@webpieces/pr-gate 0.4.454 → 0.4.455

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/pr-gate",
-  "version": "0.4.454",
+  "version": "0.4.455",
   "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",
@@ -9,7 +9,8 @@
     "wp-start-upsert-pr": "./src/scripts/wp-start-upsert-pr.js",
     "wp-start-update": "./src/scripts/wp-start-update.js",
     "wp-finish-update": "./src/scripts/wp-finish-update.js",
-    "wp-cleanup": "./src/scripts/wp-cleanup.js"
+    "wp-cleanup": "./src/scripts/wp-cleanup.js",
+    "wp-land-pr": "./src/scripts/wp-land-pr.js"
   },
   "files": [
     "src/**/*"
@@ -22,7 +23,7 @@
     "directory": "packages/tooling/pr-gate"
   },
   "dependencies": {
-    "@webpieces/rules-config": "0.4.454",
+    "@webpieces/rules-config": "0.4.455",
     "@inversifyjs/binding-decorators": "1.1.5",
     "inversify": "7.10.4",
     "reflect-metadata": "0.2.2"

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

@@ -0,0 +1,28 @@
+import { RepoRootFinder } from '@webpieces/rules-config';
+import { AiBranchName } from '../workflow/git-readAiBranchName';
+import { BranchNaming } from '../workflow/branch-naming';
+import { PrMerger } from '../workflow/pr-merger';
+/**
+ * `wp-land-pr`: squash-merge THIS branch's already-posted PR into main with the compact commit body.
+ *
+ * It exists because a merge clicked in the GitHub UI cannot produce that body. A UI merge is limited
+ * to the repo's squash_merge_commit_title/message settings, and none of their values yields the
+ * shortened risk/flags summary — only an explicit `gh pr merge --subject --body-file` does. So when a
+ * merge has to happen outside `wp-finish-upsert-pr` (a mergeMode=NONE repo, or a PR whose checks were
+ * still running when finish ran), this is the command that keeps main's history consistent.
+ *
+ * It deliberately does NOT re-run the build gate or re-render the dashboard: `wp-finish-upsert-pr`
+ * already did both and left `merge-commit-body.md` on disk. Landing is a separate, later act, and
+ * rebuilding here would mean a second authoritative gate whose result nobody reads. If that file is
+ * missing, the honest answer is that finish has not run — so this fails and says so, rather than
+ * inventing a body that would not match the PR.
+ */
+export declare class LandPrCommand {
+    private readonly repoRootFinder;
+    private readonly aiBranchName;
+    private readonly branchNaming;
+    private readonly prMerger;
+    constructor(repoRootFinder: RepoRootFinder, aiBranchName: AiBranchName, branchNaming: BranchNaming, prMerger: PrMerger);
+    run(): Promise<void>;
+    private prNumberAndTitle;
+}

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

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LandPrCommand = 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");
+const git_readAiBranchName_1 = require("../workflow/git-readAiBranchName");
+const branch_naming_1 = require("../workflow/branch-naming");
+const pr_merger_1 = require("../workflow/pr-merger");
+const SEP = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
+/**
+ * `wp-land-pr`: squash-merge THIS branch's already-posted PR into main with the compact commit body.
+ *
+ * It exists because a merge clicked in the GitHub UI cannot produce that body. A UI merge is limited
+ * to the repo's squash_merge_commit_title/message settings, and none of their values yields the
+ * shortened risk/flags summary — only an explicit `gh pr merge --subject --body-file` does. So when a
+ * merge has to happen outside `wp-finish-upsert-pr` (a mergeMode=NONE repo, or a PR whose checks were
+ * still running when finish ran), this is the command that keeps main's history consistent.
+ *
+ * It deliberately does NOT re-run the build gate or re-render the dashboard: `wp-finish-upsert-pr`
+ * already did both and left `merge-commit-body.md` on disk. Landing is a separate, later act, and
+ * rebuilding here would mean a second authoritative gate whose result nobody reads. If that file is
+ * missing, the honest answer is that finish has not run — so this fails and says so, rather than
+ * inventing a body that would not match the PR.
+ */
+let LandPrCommand = class LandPrCommand {
+    repoRootFinder;
+    aiBranchName;
+    branchNaming;
+    prMerger;
+    constructor(repoRootFinder, aiBranchName, branchNaming, prMerger) {
+        this.repoRootFinder = repoRootFinder;
+        this.aiBranchName = aiBranchName;
+        this.branchNaming = branchNaming;
+        this.prMerger = prMerger;
+    }
+    async run() {
+        const repoRoot = this.repoRootFinder.resolveRepoRoot(process.cwd());
+        const base = this.branchNaming.baseBranchName((0, child_process_1.execSync)('git branch --show-current', { encoding: 'utf8' }).trim());
+        const prDir = (0, rules_config_1.prDirFor)(repoRoot, this.aiBranchName.getFeatureName());
+        const mergeBodyFile = path.join(prDir, 'merge-commit-body.md');
+        if (!fs.existsSync(mergeBodyFile)) {
+            throw new rules_config_1.InformAiError('\n' + SEP + '❌ Nothing to land — no rendered merge body\n' + SEP + '\n' +
+                `Expected the compact squash-commit body at:\n  ${mergeBodyFile}\n\n` +
+                'That file is written by `pnpm wp-finish-upsert-pr`, which is also what posts the PR.\n' +
+                'Its absence means finish has not run on this branch, so there is no reviewed PR to\n' +
+                'land. Run the gated flow first:\n\n' +
+                '  pnpm wp-start-upsert-pr     # update from main, push, build gate\n' +
+                '  # write .webpieces/review.json\n' +
+                '  pnpm wp-finish-upsert-pr    # build gate, dashboard, create/update the PR\n\n' +
+                'Then re-run `pnpm wp-land-pr` if the PR still needs landing.\n' + SEP);
+        }
+        const ref = this.prNumberAndTitle(base);
+        if (ref === null) {
+            throw new rules_config_1.InformAiError('\n' + SEP + '❌ No open PR found for this branch\n' + SEP + '\n' +
+                `No open PR has head branch "${base}". Nothing to land.\n` +
+                'If the PR is already merged, run `pnpm wp-cleanup`.\n' + SEP);
+        }
+        process.stdout.write('\n' + SEP + `🚀 Landing PR #${ref.number}\n` + SEP + '\n');
+        // Reuse the SAME merge logic wp-finish-upsert-pr uses, so a PR lands identically whichever
+        // command lands it — including the auto-merge fallback when the checks are still running.
+        // MERGE_MODE_AUTO is passed explicitly: running this command IS the intent to merge, so it is
+        // not gated on pr-gate.mergeMode (a NONE repo runs this precisely to land one PR by hand).
+        const outcome = this.prMerger.merge(base, `${ref.title} (#${ref.number})`, mergeBodyFile, rules_config_1.MERGE_MODE_AUTO);
+        const policy = (0, rules_config_1.loadAndValidate)(repoRoot).prGate.mergeMode;
+        process.stdout.write('\n' + SEP + (outcome.merged ? '✅ Landed\n' : 'ℹ️  Not landed yet\n') + SEP + '\n' +
+            `   ${outcome.message}\n` +
+            (outcome.merged ? '   Next: `pnpm wp-cleanup` to delete the merged branch.\n' : '') +
+            (policy === rules_config_1.MERGE_MODE_AUTO
+                ? ''
+                : `   (pr-gate.mergeMode is ${policy} — wp-finish-upsert-pr will keep leaving PRs for a human.)\n`) +
+            '\n');
+    }
+    // The open PR's number + title for this head branch, or null when there is none. The TITLE comes
+    // from the PR itself, not review.json, so the squash subject matches what a reviewer approved even
+    // if review.json was edited afterwards.
+    prNumberAndTitle(baseBranch) {
+        const result = (0, child_process_1.spawnSync)('gh', ['pr', 'view', baseBranch, '--json', 'number,title', '--jq', '"\\(.number)\\t\\(.title)"'], { encoding: 'utf8' });
+        if (result.status !== 0)
+            return null;
+        const parts = (result.stdout ?? '').trim().split('\t');
+        if ((parts[0] ?? '') === '')
+            return null;
+        return new PrIdentity(parts[0] ?? '', parts[1] ?? '');
+    }
+};
+exports.LandPrCommand = LandPrCommand;
+exports.LandPrCommand = LandPrCommand = tslib_1.__decorate([
+    (0, inversify_1.injectable)(inversify_1.bindingScopeValues.Singleton),
+    tslib_1.__metadata("design:paramtypes", [rules_config_1.RepoRootFinder,
+        git_readAiBranchName_1.AiBranchName,
+        branch_naming_1.BranchNaming,
+        pr_merger_1.PrMerger])
+], LandPrCommand);
+// The open PR's number + title, as read back from GitHub.
+class PrIdentity {
+    number;
+    title;
+    constructor(number, title) {
+        this.number = number;
+        this.title = title;
+    }
+}
+//# sourceMappingURL=land-pr-command.js.map

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

@@ -0,0 +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 { prDirFor, InformAiError, RepoRootFinder, MERGE_MODE_AUTO, loadAndValidate } from '@webpieces/rules-config';\nimport { injectable, bindingScopeValues } from 'inversify';\nimport { AiBranchName } from '../workflow/git-readAiBranchName';\nimport { BranchNaming } from '../workflow/branch-naming';\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    ) {}\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 policy = loadAndValidate(repoRoot).prGate.mergeMode;\n        process.stdout.write(\n            '\\n' + SEP + (outcome.merged ? '✅ Landed\\n' : 'ℹ️  Not landed yet\\n') + SEP + '\\n' +\n            `   ${outcome.message}\\n` +\n            (outcome.merged ? '   Next: `pnpm wp-cleanup` to delete the merged branch.\\n' : '') +\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    // 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/pr-gate-app.d.ts

@@ -3,9 +3,10 @@ import { FinishUpdateCommand } from './commands/finish-update-command';
 import { StartUpsertPrCommand } from './commands/start-upsert-pr-command';
 import { FinishUpsertPrCommand } from './commands/finish-upsert-pr-command';
 import { CleanupCommand } from './commands/cleanup-command';
+import { LandPrCommand } from './commands/land-pr-command';
 /**
- * The pr-gate application root. `container.get(PrGateApp)` resolves the entire workflow DAG (the 4
- * command classes → the injected git/merge/dashboard services). `@DocumentDesign` marks it the
+ * 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
  * top-of-DAG the DI-design analyzer roots on, so `role:app` pr-gate draws its design. Each `bin/*`
  * entry resolves THIS and calls the matching command method.
  */
@@ -15,7 +16,8 @@ export declare class PrGateApp {
     private readonly startUpsertPrCommand;
     private readonly finishUpsertPrCommand;
     private readonly cleanupCommand;
-    constructor(startUpdateCommand: StartUpdateCommand, finishUpdateCommand: FinishUpdateCommand, startUpsertPrCommand: StartUpsertPrCommand, finishUpsertPrCommand: FinishUpsertPrCommand, cleanupCommand: CleanupCommand);
+    private readonly landPrCommand;
+    constructor(startUpdateCommand: StartUpdateCommand, finishUpdateCommand: FinishUpdateCommand, startUpsertPrCommand: StartUpsertPrCommand, finishUpsertPrCommand: FinishUpsertPrCommand, cleanupCommand: CleanupCommand, landPrCommand: LandPrCommand);
     /** `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). */
@@ -26,4 +28,6 @@ export declare class PrGateApp {
     finishUpsertPr(): Promise<void>;
     /** `wp-cleanup`: delete local branches whose PR is already merged (or that hold no commits). */
     cleanup(): Promise<void>;
+    /** `wp-land-pr`: squash-merge this branch's PR into main with the compact commit body. */
+    landPr(): Promise<void>;
 }

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

@@ -9,9 +9,10 @@ const finish_update_command_1 = require("./commands/finish-update-command");
 const start_upsert_pr_command_1 = require("./commands/start-upsert-pr-command");
 const finish_upsert_pr_command_1 = require("./commands/finish-upsert-pr-command");
 const cleanup_command_1 = require("./commands/cleanup-command");
+const land_pr_command_1 = require("./commands/land-pr-command");
 /**
- * The pr-gate application root. `container.get(PrGateApp)` resolves the entire workflow DAG (the 4
- * command classes → the injected git/merge/dashboard services). `@DocumentDesign` marks it the
+ * 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
  * top-of-DAG the DI-design analyzer roots on, so `role:app` pr-gate draws its design. Each `bin/*`
  * entry resolves THIS and calls the matching command method.
  */
@@ -21,12 +22,14 @@ let PrGateApp = class PrGateApp {
     startUpsertPrCommand;
     finishUpsertPrCommand;
     cleanupCommand;
-    constructor(startUpdateCommand, finishUpdateCommand, startUpsertPrCommand, finishUpsertPrCommand, cleanupCommand) {
+    landPrCommand;
+    constructor(startUpdateCommand, finishUpdateCommand, startUpsertPrCommand, finishUpsertPrCommand, cleanupCommand, landPrCommand) {
         this.startUpdateCommand = startUpdateCommand;
         this.finishUpdateCommand = finishUpdateCommand;
         this.startUpsertPrCommand = startUpsertPrCommand;
         this.finishUpsertPrCommand = finishUpsertPrCommand;
         this.cleanupCommand = cleanupCommand;
+        this.landPrCommand = landPrCommand;
     }
     /** `wp-start-update`: 3-point squash-update from main (no PR). */
     startUpdate() {
@@ -48,6 +51,10 @@ let PrGateApp = class PrGateApp {
     cleanup() {
         return this.cleanupCommand.run();
     }
+    /** `wp-land-pr`: squash-merge this branch's PR into main with the compact commit body. */
+    landPr() {
+        return this.landPrCommand.run();
+    }
 };
 exports.PrGateApp = PrGateApp;
 exports.PrGateApp = PrGateApp = tslib_1.__decorate([
@@ -57,6 +64,7 @@ exports.PrGateApp = PrGateApp = tslib_1.__decorate([
         finish_update_command_1.FinishUpdateCommand,
         start_upsert_pr_command_1.StartUpsertPrCommand,
         finish_upsert_pr_command_1.FinishUpsertPrCommand,
-        cleanup_command_1.CleanupCommand])
+        cleanup_command_1.CleanupCommand,
+        land_pr_command_1.LandPrCommand])
 ], 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;AAE5D;;;;;GAKG;AAGI,IAAM,SAAS,GAAf,MAAM,SAAS;IAEG;IACA;IACA;IACA;IACA;IALrB,YACqB,kBAAsC,EACtC,mBAAwC,EACxC,oBAA0C,EAC1C,qBAA4C,EAC5C,cAA8B;QAJ9B,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,wBAAmB,GAAnB,mBAAmB,CAAqB;QACxC,yBAAoB,GAApB,oBAAoB,CAAsB;QAC1C,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,mBAAc,GAAd,cAAc,CAAgB;IAChD,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,+FAA+F;IAC/F,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,gGAAgG;IAChG,OAAO;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;CACJ,CAAA;AAjCY,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;GAN1C,SAAS,CAiCrB","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';\n\n/**\n * The pr-gate application root. `container.get(PrGateApp)` resolves the entire workflow DAG (the 4\n * command 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    ) {}\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, push, advisory build gate, hand off review.json. */\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`: delete local branches whose PR is already merged (or that hold no commits). */\n    cleanup(): Promise<void> {\n        return this.cleanupCommand.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;AAE3D;;;;;GAKG;AAGI,IAAM,SAAS,GAAf,MAAM,SAAS;IAEG;IACA;IACA;IACA;IACA;IACA;IANrB,YACqB,kBAAsC,EACtC,mBAAwC,EACxC,oBAA0C,EAC1C,qBAA4C,EAC5C,cAA8B,EAC9B,aAA4B;QAL5B,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;IAC9C,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,+FAA+F;IAC/F,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,gGAAgG;IAChG,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;CACJ,CAAA;AAvCY,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;GAPxC,SAAS,CAuCrB","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';\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    ) {}\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, push, advisory build gate, hand off review.json. */\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`: delete local branches whose PR is already merged (or that hold no commits). */\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"]}

package/src/scripts/wp-land-pr.d.ts

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

package/src/scripts/wp-land-pr.js

@@ -0,0 +1,16 @@
+#!/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");
+// Composition root: build the container and resolve the app so inversify constructs the whole DAG.
+(0, rules_config_1.runMain)(async () => {
+    // autobind self-binds every @injectable(Singleton) tooling class (replaces the buildProviderModule registry scan)
+    const container = new inversify_1.Container({ autobind: true });
+    // Reject `--help`/bogus flags BEFORE the app touches git — an ignored flag must never start the flow.
+    container.get(rules_config_1.CliArgs).assertNoArgs(new rules_config_1.CliUsage('wp-land-pr', "Squash-merge this branch's PR into main with the compact risk/flags commit body."));
+    await container.get(pr_gate_app_1.PrGateApp).landPr();
+});
+//# sourceMappingURL=wp-land-pr.js.map

package/src/scripts/wp-land-pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wp-land-pr.js","sourceRoot":"","sources":["../../../../../../packages/tooling/pr-gate/src/scripts/wp-land-pr.ts"],"names":[],"mappings":";;;AACA,4BAA0B;AAC1B,yCAAsC;AACtC,0DAAqE;AACrE,+CAA0C;AAE1C,mGAAmG;AACnG,IAAA,sBAAO,EAAC,KAAK,IAAmB,EAAE;IAC9B,kHAAkH;IAClH,MAAM,SAAS,GAAG,IAAI,qBAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,sGAAsG;IACtG,SAAS,CAAC,GAAG,CAAC,sBAAO,CAAC,CAAC,YAAY,CAAC,IAAI,uBAAQ,CAC5C,YAAY,EAAE,kFAAkF,CAAC,CAAC,CAAC;IACvG,MAAM,SAAS,CAAC,GAAG,CAAC,uBAAS,CAAC,CAAC,MAAM,EAAE,CAAC;AAC5C,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport 'reflect-metadata';\nimport { Container } from 'inversify';\nimport { runMain, CliArgs, CliUsage } from '@webpieces/rules-config';\nimport { PrGateApp } from './pr-gate-app';\n\n// Composition root: build the container and resolve the app so inversify constructs the whole DAG.\nrunMain(async (): Promise<void> => {\n    // autobind self-binds every @injectable(Singleton) tooling class (replaces the buildProviderModule registry scan)\n    const container = new Container({ autobind: true });\n    // Reject `--help`/bogus flags BEFORE the app touches git — an ignored flag must never start the flow.\n    container.get(CliArgs).assertNoArgs(new CliUsage(\n        'wp-land-pr', \"Squash-merge this branch's PR into main with the compact risk/flags commit body.\"));\n    await container.get(PrGateApp).landPr();\n});\n"]}