@deftai/directive 0.119.13 → 0.121.0

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 { COMPLETED_TRACKED_PROGRESS_MIN_BLOBS, COMPLETED_TRACKED_PROGRESS_THRESHOLD_MS, evaluateCompletedTracked, shouldAnnounceProgress, shouldAnnounceUpFrontCount, } from "@deftai/directive-core/lifecycle";
+import { COMPLETED_TRACKED_PROGRESS_MIN_BLOBS, COMPLETED_TRACKED_PROGRESS_THRESHOLD_MS, evaluateCompletedTracked, evaluateShippedClosedDiscovery, shouldAnnounceProgress, shouldAnnounceUpFrontCount, } from "@deftai/directive-core/lifecycle";
 function parseIssueNumber(raw) {
     const trimmed = raw.startsWith("#") ? raw.slice(1) : raw;
     if (!/^\d+$/.test(trimmed)) {
@@ -10,7 +10,7 @@ function parseIssueNumber(raw) {
     const value = Number(trimmed);
     return Number.isInteger(value) && value > 0 ? value : null;
 }
-/** Parse verify-completed-tracked CLI args (#3264 / #3476). */
+/** Parse verify-completed-tracked CLI args (#3264 / #3476 / #3495). */
 export function parseArgs(argv) {
     const parsed = {
         projectRoot: ".",
@@ -19,6 +19,8 @@ export function parseArgs(argv) {
         issue: null,
         quiet: false,
         skipGh: false,
+        discover: null,
+        enforce: false,
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -28,6 +30,15 @@ export function parseArgs(argv) {
         else if (arg === "--skip-gh") {
             parsed.skipGh = true;
         }
+        else if (arg === "--discover") {
+            parsed.discover = true;
+        }
+        else if (arg === "--no-discover") {
+            parsed.discover = false;
+        }
+        else if (arg === "--enforce") {
+            parsed.enforce = true;
+        }
         else if (arg === "--project-root") {
             const value = argv[i + 1];
             if (value === undefined) {
@@ -87,6 +98,16 @@ export function parseArgs(argv) {
     }
     return parsed;
 }
+function shouldRunDiscovery(args) {
+    if (args.discover === false) {
+        return false;
+    }
+    if (args.discover === true || args.enforce) {
+        return true;
+    }
+    // Warn-first default: unscoped corpus scans discover; --issue N stays land-only.
+    return args.issue === null;
+}
 /** Run the gate and return the process exit code. */
 export function run(argv) {
     const args = parseArgs(argv);
@@ -97,7 +118,7 @@ export function run(argv) {
     const projectRoot = resolve(args.projectRoot);
     const thresholdMs = resolveProgressThresholdMs();
     let announced = false;
-    const result = evaluateCompletedTracked(projectRoot, {
+    const land = evaluateCompletedTracked(projectRoot, {
         quiet: args.quiet,
         repo: args.repo,
         tip: args.tip,
@@ -117,15 +138,45 @@ export function run(argv) {
             writeProgress(event);
         },
     });
-    if (result.message.length > 0) {
-        if (result.stream === "stdout") {
-            process.stdout.write(`${result.message}\n`);
+    let discoveryCode = 0;
+    let discoveryMessage = "";
+    let discoveryStream = "none";
+    if (shouldRunDiscovery(args)) {
+        const discovery = evaluateShippedClosedDiscovery(projectRoot, {
+            quiet: args.quiet,
+            repo: args.repo,
+            tip: args.tip,
+            skipGh: args.skipGh,
+            enforce: args.enforce,
+        });
+        discoveryCode = discovery.code;
+        discoveryMessage = discovery.message;
+        discoveryStream = discovery.stream;
+    }
+    // Scoped land fail-closed must not be softened by discovery warn (#3495 Reject).
+    if (land.message.length > 0) {
+        if (land.stream === "stdout") {
+            process.stdout.write(`${land.message}\n`);
         }
-        else if (result.stream === "stderr") {
-            process.stderr.write(`${result.message}\n`);
+        else if (land.stream === "stderr") {
+            process.stderr.write(`${land.message}\n`);
         }
     }
-    return result.code;
+    if (discoveryMessage.length > 0) {
+        if (discoveryStream === "stdout") {
+            process.stdout.write(`${discoveryMessage}\n`);
+        }
+        else if (discoveryStream === "stderr") {
+            process.stderr.write(`${discoveryMessage}\n`);
+        }
+    }
+    if (land.code === 2 || discoveryCode === 2) {
+        return 2;
+    }
+    if (land.code === 1 || discoveryCode === 1) {
+        return 1;
+    }
+    return 0;
 }
 function resolveProgressThresholdMs() {
     const raw = process.env.DEFT_COMPLETED_TRACKED_PROGRESS_MS;

package/dist/verify-review-monitor.d.ts

@@ -14,6 +14,8 @@ interface ParsedArgs {
     liveWait: boolean;
     explicitFinish: boolean;
     stickyLease: boolean;
+    /** DeliveryAttemptRecord.startedAt for Approach 1 arm-startup halt (#5278 P3). */
+    dispatchStartedAt: string | null;
     help: boolean;
     error?: string;
 }

package/dist/verify-review-monitor.js

@@ -2,7 +2,9 @@
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { bindLivePhaseCorrectWait, evaluateMergePathArm, } from "@deftai/directive-core/dist/pr-watch/main.js";
+import { evaluateApproach1ArmStartup } from "@deftai/directive-core/orchestration";
 import { EXIT_CONFIG_ERROR, EXIT_NOT_READY, evaluateReviewMonitorGate, formatApproach1BabysitterOneLiner, isTier1, REVIEW_MONITOR_HELP, spawnRedirect, verifyResultToJson, } from "@deftai/directive-core/review-monitor";
+import { writeMergePathExplicitFinishAttestation } from "@deftai/directive-core/swarm";
 const CALL_SITES = new Set([
     "solo",
     "swarm-phase5-6",
@@ -23,6 +25,7 @@ export function parseVerifyReviewMonitorArgs(argv) {
         liveWait: false,
         explicitFinish: false,
         stickyLease: false,
+        dispatchStartedAt: null,
         help: false,
     };
     for (let i = 0; i < argv.length; i += 1) {
@@ -45,6 +48,17 @@ export function parseVerifyReviewMonitorArgs(argv) {
         else if (arg === "--sticky-lease") {
             acc.stickyLease = true;
         }
+        else if (arg === "--dispatch-started-at") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --dispatch-started-at: expected one argument" };
+            }
+            acc.dispatchStartedAt = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--dispatch-started-at=")) {
+            acc.dispatchStartedAt = arg.slice("--dispatch-started-at=".length);
+        }
         else if (arg === "--approach3") {
             acc.approach3 = true;
         }
@@ -146,6 +160,9 @@ export function run(argv) {
             "                         parent-shell pr:watch (parent_id=pr-watch) does not arm.\n" +
             "  --explicit-finish      Attest option-C BLOCKED/FAILED finish for this PR\n" +
             "  --sticky-lease         Attest a fresh sticky lease (not sufficient alone)\n" +
+            "  --dispatch-started-at  DeliveryAttemptRecord.startedAt ISO for Approach 1\n" +
+            "                         arm-startup halt (#5278); when merge-path-arm stays\n" +
+            "                         red past the 3m allowance, emit approach1-arm-startup.\n" +
             "  Prefer Approach 1 / native pr:watch --monitor-agent-id <id> or post-CLEAN\n" +
             "  pr:wait-mergeable-and-merge; homemade line-parsed --json is not an arm.\n");
         return 0;
@@ -174,6 +191,26 @@ export function run(argv) {
     });
     let arm = null;
     if (args.mergePathArm) {
+        // Durable option-C attestation for cohort inventory halted-explicit (#5318).
+        // Do not write (or arm from) --explicit-finish when the monitor gate is a config error,
+        // and fail closed if the durable write itself fails.
+        let explicitFinishDurable = false;
+        if (args.explicitFinish) {
+            if (result.exitCode === EXIT_CONFIG_ERROR) {
+                explicitFinishDurable = false;
+            }
+            else {
+                const written = writeMergePathExplicitFinishAttestation(resolve(args.projectRoot), args.pr, {
+                    source: "verify:review-monitor --explicit-finish",
+                });
+                if (!written.ok) {
+                    process.stderr.write(`verify_review_monitor: ${written.reason}
+`);
+                    return EXIT_CONFIG_ERROR;
+                }
+                explicitFinishDurable = true;
+            }
+        }
         // Bind --live-wait to lease (#5018) + process-liveness heartbeat (#5020) on Tier 1.
         // spawn_subagent identity join is already applied in evaluateReviewMonitorGate (#5219).
         const leaseEvidence = result.monitorRecord !== null;
@@ -186,7 +223,7 @@ export function run(argv) {
         });
         arm = evaluateMergePathArm({
             livePhaseCorrectWait: liveBind.livePhaseCorrectWait,
-            explicitFinish: args.explicitFinish,
+            explicitFinish: explicitFinishDurable,
             stickyLeaseActive: args.stickyLease || leaseEvidence,
         });
         if (args.liveWait && !liveBind.livePhaseCorrectWait && !args.explicitFinish && !arm.armed) {
@@ -224,6 +261,26 @@ export function run(argv) {
             };
         }
     }
+    // Approach 1 arm-startup halt (#5278 P3): production caller for evaluateApproach1ArmStartup.
+    let armStartupHalt = null;
+    if (args.mergePathArm &&
+        args.dispatchStartedAt !== null &&
+        args.dispatchStartedAt.trim().length > 0 &&
+        arm !== null &&
+        !arm.armed &&
+        !args.explicitFinish) {
+        armStartupHalt = evaluateApproach1ArmStartup({
+            dispatchStartedAt: args.dispatchStartedAt,
+            probeReady: false,
+        });
+        if (armStartupHalt.halt && armStartupHalt.message.length > 0) {
+            arm = {
+                armed: false,
+                reason: "unarmed_stand_down",
+                message: `${arm.message}\n${armStartupHalt.message}`,
+            };
+        }
+    }
     if (args.emitJson) {
         const payload = verifyResultToJson(result);
         if (arm !== null) {
@@ -237,6 +294,14 @@ export function run(argv) {
                 lease_evidence: result.monitorRecord !== null,
                 heartbeat_active: result.heartbeatActive,
             };
+            if (armStartupHalt !== null) {
+                payload.approach1_arm_startup = {
+                    halt: armStartupHalt.halt,
+                    halt_class: armStartupHalt.halt_class,
+                    elapsed_seconds: armStartupHalt.elapsed_seconds,
+                    message: armStartupHalt.message,
+                };
+            }
             // Combined gate+arm: unarmed fails closed even when the monitor gate is ready.
             if (!arm.armed && result.exitCode !== EXIT_CONFIG_ERROR) {
                 payload.ready = false;

package/dist/verify-source-cli/verify-spec-drift.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function run(argv: string[]): number;
+//# sourceMappingURL=verify-spec-drift.d.ts.map

package/dist/verify-source-cli/verify-spec-drift.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { runSpecDriftCli } from "@deftai/directive-core/verify-source";
+export function run(argv) {
+    const result = runSpecDriftCli(argv);
+    if (result.stdout.length > 0)
+        process.stdout.write(result.stdout);
+    if (result.stderr.length > 0)
+        process.stderr.write(result.stderr);
+    return result.exitCode;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=verify-spec-drift.js.map

package/dist/verify-story-ready.js

@@ -95,8 +95,11 @@ const HELP_TEXT = `usage: verify-story-ready [--vbrief-path PATH] [--project-roo
                           [--skip-routing] [--roles ROLE[,ROLE...]]
 
 Deterministic story-start Gate 0 (#1378). When the active dispatch provider is
-cursor or grok, chains verify:routing (#1877 single-dispatch enforcement).
-Three-state exit: 0 ready / 1 not ready / 2 config error.
+one of ROUTING_GATED_DISPATCH_PROVIDERS (claude, cursor, grok, grok-bot,
+openclaw), chains verify:routing (#1877 / #3703). --skip-routing records a
+silent opt-out. Session-start --advise remains additive disclosure only and
+does not relieve honor-at-dispatch. Three-state exit: 0 ready / 1 not ready /
+2 config error.
 `;
 function emitJson(vbriefPath, exitCode, message, dispatchKind) {
     const payload = {

package/dist/verify-subagent-alive.js

@@ -129,6 +129,20 @@ export function evaluateSubagentAliveGate(args, cwd = process.cwd()) {
                 redispatch_ok: unhealthy && !configError,
                 required_agents: [...args.requireAgents],
                 missing_or_stale_agents: missingAgents,
+                // Flat per-agent records including wait_kind (#5278 P2).
+                records: sweep.records.map((r) => ({
+                    agent_id: r.agent_id,
+                    phase: r.phase,
+                    wait_kind: r.wait_kind,
+                    head_sha: r.head_sha,
+                    pr_number: r.pr_number,
+                    last_heartbeat_at: r.last_heartbeat_at_iso,
+                    age_seconds: r.age_seconds,
+                    is_stale: r.is_stale,
+                    is_terminal: r.is_terminal,
+                    failures: [...r.failures],
+                    ok: recordOk(r),
+                })),
                 sweep: {
                     scratch_dirs: sweep.scratch_dirs,
                     threshold_minutes: sweep.threshold_minutes,
@@ -167,10 +181,12 @@ export function evaluateSubagentAliveGate(args, cwd = process.cwd()) {
     lines.push("");
     lines.push("REDISPATCH_OK: host-reported running + missing/STALE heartbeat authorizes takeover.");
     lines.push("A killed worker's delivery attempt stays running until cancelled.");
-    lines.push("Takeover: task swarm:pre-dispatch -- --scope-id <id> --target-id <worktree> --action cancel");
+    lines.push("Takeover: task subagent:pre-cancel -- --agent <id> --canceller-id <id> --target-id <worktree>");
+    lines.push("then:     task swarm:pre-dispatch -- --scope-id <id> --target-id <worktree> --action cancel --agent <id>");
     lines.push("then:     task swarm:pre-dispatch -- --scope-id <id> --target-id <worktree>");
     lines.push("If verify:session-ritual --tier=gated fails, run session:start --rearm --session-id=<same> first.");
     lines.push("Do not wait on Cursor false-alive state. Do not spawn while DENY_DUPLICATE_ACTIVE.");
+    lines.push("⊗ bare ledger cancel while pre-cancel is red (#5278).");
     return {
         exitCode: EXIT_STALE,
         redispatchOk: true,

package/package.json

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