pm-github 2026.10.14 → 2026.10.16

package/dist/index.js

@@ -13,6 +13,7 @@
 //
 // Issues use the REST API; Projects v2 is GraphQL-only (see the Projects v2
 // section below and the pure plan/mapping logic in ./projects.ts).
+import { CloseoutUsageError, compactCloseoutReport, runCloseout } from "./closeout.js";
 import http from "node:http";
 import https from "node:https";
 import crypto from "node:crypto";
@@ -4976,7 +4977,7 @@ const PROJECT_SYNC_FLAGS = [
 const defineExtension = (module) => module;
 export default defineExtension({
     name: "pm-github",
-    version: "2026.10.14",
+    version: "2026.10.16",
     activate(api) {
         // -----------------------------------------------------------------------
         // schema — declare the GitHub provenance fields so the workspace knows them
@@ -5300,6 +5301,37 @@ export default defineExtension({
                 return report;
             },
         });
+        // Closeout uses the existing repository resolution and REST transport.
+        api.registerCommand({
+            name: "github closeout",
+            description: "Close items linked by merged PRs after verifying head checks. Dry-run by default; --apply writes through the SDK. Returns a compact TOON plan or --json.",
+            intent: "close delivered pm items with verifiable GitHub evidence",
+            examples: ["pm github closeout --repo owner/repo --pr 42 --pr 43", "pm github closeout --since 2026-10-01 --skip pm-123 --apply --json"],
+            flags: [
+                { long: "--repo", value_name: "owner/repo", description: "Repository (or PM_GITHUB_REPO)" },
+                { long: "--pr", value_name: "n", repeatable: true, description: "Select a PR number (repeatable; conflicts with --since)" },
+                { long: "--since", value_name: "ISO date", description: "Select PRs merged at or after this ISO date/time" },
+                { long: "--skip", value_name: "id", repeatable: true, description: "Never close this item (repeatable)" },
+                { long: "--apply", description: "Close eligible items (default: dry-run)" },
+                { long: "--dry-run", description: "Preview only; overrides --apply" },
+                { long: "--full", description: "Include every plan row and PR check (also available with --json)" },
+            ],
+            async run(ctx) {
+                try {
+                    const token = resolveGitHubToken();
+                    const report = await runCloseout(ctx.pm_root, resolveSearchRepo(ctx.options), ctx.options, {
+                        base: githubApiBase(), get: url => fetchJSON(url, token), next: parseNextLink,
+                    });
+                    if (report.failed > 0)
+                        throw new CommandError(JSON.stringify({ ...report, error: "pm github closeout: some closes failed" }), EXIT_CODE.GENERIC_FAILURE);
+                    return ctx.global.json === true || ctx.options.full === true ? report : compactCloseoutReport(report);
+                }
+                catch (error) {
+                    // A plain Error would make the host re-run the handler (repeating GitHub reads and remaining closes).
+                    throw new CommandError(error.message, error instanceof CloseoutUsageError ? EXIT_CODE.USAGE : EXIT_CODE.GENERIC_FAILURE);
+                }
+            },
+        });
         // -----------------------------------------------------------------------
         // command — `pm github blockers` (revalidate blocked items against the
         // live state of their GitHub blockers). REPORT-ONLY: it never unblocks,