@deftai/directive-core 0.72.0 → 0.73.1

package/dist/triage/reconcile/reconcile.js

@@ -40,7 +40,13 @@ export function findReconcilable(projectRoot, options = {}) {
     const items = [];
     const seen = new Set();
     for (const folderName of BACKFILL_FOLDERS) {
-        const folderPath = resolveLifecycleFolder(root, folderName);
+        let folderPath;
+        try {
+            folderPath = resolveLifecycleFolder(root, folderName);
+        }
+        catch {
+            continue; // No xbrief/ layout; skip this folder.
+        }
         for (const [refRepo, number, path] of scanLifecycleRefs(folderPath)) {
             const effectiveRepo = refRepo ?? defaultRepo;
             if (effectiveRepo === null)
@@ -65,7 +71,14 @@ function countSkippedExisting(projectRoot, defaultRepo, auditPath) {
     let count = 0;
     const root = resolve(projectRoot);
     for (const folderName of BACKFILL_FOLDERS) {
-        for (const [refRepo, number] of scanLifecycleRefs(resolveLifecycleFolder(root, folderName))) {
+        let folderPath;
+        try {
+            folderPath = resolveLifecycleFolder(root, folderName);
+        }
+        catch {
+            continue; // No xbrief/ layout; skip this folder.
+        }
+        for (const [refRepo, number] of scanLifecycleRefs(folderPath)) {
             const effectiveRepo = refRepo ?? defaultRepo;
             if (effectiveRepo === null)
                 continue;
@@ -88,7 +101,14 @@ function countNoRepo(projectRoot, defaultRepo, auditPath) {
     let count = 0;
     const root = resolve(projectRoot);
     for (const folderName of BACKFILL_FOLDERS) {
-        for (const [refRepo, number] of scanLifecycleRefs(resolveLifecycleFolder(root, folderName))) {
+        let folderPath;
+        try {
+            folderPath = resolveLifecycleFolder(root, folderName);
+        }
+        catch {
+            continue; // No xbrief/ layout; skip this folder.
+        }
+        for (const [refRepo, number] of scanLifecycleRefs(folderPath)) {
             if ((refRepo ?? defaultRepo) === null && !existingNumbers.has(number))
                 count += 1;
         }

package/dist/triage/reconcile/types.d.ts

@@ -1,4 +1,4 @@
-export declare const AUDIT_LOG_RELPATH = "vbrief/.eval/candidates.jsonl";
+export declare const AUDIT_LOG_RELPATH = "xbrief/.triage-cache/candidates.jsonl";
 export declare const BACKFILL_FOLDERS: readonly ["proposed", "pending", "active"];
 export declare const RECONCILE_ACTOR = "agent:reconcile";
 export interface ReconcileItem {

package/dist/triage/reconcile/types.js

@@ -1,4 +1,4 @@
-export const AUDIT_LOG_RELPATH = "vbrief/.eval/candidates.jsonl";
+export const AUDIT_LOG_RELPATH = "xbrief/.triage-cache/candidates.jsonl";
 export const BACKFILL_FOLDERS = ["proposed", "pending", "active"];
 export const RECONCILE_ACTOR = "agent:reconcile";
 export function reconcileSummary(result) {

package/dist/triage/refresh/refresh.js

@@ -1,4 +1,4 @@
-import { resolve } from "node:path";
+import { join, resolve } from "node:path";
 import { resolveLifecycleFolder } from "../../layout/resolve.js";
 import { detectDrift } from "./drift.js";
 import { iterActiveVbriefs } from "./extract.js";
@@ -21,7 +21,14 @@ function defaultAuditWriter(repo, issueNumber, annotation, log) {
 }
 export function refreshActive(projectRoot, options = {}) {
     const root = resolve(projectRoot);
-    const activeDir = options.activeDir ?? resolveLifecycleFolder(root, "active");
+    let defaultActiveDir;
+    try {
+        defaultActiveDir = resolveLifecycleFolder(root, "active");
+    }
+    catch {
+        defaultActiveDir = join(root, "xbrief", "active"); // No xbrief/ layout; use canonical path.
+    }
+    const activeDir = options.activeDir ?? defaultActiveDir;
     const log = options.log ?? ((line) => process.stdout.write(`${line}\n`));
     const inputFn = options.inputFn ?? (() => "");
     const refreshLocal = options.refreshLocal ?? (() => { });

package/dist/triage/scope/constants.d.ts

@@ -1,6 +1,6 @@
 /** Framework default when plan.policy.triageScope is unset (#1131). */
 export declare const DEFAULT_TRIAGE_SCOPE: ReadonlyArray<Record<string, unknown>>;
-export declare const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+export declare const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 export declare const CACHE_DIR_NAME = ".deft-cache";
 export declare const COVERAGE_FILENAME = "coverage.json";
 export declare const ENV_COVERAGE_TTL_HOURS = "DEFT_COVERAGE_MAX_AGE_HOURS";
@@ -11,6 +11,6 @@ export declare const VALID_IGNORE_KEYS: Set<string>;
 export declare const VALID_IGNORE_RULES: Set<string>;
 export declare const REFERENCED_BY_VBRIEF_SCOPES: Set<string>;
 export declare const SLICED_FROM_SCOPES: Set<string>;
-export declare const SUBSCRIPTION_HISTORY_REL_PATH = "vbrief/.eval/subscription-history.jsonl";
+export declare const SUBSCRIPTION_HISTORY_REL_PATH = "xbrief/.triage-cache/subscription-history.jsonl";
 export declare const SUBSCRIPTION_HISTORY_SCHEMA = "deft.triage.subscription-change.v1";
 //# sourceMappingURL=constants.d.ts.map

package/dist/triage/scope/constants.js

@@ -1,6 +1,6 @@
 /** Framework default when plan.policy.triageScope is unset (#1131). */
 export const DEFAULT_TRIAGE_SCOPE = [{ rule: "all-open" }];
-export const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+export const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 export const CACHE_DIR_NAME = ".deft-cache";
 export const COVERAGE_FILENAME = "coverage.json";
 export const ENV_COVERAGE_TTL_HOURS = "DEFT_COVERAGE_MAX_AGE_HOURS";
@@ -20,6 +20,6 @@ export const VALID_IGNORE_KEYS = new Set(["label", "milestone"]);
 export const VALID_IGNORE_RULES = new Set(["author"]);
 export const REFERENCED_BY_VBRIEF_SCOPES = new Set(["any", "active"]);
 export const SLICED_FROM_SCOPES = new Set(["any-umbrella-in-cache"]);
-export const SUBSCRIPTION_HISTORY_REL_PATH = "vbrief/.eval/subscription-history.jsonl";
+export const SUBSCRIPTION_HISTORY_REL_PATH = "xbrief/.triage-cache/subscription-history.jsonl";
 export const SUBSCRIPTION_HISTORY_SCHEMA = "deft.triage.subscription-change.v1";
 //# sourceMappingURL=constants.js.map

package/dist/triage/scope/renderers.js

@@ -6,7 +6,13 @@ import { subscriptionHash } from "./normalize.js";
 import { pyListRepr } from "./python-repr.js";
 const LIFECYCLE_FOLDERS = ["proposed", "pending", "active", "completed", "cancelled"];
 export function extractReferencedIssues(projectRoot, lifecycleFolders = LIFECYCLE_FOLDERS) {
-    const root = resolveLifecycleRoot(projectRoot);
+    let root;
+    try {
+        root = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        return { any: new Set(), active: new Set() };
+    }
     const anySet = new Set();
     const activeSet = new Set();
     if (!existsSync(root))

package/dist/triage/smoketest/index.js

@@ -119,21 +119,24 @@ function defaultScriptRunner(scriptsDir) {
 export function copyFixtureToTmp(fixtureRoot, tmpRoot) {
     const project = tmpRoot;
     mkdirSync(project, { recursive: true });
-    mkdirSync(join(project, "vbrief"), { recursive: true });
-    copyFileSync(join(fixtureRoot, "PROJECT-DEFINITION.vbrief.json"), join(project, "vbrief", "PROJECT-DEFINITION.vbrief.json"));
+    mkdirSync(join(project, "xbrief"), { recursive: true });
+    const srcPD = join(fixtureRoot, "PROJECT-DEFINITION.xbrief.json");
+    if (existsSync(srcPD)) {
+        copyFileSync(srcPD, join(project, "xbrief", "PROJECT-DEFINITION.xbrief.json"));
+    }
     for (const sub of ["active", "proposed", "pending", "completed", "cancelled"]) {
-        const srcDir = join(fixtureRoot, "vbrief", sub);
-        const dstDir = join(project, "vbrief", sub);
+        const srcDir = join(fixtureRoot, "xbrief", sub);
+        const dstDir = join(project, "xbrief", sub);
         mkdirSync(dstDir, { recursive: true });
         if (existsSync(srcDir)) {
             for (const name of readdirSync(srcDir)) {
-                if (name.endsWith(".vbrief.json")) {
+                if (name.endsWith(".xbrief.json")) {
                     copyFileSync(join(srcDir, name), join(dstDir, name));
                 }
             }
         }
     }
-    mkdirSync(join(project, "vbrief", ".eval"), { recursive: true });
+    mkdirSync(join(project, "xbrief", ".eval"), { recursive: true });
     return project;
 }
 function defaultInlineRunner() {

package/dist/triage/subscribe/index.d.ts

@@ -1,6 +1,6 @@
-export declare const SUBSCRIPTION_HISTORY_REL_PATH = "vbrief/.triage-cache/subscription-history.jsonl";
+export declare const SUBSCRIPTION_HISTORY_REL_PATH = "xbrief/.triage-cache/subscription-history.jsonl";
 export declare const SUBSCRIPTION_HISTORY_SCHEMA = "deft.triage.subscription-change.v1";
-export declare const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+export declare const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 /** Python ``!r``-style quoting for parity with triage_subscribe.py messages. */
 export declare function pyRepr(value: string): string;
 export declare class ProjectDefinitionIOError extends Error {

package/dist/triage/subscribe/index.js

@@ -5,9 +5,9 @@ import { resolveProjectDefinitionPath } from "../../layout/resolve.js";
 import { migrateLegacyPolicyKey, PLAN_POLICY_KEY } from "../../policy/plan-extensions.js";
 import { projectDefinitionMutationLock } from "../../vbrief-build/project-definition-io.js";
 import { resolveTriageCachePath } from "../cache-path.js";
-export const SUBSCRIPTION_HISTORY_REL_PATH = "vbrief/.triage-cache/subscription-history.jsonl";
+export const SUBSCRIPTION_HISTORY_REL_PATH = "xbrief/.triage-cache/subscription-history.jsonl";
 export const SUBSCRIPTION_HISTORY_SCHEMA = "deft.triage.subscription-change.v1";
-export const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+export const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 /** Python ``!r``-style quoting for parity with triage_subscribe.py messages. */
 export function pyRepr(value) {
     return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;

package/dist/triage/summary/index.d.ts

@@ -4,9 +4,9 @@ export declare const MAX_LINE_CHARS = 120;
 export { DEFAULT_WIP_CAP, PROJECT_DEFINITION_REL_PATH };
 export declare const CACHE_DIR_NAME = ".deft-cache";
 export declare const CACHE_SOURCE = "github-issue";
-export declare const CANDIDATES_LOG_REL_PATH = "vbrief/.triage-cache/candidates.jsonl";
+export declare const CANDIDATES_LOG_REL_PATH = "xbrief/.triage-cache/candidates.jsonl";
 export { latestDecisions, readAuditLog } from "../actions/candidates-log.js";
-export declare const SUMMARY_HISTORY_REL_PATH = "vbrief/.triage-cache/summary-history.jsonl";
+export declare const SUMMARY_HISTORY_REL_PATH = "xbrief/.triage-cache/summary-history.jsonl";
 export declare const SUMMARY_HISTORY_SCHEMA = "deft.triage.summary.v1";
 /** D2 repeat-suppression window for session-start triage one-liner (#1122 / #1279). */
 export declare const D2_SUPPRESSION_WINDOW_HOURS = 4;

package/dist/triage/summary/index.js

@@ -18,7 +18,7 @@ export const CACHE_DIR_NAME = ".deft-cache";
 export const CACHE_SOURCE = "github-issue";
 export const CANDIDATES_LOG_REL_PATH = AUDIT_LOG_REL_PATH;
 export { latestDecisions, readAuditLog } from "../actions/candidates-log.js";
-export const SUMMARY_HISTORY_REL_PATH = "vbrief/.triage-cache/summary-history.jsonl";
+export const SUMMARY_HISTORY_REL_PATH = "xbrief/.triage-cache/summary-history.jsonl";
 export const SUMMARY_HISTORY_SCHEMA = "deft.triage.summary.v1";
 /** D2 repeat-suppression window for session-start triage one-liner (#1122 / #1279). */
 export const D2_SUPPRESSION_WINDOW_HOURS = 4;

package/dist/triage/summary/reconcilable.d.ts

@@ -1,6 +1,6 @@
 /** Lifecycle folders scanned for reconcilable vBRIEFs (#1468). */
 export declare const BACKFILL_FOLDERS: readonly ["proposed", "pending", "active"];
-export declare const CANDIDATES_LOG_REL_PATH = "vbrief/.triage-cache/candidates.jsonl";
+export declare const CANDIDATES_LOG_REL_PATH = "xbrief/.triage-cache/candidates.jsonl";
 /**
  * Count reconcilable issues (#1468) — mirrors `triage_reconcile.count_reconcilable`.
  */

package/dist/triage/welcome/constants.d.ts

@@ -1,13 +1,13 @@
 export declare const CACHE_DIR_NAME = ".deft-cache";
 export declare const CACHE_SOURCE = "github-issue";
-export declare const CANDIDATES_RELPATH: readonly ["vbrief", ".triage-cache", "candidates.jsonl"];
+export declare const CANDIDATES_RELPATH: readonly ["xbrief", ".triage-cache", "candidates.jsonl"];
 export declare const WIP_LIFECYCLE_DIRS: readonly ["pending", "active"];
 export declare const AUDIT_LOG_REL_PATH = "meta/policy-changes.log";
 export declare const DEFAULT_WIP_CAP = 20;
 export declare const DEFAULT_RELIEF_AGE_DAYS = 30;
 export declare const TRIAGE_SKILL_PATH = "skills/deft-directive-triage/SKILL.md";
 export declare const WELCOME_AUDIT_TAG = "triage-welcome";
-export declare const SUMMARY_HISTORY_REL_PATH = "vbrief/.triage-cache/summary-history.jsonl";
+export declare const SUMMARY_HISTORY_REL_PATH = "xbrief/.triage-cache/summary-history.jsonl";
 export declare const SUMMARY_HISTORY_SCHEMA = "deft.triage.summary.v1";
 export declare const EMPTY_CACHE_LINE = "[triage] cache empty -- run task triage:bootstrap";
 export declare const MAX_LINE_CHARS = 120;

package/dist/triage/welcome/constants.js

@@ -1,13 +1,13 @@
 export const CACHE_DIR_NAME = ".deft-cache";
 export const CACHE_SOURCE = "github-issue";
-export const CANDIDATES_RELPATH = ["vbrief", ".triage-cache", "candidates.jsonl"];
+export const CANDIDATES_RELPATH = ["xbrief", ".triage-cache", "candidates.jsonl"];
 export const WIP_LIFECYCLE_DIRS = ["pending", "active"];
 export const AUDIT_LOG_REL_PATH = "meta/policy-changes.log";
 export const DEFAULT_WIP_CAP = 20;
 export const DEFAULT_RELIEF_AGE_DAYS = 30;
 export const TRIAGE_SKILL_PATH = "skills/deft-directive-triage/SKILL.md";
 export const WELCOME_AUDIT_TAG = "triage-welcome";
-export const SUMMARY_HISTORY_REL_PATH = "vbrief/.triage-cache/summary-history.jsonl";
+export const SUMMARY_HISTORY_REL_PATH = "xbrief/.triage-cache/summary-history.jsonl";
 export const SUMMARY_HISTORY_SCHEMA = "deft.triage.summary.v1";
 export const EMPTY_CACHE_LINE = "[triage] cache empty -- run task triage:bootstrap";
 export const MAX_LINE_CHARS = 120;

package/dist/triage/welcome/onboard.js

@@ -43,7 +43,14 @@ export function runOnboardMode(projectRoot, options = {}) {
         out(`[welcome] --wip-cap must be a positive integer, got ${JSON.stringify(options.wipCap)}.`);
         return failure(2);
     }
-    const pdPath = resolveProjectDefinitionPath(projectRoot);
+    let pdPath;
+    try {
+        pdPath = resolveProjectDefinitionPath(projectRoot);
+    }
+    catch {
+        out(`[welcome] No xbrief/ layout found at ${projectRoot}. Run \`deft migrate:xbrief\` to convert your project from the legacy vbrief/ layout, or run project setup first (deft-directive-setup).`);
+        return failure(2);
+    }
     if (!existsSync(pdPath)) {
         out(`[welcome] No project definition found at ${pdPath}. Run project setup first (deft-directive-setup) before onboarding triage.`);
         return failure(2);

package/dist/triage/welcome/prior-state.js

@@ -5,7 +5,13 @@ import { readPlanPolicy } from "../../policy/plan-extensions.js";
 import { resolveCandidatesLogPath } from "../cache-path.js";
 import { CACHE_DIR_NAME, CACHE_SOURCE, DEFAULT_WIP_CAP, SUBSCRIPTION_PRESETS, WIP_LIFECYCLE_DIRS, } from "./constants.js";
 function loadProjectDefinition(projectRoot) {
-    const path = resolveProjectDefinitionPath(projectRoot);
+    let path;
+    try {
+        path = resolveProjectDefinitionPath(projectRoot);
+    }
+    catch {
+        return null; // No xbrief/ layout; no project definition.
+    }
     if (!existsSync(path))
         return null;
     try {
@@ -44,7 +50,13 @@ export function candidatesLogPath(projectRoot) {
 }
 function countWip(projectRoot) {
     let total = 0;
-    const root = resolveLifecycleRoot(projectRoot);
+    let root;
+    try {
+        root = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        return 0; // No xbrief/ layout; no WIP.
+    }
     for (const sub of WIP_LIFECYCLE_DIRS) {
         const folder = join(root, sub);
         if (!existsSync(folder))

package/dist/triage/welcome/summary.js

@@ -74,7 +74,13 @@ function latestDecisions(entries) {
     return out;
 }
 function countFilesystemInFlight(projectRoot) {
-    const activeDir = resolveLifecycleFolder(projectRoot, "active");
+    let activeDir;
+    try {
+        activeDir = resolveLifecycleFolder(projectRoot, "active");
+    }
+    catch {
+        return 0; // No xbrief/ layout; nothing in-flight.
+    }
     if (!existsSync(activeDir))
         return 0;
     let count = 0;
@@ -94,7 +100,13 @@ function countFilesystemInFlight(projectRoot) {
     return count;
 }
 function isTriageScopeConfigured(projectRoot) {
-    const path = resolveProjectDefinitionPath(projectRoot);
+    let path;
+    try {
+        path = resolveProjectDefinitionPath(projectRoot);
+    }
+    catch {
+        return false; // No xbrief/ layout; triage scope not configured.
+    }
     if (!existsSync(path))
         return false;
     try {

package/dist/triage/welcome/writers.js

@@ -143,7 +143,13 @@ function daysInPending(path, now) {
     }
 }
 export function previewWipRelief(projectRoot, olderThanDays = DEFAULT_RELIEF_AGE_DAYS) {
-    const pendingDir = resolveLifecycleFolder(projectRoot, "pending");
+    let pendingDir;
+    try {
+        pendingDir = resolveLifecycleFolder(projectRoot, "pending");
+    }
+    catch {
+        return { olderThanDays, eligibleCount: 0, eligibleFiles: [], skippedCount: 0 };
+    }
     if (!existsSync(pendingDir)) {
         return { olderThanDays, eligibleCount: 0, eligibleFiles: [], skippedCount: 0 };
     }

package/dist/ts-check-lane/run-lane.d.ts

@@ -25,6 +25,8 @@ export declare const SKIP_NOTICE: string;
 /** Result of a single lane command invocation. Mirrors a subset of SpawnSyncReturns. */
 export interface RunnerResult {
     readonly status: number | null;
+    readonly signal?: NodeJS.Signals | null;
+    readonly error?: Error;
 }
 export type LaneRunner = (argv: readonly string[], cwd: string) => RunnerResult;
 export interface RunTsLaneOptions {
@@ -35,6 +37,8 @@ export interface RunTsLaneOptions {
     /** Injected sink for human-facing notices (defaults to stdout). */
     readonly out?: (message: string) => void;
 }
+/** Windows command shims (.cmd/.bat) need a shell; native executables do not. */
+export declare function shouldUseShellForCommand(command: string, platform?: NodeJS.Platform): boolean;
 export interface ResolvePnpmOptions {
     readonly env?: NodeJS.ProcessEnv;
     readonly platform?: NodeJS.Platform;

package/dist/ts-check-lane/run-lane.js

@@ -18,7 +18,7 @@
  */
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
-import { join } from "node:path";
+import { posix, win32 } from "node:path";
 /**
  * Run order is deliberate: lint (cheapest, catches the biome class first),
  * then build, then the test suite.
@@ -31,11 +31,20 @@ export const LANE_COMMANDS = [
 export const SKIP_NOTICE = "[ts:check-lane] pnpm not found on PATH -- skipping the TypeScript lane " +
     "(build/lint/test). The TS engine stays validated by the dedicated CI job. " +
     "Install the Node toolchain (pnpm) to run the TS lane locally.";
-/** Default runner: a non-shell, inherited-stdio pnpm invocation. */
+/** Windows command shims (.cmd/.bat) need a shell; native executables do not. */
+export function shouldUseShellForCommand(command, platform = process.platform) {
+    return platform === "win32" && /\.(?:cmd|bat)$/i.test(command);
+}
+/** Default runner: an inherited-stdio pnpm invocation. */
 function defaultRunner(argv, cwd) {
     const [command, ...rest] = argv;
-    const result = spawnSync(command ?? "", rest, { cwd, stdio: "inherit" });
-    return { status: result.status };
+    const commandPath = command ?? "";
+    const result = spawnSync(commandPath, rest, {
+        cwd,
+        stdio: "inherit",
+        shell: shouldUseShellForCommand(commandPath),
+    });
+    return { error: result.error, signal: result.signal, status: result.status };
 }
 /** Resolve the pnpm executable path, or null when it is not installed. */
 export function resolvePnpm(options = {}) {
@@ -49,11 +58,12 @@ export function resolvePnpm(options = {}) {
     const isWindows = platform === "win32";
     const exts = isWindows ? (env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";") : [""];
     const sep = isWindows ? ";" : ":";
+    const joinPath = isWindows ? win32.join : posix.join;
     for (const dir of pathValue.split(sep)) {
         if (dir === "")
             continue;
         for (const ext of exts) {
-            const candidate = join(dir, `pnpm${ext}`);
+            const candidate = joinPath(dir, `pnpm${ext}`);
             if (exists(candidate)) {
                 return candidate;
             }
@@ -85,7 +95,11 @@ export function runTsLane(projectRoot, options) {
         // failure -- this mirrors the Python oracle, whose returncode is negative
         // (non-zero) for a signal-killed process.
         if (code === null) {
-            out(`[ts:check-lane] \`pnpm ${command.join(" ")}\` was killed by a signal before exit -- treating as failure.`);
+            if (result.error) {
+                out(`[ts:check-lane] \`pnpm ${command.join(" ")}\` failed to start: ${result.error.message}`);
+                return 1;
+            }
+            out(`[ts:check-lane] \`pnpm ${command.join(" ")}\` was killed by ${result.signal ?? "a signal"} before exit -- treating as failure.`);
             return 1;
         }
         if (code !== 0) {

package/dist/validate-content/validate-strategy-output.js

@@ -29,7 +29,17 @@ export function validateStrategyOutput(projectRoot, strict = false) {
     const errors = [];
     // Layout-aware (#2109 part 2a): resolve the lifecycle dir/suffix dynamically;
     // identical to vbrief/ on today's tree.
-    const layout = resolveLifecycleLayout(root);
+    let layout;
+    try {
+        layout = resolveLifecycleLayout(root);
+    }
+    catch {
+        if (strict) {
+            errors.push("xbrief/ directory missing entirely. v0.20 strategies must emit at least " +
+                "xbrief/proposed/ (with date-prefixed files) + PROJECT-DEFINITION.xbrief.json.");
+        }
+        return errors;
+    }
     const vbriefDir = layout.root;
     if (!existsSync(vbriefDir)) {
         if (strict) {

package/dist/value/feedback-file.js

@@ -1,6 +1,7 @@
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { isFrameworkRepoRoot } from "../check/orchestrator.js";
+import { policyColonInvocation } from "../policy/policy-invocation.js";
 import { isValueFeedbackPathAllowed, resolveValueFeedback } from "../policy/value-feedback.js";
 import { GhRestError, restCreateIssue, restIssueListPaginated, } from "../scm/gh-rest.js";
 import { resolveProjectRoot } from "../scope/project-context.js";
@@ -146,8 +147,8 @@ export function runFeedbackFile(options) {
             body,
             repo,
             message: "[deft feedback] Blocked: plan.policy.valueFeedback upstreamPrompt is OFF. " +
-                "Enable with `task policy:enable-value-feedback -- --confirm` and set upstreamPrompt, " +
-                "or inspect via `task policy:show --field=valueFeedback`.\n",
+                `Enable with \`${policyColonInvocation("enable-value-feedback", " -- --confirm")}\` and set upstreamPrompt, ` +
+                `or inspect via \`${policyColonInvocation("show", " --field=valueFeedback")}\`.\n`,
         };
     }
     const offline = isOffline();

package/dist/value/readback.js

@@ -3,6 +3,7 @@ import { join, resolve } from "node:path";
 import { runningInsideDeftRepo } from "../doctor/paths.js";
 import { ALL_ATTRIBUTION_EVENT_NAMES } from "../events/attribution-constants.js";
 import { DEFAULT_EVENT_LOG, readEvents } from "../lifecycle/events.js";
+import { policyColonInvocation } from "../policy/policy-invocation.js";
 import { isValueFeedbackPathAllowed, resolveValueFeedback, } from "../policy/value-feedback.js";
 import { resolveProjectRoot } from "../scope/project-context.js";
 import { MAX_LINE_CHARS } from "../triage/welcome/constants.js";
@@ -364,7 +365,7 @@ export function formatValueShowReport(trend) {
     if (trend.total === 0) {
         return (`[value] No attributed signals in the last ${trend.windowLabel} ` +
             "(ledger empty for this window).\n" +
-            "Inspect policy: `task policy:show --field=valueFeedback`.\n");
+            `Inspect policy: \`${policyColonInvocation("show", " --field=valueFeedback")}\`.\n`);
     }
     const classParts = ["value", "bypass", "adoption", "friction"]
         .filter((key) => trend.byClass[key] > 0)
@@ -409,7 +410,7 @@ export function runValueShow(options) {
             gated: true,
             empty: true,
             text: "[value] Blocked: plan.policy.valueFeedback is OFF. " +
-                "Enable with `task policy:enable-value-feedback -- --confirm`.\n",
+                `Enable with \`${policyColonInvocation("enable-value-feedback", " -- --confirm")}\`.\n`,
             trend: null,
         };
     }

package/dist/vbrief-build/parity-scenarios.js

@@ -195,10 +195,10 @@ export function runParityScenario(name, ctx) {
                 }, { ipIndex: 1, dependencies: ["ip-0"], specRef: "../specification.vbrief.json" }),
             };
         case "project-definition-roundtrip": {
-            const vbriefDir = join(ctx.fixtureRoot, "vbrief");
+            const vbriefDir = join(ctx.fixtureRoot, "xbrief");
             mkdirSync(vbriefDir, { recursive: true });
             const seed = {
-                vBRIEFInfo: { version: "0.6" },
+                xBRIEFInfo: { version: "0.8" },
                 plan: {
                     title: "Parity project",
                     status: "running",
@@ -206,7 +206,7 @@ export function runParityScenario(name, ctx) {
                     items: [],
                 },
             };
-            const pdPath = join(vbriefDir, "PROJECT-DEFINITION.vbrief.json");
+            const pdPath = join(vbriefDir, "PROJECT-DEFINITION.xbrief.json");
             writeFileSync(pdPath, pythonJsonPretty(seed), "utf8");
             let roundtrip = {};
             projectDefinitionMutationLock(ctx.fixtureRoot, () => {

package/dist/vbrief-reconcile/labels.js

@@ -84,7 +84,22 @@ function hasUnresolvedDeps(swarm, knownIds) {
 }
 export function reconcileLabels(projectRoot, options = {}) {
     const root = resolve(projectRoot);
-    const vbriefDir = resolveLifecycleRoot(root);
+    let vbriefDir;
+    try {
+        vbriefDir = resolveLifecycleRoot(root);
+    }
+    catch {
+        return [
+            2,
+            {
+                changed: [],
+                unchanged: [],
+                skipped_no_ref: [],
+                errors: [],
+                dry_run: options.dryRun ?? false,
+            },
+        ];
+    }
     if (!existsSync(vbriefDir)) {
         return [
             2,

package/dist/vbrief-reconcile/parity-scenarios.js

@@ -79,8 +79,8 @@ function specWith(items) {
     };
 }
 function writeBrief(root, storyId, folder, extra = {}) {
-    const path = join(root, "vbrief", folder, `2026-05-21-${storyId}.vbrief.json`);
-    mkdirSync(join(root, "vbrief", folder), { recursive: true });
+    const path = join(root, "xbrief", folder, `2026-05-21-${storyId}.xbrief.json`);
+    mkdirSync(join(root, "xbrief", folder), { recursive: true });
     const statusMap = {
         proposed: "proposed",
         pending: "pending",
@@ -89,7 +89,7 @@ function writeBrief(root, storyId, folder, extra = {}) {
         cancelled: "cancelled",
     };
     const data = {
-        vBRIEFInfo: { version: "0.6" },
+        xBRIEFInfo: { version: "0.8" },
         plan: {
             id: storyId,
             title: storyId,
@@ -215,7 +215,7 @@ export function runParityScenario(name, options) {
             };
         }
         case "graph-dry-run": {
-            mkdirSync(join(root, "vbrief", "proposed"), { recursive: true });
+            mkdirSync(join(root, "xbrief", "proposed"), { recursive: true });
             writeBrief(root, "dep-done", "completed");
             writeBrief(root, "child", "proposed", {
                 metadata: {
@@ -246,7 +246,7 @@ export function runParityScenario(name, options) {
             };
         }
         case "graph-cycle": {
-            mkdirSync(join(root, "vbrief", "proposed"), { recursive: true });
+            mkdirSync(join(root, "xbrief", "proposed"), { recursive: true });
             for (const id of ["a", "b"]) {
                 writeBrief(root, id, "proposed", {
                     metadata: {
@@ -274,12 +274,12 @@ export function runParityScenario(name, options) {
             };
         }
         case "graph-missing-proposed": {
-            mkdirSync(join(root, "vbrief"), { recursive: true });
+            mkdirSync(join(root, "xbrief"), { recursive: true });
             const [code] = reconcileGraph(root, { dryRun: true });
             return { scenario: name, ok: true, payload: { exitCode: code } };
         }
         case "labels-blocked-dry-run": {
-            mkdirSync(join(root, "vbrief", "active"), { recursive: true });
+            mkdirSync(join(root, "xbrief", "active"), { recursive: true });
             writeBrief(root, "blk", "active", {
                 status: "blocked",
                 references: [
@@ -303,7 +303,7 @@ export function runParityScenario(name, options) {
             };
         }
         case "labels-utf8-dry-run": {
-            mkdirSync(join(root, "vbrief", "active"), { recursive: true });
+            mkdirSync(join(root, "xbrief", "active"), { recursive: true });
             writeBrief(root, "utf8", "active", {
                 references: [
                     {
@@ -322,7 +322,7 @@ export function runParityScenario(name, options) {
             };
         }
         case "umbrellas-create-dry-run": {
-            mkdirSync(join(root, "vbrief", "active"), { recursive: true });
+            mkdirSync(join(root, "xbrief", "active"), { recursive: true });
             writeBrief(root, "child-a", "active", {
                 metadata: { kind: "story", swarm: { depends_on: [] } },
             });
@@ -350,7 +350,7 @@ export function runParityScenario(name, options) {
             };
         }
         case "umbrellas-unchanged": {
-            mkdirSync(join(root, "vbrief", "active"), { recursive: true });
+            mkdirSync(join(root, "xbrief", "active"), { recursive: true });
             writeBrief(root, "child-b", "active", {
                 metadata: { kind: "story", swarm: { depends_on: [] } },
             });