@deftai/directive 0.119.5 → 0.119.7

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

@@ -28,6 +28,7 @@ export const SCOPE_LIFECYCLE_VERBS = new Set([
     "restore",
     "block",
     "unblock",
+    "stamp-evidence",
 ]);
 /** pr:* task names that do not hyphenate 1:1 to handler stems. */
 export const PR_VERB_MAP = {

package/dist/doctor.js

@@ -100,42 +100,45 @@ async function resolveEngineContentRoot() {
     }
 }
 export async function run(argv) {
-    // #2022: surface pre-cutover (pre-v0.20 document model) migration state alongside the
-    // core doctor report. Only emit on a valid, human-readable invocation: suppressed under
-    // --json (so the machine-readable report stays valid), on --help, and when unknown flags
-    // are present (so an invalid invocation still mirrors the core error path exactly).
+    // Human advisory lines stay off --json so the machine report stays one object.
+    // Deposit hygiene is still passed into cmdDoctor, including --json (#4812).
     const flags = parseDoctorFlags(argv);
-    let depositHygieneExit = 0;
     const installedRoot = await resolveEngineContentRoot();
     if (installedRoot !== null) {
         setDoctorAgentsTemplateRoot(installedRoot);
     }
     try {
-        if (!flags.json && !flags.help && flags.unknown.length === 0) {
-            const projectRoot = flags.projectRoot ?? process.cwd();
-            const walkRoot = resolveContentPackageRoot(projectRoot);
-            const depositResult = evaluateDepositFileSetHygiene(projectRoot, {
-                contentRoot: installedRoot ?? undefined,
-                walkRoot,
-                installedRoot,
-            });
+        if (flags.help || flags.unknown.length > 0) {
+            return cmdDoctor(argv);
+        }
+        const projectRoot = flags.projectRoot ?? process.cwd();
+        const walkRoot = resolveContentPackageRoot(projectRoot);
+        const depositResult = evaluateDepositFileSetHygiene(projectRoot, {
+            contentRoot: installedRoot ?? undefined,
+            walkRoot,
+            installedRoot,
+        });
+        const closure = evaluateInstalledDepositClosure(projectRoot);
+        // Package-absent files stay diagnostic unless --full. A real hygiene failure
+        // (full file-set or declared closure) is the one status cmdDoctor shares.
+        const fileSetFailed = flags.full && !depositResult.skipped && depositResult.absent.length > 0;
+        const closureFailed = flags.full && !closure.skipped && (closure.missing.length > 0 || closure.error !== null);
+        const line = renderDepositFileSetHygieneLine(projectRoot, depositResult);
+        if (!flags.json) {
             process.stdout.write(`${renderPrecutoverLine(projectRoot)}\n`);
             process.stdout.write(`${renderXbriefMigrationLine(projectRoot)}\n`);
             process.stdout.write(`${renderStaleHeaderLine(projectRoot)}\n`);
-            process.stdout.write(`${renderDepositFileSetHygieneLine(projectRoot, depositResult)}\n`);
-            const closure = evaluateInstalledDepositClosure(projectRoot);
+            process.stdout.write(`${line}\n`);
             process.stdout.write(`${renderDeclaredDepositClosureLine(closure)}\n`);
-            if (flags.full && !depositResult.skipped && depositResult.absent.length > 0) {
-                depositHygieneExit = 1;
-            }
-            if (flags.full &&
-                !closure.skipped &&
-                (closure.missing.length > 0 || closure.error !== null)) {
-                depositHygieneExit = 1;
-            }
         }
-        const doctorExit = cmdDoctor(argv);
-        return Math.max(depositHygieneExit, doctorExit);
+        const closureLine = renderDeclaredDepositClosureLine(closure);
+        return cmdDoctor(argv, {
+            depositHygiene: {
+                failed: fileSetFailed || closureFailed,
+                absent: depositResult.absent,
+                line: fileSetFailed ? line : closureFailed ? closureLine : line,
+            },
+        });
     }
     finally {
         setDoctorAgentsTemplateRoot(undefined);

package/dist/plan-sequence.js

@@ -5,7 +5,7 @@
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { advancePlanSequence, clearPlanSequence, createPlanSequence, parsePlanSequence, readPlanSequence, writePlanSequence, } from "@deftai/directive-core/plan-sequence";
+import { advancePlanSequence, clearPlanSequence, collectTerminalLifecycleOrigins, createPlanSequence, detectTerminalEntryDrift, inspectMissingSequenceKind, missingSequenceKindPayload, parsePlanSequence, readPlanSequence, writePlanSequence, } from "@deftai/directive-core/plan-sequence";
 export function parseArgs(argv) {
     const parsed = {
         projectRoot: ".",
@@ -113,13 +113,40 @@ export function main(argv = process.argv.slice(2)) {
             return 0;
         }
         if (parsed.action === "current") {
+            const missingKind = inspectMissingSequenceKind(root);
+            if (missingKind !== null) {
+                if (parsed.emitJson) {
+                    process.stdout.write(`${JSON.stringify(missingSequenceKindPayload(missingKind), null, 2)}\n`);
+                }
+                else {
+                    process.stderr.write(`${missingKind.message}\n`);
+                }
+                return 1;
+            }
             const seq = readPlanSequence(root);
             if (seq === null) {
                 process.stderr.write("No active ordered-plan sequence (.deft/plan-sequence.json missing).\n");
                 return 1;
             }
+            const drift = detectTerminalEntryDrift(seq, collectTerminalLifecycleOrigins(root));
             if (parsed.emitJson) {
-                process.stdout.write(`${JSON.stringify(seq, null, 2)}\n`);
+                if (drift.drifted) {
+                    process.stdout.write(`${JSON.stringify({
+                        ...seq,
+                        terminal_lifecycle_drift: {
+                            code: drift.code,
+                            message: drift.message,
+                            originPath: drift.originPath,
+                            folder: drift.folder,
+                        },
+                    }, null, 2)}\n`);
+                }
+                else {
+                    process.stdout.write(`${JSON.stringify(seq, null, 2)}\n`);
+                }
+            }
+            else if (drift.drifted) {
+                process.stderr.write(`${drift.message}\n`);
             }
             else {
                 const cur = seq.exhausted ? null : seq.entries[seq.current_index];
@@ -132,7 +159,7 @@ export function main(argv = process.argv.slice(2)) {
                     process.stdout.write("current: (exhausted — fresh approval required)\n");
                 }
             }
-            return 0;
+            return drift.drifted ? 1 : 0;
         }
         if (parsed.action === "clear") {
             const cleared = clearPlanSequence(root);

package/dist/policy.js

@@ -274,7 +274,6 @@ export function parseArgs(argv) {
                 host = parsedHost;
             }
             else if (arg === "--") {
-                continue;
             }
             else {
                 return makeSetError(`unrecognized argument: ${arg}`);

package/dist/vbrief-preflight.js

@@ -46,7 +46,7 @@ export function parseArgs(argv) {
             if (nextToken === "--help" || nextToken === "-h") {
                 return { ...parsed, help: true };
             }
-            if (nextToken !== undefined && nextToken.startsWith("-")) {
+            if (nextToken?.startsWith("-")) {
                 return {
                     ...parsed,
                     error: "argument --vbrief-path: expected one argument",

package/dist/verify-plan-sequence.js

@@ -4,7 +4,7 @@
  */
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { readPlanSequence, verifyPlanTarget, } from "@deftai/directive-core/plan-sequence";
+import { collectTerminalLifecycleOrigins, inspectMissingSequenceKind, missingSequenceKindPayload, readPlanSequence, verifyPlanTarget, } from "@deftai/directive-core/plan-sequence";
 const KINDS = [
     "pr",
     "issue",
@@ -94,7 +94,18 @@ export function main(argv = process.argv.slice(2)) {
         process.stderr.write(`${parsed.error ?? "usage error"}\n`);
         return 2;
     }
-    const seq = readPlanSequence(resolve(parsed.projectRoot));
+    const root = resolve(parsed.projectRoot);
+    const missingKind = inspectMissingSequenceKind(root);
+    if (missingKind !== null) {
+        if (parsed.emitJson) {
+            process.stdout.write(`${JSON.stringify(missingSequenceKindPayload(missingKind), null, 2)}\n`);
+        }
+        else {
+            process.stderr.write(`${missingKind.message}\n`);
+        }
+        return 1;
+    }
+    const seq = readPlanSequence(root);
     // No sequence: allow (caller may have explicit operator approval); warn on stderr.
     if (seq === null) {
         if (parsed.emitJson) {
@@ -108,6 +119,7 @@ export function main(argv = process.argv.slice(2)) {
     const result = verifyPlanTarget(seq, {
         targetKind: parsed.targetKind,
         target: parsed.target,
+        terminalOrigins: collectTerminalLifecycleOrigins(root),
     });
     if (parsed.emitJson) {
         process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.119.5",
+  "version": "0.119.7",
   "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.119.5",
-    "@deftai/directive-content": "^0.119.5"
+    "@deftai/directive-core": "^0.119.7",
+    "@deftai/directive-content": "^0.119.7"
   },
   "scripts": {
     "build": "tsc -b"