@deftai/directive 0.119.6 → 0.119.8

package/dist/cli-package-version.d.ts

@@ -0,0 +1,3 @@
+/** Reads `@deftai/directive` version from the installed CLI package.json adjacent to dist/ or src/. */
+export declare function readCliPackageVersion(): string;
+//# sourceMappingURL=cli-package-version.d.ts.map

package/dist/cli-package-version.js

@@ -0,0 +1,23 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const FALLBACK_VERSION = "0.0.0";
+function parsePackageVersion(raw) {
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== "object") {
+        return FALLBACK_VERSION;
+    }
+    const version = parsed.version;
+    return typeof version === "string" && version.length > 0 ? version : FALLBACK_VERSION;
+}
+/** Reads `@deftai/directive` version from the installed CLI package.json adjacent to dist/ or src/. */
+export function readCliPackageVersion() {
+    try {
+        const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+        return parsePackageVersion(readFileSync(pkgPath, "utf8"));
+    }
+    catch {
+        return FALLBACK_VERSION;
+    }
+}
+//# sourceMappingURL=cli-package-version.js.map

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/dispatch.d.ts

@@ -12,7 +12,7 @@ export interface DispatchIo {
 /** 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", "release-wait-npm", "scope-lifecycle", "scope-record-approved-scope", "scope-record-observable-scope", "scope-record-intent-constraint", "scm-sync-default", "lifecycle-event", "lifecycle-stats", "session-start", "session-ready", "occupancy-steal", "occupancy-release", "occupancy-heartbeat", "occupancy-grant", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-strip-withdrawn", "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-deposit-closure", "verify-consumer-hard-stops", "verify-closing-keywords", "verify-skill-external-fetch-gate", "verify-semantic-single-source", "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", "verify-spec-prd-fresh", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-l4-owner", "verify-subagent-alive", "verify-subagent-steer", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-pr-closeout-attestable", "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", "verify-evaluator-surface", "verify-observable-scope", "verify-intent-constraint", "verify-consumer-test-lane", "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", "docs-impact"];
+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", "project-write-narratives", "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", "docs-impact"];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
 export declare const TRIAGE_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
 /** Colon aliases for policy subcommands (mirrors cli-router SUBCOMMAND_ROUTES). */

package/dist/dispatch.js

@@ -14,6 +14,7 @@ import { appendAuditLog, disclosureLine, migrateLegacyPolicyKey, PLAN_POLICY_KEY
 import { defaultWhich } from "@deftai/directive-core/scm";
 import { KNOWN_SUBAGENT_BACKEND_IDS, probeSubagentBackends, resolveSwarmSubagentBackend, } from "@deftai/directive-core/swarm";
 import { withProjectDefinitionMutation, } from "@deftai/directive-core/vbrief-build";
+import { identityBanner } from "./identity-banner.js";
 const HANDLER_KEYS = [
     "run",
     "main",
@@ -198,6 +199,7 @@ export const CORE_MODULE_VERBS = [
     "prd-render",
     "export-spec",
     "project-render",
+    "project-write-narratives",
     "roadmap-render",
     "rule-map",
     "spec-render",
@@ -413,6 +415,7 @@ export const VERB_ALIASES = {
     "spec:render": "spec-render",
     "prd:render": "prd-render",
     "project:render": "project-render",
+    "project:write-narratives": "project-write-narratives",
     "docs:rule-map": "rule-map",
     "project:export-spec": "export-spec",
     "pr:watch": "pr-watch",
@@ -2497,6 +2500,10 @@ async function loadCoreModuleHandler(verb, io) {
             const { runProjectRenderCli } = await import("./render-cli/project-render-cli.js");
             return (argv) => runProjectRenderCli(argv);
         }
+        case "project-write-narratives": {
+            const { writePhase2NarrativesMain } = await import("@deftai/directive-core/dist/render/phase2-narratives-cli.js");
+            return (argv) => writePhase2NarrativesMain(argv);
+        }
         case "rule-map": {
             const { runRuleMapCli } = await import("./render-cli/rule-map-cli.js");
             return (argv) => runRuleMapCli(argv);
@@ -2770,6 +2777,10 @@ const CURATED_HELP_GROUPS = [
         title: "Project artifacts",
         commands: [
             { name: "project:render", summary: "Render PROJECT-DEFINITION projection" },
+            {
+                name: "project:write-narratives",
+                summary: "Store Phase 2 narratives in PROJECT-DEFINITION without policy keys",
+            },
             { name: "spec:render", summary: "Render specification projection" },
         ],
     },
@@ -2824,7 +2835,6 @@ async function invokeHandler(handler, argv) {
     const code = await handler(argv);
     return typeof code === "number" ? code : 0;
 }
-const CLI_PACKAGE = "@deftai/directive";
 const PLAN_SEQUENCE_VERBS = "set|current|clear|advance";
 /**
  * Unknown-colon-verb remediation (#3439 / #2652).
@@ -2843,8 +2853,7 @@ export function unknownColonVerbHint(verb) {
         `Hyphen stem: ${hyphen}.\n`);
 }
 function versionBanner() {
-    const info = engineInfo();
-    return `${CLI_PACKAGE} (engine: ${info.name}@${info.version})\n`;
+    return `${identityBanner()}\n`;
 }
 /** Dispatch argv to a registered verb; returns the handler exit code. */
 export async function dispatch(argv, io = defaultIo()) {

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/identity-banner.d.ts

@@ -0,0 +1,13 @@
+export declare const CLI_PACKAGE: "@deftai/directive";
+export interface IdentityBannerParts {
+    readonly cliVersion: string;
+    readonly engineName: string;
+    readonly engineVersion: string;
+}
+/**
+ * Display-both identity line. Engine semver is first so parseVersionFromOutput
+ * in active-cli.ts and classify.ts still treat --version as the engine.
+ */
+export declare function formatIdentityBanner(parts: IdentityBannerParts): string;
+export declare function identityBanner(): string;
+//# sourceMappingURL=identity-banner.d.ts.map

package/dist/identity-banner.js

@@ -0,0 +1,19 @@
+import { engineInfo } from "@deftai/directive-core";
+import { readCliPackageVersion } from "./cli-package-version.js";
+export const CLI_PACKAGE = "@deftai/directive";
+/**
+ * Display-both identity line. Engine semver is first so parseVersionFromOutput
+ * in active-cli.ts and classify.ts still treat --version as the engine.
+ */
+export function formatIdentityBanner(parts) {
+    return `${CLI_PACKAGE} (engine: ${parts.engineName}@${parts.engineVersion}; package: ${CLI_PACKAGE}@${parts.cliVersion})`;
+}
+export function identityBanner() {
+    const info = engineInfo();
+    return formatIdentityBanner({
+        cliVersion: readCliPackageVersion(),
+        engineName: info.name,
+        engineVersion: info.version,
+    });
+}
+//# sourceMappingURL=identity-banner.js.map

package/dist/index.d.ts

@@ -5,7 +5,7 @@
  * (cli → core → types), proving the project-reference graph builds and
  * resolves end-to-end. Real commands land in later migration waves.
  */
-export declare const CLI_PACKAGE: "@deftai/directive";
-/** Renders the engine banner string, sourcing core engine metadata. */
+export { CLI_PACKAGE } from "./identity-banner.js";
+/** Renders CLI package and engine identity. First semver is the engine (#4766). */
 export declare function banner(): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,4 +1,4 @@
-import { engineInfo } from "@deftai/directive-core";
+import { identityBanner } from "./identity-banner.js";
 /**
  * `@deftai/directive` — entrypoint for the deft directive TypeScript engine.
  *
@@ -6,10 +6,9 @@ import { engineInfo } from "@deftai/directive-core";
  * (cli → core → types), proving the project-reference graph builds and
  * resolves end-to-end. Real commands land in later migration waves.
  */
-export const CLI_PACKAGE = "@deftai/directive";
-/** Renders the engine banner string, sourcing core engine metadata. */
+export { CLI_PACKAGE } from "./identity-banner.js";
+/** Renders CLI package and engine identity. First semver is the engine (#4766). */
 export function banner() {
-    const info = engineInfo();
-    return `${CLI_PACKAGE} (engine: ${info.name}@${info.version})`;
+    return identityBanner();
 }
 //# sourceMappingURL=index.js.map

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, collectTerminalLifecycleOrigins, createPlanSequence, detectTerminalEntryDrift, 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,6 +113,16 @@ 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");

package/dist/verify-plan-sequence.js

@@ -4,7 +4,7 @@
  */
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { collectTerminalLifecycleOrigins, 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,7 +119,7 @@ export function main(argv = process.argv.slice(2)) {
     const result = verifyPlanTarget(seq, {
         targetKind: parsed.targetKind,
         target: parsed.target,
-        terminalOrigins: collectTerminalLifecycleOrigins(resolve(parsed.projectRoot)),
+        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.6",
+  "version": "0.119.8",
   "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.6",
-    "@deftai/directive-content": "^0.119.6"
+    "@deftai/directive-core": "^0.119.8",
+    "@deftai/directive-content": "^0.119.8"
   },
   "scripts": {
     "build": "tsc -b"