ci(digest): update to PR-based upstream tracker workflow

Problem: the initial approach created GitHub issues for new upstream
activity, which accumulate and require a separate triage step outside
the codebase.

Solution: rewrite the script to append new rows directly to
doc/upstream.md (open PRs and issues to their respective tables,
merged PRs with "merged — not cherry-picked" status), then open a
PR with auto-merge enabled. The workflow formats the markdown with
prettier before committing so the markdown-format check passes.

.github/scripts/upstream_digest.py

@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 import json
+import os
 import re
 import subprocess
 import sys
@@ -7,9 +8,10 @@ from datetime import date, timedelta
 
 
 UPSTREAM = "stevearc/oil.nvim"
-TARGET = "barrettruth/canola.nvim"
 UPSTREAM_MD = "doc/upstream.md"
-LABEL = "upstream/digest"
+
+PRS_HEADING = "## Open upstream PRs"
+ISSUES_HEADING = "## Upstream issues"
 
 
 def get_last_tracked_number():
@@ -43,10 +45,18 @@ def fetch_items(last_number, since_date):
             "--repo", UPSTREAM,
             "--state", "merged",
             "--limit", "100",
-            "--json", "number,title,mergedAt,url",
+            "--json", "number,title,url",
+        )
+    )
+    open_prs = json.loads(
+        gh(
+            "pr", "list",
+            "--repo", UPSTREAM,
+            "--state", "open",
+            "--limit", "100",
+            "--json", "number,title,createdAt,url",
         )
     )
-
     open_issues = json.loads(
         gh(
             "issue", "list",
@@ -57,96 +67,88 @@ def fetch_items(last_number, since_date):
         )
     )
 
-    open_prs = json.loads(
-        gh(
-            "pr", "list",
-            "--repo", UPSTREAM,
-            "--state", "open",
-            "--limit", "100",
-            "--json", "number,title,createdAt,url",
-        )
-    )
-
     if last_number is not None:
         merged_prs = [x for x in merged_prs if x["number"] > last_number]
-        open_issues = [x for x in open_issues if x["number"] > last_number]
         open_prs = [x for x in open_prs if x["number"] > last_number]
+        open_issues = [x for x in open_issues if x["number"] > last_number]
     else:
         cutoff = since_date.isoformat()
-        merged_prs = [x for x in merged_prs if x.get("mergedAt", "") >= cutoff]
+        merged_prs = []
-        open_issues = [x for x in open_issues if x.get("createdAt", "") >= cutoff]
         open_prs = [x for x in open_prs if x.get("createdAt", "") >= cutoff]
+        open_issues = [x for x in open_issues if x.get("createdAt", "") >= cutoff]
 
     merged_prs.sort(key=lambda x: x["number"])
-    open_issues.sort(key=lambda x: x["number"])
     open_prs.sort(key=lambda x: x["number"])
+    open_issues.sort(key=lambda x: x["number"])
 
-    return merged_prs, open_issues, open_prs
+    return merged_prs, open_prs, open_issues
 
 
-def format_row(item):
+def append_to_section(content, heading, new_rows):
-    num = item["number"]
+    lines = content.split("\n")
-    title = item["title"]
+    in_section = False
-    url = item["url"]
+    last_table_row = -1
-    return f"- [#{num}]({url}) — {title}"
 
+    for i, line in enumerate(lines):
+        if line.startswith("## "):
+            in_section = line.strip() == heading
+        if in_section and line.startswith("|"):
+            last_table_row = i
 
-def build_body(merged_prs, open_issues, open_prs, last_number):
+    if last_table_row == -1:
-    if last_number is not None:
+        return content
-        summary = f"Items with number > #{last_number} (last entry in `doc/upstream.md`)."
-    else:
-        summary = "Last 30 days (could not parse `doc/upstream.md` for a baseline)."
 
-    sections = [summary, ""]
+    return "\n".join(
-
+        lines[: last_table_row + 1] + new_rows + lines[last_table_row + 1 :]
-    sections.append("## Merged PRs")
+    )
-    if merged_prs:
-        sections.extend(format_row(x) for x in merged_prs)
-    else:
-        sections.append("_None_")
-
-    sections.append("")
-    sections.append("## New open issues")
-    if open_issues:
-        sections.extend(format_row(x) for x in open_issues)
-    else:
-        sections.append("_None_")
-
-    sections.append("")
-    sections.append("## New open PRs")
-    if open_prs:
-        sections.extend(format_row(x) for x in open_prs)
-    else:
-        sections.append("_None_")
-
-    return "\n".join(sections)
 
 
 def main():
     last_number = get_last_tracked_number()
     since_date = date.today() - timedelta(days=30)
 
-    merged_prs, open_issues, open_prs = fetch_items(last_number, since_date)
+    merged_prs, open_prs, open_issues = fetch_items(last_number, since_date)
 
-    total = len(merged_prs) + len(open_issues) + len(open_prs)
+    total = len(merged_prs) + len(open_prs) + len(open_issues)
     if total == 0:
-        print("No new upstream activity. Skipping issue creation.")
+        print("No new upstream activity.")
         return
 
-    today = date.today().isoformat()
+    with open(UPSTREAM_MD) as f:
-    title = f"upstream digest: week of {today}"
+        content = f.read()
-    body = build_body(merged_prs, open_issues, open_prs, last_number)
 
-    gh(
+    pr_rows = []
-        "issue", "create",
+    for pr in open_prs:
-        "--repo", TARGET,
+        pr_rows.append(f"| [#{pr['number']}]({pr['url']}) | {pr['title']} | open |")
-        "--title", title,
+    for pr in merged_prs:
-        "--label", LABEL,
+        pr_rows.append(
-        "--body", body,
+            f"| [#{pr['number']}]({pr['url']}) | {pr['title']} | merged — not cherry-picked |"
+        )
+
+    issue_rows = []
+    for issue in open_issues:
+        issue_rows.append(
+            f"| [#{issue['number']}]({issue['url']}) | open | {issue['title']} |"
+        )
+
+    if pr_rows:
+        content = append_to_section(content, PRS_HEADING, pr_rows)
+    if issue_rows:
+        content = append_to_section(content, ISSUES_HEADING, issue_rows)
+
+    with open(UPSTREAM_MD, "w") as f:
+        f.write(content)
+
+    github_output = os.environ.get("GITHUB_OUTPUT")
+    if github_output:
+        with open(github_output, "a") as f:
+            f.write("changed=true\n")
+
+    print(
+        f"Added {len(open_prs)} open PR(s), {len(merged_prs)} merged PR(s), "
+        f"{len(open_issues)} issue(s) to {UPSTREAM_MD}"
     )
 
-    print(f"Created digest issue: {title} ({total} items)")
-
 
 if __name__ == "__main__":
     try:

.github/workflows/upstream-digest.yml

@@ -6,8 +6,8 @@ on:
   workflow_dispatch:
 
 permissions:
-  issues: write
+  contents: write
-  contents: read
+  pull-requests: write
 
 jobs:
   digest:
@@ -15,7 +15,32 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Create upstream digest issue
+      - name: Update upstream tracker
+        id: digest
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: python3 .github/scripts/upstream_digest.py
+
+      - name: Format doc/upstream.md
+        if: steps.digest.outputs.changed == 'true'
+        run: npx --yes prettier --write doc/upstream.md
+
+      - name: Create PR
+        if: steps.digest.outputs.changed == 'true'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          DATE=$(date +%Y-%m-%d)
+          BRANCH="ci/upstream-digest-${DATE}"
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git checkout -b "${BRANCH}"
+          git add doc/upstream.md
+          git commit -m "docs(upstream): add digest for week of ${DATE}"
+          git push origin "${BRANCH}"
+          PR_URL=$(gh pr create \
+            --title "docs(upstream): add digest for week of ${DATE}" \
+            --body "Automated weekly digest of new upstream activity. Triage by updating statuses and notes." \
+            --base main \
+            --head "${BRANCH}")
+          gh pr merge "${PR_URL}" --auto --squash