@deftai/directive 0.106.0 → 0.107.0

package/dist/authz.js

@@ -225,7 +225,7 @@ function helpText() {
         "  (grant / uat-start / uat-suspend / revoke) — no TTY, --confirm, or phrase path.",
         "  Self-approval under UAT is impossible by construction. Mint grants BEFORE uat-start.",
         "Outside UAT, mutating verbs require multi-factor human presence (#3110):",
-        "  - Interactive TTY (stdin+stdout) + controlling terminal (/dev/tty|CONIN$)",
+        "  - Interactive TTY (stdin+stdout) + controlling terminal (/dev/tty|\\\\.\\CONIN$)",
         "  - Explicit --confirm (argv flag alone never enough)",
         "  - Typed phrase 'mint' on the controlling TTY (PTY+--confirm alone never enough)",
         "  - Known agent/CI env markers always refuse (fail-closed).",

package/dist/cli-router/route-argv.js

@@ -197,6 +197,9 @@ function routeNamespaceVerb(ns, verb, rest) {
             return { kind: "dispatch", argv: [verifyStem, ...rest] };
         }
     }
+    if (ns === "scm" && verb === "issue:design-critique-chip") {
+        return { kind: "dispatch", argv: ["scm", "issue", "design-critique-chip", ...rest] };
+    }
     if (ns === "issue" && verb === "ingest") {
         return { kind: "dispatch", argv: ["issue-ingest", ...rest] };
     }

package/dist/dispatch.d.ts

@@ -10,7 +10,7 @@ export interface DispatchIo {
     writeErr: (text: string) => void;
 }
 /** CLI modules in packages/cli/src (excluding parity harnesses and bin/index). */
-export declare const CLI_MODULE_VERBS: readonly ["agents-refresh", "cache", "check", "capacity-backfill", "capacity-show", "codebase-default-extractor", "codebase-map", "codebase-map-fresh", "codebase-projection-registry", "codebase-provider", "doctor", "install-upgrade", "install-uninstall", "migrate-preflight", "migrate-xbrief", "migrate-category-b", "framework-check-updates", "hook-dispatch", "umbrella-current-shape", "changelog-check", "change-init", "commit-lint", "coverage-hotspots", "policy", "authz", "escalation-cli", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "pr-finish-loop", "directive-finish-loop", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "scope-record-approved-scope", "scm-sync-default", "lifecycle-event", "lifecycle-stats", "session-start", "session-ready", "occupancy-steal", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "xbrief-create", "xbrief-verify", "verify-branch", "verify-encoding", "verify-forward-coverage", "verify-test-boundary", "verify-scope-provenance", "verify-consumer-check-contract", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-biome-config", "verify-bridge-drift", "verify-capacity", "verify-contained-writes", "verify-telemetry-coverage", "verify-content-manifest", "verify-skill-external-fetch-gate", "verify-contract-drift", "verify-cursor-tier1", "verify-openclaw-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-l4-owner", "verify-subagent-alive", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-lifecycle-visible", "verify-completed-tracked", "verify-literal-ac", "verify-ac", "verify-agents-md-budget", "verify-agents-md-advisory", "verify-eval-health-relocation", "verify-eval-triggers-relocation", "eval-health", "eval-run", "eval-report", "eval-triggers"];
+export declare const CLI_MODULE_VERBS: readonly ["agents-refresh", "cache", "check", "capacity-backfill", "capacity-show", "codebase-default-extractor", "codebase-map", "codebase-map-fresh", "codebase-projection-registry", "codebase-provider", "doctor", "install-upgrade", "install-uninstall", "migrate-preflight", "migrate-xbrief", "migrate-category-b", "framework-check-updates", "hook-dispatch", "umbrella-current-shape", "changelog-check", "change-init", "commit-lint", "coverage-hotspots", "policy", "authz", "escalation-cli", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "pr-finish-loop", "directive-finish-loop", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "scope-record-approved-scope", "scm-sync-default", "lifecycle-event", "lifecycle-stats", "session-start", "session-ready", "occupancy-steal", "occupancy-release", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-evaluate", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "xbrief-create", "xbrief-verify", "verify-branch", "verify-encoding", "verify-forward-coverage", "verify-test-boundary", "verify-scope-provenance", "verify-consumer-check-contract", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-biome-config", "verify-bridge-drift", "verify-capacity", "verify-contained-writes", "verify-telemetry-coverage", "verify-content-manifest", "verify-skill-external-fetch-gate", "verify-contract-drift", "verify-cursor-tier1", "verify-openclaw-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-l4-owner", "verify-subagent-alive", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-lifecycle-visible", "verify-completed-tracked", "verify-completed-write-guard", "verify-literal-ac", "verify-ac", "verify-agents-md-budget", "verify-agents-md-advisory", "verify-eval-health-relocation", "verify-eval-triggers-relocation", "eval-health", "eval-run", "eval-report", "eval-triggers"];
 /** Core-only CLI entrypoints without a packages/cli wrapper. */
 export declare const CORE_MODULE_VERBS: readonly ["scm", "scm-readiness", "github-auth-modes", "github-body", "issue-emit", "issue-ingest", "issue-sync-from-xbrief", "reconcile-issues", "swarm-launch", "swarm-complete-cohort", "swarm-finalize-cohort", "swarm-pre-dispatch", "swarm-readiness", "swarm-routing-verify", "swarm-routing-set", "swarm-verify-review-clean", "swarm-worktrees", "framework-commands", "pack-render", "packs-slice", "prd-render", "export-spec", "project-render", "roadmap-render", "rule-map", "spec-render", "spec-validate", "code-structure-validate", "pack-migrate-skills", "pack-migrate-rules", "pack-migrate-strategies", "pack-migrate-patterns", "pack-migrate-swarm-spec", "policy-set", "setup-ghx", "scope-undo", "scope-demote", "scope-decompose", "changelog-resolve-unreleased", "architecture-preflight-sor", "feedback-file", "value-readback", "product-signal", "freshness-report", "decision-write", "decision-list"];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */

package/dist/dispatch.js

@@ -75,6 +75,7 @@ export const CLI_MODULE_VERBS = [
     "session-start",
     "session-ready",
     "occupancy-steal",
+    "occupancy-release",
     "plan-sequence",
     "slice",
     "subagent-monitor",
@@ -83,6 +84,7 @@ export const CLI_MODULE_VERBS = [
     "triage-bootstrap",
     "triage-bulk",
     "triage-classify",
+    "triage-evaluate",
     "triage-help",
     "triage-queue",
     "triage-reconcile",
@@ -142,6 +144,7 @@ export const CLI_MODULE_VERBS = [
     "verify-orphan-active",
     "verify-lifecycle-visible",
     "verify-completed-tracked",
+    "verify-completed-write-guard",
     "verify-literal-ac",
     "verify-ac",
     "verify-agents-md-budget",
@@ -286,6 +289,7 @@ export const VERB_ALIASES = {
     "verify:orphan-active": "verify-orphan-active",
     "verify:lifecycle-visible": "verify-lifecycle-visible",
     "verify:completed-tracked": "verify-completed-tracked",
+    "verify:completed-write-guard": "verify-completed-write-guard",
     "verify:literal-ac": "verify-literal-ac",
     "verify:literal-acceptance": "verify-literal-ac",
     "verify:ac": "verify-ac",
@@ -346,6 +350,7 @@ export const VERB_ALIASES = {
     "triage:bootstrap": "triage-bootstrap",
     "triage:summary": "triage-summary",
     "triage:queue": "triage-queue",
+    "triage:evaluate": "triage-evaluate",
     "triage:scope": "triage-scope",
     ...TRIAGE_ACTION_COLON_ALIASES,
     ...POLICY_ACTION_COLON_ALIASES,
@@ -363,6 +368,8 @@ export const VERB_ALIASES = {
     "session:start": "session-start",
     "session:ready": "session-ready",
     "occupancy:steal": "occupancy-steal",
+    "occupancy:release": "occupancy-release",
+    "session:end": "occupancy-release",
     ...FRESHNESS_COLON_ALIASES,
     "lifecycle:event": "lifecycle-event",
     "lifecycle:stats": "lifecycle-stats",
@@ -2619,6 +2626,14 @@ const CURATED_HELP_GROUPS = [
                 name: "occupancy:steal",
                 summary: "Supersede a live worktree occupancy lease (--confirm --occupant)",
             },
+            {
+                name: "occupancy:release",
+                summary: "Release this worktree occupancy lease (owner live, or expired residue)",
+            },
+            {
+                name: "session:end",
+                summary: "End this mutation session by releasing occupancy (same as occupancy:release)",
+            },
             {
                 name: "freshness:report",
                 summary: "Bound vs live deposit generation (current|stale_soft|stale_hard)",

package/dist/human-presence-mint.d.ts

@@ -16,7 +16,7 @@ export interface HumanPresenceMintSeams {
     /** Environ for agent-shell marker detection (default: process.env). */
     readonly environ?: NodeJS.ProcessEnv;
     /**
-     * True when a controlling terminal device is available (`/dev/tty` or `CONIN$`).
+     * True when a controlling terminal device is available (`/dev/tty` or `\\.\CONIN$`).
      * Default: open/close the platform controlling terminal (fail-closed on error).
      */
     readonly hasControllingTerminal?: () => boolean;
@@ -27,13 +27,13 @@ export interface HumanPresenceMintSeams {
     readonly readInteractiveConfirm?: () => string | null;
 }
 export declare function looksLikeAgentShell(environ: NodeJS.ProcessEnv): boolean;
-/** Platform controlling-terminal path (`CONIN$` on win32, `/dev/tty` elsewhere). */
+/** Platform controlling-terminal path (`\\.\CONIN$` on win32, `/dev/tty` elsewhere). */
 export declare function controllingTerminalPath(platform?: NodeJS.Platform): string;
 /**
- * Open flag for the platform controlling-terminal device (#3596).
+ * Open flag for the platform controlling-terminal device (#3596 leftover).
  *
- * Windows `CONIN$` generally requires read/write (`r+`); `r` (O_RDONLY) fails
- * in a real interactive console and made operator mint unreachable on win32.
+ * Win32 stays `r+` so the probe and phrase-read share one flag. The leftover
+ * path is the Windows device-namespace CONIN$ string, not bare CONIN$.
  */
 export declare function controllingTerminalOpenFlag(platform?: NodeJS.Platform): "r" | "r+";
 export declare function resolveHumanPresenceMintSeams(seams?: HumanPresenceMintSeams): Required<HumanPresenceMintSeams>;
@@ -52,7 +52,7 @@ export declare function refuseMintWhileUatActive(verb: string, projectRoot: stri
  * Multi-factor human-presence gate (applies only when UAT lease is inactive):
  * 1. No known agent/CI env markers
  * 2. Interactive TTY (stdin + stdout isTTY)
- * 3. Controlling terminal device present (`/dev/tty` / `CONIN$`)
+ * 3. Controlling terminal device present (`/dev/tty` / `\\.\CONIN$`)
  * 4. Explicit argv `--confirm` (flag alone never enough)
  * 5. Interactive typed phrase `mint` (argv --confirm alone never enough even on PTY)
  *

package/dist/human-presence-mint.js

@@ -67,15 +67,16 @@ export function looksLikeAgentShell(environ) {
 function defaultIsTty() {
     return process.stdin.isTTY === true && process.stdout.isTTY === true;
 }
-/** Platform controlling-terminal path (`CONIN$` on win32, `/dev/tty` elsewhere). */
+/** Platform controlling-terminal path (`\\.\CONIN$` on win32, `/dev/tty` elsewhere). */
 export function controllingTerminalPath(platform = process.platform) {
-    return platform === "win32" ? "CONIN$" : "/dev/tty";
+    // Real-console diagnostic on #3596: bare CONIN$ and CON ENOENT; device-namespace path opens.
+    return platform === "win32" ? "\\\\.\\CONIN$" : "/dev/tty";
 }
 /**
- * Open flag for the platform controlling-terminal device (#3596).
+ * Open flag for the platform controlling-terminal device (#3596 leftover).
  *
- * Windows `CONIN$` generally requires read/write (`r+`); `r` (O_RDONLY) fails
- * in a real interactive console and made operator mint unreachable on win32.
+ * Win32 stays `r+` so the probe and phrase-read share one flag. The leftover
+ * path is the Windows device-namespace CONIN$ string, not bare CONIN$.
  */
 export function controllingTerminalOpenFlag(platform = process.platform) {
     return platform === "win32" ? "r+" : "r";
@@ -153,7 +154,7 @@ export function refuseMintWhileUatActive(verb, projectRoot) {
  * Multi-factor human-presence gate (applies only when UAT lease is inactive):
  * 1. No known agent/CI env markers
  * 2. Interactive TTY (stdin + stdout isTTY)
- * 3. Controlling terminal device present (`/dev/tty` / `CONIN$`)
+ * 3. Controlling terminal device present (`/dev/tty` / `\\.\CONIN$`)
  * 4. Explicit argv `--confirm` (flag alone never enough)
  * 5. Interactive typed phrase `mint` (argv --confirm alone never enough even on PTY)
  *

package/dist/occupancy-release.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+export declare function parseArgs(argv: readonly string[]): {
+    projectRoot: string;
+    error?: string;
+};
+export declare function run(argv: readonly string[]): number;
+//# sourceMappingURL=occupancy-release.d.ts.map

package/dist/occupancy-release.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { releaseOccupancy } from "@deftai/directive-core/session";
+export function parseArgs(argv) {
+    const parsed = { projectRoot: "." };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        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 {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return parsed;
+}
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`occupancy:release: ${args.error}\n`);
+        return 2;
+    }
+    const result = releaseOccupancy(resolve(args.projectRoot), {
+        env: process.env,
+    });
+    const sink = result.code === 0 ? process.stdout : process.stderr;
+    sink.write(`${result.message}\n`);
+    return result.code;
+}
+//# sourceMappingURL=occupancy-release.js.map

package/dist/triage-actions.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { accept, createDefaultDeps, deferAction, formatDecision, history, markDuplicate, needsAc, reject, reset, status, TriageError, UpstreamCloseError, } from "@deftai/directive-core/dist/triage/actions/index.js";
+import { accept, createDefaultDeps, deferAction, formatAcceptOutput, formatDecision, history, markDuplicate, needsAc, reject, reset, status, TriageError, UpstreamCloseError, } from "@deftai/directive-core/dist/triage/actions/index.js";
 const VALID_CMDS = new Set([
     "accept",
     "reject",
@@ -158,8 +158,7 @@ export function run(argv) {
                 autoPromote: args.autoPromote === true,
                 force: args.force === true,
             });
-            const promoteNote = args.autoPromote === true ? " + auto-promote" : "";
-            process.stdout.write(`accept #${n} (${repo}) -> ${decisionId}${promoteNote}\n`);
+            process.stdout.write(`${formatAcceptOutput(n, repo, decisionId, { autoPromote: args.autoPromote === true })}\n`);
         }
         else if (args.cmd === "reject") {
             const decisionId = reject(n, repo, args.reason ?? "", deps, {

package/dist/triage-evaluate.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+interface Parsed {
+    projectRoot: string;
+    repo: string | null;
+    issues: number[];
+    concurrency: number;
+    json: boolean;
+    error?: string;
+}
+export declare function parseArgs(argv: string[]): Parsed;
+export declare function run(argv: string[]): Promise<number>;
+export declare function main(argv: string[]): Promise<number>;
+export {};
+//# sourceMappingURL=triage-evaluate.d.ts.map

package/dist/triage-evaluate.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { DEFAULT_CONCURRENCY, EvaluateError, evaluateIssues, renderEvaluateText, } from "@deftai/directive-core/dist/triage/evaluate/index.js";
+import { interceptHelp } from "@deftai/directive-core/dist/triage/help/index.js";
+import { resolveRepo } from "@deftai/directive-core/dist/triage/queue/repo.js";
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: process.env.DEFT_PROJECT_ROOT ?? process.cwd(),
+        repo: process.env.DEFT_TRIAGE_REPO ?? null,
+        issues: [],
+        concurrency: DEFAULT_CONCURRENCY,
+        json: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === undefined || arg === "--") {
+            continue;
+        }
+        if (arg === "--project-root") {
+            if (i + 1 >= argv.length) {
+                return { ...parsed, error: "--project-root requires a path" };
+            }
+            i += 1;
+            const value = argv[i];
+            if (value === undefined) {
+                return { ...parsed, error: "--project-root requires a path" };
+            }
+            parsed.projectRoot = value;
+        }
+        else if (arg.startsWith("--project-root=")) {
+            parsed.projectRoot = arg.slice("--project-root=".length);
+        }
+        else if (arg === "--repo") {
+            if (i + 1 >= argv.length) {
+                return { ...parsed, error: "--repo requires owner/name" };
+            }
+            i += 1;
+            const value = argv[i];
+            if (value === undefined) {
+                return { ...parsed, error: "--repo requires owner/name" };
+            }
+            parsed.repo = value;
+        }
+        else if (arg.startsWith("--repo=")) {
+            parsed.repo = arg.slice("--repo=".length);
+        }
+        else if (arg === "--issue") {
+            if (i + 1 >= argv.length) {
+                return { ...parsed, error: "--issue requires a number" };
+            }
+            i += 1;
+            const value = argv[i];
+            if (value === undefined) {
+                return { ...parsed, error: "--issue requires a number" };
+            }
+            const n = Number.parseInt(value, 10);
+            if (!Number.isInteger(n) || n < 1) {
+                return { ...parsed, error: `--issue invalid: ${value}` };
+            }
+            parsed.issues.push(n);
+        }
+        else if (arg.startsWith("--issue=")) {
+            const n = Number.parseInt(arg.slice("--issue=".length), 10);
+            if (!Number.isInteger(n) || n < 1) {
+                return { ...parsed, error: `--issue invalid: ${arg}` };
+            }
+            parsed.issues.push(n);
+        }
+        else if (arg === "--concurrency") {
+            if (i + 1 >= argv.length) {
+                return { ...parsed, error: "--concurrency requires a positive integer" };
+            }
+            i += 1;
+            const value = argv[i];
+            if (value === undefined) {
+                return { ...parsed, error: "--concurrency requires a positive integer" };
+            }
+            const n = Number.parseInt(value, 10);
+            if (!Number.isInteger(n) || n < 1) {
+                return { ...parsed, error: `--concurrency invalid: ${value}` };
+            }
+            parsed.concurrency = n;
+        }
+        else if (arg.startsWith("--concurrency=")) {
+            const n = Number.parseInt(arg.slice("--concurrency=".length), 10);
+            if (!Number.isInteger(n) || n < 1) {
+                return { ...parsed, error: `--concurrency invalid: ${arg}` };
+            }
+            parsed.concurrency = n;
+        }
+        else if (arg === "--json") {
+            parsed.json = true;
+        }
+        else if (arg.startsWith("-")) {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+        else {
+            const n = Number.parseInt(arg.replace(/^#/u, ""), 10);
+            if (!Number.isInteger(n) || n < 1) {
+                return { ...parsed, error: `invalid issue number: ${arg}` };
+            }
+            parsed.issues.push(n);
+        }
+    }
+    return parsed;
+}
+export async function run(argv) {
+    const help = interceptHelp("triage_evaluate", argv);
+    if (help !== null) {
+        return help;
+    }
+    const parsed = parseArgs(argv);
+    if (parsed.error !== undefined) {
+        process.stderr.write(`triage:evaluate: ${parsed.error}\n`);
+        return 2;
+    }
+    const projectRoot = resolve(parsed.projectRoot);
+    const repo = resolveRepo(parsed.repo, projectRoot);
+    if (repo === null) {
+        process.stderr.write("triage:evaluate: --repo owner/name is required\n");
+        return 2;
+    }
+    try {
+        const result = await evaluateIssues({
+            projectRoot,
+            repo,
+            issues: parsed.issues,
+            concurrency: parsed.concurrency,
+        });
+        if (parsed.json) {
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        }
+        else {
+            process.stdout.write(renderEvaluateText(result));
+        }
+        return result.verdicts.some((v) => v.error !== null) ? 1 : 0;
+    }
+    catch (err) {
+        const message = err instanceof EvaluateError ? err.message : String(err);
+        process.stderr.write(`triage:evaluate: ${message}\n`);
+        return err instanceof EvaluateError ? 2 : 1;
+    }
+}
+export async function main(argv) {
+    return run(argv);
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    void run(process.argv.slice(2)).then((code) => {
+        process.exit(code);
+    });
+}
+//# sourceMappingURL=triage-evaluate.js.map

package/dist/verify-completed-tracked.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { evaluateCompletedTracked } from "@deftai/directive-core/lifecycle";
+import { COMPLETED_TRACKED_PROGRESS_MIN_BLOBS, COMPLETED_TRACKED_PROGRESS_THRESHOLD_MS, evaluateCompletedTracked, shouldAnnounceProgress, shouldAnnounceUpFrontCount, } from "@deftai/directive-core/lifecycle";
 function parseIssueNumber(raw) {
     const trimmed = raw.startsWith("#") ? raw.slice(1) : raw;
     if (!/^\d+$/.test(trimmed)) {
@@ -95,12 +95,27 @@ export function run(argv) {
         return 2;
     }
     const projectRoot = resolve(args.projectRoot);
+    const thresholdMs = resolveProgressThresholdMs();
+    let announced = false;
     const result = evaluateCompletedTracked(projectRoot, {
         quiet: args.quiet,
         repo: args.repo,
         tip: args.tip,
         issue: args.issue,
         skipGh: args.skipGh,
+        onProgress: (event) => {
+            if (args.quiet || announced) {
+                return;
+            }
+            const minBlobs = resolveProgressMinBlobs();
+            const upFront = event.phase === "listed" &&
+                shouldAnnounceUpFrontCount(event.terminalCount, event.nonterminalCount, minBlobs);
+            if (!upFront && !shouldAnnounceProgress(event.elapsedMs, thresholdMs)) {
+                return;
+            }
+            announced = true;
+            writeProgress(event);
+        },
     });
     if (result.message.length > 0) {
         if (result.stream === "stdout") {
@@ -112,6 +127,24 @@ export function run(argv) {
     }
     return result.code;
 }
+function resolveProgressThresholdMs() {
+    const raw = process.env.DEFT_COMPLETED_TRACKED_PROGRESS_MS;
+    if (raw !== undefined && /^\d+$/.test(raw)) {
+        return Number(raw);
+    }
+    return COMPLETED_TRACKED_PROGRESS_THRESHOLD_MS;
+}
+function resolveProgressMinBlobs() {
+    const raw = process.env.DEFT_COMPLETED_TRACKED_PROGRESS_MIN_BLOBS;
+    if (raw !== undefined && /^\d+$/.test(raw)) {
+        return Number(raw);
+    }
+    return COMPLETED_TRACKED_PROGRESS_MIN_BLOBS;
+}
+function writeProgress(event) {
+    process.stderr.write(`verify:completed-tracked: still running (${event.elapsedMs}ms); ` +
+        `reading ${event.terminalCount} terminal and ${event.nonterminalCount} nonterminal blobs.\n`);
+}
 if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
     process.exit(run(process.argv.slice(2)));
 }

package/dist/verify-completed-write-guard.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    baseRef: string;
+    quiet: boolean;
+    error?: string;
+}
+/** Parse verify-completed-write-guard CLI args (#3679). */
+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-completed-write-guard.d.ts.map

package/dist/verify-completed-write-guard.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+/**
+ * CLI for verify:completed-write-guard (#3679).
+ */
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluateCompletedWriteGuard } from "@deftai/directive-core/lifecycle";
+/** Parse verify-completed-write-guard CLI args (#3679). */
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        baseRef: "",
+        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 === "--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 {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    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_completed_write_guard: ${args.error}\n`);
+        return 2;
+    }
+    const projectRoot = resolve(args.projectRoot);
+    const result = evaluateCompletedWriteGuard(projectRoot, {
+        ...(args.baseRef.length > 0 ? { baseRef: args.baseRef } : {}),
+    });
+    if (result.message.length > 0 && !args.quiet) {
+        if (result.code === 0) {
+            process.stdout.write(`${result.message}\n`);
+        }
+        else {
+            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-completed-write-guard.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.106.0",
+  "version": "0.107.0",
   "description": "Directive CLI — npm install path for the Deft Directive framework.",
   "license": "MIT",
   "homepage": "https://deftai.github.io/directive/",
@@ -34,8 +34,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-core": "^0.106.0",
-    "@deftai/directive-content": "^0.106.0"
+    "@deftai/directive-core": "^0.107.0",
+    "@deftai/directive-content": "^0.107.0"
   },
   "scripts": {
     "build": "tsc -b"