@deftai/directive-core 0.72.0 → 0.73.0

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/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/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)) {

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, "\\'")}'`;