@deftai/directive-core 0.105.0 → 0.107.0

package/dist/xbrief-migrate/agents-header.js

@@ -6,14 +6,14 @@ import { MIGRATED_ARTIFACT_DIR } from "./constants.js";
 import { isDirectory } from "./fs-helpers.js";
 /**
  * Bounded, ordered set of legacy crossover tokens rewritten in the UNMANAGED
- * region of a consumer AGENTS.md after `migrate:xbrief` (#2154 / Option A).
+ * region of a consumer AGENTS.md after `migrate:xbrief` (#2154 / Option A / #3637).
  *
  * Each entry is a mechanical path / verb literal — NOT freeform prose. The
  * casing-only `vBRIEF format` product-description token from the issue table is
- * intentionally excluded so freeform prose survives untouched. The tokens are
- * disjoint substrings (`.vbrief.json` has no trailing slash, `vbrief:preflight`
- * uses a colon, `vbrief/` requires a slash), so replacement order does not
- * change the result and a second pass is a guaranteed no-op (idempotent).
+ * intentionally excluded so freeform prose survives untouched. `.vbrief.json`
+ * and `vbrief:preflight` are substring hits. `vbrief/` is left-bound and only
+ * a hard hit when a child segment follows (`vbrief/active/...`); bare
+ * `vbrief/` and `x-vbrief/` are not rewritten. A second pass is a no-op.
  */
 /** Refuse migrate header writes that escape via repo-controlled symlinks (#2668). */
 function projectionTarget(projectDir, ...relSegments) {
@@ -26,6 +26,8 @@ export const LEGACY_HEADER_TOKENS = [
     { legacy: "vbrief:preflight", migrated: "xbrief:preflight" },
     { legacy: "vbrief/", migrated: "xbrief/" },
 ];
+const VBRIEF_DIR = "vbrief/";
+const XBRIEF_DIR = "xbrief/";
 function countOccurrences(haystack, needle) {
     if (needle.length === 0)
         return 0;
@@ -37,10 +39,70 @@ function countOccurrences(haystack, needle) {
     }
     return count;
 }
+/** `x-vbrief/` is not a `vbrief/` hit; ident/hyphen continue the token. */
+function isLeftBoundAt(text, index) {
+    if (index === 0)
+        return true;
+    return !/[A-Za-z0-9_-]/.test(text[index - 1]);
+}
+/** Child path segment after `vbrief/` — not whitespace, fence close, or EOS. */
+function hasVbriefChildSegment(text, index) {
+    const after = index + VBRIEF_DIR.length;
+    if (after >= text.length)
+        return false;
+    const ch = text[after];
+    return ch !== "/" && ch !== "`" && !/\s/.test(ch);
+}
+function isHardVbriefDirHit(text, index) {
+    return isLeftBoundAt(text, index) && hasVbriefChildSegment(text, index);
+}
+function hasHardVbriefDirHit(text) {
+    let index = text.indexOf(VBRIEF_DIR);
+    while (index !== -1) {
+        if (isHardVbriefDirHit(text, index))
+            return true;
+        index = text.indexOf(VBRIEF_DIR, index + VBRIEF_DIR.length);
+    }
+    return false;
+}
+/** Rewrite left-bound `vbrief/` + child; leave bare `vbrief/` and `x-vbrief/`. */
+function rewriteLeftBoundVbriefDir(slice) {
+    let out = "";
+    let cursor = 0;
+    let count = 0;
+    let index = slice.indexOf(VBRIEF_DIR);
+    while (index !== -1) {
+        out += slice.slice(cursor, index);
+        if (isHardVbriefDirHit(slice, index)) {
+            out += XBRIEF_DIR;
+            count += 1;
+        }
+        else {
+            out += VBRIEF_DIR;
+        }
+        cursor = index + VBRIEF_DIR.length;
+        index = slice.indexOf(VBRIEF_DIR, cursor);
+    }
+    out += slice.slice(cursor);
+    return { next: out, count };
+}
+function unmanagedHitsLegacyToken(unmanaged, legacy) {
+    if (legacy === VBRIEF_DIR)
+        return hasHardVbriefDirHit(unmanaged);
+    return unmanaged.includes(legacy);
+}
 /** Rewrite the bounded legacy tokens inside a single unmanaged text slice. */
 function rewriteSlice(slice, tally) {
     let next = slice;
     for (const { legacy, migrated } of LEGACY_HEADER_TOKENS) {
+        if (legacy === VBRIEF_DIR) {
+            const rewritten = rewriteLeftBoundVbriefDir(next);
+            if (rewritten.count === 0)
+                continue;
+            tally.set(legacy, (tally.get(legacy) ?? 0) + rewritten.count);
+            next = rewritten.next;
+            continue;
+        }
         const occurrences = countOccurrences(next, legacy);
         if (occurrences === 0)
             continue;
@@ -172,7 +234,7 @@ export function detectStaleUnmanagedHeader(projectRoot, readText = (path) => {
         cursor = end;
     }
     unmanaged += content.slice(cursor);
-    const matches = LEGACY_HEADER_TOKENS.filter((t) => unmanaged.includes(t.legacy)).map((t) => t.legacy);
+    const matches = LEGACY_HEADER_TOKENS.filter((t) => unmanagedHitsLegacyToken(unmanaged, t.legacy)).map((t) => t.legacy);
     return { stale: matches.length > 0, matches };
 }
 /** One-line doctor / ritual signpost for the #2154 stale-header regression. */
@@ -183,6 +245,6 @@ export function renderStaleHeaderLine(projectRoot, readText) {
     }
     return (`AGENTS.md header drift: xbrief/ tree present but the unmanaged AGENTS.md header still ` +
         `references legacy token(s) ${matches.join(", ")}. ` +
-        "Run `deft migrate:xbrief` (idempotent) to rewrite them, or hand-edit the header.");
+        "Hand-edit the unmanaged header path literals.");
 }
 //# sourceMappingURL=agents-header.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.105.0",
+  "version": "0.107.0",
   "description": "TypeScript engine core for the Directive framework.",
   "license": "MIT",
   "type": "module",
@@ -283,6 +283,10 @@
       "types": "./dist/lifecycle/index.d.ts",
       "default": "./dist/lifecycle/index.js"
     },
+    "./lifecycle-visible": {
+      "types": "./dist/lifecycle-visible/index.d.ts",
+      "default": "./dist/lifecycle-visible/index.js"
+    },
     "./literal-acceptance": {
       "types": "./dist/literal-acceptance/index.d.ts",
       "default": "./dist/literal-acceptance/index.js"
@@ -382,8 +386,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.105.0",
-    "@deftai/directive-types": "^0.105.0",
+    "@deftai/directive-content": "^0.107.0",
+    "@deftai/directive-types": "^0.107.0",
     "archiver": "^8.0.0"
   },
   "scripts": {