@deftai/directive 0.107.0 → 0.109.0

package/dist/render-cli/prd-render-cli.js

@@ -1,13 +1,11 @@
 /**
  * Thin CLI wrapper for prd-render (mirrors ``scripts/prd_render.py``).
  *
- * Supports `--project-root <dir>` to resolve the spec artifact via the layout
- * resolver (#2132), preferring `xbrief/specification.xbrief.json` on migrated
- * trees and falling back to `vbrief/specification.vbrief.json` on legacy trees.
+ * Supports `--project-root <dir>` to resolve full-spec or greenfield authority
+ * through the shared authority resolver (#2132 / #3598).
  * When `--spec` is explicitly provided it takes precedence over `--project-root`.
  * Direct `--spec` / `--output` / `--force` flags are still accepted unchanged.
  */
-import { layout } from "@deftai/directive-core";
 import { parsePrdArgv, prdRenderMain } from "@deftai/directive-core/render";
 function parsePrdRenderCliArgv(argv) {
     const remaining = [];
@@ -30,12 +28,10 @@ function parsePrdRenderCliArgv(argv) {
 export function runPrdRenderCli(argv) {
     const { projectRoot, remaining } = parsePrdRenderCliArgv(argv);
     const parsedArgs = parsePrdArgv(remaining);
-    const spec = parsedArgs.spec !== undefined
-        ? parsedArgs.spec
-        : projectRoot !== undefined
-            ? layout.resolveSpecArtifactPath(projectRoot)
-            : undefined;
-    prdRenderMain({ ...parsedArgs, spec });
+    prdRenderMain({
+        ...parsedArgs,
+        projectRoot: parsedArgs.spec === undefined ? projectRoot : undefined,
+    });
     return 0;
 }
 //# sourceMappingURL=prd-render-cli.js.map

package/dist/session-ready.d.ts

@@ -4,6 +4,8 @@ export interface ParsedSessionReadyArgs {
     emitJson: boolean;
     withNetwork: boolean;
     repo: string | null;
+    /** #3611: explicit lifecycle owner injected by a host hook bridge. */
+    sessionId: string | null;
     error?: string;
 }
 /** Parse session:ready CLI args. */

package/dist/session-ready.js

@@ -15,6 +15,7 @@ export function parseArgs(argv) {
         emitJson: false,
         withNetwork: false,
         repo: null,
+        sessionId: null,
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -33,13 +34,13 @@ export function parseArgs(argv) {
         if (arg === "--help" || arg === "-h") {
             return {
                 ...parsed,
-                error: "usage: session:ready [--project-root <path>] [--repo OWNER/NAME] [--with-network] [--json]\n" +
+                error: "usage: session:ready [--project-root <path>] [--repo OWNER/NAME] [--session-id <id>] [--with-network] [--json]\n" +
                     "  One-shot recovery: session:start (if needed) + gated ritual + cache recovery (#2993).",
             };
         }
         if (arg === "--project-root") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value.startsWith("--")) {
                 return { ...parsed, error: "argument --project-root: expected one argument" };
             }
             parsed.projectRoot = value;
@@ -47,12 +48,37 @@ export function parseArgs(argv) {
             continue;
         }
         if (arg.startsWith("--project-root=")) {
-            parsed.projectRoot = arg.slice("--project-root=".length);
+            const value = arg.slice("--project-root=".length);
+            if (value.length === 0 || value.startsWith("--")) {
+                return { ...parsed, error: "argument --project-root: expected one argument" };
+            }
+            parsed.projectRoot = value;
+            continue;
+        }
+        if (arg === "--session-id") {
+            const value = argv[i + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return { ...parsed, error: "argument --session-id: expected one argument" };
+            }
+            const sessionId = value.trim();
+            if (sessionId.length === 0 || sessionId.startsWith("--")) {
+                return { ...parsed, error: "argument --session-id: expected a non-empty value" };
+            }
+            parsed.sessionId = sessionId;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith("--session-id=")) {
+            const sessionId = arg.slice("--session-id=".length).trim();
+            if (sessionId.length === 0 || sessionId.startsWith("--")) {
+                return { ...parsed, error: "argument --session-id: expected a non-empty value" };
+            }
+            parsed.sessionId = sessionId;
             continue;
         }
         if (arg === "--repo") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value.startsWith("--")) {
                 return { ...parsed, error: "argument --repo: expected one argument" };
             }
             parsed.repo = value;
@@ -60,7 +86,11 @@ export function parseArgs(argv) {
             continue;
         }
         if (arg.startsWith("--repo=")) {
-            parsed.repo = arg.slice("--repo=".length);
+            const value = arg.slice("--repo=".length);
+            if (value.length === 0 || value.startsWith("--")) {
+                return { ...parsed, error: "argument --repo: expected one argument" };
+            }
+            parsed.repo = value;
             continue;
         }
         if (arg.startsWith("-")) {
@@ -80,6 +110,7 @@ export function run(argv = process.argv.slice(2)) {
     const projectRoot = resolve(args.projectRoot);
     const result = runSessionReady(projectRoot, {
         repo: args.repo,
+        sessionId: args.sessionId ?? undefined,
         sessionStartOptions: {
             allowOptionalNetwork: args.withNetwork ? true : undefined,
             writeHistory: false,
@@ -89,6 +120,7 @@ export function run(argv = process.argv.slice(2)) {
         process.stdout.write(`${JSON.stringify({
             ready: result.code === 0,
             exit_code: result.code,
+            session_id: result.sessionId,
             path: result.path,
             message: result.message,
             steps: result.steps,

package/dist/session-start.d.ts

@@ -36,6 +36,8 @@ export interface ParsedSessionStartArgs {
     steal: boolean;
     confirm: boolean;
     occupant: string | null;
+    /** #3611: explicit lifecycle owner injected by a host hook bridge. */
+    sessionId: string | null;
     error?: string;
 }
 /** Parse session:start CLI args, mirroring scripts/session_start.py. */

package/dist/session-start.js

@@ -34,6 +34,7 @@ export function parseArgs(argv) {
         steal: false,
         confirm: false,
         occupant: null,
+        sessionId: null,
     };
     const dialInputs = {};
     for (let i = 0; i < argv.length; i += 1) {
@@ -82,25 +83,33 @@ export function parseArgs(argv) {
         }
         else if (arg === "--project-root") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value.startsWith("--")) {
                 return { ...parsed, error: "argument --project-root: expected one argument" };
             }
             parsed.projectRoot = value;
             i += 1;
         }
         else if (arg?.startsWith("--project-root=")) {
-            parsed.projectRoot = arg.slice("--project-root=".length);
+            const value = arg.slice("--project-root=".length);
+            if (value.length === 0 || value.startsWith("--")) {
+                return { ...parsed, error: "argument --project-root: expected one argument" };
+            }
+            parsed.projectRoot = value;
         }
         else if (arg === "--defer") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value.startsWith("--")) {
                 return { ...parsed, error: "argument --defer: expected one argument" };
             }
             parsed.deferValues.push(value);
             i += 1;
         }
         else if (arg?.startsWith("--defer=")) {
-            parsed.deferValues.push(arg.slice("--defer=".length));
+            const value = arg.slice("--defer=".length);
+            if (value.length === 0 || value.startsWith("--")) {
+                return { ...parsed, error: "argument --defer: expected one argument" };
+            }
+            parsed.deferValues.push(value);
         }
         else if (arg === "--task-size" || arg === "--ceremony-task-size") {
             const value = argv[i + 1];
@@ -282,16 +291,39 @@ export function parseArgs(argv) {
         else if (arg === "--confirm") {
             parsed.confirm = true;
         }
+        else if (arg === "--session-id") {
+            const value = argv[i + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return { ...parsed, error: "argument --session-id: expected one argument" };
+            }
+            const sessionId = value.trim();
+            if (sessionId.length === 0 || sessionId.startsWith("--")) {
+                return { ...parsed, error: "argument --session-id: expected a non-empty value" };
+            }
+            parsed.sessionId = sessionId;
+            i += 1;
+        }
+        else if (arg?.startsWith("--session-id=")) {
+            const sessionId = arg.slice("--session-id=".length).trim();
+            if (sessionId.length === 0 || sessionId.startsWith("--")) {
+                return { ...parsed, error: "argument --session-id: expected a non-empty value" };
+            }
+            parsed.sessionId = sessionId;
+        }
         else if (arg === "--occupant") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value.startsWith("--")) {
                 return { ...parsed, error: "argument --occupant: expected one argument" };
             }
             parsed.occupant = value;
             i += 1;
         }
         else if (arg?.startsWith("--occupant=")) {
-            parsed.occupant = arg.slice("--occupant=".length);
+            const value = arg.slice("--occupant=".length);
+            if (value.length === 0 || value.startsWith("--")) {
+                return { ...parsed, error: "argument --occupant: expected one argument" };
+            }
+            parsed.occupant = value;
         }
         else {
             return { ...parsed, error: `unrecognized argument: ${arg}` };
@@ -358,6 +390,7 @@ export function run(argv) {
             steal: args.steal ? true : undefined,
             confirm: args.confirm ? true : undefined,
             occupant: args.occupant ?? undefined,
+            sessionId: args.sessionId ?? undefined,
             ...(args.ceremonyDepthOverride !== null
                 ? {
                     ceremonyDial: selectCeremonyDepth({

package/dist/toolchain-check.d.ts

@@ -2,6 +2,7 @@
 import { type CommandRunner } from "@deftai/directive-core/verify-env";
 export interface ToolchainCheckRunOptions {
     readonly runner?: CommandRunner;
+    readonly env?: NodeJS.ProcessEnv;
 }
 export declare function run(argv?: readonly string[], options?: ToolchainCheckRunOptions): number;
 //# sourceMappingURL=toolchain-check.d.ts.map

package/dist/toolchain-check.js

@@ -1,9 +1,48 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
 import { runToolchainCheck } from "@deftai/directive-core/verify-env";
+function parseArgs(argv) {
+    let consumer = false;
+    let projectRoot = process.cwd();
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index] ?? "";
+        if (arg === "--consumer") {
+            consumer = true;
+            continue;
+        }
+        if (arg === "--project-root") {
+            const value = argv[index + 1];
+            if (value === undefined || value.trim() === "" || value.startsWith("-")) {
+                return { consumer, projectRoot, error: "--project-root requires a path" };
+            }
+            projectRoot = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--project-root=")) {
+            const value = arg.slice("--project-root=".length);
+            if (value.trim() === "") {
+                return { consumer, projectRoot, error: "--project-root requires a path" };
+            }
+            projectRoot = value;
+            continue;
+        }
+        return { consumer, projectRoot, error: `unrecognized argument: ${arg}` };
+    }
+    return { consumer, projectRoot };
+}
 export function run(argv = process.argv.slice(2), options = {}) {
-    const consumer = argv.includes("--consumer");
-    const result = runToolchainCheck(options.runner, { consumer });
+    const parsed = parseArgs(argv);
+    if (parsed.error !== undefined) {
+        process.stderr.write(`toolchain-check: ${parsed.error}\n`);
+        process.stderr.write("Usage: deft toolchain-check [--consumer] [--project-root <path>]\n");
+        return 2;
+    }
+    const result = runToolchainCheck(options.runner, {
+        consumer: parsed.consumer,
+        projectRoot: parsed.projectRoot,
+        env: options.env ?? process.env,
+    });
     for (const line of result.lines) {
         process.stdout.write(`${line}\n`);
     }

package/dist/verify-orphan-active.d.ts

@@ -5,6 +5,8 @@ interface ParsedArgs {
     issue: number | null;
     quiet: boolean;
     skipGh: boolean;
+    changedOnly: boolean;
+    baseRef: string | null;
     error?: string;
 }
 /** Parse verify-orphan-active CLI args. */

package/dist/verify-orphan-active.js

@@ -18,6 +18,8 @@ export function parseArgs(argv) {
         issue: null,
         quiet: false,
         skipGh: false,
+        changedOnly: false,
+        baseRef: null,
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -27,6 +29,20 @@ export function parseArgs(argv) {
         else if (arg === "--skip-gh") {
             parsed.skipGh = true;
         }
+        else if (arg === "--changed-only") {
+            parsed.changedOnly = true;
+        }
+        else if (arg === "--base-ref") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --base-ref: expected one argument" };
+            }
+            parsed.baseRef = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--base-ref=")) {
+            parsed.baseRef = arg.slice("--base-ref=".length);
+        }
         else if (arg === "--project-root") {
             const value = argv[i + 1];
             if (value === undefined) {
@@ -73,6 +89,18 @@ export function parseArgs(argv) {
             return { ...parsed, error: `unrecognized argument: ${arg}` };
         }
     }
+    // The two scopes answer different questions; silently preferring one would
+    // hide which residue the run actually covered (#3893).
+    if (parsed.changedOnly && parsed.issue !== null) {
+        return {
+            ...parsed,
+            error: "--changed-only and --issue are mutually exclusive: --issue is the after-merge " +
+                "one-origin scan, --changed-only is the merge-gate candidate scan",
+        };
+    }
+    if (parsed.baseRef !== null && !parsed.changedOnly) {
+        return { ...parsed, error: "--base-ref requires --changed-only" };
+    }
     return parsed;
 }
 /** Run the gate and return the process exit code. */
@@ -88,6 +116,8 @@ export function run(argv) {
         repo: args.repo,
         skipGh: args.skipGh,
         issue: args.issue,
+        changedOnly: args.changedOnly,
+        baseRef: args.baseRef,
     });
     if (result.message.length > 0) {
         if (result.stream === "stdout") {

package/dist/verify-pr-closeout-attestable.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    repo: string | null;
+    pr: number | null;
+    quiet: boolean;
+    error?: string;
+}
+/** Parse verify-pr-closeout-attestable CLI args. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** Run the gate and return the process exit code. */
+export declare function run(argv: string[]): number;
+export {};
+//# sourceMappingURL=verify-pr-closeout-attestable.d.ts.map

package/dist/verify-pr-closeout-attestable.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluate } from "@deftai/directive-core/pr-closeout-attestable";
+function parsePrNumber(raw) {
+    const trimmed = raw.startsWith("#") ? raw.slice(1) : raw;
+    if (!/^\d+$/.test(trimmed)) {
+        return null;
+    }
+    const value = Number(trimmed);
+    return Number.isInteger(value) && value > 0 ? value : null;
+}
+/** Parse verify-pr-closeout-attestable CLI args. */
+export function parseArgs(argv) {
+    const parsed = { projectRoot: ".", repo: null, pr: null, quiet: false };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--quiet") {
+            parsed.quiet = true;
+        }
+        else if (arg === "--project-root") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --project-root: expected one argument" };
+            }
+            parsed.projectRoot = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--project-root=")) {
+            parsed.projectRoot = arg.slice("--project-root=".length);
+        }
+        else if (arg === "--repo") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --repo: expected one argument" };
+            }
+            parsed.repo = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--repo=")) {
+            parsed.repo = arg.slice("--repo=".length);
+        }
+        else if (arg === "--pr") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --pr: expected one argument" };
+            }
+            const pr = parsePrNumber(value);
+            if (pr === null) {
+                return { ...parsed, error: `argument --pr: expected a positive integer, got ${value}` };
+            }
+            parsed.pr = pr;
+            i += 1;
+        }
+        else if (arg?.startsWith("--pr=")) {
+            const value = arg.slice("--pr=".length);
+            const pr = parsePrNumber(value);
+            if (pr === null) {
+                return { ...parsed, error: `argument --pr: expected a positive integer, got ${value}` };
+            }
+            parsed.pr = pr;
+        }
+        else {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    if (parsed.pr === null) {
+        return { ...parsed, error: "argument --pr is required" };
+    }
+    return parsed;
+}
+/** Run the gate and return the process exit code. */
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`verify_pr_closeout_attestable: ${args.error}\n`);
+        return 2;
+    }
+    const result = evaluate(resolve(args.projectRoot), args.pr, {
+        repo: args.repo,
+        quiet: args.quiet,
+    });
+    if (result.message.length > 0) {
+        if (result.stream === "stdout") {
+            process.stdout.write(`${result.message}\n`);
+        }
+        else if (result.stream === "stderr") {
+            process.stderr.write(`${result.message}\n`);
+        }
+    }
+    return result.code;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=verify-pr-closeout-attestable.js.map

package/dist/verify-source-cli/verify-closing-keywords.d.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+export type RunGitFn = (args: readonly string[]) => {
+    readonly returncode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+};
+export type RangeResolution = {
+    readonly kind: "pr";
+    readonly pr: string;
+} | {
+    readonly kind: "range";
+    readonly range: string;
+} | {
+    readonly kind: "missing-base";
+    readonly reason: string;
+} | {
+    readonly kind: "stale-base";
+    readonly reason: string;
+};
+export declare function defaultRunGit(args: readonly string[]): {
+    returncode: number;
+    stdout: string;
+    stderr: string;
+};
+/**
+ * Resolve the candidate commit range against a merge-base, not a hardcoded
+ * origin/master two-dot range (#3969 Greptile leftover).
+ */
+export declare function resolveClosingKeywordsSource(env: NodeJS.ProcessEnv, runGit?: RunGitFn): RangeResolution;
+export declare function buildClosingKeywordsCheckArgv(env: NodeJS.ProcessEnv, extra?: readonly string[], runGit?: RunGitFn): {
+    argv: string[];
+    error?: string;
+};
+export declare function run(argv: string[], env?: NodeJS.ProcessEnv, invoke?: (args: readonly string[]) => number, runGit?: RunGitFn): number;
+//# sourceMappingURL=verify-closing-keywords.d.ts.map

package/dist/verify-source-cli/verify-closing-keywords.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { cmdPrCheckClosingKeywords } from "@deftai/directive-core/dist/pr-closing-keywords/main.js";
+const BASE_CANDIDATES = ["origin/master", "origin/main"];
+export function defaultRunGit(args) {
+    try {
+        const stdout = execFileSync("git", [...args], {
+            encoding: "utf8",
+            timeout: 30_000,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        return { returncode: 0, stdout: typeof stdout === "string" ? stdout : "", stderr: "" };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            returncode: typeof e.status === "number" ? e.status : 1,
+            stdout: typeof e.stdout === "string" ? e.stdout : "",
+            stderr: typeof e.stderr === "string" ? e.stderr : String(e.message ?? ""),
+        };
+    }
+}
+function firstLine(text) {
+    return text.trim().split(/\r?\n/)[0] ?? "";
+}
+function shaOf(result) {
+    if (result.returncode !== 0)
+        return null;
+    const sha = firstLine(result.stdout);
+    return /^[0-9a-f]{7,40}$/i.test(sha) ? sha : null;
+}
+function localDefaultFor(originRef) {
+    if (originRef.endsWith("/master") || originRef === "master")
+        return "master";
+    if (originRef.endsWith("/main") || originRef === "main")
+        return "main";
+    const slash = originRef.lastIndexOf("/");
+    return slash >= 0 ? originRef.slice(slash + 1) : null;
+}
+/** Remote-tracking ref name for `git fetch origin <name> --`. */
+function originFetchArg(originRef) {
+    if (!originRef.startsWith("origin/"))
+        return null;
+    const name = originRef.slice("origin/".length);
+    return name.length > 0 ? name : null;
+}
+/**
+ * Detect the locally observable stale-range enlargement without fetching:
+ * origin/<default> lags a descendant local default, and HEAD's merge-base
+ * against that local default is not the origin merge-base. Then
+ * origin/master..HEAD would include already-merged local-default commits.
+ */
+function staleRelativeToLocalDefault(originRef, originMergeBase, runGit) {
+    const localDefault = localDefaultFor(originRef);
+    if (localDefault === null)
+        return null;
+    const ahead = runGit(["merge-base", "--is-ancestor", originRef, localDefault]);
+    if (ahead.returncode !== 0)
+        return null;
+    const localMb = shaOf(runGit(["merge-base", localDefault, "HEAD"]));
+    if (localMb === null || localMb === originMergeBase)
+        return null;
+    return {
+        kind: "stale-base",
+        reason: originRef +
+            " lags local " +
+            localDefault +
+            " relative to HEAD, so the scan range would include already-merged commits. Recovery: git fetch origin " +
+            localDefault +
+            ".",
+    };
+}
+/**
+ * Resolve the candidate commit range against a merge-base, not a hardcoded
+ * origin/master two-dot range (#3969 Greptile leftover).
+ */
+export function resolveClosingKeywordsSource(env, runGit = defaultRunGit) {
+    const raw = env.GITHUB_PR_NUMBER ?? env.PR_NUMBER;
+    const pr = raw?.trim() ?? "";
+    if (/^\d+$/.test(pr)) {
+        return { kind: "pr", pr };
+    }
+    const bases = [
+        env.GITHUB_BASE_REF?.trim() ? `origin/${env.GITHUB_BASE_REF.trim()}` : null,
+        ...BASE_CANDIDATES,
+    ].filter((base) => base !== null && base.length > 0);
+    const seen = new Set();
+    for (const base of bases) {
+        if (seen.has(base))
+            continue;
+        seen.add(base);
+        const fetchArg = originFetchArg(base);
+        let fetched = false;
+        if (fetchArg !== null) {
+            // Scoped to this wrapper, not the whole check graph. CI uses --pr
+            // and never reaches this path.
+            fetched = runGit(["fetch", "origin", fetchArg, "--"]).returncode === 0;
+        }
+        const sha = shaOf(runGit(["merge-base", base, "HEAD"]));
+        if (sha === null)
+            continue;
+        if (!fetched) {
+            const stale = staleRelativeToLocalDefault(base, sha, runGit);
+            if (stale !== null)
+                return stale;
+            // Fetch failed and local evidence cannot prove freshness: do not
+            // scan a possibly stale origin merge-base.
+            continue;
+        }
+        return { kind: "range", range: `${sha}..HEAD` };
+    }
+    return {
+        kind: "missing-base",
+        reason: "no merge-base against origin/master or origin/main. Recovery: git fetch origin master.",
+    };
+}
+export function buildClosingKeywordsCheckArgv(env, extra = [], runGit = defaultRunGit) {
+    const source = resolveClosingKeywordsSource(env, runGit);
+    if (source.kind === "pr") {
+        return { argv: ["--mode", "fp", "--pr", source.pr, ...extra] };
+    }
+    if (source.kind === "missing-base" || source.kind === "stale-base") {
+        return { argv: [], error: source.reason };
+    }
+    return { argv: ["--mode", "fp", "--from-git-range", source.range, ...extra] };
+}
+export function run(argv, env = process.env, invoke = cmdPrCheckClosingKeywords, runGit = defaultRunGit) {
+    const built = buildClosingKeywordsCheckArgv(env, argv, runGit);
+    if (built.error !== undefined) {
+        process.stderr.write("verify:closing-keywords: fail -- " + built.error + "\n");
+        return 2;
+    }
+    return invoke(built.argv);
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=verify-closing-keywords.js.map

package/dist/verify-source-cli/verify-consumer-hard-stops.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    repo: string;
+    projectRoot: string;
+    changelog: string | null;
+    error?: string;
+}
+export interface HardStopCliSeams {
+    readonly inventory?: readonly Record<string, unknown>[];
+    readonly changelogText?: string;
+}
+/** Parse verify-consumer-hard-stops CLI args (#3900 / #3713). */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function run(argv: string[], seams?: HardStopCliSeams): number;
+export {};
+//# sourceMappingURL=verify-consumer-hard-stops.d.ts.map