@deftai/directive-core 0.71.1 → 0.73.0

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/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/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: [] } },
             });

package/dist/vbrief-reconcile/umbrellas.js

@@ -333,7 +333,22 @@ export function nowIso(date = new Date()) {
 }
 export function reconcileUmbrellas(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-validate/main.js

@@ -42,7 +42,19 @@ export function runValidate(argv) {
             return 2;
         }
     }
-    const resolvedDir = vbriefDir ?? resolveLifecycleLayout(projectRoot ?? process.cwd()).root;
+    let resolvedDir;
+    if (vbriefDir !== null) {
+        resolvedDir = vbriefDir;
+    }
+    else {
+        try {
+            resolvedDir = resolveLifecycleLayout(projectRoot ?? process.cwd()).root;
+        }
+        catch {
+            process.stdout.write(`OK: No xbrief/ layout found at ${projectRoot ?? process.cwd()} -- skipping validation\n`);
+            return 0;
+        }
+    }
     if (!existsSync(resolvedDir)) {
         process.stdout.write(`OK: No vbrief directory at ${resolvedDir} -- skipping validation\n`);
         return 0;

package/dist/vbrief-validate/precutover.js

@@ -8,7 +8,14 @@ export { DEPRECATION_SENTINEL as DEPRECATED_REDIRECT_SENTINEL };
 const DEPRECATION_REDIRECT_PURPOSE = "<!-- Purpose: deprecation redirect -->";
 const LIFECYCLE_FOLDERS = ["proposed", "pending", "active", "completed", "cancelled"];
 export function missingLifecycleFolders(projectRoot) {
-    const lifecycleRoot = resolveLifecycleRoot(projectRoot);
+    let lifecycleRoot;
+    try {
+        lifecycleRoot = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        // No xbrief/ layout present -- all lifecycle folders are missing.
+        return [...LIFECYCLE_FOLDERS];
+    }
     return LIFECYCLE_FOLDERS.filter((folder) => !existsSync(join(lifecycleRoot, folder)));
 }
 function hasCompleteLifecycle(projectRoot) {
@@ -20,9 +27,15 @@ export function isDeprecationRedirect(content) {
 }
 /** Full-spec generated export (layout-resolved specification artifact source line). */
 export function isGeneratedSpecificationExport(projectRoot, content) {
-    return (content.includes(GENERATED_SPEC_PURPOSE) &&
-        contentHasGeneratedSpecSource(content) &&
-        existsSync(resolveSpecArtifactPath(projectRoot)));
+    if (!content.includes(GENERATED_SPEC_PURPOSE) || !contentHasGeneratedSpecSource(content)) {
+        return false;
+    }
+    try {
+        return existsSync(resolveSpecArtifactPath(projectRoot));
+    }
+    catch {
+        return false;
+    }
 }
 /** Return true for a fully current generated spec export (full-spec or greenfield). */
 export function isCurrentGeneratedSpecification(projectRoot, content) {
@@ -91,7 +104,22 @@ export function detectPreCutover(projectRoot) {
             reasons.push("PROJECT.md is a pre-v0.20 hand-authored doc (not a deprecation redirect)");
         }
     }
-    const layout = resolveLifecycleLayout(projectRoot);
+    // Since #2112, resolveLifecycleLayout throws when no xbrief/ layout is present.
+    // Catch that error so the doctor can still diagnose pre-cutover state on unmigrated trees.
+    // However, an empty (greenfield) directory with no pre-cutover artifacts is NOT pre-cutover.
+    let layout = null;
+    try {
+        layout = resolveLifecycleLayout(projectRoot);
+    }
+    catch {
+        // No xbrief/ layout found. Only report a pre-cutover reason if legacy artifacts
+        // (SPECIFICATION.md / PROJECT.md) were already detected above; a bare empty directory
+        // without any artifacts is greenfield, not pre-cutover.
+        if (reasons.length > 0) {
+            reasons.push("xbrief/ lifecycle layout not found -- run `deft migrate:xbrief` first");
+        }
+        return { preCutover: reasons.length > 0, reasons };
+    }
     if (existsSync(layout.root)) {
         const missing = missingLifecycleFolders(projectRoot);
         if (missing.length > 0) {

package/dist/vbrief-validate/staleness.d.ts

@@ -1,3 +1,3 @@
-/** Warn if PRD.md or SPECIFICATION.md are stale relative to specification.vbrief.json (#398). */
+/** Warn if PRD.md or SPECIFICATION.md are stale relative to the spec artifact (#398). */
 export declare function checkRenderStaleness(vbriefDir: string): string[];
 //# sourceMappingURL=staleness.d.ts.map

package/dist/vbrief-validate/staleness.js

@@ -66,11 +66,14 @@ function checkSpecStaleness(specMdPath, narratives, items, title) {
     }
     return [];
 }
-/** Warn if PRD.md or SPECIFICATION.md are stale relative to specification.vbrief.json (#398). */
+/** Warn if PRD.md or SPECIFICATION.md are stale relative to the spec artifact (#398). */
 export function checkRenderStaleness(vbriefDir) {
     const warnings = [];
     const projectRoot = join(vbriefDir, "..");
-    const specPath = join(vbriefDir, "specification.vbrief.json");
+    // Prefer the migrated xbrief artifact; fall back to the legacy vbrief artifact.
+    const specPath = existsSync(join(vbriefDir, "specification.xbrief.json"))
+        ? join(vbriefDir, "specification.xbrief.json")
+        : join(vbriefDir, "specification.vbrief.json");
     if (!existsSync(specPath)) {
         return warnings;
     }

package/dist/verify-source/code-structure-validate.js

@@ -545,7 +545,13 @@ export function discoverCodeStructurePaths(projectRoot) {
             paths.set(projectDef.replace(/\\/g, "/"), projectDef);
         }
     }
-    const vbriefRoot = resolveLifecycleRoot(projectRoot);
+    let vbriefRoot;
+    try {
+        vbriefRoot = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        return [...paths.values()];
+    }
     if (existsSync(vbriefRoot)) {
         const stack = [vbriefRoot];
         while (stack.length > 0) {

package/dist/xbrief-migrate/signpost.d.ts

@@ -2,10 +2,10 @@
 export declare function xbriefMigrationGuidance(): string;
 /**
  * One-line doctor / ritual signpost mirroring `renderPrecutoverLine` (#2110),
- * reporting an unambiguous convergence state (#2270). A migrated project reads
- * as `xbrief active` plus either `vbrief legacy marker` or `vbrief removed`; a
- * stray empty legacy root is called out as a pending convergence rather than a
- * generic "run migrate" dead end — never a dual-empty-root ambiguity.
+ * reporting an unambiguous convergence state (#2270 / #2112). As of #2112
+ * (0.73.0 MINOR), the legacy vbrief read path is removed; the `legacy-only` and
+ * `dual-populated` states are still reported here so the doctor can direct
+ * unmigrated-project operators to `deft migrate:xbrief` before the engine runs.
  */
 export declare function renderXbriefMigrationLine(projectRoot: string): string;
 //# sourceMappingURL=signpost.d.ts.map

package/dist/xbrief-migrate/signpost.js

@@ -1,14 +1,14 @@
-import { detectLegacyVbriefLayout, detectXbriefConvergence } from "./detect.js";
+import { detectXbriefConvergence } from "./detect.js";
 /** Operator guidance for the TS-native xbrief rename (#2034 / #2110). */
 export function xbriefMigrationGuidance() {
     return "Run `deft migrate:xbrief` (or `task migrate:xbrief`) to convert vbrief/ to xbrief/ safely.";
 }
 /**
  * One-line doctor / ritual signpost mirroring `renderPrecutoverLine` (#2110),
- * reporting an unambiguous convergence state (#2270). A migrated project reads
- * as `xbrief active` plus either `vbrief legacy marker` or `vbrief removed`; a
- * stray empty legacy root is called out as a pending convergence rather than a
- * generic "run migrate" dead end — never a dual-empty-root ambiguity.
+ * reporting an unambiguous convergence state (#2270 / #2112). As of #2112
+ * (0.73.0 MINOR), the legacy vbrief read path is removed; the `legacy-only` and
+ * `dual-populated` states are still reported here so the doctor can direct
+ * unmigrated-project operators to `deft migrate:xbrief` before the engine runs.
  */
 export function renderXbriefMigrationLine(projectRoot) {
     const convergence = detectXbriefConvergence(projectRoot);
@@ -16,19 +16,15 @@ export function renderXbriefMigrationLine(projectRoot) {
     if (convergence.state === "xbrief-marker") {
         return "xBrief migration: converged -- xbrief active, vbrief legacy marker (read-compat).";
     }
-    // Ambiguous dual-empty root: canonical xbrief/ (or none) plus a stray empty vbrief/.
+    // Ambiguous: canonical xbrief/ (or none) plus a stray empty vbrief/.
     if (convergence.state === "empty-vbrief") {
         return `xBrief migration: converge pending -- xbrief active, empty legacy vbrief/ present. ${xbriefMigrationGuidance()}`;
     }
-    const { legacyLayout, reasons } = detectLegacyVbriefLayout(projectRoot);
-    if (!legacyLayout) {
-        return "xBrief migration: none -- xbrief active, vbrief removed.";
+    // Unmigrated: only vbrief/ found, or both roots populated without a marker.
+    if (convergence.state === "legacy-only" || convergence.state === "dual-populated") {
+        return `xBrief migration: migrate required -- ${convergence.state === "legacy-only" ? "only vbrief/ found, no xbrief/ layout" : "both vbrief/ and xbrief/ found without a migration marker"}. ${xbriefMigrationGuidance()}`;
     }
-    const maxReasons = 3;
-    const shown = reasons.slice(0, maxReasons);
-    const remainder = reasons.length - shown.length;
-    const summary = shown.join("; ").replace(/\r?\n/g, " ");
-    const tail = remainder > 0 ? `${summary}; …and ${remainder} more marker(s)` : summary;
-    return `xBrief migration: legacy vbrief layout detected -- ${tail}. ${xbriefMigrationGuidance()}`;
+    // Fully migrated: xbrief active, no legacy vbrief/ present (or empty root with no content).
+    return "xBrief migration: none -- xbrief active, vbrief removed.";
 }
 //# sourceMappingURL=signpost.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.71.1",
+  "version": "0.73.0",
   "description": "TypeScript engine core for the Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -281,8 +281,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.71.1",
-    "@deftai/directive-types": "^0.71.1",
+    "@deftai/directive-content": "^0.73.0",
+    "@deftai/directive-types": "^0.73.0",
     "archiver": "^8.0.0"
   },
   "scripts": {