@deftai/directive 0.72.0 → 0.73.1

package/dist/branch-fixtures.js

@@ -16,10 +16,10 @@ function gitCommit(cwd, message) {
     });
 }
 function writeProjectDef(root, plan) {
-    const dir = join(root, "vbrief");
+    const dir = join(root, "xbrief");
     mkdirSync(dir, { recursive: true });
-    writeFileSync(join(dir, "PROJECT-DEFINITION.vbrief.json"), `${JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+    writeFileSync(join(dir, "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify({
+        xBRIEFInfo: { version: "0.8" },
         plan: { title: "T", status: "running", items: [], ...plan },
     }, null, 2)}\n`, { encoding: "utf8" });
 }

package/dist/dispatch.d.ts

@@ -15,6 +15,8 @@ export declare const CLI_MODULE_VERBS: readonly ["agents-refresh", "cache", "che
 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). */
 export declare const TRIAGE_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
+/** Colon aliases for policy subcommands (mirrors cli-router SUBCOMMAND_ROUTES). */
+export declare const POLICY_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 (display only) — keep in lockstep with .github/workflows/ci.yml env.GHX_VERSION. */

package/dist/dispatch.js

@@ -9,7 +9,7 @@ import { homedir, tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { engineInfo, userConfig } from "@deftai/directive-core";
 import { parseInitArgv, runInitDepositCli } from "@deftai/directive-core/init-deposit";
-import { appendAuditLog, disclosureLine, migrateLegacyPolicyKey, PLAN_POLICY_KEY, projectDefinitionPath, resolvePolicy, resolveWipCap, setPolicy, } from "@deftai/directive-core/policy";
+import { appendAuditLog, disclosureLine, migrateLegacyPolicyKey, PLAN_POLICY_KEY, policyColonInvocation, policySetInvocation, 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 = [
@@ -168,6 +168,14 @@ export const TRIAGE_ACTION_ALIAS_SUBCOMMANDS = {
     "triage:history": "history",
 };
 const TRIAGE_ACTION_COLON_ALIASES = Object.fromEntries(Object.keys(TRIAGE_ACTION_ALIAS_SUBCOMMANDS).map((alias) => [alias, "triage-actions"]));
+/** Colon aliases for policy subcommands (mirrors cli-router SUBCOMMAND_ROUTES). */
+export const POLICY_ACTION_ALIAS_SUBCOMMANDS = {
+    "policy:show": "show",
+    "policy:enforce-branches": "enforce-branches",
+    "policy:allow-direct-commits": "allow-direct-commits",
+    "policy:enable-value-feedback": "enable-value-feedback",
+};
+const POLICY_ACTION_COLON_ALIASES = Object.fromEntries(Object.keys(POLICY_ACTION_ALIAS_SUBCOMMANDS).map((alias) => [alias, "policy"]));
 /** Task-style aliases (framework_commands / Taskfile names). */
 export const VERB_ALIASES = {
     "verify:encoding": "verify-encoding",
@@ -211,6 +219,7 @@ export const VERB_ALIASES = {
     "triage:queue": "triage-queue",
     "triage:scope": "triage-scope",
     ...TRIAGE_ACTION_COLON_ALIASES,
+    ...POLICY_ACTION_COLON_ALIASES,
     "agents:refresh": "agents-refresh",
     "migrate:preflight": "migrate-preflight",
     "migrate:xbrief": "migrate-xbrief",
@@ -1747,7 +1756,9 @@ const POLICY_CAPABILITY_COST_DISCLOSURE = "\u26a0 Capability-cost disclosure --
     "  \u2022 verify:branch will pass on the default branch.\n" +
     "  \u2022 The CI sanity check (head_ref != base_ref) is still independent and " +
     "will continue to flag master->master PRs.\n" +
-    "  \u2022 This change is reversible: run `task policy:enforce-branches` to " +
+    "  \u2022 This change is reversible: run `" +
+    policyColonInvocation("enforce-branches") +
+    "` to " +
     "re-enable the gate.\n" +
     "  \u2022 The change is recorded to meta/policy-changes.log for auditability.";
 const POLICY_WIP_CAP_DISCLOSURE = "\u26a0 Capability-cost disclosure -- changing plan.policy.wipCap " +
@@ -1802,15 +1813,15 @@ function sanitizeNote(note) {
 function defaultPolicySetActor(cmd) {
     switch (cmd) {
         case "enforce-branches":
-            return "task policy:enforce-branches";
+            return policyColonInvocation("enforce-branches");
         case "allow-direct-commits":
-            return "task policy:allow-direct-commits";
+            return policyColonInvocation("allow-direct-commits");
         case "wip-cap":
-            return "task policy:wip-cap";
+            return policySetInvocation("wip-cap");
         case "subagent-backend":
-            return "task policy:subagent-backend";
+            return policySetInvocation("subagent-backend");
         case "subagent-backends":
-            return "task policy:subagent-backends";
+            return policySetInvocation("subagent-backends");
     }
 }
 /** Mirror Python `Path(...).expanduser()` for a leading `~` / `~/` segment. */
@@ -2027,7 +2038,7 @@ function applyBranchPolicy(args, io) {
         if (!args.confirm) {
             io.writeOut(`${POLICY_CAPABILITY_COST_DISCLOSURE}\n`);
             io.writeOut("\n");
-            io.writeOut("Re-run with --confirm to apply: task policy:allow-direct-commits -- --confirm\n");
+            io.writeOut(`Re-run with --confirm to apply: ${policyColonInvocation("allow-direct-commits", " -- --confirm")}\n`);
             return 1;
         }
         target = true;
@@ -2071,7 +2082,7 @@ function applyWipCap(args, io) {
     if (!args.confirm) {
         io.writeOut(`${POLICY_WIP_CAP_DISCLOSURE}\n`);
         io.writeOut("\n");
-        io.writeOut(`Re-run with --confirm to apply: task policy:wip-cap -- --set ${cap} --confirm\n`);
+        io.writeOut(`Re-run with --confirm to apply: ${policySetInvocation("wip-cap", ` -- --set ${cap} --confirm`)}\n`);
         return 1;
     }
     let res;
@@ -2401,11 +2412,14 @@ 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 policySubcommand = verb !== undefined ? POLICY_ACTION_ALIAS_SUBCOMMANDS[verb] : undefined;
         const handlerArgv = canonical === "framework-commands" && verb !== undefined && verb !== canonical
             ? [verb, ...rest]
             : triageSubcommand !== undefined && canonical === "triage-actions"
                 ? [triageSubcommand, ...rest]
-                : rest;
+                : policySubcommand !== undefined && canonical === "policy"
+                    ? [policySubcommand, ...rest]
+                    : rest;
         return await invokeHandler(handler, handlerArgv);
     }
     catch (err) {

package/dist/doctor.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/** Advisory when a consumer deposit carries git-vendored framework source (#2142). */
+/** Advisory when a consumer deposit carries git-vendored framework source (#2142 / #2347). */
 export declare function renderStrayPackagesAdvisoryLine(projectRoot: string): string;
 export declare function run(argv: string[]): number;
 //# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.js

@@ -6,15 +6,16 @@ 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 { renderStaleHeaderLine, renderXbriefMigrationLine, } from "@deftai/directive-core/xbrief-migrate";
-/** Advisory when a consumer deposit carries git-vendored framework source (#2142). */
+/** Advisory when a consumer deposit carries git-vendored framework source (#2142 / #2347). */
 export function renderStrayPackagesAdvisoryLine(projectRoot) {
     const packagesDir = join(projectRoot, ".deft", "core", "packages");
     if (!existsSync(packagesDir)) {
         return "Deposit hygiene: none -- .deft/core contains no stray packages/ source tree.";
     }
     return ("Deposit hygiene: advisory -- .deft/core/packages/ is present (git-vendored framework source, " +
-        "not shipped by npm @deftai/directive-content). Upgrade directive to pick up task guard fixes; " +
-        "consider removing the stray tree from version control.");
+        "not shipped by npm @deftai/directive-content). " +
+        "Run `directive update` to auto-prune this stray tree, then commit the result (#2347). " +
+        "Or remove it manually: `git rm -r --cached .deft/core/packages && git commit -m 'chore: remove stray framework source'`.");
 }
 export function run(argv) {
     // #2022: surface pre-cutover (pre-v0.20 document model) migration state alongside the

package/dist/gates-cli/_helpers.js

@@ -56,9 +56,9 @@ export function initGitRepo(root) {
     return execFileSync("git", ["rev-parse", "HEAD"], { cwd: root, encoding: "utf8" }).trim();
 }
 export function writeProjectDef(root, policy = {}) {
-    mkdirSync(join(root, "vbrief"), { recursive: true });
-    writeFileSync(join(root, "vbrief", "PROJECT-DEFINITION.vbrief.json"), JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+    mkdirSync(join(root, "xbrief"), { recursive: true });
+    writeFileSync(join(root, "xbrief", "PROJECT-DEFINITION.xbrief.json"), JSON.stringify({
+        xBRIEFInfo: { version: "0.8" },
         plan: { title: "T", status: "running", items: [], policy },
     }), "utf8");
 }

package/dist/policy-fixtures.js

@@ -10,17 +10,17 @@ export function normalizeOutput(text) {
         .replace(/fail-closed: PROJECT-DEFINITION not found at [^)]+/g, "fail-closed: PROJECT-DEFINITION not found at <ROOT>");
 }
 function writeFixture(root, plan) {
-    const dir = join(root, "vbrief");
+    const dir = join(root, "xbrief");
     mkdirSync(dir, { recursive: true });
-    writeFileSync(join(dir, "PROJECT-DEFINITION.vbrief.json"), `${JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+    writeFileSync(join(dir, "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify({
+        xBRIEFInfo: { version: "0.8" },
         plan: { title: "T", status: "running", items: [], ...plan },
     }, null, 2)}\n`, { encoding: "utf8" });
 }
 /** Build a throwaway project root with optional PROJECT-DEFINITION plan payload. */
 export function buildFixtureRepo(plan) {
     const root = mkdtempSync(join(tmpdir(), "deft-policy-parity-"));
-    mkdirSync(join(root, "vbrief"), { recursive: true });
+    mkdirSync(join(root, "xbrief"), { recursive: true });
     if (plan !== undefined) {
         writeFixture(root, plan);
     }

package/dist/policy.js

@@ -6,7 +6,7 @@
 import { existsSync } from "node:fs";
 import { resolve as pathResolve, relative } from "node:path";
 import { fileURLToPath } from "node:url";
-import { describeShadowedPlanExtension, detectShadowedPlanExtensions, disclosureLine, enableValueFeedback, FIELD_VALUE_FEEDBACK, FIELD_VALUE_FEEDBACK_CLI_ALIAS, formatValueFeedbackStatusLine, inspectAllPolicies, inspectOnePolicy, loadProjectDefinition, projectDefinitionPath, pythonListRepr, pythonStringRepr, registeredPolicyNames, renderJson, renderText, resolvePolicy, resolveValueFeedback, setPolicy, } from "@deftai/directive-core/policy";
+import { describeShadowedPlanExtension, detectShadowedPlanExtensions, disclosureLine, enableValueFeedback, FIELD_VALUE_FEEDBACK, FIELD_VALUE_FEEDBACK_CLI_ALIAS, formatValueFeedbackStatusLine, inspectAllPolicies, inspectOnePolicy, loadProjectDefinition, policyColonInvocation, projectDefinitionPath, pythonListRepr, pythonStringRepr, registeredPolicyNames, renderJson, renderText, resolvePolicy, resolveValueFeedback, setPolicy, } from "@deftai/directive-core/policy";
 const CAPABILITY_COST_DISCLOSURE = "\u26a0 Capability-cost disclosure -- enabling direct commits to the default " +
     "branch turns OFF the deft branch-protection policy.\n" +
     "  \u2022 Pre-commit + pre-push hooks will no longer block default-branch " +
@@ -14,7 +14,9 @@ const CAPABILITY_COST_DISCLOSURE = "\u26a0 Capability-cost disclosure -- enablin
     "  \u2022 verify:branch will pass on the default branch.\n" +
     "  \u2022 The CI sanity check (head_ref != base_ref) is still independent and " +
     "will continue to flag master->master PRs.\n" +
-    "  \u2022 This change is reversible: run `task policy:enforce-branches` to " +
+    "  \u2022 This change is reversible: run `" +
+    policyColonInvocation("enforce-branches") +
+    "` to " +
     "re-enable the gate.\n" +
     "  \u2022 The change is recorded to meta/policy-changes.log for auditability.";
 function makeSetError(message) {
@@ -121,7 +123,7 @@ export function parseArgs(argv) {
         return {
             cmd: "show",
             confirm: false,
-            actor: "task policy:show",
+            actor: policyColonInvocation("show"),
             note: "",
             projectRoot: show.projectRoot,
             format: show.format,
@@ -149,10 +151,10 @@ export function parseArgs(argv) {
         cmd === "enable-value-feedback") {
         let confirm = false;
         let actor = cmd === "enforce-branches"
-            ? "task policy:enforce-branches"
+            ? policyColonInvocation("enforce-branches")
             : cmd === "allow-direct-commits"
-                ? "task policy:allow-direct-commits"
-                : "task policy:enable-value-feedback";
+                ? policyColonInvocation("allow-direct-commits")
+                : policyColonInvocation("enable-value-feedback");
         let note = "";
         let projectRoot = ".";
         for (let i = 1; i < argv.length; i += 1) {
@@ -291,7 +293,7 @@ function runSet(args) {
     const projectRoot = pathResolve(args.projectRoot);
     if (args.cmd === "allow-direct-commits" && !args.confirm) {
         process.stdout.write(`${CAPABILITY_COST_DISCLOSURE}\n\n`);
-        process.stdout.write("Re-run with --confirm to apply: task policy:allow-direct-commits -- --confirm\n");
+        process.stdout.write(`Re-run with --confirm to apply: ${policyColonInvocation("allow-direct-commits", " -- --confirm")}\n`);
         return 1;
     }
     const target = args.cmd === "allow-direct-commits";

package/dist/story-ready-fixtures.js

@@ -4,11 +4,11 @@ import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 function writeVbrief(root, rel, status = "running", folder = "active") {
-    const full = join(root, "vbrief", folder, rel);
+    const full = join(root, "xbrief", folder, rel);
     mkdirSync(dirname(full), { recursive: true });
     const payload = {
         plan: { status, title: "T", items: [] },
-        vBRIEFInfo: { version: "0.6" },
+        xBRIEFInfo: { version: "0.8" },
     };
     writeFileSync(full, `${JSON.stringify(payload)}\n`, "utf8");
 }
@@ -23,7 +23,7 @@ function renderAllocation(fields) {
 const VALID_COHORT = {
     allocation_plan_id: "orchestrator-run-019e80bd",
     batching_rationale: "Three disjoint-file-scope stories from #1378.",
-    cohort_vbriefs: "[vbrief/active/a.json, vbrief/active/b.json]",
+    cohort_vbriefs: "[xbrief/active/a.json, xbrief/active/b.json]",
     dispatch_kind: "swarm-cohort",
     operator_approval_evidence: "user directive 2026-06-01T02:26Z",
 };
@@ -31,29 +31,29 @@ const VALID_COHORT = {
 export const PARITY_SCENARIOS = [
     {
         name: "clean-active-running-solo",
-        vbriefRel: "2026-06-01-story.vbrief.json",
+        vbriefRel: "2026-06-01-story.xbrief.json",
         envelopeRel: null,
     },
     {
         name: "dirty-tree",
-        vbriefRel: "2026-06-01-story.vbrief.json",
+        vbriefRel: "2026-06-01-story.xbrief.json",
         envelopeRel: null,
         dirty: true,
     },
     {
         name: "non-running-vbrief",
-        vbriefRel: "2026-06-01-pending.vbrief.json",
+        vbriefRel: "2026-06-01-pending.xbrief.json",
         vbriefStatus: "approved",
         envelopeRel: null,
     },
     {
         name: "satisfied-swarm-cohort",
-        vbriefRel: "2026-06-01-story.vbrief.json",
+        vbriefRel: "2026-06-01-story.xbrief.json",
         envelopeRel: "envelope-cohort.md",
     },
     {
         name: "malformed-allocation",
-        vbriefRel: "2026-06-01-story.vbrief.json",
+        vbriefRel: "2026-06-01-story.xbrief.json",
         envelopeRel: "envelope-bad.md",
     },
 ];
@@ -99,7 +99,7 @@ export function buildScenarioRepo(scenario) {
     if (!scenario.dirty) {
         gitCommit(root, "init");
     }
-    const vbriefPath = join(root, "vbrief", "active", vbriefName);
+    const vbriefPath = join(root, "xbrief", "active", vbriefName);
     return { root, vbriefPath, envelopePath };
 }
 /** Diff python vs TS gate outputs across all parity scenarios. */

package/dist/triage-aux-a-fixtures.js

@@ -37,8 +37,8 @@ export function diffCase(python, ts, caseName) {
     };
 }
 function writeProjectDefinition(root, policy = {}) {
-    mkdirSync(join(root, "vbrief"), { recursive: true });
-    writeFileSync(join(root, "vbrief", "PROJECT-DEFINITION.vbrief.json"), `${JSON.stringify({ vBRIEFInfo: { version: "0.6" }, plan: { policy } }, null, 2)}\n`, "utf8");
+    mkdirSync(join(root, "xbrief"), { recursive: true });
+    writeFileSync(join(root, "xbrief", "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify({ xBRIEFInfo: { version: "0.8" }, plan: { policy } }, null, 2)}\n`, "utf8");
 }
 export const PARITY_CASES = [
     {
@@ -82,7 +82,7 @@ export const PARITY_CASES = [
 ];
 export function buildFixtureRepo(setup) {
     const root = mkdtempSync(join(tmpdir(), "deft-triage-aux-a-parity-"));
-    mkdirSync(join(root, "vbrief"), { recursive: true });
+    mkdirSync(join(root, "xbrief"), { recursive: true });
     setup?.(root);
     return root;
 }

package/dist/triage-aux-b-fixtures.js

@@ -12,9 +12,9 @@ export function normalizeOutput(text) {
         .replace(/Installed \d+ packages[^\n]*\n/g, "");
 }
 function writeProjectDefinition(root, policy = {}) {
-    mkdirSync(join(root, "vbrief"), { recursive: true });
-    writeFileSync(join(root, "vbrief", "PROJECT-DEFINITION.vbrief.json"), `${JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+    mkdirSync(join(root, "xbrief"), { recursive: true });
+    writeFileSync(join(root, "xbrief", "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify({
+        xBRIEFInfo: { version: "0.8" },
         plan: { title: "T", status: "running", items: [], policy },
     }, null, 2)}\n`, { encoding: "utf8" });
 }

package/dist/triage-bootstrap-fixtures.d.ts

@@ -32,7 +32,7 @@ export interface ParityResult {
 export declare function normalizeOutput(text: string): string;
 /** Compare stdout, parsing JSON payloads when present. */
 export declare function normalizeStdout(text: string): string;
-/** Build a throwaway project root with optional vBRIEF fixtures. */
+/** Build a throwaway project root with optional xBRIEF fixtures. */
 export declare function buildFixtureRepo(options?: FixtureOptions): string;
 /** Diff one parity case between Python oracle and TS CLI. */
 export declare function diffCase(python: CommandCapture, ts: CommandCapture, caseName: string): ParityDiff;

package/dist/triage-bootstrap-fixtures.js

@@ -33,7 +33,7 @@ export function normalizeStdout(text) {
                     if (typeof details === "object" && details !== null) {
                         const detailRecord = details;
                         if (typeof detailRecord.audit_path === "string") {
-                            detailRecord.audit_path = "<ROOT>/vbrief/.eval/candidates.jsonl";
+                            detailRecord.audit_path = "<ROOT>/xbrief/.triage-cache/candidates.jsonl";
                         }
                         if (typeof detailRecord.fetch_timeout_s === "number") {
                             detailRecord.fetch_timeout_s = Math.trunc(detailRecord.fetch_timeout_s);
@@ -53,10 +53,10 @@ export function normalizeStdout(text) {
     return normalizeOutput(text);
 }
 function writeScopeVbrief(root, folder, slug, issueNumber) {
-    const dir = join(root, "vbrief", folder);
+    const dir = join(root, "xbrief", folder);
     mkdirSync(dir, { recursive: true });
-    writeFileSync(join(dir, `${slug}.vbrief.json`), `${JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+    writeFileSync(join(dir, `${slug}.xbrief.json`), `${JSON.stringify({
+        xBRIEFInfo: { version: "0.8" },
         plan: {
             id: slug,
             title: slug,
@@ -70,10 +70,10 @@ function writeScopeVbrief(root, folder, slug, issueNumber) {
         },
     })}\n`, { encoding: "utf8" });
 }
-/** Build a throwaway project root with optional vBRIEF fixtures. */
+/** Build a throwaway project root with optional xBRIEF fixtures. */
 export function buildFixtureRepo(options = {}) {
     const root = mkdtempSync(join(tmpdir(), "deft-triage-bootstrap-parity-"));
-    mkdirSync(join(root, "vbrief"), { recursive: true });
+    mkdirSync(join(root, "xbrief"), { recursive: true });
     for (const item of options.scopeVbriefs ?? []) {
         writeScopeVbrief(root, item.folder, item.slug, item.issue);
     }

package/dist/triage-classify-fixtures.js

@@ -11,19 +11,19 @@ export function normalizeOutput(text) {
         .replace(/\S*deft-triage-classify-parity-[^\s/]+/g, "<TMPROOT>"));
 }
 function writeProjectDefinition(root, plan) {
-    const dir = join(root, "vbrief");
+    const dir = join(root, "xbrief");
     mkdirSync(dir, { recursive: true });
-    writeFileSync(join(dir, "PROJECT-DEFINITION.vbrief.json"), `${JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+    writeFileSync(join(dir, "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify({
+        xBRIEFInfo: { version: "0.8" },
         plan: { title: "T", status: "running", items: [], ...plan },
     }, null, 2)}\n`, { encoding: "utf8" });
 }
 /** Build a throwaway project root with optional PROJECT-DEFINITION. */
 export function buildFixtureRepo(options = {}) {
     const root = mkdtempSync(join(tmpdir(), "deft-triage-classify-parity-"));
-    mkdirSync(join(root, "vbrief"), { recursive: true });
+    mkdirSync(join(root, "xbrief"), { recursive: true });
     if (options.rawProjectDefinition !== undefined) {
-        writeFileSync(join(root, "vbrief", "PROJECT-DEFINITION.vbrief.json"), `${JSON.stringify(options.rawProjectDefinition, null, 2)}\n`, { encoding: "utf8" });
+        writeFileSync(join(root, "xbrief", "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify(options.rawProjectDefinition, null, 2)}\n`, { encoding: "utf8" });
     }
     else if (!options.omitProjectDefinition && options.plan !== undefined) {
         writeProjectDefinition(root, options.plan);
@@ -109,7 +109,7 @@ export const PARITY_CASES = [
         argv: ["--validate"],
         fixture: {
             rawProjectDefinition: {
-                vBRIEFInfo: { version: "0.6" },
+                xBRIEFInfo: { version: "0.8" },
                 plan: null,
             },
         },

package/dist/triage-queue-fixtures.js

@@ -29,7 +29,7 @@ function writeCachedIssue(root, repo, issue) {
     writeFileSync(join(dir, "raw.json"), `${JSON.stringify(raw)}\n`, { encoding: "utf8" });
 }
 function writeAuditLog(root, repo, entries) {
-    const dir = join(root, "vbrief", ".eval");
+    const dir = join(root, "xbrief", ".triage-cache");
     mkdirSync(dir, { recursive: true });
     const lines = entries.map((entry) => JSON.stringify({
         decision_id: `id-${entry.issueNumber}-${entry.decision}`,
@@ -42,19 +42,19 @@ function writeAuditLog(root, repo, entries) {
     writeFileSync(join(dir, "candidates.jsonl"), `${lines.join("\n")}\n`, { encoding: "utf8" });
 }
 function writeProjectDefinition(root, rankingLabels) {
-    const dir = join(root, "vbrief");
+    const dir = join(root, "xbrief");
     mkdirSync(dir, { recursive: true });
     const plan = { title: "T", status: "running", items: [] };
     if (rankingLabels !== undefined && rankingLabels.length > 0) {
         plan.policy = { triageRankingLabels: [...rankingLabels] };
     }
-    writeFileSync(join(dir, "PROJECT-DEFINITION.vbrief.json"), `${JSON.stringify({ vBRIEFInfo: { version: "0.6" }, plan }, null, 2)}\n`, { encoding: "utf8" });
+    writeFileSync(join(dir, "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify({ xBRIEFInfo: { version: "0.8" }, plan }, null, 2)}\n`, { encoding: "utf8" });
 }
 function writeActiveScope(root, repo, issueNumber, filename) {
-    const dir = join(root, "vbrief", "active");
+    const dir = join(root, "xbrief", "active");
     mkdirSync(dir, { recursive: true });
     writeFileSync(join(dir, filename), `${JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+        xBRIEFInfo: { version: "0.8" },
         plan: {
             title: "Active scope",
             status: "running",
@@ -69,10 +69,10 @@ function writeActiveScope(root, repo, issueNumber, filename) {
     })}\n`, { encoding: "utf8" });
 }
 function writeBlockedScope(root, repo, issueNumber, filename) {
-    const dir = join(root, "vbrief", "active");
+    const dir = join(root, "xbrief", "active");
     mkdirSync(dir, { recursive: true });
     writeFileSync(join(dir, filename), `${JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+        xBRIEFInfo: { version: "0.8" },
         plan: {
             title: "Blocked scope",
             status: "blocked",
@@ -87,7 +87,7 @@ function writeBlockedScope(root, repo, issueNumber, filename) {
     })}\n`, { encoding: "utf8" });
 }
 function writeSliceRecords(root, records) {
-    const dir = join(root, "vbrief", ".eval");
+    const dir = join(root, "xbrief", ".triage-cache");
     mkdirSync(dir, { recursive: true });
     writeFileSync(join(dir, "slices.jsonl"), `${records.map((record) => JSON.stringify(record)).join("\n")}\n`, { encoding: "utf8" });
 }
@@ -95,7 +95,7 @@ function writeSliceRecords(root, records) {
 export function buildFixtureRepo(options = {}) {
     const root = mkdtempSync(join(tmpdir(), "deft-triage-queue-parity-"));
     const repo = options.repo ?? DEFAULT_REPO;
-    mkdirSync(join(root, "vbrief"), { recursive: true });
+    mkdirSync(join(root, "xbrief"), { recursive: true });
     writeProjectDefinition(root, options.rankingLabels);
     for (const issue of options.issues ?? []) {
         writeCachedIssue(root, repo, issue);
@@ -104,10 +104,10 @@ export function buildFixtureRepo(options = {}) {
         writeAuditLog(root, repo, options.auditEntries);
     }
     for (const issueNumber of options.activeIssueNumbers ?? []) {
-        writeActiveScope(root, repo, issueNumber, `active-${issueNumber}.vbrief.json`);
+        writeActiveScope(root, repo, issueNumber, `active-${issueNumber}.xbrief.json`);
     }
     for (const issueNumber of options.blockedIssueNumbers ?? []) {
-        writeBlockedScope(root, repo, issueNumber, `blocked-${issueNumber}.vbrief.json`);
+        writeBlockedScope(root, repo, issueNumber, `blocked-${issueNumber}.xbrief.json`);
     }
     if (options.sliceRecords !== undefined && options.sliceRecords.length > 0) {
         writeSliceRecords(root, options.sliceRecords);
@@ -251,10 +251,10 @@ export function augmentParityArgv(testCase, root) {
     }
     const extras = [];
     if (testCase.fixture.auditEntries !== undefined && testCase.fixture.auditEntries.length > 0) {
-        extras.push("--audit-log", join(root, "vbrief", ".eval", "candidates.jsonl"));
+        extras.push("--audit-log", join(root, "xbrief", ".triage-cache", "candidates.jsonl"));
     }
     if (testCase.fixture.sliceRecords !== undefined && testCase.fixture.sliceRecords.length > 0) {
-        extras.push("--slices-log", join(root, "vbrief", ".eval", "slices.jsonl"));
+        extras.push("--slices-log", join(root, "xbrief", ".triage-cache", "slices.jsonl"));
     }
     return [...argv, ...extras];
 }

package/dist/triage-scope-fixtures.js

@@ -10,16 +10,16 @@ export function normalizeOutput(text) {
         .replace(/path=[^\s\n]+coverage\.json/g, "path=<ROOT>/coverage.json");
 }
 function writeProjectDefinition(root, policy = {}) {
-    const dir = join(root, "vbrief");
+    const dir = join(root, "xbrief");
     mkdirSync(dir, { recursive: true });
-    writeFileSync(join(dir, "PROJECT-DEFINITION.vbrief.json"), `${JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+    writeFileSync(join(dir, "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify({
+        xBRIEFInfo: { version: "0.8" },
         plan: { title: "T", status: "running", items: [], policy },
     }, null, 2)}\n`, "utf8");
 }
 export function buildFixtureRepo(options = {}) {
     const root = mkdtempSync(join(tmpdir(), "deft-triage-scope-parity-"));
-    mkdirSync(join(root, "vbrief"), { recursive: true });
+    mkdirSync(join(root, "xbrief"), { recursive: true });
     writeProjectDefinition(root, options.policy ?? {});
     return root;
 }

package/dist/vbrief-preflight-fixtures.js

@@ -49,7 +49,7 @@ export function buildFixtures(root) {
     for (const [label, folder, content] of PARITY_FIXTURES) {
         const dir = join(root, folder);
         mkdirSync(dir, { recursive: true });
-        const file = join(dir, `${label}.vbrief.json`);
+        const file = join(dir, `${label}.xbrief.json`);
         writeFileSync(file, content, { encoding: "utf8" });
         paths.set(label, file);
     }

package/dist/wip-cap-fixtures.js

@@ -7,30 +7,30 @@ export function normalizeOutput(text) {
     return text.replace(/project_root=[^\s)]+/g, "project_root=<ROOT>");
 }
 function writeProjectDefinition(root, plan) {
-    const dir = join(root, "vbrief");
+    const dir = join(root, "xbrief");
     mkdirSync(dir, { recursive: true });
-    writeFileSync(join(dir, "PROJECT-DEFINITION.vbrief.json"), `${JSON.stringify({
-        vBRIEFInfo: { version: "0.6" },
+    writeFileSync(join(dir, "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify({
+        xBRIEFInfo: { version: "0.8" },
         plan: { title: "T", status: "running", items: [], ...plan },
     }, null, 2)}\n`, { encoding: "utf8" });
 }
-function writeVbrief(root, folder, name) {
-    const dir = join(root, "vbrief", folder);
+function writeXbrief(root, folder, name) {
+    const dir = join(root, "xbrief", folder);
     mkdirSync(dir, { recursive: true });
-    writeFileSync(join(dir, name), `${JSON.stringify({ vBRIEFInfo: { version: "0.6" }, plan: { status: "approved", title: "T", items: [] } })}\n`, { encoding: "utf8" });
+    writeFileSync(join(dir, name), `${JSON.stringify({ xBRIEFInfo: { version: "0.8" }, plan: { status: "approved", title: "T", items: [] } })}\n`, { encoding: "utf8" });
 }
 /** Build a throwaway project root with optional PROJECT-DEFINITION and WIP files. */
 export function buildFixtureRepo(options = {}) {
     const root = mkdtempSync(join(tmpdir(), "deft-wip-cap-parity-"));
-    mkdirSync(join(root, "vbrief"), { recursive: true });
+    mkdirSync(join(root, "xbrief"), { recursive: true });
     if (options.plan !== undefined) {
         writeProjectDefinition(root, options.plan);
     }
     for (let i = 0; i < (options.pendingFiles ?? 0); i += 1) {
-        writeVbrief(root, "pending", `pending-${i}.vbrief.json`);
+        writeXbrief(root, "pending", `pending-${i}.xbrief.json`);
     }
     for (let i = 0; i < (options.activeFiles ?? 0); i += 1) {
-        writeVbrief(root, "active", `active-${i}.vbrief.json`);
+        writeXbrief(root, "active", `active-${i}.xbrief.json`);
     }
     return root;
 }

package/package.json

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