@deftai/directive-core 0.72.0 → 0.73.1

package/dist/scope/decompose.js

@@ -9,7 +9,7 @@
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { referenceTypeMatches } from "@deftai/directive-types";
-import { hasArtifactSuffix, resolveLifecycleRoot } from "../layout/resolve.js";
+import { hasArtifactSuffix, LEGACY_ARTIFACT_DIR, MIGRATED_ARTIFACT_DIR, resolveLifecycleRoot, } from "../layout/resolve.js";
 import { referenceWithDefaultTrust, slugify } from "../vbrief-build/build.js";
 import { EMITTED_VBRIEF_VERSION } from "../vbrief-build/constants.js";
 import { formatVbriefJson } from "./vbrief-json.js";
@@ -400,7 +400,17 @@ export function storyQualityIssues(opts) {
 // Path helpers
 // ---------------------------------------------------------------------------
 function vbriefDir(projectRoot) {
-    return resolveLifecycleRoot(projectRoot);
+    try {
+        return resolveLifecycleRoot(projectRoot);
+    }
+    catch (err) {
+        // Re-throw if only vbrief/ exists (legacy-only); fall back to canonical xbrief/ path otherwise.
+        if (existsSync(join(projectRoot, LEGACY_ARTIFACT_DIR)) &&
+            !existsSync(join(projectRoot, MIGRATED_ARTIFACT_DIR))) {
+            throw err;
+        }
+        return join(projectRoot, MIGRATED_ARTIFACT_DIR);
+    }
 }
 function relToVbrief(vbriefDirPath, path) {
     const resolvedPath = resolve(path);

package/dist/session/resume-conditions.js

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { hasArtifactSuffix } from "../layout/resolve.js";
+import { hasArtifactSuffix, MIGRATED_ARTIFACT_DIR } from "../layout/resolve.js";
 export const RESUME_ELIGIBLE_DECISION = "resume-eligible";
 export const EVALUATOR_ACTOR = "agent:resume-evaluator";
 export const CACHE_DIR_NAME = ".deft-cache";
@@ -258,7 +258,7 @@ export function evaluate(expr, ctx) {
     throw new ResumeGrammarError(`unknown composition op ${JSON.stringify(expr.op)}`);
 }
 function countPending(projectRoot) {
-    const folder = join(resolve(projectRoot), "vbrief", PENDING_LIFECYCLE_DIR);
+    const folder = join(resolve(projectRoot), MIGRATED_ARTIFACT_DIR, PENDING_LIFECYCLE_DIR);
     try {
         if (!statSync(folder).isDirectory())
             return 0;

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

@@ -3,7 +3,7 @@ export declare const RITUAL_STATE_SCHEMA_VERSION = 1;
 export declare const SENTINEL_RELPATH: readonly [".deft", "last-session.json"];
 export declare const RITUAL_STATE_RELPATH: readonly [".deft", "ritual-state.json"];
 export declare const MIN_RESUME_AGE_MS: number;
-export declare const ACTIVE_VBRIEF_PREFIX = "vbrief/active/";
+export declare const ACTIVE_VBRIEF_PREFIX: string;
 export interface Sentinel {
     readonly schemaVersion: number;
     readonly deftVersion: string;

package/dist/session/ritual-sentinel.js

@@ -1,6 +1,6 @@
 import { closeSync, existsSync, fdatasyncSync, mkdirSync, openSync, readdirSync, readFileSync, renameSync, statSync, writeSync, } from "node:fs";
 import { join, relative, resolve } from "node:path";
-import { hasArtifactSuffix } from "../layout/resolve.js";
+import { hasArtifactSuffix, LEGACY_ARTIFACT_DIR, MIGRATED_ARTIFACT_DIR, } from "../layout/resolve.js";
 import { stableJson } from "./json.js";
 import { parseTimestamp, timestampIso } from "./time.js";
 export const SCHEMA_VERSION = 1;
@@ -8,7 +8,7 @@ export const RITUAL_STATE_SCHEMA_VERSION = 1;
 export const SENTINEL_RELPATH = [".deft", "last-session.json"];
 export const RITUAL_STATE_RELPATH = [".deft", "ritual-state.json"];
 export const MIN_RESUME_AGE_MS = 2 * 60 * 60 * 1000;
-export const ACTIVE_VBRIEF_PREFIX = "vbrief/active/";
+export const ACTIVE_VBRIEF_PREFIX = `${MIGRATED_ARTIFACT_DIR}/active/`;
 export function ritualStatePath(projectRoot) {
     return join(resolve(projectRoot), ...RITUAL_STATE_RELPATH);
 }
@@ -249,7 +249,9 @@ export function writeSentinel(projectRoot, input) {
         schemaVersion: SCHEMA_VERSION,
         deftVersion: input.deftVersion,
         timestamp: timestampIso(instant),
-        lastActiveVbrief: input.lastActiveVbrief.replace(/\\/g, "/"),
+        lastActiveVbrief: input.lastActiveVbrief
+            .replace(/\\/g, "/")
+            .replace(`${LEGACY_ARTIFACT_DIR}/active/`, `${MIGRATED_ARTIFACT_DIR}/active/`),
         lastBranch: input.lastBranch,
     };
     atomicWriteJson(sentinelFile, payload, ".last-session.");
@@ -290,7 +292,7 @@ export function computeResumeSignal(sentinel, now, projectRoot) {
         `${elapsedLabel} ago. Resume? Run \`task vbrief:show ${lastActive}\`.`);
 }
 export function detectLatestActiveVbrief(projectRoot) {
-    const activeDir = join(resolve(projectRoot), "vbrief", "active");
+    const activeDir = join(resolve(projectRoot), MIGRATED_ARTIFACT_DIR, "active");
     try {
         if (!existsSync(activeDir)) {
             return null;

package/dist/slice/constants.d.ts

@@ -14,5 +14,5 @@ export declare const CHILD_ALLOWED_FIELDS: Set<"n" | "url" | "wave" | "role">;
 export declare const UUID_RE: RegExp;
 export declare const ISO8601_RE: RegExp;
 export declare const WAVE_FLAG_RE: RegExp;
-export declare const PROJECT_ROOT_SENTINELS: readonly ["vbrief", ".git"];
+export declare const PROJECT_ROOT_SENTINELS: readonly ["xbrief", "vbrief", ".git"];
 //# sourceMappingURL=constants.d.ts.map

package/dist/slice/constants.js

@@ -26,5 +26,5 @@ export const CHILD_ALLOWED_FIELDS = new Set(CHILD_REQUIRED_FIELDS);
 export const UUID_RE = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
 export const ISO8601_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$/;
 export const WAVE_FLAG_RE = /^--wave-(\d+)(?:=(.*))?$/;
-export const PROJECT_ROOT_SENTINELS = ["vbrief", ".git"];
+export const PROJECT_ROOT_SENTINELS = ["xbrief", "vbrief", ".git"];
 //# sourceMappingURL=constants.js.map

package/dist/slice/project-context.js

@@ -77,7 +77,7 @@ export function resolveRootAndRepo(cliProjectRoot, cliRepo, requireRepo) {
 export function formatMissingRootError() {
     return ("error: cannot determine project root. Pass --project-root PATH, " +
         "set $DEFT_PROJECT_ROOT, or run from inside a directory tree that " +
-        "contains vbrief/ or .git/ (#535).");
+        "contains xbrief/ or .git/ (#535).");
 }
 export function formatMissingRepoError() {
     return ("error: cannot determine repo slug. Pass --repo OWNER/NAME, " +

package/dist/spec-authority/resolver.js

@@ -5,8 +5,15 @@ import { SPEC_RENDER_BANNER } from "../render/constants.js";
 import { contentHasGeneratedPdSource, contentHasGeneratedSpecSource, EXPORT_SPEC_PD_BANNER, GENERATED_SPEC_PURPOSE, } from "./constants.js";
 export function resolveSpecAuthority(projectRoot) {
     const root = projectRoot;
-    const layout = resolveLifecycleLayout(root);
-    const vbriefDir = resolveLifecycleRoot(root);
+    let layout;
+    let vbriefDir;
+    try {
+        layout = resolveLifecycleLayout(root);
+        vbriefDir = resolveLifecycleRoot(root);
+    }
+    catch {
+        return null; // No xbrief/ layout; spec authority unavailable.
+    }
     const projectDefPath = resolveProjectDefinitionPath(root);
     if (!existsSync(projectDefPath))
         return null;

package/dist/swarm/complete-cohort.js

@@ -230,7 +230,20 @@ function completeParent(parentPath, vbriefDir, projectRoot, settled, dryRun) {
     };
 }
 export function sweepCohort(storyPaths, projectRoot, dryRun) {
-    const vbriefDir = resolveLifecycleRoot(projectRoot);
+    let vbriefDir;
+    try {
+        vbriefDir = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        return {
+            project_root: resolve(projectRoot),
+            dry_run: dryRun,
+            stories: [],
+            parents: [],
+            errors: [],
+            ok: true,
+        };
+    }
     const result = {
         project_root: resolve(projectRoot),
         dry_run: dryRun,

package/dist/swarm/constants.d.ts

@@ -7,7 +7,7 @@ export declare const EXIT_UNCLEAN = 1;
 export declare const EXIT_EXTERNAL_ERROR = 2;
 export declare const DEFAULT_BASE_BRANCH = "master";
 export declare const LEAF_CODING_WORKER_ROLE = "leaf-implementation";
-export declare const SUBAGENT_BACKEND_SET_CMD = "task policy:subagent-backend -- --set {backend_id}";
+export declare const SUBAGENT_BACKEND_SET_CMD: string;
 export declare const GATE_ADVISE = "advise";
 export declare const GATE_ENFORCE = "enforce";
 export declare const READY = "ready";

package/dist/swarm/constants.js

@@ -1,3 +1,4 @@
+import { policySetInvocation } from "../policy/policy-invocation.js";
 export const EXIT_OK = 0;
 export const EXIT_GATE_FAILED = 1;
 export const EXIT_CONFIG_ERROR = 2;
@@ -7,7 +8,7 @@ export const EXIT_UNCLEAN = 1;
 export const EXIT_EXTERNAL_ERROR = 2;
 export const DEFAULT_BASE_BRANCH = "master";
 export const LEAF_CODING_WORKER_ROLE = "leaf-implementation";
-export const SUBAGENT_BACKEND_SET_CMD = "task policy:subagent-backend -- --set {backend_id}";
+export const SUBAGENT_BACKEND_SET_CMD = `${policySetInvocation("subagent-backend", " -- --set {backend_id}")}`;
 export const GATE_ADVISE = "advise";
 export const GATE_ENFORCE = "enforce";
 export const READY = "ready";

package/dist/swarm/readiness.js

@@ -1,7 +1,7 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { basename, join, resolve } from "node:path";
 import { referenceTypeMatches } from "@deftai/directive-types";
-import { ARTIFACT_SUFFIXES, hasArtifactSuffix, LIFECYCLE_DIR_NAMES, resolveLifecycleLayout, resolveLifecycleRoot, stripArtifactSuffix, } from "../layout/resolve.js";
+import { ARTIFACT_SUFFIXES, hasArtifactSuffix, LEGACY_ARTIFACT_DIR, LIFECYCLE_DIR_NAMES, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY, resolveLifecycleLayout, resolveLifecycleRoot, stripArtifactSuffix, } from "../layout/resolve.js";
 import { acceptanceTextsFromItems, asStrList, deprecatedSubitemsIssues, itemHasTraces, itemsHaveAcceptance, missingRequiredSwarmFields, storyQualityIssues, } from "../vbrief-validation/story-quality.js";
 import { LIFECYCLE_FOLDERS, READY } from "./constants.js";
 function loadJson(path) {
@@ -26,7 +26,31 @@ function projectRel(projectRoot, path) {
     }
 }
 function expandPaths(projectRoot, patterns) {
-    const layout = resolveLifecycleLayout(projectRoot);
+    // Use the canonical xbrief layout; re-throw only if a legacy vbrief/-only tree is detected (#2112).
+    let layout;
+    try {
+        layout = resolveLifecycleLayout(projectRoot);
+    }
+    catch (err) {
+        const xbriefDir = join(projectRoot, MIGRATED_ARTIFACT_DIR);
+        if (existsSync(xbriefDir)) {
+            // xbrief/ dir exists but has no artifacts yet -- treat as valid (empty) layout.
+            layout = {
+                root: xbriefDir,
+                artifactDir: MIGRATED_ARTIFACT_DIR,
+                artifactSuffix: MIGRATED_ARTIFACT_SUFFIX,
+                infoRootKey: MIGRATED_INFO_ROOT_KEY,
+                migrated: true,
+            };
+        }
+        else if (existsSync(join(projectRoot, LEGACY_ARTIFACT_DIR))) {
+            throw err; // Legacy-only project: operator must run deft migrate:xbrief.
+        }
+        else {
+            // Neither exists -- return empty list.
+            return [];
+        }
+    }
     const usePatterns = patterns.length > 0 ? patterns : [`${layout.artifactDir}/active/*${layout.artifactSuffix}`];
     const out = [];
     const seen = new Set();
@@ -210,7 +234,13 @@ function acceptanceCountJustification(plan, swarm) {
 }
 function allScopeIds(projectRoot) {
     const ids = new Map();
-    const vbriefDir = resolveLifecycleRoot(projectRoot);
+    let vbriefDir;
+    try {
+        vbriefDir = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        return ids; // No xbrief/ layout; no scope IDs.
+    }
     for (const folder of LIFECYCLE_FOLDERS) {
         const dir = join(vbriefDir, folder);
         if (!existsSync(dir)) {

package/dist/swarm/subagent-backend.js

@@ -12,6 +12,7 @@
  * @see {@link https://github.com/deftai/directive/issues/1860} Hard deletion tracking
  */
 import { readPlanPolicy } from "../policy/plan-extensions.js";
+import { policySetInvocation } from "../policy/policy-invocation.js";
 import { loadProjectDefinition } from "../policy/resolve.js";
 import { LEAF_CODING_WORKER_ROLE, SUBAGENT_BACKEND_SET_CMD } from "./constants.js";
 const TRUTHY = new Set(["1", "true", "yes", "on"]);
@@ -132,7 +133,7 @@ export function enforceSubagentBackendPolicy(projectRoot, environ = process.env)
             error: `${detail}\n` +
                 "Select a coding sub-agent backend before headless dispatch:\n" +
                 `${listing}\n` +
-                "Probe harness availability: task policy:subagent-backends\n" +
+                `Probe harness availability: ${policySetInvocation("subagent-backends")}\n` +
                 `Persist a choice: ${SUBAGENT_BACKEND_SET_CMD.replace("{backend_id}", "<id>")}`,
         };
     }

package/dist/task-surface/index.js

@@ -72,10 +72,10 @@ export function runChangeInit(projectRoot, name, io) {
         return 1;
     }
     mkdirSync(join(base, "specs"), { recursive: true });
-    writeFileSync(join(base, "proposal.vbrief.json"), `${JSON.stringify(proposalTemplate(trimmed), null, 2)}\n`, "utf8");
-    writeFileSync(join(base, "tasks.vbrief.json"), `${JSON.stringify(tasksTemplate(trimmed), null, 2)}\n`, "utf8");
+    writeFileSync(join(base, "proposal.xbrief.json"), `${JSON.stringify(proposalTemplate(trimmed), null, 2)}\n`, "utf8");
+    writeFileSync(join(base, "tasks.xbrief.json"), `${JSON.stringify(tasksTemplate(trimmed), null, 2)}\n`, "utf8");
     io.writeOut(`OK: Created change proposal at ${base}/\n`);
-    for (const file of ["proposal.vbrief.json", "tasks.vbrief.json", "specs/"]) {
+    for (const file of ["proposal.xbrief.json", "tasks.xbrief.json", "specs/"]) {
         io.writeOut(`  - ${file}\n`);
     }
     return 0;

package/dist/triage/actions/candidates-log.d.ts

@@ -1,7 +1,7 @@
 import { resolveCandidatesLogPath } from "../cache-path.js";
 import type { AuditEntry, CandidatesLog } from "./types.js";
 /** Display/back-compat constant; resolution flows through resolveTriageCachePath (#1703). */
-export declare const AUDIT_LOG_REL_PATH = "vbrief/.triage-cache/candidates.jsonl";
+export declare const AUDIT_LOG_REL_PATH = "xbrief/.triage-cache/candidates.jsonl";
 export { resolveCandidatesLogPath };
 /** Read every well-formed audit-log row in insertion order (#1698 shared reader). */
 export declare function readAuditLog(logPath: string, repo?: string | null): AuditEntry[];

package/dist/triage/bootstrap/gitignore.js

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, relative } from "node:path";
-import { resolveLifecycleLayout } from "../../layout/resolve.js";
+import { MIGRATED_ARTIFACT_DIR, resolveLifecycleLayout } from "../../layout/resolve.js";
 import { resolveCandidatesLogPath, resolveTriageCachePath, TRIAGE_CACHE_DIR_NAME, triageCacheRelPath, } from "../cache-path.js";
 /** POSIX-style display path for `absPath` relative to `projectRoot` (#2109). */
 function evalRelDisplay(projectRoot, absPath) {
@@ -13,11 +13,11 @@ export const GITIGNORE_DEFT_RUNTIME_SENTINELS = [
 ];
 /** Legacy static vbrief paths kept for tests referencing the pre-#1703 constant shape. */
 export const GITIGNORE_EVAL_ENTRIES = [
-    "vbrief/.triage-cache/candidates.jsonl",
-    "vbrief/.triage-cache/summary-history.jsonl",
-    "vbrief/.triage-cache/scope-lifecycle.jsonl",
-    "vbrief/.triage-cache/decompositions/",
-    "vbrief/.triage-cache/doctor-state.json",
+    "xbrief/.triage-cache/candidates.jsonl",
+    "xbrief/.triage-cache/summary-history.jsonl",
+    "xbrief/.triage-cache/scope-lifecycle.jsonl",
+    "xbrief/.triage-cache/decompositions/",
+    "xbrief/.triage-cache/doctor-state.json",
 ];
 /** Layout-aware gitignore lines for triage working-set files (#1703). */
 export function gitignoreTriageCacheEntries(projectRoot) {
@@ -31,8 +31,14 @@ export function gitignoreTriageCacheEntries(projectRoot) {
     ];
 }
 export function gitattributesTriageCacheGlob(projectRoot) {
-    const layout = resolveLifecycleLayout(projectRoot);
-    return `${layout.artifactDir}/${TRIAGE_CACHE_DIR_NAME}/*.jsonl`;
+    let artifactDir;
+    try {
+        artifactDir = resolveLifecycleLayout(projectRoot).artifactDir;
+    }
+    catch {
+        artifactDir = MIGRATED_ARTIFACT_DIR; // No layout; default to xbrief/.
+    }
+    return `${artifactDir}/${TRIAGE_CACHE_DIR_NAME}/*.jsonl`;
 }
 export const GITATTRIBUTES_EVAL_RULE = "vbrief/.triage-cache/*.jsonl  merge=union";
 export const FORBIDDEN_BLANKET_EVAL_LINES = [
@@ -154,8 +160,14 @@ operators should know:
 `;
 /** Layout-aware triage-cache README body for the active lifecycle tree (#2344 / #2349). */
 export function generateTriageCacheReadmeBody(projectRoot) {
-    const layout = resolveLifecycleLayout(projectRoot);
-    const triagePrefix = `${layout.artifactDir}/${TRIAGE_CACHE_DIR_NAME}`;
+    let artifactDir;
+    try {
+        artifactDir = resolveLifecycleLayout(projectRoot).artifactDir;
+    }
+    catch {
+        artifactDir = MIGRATED_ARTIFACT_DIR; // No layout; default to xbrief/.
+    }
+    const triagePrefix = `${artifactDir}/${TRIAGE_CACHE_DIR_NAME}`;
     return EVAL_README_BODY.replaceAll("vbrief/.triage-cache", triagePrefix);
 }
 function stepOutcome(name, ok, message, details = {}, error = null) {

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

@@ -2,7 +2,7 @@ import type { BootstrapResult, CacheModule, RunBootstrapOptions, StepOutcome } f
 export * from "./gitignore.js";
 export * from "./types.js";
 export declare const CACHE_DIR_NAME = ".deft-cache";
-export declare const AUDIT_LOG_RELPATH = "vbrief/.triage-cache/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 BOOTSTRAP_ACTOR = "agent:bootstrap";
 export declare const DEFAULT_FETCH_TIMEOUT_S = 3600;

package/dist/triage/bootstrap/index.js

@@ -11,7 +11,7 @@ import { PROGRESS_DEFAULT } from "./types.js";
 export * from "./gitignore.js";
 export * from "./types.js";
 export const CACHE_DIR_NAME = ".deft-cache";
-export const AUDIT_LOG_RELPATH = "vbrief/.triage-cache/candidates.jsonl";
+export const AUDIT_LOG_RELPATH = "xbrief/.triage-cache/candidates.jsonl";
 export const BACKFILL_FOLDERS = ["proposed", "pending", "active"];
 export const BOOTSTRAP_ACTOR = "agent:bootstrap";
 export const DEFAULT_FETCH_TIMEOUT_S = 3600;
@@ -374,9 +374,15 @@ export function stepBackfillAuditLog(projectRoot, repo, options = {}) {
     if (repo === null) {
         return stepOutcome("backfill_audit_log", true, "skipped (no --repo provided; pass --repo OWNER/NAME to backfill)", { skipped: "no-repo" });
     }
-    const vbriefRoot = resolveLifecycleRoot(projectRoot);
+    let vbriefRoot;
+    try {
+        vbriefRoot = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        return stepOutcome("backfill_audit_log", true, `skipped (no xbrief/ layout under ${projectRoot})`, { skipped: "no-xbrief" });
+    }
     if (!existsSync(vbriefRoot)) {
-        return stepOutcome("backfill_audit_log", true, `skipped (no vbrief/ directory under ${projectRoot})`, { skipped: "no-vbrief" });
+        return stepOutcome("backfill_audit_log", true, `skipped (no xbrief/ directory under ${projectRoot})`, { skipped: "no-xbrief" });
     }
     const auditPath = resolveCandidatesLogPath(projectRoot);
     const alreadyLogged = existingAuditIssueNumbers(auditPath);

package/dist/triage/cache-path.d.ts

@@ -33,7 +33,7 @@ export declare function resolveTriageCachePath(projectRoot: string, ...segments:
 /** Display helper: project-root-relative POSIX path for logs and gitignore copy. */
 export declare function triageCacheDisplayPath(projectRoot: string, absPath: string): string;
 /** Back-compat display constant; resolution flows through `resolveTriageCachePath`. */
-export declare const TRIAGE_CANDIDATES_LOG_REL_PATH = "vbrief/.triage-cache/candidates.jsonl";
+export declare const TRIAGE_CANDIDATES_LOG_REL_PATH = "xbrief/.triage-cache/candidates.jsonl";
 /** Layout-aware candidates audit-log path. */
 export declare function resolveCandidatesLogPath(projectRoot: string): string;
 /** Ensure the triage cache directory exists (post-migration). */

package/dist/triage/cache-path.js

@@ -6,7 +6,7 @@
  */
 import { existsSync, mkdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { join, relative } from "node:path";
-import { resolveEvalDir, resolveLifecycleLayout, resolveLifecycleRoot } from "../layout/resolve.js";
+import { MIGRATED_ARTIFACT_DIR, resolveEvalDir, resolveLifecycleLayout, resolveLifecycleRoot, } from "../layout/resolve.js";
 import { generateTriageCacheReadmeBody } from "./bootstrap/gitignore.js";
 /** Directory name for the triage working-set cache (not version-eval results). */
 export const TRIAGE_CACHE_DIR_NAME = ".triage-cache";
@@ -26,19 +26,45 @@ export const TRIAGE_CACHE_FILE_NAMES = [
 export const TRIAGE_CACHE_DIR_NAMES = ["decompositions"];
 /** Absolute path to the layout-aware `.triage-cache/` directory. */
 export function resolveTriageCacheDir(projectRoot) {
-    return join(resolveLifecycleRoot(projectRoot), TRIAGE_CACHE_DIR_NAME);
+    let layoutRoot;
+    try {
+        layoutRoot = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        layoutRoot = join(projectRoot, MIGRATED_ARTIFACT_DIR); // No xbrief/ layout; use canonical path.
+    }
+    return join(layoutRoot, TRIAGE_CACHE_DIR_NAME);
 }
 /** POSIX-style path relative to project root (e.g. `xbrief/.triage-cache/foo`). */
 export function triageCacheRelPath(projectRoot, ...segments) {
-    const layout = resolveLifecycleLayout(projectRoot);
-    return [layout.artifactDir, TRIAGE_CACHE_DIR_NAME, ...segments].join("/");
+    let artifactDir;
+    try {
+        const layout = resolveLifecycleLayout(projectRoot);
+        artifactDir = layout.artifactDir;
+    }
+    catch {
+        artifactDir = "xbrief"; // No layout; default to xbrief/ path for display purposes.
+    }
+    return [artifactDir, TRIAGE_CACHE_DIR_NAME, ...segments].join("/");
 }
 /**
  * Idempotently move triage working-set artefacts from legacy `.eval/` into
  * `.triage-cache/` when the new location is absent.
  */
 export function migrateLegacyTriageCacheFromEval(projectRoot) {
-    const legacyDir = resolveEvalDir(projectRoot);
+    let legacyDir;
+    try {
+        legacyDir = resolveEvalDir(projectRoot);
+    }
+    catch {
+        return {
+            migratedFiles: [],
+            skippedFiles: [],
+            migratedDirs: [],
+            regeneratedFiles: [],
+            removedLegacyFiles: [],
+        };
+    }
     const targetDir = resolveTriageCacheDir(projectRoot);
     const migratedFiles = [];
     const skippedFiles = [];
@@ -100,7 +126,7 @@ export function triageCacheDisplayPath(projectRoot, absPath) {
     return relative(projectRoot, absPath).split(/[\\/]/).join("/");
 }
 /** Back-compat display constant; resolution flows through `resolveTriageCachePath`. */
-export const TRIAGE_CANDIDATES_LOG_REL_PATH = "vbrief/.triage-cache/candidates.jsonl";
+export const TRIAGE_CANDIDATES_LOG_REL_PATH = "xbrief/.triage-cache/candidates.jsonl";
 /** Layout-aware candidates audit-log path. */
 export function resolveCandidatesLogPath(projectRoot) {
     return resolveTriageCachePath(projectRoot, "candidates.jsonl");

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

@@ -1,5 +1,5 @@
 /** Filesystem-relative location of the PROJECT-DEFINITION vBRIEF. */
-export declare const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+export declare const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 /** Threshold in days for the "dormant" universal rule (Decision 1). */
 export declare const DORMANT_AGE_DAYS = 90;
 /** Threshold in characters for "thin body" used by the dormant rule. */

package/dist/triage/classify/index.js

@@ -30,7 +30,7 @@ function pythonRepr(value) {
     return pyRepr(value);
 }
 /** Filesystem-relative location of the PROJECT-DEFINITION vBRIEF. */
-export const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+export const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 /** Threshold in days for the "dormant" universal rule (Decision 1). */
 export const DORMANT_AGE_DAYS = 90;
 /** Threshold in characters for "thin body" used by the dormant rule. */
@@ -255,7 +255,14 @@ export function validateHoldMarkers(markers) {
     return { errors, warnings };
 }
 export function projectDefinitionPath(projectRoot) {
-    return resolveProjectDefinitionPath(projectRoot ?? process.cwd());
+    const root = projectRoot ?? process.cwd();
+    try {
+        return resolveProjectDefinitionPath(root);
+    }
+    catch {
+        // No xbrief/ layout; return canonical path so callers get a predictable "not found" result.
+        return join(root, "xbrief", "PROJECT-DEFINITION.xbrief.json");
+    }
 }
 function loadProjectDefinition(projectRoot) {
     const path = projectDefinitionPath(projectRoot);
@@ -698,7 +705,7 @@ export function validateProject(projectRoot) {
         return {
             code: 0,
             stdout: "OK: no PROJECT-DEFINITION at " +
-                `${resolveProjectDefinitionPath(root)} -- ` +
+                `${projectDefinitionPath(root)} -- ` +
                 "framework defaults apply with no consumer overrides.\n",
             stderr: "",
         };
@@ -711,7 +718,7 @@ export function validateProject(projectRoot) {
             stderr: "FAIL: PROJECT-DEFINITION.plan is not an object\n",
         };
     }
-    const rel = resolveProjectDefinitionPath(root);
+    const rel = projectDefinitionPath(root);
     const classifyErrs = validateTriageAutoClassifyOnPlan(plan, rel);
     const holderErrs = validateTriageHoldMarkersOnPlan(plan, rel);
     const errors = [...classifyErrs, ...holderErrs];

package/dist/triage/help/registry-data.d.ts

@@ -1,11 +1,11 @@
-/** Auto-generated from scripts/triage_help.py -- do not edit by hand. */
+/** Hand-maintained help registry. Edit directly; no generator script. */
 export declare const registryData: {
     readonly registry: {
         readonly "task triage:summary": {
             readonly name: "task triage:summary";
             readonly summary: "One-line state for session-start ritual";
             readonly refs: "(D2 / #1122)";
-            readonly description: "Emit the one-line triage state consumed by the session-start ritual. Always exits 0 (status surface, not a gate); appends a JSONL record to vbrief/.triage-cache/summary-history.jsonl for observability.";
+            readonly description: "Emit the one-line triage state consumed by the session-start ritual. Always exits 0 (status surface, not a gate); appends a JSONL record to <lifecycle-root>/.triage-cache/summary-history.jsonl for observability.";
             readonly usage: "task triage:summary [-- --json] [--no-history]";
             readonly flags: readonly [readonly ["--json", "(off)", "Emit the structured record as JSON instead of the one-liner."], readonly ["--no-history", "(off)", "Suppress the history sidecar append (test-only)."], readonly ["--project-root PATH", "(cwd)", "Project root override (Taskfile threads USER_WORKING_DIR)."]];
             readonly examples: readonly ["task triage:summary", "task triage:summary -- --json | jq"];

package/dist/triage/help/registry-data.js

@@ -1,11 +1,11 @@
-/** Auto-generated from scripts/triage_help.py -- do not edit by hand. */
+/** Hand-maintained help registry. Edit directly; no generator script. */
 export const registryData = {
     registry: {
         "task triage:summary": {
             name: "task triage:summary",
             summary: "One-line state for session-start ritual",
             refs: "(D2 / #1122)",
-            description: "Emit the one-line triage state consumed by the session-start ritual. Always exits 0 (status surface, not a gate); appends a JSONL record to vbrief/.triage-cache/summary-history.jsonl for observability.",
+            description: "Emit the one-line triage state consumed by the session-start ritual. Always exits 0 (status surface, not a gate); appends a JSONL record to <lifecycle-root>/.triage-cache/summary-history.jsonl for observability.",
             usage: "task triage:summary [-- --json] [--no-history]",
             flags: [
                 ["--json", "(off)", "Emit the structured record as JSON instead of the one-liner."],

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

@@ -4,14 +4,14 @@ export declare const CACHE_DIR_NAME = ".deft-cache";
 export declare const CACHE_SOURCE_GITHUB_ISSUE = "github-issue";
 /** Env var honoured for repo inference when `--repo` is absent (#1238). */
 export declare const ENV_TRIAGE_REPO = "DEFT_TRIAGE_REPO";
-/** PROJECT-DEFINITION vBRIEF location for typed-policy lookup. */
-export declare const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+/** PROJECT-DEFINITION xBRIEF location for typed-policy lookup. */
+export declare const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 /** Default queue limit when `--limit` is omitted on the CLI surface. */
 export declare const DEFAULT_QUEUE_LIMIT = 25;
 /** Default audit log path relative to the deft framework root (candidates_log.REPO_ROOT). */
-export declare const DEFAULT_AUDIT_LOG_REL_PATH = "vbrief/.eval/candidates.jsonl";
+export declare const DEFAULT_AUDIT_LOG_REL_PATH = "xbrief/.triage-cache/candidates.jsonl";
 /** Default slices log path relative to project root. */
-export declare const DEFAULT_SLICES_LOG_REL_PATH = "vbrief/.eval/slices.jsonl";
+export declare const DEFAULT_SLICES_LOG_REL_PATH = "xbrief/.triage-cache/slices.jsonl";
 /** Group display order (#1128 / D13 / #1286). */
 export declare const GROUP_ORDER: readonly ["ORPHAN", "RESUME", "URGENT", "untriaged", "other", "BLOCKED"];
 export type QueueGroup = (typeof GROUP_ORDER)[number];

package/dist/triage/queue/constants.js

@@ -4,14 +4,14 @@ export const CACHE_DIR_NAME = ".deft-cache";
 export const CACHE_SOURCE_GITHUB_ISSUE = "github-issue";
 /** Env var honoured for repo inference when `--repo` is absent (#1238). */
 export const ENV_TRIAGE_REPO = "DEFT_TRIAGE_REPO";
-/** PROJECT-DEFINITION vBRIEF location for typed-policy lookup. */
-export const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+/** PROJECT-DEFINITION xBRIEF location for typed-policy lookup. */
+export const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 /** Default queue limit when `--limit` is omitted on the CLI surface. */
 export const DEFAULT_QUEUE_LIMIT = 25;
 /** Default audit log path relative to the deft framework root (candidates_log.REPO_ROOT). */
-export const DEFAULT_AUDIT_LOG_REL_PATH = "vbrief/.eval/candidates.jsonl";
+export const DEFAULT_AUDIT_LOG_REL_PATH = "xbrief/.triage-cache/candidates.jsonl";
 /** Default slices log path relative to project root. */
-export const DEFAULT_SLICES_LOG_REL_PATH = "vbrief/.eval/slices.jsonl";
+export const DEFAULT_SLICES_LOG_REL_PATH = "xbrief/.triage-cache/slices.jsonl";
 /** Group display order (#1128 / D13 / #1286). */
 export const GROUP_ORDER = ["ORPHAN", "RESUME", "URGENT", "untriaged", "other", "BLOCKED"];
 /** Display labels per group (left-of-issue marker). */

package/dist/triage/queue/scope-walk.js

@@ -113,7 +113,13 @@ export function scopeIsBlocked(plan, completedIds) {
     return deps.length > 0 && deps.some((dep) => !completedIds.has(dep));
 }
 function walkScopeFolders(projectRoot, folders, visitor) {
-    const base = resolveLifecycleRoot(projectRoot);
+    let base;
+    try {
+        base = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        return; // No xbrief/ layout present -- nothing to walk.
+    }
     for (const folder of folders) {
         const folderDir = join(base, folder);
         if (!existsSync(folderDir)) {