@deftai/directive-core 0.72.0 → 0.73.1

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.72.0",
+  "version": "0.73.1",
   "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.72.0",
-    "@deftai/directive-types": "^0.72.0",
+    "@deftai/directive-content": "^0.73.1",
+    "@deftai/directive-types": "^0.73.1",
     "archiver": "^8.0.0"
   },
   "scripts": {