@deftai/directive 0.64.0 → 0.66.0

package/dist/dispatch.d.ts

@@ -10,9 +10,11 @@ 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", "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", "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-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-bridge-drift", "verify-capacity", "verify-content-manifest", "verify-cursor-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-stubs", "rule-ownership-lint", "verify-story-ready", "verify-tools", "verify-wip-cap"];
+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", "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-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "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"];
 /** 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-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"];
+/** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
+export declare const TRIAGE_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
 /** Task-style aliases (framework_commands / Taskfile names). */
 export declare const VERB_ALIASES: Readonly<Record<string, string>>;
 /** Pinned ghx version — keep in lockstep with .github/workflows/ci.yml env.GHX_VERSION. */

package/dist/dispatch.js

@@ -8,7 +8,7 @@ import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { engineInfo } from "@deftai/directive-core";
 import { parseInitArgv, runInitDepositCli, userConfigDir, } from "@deftai/directive-core/init-deposit";
-import { appendAuditLog, disclosureLine, projectDefinitionPath, resolvePolicy, resolveWipCap, setPolicy, } from "@deftai/directive-core/policy";
+import { appendAuditLog, disclosureLine, migrateLegacyPolicyKey, PLAN_POLICY_KEY, projectDefinitionPath, resolvePolicy, resolveWipCap, setPolicy, } from "@deftai/directive-core/policy";
 import { defaultWhich } from "@deftai/directive-core/scm";
 import { KNOWN_SUBAGENT_BACKEND_IDS, probeSubagentBackends, resolveSwarmSubagentBackend, } from "@deftai/directive-core/swarm";
 const HANDLER_KEYS = [
@@ -37,6 +37,8 @@ export const CLI_MODULE_VERBS = [
     "install-upgrade",
     "install-uninstall",
     "migrate-preflight",
+    "migrate-xbrief",
+    "migrate-category-b",
     "framework-check-updates",
     "umbrella-current-shape",
     "changelog-check",
@@ -92,11 +94,13 @@ export const CLI_MODULE_VERBS = [
     "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",
@@ -140,6 +144,18 @@ export const CORE_MODULE_VERBS = [
     "changelog-resolve-unreleased",
     "architecture-preflight-sor",
 ];
+/** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
+export const TRIAGE_ACTION_ALIAS_SUBCOMMANDS = {
+    "triage:accept": "accept",
+    "triage:reject": "reject",
+    "triage:defer": "defer",
+    "triage:needs-ac": "needs-ac",
+    "triage:mark-duplicate": "mark-duplicate",
+    "triage:status": "status",
+    "triage:reset": "reset",
+    "triage:history": "history",
+};
+const TRIAGE_ACTION_COLON_ALIASES = Object.fromEntries(Object.keys(TRIAGE_ACTION_ALIAS_SUBCOMMANDS).map((alias) => [alias, "triage-actions"]));
 /** Task-style aliases (framework_commands / Taskfile names). */
 export const VERB_ALIASES = {
     "verify:encoding": "verify-encoding",
@@ -161,10 +177,12 @@ export const VERB_ALIASES = {
     "verify:rule-ownership": "rule-ownership-lint",
     "rule:ownership-lint": "rule-ownership-lint",
     "verify:content-manifest": "verify-content-manifest",
+    "verify:contract-drift": "verify-contract-drift",
     "verify:cursor-tier1": "verify-cursor-tier1",
     "verify:go-freeze": "verify-go-freeze",
     "verify:bridge-drift": "verify-bridge-drift",
     "verify:scm-boundary": "verify-scm-boundary",
+    "verify:xbrief-drift": "verify-xbrief-drift",
     "verify:capacity": "verify-capacity",
     "verify:session-ritual": "verify-session-ritual",
     "verify-strategy-output": "validate-strategy-output",
@@ -176,10 +194,11 @@ export const VERB_ALIASES = {
     "triage:summary": "triage-summary",
     "triage:queue": "triage-queue",
     "triage:scope": "triage-scope",
-    "triage:accept": "triage-actions",
-    "triage:status": "triage-actions",
+    ...TRIAGE_ACTION_COLON_ALIASES,
     "agents:refresh": "agents-refresh",
     "migrate:preflight": "migrate-preflight",
+    "migrate:xbrief": "migrate-xbrief",
+    "migrate:category-b": "migrate-category-b",
     "framework:check-updates": "framework-check-updates",
     "umbrella:current-shape": "umbrella-current-shape",
     upgrade: "install-upgrade",
@@ -200,8 +219,10 @@ const SUBDIR_CLI_STEMS = {
     "verify-stubs": "verify-source-cli/verify-stubs",
     "rule-ownership-lint": "verify-source-cli/rule-ownership-lint",
     "verify-content-manifest": "verify-source-cli/verify-content-manifest",
+    "verify-contract-drift": "verify-source-cli/verify-contract-drift",
     "verify-cursor-tier1": "verify-source-cli/verify-cursor-tier1",
     "verify-scm-boundary": "verify-source-cli/verify-scm-boundary",
+    "verify-xbrief-drift": "verify-source-cli/verify-xbrief-drift",
     "verify-go-freeze": "gates-cli/verify-go-freeze",
     "verify-bridge-drift": "gates-cli/verify-bridge-drift",
     "validate-links": "content-validate-cli/validate-links",
@@ -1695,10 +1716,11 @@ function loadProjectDefinitionForWrite(projectRoot) {
         throw new PolicySetError("PROJECT-DEFINITION 'plan' is not an object", "config");
     }
     const planObj = plan;
-    let policy = planObj.policy;
+    migrateLegacyPolicyKey(planObj);
+    let policy = planObj[PLAN_POLICY_KEY];
     if (policy === undefined) {
         policy = {};
-        planObj.policy = policy;
+        planObj[PLAN_POLICY_KEY] = policy;
     }
     if (typeof policy !== "object" || policy === null || Array.isArray(policy)) {
         throw new PolicySetError("plan.policy is not an object", "config");
@@ -2110,9 +2132,12 @@ export async function dispatch(argv, io = defaultIo()) {
     }
     try {
         const handler = await loadHandler(canonical, io);
+        const triageSubcommand = verb !== undefined ? TRIAGE_ACTION_ALIAS_SUBCOMMANDS[verb] : undefined;
         const handlerArgv = canonical === "framework-commands" && verb !== undefined && verb !== canonical
             ? [verb, ...rest]
-            : rest;
+            : triageSubcommand !== undefined && canonical === "triage-actions"
+                ? [triageSubcommand, ...rest]
+                : rest;
         return await invokeHandler(handler, handlerArgv);
     }
     catch (err) {

package/dist/doctor.js

@@ -3,6 +3,7 @@ import { fileURLToPath } from "node:url";
 import { parseDoctorFlags } from "@deftai/directive-core/dist/doctor/flags.js";
 import { cmdDoctor } from "@deftai/directive-core/dist/doctor/main.js";
 import { renderPrecutoverLine } from "@deftai/directive-core/dist/vbrief-validate/precutover.js";
+import { renderXbriefMigrationLine } from "@deftai/directive-core/xbrief-migrate";
 export 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
@@ -12,6 +13,7 @@ export function run(argv) {
     if (!flags.json && !flags.help && flags.unknown.length === 0) {
         const projectRoot = flags.projectRoot ?? process.cwd();
         process.stdout.write(`${renderPrecutoverLine(projectRoot)}\n`);
+        process.stdout.write(`${renderXbriefMigrationLine(projectRoot)}\n`);
     }
     return cmdDoctor(argv);
 }

package/dist/install-upgrade.d.ts

@@ -2,6 +2,8 @@
 export interface ParsedInstallUpgradeArgs {
     projectRoot: string;
     frameworkRoot: string;
+    migrate: boolean;
+    force: boolean;
     error?: string;
 }
 export declare function parseArgs(argv: readonly string[]): ParsedInstallUpgradeArgs;

package/dist/install-upgrade.js

@@ -5,14 +5,24 @@ import { runInstallUpgrade } from "@deftai/directive-core/install-upgrade";
 export function parseArgs(argv) {
     let projectRoot = ".";
     let frameworkRoot = resolve(import.meta.dirname, "..", "..", "..");
+    let migrate = false;
+    let force = false;
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i] ?? "";
-        if (arg === "--project-root") {
+        if (arg === "--migrate") {
+            migrate = true;
+        }
+        else if (arg === "--force") {
+            force = true;
+        }
+        else if (arg === "--project-root") {
             const value = argv[i + 1];
             if (value === undefined) {
                 return {
                     projectRoot,
                     frameworkRoot,
+                    migrate,
+                    force,
                     error: "argument --project-root: expected one argument",
                 };
             }
@@ -28,6 +38,8 @@ export function parseArgs(argv) {
                 return {
                     projectRoot,
                     frameworkRoot,
+                    migrate,
+                    force,
                     error: "argument --framework-root: expected one argument",
                 };
             }
@@ -38,13 +50,13 @@ export function parseArgs(argv) {
             frameworkRoot = arg.slice("--framework-root=".length);
         }
         else {
-            return { projectRoot, frameworkRoot, error: `unrecognized argument: ${arg}` };
+            return { projectRoot, frameworkRoot, migrate, force, error: `unrecognized argument: ${arg}` };
         }
     }
     if (process.env.DEFT_ROOT && process.env.DEFT_ROOT.length > 0) {
         frameworkRoot = process.env.DEFT_ROOT;
     }
-    return { projectRoot, frameworkRoot };
+    return { projectRoot, frameworkRoot, migrate, force };
 }
 export function run(argv) {
     const args = parseArgs(argv);
@@ -52,7 +64,12 @@ export function run(argv) {
         process.stderr.write(`install-upgrade: ${args.error}\n`);
         return 2;
     }
-    return runInstallUpgrade({ projectRoot: args.projectRoot, frameworkRoot: args.frameworkRoot }, {
+    return runInstallUpgrade({
+        projectRoot: args.projectRoot,
+        frameworkRoot: args.frameworkRoot,
+        migrate: args.migrate,
+        force: args.force,
+    }, {
         writeOut: (text) => {
             process.stdout.write(text);
         },

package/dist/migrate-category-b.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+export interface ParsedMigrateCategoryBArgs {
+    projectRoot: string;
+    error?: string;
+}
+export declare function parseArgs(argv: readonly string[]): ParsedMigrateCategoryBArgs;
+/** Migrate Category B bare plan keys to the x-directive/ namespace (#1650). */
+export declare function run(argv: readonly string[]): number;
+//# sourceMappingURL=migrate-category-b.d.ts.map

package/dist/migrate-category-b.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { migrateCategoryBCorpus } from "@deftai/directive-core/category-b-namespace";
+export function parseArgs(argv) {
+    let 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 { projectRoot, error: "argument --project-root: expected one argument" };
+            }
+            projectRoot = value;
+            i += 1;
+        }
+        else if (arg.startsWith("--project-root=")) {
+            projectRoot = arg.slice("--project-root=".length);
+        }
+        else {
+            return { projectRoot, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return { projectRoot };
+}
+/** Migrate Category B bare plan keys to the x-directive/ namespace (#1650). */
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`migrate:category-b: ${args.error}\n`);
+        return 2;
+    }
+    const result = migrateCategoryBCorpus(args.projectRoot);
+    if (result.conflicts.length > 0) {
+        for (const conflict of result.conflicts) {
+            process.stderr.write(`migrate:category-b: conflict in ${conflict.path}: ${conflict.message}\n`);
+        }
+        return 1;
+    }
+    if (result.changed.length === 0) {
+        process.stdout.write(`migrate:category-b: ${result.scanned} vBRIEF file(s) scanned -- already namespaced.\n`);
+        return 0;
+    }
+    process.stdout.write(`migrate:category-b: namespaced ${result.changed.length} of ${result.scanned} vBRIEF file(s):\n`);
+    for (const path of result.changed) {
+        process.stdout.write(`  ${path}\n`);
+    }
+    return 0;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=migrate-category-b.js.map

package/dist/migrate-xbrief.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+export interface ParsedMigrateXbriefArgs {
+    projectRoot: string;
+    frameworkRoot: string;
+    force: boolean;
+    error?: string;
+}
+export declare function parseArgs(argv: readonly string[]): ParsedMigrateXbriefArgs;
+export declare function run(argv: readonly string[]): number;
+//# sourceMappingURL=migrate-xbrief.d.ts.map

package/dist/migrate-xbrief.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { runXbriefMigrationCli } from "@deftai/directive-core/xbrief-migrate";
+export function parseArgs(argv) {
+    let projectRoot = ".";
+    let frameworkRoot = resolve(import.meta.dirname, "..", "..", "..");
+    let force = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i] ?? "";
+        if (arg === "--force") {
+            force = true;
+        }
+        else if (arg === "--project-root") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return {
+                    projectRoot,
+                    frameworkRoot,
+                    force,
+                    error: "argument --project-root: expected one argument",
+                };
+            }
+            projectRoot = value;
+            i += 1;
+        }
+        else if (arg.startsWith("--project-root=")) {
+            projectRoot = arg.slice("--project-root=".length);
+        }
+        else if (arg === "--framework-root") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return {
+                    projectRoot,
+                    frameworkRoot,
+                    force,
+                    error: "argument --framework-root: expected one argument",
+                };
+            }
+            frameworkRoot = value;
+            i += 1;
+        }
+        else if (arg.startsWith("--framework-root=")) {
+            frameworkRoot = arg.slice("--framework-root=".length);
+        }
+        else {
+            return { projectRoot, frameworkRoot, force, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    if (process.env.DEFT_ROOT && process.env.DEFT_ROOT.length > 0) {
+        frameworkRoot = process.env.DEFT_ROOT;
+    }
+    return { projectRoot, frameworkRoot, force };
+}
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`migrate:xbrief: ${args.error}\n`);
+        return 2;
+    }
+    return runXbriefMigrationCli({
+        projectRoot: args.projectRoot,
+        frameworkRoot: args.frameworkRoot,
+        force: args.force,
+    }, {
+        writeOut: (text) => {
+            process.stdout.write(text);
+        },
+        writeErr: (text) => {
+            process.stderr.write(text);
+        },
+    });
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=migrate-xbrief.js.map

package/dist/render-cli/prd-render-cli.js

@@ -1,7 +1,41 @@
-/** Thin CLI wrapper for prd-render (mirrors ``scripts/prd_render.py``). */
+/**
+ * Thin CLI wrapper for prd-render (mirrors ``scripts/prd_render.py``).
+ *
+ * Supports `--project-root <dir>` to resolve the spec artifact via the layout
+ * resolver (#2132), preferring `xbrief/specification.xbrief.json` on migrated
+ * trees and falling back to `vbrief/specification.vbrief.json` on legacy trees.
+ * When `--spec` is explicitly provided it takes precedence over `--project-root`.
+ * Direct `--spec` / `--output` / `--force` flags are still accepted unchanged.
+ */
+import { layout } from "@deftai/directive-core";
 import { parsePrdArgv, prdRenderMain } from "@deftai/directive-core/render";
+function parsePrdRenderCliArgv(argv) {
+    const remaining = [];
+    let projectRoot;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i] ?? "";
+        if (arg === "--project-root") {
+            projectRoot = argv[i + 1];
+            i += 1;
+        }
+        else if (arg.startsWith("--project-root=")) {
+            projectRoot = arg.slice("--project-root=".length);
+        }
+        else {
+            remaining.push(arg);
+        }
+    }
+    return { projectRoot, remaining };
+}
 export function runPrdRenderCli(argv) {
-    prdRenderMain(parsePrdArgv(argv));
+    const { projectRoot, remaining } = parsePrdRenderCliArgv(argv);
+    const parsedArgs = parsePrdArgv(remaining);
+    const spec = parsedArgs.spec !== undefined
+        ? parsedArgs.spec
+        : projectRoot !== undefined
+            ? layout.resolveSpecArtifactPath(projectRoot)
+            : undefined;
+    prdRenderMain({ ...parsedArgs, spec });
     return 0;
 }
 //# sourceMappingURL=prd-render-cli.js.map

package/dist/render-cli/spec-render-cli.js

@@ -1,6 +1,39 @@
-/** Thin CLI wrapper for spec-render (mirrors ``scripts/spec_render.py``). */
+/**
+ * Thin CLI wrapper for spec-render (mirrors ``scripts/spec_render.py``).
+ *
+ * Supports `--project-root <dir>` to resolve the spec artifact via the layout
+ * resolver (#2132), preferring `xbrief/specification.xbrief.json` on migrated
+ * trees and falling back to `vbrief/specification.vbrief.json` on legacy trees.
+ * Direct positional path args are still accepted for backward compatibility.
+ */
+import { join, resolve } from "node:path";
+import { layout } from "@deftai/directive-core";
 import { specRenderMain } from "@deftai/directive-core/render";
+function parseSpecRenderCliArgv(argv) {
+    const remaining = [];
+    let projectRoot;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i] ?? "";
+        if (arg === "--project-root") {
+            projectRoot = argv[i + 1];
+            i += 1;
+        }
+        else if (arg.startsWith("--project-root=")) {
+            projectRoot = arg.slice("--project-root=".length);
+        }
+        else {
+            remaining.push(arg);
+        }
+    }
+    return { projectRoot, remaining };
+}
 export function runSpecRenderCli(argv) {
-    return specRenderMain(argv);
+    const { projectRoot, remaining } = parseSpecRenderCliArgv(argv);
+    if (projectRoot !== undefined && remaining.filter((a) => !a.startsWith("--")).length === 0) {
+        const specPath = layout.resolveSpecArtifactPath(projectRoot);
+        const outPath = join(resolve(projectRoot), "SPECIFICATION.md");
+        return specRenderMain([specPath, outPath, ...remaining]);
+    }
+    return specRenderMain(remaining);
 }
 //# sourceMappingURL=spec-render-cli.js.map

package/dist/render-cli/spec-validate-cli.js

@@ -1,6 +1,38 @@
-/** Thin CLI wrapper for spec-validate (mirrors ``scripts/spec_validate.py``). */
+/**
+ * Thin CLI wrapper for spec-validate (mirrors ``scripts/spec_validate.py``).
+ *
+ * Supports `--project-root <dir>` to resolve the spec artifact via the layout
+ * resolver (#2132), preferring `xbrief/specification.xbrief.json` on migrated
+ * trees and falling back to `vbrief/specification.vbrief.json` on legacy trees.
+ * A direct path positional arg is still accepted for backward compatibility.
+ */
+import { layout } from "@deftai/directive-core";
 import { specValidateMain } from "@deftai/directive-core/render";
+function parseSpecValidateCliArgv(argv) {
+    const positional = [];
+    let projectRoot;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i] ?? "";
+        if (arg === "--project-root") {
+            projectRoot = argv[i + 1];
+            i += 1;
+        }
+        else if (arg.startsWith("--project-root=")) {
+            projectRoot = arg.slice("--project-root=".length);
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { specPath: positional[0], projectRoot };
+}
 export function runSpecValidateCli(argv) {
-    return specValidateMain(argv);
+    const { specPath, projectRoot } = parseSpecValidateCliArgv(argv);
+    const resolved = projectRoot !== undefined ? layout.resolveSpecArtifactPath(projectRoot) : specPath;
+    if (!resolved) {
+        process.stderr.write("Usage: spec-validate [--project-root <dir>] [<spec_file>]\n");
+        return 2;
+    }
+    return specValidateMain([resolved]);
 }
 //# sourceMappingURL=spec-validate-cli.js.map

package/dist/triage-queue.js

@@ -2,6 +2,7 @@
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { activeReferencedIssueNumbers, buildQueue, collectOrphanIssueNumbers, DEFAULT_QUEUE_LIMIT, loadCachedIssues, loadSliceRecords, readAuditEntries, renderQueue, resolveRankingLabels, resolveRepo, } from "@deftai/directive-core/dist/triage/queue/index.js";
+import { resolveScopeIgnores } from "@deftai/directive-core/dist/triage/scope-drift/index.js";
 /** Parse triage-queue CLI args for the queue subcommand. */
 export function parseArgs(argv) {
     const parsed = {
@@ -150,6 +151,7 @@ export function run(argv) {
     });
     const orphanNumbers = collectOrphanIssueNumbers(sliceRecords, issuesByNumber);
     const limit = args.limit === 0 ? null : Math.max(0, args.limit);
+    const scopeIgnores = resolveScopeIgnores(projectRoot);
     const items = buildQueue(issuesForQueue, auditEntries, {
         repo,
         queue: {
@@ -158,6 +160,7 @@ export function run(argv) {
             orphanIssueNumbers: orphanNumbers,
             includeBlocked: args.includeBlocked,
             limit,
+            scopeIgnores,
         },
     });
     process.stdout.write(`${renderQueue({

package/dist/triage-summary.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { appendHistory, computeSummary, formatSummary, pythonStyleStringify, SUMMARY_HISTORY_REL_PATH, summaryResultToRecord, utcIso, } from "@deftai/directive-core/dist/triage/summary/index.js";
+import { resolveEvalPath } from "@deftai/directive-core/dist/layout/resolve.js";
+import { appendHistory, computeSummary, formatSummary, pythonStyleStringify, summaryResultToRecord, utcIso, } from "@deftai/directive-core/dist/triage/summary/index.js";
 /** Parse triage-summary CLI args, mirroring the Python argparse surface. */
 export function parseArgs(argv) {
     const parsed = {
@@ -66,7 +67,7 @@ export function run(argv) {
         process.stdout.write(`${line}\n`);
     }
     if (!args.noHistory) {
-        const historyPath = resolve(projectRoot, SUMMARY_HISTORY_REL_PATH);
+        const historyPath = resolveEvalPath(projectRoot, "summary-history.jsonl");
         appendHistory(historyPath, result, line, { emittedAt });
     }
     return 0;

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

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string | null;
+    error?: string;
+}
+/** Parse verify-contract-drift CLI args (#1799). */
+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-contract-drift.d.ts.map

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

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluateContractDrift } from "@deftai/directive-core/verify-source";
+/** Parse verify-contract-drift CLI args (#1799). */
+export function parseArgs(argv) {
+    const parsed = { projectRoot: null };
+    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;
+}
+/** 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_contract_drift: ${args.error}\n`);
+        return 2;
+    }
+    const root = resolve(args.projectRoot ?? ".");
+    const result = evaluateContractDrift(root);
+    if (result.stream === "stdout") {
+        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-contract-drift.js.map

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

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { type DriftScanMode } from "@deftai/directive-core/xbrief-migrate";
+interface ParsedArgs {
+    mode: DriftScanMode;
+    projectRoot: string;
+    allowList: string | null;
+    quiet: boolean;
+    error?: string;
+}
+/** Parse verify-xbrief-drift CLI args (#2109), mirroring the verify-encoding surface. */
+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-xbrief-drift.d.ts.map

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

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluateXbriefDrift } from "@deftai/directive-core/xbrief-migrate";
+/** Parse verify-xbrief-drift CLI args (#2109), mirroring the verify-encoding surface. */
+export function parseArgs(argv) {
+    const parsed = { mode: "all", projectRoot: ".", allowList: null, quiet: false };
+    let sawAll = false;
+    let sawStaged = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--all") {
+            sawAll = true;
+            parsed.mode = "all";
+        }
+        else if (arg === "--staged") {
+            sawStaged = true;
+            parsed.mode = "staged";
+        }
+        else 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 === "--allow-list") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --allow-list: expected one argument" };
+            }
+            parsed.allowList = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--allow-list=")) {
+            parsed.allowList = arg.slice("--allow-list=".length);
+        }
+        else {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    if (sawAll && sawStaged) {
+        return { ...parsed, error: "argument --staged: not allowed with argument --all" };
+    }
+    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_xbrief_drift: ${args.error}\n`);
+        return 2;
+    }
+    const projectRoot = resolve(args.projectRoot);
+    const result = evaluateXbriefDrift(projectRoot, {
+        mode: args.mode,
+        allowListPath: args.allowList !== null ? resolve(args.allowList) : null,
+        quiet: args.quiet,
+    });
+    if (result.code === 0) {
+        if (!args.quiet && result.message.length > 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-xbrief-drift.js.map

package/package.json

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