@webpieces/pr-gate 0.4.523 → 0.4.524

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/pr-gate",
-  "version": "0.4.523",
+  "version": "0.4.524",
   "description": "Gated PR system: 3-point squash-merge, merge validation gate, and red/yellow/green PR dashboard. Standalone scripts, no Nx dependency required.",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -26,7 +26,7 @@
     "directory": "packages/tooling/pr-gate"
   },
   "dependencies": {
-    "@webpieces/rules-config": "0.4.523",
+    "@webpieces/rules-config": "0.4.524",
     "@inversifyjs/binding-decorators": "1.1.5",
     "inversify": "7.10.4",
     "reflect-metadata": "0.2.2"

package/src/scripts/commands/land-pr-command.d.ts

@@ -1,6 +1,7 @@
-import { RepoRootFinder, BranchArchiver, WorktreeService } from '@webpieces/rules-config';
+import { RepoRootFinder, BranchArchiver } from '@webpieces/rules-config';
 import { AiBranchName } from '../workflow/git-readAiBranchName';
 import { BranchNaming } from '../workflow/branch-naming';
+import { LandedWorktreeReaper } from '../workflow/landed-worktree-reaper';
 import { MergeInfoIndex } from '../workflow/merge-info-index';
 import { PrMerger } from '../workflow/pr-merger';
 /**
@@ -25,21 +26,24 @@ export declare class LandPrCommand {
     private readonly prMerger;
     private readonly archiver;
     private readonly mergeInfoIndex;
-    private readonly worktrees;
-    constructor(repoRootFinder: RepoRootFinder, aiBranchName: AiBranchName, branchNaming: BranchNaming, prMerger: PrMerger, archiver: BranchArchiver, mergeInfoIndex: MergeInfoIndex, worktrees: WorktreeService);
+    private readonly landedWorktree;
+    constructor(repoRootFinder: RepoRootFinder, aiBranchName: AiBranchName, branchNaming: BranchNaming, prMerger: PrMerger, archiver: BranchArchiver, mergeInfoIndex: MergeInfoIndex, landedWorktree: LandedWorktreeReaper);
     run(): Promise<void>;
     /**
-     * What to run next — which is NOT the same sentence when you landed from a worktree.
+     * What happens next — which is NOT the same act when you landed from a worktree.
      *
      * Landing from a linked worktree always used to leave a corpse: the merged branch is checked out
      * here, so `git branch -D` refuses, `wp-cleanup`'s branch pass spares it as in-use, and nothing
-     * removed the worktree — so the pair sat there until branch-creation-guard hit its cap. wp-cleanup
-     * now reaps dead worktrees, but it cannot reap the one it is RUNNING IN (removing your own cwd
-     * mid-command is a self-destruct), so the instruction has to say where to run it from.
+     * removed the worktree — so the pair sat there until branch-creation-guard hit its cap. #512 made
+     * worktrees reapable and printed `cd <primary> && pnpm wp-cleanup`; that instruction was correct
+     * and it was the most-skipped step in the flow, because the PR is already landed and the work
+     * feels done.
      *
-     * We deliberately do NOT remove the worktree here. This command is executing inside it, and a
-     * process that deletes the directory underneath itself is exactly the thing every safety rail in
-     * WorktreeReaper exists to refuse.
+     * So the reap is no longer an instruction. This command still refuses to remove the directory it
+     * is standing in — that rail is untouched — and instead HANDS THE REAP to a child process rooted
+     * in the primary clone, which is a tree nobody is deleting. See LandedWorktreeReaper. When that
+     * hand-off is not safely achievable the #512 notice is printed unchanged, because an honest
+     * limitation beats a command that deletes its own working directory mid-run.
      */
     private nextStep;
     /**

package/src/scripts/commands/land-pr-command.js

@@ -9,6 +9,7 @@ const rules_config_1 = require("@webpieces/rules-config");
 const inversify_1 = require("inversify");
 const git_readAiBranchName_1 = require("../workflow/git-readAiBranchName");
 const branch_naming_1 = require("../workflow/branch-naming");
+const landed_worktree_reaper_1 = require("../workflow/landed-worktree-reaper");
 const merge_info_index_1 = require("../workflow/merge-info-index");
 const pr_merger_1 = require("../workflow/pr-merger");
 const SEP = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
@@ -34,15 +35,15 @@ let LandPrCommand = class LandPrCommand {
     prMerger;
     archiver;
     mergeInfoIndex;
-    worktrees;
-    constructor(repoRootFinder, aiBranchName, branchNaming, prMerger, archiver, mergeInfoIndex, worktrees) {
+    landedWorktree;
+    constructor(repoRootFinder, aiBranchName, branchNaming, prMerger, archiver, mergeInfoIndex, landedWorktree) {
         this.repoRootFinder = repoRootFinder;
         this.aiBranchName = aiBranchName;
         this.branchNaming = branchNaming;
         this.prMerger = prMerger;
         this.archiver = archiver;
         this.mergeInfoIndex = mergeInfoIndex;
-        this.worktrees = worktrees;
+        this.landedWorktree = landedWorktree;
     }
     async run() {
         const repoRoot = this.repoRootFinder.resolveRepoRoot(process.cwd());
@@ -87,30 +88,28 @@ let LandPrCommand = class LandPrCommand {
             '\n');
     }
     /**
-     * What to run next — which is NOT the same sentence when you landed from a worktree.
+     * What happens next — which is NOT the same act when you landed from a worktree.
      *
      * Landing from a linked worktree always used to leave a corpse: the merged branch is checked out
      * here, so `git branch -D` refuses, `wp-cleanup`'s branch pass spares it as in-use, and nothing
-     * removed the worktree — so the pair sat there until branch-creation-guard hit its cap. wp-cleanup
-     * now reaps dead worktrees, but it cannot reap the one it is RUNNING IN (removing your own cwd
-     * mid-command is a self-destruct), so the instruction has to say where to run it from.
+     * removed the worktree — so the pair sat there until branch-creation-guard hit its cap. #512 made
+     * worktrees reapable and printed `cd <primary> && pnpm wp-cleanup`; that instruction was correct
+     * and it was the most-skipped step in the flow, because the PR is already landed and the work
+     * feels done.
      *
-     * We deliberately do NOT remove the worktree here. This command is executing inside it, and a
-     * process that deletes the directory underneath itself is exactly the thing every safety rail in
-     * WorktreeReaper exists to refuse.
+     * So the reap is no longer an instruction. This command still refuses to remove the directory it
+     * is standing in — that rail is untouched — and instead HANDS THE REAP to a child process rooted
+     * in the primary clone, which is a tree nobody is deleting. See LandedWorktreeReaper. When that
+     * hand-off is not safely achievable the #512 notice is printed unchanged, because an honest
+     * limitation beats a command that deletes its own working directory mid-run.
      */
     nextStep(repoRoot, base) {
-        const here = this.worktrees.currentWorktree(repoRoot);
-        if (here === null || here.isMain || here.branch !== base) {
+        const handoff = this.landedWorktree.plan(repoRoot, base);
+        if (handoff === null)
             return '   Next: `pnpm wp-cleanup` to delete the merged branch.\n';
-        }
-        const main = this.worktrees.listWorktrees(repoRoot)
-            .find((tree) => tree.isMain);
-        const from = main ? main.path : '<the primary clone>';
-        return '   Next: this branch is checked out in THIS worktree, so neither it nor the worktree can\n'
-            + `         be removed from in here. Run cleanup from the primary clone instead:\n`
-            + `           cd ${from} && pnpm wp-cleanup\n`
-            + `         It archives ${base} as a tag, removes ${here.path}, then deletes the branch.\n`;
+        if (!handoff.canReap)
+            return this.landedWorktree.manualNotice(handoff);
+        return this.landedWorktree.handOff(handoff);
     }
     /**
      * The landed branch's post-merge bookkeeping, in one place:
@@ -170,7 +169,7 @@ exports.LandPrCommand = LandPrCommand = tslib_1.__decorate([
         pr_merger_1.PrMerger,
         rules_config_1.BranchArchiver,
         merge_info_index_1.MergeInfoIndex,
-        rules_config_1.WorktreeService])
+        landed_worktree_reaper_1.LandedWorktreeReaper])
 ], LandPrCommand);
 // The open PR's number + title, as read back from GitHub.
 class PrIdentity {

package/src/scripts/commands/land-pr-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"land-pr-command.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/pr-gate/src/scripts/commands/land-pr-command.ts"],"names":[],"mappings":"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","sourcesContent":["import { execSync, spawnSync } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport {\n    prDirFor, InformAiError, RepoRootFinder, MERGE_MODE_AUTO, loadAndValidate,\n    BranchArchiver, BRANCH_RETENTION_ARCHIVE_TAG, BRANCH_RETENTION_KEEP,\n    Worktree, WorktreeService,\n} from '@webpieces/rules-config';\nimport { injectable, bindingScopeValues } from 'inversify';\nimport { AiBranchName } from '../workflow/git-readAiBranchName';\nimport { BranchNaming } from '../workflow/branch-naming';\nimport { ArchiveRecord, MergeInfoIndex } from '../workflow/merge-info-index';\nimport { PrMerger } from '../workflow/pr-merger';\n\nconst SEP = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\\n';\n\n/**\n * `wp-land-pr`: squash-merge THIS branch's already-posted PR into main with the compact commit body.\n *\n * It exists because a merge clicked in the GitHub UI cannot produce that body. A UI merge is limited\n * to the repo's squash_merge_commit_title/message settings, and none of their values yields the\n * shortened risk/flags summary — only an explicit `gh pr merge --subject --body-file` does. So when a\n * merge has to happen outside `wp-finish-upsert-pr` (a mergeMode=NONE repo, or a PR whose checks were\n * still running when finish ran), this is the command that keeps main's history consistent.\n *\n * It deliberately does NOT re-run the build gate or re-render the dashboard: `wp-finish-upsert-pr`\n * already did both and left `merge-commit-body.md` on disk. Landing is a separate, later act, and\n * rebuilding here would mean a second authoritative gate whose result nobody reads. If that file is\n * missing, the honest answer is that finish has not run — so this fails and says so, rather than\n * inventing a body that would not match the PR.\n */\n@injectable(bindingScopeValues.Singleton)\nexport class LandPrCommand {\n    constructor(\n        private readonly repoRootFinder: RepoRootFinder,\n        private readonly aiBranchName: AiBranchName,\n        private readonly branchNaming: BranchNaming,\n        private readonly prMerger: PrMerger,\n        private readonly archiver: BranchArchiver,\n        private readonly mergeInfoIndex: MergeInfoIndex,\n        private readonly worktrees: WorktreeService,\n    ) {}\n\n    async run(): Promise<void> {\n        const repoRoot = this.repoRootFinder.resolveRepoRoot(process.cwd());\n        const base = this.branchNaming.baseBranchName(execSync('git branch --show-current', { encoding: 'utf8' }).trim());\n        const prDir = prDirFor(repoRoot, this.aiBranchName.getFeatureName());\n        const mergeBodyFile = path.join(prDir, 'merge-commit-body.md');\n\n        if (!fs.existsSync(mergeBodyFile)) {\n            throw new InformAiError(\n                '\\n' + SEP + '❌ Nothing to land — no rendered merge body\\n' + SEP + '\\n' +\n                `Expected the compact squash-commit body at:\\n  ${mergeBodyFile}\\n\\n` +\n                'That file is written by `pnpm wp-finish-upsert-pr`, which is also what posts the PR.\\n' +\n                'Its absence means finish has not run on this branch, so there is no reviewed PR to\\n' +\n                'land. Run the gated flow first:\\n\\n' +\n                '  pnpm wp-start-upsert-pr     # update from main, push, build gate\\n' +\n                '  # write .webpieces/review.json\\n' +\n                '  pnpm wp-finish-upsert-pr    # build gate, dashboard, create/update the PR\\n\\n' +\n                'Then re-run `pnpm wp-land-pr` if the PR still needs landing.\\n' + SEP,\n            );\n        }\n\n        const ref = this.prNumberAndTitle(base);\n        if (ref === null) {\n            throw new InformAiError(\n                '\\n' + SEP + '❌ No open PR found for this branch\\n' + SEP + '\\n' +\n                `No open PR has head branch \"${base}\". Nothing to land.\\n` +\n                'If the PR is already merged, run `pnpm wp-cleanup`.\\n' + SEP,\n            );\n        }\n\n        process.stdout.write('\\n' + SEP + `🚀 Landing PR #${ref.number}\\n` + SEP + '\\n');\n        // Reuse the SAME merge logic wp-finish-upsert-pr uses, so a PR lands identically whichever\n        // command lands it — including the auto-merge fallback when the checks are still running.\n        // MERGE_MODE_AUTO is passed explicitly: running this command IS the intent to merge, so it is\n        // not gated on pr-gate.mergeMode (a NONE repo runs this precisely to land one PR by hand).\n        const outcome = this.prMerger.merge(base, `${ref.title} (#${ref.number})`, mergeBodyFile, MERGE_MODE_AUTO);\n\n        const config = loadAndValidate(repoRoot).prGate;\n        const policy = config.mergeMode;\n        const archived = outcome.merged\n            ? this.archiveAndPromote(repoRoot, base, ref, config.landPr.branchRetention)\n            : '';\n        process.stdout.write(\n            '\\n' + SEP + (outcome.merged ? '✅ Landed\\n' : 'ℹ️  Not landed yet\\n') + SEP + '\\n' +\n            `   ${outcome.message}\\n` +\n            archived +\n            (outcome.merged ? this.nextStep(repoRoot, base) : '') +\n            (policy === MERGE_MODE_AUTO\n                ? ''\n                : `   (pr-gate.mergeMode is ${policy} — wp-finish-upsert-pr will keep leaving PRs for a human.)\\n`) +\n            '\\n',\n        );\n    }\n\n    /**\n     * What to run next — which is NOT the same sentence when you landed from a worktree.\n     *\n     * Landing from a linked worktree always used to leave a corpse: the merged branch is checked out\n     * here, so `git branch -D` refuses, `wp-cleanup`'s branch pass spares it as in-use, and nothing\n     * removed the worktree — so the pair sat there until branch-creation-guard hit its cap. wp-cleanup\n     * now reaps dead worktrees, but it cannot reap the one it is RUNNING IN (removing your own cwd\n     * mid-command is a self-destruct), so the instruction has to say where to run it from.\n     *\n     * We deliberately do NOT remove the worktree here. This command is executing inside it, and a\n     * process that deletes the directory underneath itself is exactly the thing every safety rail in\n     * WorktreeReaper exists to refuse.\n     */\n    private nextStep(repoRoot: string, base: string): string {\n        const here = this.worktrees.currentWorktree(repoRoot);\n        if (here === null || here.isMain || here.branch !== base) {\n            return '   Next: `pnpm wp-cleanup` to delete the merged branch.\\n';\n        }\n        const main = this.worktrees.listWorktrees(repoRoot)\n            .find((tree: Worktree): boolean => tree.isMain);\n        const from = main ? main.path : '<the primary clone>';\n        return '   Next: this branch is checked out in THIS worktree, so neither it nor the worktree can\\n'\n            + `         be removed from in here. Run cleanup from the primary clone instead:\\n`\n            + `           cd ${from} && pnpm wp-cleanup\\n`\n            + `         It archives ${base} as a tag, removes ${here.path}, then deletes the branch.\\n`;\n    }\n\n    /**\n     * The landed branch's post-merge bookkeeping, in one place:\n     *  1. ARCHIVE the pre-squash tip as `archive/<date>/<branch>` — the tag makes the original history\n     *     permanently restorable (`git checkout -b <branch> <tag>` gives back the exact objects) while\n     *     costing one ref, so the branch itself no longer has to survive as a `*PreMerge` husk that\n     *     counts toward the branch cap. See BranchArchiver for why a tag beats a patch or the reflog.\n     *  2. PROMOTE `merge-info/staged/<feature>/` to `merge-info/merged/<feature>/` and rebuild\n     *     `index.json`, so `staged/` holds only branches that are still in flight.\n     *\n     * Never throws: the PR is already merged by the time we get here, and failing the command after a\n     * successful merge would report a landed PR as a failure. Problems are reported in the recap.\n     */\n    private archiveAndPromote(repoRoot: string, base: string, ref: PrIdentity, retention: string): string {\n        if (retention === BRANCH_RETENTION_KEEP) return '   Branch retention is \"keep\" — nothing archived.\\n';\n\n        let line = '';\n        let tag = '';\n        if (retention === BRANCH_RETENTION_ARCHIVE_TAG) {\n            const archive = this.archiver.archive(repoRoot, base);\n            tag = archive.tag;\n            line = archive.ok\n                ? `   Archived ${base} → ${archive.tag}   (restore: ${this.archiver.restoreCommand(base, archive.tag)})\\n`\n                : `   ⚠️  Could not archive ${base}: ${archive.error} — the branch was left alone.\\n`;\n        }\n\n        const feature = this.aiBranchName.getFeatureName();\n        const record = new ArchiveRecord(\n            tag, this.revParse(repoRoot, base), this.revParse(repoRoot, 'origin/main'),\n            Number(ref.number), new Date().toISOString(),\n        );\n        if (this.mergeInfoIndex.promoteToMerged(repoRoot, feature, record)) {\n            line += `   merge-info: staged/${feature} → merged/${feature} (index.json rebuilt)\\n`;\n        }\n        return line;\n    }\n\n    // Best-effort sha of a ref — '' when it cannot resolve. Recorded in archive.json for provenance.\n    private revParse(repoRoot: string, ref: string): string {\n        const result = spawnSync('git', ['rev-parse', ref], { cwd: repoRoot, encoding: 'utf8' });\n        return result.status === 0 ? (result.stdout ?? '').trim() : '';\n    }\n\n    // The open PR's number + title for this head branch, or null when there is none. The TITLE comes\n    // from the PR itself, not review.json, so the squash subject matches what a reviewer approved even\n    // if review.json was edited afterwards.\n    private prNumberAndTitle(baseBranch: string): PrIdentity | null {\n        const result = spawnSync(\n            'gh', ['pr', 'view', baseBranch, '--json', 'number,title', '--jq', '\"\\\\(.number)\\\\t\\\\(.title)\"'],\n            { encoding: 'utf8' },\n        );\n        if (result.status !== 0) return null;\n        const parts = (result.stdout ?? '').trim().split('\\t');\n        if ((parts[0] ?? '') === '') return null;\n        return new PrIdentity(parts[0] ?? '', parts[1] ?? '');\n    }\n}\n\n// The open PR's number + title, as read back from GitHub.\nclass PrIdentity {\n    number: string;\n    title: string;\n\n    constructor(number: string, title: string) {\n        this.number = number;\n        this.title = title;\n    }\n}\n"]}
+{"version":3,"file":"land-pr-command.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/pr-gate/src/scripts/commands/land-pr-command.ts"],"names":[],"mappings":"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","sourcesContent":["import { execSync, spawnSync } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport {\n    prDirFor, InformAiError, RepoRootFinder, MERGE_MODE_AUTO, loadAndValidate,\n    BranchArchiver, BRANCH_RETENTION_ARCHIVE_TAG, BRANCH_RETENTION_KEEP,\n} from '@webpieces/rules-config';\nimport { injectable, bindingScopeValues } from 'inversify';\nimport { AiBranchName } from '../workflow/git-readAiBranchName';\nimport { BranchNaming } from '../workflow/branch-naming';\nimport { LandedWorktreeReaper, WorktreeReapHandoff } from '../workflow/landed-worktree-reaper';\nimport { ArchiveRecord, MergeInfoIndex } from '../workflow/merge-info-index';\nimport { PrMerger } from '../workflow/pr-merger';\n\nconst SEP = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\\n';\n\n/**\n * `wp-land-pr`: squash-merge THIS branch's already-posted PR into main with the compact commit body.\n *\n * It exists because a merge clicked in the GitHub UI cannot produce that body. A UI merge is limited\n * to the repo's squash_merge_commit_title/message settings, and none of their values yields the\n * shortened risk/flags summary — only an explicit `gh pr merge --subject --body-file` does. So when a\n * merge has to happen outside `wp-finish-upsert-pr` (a mergeMode=NONE repo, or a PR whose checks were\n * still running when finish ran), this is the command that keeps main's history consistent.\n *\n * It deliberately does NOT re-run the build gate or re-render the dashboard: `wp-finish-upsert-pr`\n * already did both and left `merge-commit-body.md` on disk. Landing is a separate, later act, and\n * rebuilding here would mean a second authoritative gate whose result nobody reads. If that file is\n * missing, the honest answer is that finish has not run — so this fails and says so, rather than\n * inventing a body that would not match the PR.\n */\n@injectable(bindingScopeValues.Singleton)\nexport class LandPrCommand {\n    constructor(\n        private readonly repoRootFinder: RepoRootFinder,\n        private readonly aiBranchName: AiBranchName,\n        private readonly branchNaming: BranchNaming,\n        private readonly prMerger: PrMerger,\n        private readonly archiver: BranchArchiver,\n        private readonly mergeInfoIndex: MergeInfoIndex,\n        private readonly landedWorktree: LandedWorktreeReaper,\n    ) {}\n\n    async run(): Promise<void> {\n        const repoRoot = this.repoRootFinder.resolveRepoRoot(process.cwd());\n        const base = this.branchNaming.baseBranchName(execSync('git branch --show-current', { encoding: 'utf8' }).trim());\n        const prDir = prDirFor(repoRoot, this.aiBranchName.getFeatureName());\n        const mergeBodyFile = path.join(prDir, 'merge-commit-body.md');\n\n        if (!fs.existsSync(mergeBodyFile)) {\n            throw new InformAiError(\n                '\\n' + SEP + '❌ Nothing to land — no rendered merge body\\n' + SEP + '\\n' +\n                `Expected the compact squash-commit body at:\\n  ${mergeBodyFile}\\n\\n` +\n                'That file is written by `pnpm wp-finish-upsert-pr`, which is also what posts the PR.\\n' +\n                'Its absence means finish has not run on this branch, so there is no reviewed PR to\\n' +\n                'land. Run the gated flow first:\\n\\n' +\n                '  pnpm wp-start-upsert-pr     # update from main, push, build gate\\n' +\n                '  # write .webpieces/review.json\\n' +\n                '  pnpm wp-finish-upsert-pr    # build gate, dashboard, create/update the PR\\n\\n' +\n                'Then re-run `pnpm wp-land-pr` if the PR still needs landing.\\n' + SEP,\n            );\n        }\n\n        const ref = this.prNumberAndTitle(base);\n        if (ref === null) {\n            throw new InformAiError(\n                '\\n' + SEP + '❌ No open PR found for this branch\\n' + SEP + '\\n' +\n                `No open PR has head branch \"${base}\". Nothing to land.\\n` +\n                'If the PR is already merged, run `pnpm wp-cleanup`.\\n' + SEP,\n            );\n        }\n\n        process.stdout.write('\\n' + SEP + `🚀 Landing PR #${ref.number}\\n` + SEP + '\\n');\n        // Reuse the SAME merge logic wp-finish-upsert-pr uses, so a PR lands identically whichever\n        // command lands it — including the auto-merge fallback when the checks are still running.\n        // MERGE_MODE_AUTO is passed explicitly: running this command IS the intent to merge, so it is\n        // not gated on pr-gate.mergeMode (a NONE repo runs this precisely to land one PR by hand).\n        const outcome = this.prMerger.merge(base, `${ref.title} (#${ref.number})`, mergeBodyFile, MERGE_MODE_AUTO);\n\n        const config = loadAndValidate(repoRoot).prGate;\n        const policy = config.mergeMode;\n        const archived = outcome.merged\n            ? this.archiveAndPromote(repoRoot, base, ref, config.landPr.branchRetention)\n            : '';\n        process.stdout.write(\n            '\\n' + SEP + (outcome.merged ? '✅ Landed\\n' : 'ℹ️  Not landed yet\\n') + SEP + '\\n' +\n            `   ${outcome.message}\\n` +\n            archived +\n            (outcome.merged ? this.nextStep(repoRoot, base) : '') +\n            (policy === MERGE_MODE_AUTO\n                ? ''\n                : `   (pr-gate.mergeMode is ${policy} — wp-finish-upsert-pr will keep leaving PRs for a human.)\\n`) +\n            '\\n',\n        );\n    }\n\n    /**\n     * What happens next — which is NOT the same act when you landed from a worktree.\n     *\n     * Landing from a linked worktree always used to leave a corpse: the merged branch is checked out\n     * here, so `git branch -D` refuses, `wp-cleanup`'s branch pass spares it as in-use, and nothing\n     * removed the worktree — so the pair sat there until branch-creation-guard hit its cap. #512 made\n     * worktrees reapable and printed `cd <primary> && pnpm wp-cleanup`; that instruction was correct\n     * and it was the most-skipped step in the flow, because the PR is already landed and the work\n     * feels done.\n     *\n     * So the reap is no longer an instruction. This command still refuses to remove the directory it\n     * is standing in — that rail is untouched — and instead HANDS THE REAP to a child process rooted\n     * in the primary clone, which is a tree nobody is deleting. See LandedWorktreeReaper. When that\n     * hand-off is not safely achievable the #512 notice is printed unchanged, because an honest\n     * limitation beats a command that deletes its own working directory mid-run.\n     */\n    private nextStep(repoRoot: string, base: string): string {\n        const handoff: WorktreeReapHandoff | null = this.landedWorktree.plan(repoRoot, base);\n        if (handoff === null) return '   Next: `pnpm wp-cleanup` to delete the merged branch.\\n';\n        if (!handoff.canReap) return this.landedWorktree.manualNotice(handoff);\n        return this.landedWorktree.handOff(handoff);\n    }\n\n    /**\n     * The landed branch's post-merge bookkeeping, in one place:\n     *  1. ARCHIVE the pre-squash tip as `archive/<date>/<branch>` — the tag makes the original history\n     *     permanently restorable (`git checkout -b <branch> <tag>` gives back the exact objects) while\n     *     costing one ref, so the branch itself no longer has to survive as a `*PreMerge` husk that\n     *     counts toward the branch cap. See BranchArchiver for why a tag beats a patch or the reflog.\n     *  2. PROMOTE `merge-info/staged/<feature>/` to `merge-info/merged/<feature>/` and rebuild\n     *     `index.json`, so `staged/` holds only branches that are still in flight.\n     *\n     * Never throws: the PR is already merged by the time we get here, and failing the command after a\n     * successful merge would report a landed PR as a failure. Problems are reported in the recap.\n     */\n    private archiveAndPromote(repoRoot: string, base: string, ref: PrIdentity, retention: string): string {\n        if (retention === BRANCH_RETENTION_KEEP) return '   Branch retention is \"keep\" — nothing archived.\\n';\n\n        let line = '';\n        let tag = '';\n        if (retention === BRANCH_RETENTION_ARCHIVE_TAG) {\n            const archive = this.archiver.archive(repoRoot, base);\n            tag = archive.tag;\n            line = archive.ok\n                ? `   Archived ${base} → ${archive.tag}   (restore: ${this.archiver.restoreCommand(base, archive.tag)})\\n`\n                : `   ⚠️  Could not archive ${base}: ${archive.error} — the branch was left alone.\\n`;\n        }\n\n        const feature = this.aiBranchName.getFeatureName();\n        const record = new ArchiveRecord(\n            tag, this.revParse(repoRoot, base), this.revParse(repoRoot, 'origin/main'),\n            Number(ref.number), new Date().toISOString(),\n        );\n        if (this.mergeInfoIndex.promoteToMerged(repoRoot, feature, record)) {\n            line += `   merge-info: staged/${feature} → merged/${feature} (index.json rebuilt)\\n`;\n        }\n        return line;\n    }\n\n    // Best-effort sha of a ref — '' when it cannot resolve. Recorded in archive.json for provenance.\n    private revParse(repoRoot: string, ref: string): string {\n        const result = spawnSync('git', ['rev-parse', ref], { cwd: repoRoot, encoding: 'utf8' });\n        return result.status === 0 ? (result.stdout ?? '').trim() : '';\n    }\n\n    // The open PR's number + title for this head branch, or null when there is none. The TITLE comes\n    // from the PR itself, not review.json, so the squash subject matches what a reviewer approved even\n    // if review.json was edited afterwards.\n    private prNumberAndTitle(baseBranch: string): PrIdentity | null {\n        const result = spawnSync(\n            'gh', ['pr', 'view', baseBranch, '--json', 'number,title', '--jq', '\"\\\\(.number)\\\\t\\\\(.title)\"'],\n            { encoding: 'utf8' },\n        );\n        if (result.status !== 0) return null;\n        const parts = (result.stdout ?? '').trim().split('\\t');\n        if ((parts[0] ?? '') === '') return null;\n        return new PrIdentity(parts[0] ?? '', parts[1] ?? '');\n    }\n}\n\n// The open PR's number + title, as read back from GitHub.\nclass PrIdentity {\n    number: string;\n    title: string;\n\n    constructor(number: string, title: string) {\n        this.number = number;\n        this.title = title;\n    }\n}\n"]}

package/src/scripts/commands/reap-worktree-command.d.ts

@@ -0,0 +1,36 @@
+import { RepoRootFinder } from '@webpieces/rules-config';
+import { WorktreeCleanupSection } from './worktree-cleanup';
+/**
+ * The CHILD side of `wp-land-pr`'s re-exec: reap ONE named worktree, from a process whose cwd is the
+ * primary clone.
+ *
+ * It is not a published `bin`. Nothing about it is a verb a human should reach for — `pnpm wp-cleanup`
+ * is that verb, and it does strictly more. This exists so the parent can hand off a SINGLE, already
+ * identified corpse without also reaping every other agent's worktree as a side effect of landing one
+ * PR. LandedWorktreeReaper spawns it by absolute path; see that class for why a child rather than a
+ * `process.chdir`.
+ *
+ * WHAT IT WILL NOT TAKE ON TRUST. The parent tells it a path and a branch; it believes neither.
+ * The verdict is recomputed here, from scratch, by the same MergedBranchesService that backs
+ * `wp-cleanup` — so a worktree is removed only when it is PROVABLY dead (its PR is merged), and never
+ * because a caller said so. That is what keeps "never remove a tree still holding unmerged work" true
+ * even if the parent is wrong, out of date, or someone runs this by hand.
+ *
+ * The primary clone can never be a target: `classifyWorktrees` drops the main worktree from the
+ * verdicts outright, so a path pointing at it simply does not resolve to a target — and WorktreeReaper
+ * refuses it a second time by name. Neither rail is load-bearing alone.
+ */
+export declare class ReapWorktreeCommand {
+    private readonly repoRootFinder;
+    private readonly worktreeSection;
+    constructor(repoRootFinder: RepoRootFinder, worktreeSection: WorktreeCleanupSection);
+    run(args: string[]): Promise<void>;
+    /**
+     * The verdict for the requested path, or null after printing WHY it is not reapable. Refusals are
+     * printed rather than thrown: the PR they follow is already merged, and exiting non-zero after a
+     * successful landing would report a landed PR as a failed command.
+     */
+    private resolveTarget;
+    private render;
+    private parse;
+}

package/src/scripts/commands/reap-worktree-command.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReapWorktreeCommand = void 0;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const rules_config_1 = require("@webpieces/rules-config");
+const inversify_1 = require("inversify");
+const worktree_cleanup_1 = require("./worktree-cleanup");
+const SEP = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
+/**
+ * The CHILD side of `wp-land-pr`'s re-exec: reap ONE named worktree, from a process whose cwd is the
+ * primary clone.
+ *
+ * It is not a published `bin`. Nothing about it is a verb a human should reach for — `pnpm wp-cleanup`
+ * is that verb, and it does strictly more. This exists so the parent can hand off a SINGLE, already
+ * identified corpse without also reaping every other agent's worktree as a side effect of landing one
+ * PR. LandedWorktreeReaper spawns it by absolute path; see that class for why a child rather than a
+ * `process.chdir`.
+ *
+ * WHAT IT WILL NOT TAKE ON TRUST. The parent tells it a path and a branch; it believes neither.
+ * The verdict is recomputed here, from scratch, by the same MergedBranchesService that backs
+ * `wp-cleanup` — so a worktree is removed only when it is PROVABLY dead (its PR is merged), and never
+ * because a caller said so. That is what keeps "never remove a tree still holding unmerged work" true
+ * even if the parent is wrong, out of date, or someone runs this by hand.
+ *
+ * The primary clone can never be a target: `classifyWorktrees` drops the main worktree from the
+ * verdicts outright, so a path pointing at it simply does not resolve to a target — and WorktreeReaper
+ * refuses it a second time by name. Neither rail is load-bearing alone.
+ */
+let ReapWorktreeCommand = class ReapWorktreeCommand {
+    repoRootFinder;
+    worktreeSection;
+    constructor(repoRootFinder, worktreeSection) {
+        this.repoRootFinder = repoRootFinder;
+        this.worktreeSection = worktreeSection;
+    }
+    async run(args) {
+        await Promise.resolve();
+        const request = this.parse(args);
+        const repoRoot = this.repoRootFinder.resolveRepoRoot(process.cwd());
+        const target = this.resolveTarget(repoRoot, request);
+        if (target === null)
+            return;
+        const retention = (0, rules_config_1.loadAndValidate)(repoRoot).prGate.landPr.branchRetention;
+        const result = this.worktreeSection.reap(repoRoot, 'wp-land-pr', [target], retention);
+        process.stdout.write(this.render(result));
+    }
+    /**
+     * The verdict for the requested path, or null after printing WHY it is not reapable. Refusals are
+     * printed rather than thrown: the PR they follow is already merged, and exiting non-zero after a
+     * successful landing would report a landed PR as a failed command.
+     */
+    resolveTarget(repoRoot, request) {
+        const wanted = path.resolve(request.worktreePath);
+        const target = this.worktreeSection.verdicts(repoRoot)
+            .find((tree) => path.resolve(tree.path) === wanted);
+        if (target === undefined) {
+            process.stdout.write(`\n   ℹ️  ${request.worktreePath} is not a removable worktree of this repo (it may be the\n`
+                + '       primary clone, or already gone). Nothing removed.\n');
+            return null;
+        }
+        // The branch moved under us between landing and reaping — somebody checked something else out
+        // there. Whatever that is, it is not the corpse we were asked to bury.
+        if (target.branch !== request.branch) {
+            process.stdout.write(`\n   ⚠️  ${request.worktreePath} now holds '${target.branch}', not '${request.branch}'.\n`
+                + '       Refusing to remove a worktree whose branch changed since the PR landed.\n');
+            return null;
+        }
+        if (!target.deletable) {
+            process.stdout.write(`\n   ⚠️  ${request.worktreePath} is not provably dead: ${target.reason}\n`
+                + '       Refusing to remove a worktree that may still hold unmerged work.\n');
+            return null;
+        }
+        return target;
+    }
+    // The reap report, plus the spared case — which report() renders as '' because from wp-cleanup's
+    // point of view "nothing happened" is a whole answer. Here it never is: we asked for exactly one.
+    render(result) {
+        if (result.reaped.length === 0 && result.failed.length === 0) {
+            let out = '\n' + SEP + '🛑 Nothing removed\n' + SEP + '\n';
+            for (const tree of result.spared)
+                out += `   · ${tree.path} — ${tree.reason}\n`;
+            return out;
+        }
+        return this.worktreeSection.report(result);
+    }
+    // `<worktree-path> <branch>`, both required. Thrown rather than printed: bad argv means the caller
+    // is broken, and there is no landed PR in this process whose success a non-zero exit could misreport.
+    parse(args) {
+        const worktreePath = args[0] ?? '';
+        const branch = args[1] ?? '';
+        if (worktreePath === '' || branch === '') {
+            throw new rules_config_1.InformAiError('\n' + SEP + '❌ wp-reap-worktree: missing arguments\n' + SEP + '\n'
+                + 'Usage: node wp-reap-worktree.js <worktree-path> <branch>\n\n'
+                + 'This is an INTERNAL entry point, spawned by `pnpm wp-land-pr` with cwd set to the\n'
+                + 'primary clone. To clean up by hand, run `pnpm wp-cleanup` from the primary clone.\n' + SEP);
+        }
+        return new ReapRequest(worktreePath, branch);
+    }
+};
+exports.ReapWorktreeCommand = ReapWorktreeCommand;
+exports.ReapWorktreeCommand = ReapWorktreeCommand = tslib_1.__decorate([
+    (0, inversify_1.injectable)(inversify_1.bindingScopeValues.Singleton),
+    tslib_1.__metadata("design:paramtypes", [rules_config_1.RepoRootFinder,
+        worktree_cleanup_1.WorktreeCleanupSection])
+], ReapWorktreeCommand);
+// Data-only (per CLAUDE.md, classes for data): the pair of argv values this entry point takes.
+class ReapRequest {
+    worktreePath;
+    branch;
+    constructor(worktreePath, branch) {
+        this.worktreePath = worktreePath;
+        this.branch = branch;
+    }
+}
+//# sourceMappingURL=reap-worktree-command.js.map

package/src/scripts/commands/reap-worktree-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reap-worktree-command.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/pr-gate/src/scripts/commands/reap-worktree-command.ts"],"names":[],"mappings":";;;;AAAA,mDAA6B;AAC7B,0DAMiC;AACjC,yCAA2D;AAE3D,yDAA4D;AAE5D,MAAM,GAAG,GAAG,0DAA0D,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;GAmBG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAEP;IACA;IAFrB,YACqB,cAA8B,EAC9B,eAAuC;QADvC,mBAAc,GAAd,cAAc,CAAgB;QAC9B,oBAAe,GAAf,eAAe,CAAwB;IACzD,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,IAAc;QACpB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO;QAE5B,MAAM,SAAS,GAAG,IAAA,8BAAe,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;QACtF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACK,aAAa,CAAC,QAAgB,EAAE,OAAoB;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACjD,IAAI,CAAC,CAAC,IAAuB,EAAW,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC;QAEpF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,YAAY,OAAO,CAAC,YAAY,4DAA4D;kBAC1F,4DAA4D,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,8FAA8F;QAC9F,uEAAuE;QACvE,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,YAAY,OAAO,CAAC,YAAY,eAAe,MAAM,CAAC,MAAM,WAAW,OAAO,CAAC,MAAM,MAAM;kBACzF,kFAAkF,CAAC,CAAC;YAC1F,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,YAAY,OAAO,CAAC,YAAY,0BAA0B,MAAM,CAAC,MAAM,IAAI;kBACzE,2EAA2E,CAAC,CAAC;YACnF,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,iGAAiG;IACjG,kGAAkG;IAC1F,MAAM,CAAC,MAA0B;QACrC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,IAAI,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,sBAAsB,GAAG,GAAG,GAAG,IAAI,CAAC;YAC3D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM;gBAAE,GAAG,IAAI,QAAQ,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC;YAChF,OAAO,GAAG,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,mGAAmG;IACnG,sGAAsG;IAC9F,KAAK,CAAC,IAAc;QACxB,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,YAAY,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,4BAAa,CACnB,IAAI,GAAG,GAAG,GAAG,yCAAyC,GAAG,GAAG,GAAG,IAAI;kBACjE,8DAA8D;kBAC9D,qFAAqF;kBACrF,qFAAqF,GAAG,GAAG,CAAC,CAAC;QACvG,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;CACJ,CAAA;AA7EY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,sBAAU,EAAC,8BAAkB,CAAC,SAAS,CAAC;6CAGA,6BAAc;QACb,yCAAsB;GAHnD,mBAAmB,CA6E/B;AAED,+FAA+F;AAC/F,MAAM,WAAW;IACb,YAAY,CAAS;IACrB,MAAM,CAAS;IAEf,YAAY,YAAoB,EAAE,MAAc;QAC5C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;CACJ","sourcesContent":["import * as path from 'path';\nimport {\n    DeletableWorktree,\n    InformAiError,\n    RepoRootFinder,\n    WorktreeReapResult,\n    loadAndValidate,\n} from '@webpieces/rules-config';\nimport { injectable, bindingScopeValues } from 'inversify';\n\nimport { WorktreeCleanupSection } from './worktree-cleanup';\n\nconst SEP = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\\n';\n\n/**\n * The CHILD side of `wp-land-pr`'s re-exec: reap ONE named worktree, from a process whose cwd is the\n * primary clone.\n *\n * It is not a published `bin`. Nothing about it is a verb a human should reach for — `pnpm wp-cleanup`\n * is that verb, and it does strictly more. This exists so the parent can hand off a SINGLE, already\n * identified corpse without also reaping every other agent's worktree as a side effect of landing one\n * PR. LandedWorktreeReaper spawns it by absolute path; see that class for why a child rather than a\n * `process.chdir`.\n *\n * WHAT IT WILL NOT TAKE ON TRUST. The parent tells it a path and a branch; it believes neither.\n * The verdict is recomputed here, from scratch, by the same MergedBranchesService that backs\n * `wp-cleanup` — so a worktree is removed only when it is PROVABLY dead (its PR is merged), and never\n * because a caller said so. That is what keeps \"never remove a tree still holding unmerged work\" true\n * even if the parent is wrong, out of date, or someone runs this by hand.\n *\n * The primary clone can never be a target: `classifyWorktrees` drops the main worktree from the\n * verdicts outright, so a path pointing at it simply does not resolve to a target — and WorktreeReaper\n * refuses it a second time by name. Neither rail is load-bearing alone.\n */\n@injectable(bindingScopeValues.Singleton)\nexport class ReapWorktreeCommand {\n    constructor(\n        private readonly repoRootFinder: RepoRootFinder,\n        private readonly worktreeSection: WorktreeCleanupSection,\n    ) {}\n\n    async run(args: string[]): Promise<void> {\n        await Promise.resolve();\n        const request = this.parse(args);\n        const repoRoot = this.repoRootFinder.resolveRepoRoot(process.cwd());\n\n        const target = this.resolveTarget(repoRoot, request);\n        if (target === null) return;\n\n        const retention = loadAndValidate(repoRoot).prGate.landPr.branchRetention;\n        const result = this.worktreeSection.reap(repoRoot, 'wp-land-pr', [target], retention);\n        process.stdout.write(this.render(result));\n    }\n\n    /**\n     * The verdict for the requested path, or null after printing WHY it is not reapable. Refusals are\n     * printed rather than thrown: the PR they follow is already merged, and exiting non-zero after a\n     * successful landing would report a landed PR as a failed command.\n     */\n    private resolveTarget(repoRoot: string, request: ReapRequest): DeletableWorktree | null {\n        const wanted = path.resolve(request.worktreePath);\n        const target = this.worktreeSection.verdicts(repoRoot)\n            .find((tree: DeletableWorktree): boolean => path.resolve(tree.path) === wanted);\n\n        if (target === undefined) {\n            process.stdout.write(\n                `\\n   ℹ️  ${request.worktreePath} is not a removable worktree of this repo (it may be the\\n`\n                + '       primary clone, or already gone). Nothing removed.\\n');\n            return null;\n        }\n        // The branch moved under us between landing and reaping — somebody checked something else out\n        // there. Whatever that is, it is not the corpse we were asked to bury.\n        if (target.branch !== request.branch) {\n            process.stdout.write(\n                `\\n   ⚠️  ${request.worktreePath} now holds '${target.branch}', not '${request.branch}'.\\n`\n                + '       Refusing to remove a worktree whose branch changed since the PR landed.\\n');\n            return null;\n        }\n        if (!target.deletable) {\n            process.stdout.write(\n                `\\n   ⚠️  ${request.worktreePath} is not provably dead: ${target.reason}\\n`\n                + '       Refusing to remove a worktree that may still hold unmerged work.\\n');\n            return null;\n        }\n        return target;\n    }\n\n    // The reap report, plus the spared case — which report() renders as '' because from wp-cleanup's\n    // point of view \"nothing happened\" is a whole answer. Here it never is: we asked for exactly one.\n    private render(result: WorktreeReapResult): string {\n        if (result.reaped.length === 0 && result.failed.length === 0) {\n            let out = '\\n' + SEP + '🛑 Nothing removed\\n' + SEP + '\\n';\n            for (const tree of result.spared) out += `   · ${tree.path} — ${tree.reason}\\n`;\n            return out;\n        }\n        return this.worktreeSection.report(result);\n    }\n\n    // `<worktree-path> <branch>`, both required. Thrown rather than printed: bad argv means the caller\n    // is broken, and there is no landed PR in this process whose success a non-zero exit could misreport.\n    private parse(args: string[]): ReapRequest {\n        const worktreePath = args[0] ?? '';\n        const branch = args[1] ?? '';\n        if (worktreePath === '' || branch === '') {\n            throw new InformAiError(\n                '\\n' + SEP + '❌ wp-reap-worktree: missing arguments\\n' + SEP + '\\n'\n                + 'Usage: node wp-reap-worktree.js <worktree-path> <branch>\\n\\n'\n                + 'This is an INTERNAL entry point, spawned by `pnpm wp-land-pr` with cwd set to the\\n'\n                + 'primary clone. To clean up by hand, run `pnpm wp-cleanup` from the primary clone.\\n' + SEP);\n        }\n        return new ReapRequest(worktreePath, branch);\n    }\n}\n\n// Data-only (per CLAUDE.md, classes for data): the pair of argv values this entry point takes.\nclass ReapRequest {\n    worktreePath: string;\n    branch: string;\n\n    constructor(worktreePath: string, branch: string) {\n        this.worktreePath = worktreePath;\n        this.branch = branch;\n    }\n}\n"]}

package/src/scripts/pr-gate-app.d.ts

@@ -6,6 +6,7 @@ import { CleanupCommand } from './commands/cleanup-command';
 import { LandPrCommand } from './commands/land-pr-command';
 import { CheckPrCommand } from './commands/check-pr-command';
 import { ReviewUpsertPrCommand } from './commands/review-upsert-pr-command';
+import { ReapWorktreeCommand } from './commands/reap-worktree-command';
 /**
  * The pr-gate application root. `container.get(PrGateApp)` resolves the entire workflow DAG (the command
  * classes → the injected git/merge/dashboard services). `@DocumentDesign` marks it the
@@ -21,7 +22,14 @@ export declare class PrGateApp {
     private readonly landPrCommand;
     private readonly checkPrCommand;
     private readonly reviewUpsertPrCommand;
-    constructor(startUpdateCommand: StartUpdateCommand, finishUpdateCommand: FinishUpdateCommand, startUpsertPrCommand: StartUpsertPrCommand, finishUpsertPrCommand: FinishUpsertPrCommand, cleanupCommand: CleanupCommand, landPrCommand: LandPrCommand, checkPrCommand: CheckPrCommand, reviewUpsertPrCommand: ReviewUpsertPrCommand);
+    private readonly reapWorktreeCommand;
+    constructor(startUpdateCommand: StartUpdateCommand, finishUpdateCommand: FinishUpdateCommand, startUpsertPrCommand: StartUpsertPrCommand, finishUpsertPrCommand: FinishUpsertPrCommand, cleanupCommand: CleanupCommand, landPrCommand: LandPrCommand, checkPrCommand: CheckPrCommand, reviewUpsertPrCommand: ReviewUpsertPrCommand, reapWorktreeCommand: ReapWorktreeCommand);
+    /**
+     * INTERNAL (`wp-reap-worktree.js`, no `bin` entry): remove ONE named worktree and its branch.
+     * `wp-land-pr` spawns it with cwd = the primary clone so the tree it just landed from can be
+     * reaped by a process that is not standing in it.
+     */
+    reapWorktree(args: string[]): Promise<void>;
     /** `wp-start-update`: 3-point squash-update from main (no PR). */
     startUpdate(): Promise<void>;
     /** `wp-finish-update`: validate + finalize a resolved 3-point merge (no PR). */

package/src/scripts/pr-gate-app.js

@@ -12,6 +12,7 @@ const cleanup_command_1 = require("./commands/cleanup-command");
 const land_pr_command_1 = require("./commands/land-pr-command");
 const check_pr_command_1 = require("./commands/check-pr-command");
 const review_upsert_pr_command_1 = require("./commands/review-upsert-pr-command");
+const reap_worktree_command_1 = require("./commands/reap-worktree-command");
 /**
  * The pr-gate application root. `container.get(PrGateApp)` resolves the entire workflow DAG (the command
  * classes → the injected git/merge/dashboard services). `@DocumentDesign` marks it the
@@ -27,7 +28,8 @@ let PrGateApp = class PrGateApp {
     landPrCommand;
     checkPrCommand;
     reviewUpsertPrCommand;
-    constructor(startUpdateCommand, finishUpdateCommand, startUpsertPrCommand, finishUpsertPrCommand, cleanupCommand, landPrCommand, checkPrCommand, reviewUpsertPrCommand) {
+    reapWorktreeCommand;
+    constructor(startUpdateCommand, finishUpdateCommand, startUpsertPrCommand, finishUpsertPrCommand, cleanupCommand, landPrCommand, checkPrCommand, reviewUpsertPrCommand, reapWorktreeCommand) {
         this.startUpdateCommand = startUpdateCommand;
         this.finishUpdateCommand = finishUpdateCommand;
         this.startUpsertPrCommand = startUpsertPrCommand;
@@ -36,6 +38,15 @@ let PrGateApp = class PrGateApp {
         this.landPrCommand = landPrCommand;
         this.checkPrCommand = checkPrCommand;
         this.reviewUpsertPrCommand = reviewUpsertPrCommand;
+        this.reapWorktreeCommand = reapWorktreeCommand;
+    }
+    /**
+     * INTERNAL (`wp-reap-worktree.js`, no `bin` entry): remove ONE named worktree and its branch.
+     * `wp-land-pr` spawns it with cwd = the primary clone so the tree it just landed from can be
+     * reaped by a process that is not standing in it.
+     */
+    reapWorktree(args) {
+        return this.reapWorktreeCommand.run(args);
     }
     /** `wp-start-update`: 3-point squash-update from main (no PR). */
     startUpdate() {
@@ -85,6 +96,7 @@ exports.PrGateApp = PrGateApp = tslib_1.__decorate([
         cleanup_command_1.CleanupCommand,
         land_pr_command_1.LandPrCommand,
         check_pr_command_1.CheckPrCommand,
-        review_upsert_pr_command_1.ReviewUpsertPrCommand])
+        review_upsert_pr_command_1.ReviewUpsertPrCommand,
+        reap_worktree_command_1.ReapWorktreeCommand])
 ], PrGateApp);
 //# sourceMappingURL=pr-gate-app.js.map

package/src/scripts/pr-gate-app.js.map

@@ -1 +1 @@
-{"version":3,"file":"pr-gate-app.js","sourceRoot":"","sources":["../../../../../../packages/tooling/pr-gate/src/scripts/pr-gate-app.ts"],"names":[],"mappings":";;;;AAAA,0DAAyD;AACzD,yCAA2D;AAC3D,0EAAqE;AACrE,4EAAuE;AACvE,gFAA0E;AAC1E,kFAA4E;AAC5E,gEAA4D;AAC5D,gEAA2D;AAC3D,kEAA6D;AAC7D,kFAA4E;AAE5E;;;;;GAKG;AAGI,IAAM,SAAS,GAAf,MAAM,SAAS;IAEG;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IARrB,YACqB,kBAAsC,EACtC,mBAAwC,EACxC,oBAA0C,EAC1C,qBAA4C,EAC5C,cAA8B,EAC9B,aAA4B,EAC5B,cAA8B,EAC9B,qBAA4C;QAP5C,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,wBAAmB,GAAnB,mBAAmB,CAAqB;QACxC,yBAAoB,GAApB,oBAAoB,CAAsB;QAC1C,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,kBAAa,GAAb,aAAa,CAAe;QAC5B,mBAAc,GAAd,cAAc,CAAgB;QAC9B,0BAAqB,GAArB,qBAAqB,CAAuB;IAC9D,CAAC;IAEJ,kEAAkE;IAClE,WAAW;QACP,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC;IACzC,CAAC;IAED,gFAAgF;IAChF,YAAY;QACR,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC;IAC1C,CAAC;IAED,4GAA4G;IAC5G,aAAa;QACT,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,CAAC;IAC3C,CAAC;IAED,oGAAoG;IACpG,cAAc;QACV,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC;IAC5C,CAAC;IAED,mGAAmG;IACnG,OAAO;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAED,0FAA0F;IAC1F,MAAM;QACF,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,cAAc;QACV,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC;IAC5C,CAAC;IAED,+GAA+G;IAC/G,OAAO;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;CACJ,CAAA;AAvDY,8BAAS;oBAAT,SAAS;IAFrB,IAAA,6BAAc,GAAE;IAChB,IAAA,sBAAU,EAAC,8BAAkB,CAAC,SAAS,CAAC;6CAGI,yCAAkB;QACjB,2CAAmB;QAClB,8CAAoB;QACnB,gDAAqB;QAC5B,gCAAc;QACf,+BAAa;QACZ,iCAAc;QACP,gDAAqB;GATxD,SAAS,CAuDrB","sourcesContent":["import { DocumentDesign } from '@webpieces/rules-config';\nimport { injectable, bindingScopeValues } from 'inversify';\nimport { StartUpdateCommand } from './commands/start-update-command';\nimport { FinishUpdateCommand } from './commands/finish-update-command';\nimport { StartUpsertPrCommand } from './commands/start-upsert-pr-command';\nimport { FinishUpsertPrCommand } from './commands/finish-upsert-pr-command';\nimport { CleanupCommand } from './commands/cleanup-command';\nimport { LandPrCommand } from './commands/land-pr-command';\nimport { CheckPrCommand } from './commands/check-pr-command';\nimport { ReviewUpsertPrCommand } from './commands/review-upsert-pr-command';\n\n/**\n * The pr-gate application root. `container.get(PrGateApp)` resolves the entire workflow DAG (the command\n * classes → the injected git/merge/dashboard services). `@DocumentDesign` marks it the\n * top-of-DAG the DI-design analyzer roots on, so `role:app` pr-gate draws its design. Each `bin/*`\n * entry resolves THIS and calls the matching command method.\n */\n@DocumentDesign()\n@injectable(bindingScopeValues.Singleton)\nexport class PrGateApp {\n    constructor(\n        private readonly startUpdateCommand: StartUpdateCommand,\n        private readonly finishUpdateCommand: FinishUpdateCommand,\n        private readonly startUpsertPrCommand: StartUpsertPrCommand,\n        private readonly finishUpsertPrCommand: FinishUpsertPrCommand,\n        private readonly cleanupCommand: CleanupCommand,\n        private readonly landPrCommand: LandPrCommand,\n        private readonly checkPrCommand: CheckPrCommand,\n        private readonly reviewUpsertPrCommand: ReviewUpsertPrCommand,\n    ) {}\n\n    /** `wp-start-update`: 3-point squash-update from main (no PR). */\n    startUpdate(): Promise<void> {\n        return this.startUpdateCommand.run();\n    }\n\n    /** `wp-finish-update`: validate + finalize a resolved 3-point merge (no PR). */\n    finishUpdate(): Promise<void> {\n        return this.finishUpdateCommand.run();\n    }\n\n    /** `wp-start-upsert-pr`: update from main (3-point merge), hand off review.json. No build gate, no push. */\n    startUpsertPr(): Promise<void> {\n        return this.startUpsertPrCommand.run();\n    }\n\n    /** `wp-finish-upsert-pr`: finalize merge, authoritative build gate, dashboard, create/update PR. */\n    finishUpsertPr(): Promise<void> {\n        return this.finishUpsertPrCommand.run();\n    }\n\n    /** `wp-cleanup`: reap what is provably merged, and ASK about everything that merely looks dead. */\n    cleanup(): Promise<void> {\n        return this.cleanupCommand.run();\n    }\n\n    /** `wp-land-pr`: squash-merge this branch's PR into main with the compact commit body. */\n    landPr(): Promise<void> {\n        return this.landPrCommand.run();\n    }\n\n    /**\n     * `wp-review-upsert-pr`: STAGE ② — validate the 3-point merge, run the build gate, extract this\n     * branch's diff, and brief the reviewer subagents. Unlike the report-only command it replaces, this CAN\n     * fail — before any reviewer is spawned, so a broken branch costs no reviewer tokens.\n     */\n    reviewUpsertPr(): Promise<void> {\n        return this.reviewUpsertPrCommand.run();\n    }\n\n    /** `wp-check-pr`: READ-ONLY CI check — verify the PR body carries a valid HMAC gate token for its head sha. */\n    checkPr(): Promise<void> {\n        return this.checkPrCommand.run();\n    }\n}\n"]}
+{"version":3,"file":"pr-gate-app.js","sourceRoot":"","sources":["../../../../../../packages/tooling/pr-gate/src/scripts/pr-gate-app.ts"],"names":[],"mappings":";;;;AAAA,0DAAyD;AACzD,yCAA2D;AAC3D,0EAAqE;AACrE,4EAAuE;AACvE,gFAA0E;AAC1E,kFAA4E;AAC5E,gEAA4D;AAC5D,gEAA2D;AAC3D,kEAA6D;AAC7D,kFAA4E;AAC5E,4EAAuE;AAEvE;;;;;GAKG;AAGI,IAAM,SAAS,GAAf,MAAM,SAAS;IAEG;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IATrB,YACqB,kBAAsC,EACtC,mBAAwC,EACxC,oBAA0C,EAC1C,qBAA4C,EAC5C,cAA8B,EAC9B,aAA4B,EAC5B,cAA8B,EAC9B,qBAA4C,EAC5C,mBAAwC;QARxC,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,wBAAmB,GAAnB,mBAAmB,CAAqB;QACxC,yBAAoB,GAApB,oBAAoB,CAAsB;QAC1C,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,kBAAa,GAAb,aAAa,CAAe;QAC5B,mBAAc,GAAd,cAAc,CAAgB;QAC9B,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,wBAAmB,GAAnB,mBAAmB,CAAqB;IAC1D,CAAC;IAEJ;;;;OAIG;IACH,YAAY,CAAC,IAAc;QACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,kEAAkE;IAClE,WAAW;QACP,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC;IACzC,CAAC;IAED,gFAAgF;IAChF,YAAY;QACR,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC;IAC1C,CAAC;IAED,4GAA4G;IAC5G,aAAa;QACT,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,CAAC;IAC3C,CAAC;IAED,oGAAoG;IACpG,cAAc;QACV,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC;IAC5C,CAAC;IAED,mGAAmG;IACnG,OAAO;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAED,0FAA0F;IAC1F,MAAM;QACF,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,cAAc;QACV,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC;IAC5C,CAAC;IAED,+GAA+G;IAC/G,OAAO;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;CACJ,CAAA;AAjEY,8BAAS;oBAAT,SAAS;IAFrB,IAAA,6BAAc,GAAE;IAChB,IAAA,sBAAU,EAAC,8BAAkB,CAAC,SAAS,CAAC;6CAGI,yCAAkB;QACjB,2CAAmB;QAClB,8CAAoB;QACnB,gDAAqB;QAC5B,gCAAc;QACf,+BAAa;QACZ,iCAAc;QACP,gDAAqB;QACvB,2CAAmB;GAVpD,SAAS,CAiErB","sourcesContent":["import { DocumentDesign } from '@webpieces/rules-config';\nimport { injectable, bindingScopeValues } from 'inversify';\nimport { StartUpdateCommand } from './commands/start-update-command';\nimport { FinishUpdateCommand } from './commands/finish-update-command';\nimport { StartUpsertPrCommand } from './commands/start-upsert-pr-command';\nimport { FinishUpsertPrCommand } from './commands/finish-upsert-pr-command';\nimport { CleanupCommand } from './commands/cleanup-command';\nimport { LandPrCommand } from './commands/land-pr-command';\nimport { CheckPrCommand } from './commands/check-pr-command';\nimport { ReviewUpsertPrCommand } from './commands/review-upsert-pr-command';\nimport { ReapWorktreeCommand } from './commands/reap-worktree-command';\n\n/**\n * The pr-gate application root. `container.get(PrGateApp)` resolves the entire workflow DAG (the command\n * classes → the injected git/merge/dashboard services). `@DocumentDesign` marks it the\n * top-of-DAG the DI-design analyzer roots on, so `role:app` pr-gate draws its design. Each `bin/*`\n * entry resolves THIS and calls the matching command method.\n */\n@DocumentDesign()\n@injectable(bindingScopeValues.Singleton)\nexport class PrGateApp {\n    constructor(\n        private readonly startUpdateCommand: StartUpdateCommand,\n        private readonly finishUpdateCommand: FinishUpdateCommand,\n        private readonly startUpsertPrCommand: StartUpsertPrCommand,\n        private readonly finishUpsertPrCommand: FinishUpsertPrCommand,\n        private readonly cleanupCommand: CleanupCommand,\n        private readonly landPrCommand: LandPrCommand,\n        private readonly checkPrCommand: CheckPrCommand,\n        private readonly reviewUpsertPrCommand: ReviewUpsertPrCommand,\n        private readonly reapWorktreeCommand: ReapWorktreeCommand,\n    ) {}\n\n    /**\n     * INTERNAL (`wp-reap-worktree.js`, no `bin` entry): remove ONE named worktree and its branch.\n     * `wp-land-pr` spawns it with cwd = the primary clone so the tree it just landed from can be\n     * reaped by a process that is not standing in it.\n     */\n    reapWorktree(args: string[]): Promise<void> {\n        return this.reapWorktreeCommand.run(args);\n    }\n\n    /** `wp-start-update`: 3-point squash-update from main (no PR). */\n    startUpdate(): Promise<void> {\n        return this.startUpdateCommand.run();\n    }\n\n    /** `wp-finish-update`: validate + finalize a resolved 3-point merge (no PR). */\n    finishUpdate(): Promise<void> {\n        return this.finishUpdateCommand.run();\n    }\n\n    /** `wp-start-upsert-pr`: update from main (3-point merge), hand off review.json. No build gate, no push. */\n    startUpsertPr(): Promise<void> {\n        return this.startUpsertPrCommand.run();\n    }\n\n    /** `wp-finish-upsert-pr`: finalize merge, authoritative build gate, dashboard, create/update PR. */\n    finishUpsertPr(): Promise<void> {\n        return this.finishUpsertPrCommand.run();\n    }\n\n    /** `wp-cleanup`: reap what is provably merged, and ASK about everything that merely looks dead. */\n    cleanup(): Promise<void> {\n        return this.cleanupCommand.run();\n    }\n\n    /** `wp-land-pr`: squash-merge this branch's PR into main with the compact commit body. */\n    landPr(): Promise<void> {\n        return this.landPrCommand.run();\n    }\n\n    /**\n     * `wp-review-upsert-pr`: STAGE ② — validate the 3-point merge, run the build gate, extract this\n     * branch's diff, and brief the reviewer subagents. Unlike the report-only command it replaces, this CAN\n     * fail — before any reviewer is spawned, so a broken branch costs no reviewer tokens.\n     */\n    reviewUpsertPr(): Promise<void> {\n        return this.reviewUpsertPrCommand.run();\n    }\n\n    /** `wp-check-pr`: READ-ONLY CI check — verify the PR body carries a valid HMAC gate token for its head sha. */\n    checkPr(): Promise<void> {\n        return this.checkPrCommand.run();\n    }\n}\n"]}

package/src/scripts/workflow/landed-worktree-reaper.d.ts

@@ -0,0 +1,62 @@
+import { WorktreeService } from '@webpieces/rules-config';
+/**
+ * Data-only (per CLAUDE.md, classes for data). The decision about the just-landed worktree: which
+ * directory, which branch, where the reap must run FROM, and — when it cannot run — why not.
+ */
+export declare class WorktreeReapHandoff {
+    /** The linked worktree holding the branch that was just landed. */
+    readonly worktreePath: string;
+    readonly branch: string;
+    /** The primary clone — the child's `cwd`, and the directory a human must `cd` to afterwards. */
+    readonly primaryPath: string;
+    /** The compiled entry the child runs. '' when it could not be located on disk. */
+    readonly entryScript: string;
+    /** '' when the hand-off can run; otherwise the reason it cannot, in one human-readable clause. */
+    readonly blockedBecause: string;
+    /** Precomputed (as EffectiveTree does with `redirected`) so no caller re-derives the rule. */
+    readonly canReap: boolean;
+    constructor(worktreePath: string, branch: string, primaryPath: string, entryScript: string, blockedBecause: string);
+}
+export declare class LandedWorktreeReaper {
+    private readonly worktrees;
+    constructor(worktrees: WorktreeService);
+    /**
+     * Is there a worktree to reap at all, and can the hand-off run?
+     *
+     * `null` means "nothing to do here" — we are in the primary clone, or in a worktree that does not
+     * hold the branch that just landed. That is the ordinary `pnpm wp-cleanup` case and needs no
+     * special sentence. A non-null handoff with `canReap === false` means there IS a corpse but the
+     * re-exec is not safely achievable, which is the case that must keep the manual notice.
+     */
+    plan(repoRoot: string, landedBranch: string): WorktreeReapHandoff | null;
+    /**
+     * Run the reap in a child process rooted in the primary clone, and render what happened.
+     *
+     * stdin is `ignore` deliberately: the child must never be able to ask a question. A prompt printed
+     * into a landing recap nobody is watching is not consent, and this reap is authorised by the merge
+     * that just succeeded, not by an answer.
+     */
+    handOff(handoff: WorktreeReapHandoff): string;
+    /**
+     * The #512 notice, kept verbatim in spirit for every case the re-exec cannot cover. An honest
+     * limitation beats a command that deletes its own working directory mid-run.
+     */
+    manualNotice(handoff: WorktreeReapHandoff): string;
+    /**
+     * The one thing a human or agent MUST be told after a successful reap: the shell they typed this
+     * into is now sitting in a directory that no longer exists. Every relative path from here on is a
+     * mystery ENOENT unless they move.
+     */
+    private afterReap;
+    /**
+     * WHERE the child's entry point lives — a seam, overridden in the spec, because under vitest this
+     * package runs from `.ts` sources and the compiled sibling does not exist.
+     *
+     * Resolved from `__dirname`, i.e. from THIS package's own installed files, NOT by remapping a path
+     * into the primary clone. The primary clone may have a different @webpieces/pr-gate version
+     * installed, and re-exec'ing a build that predates this feature would silently do something else.
+     * The files are read into the child before it removes anything, so the directory going away
+     * underneath them afterwards is harmless.
+     */
+    protected reapEntryScript(): string;
+}

package/src/scripts/workflow/landed-worktree-reaper.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LandedWorktreeReaper = exports.WorktreeReapHandoff = void 0;
+const tslib_1 = require("tslib");
+const child_process_1 = require("child_process");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const rules_config_1 = require("@webpieces/rules-config");
+const inversify_1 = require("inversify");
+/**
+ * The RE-EXEC half of `wp-land-pr`: reap the worktree the command is standing in, from a process that
+ * is NOT standing in it.
+ *
+ * THE PROBLEM. `wp-land-pr` squash-merges the branch checked out in the worktree it runs in. The
+ * moment that lands, both the branch and the directory are dead — but removing them from in here means
+ * deleting the files underneath the running process, which is exactly what every rail in WorktreeReaper
+ * refuses. #512 took this to an honest halfway point: print `cd <primary> && pnpm wp-cleanup` and stop.
+ * Correct, and the single most-skipped step in the whole flow, because the PR is already landed and the
+ * work FEELS done. Every skipped one leaves a corpse, and corpses are what trip branch-creation-guard.
+ *
+ * THE FIX. Do not reap in this process at all — hand the reap to a CHILD process whose `cwd` is the
+ * PRIMARY CLONE. The child's cwd is a directory nobody is deleting, so `git worktree remove` is an
+ * ordinary removal of somebody else's directory, and every existing rail still holds inside the child
+ * (it refuses its own cwd, which is now the primary clone, and it refuses the primary clone by name).
+ *
+ * WHY `WorktreeService` AND NOT `EffectiveTreeResolver`. EffectiveTreeResolver (ai-hook-rules) answers
+ * "which tree does this BASH COMMAND STRING act on" — it takes a command, resolves its leading `cd`
+ * run, and classifies foreign/outside repos for the PreToolUse guards. There is no command string
+ * here, pr-gate does not (and must not) depend on ai-hook-rules, and the only question being asked is
+ * "which of git's worktrees is the primary clone, and which one holds this branch". That is
+ * WorktreeService's whole job, and it is already the authority WorktreeReaper itself uses to decide
+ * what is protected — using a second resolver would risk the two disagreeing about which tree we are
+ * in, which for a directory deletion is the one disagreement nobody survives.
+ *
+ * WHY A CHILD AND NOT AN IN-PROCESS `chdir`. `process.chdir(primary)` would leave this node process's
+ * own module graph rooted in a directory that is about to be deleted, and its lazily-resolved requires
+ * with it. The child is spawned from THIS package's own files (same version — no skew with whatever
+ * the primary clone has installed), and it finishes loading them before it removes anything.
+ */
+const SEP = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
+/**
+ * Data-only (per CLAUDE.md, classes for data). The decision about the just-landed worktree: which
+ * directory, which branch, where the reap must run FROM, and — when it cannot run — why not.
+ */
+class WorktreeReapHandoff {
+    /** The linked worktree holding the branch that was just landed. */
+    worktreePath;
+    branch;
+    /** The primary clone — the child's `cwd`, and the directory a human must `cd` to afterwards. */
+    primaryPath;
+    /** The compiled entry the child runs. '' when it could not be located on disk. */
+    entryScript;
+    /** '' when the hand-off can run; otherwise the reason it cannot, in one human-readable clause. */
+    blockedBecause;
+    /** Precomputed (as EffectiveTree does with `redirected`) so no caller re-derives the rule. */
+    canReap;
+    // eslint-disable-next-line @typescript-eslint/max-params
+    constructor(worktreePath, branch, primaryPath, entryScript, blockedBecause) {
+        this.worktreePath = worktreePath;
+        this.branch = branch;
+        this.primaryPath = primaryPath;
+        this.entryScript = entryScript;
+        this.blockedBecause = blockedBecause;
+        this.canReap = blockedBecause === '';
+    }
+}
+exports.WorktreeReapHandoff = WorktreeReapHandoff;
+let LandedWorktreeReaper = class LandedWorktreeReaper {
+    worktrees;
+    constructor(worktrees) {
+        this.worktrees = worktrees;
+    }
+    /**
+     * Is there a worktree to reap at all, and can the hand-off run?
+     *
+     * `null` means "nothing to do here" — we are in the primary clone, or in a worktree that does not
+     * hold the branch that just landed. That is the ordinary `pnpm wp-cleanup` case and needs no
+     * special sentence. A non-null handoff with `canReap === false` means there IS a corpse but the
+     * re-exec is not safely achievable, which is the case that must keep the manual notice.
+     */
+    plan(repoRoot, landedBranch) {
+        const here = this.worktrees.currentWorktree(repoRoot);
+        if (here === null || here.isMain || here.branch !== landedBranch)
+            return null;
+        const primary = this.worktrees.listWorktrees(repoRoot)
+            .find((tree) => tree.isMain);
+        if (primary === undefined) {
+            return new WorktreeReapHandoff(here.path, landedBranch, '<the primary clone>', '', 'git did not report a primary clone, so there is no safe directory to reap from');
+        }
+        const entry = this.reapEntryScript();
+        if (entry === '') {
+            return new WorktreeReapHandoff(here.path, landedBranch, primary.path, '', 'the reap entry point is not on disk (this package is running unbuilt)');
+        }
+        return new WorktreeReapHandoff(here.path, landedBranch, primary.path, entry, '');
+    }
+    /**
+     * Run the reap in a child process rooted in the primary clone, and render what happened.
+     *
+     * stdin is `ignore` deliberately: the child must never be able to ask a question. A prompt printed
+     * into a landing recap nobody is watching is not consent, and this reap is authorised by the merge
+     * that just succeeded, not by an answer.
+     */
+    handOff(handoff) {
+        const result = (0, child_process_1.spawnSync)(process.execPath, [handoff.entryScript, handoff.worktreePath, handoff.branch], { cwd: handoff.primaryPath, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+        const output = `${result.stdout ?? ''}${result.stderr ?? ''}`.trimEnd();
+        const head = '\n' + SEP + `🌲 Reaping this worktree from ${handoff.primaryPath}\n` + SEP + '\n'
+            + `   The branch just landed, so this directory is dead. The reap runs in a child process\n`
+            + `   whose cwd is the primary clone — nothing deletes the directory it is standing in.\n\n`;
+        if (result.status !== 0) {
+            return head + (output !== '' ? output + '\n' : '')
+                + `\n   ⚠️  The reap did not complete (exit ${String(result.status ?? -1)}). Nothing was forced.\n`
+                + this.manualNotice(handoff);
+        }
+        return head + (output !== '' ? output + '\n' : '') + this.afterReap(handoff);
+    }
+    /**
+     * The #512 notice, kept verbatim in spirit for every case the re-exec cannot cover. An honest
+     * limitation beats a command that deletes its own working directory mid-run.
+     */
+    manualNotice(handoff) {
+        const why = handoff.blockedBecause !== '' ? `         (${handoff.blockedBecause})\n` : '';
+        return '   Next: this branch is checked out in THIS worktree, so neither it nor the worktree can\n'
+            + '         be removed from in here. Run cleanup from the primary clone instead:\n'
+            + `           cd ${handoff.primaryPath} && pnpm wp-cleanup\n`
+            + why
+            + `         It archives ${handoff.branch} as a tag, removes ${handoff.worktreePath}, then deletes the branch.\n`;
+    }
+    /**
+     * The one thing a human or agent MUST be told after a successful reap: the shell they typed this
+     * into is now sitting in a directory that no longer exists. Every relative path from here on is a
+     * mystery ENOENT unless they move.
+     */
+    afterReap(handoff) {
+        return `\n   ⚠️  ${handoff.worktreePath} NO LONGER EXISTS — your shell is standing in a deleted\n`
+            + '       directory, and every following command will fail until you move:\n'
+            + `           cd ${handoff.primaryPath}\n`;
+    }
+    /**
+     * WHERE the child's entry point lives — a seam, overridden in the spec, because under vitest this
+     * package runs from `.ts` sources and the compiled sibling does not exist.
+     *
+     * Resolved from `__dirname`, i.e. from THIS package's own installed files, NOT by remapping a path
+     * into the primary clone. The primary clone may have a different @webpieces/pr-gate version
+     * installed, and re-exec'ing a build that predates this feature would silently do something else.
+     * The files are read into the child before it removes anything, so the directory going away
+     * underneath them afterwards is harmless.
+     */
+    reapEntryScript() {
+        const entry = path.join(__dirname, '..', 'wp-reap-worktree.js');
+        return fs.existsSync(entry) ? entry : '';
+    }
+};
+exports.LandedWorktreeReaper = LandedWorktreeReaper;
+exports.LandedWorktreeReaper = LandedWorktreeReaper = tslib_1.__decorate([
+    (0, inversify_1.injectable)(inversify_1.bindingScopeValues.Singleton),
+    tslib_1.__metadata("design:paramtypes", [rules_config_1.WorktreeService])
+], LandedWorktreeReaper);
+//# sourceMappingURL=landed-worktree-reaper.js.map

package/src/scripts/workflow/landed-worktree-reaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landed-worktree-reaper.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/pr-gate/src/scripts/workflow/landed-worktree-reaper.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { Worktree, WorktreeService } from '@webpieces/rules-config';\nimport { injectable, bindingScopeValues } from 'inversify';\n\n/**\n * The RE-EXEC half of `wp-land-pr`: reap the worktree the command is standing in, from a process that\n * is NOT standing in it.\n *\n * THE PROBLEM. `wp-land-pr` squash-merges the branch checked out in the worktree it runs in. The\n * moment that lands, both the branch and the directory are dead — but removing them from in here means\n * deleting the files underneath the running process, which is exactly what every rail in WorktreeReaper\n * refuses. #512 took this to an honest halfway point: print `cd <primary> && pnpm wp-cleanup` and stop.\n * Correct, and the single most-skipped step in the whole flow, because the PR is already landed and the\n * work FEELS done. Every skipped one leaves a corpse, and corpses are what trip branch-creation-guard.\n *\n * THE FIX. Do not reap in this process at all — hand the reap to a CHILD process whose `cwd` is the\n * PRIMARY CLONE. The child's cwd is a directory nobody is deleting, so `git worktree remove` is an\n * ordinary removal of somebody else's directory, and every existing rail still holds inside the child\n * (it refuses its own cwd, which is now the primary clone, and it refuses the primary clone by name).\n *\n * WHY `WorktreeService` AND NOT `EffectiveTreeResolver`. EffectiveTreeResolver (ai-hook-rules) answers\n * \"which tree does this BASH COMMAND STRING act on\" — it takes a command, resolves its leading `cd`\n * run, and classifies foreign/outside repos for the PreToolUse guards. There is no command string\n * here, pr-gate does not (and must not) depend on ai-hook-rules, and the only question being asked is\n * \"which of git's worktrees is the primary clone, and which one holds this branch\". That is\n * WorktreeService's whole job, and it is already the authority WorktreeReaper itself uses to decide\n * what is protected — using a second resolver would risk the two disagreeing about which tree we are\n * in, which for a directory deletion is the one disagreement nobody survives.\n *\n * WHY A CHILD AND NOT AN IN-PROCESS `chdir`. `process.chdir(primary)` would leave this node process's\n * own module graph rooted in a directory that is about to be deleted, and its lazily-resolved requires\n * with it. The child is spawned from THIS package's own files (same version — no skew with whatever\n * the primary clone has installed), and it finishes loading them before it removes anything.\n */\n\nconst SEP = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\\n';\n\n/**\n * Data-only (per CLAUDE.md, classes for data). The decision about the just-landed worktree: which\n * directory, which branch, where the reap must run FROM, and — when it cannot run — why not.\n */\nexport class WorktreeReapHandoff {\n    /** The linked worktree holding the branch that was just landed. */\n    readonly worktreePath: string;\n    readonly branch: string;\n    /** The primary clone — the child's `cwd`, and the directory a human must `cd` to afterwards. */\n    readonly primaryPath: string;\n    /** The compiled entry the child runs. '' when it could not be located on disk. */\n    readonly entryScript: string;\n    /** '' when the hand-off can run; otherwise the reason it cannot, in one human-readable clause. */\n    readonly blockedBecause: string;\n    /** Precomputed (as EffectiveTree does with `redirected`) so no caller re-derives the rule. */\n    readonly canReap: boolean;\n\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(\n        worktreePath: string,\n        branch: string,\n        primaryPath: string,\n        entryScript: string,\n        blockedBecause: string,\n    ) {\n        this.worktreePath = worktreePath;\n        this.branch = branch;\n        this.primaryPath = primaryPath;\n        this.entryScript = entryScript;\n        this.blockedBecause = blockedBecause;\n        this.canReap = blockedBecause === '';\n    }\n}\n\n@injectable(bindingScopeValues.Singleton)\nexport class LandedWorktreeReaper {\n    constructor(private readonly worktrees: WorktreeService) {}\n\n    /**\n     * Is there a worktree to reap at all, and can the hand-off run?\n     *\n     * `null` means \"nothing to do here\" — we are in the primary clone, or in a worktree that does not\n     * hold the branch that just landed. That is the ordinary `pnpm wp-cleanup` case and needs no\n     * special sentence. A non-null handoff with `canReap === false` means there IS a corpse but the\n     * re-exec is not safely achievable, which is the case that must keep the manual notice.\n     */\n    plan(repoRoot: string, landedBranch: string): WorktreeReapHandoff | null {\n        const here = this.worktrees.currentWorktree(repoRoot);\n        if (here === null || here.isMain || here.branch !== landedBranch) return null;\n\n        const primary = this.worktrees.listWorktrees(repoRoot)\n            .find((tree: Worktree): boolean => tree.isMain);\n        if (primary === undefined) {\n            return new WorktreeReapHandoff(\n                here.path, landedBranch, '<the primary clone>', '',\n                'git did not report a primary clone, so there is no safe directory to reap from');\n        }\n\n        const entry = this.reapEntryScript();\n        if (entry === '') {\n            return new WorktreeReapHandoff(\n                here.path, landedBranch, primary.path, '',\n                'the reap entry point is not on disk (this package is running unbuilt)');\n        }\n        return new WorktreeReapHandoff(here.path, landedBranch, primary.path, entry, '');\n    }\n\n    /**\n     * Run the reap in a child process rooted in the primary clone, and render what happened.\n     *\n     * stdin is `ignore` deliberately: the child must never be able to ask a question. A prompt printed\n     * into a landing recap nobody is watching is not consent, and this reap is authorised by the merge\n     * that just succeeded, not by an answer.\n     */\n    handOff(handoff: WorktreeReapHandoff): string {\n        const result = spawnSync(\n            process.execPath, [handoff.entryScript, handoff.worktreePath, handoff.branch],\n            { cwd: handoff.primaryPath, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });\n\n        const output = `${result.stdout ?? ''}${result.stderr ?? ''}`.trimEnd();\n        const head = '\\n' + SEP + `🌲 Reaping this worktree from ${handoff.primaryPath}\\n` + SEP + '\\n'\n            + `   The branch just landed, so this directory is dead. The reap runs in a child process\\n`\n            + `   whose cwd is the primary clone — nothing deletes the directory it is standing in.\\n\\n`;\n\n        if (result.status !== 0) {\n            return head + (output !== '' ? output + '\\n' : '')\n                + `\\n   ⚠️  The reap did not complete (exit ${String(result.status ?? -1)}). Nothing was forced.\\n`\n                + this.manualNotice(handoff);\n        }\n        return head + (output !== '' ? output + '\\n' : '') + this.afterReap(handoff);\n    }\n\n    /**\n     * The #512 notice, kept verbatim in spirit for every case the re-exec cannot cover. An honest\n     * limitation beats a command that deletes its own working directory mid-run.\n     */\n    manualNotice(handoff: WorktreeReapHandoff): string {\n        const why = handoff.blockedBecause !== '' ? `         (${handoff.blockedBecause})\\n` : '';\n        return '   Next: this branch is checked out in THIS worktree, so neither it nor the worktree can\\n'\n            + '         be removed from in here. Run cleanup from the primary clone instead:\\n'\n            + `           cd ${handoff.primaryPath} && pnpm wp-cleanup\\n`\n            + why\n            + `         It archives ${handoff.branch} as a tag, removes ${handoff.worktreePath}, then deletes the branch.\\n`;\n    }\n\n    /**\n     * The one thing a human or agent MUST be told after a successful reap: the shell they typed this\n     * into is now sitting in a directory that no longer exists. Every relative path from here on is a\n     * mystery ENOENT unless they move.\n     */\n    private afterReap(handoff: WorktreeReapHandoff): string {\n        return `\\n   ⚠️  ${handoff.worktreePath} NO LONGER EXISTS — your shell is standing in a deleted\\n`\n            + '       directory, and every following command will fail until you move:\\n'\n            + `           cd ${handoff.primaryPath}\\n`;\n    }\n\n    /**\n     * WHERE the child's entry point lives — a seam, overridden in the spec, because under vitest this\n     * package runs from `.ts` sources and the compiled sibling does not exist.\n     *\n     * Resolved from `__dirname`, i.e. from THIS package's own installed files, NOT by remapping a path\n     * into the primary clone. The primary clone may have a different @webpieces/pr-gate version\n     * installed, and re-exec'ing a build that predates this feature would silently do something else.\n     * The files are read into the child before it removes anything, so the directory going away\n     * underneath them afterwards is harmless.\n     */\n    protected reapEntryScript(): string {\n        const entry = path.join(__dirname, '..', 'wp-reap-worktree.js');\n        return fs.existsSync(entry) ? entry : '';\n    }\n}\n"]}

package/src/scripts/wp-reap-worktree.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import 'reflect-metadata';

package/src/scripts/wp-reap-worktree.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const inversify_1 = require("inversify");
+const rules_config_1 = require("@webpieces/rules-config");
+const pr_gate_app_1 = require("./pr-gate-app");
+/**
+ * INTERNAL entry point — deliberately NOT registered in package.json `bin`.
+ *
+ * `pnpm wp-land-pr` spawns this by absolute path with `cwd` set to the PRIMARY CLONE, so that the
+ * worktree it just landed from can be removed by a process that is not standing in it. There is no
+ * `wp-reap-worktree` verb for a human: `pnpm wp-cleanup` is that verb and does strictly more.
+ *
+ * Unlike its siblings it TAKES arguments (`<worktree-path> <branch>`), so `CliArgs.assertNoArgs` —
+ * which exists to stop a stray flag from silently starting a mutation flow — would be wrong here.
+ * ReapWorktreeCommand validates argv itself and refuses to do anything without both values.
+ */
+(0, rules_config_1.runMain)(async () => {
+    const container = new inversify_1.Container({ autobind: true });
+    await container.get(pr_gate_app_1.PrGateApp).reapWorktree(process.argv.slice(2));
+});
+//# sourceMappingURL=wp-reap-worktree.js.map

package/src/scripts/wp-reap-worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wp-reap-worktree.js","sourceRoot":"","sources":["../../../../../../packages/tooling/pr-gate/src/scripts/wp-reap-worktree.ts"],"names":[],"mappings":";;;AACA,4BAA0B;AAC1B,yCAAsC;AACtC,0DAAkD;AAClD,+CAA0C;AAE1C;;;;;;;;;;GAUG;AACH,IAAA,sBAAO,EAAC,KAAK,IAAmB,EAAE;IAC9B,MAAM,SAAS,GAAG,IAAI,qBAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,CAAC,GAAG,CAAC,uBAAS,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport 'reflect-metadata';\nimport { Container } from 'inversify';\nimport { runMain } from '@webpieces/rules-config';\nimport { PrGateApp } from './pr-gate-app';\n\n/**\n * INTERNAL entry point — deliberately NOT registered in package.json `bin`.\n *\n * `pnpm wp-land-pr` spawns this by absolute path with `cwd` set to the PRIMARY CLONE, so that the\n * worktree it just landed from can be removed by a process that is not standing in it. There is no\n * `wp-reap-worktree` verb for a human: `pnpm wp-cleanup` is that verb and does strictly more.\n *\n * Unlike its siblings it TAKES arguments (`<worktree-path> <branch>`), so `CliArgs.assertNoArgs` —\n * which exists to stop a stray flag from silently starting a mutation flow — would be wrong here.\n * ReapWorktreeCommand validates argv itself and refuses to do anything without both values.\n */\nrunMain(async (): Promise<void> => {\n    const container = new Container({ autobind: true });\n    await container.get(PrGateApp).reapWorktree(process.argv.slice(2));\n});\n"]}