@deftai/directive-core 0.84.0 → 0.86.0

package/dist/xbrief-migrate/migrate-project.js

@@ -1,9 +1,10 @@
 import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
+import { assertWriteTargetSafe, ProjectionContainmentError } from "../fs/projection-containment.js";
 import { checkGitClean } from "../migrate-preflight/index.js";
-import { agentsRefreshPlan } from "../platform/agents-md.js";
+import { applyAgentsRefresh } from "../platform/agents-md.js";
 import { patchAgentsMdHeader, renderHeaderPatchSummary } from "./agents-header.js";
-import { LEGACY_ARTIFACT_DIR, LEGACY_ARTIFACT_SUFFIX, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, VBRIEF_DEPRECATION_MARKER_BODY, VBRIEF_DEPRECATION_MARKER_FILENAME, } from "./constants.js";
+import { LEGACY_ARTIFACT_DIR, LEGACY_ARTIFACT_SUFFIX, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, OBSOLETE_FRAMEWORK_NARRATIVE_FILENAME, VBRIEF_DEPRECATION_MARKER_BODY, VBRIEF_DEPRECATION_MARKER_FILENAME, } from "./constants.js";
 import { detectLegacyVbriefLayout, detectXbriefConvergence } from "./detect.js";
 import { hasVbriefDeprecationMarker, isDirectory, isEffectivelyEmptyDir } from "./fs-helpers.js";
 import { assertMigrationSourceSafe } from "./migration-containment.js";
@@ -24,6 +25,21 @@ function collectFiles(root, acc = []) {
     }
     return acc;
 }
+/** True when a legacy lifecycle file is an obsolete framework narrative (#2806). */
+export function shouldOmitLegacyMigrationFile(relativePath) {
+    return relativePath.replace(/\\/g, "/") === OBSOLETE_FRAMEWORK_NARRATIVE_FILENAME;
+}
+/**
+ * Remove a stale `xbrief/vbrief.md` left by an earlier migrate:xbrief run.
+ * Project JSON records and `xbrief/schemas/` are untouched (#2806).
+ */
+export function removeStaleMigratedFrameworkNarrative(projectRoot) {
+    const stale = join(projectRoot, MIGRATED_ARTIFACT_DIR, OBSOLETE_FRAMEWORK_NARRATIVE_FILENAME);
+    if (!existsSync(stale))
+        return false;
+    rmSync(stale, { force: true });
+    return true;
+}
 function mapRelativePath(relativePath) {
     return relativePath
         .split(/[/\\]/)
@@ -81,6 +97,8 @@ function migrateLegacyTree(projectRoot, legacyDir, options) {
     try {
         for (const srcPath of files) {
             const rel = relative(legacyDir, srcPath);
+            if (shouldOmitLegacyMigrationFile(rel))
+                continue;
             const destPath = join(stagedDir, mapRelativePath(rel));
             writeMigratedFile(srcPath, destPath);
         }
@@ -140,25 +158,33 @@ function renameOrReplace(src, dest) {
     rmSync(src, { recursive: true, force: true });
 }
 function runAgentsRefresh(projectRoot, frameworkRoot, io) {
-    const plan = agentsRefreshPlan(projectRoot, { frameworkRoot });
-    const state = String(plan.state ?? "unknown");
-    if (state === "current") {
-        io.writeOut("AGENTS.md managed section is current — no changes.\n");
+    try {
+        assertWriteTargetSafe(projectRoot, join(projectRoot, "AGENTS.md"));
+        const { state, wrote, writable } = applyAgentsRefresh(projectRoot, {}, { frameworkRoot });
+        if (state === "current") {
+            io.writeOut("AGENTS.md managed section is current — no changes.\n");
+            return 0;
+        }
+        if (state === "template-missing" || state === "template-malformed" || state === "unreadable") {
+            io.writeErr(`agents:refresh failed: ${state}\n`);
+            return 2;
+        }
+        if (!writable) {
+            io.writeErr("agents:refresh failed: plan produced no new_content\n");
+            return 2;
+        }
+        if (wrote) {
+            io.writeOut(`AGENTS.md updated (state=${state}).\n`);
+        }
         return 0;
     }
-    if (state === "template-missing" || state === "template-malformed" || state === "unreadable") {
-        io.writeErr(`agents:refresh failed: ${state}\n`);
-        return 2;
-    }
-    const newContent = plan.new_content;
-    if (typeof newContent !== "string") {
-        io.writeErr("agents:refresh failed: plan produced no new_content\n");
-        return 2;
+    catch (err) {
+        if (err instanceof ProjectionContainmentError) {
+            io.writeErr(`agents:refresh failed: ${err.message}\n`);
+            return 2;
+        }
+        throw err;
     }
-    const path = String(plan.path ?? join(projectRoot, "AGENTS.md"));
-    writeFileSync(path, newContent, "utf8");
-    io.writeOut(`AGENTS.md updated (state=${state}).\n`);
-    return 0;
 }
 /** Core orchestrator for the consumer xbrief rename (#2110) + convergence (#2270). */
 export function runXbriefMigration(args, _io) {

package/package.json

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