@deftai/directive 0.74.0 → 0.76.0

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", "umbrella-current-shape", "changelog-check", "change-init", "commit-lint", "policy", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "session-start", "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", "verify-branch", "verify-encoding", "verify-forward-coverage", "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-content-manifest", "verify-contract-drift", "verify-cursor-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-stubs", "verify-xbrief-drift", "rule-ownership-lint", "verify-story-ready", "verify-tools", "verify-wip-cap", "verify-agents-md-budget", "verify-agents-md-advisory", "eval-health", "eval-run", "eval-report"];
+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", "umbrella-current-shape", "changelog-check", "change-init", "commit-lint", "policy", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "session-start", "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", "verify-branch", "verify-encoding", "verify-forward-coverage", "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-content-manifest", "verify-contract-drift", "verify-cursor-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-stubs", "verify-xbrief-drift", "rule-ownership-lint", "verify-story-ready", "verify-tools", "verify-wip-cap", "verify-agents-md-budget", "verify-agents-md-advisory", "verify-eval-health-relocation", "eval-health", "eval-run", "eval-report"];
 /** Core-only CLI entrypoints without a packages/cli wrapper. */
 export declare const CORE_MODULE_VERBS: readonly ["scm", "github-auth-modes", "github-body", "issue-emit", "issue-ingest", "reconcile-issues", "swarm-launch", "swarm-complete-cohort", "swarm-finalize-cohort", "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", "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"];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */

package/dist/dispatch.js

@@ -111,6 +111,7 @@ export const CLI_MODULE_VERBS = [
     "verify-wip-cap",
     "verify-agents-md-budget",
     "verify-agents-md-advisory",
+    "verify-eval-health-relocation",
     "eval-health",
     "eval-run",
     "eval-report",
@@ -185,10 +186,12 @@ export const VERB_ALIASES = {
     "verify:wip-cap": "verify-wip-cap",
     "verify:agents-md-budget": "verify-agents-md-budget",
     "verify:agents-md-advisory": "verify-agents-md-advisory",
+    "verify:eval-health-relocation": "verify-eval-health-relocation",
     "verify:hooks-installed": "verify-hooks-installed",
     "verify:no-task-runtime": "verify-no-task-runtime",
     "vbrief:validate": "vbrief-validate",
     "vbrief:preflight": "vbrief-preflight",
+    "xbrief:preflight": "vbrief-preflight",
     "vbrief:activate": "vbrief-activate",
     "verify:story-ready": "verify-story-ready",
     "verify:tools": "verify-tools",

package/dist/session-start.d.ts

@@ -4,6 +4,7 @@ export interface ParsedSessionStartArgs {
     deferValues: string[];
     emitJson: boolean;
     noHistory: boolean;
+    readOnly: boolean;
     error?: string;
 }
 /** Parse session:start CLI args, mirroring scripts/session_start.py. */

package/dist/session-start.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { parseDeferrals, ritualStatePath, runSessionStart } from "@deftai/directive-core/session";
+import { parseDeferrals, READ_ONLY_POSTURE, ritualStatePath, runSessionStart, } from "@deftai/directive-core/session";
 /** Parse session:start CLI args, mirroring scripts/session_start.py. */
 export function parseArgs(argv) {
     const parsed = {
@@ -9,6 +9,7 @@ export function parseArgs(argv) {
         deferValues: [],
         emitJson: false,
         noHistory: false,
+        readOnly: false,
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -18,6 +19,9 @@ export function parseArgs(argv) {
         else if (arg === "--no-history") {
             parsed.noHistory = true;
         }
+        else if (arg === "--read-only") {
+            parsed.readOnly = true;
+        }
         else if (arg === "--project-root") {
             const value = argv[i + 1];
             if (value === undefined) {
@@ -76,6 +80,7 @@ export function run(argv) {
         result = runSessionStart(projectRoot, {
             deferrals,
             writeHistory: !args.noHistory,
+            posture: args.readOnly ? READ_ONLY_POSTURE : undefined,
         });
     }
     finally {
@@ -101,7 +106,13 @@ export function run(argv) {
         sink.write(`${line}\n`);
     }
     if (result.code === 0) {
-        process.stdout.write(`[deft] session ritual recorded at ${ritualStatePath(projectRoot)}\n`);
+        const posture = result.payload.posture;
+        if (posture === READ_ONLY_POSTURE) {
+            process.stdout.write(`[deft] ${String(result.payload.message)}\n`);
+        }
+        else {
+            process.stdout.write(`[deft] session ritual recorded at ${ritualStatePath(projectRoot)} (diagnostic-only; not posture authority)\n`);
+        }
     }
     return result.code;
 }

package/dist/vbrief-preflight.d.ts

@@ -4,7 +4,7 @@ interface ParsedArgs {
     emitJson: boolean;
     error?: string;
 }
-/** Parse vbrief-preflight CLI args, mirroring the Python argparse surface (#810). */
+/** Parse vbrief-preflight / xbrief:preflight CLI args (#810 / #2449). */
 export declare function parseArgs(argv: string[]): ParsedArgs;
 /** Run the gate and return the process exit code (parse errors -> 2). */
 export declare function run(argv: string[]): number;

package/dist/vbrief-preflight.js

@@ -1,7 +1,17 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { emitJson, evaluate } from "@deftai/directive-core/preflight";
-/** Parse vbrief-preflight CLI args, mirroring the Python argparse surface (#810). */
+import { emitJson, evaluate, PREFLIGHT_USAGE_HINT } from "@deftai/directive-core/preflight";
+const PATH_FLAG_NAMES = ["--vbrief-path", "--brief-path", "--xbrief-path"];
+function assignPathFlag(parsed, value) {
+    if (value === undefined || value.length === 0) {
+        return { ...parsed, error: "argument --vbrief-path: expected one argument" };
+    }
+    if (parsed.vbriefPath !== null) {
+        return { ...parsed, error: "multiple path arguments are not allowed" };
+    }
+    return { ...parsed, vbriefPath: value };
+}
+/** Parse vbrief-preflight / xbrief:preflight CLI args (#810 / #2449). */
 export function parseArgs(argv) {
     const parsed = {
         vbriefPath: null,
@@ -11,24 +21,45 @@ export function parseArgs(argv) {
         const arg = argv[i];
         if (arg === "--json") {
             parsed.emitJson = true;
+            continue;
         }
-        else if (arg === "--vbrief-path") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --vbrief-path: expected one argument" };
-            }
-            parsed.vbriefPath = value;
+        if (arg === "--help" || arg === "-h") {
+            return parsed;
+        }
+        if (PATH_FLAG_NAMES.includes(arg)) {
+            const next = assignPathFlag(parsed, argv[i + 1]);
+            if (next?.error !== undefined)
+                return next;
+            parsed.vbriefPath = next?.vbriefPath ?? null;
             i += 1;
+            continue;
         }
-        else if (arg?.startsWith("--vbrief-path=")) {
-            parsed.vbriefPath = arg.slice("--vbrief-path=".length);
+        let matchedEqualsForm = false;
+        for (const flag of PATH_FLAG_NAMES) {
+            if (arg?.startsWith(`${flag}=`)) {
+                const next = assignPathFlag(parsed, arg.slice(flag.length + 1));
+                if (next?.error !== undefined)
+                    return next;
+                parsed.vbriefPath = next?.vbriefPath ?? null;
+                matchedEqualsForm = true;
+                break;
+            }
         }
-        else {
+        if (matchedEqualsForm)
+            continue;
+        if (arg?.startsWith("-")) {
             return { ...parsed, error: `unrecognized argument: ${arg}` };
         }
+        const next = assignPathFlag(parsed, arg);
+        if (next?.error !== undefined)
+            return next;
+        parsed.vbriefPath = next?.vbriefPath ?? null;
     }
     if (parsed.vbriefPath === null) {
-        return { ...parsed, error: "the following arguments are required: --vbrief-path" };
+        return {
+            ...parsed,
+            error: `the following arguments are required: --vbrief-path (or positional path). ${PREFLIGHT_USAGE_HINT}`,
+        };
     }
     return parsed;
 }

package/dist/verify-agents-md-budget.js

@@ -47,6 +47,22 @@ export function run(argv) {
             process.stderr.write(`${result.message}\n`);
         }
     }
+    if (result.northStarMessage !== undefined && result.northStarMessage.length > 0) {
+        if (result.northStarStream === "stdout") {
+            process.stdout.write(`${result.northStarMessage}\n`);
+        }
+        else if (result.northStarStream === "stderr") {
+            process.stderr.write(`${result.northStarMessage}\n`);
+        }
+    }
+    else if (result.advisoryMessage !== undefined && result.advisoryMessage.length > 0) {
+        if (result.advisoryStream === "stdout") {
+            process.stdout.write(`${result.advisoryMessage}\n`);
+        }
+        else if (result.advisoryStream === "stderr") {
+            process.stderr.write(`${result.advisoryMessage}\n`);
+        }
+    }
     return result.code;
 }
 if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {

package/dist/verify-eval-health-relocation.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    baseRef?: string;
+    staged: boolean;
+    quiet: boolean;
+    seedBaseline: boolean;
+    paths: string[];
+    error?: string;
+}
+/** Parse verify-eval-health-relocation 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-eval-health-relocation.d.ts.map

package/dist/verify-eval-health-relocation.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluate } from "@deftai/directive-core/eval-health-relocation";
+/** Parse verify-eval-health-relocation CLI args. */
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        staged: false,
+        quiet: false,
+        seedBaseline: false,
+        paths: [],
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--quiet") {
+            parsed.quiet = true;
+        }
+        else if (arg === "--staged") {
+            parsed.staged = true;
+        }
+        else if (arg === "--seed-baseline") {
+            parsed.seedBaseline = 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 if (arg === "--path") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --path: expected one argument" };
+            }
+            parsed.paths.push(value);
+            i += 1;
+        }
+        else if (arg?.startsWith("--path=")) {
+            parsed.paths.push(arg.slice("--path=".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_eval_health_relocation: ${args.error}\n`);
+        return 2;
+    }
+    const projectRoot = resolve(args.projectRoot);
+    const result = evaluate({
+        projectRoot,
+        baseRef: args.baseRef,
+        staged: args.staged,
+        quiet: args.quiet,
+        seedBaseline: args.seedBaseline,
+        paths: args.paths.length > 0 ? args.paths : undefined,
+    });
+    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-eval-health-relocation.js.map

package/dist/verify-session-ritual.d.ts

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
+import { type DirectivePosture } from "@deftai/directive-core/session";
 interface ParsedArgs {
     projectRoot: string;
     tier: "quick" | "gated";
+    posture: DirectivePosture | null;
     emitJson: boolean;
     error?: string;
 }

package/dist/verify-session-ritual.js

@@ -2,9 +2,21 @@
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { emitBypassWarning, emitVerifyJson, verifySessionRitual, } from "@deftai/directive-core/session";
+function parsePosture(value) {
+    if (value === "read-only")
+        return "read-only";
+    if (value === "mutation" || value === "mutating")
+        return "mutation";
+    return null;
+}
 /** Parse verify-session-ritual CLI args, mirroring scripts/verify_session_ritual.py. */
 export function parseArgs(argv) {
-    const parsed = { projectRoot: ".", tier: "quick", emitJson: false };
+    const parsed = {
+        projectRoot: ".",
+        tier: "quick",
+        posture: null,
+        emitJson: false,
+    };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
         if (arg === "--json") {
@@ -39,6 +51,32 @@ export function parseArgs(argv) {
             }
             parsed.tier = value;
         }
+        else if (arg === "--posture") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --posture: expected one argument" };
+            }
+            const posture = parsePosture(value);
+            if (posture === null) {
+                return {
+                    ...parsed,
+                    error: `argument --posture: invalid choice: '${value}' (expected read-only|mutation)`,
+                };
+            }
+            parsed.posture = posture;
+            i += 1;
+        }
+        else if (arg?.startsWith("--posture=")) {
+            const value = arg.slice("--posture=".length);
+            const posture = parsePosture(value);
+            if (posture === null) {
+                return {
+                    ...parsed,
+                    error: `argument --posture: invalid choice: '${value}' (expected read-only|mutation)`,
+                };
+            }
+            parsed.posture = posture;
+        }
         else {
             return { ...parsed, error: `unrecognized argument: ${arg}` };
         }
@@ -53,7 +91,10 @@ export function run(argv) {
         return 2;
     }
     const projectRoot = resolve(args.projectRoot);
-    const result = verifySessionRitual(projectRoot, { tier: args.tier });
+    const result = verifySessionRitual(projectRoot, {
+        tier: args.tier,
+        posture: args.posture ?? undefined,
+    });
     const warning = emitBypassWarning(result);
     const warningNeeded = result.bypassed && result.wouldFailCode !== null;
     if (args.emitJson) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.74.0",
+  "version": "0.76.0",
   "description": "Directive CLI — npm install path for the Deft Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,8 +31,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-core": "^0.74.0",
-    "@deftai/directive-content": "^0.74.0"
+    "@deftai/directive-core": "^0.76.0",
+    "@deftai/directive-content": "^0.76.0"
   },
   "scripts": {
     "build": "tsc -b"