@deftai/directive-core 0.77.0 → 0.79.0

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

@@ -6,6 +6,7 @@ import { patchAgentsMdHeader, renderHeaderPatchSummary } from "./agents-header.j
 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 { detectLegacyVbriefLayout, detectXbriefConvergence } from "./detect.js";
 import { hasVbriefDeprecationMarker, isDirectory, isEffectivelyEmptyDir } from "./fs-helpers.js";
+import { assertMigrationSourceSafe } from "./migration-containment.js";
 import { renderXbriefMigrationLine, xbriefMigrationGuidance } from "./signpost.js";
 import { rewriteEmbeddedTokens, transformArtifactV06ToV08Transactional } from "./transforms.js";
 function collectFiles(root, acc = []) {
@@ -45,19 +46,32 @@ function writeMigratedFile(srcPath, destPath) {
     const raw = readFileSync(srcPath, "utf8");
     writeFileSync(destPath, rewriteEmbeddedTokens(raw), "utf8");
 }
-function backupLegacyTree(projectRoot, legacyDir) {
+function backupMigrationInputs(projectRoot, legacyDir, migratedDir) {
     const stamp = new Date().toISOString().replace(/[:.]/g, "-");
     const backupRoot = join(projectRoot, ".deft", `xbrief-migrate-backup-${stamp}`);
     mkdirSync(backupRoot, { recursive: true });
     cpSync(legacyDir, join(backupRoot, LEGACY_ARTIFACT_DIR), { recursive: true });
+    if (existsSync(migratedDir)) {
+        cpSync(migratedDir, join(backupRoot, MIGRATED_ARTIFACT_DIR), { recursive: true });
+    }
     return backupRoot;
 }
+/** Overlay the already-canonical cache last so it wins collisions. */
+function overlayCanonicalTriageCache(migratedDir, stagedDir) {
+    const source = join(migratedDir, ".triage-cache");
+    if (!isDirectory(source))
+        return;
+    cpSync(source, join(stagedDir, ".triage-cache"), { recursive: true, force: true });
+}
 function migrateLegacyTree(projectRoot, legacyDir, options) {
     const migratedDir = join(projectRoot, MIGRATED_ARTIFACT_DIR);
-    if (existsSync(migratedDir)) {
-        throw new Error(`refusing to migrate: '${MIGRATED_ARTIFACT_DIR}/' already exists alongside '${LEGACY_ARTIFACT_DIR}/'`);
+    const convergence = detectXbriefConvergence(projectRoot);
+    const hasCanonicalCache = isDirectory(join(migratedDir, ".triage-cache"));
+    if (existsSync(migratedDir) && (convergence.xbriefHasContent || !hasCanonicalCache)) {
+        throw new Error(`refusing to migrate: '${MIGRATED_ARTIFACT_DIR}/' already exists alongside '${LEGACY_ARTIFACT_DIR}/' and is not a cache-only support tree`);
     }
-    const backupDir = backupLegacyTree(projectRoot, legacyDir);
+    assertMigrationSourceSafe(projectRoot, legacyDir);
+    const backupDir = backupMigrationInputs(projectRoot, legacyDir, migratedDir);
     const stagedDir = join(projectRoot, `.${MIGRATED_ARTIFACT_DIR}.migrate-staging`);
     if (existsSync(stagedDir)) {
         rmSync(stagedDir, { recursive: true, force: true });
@@ -70,6 +84,7 @@ function migrateLegacyTree(projectRoot, legacyDir, options) {
             const destPath = join(stagedDir, mapRelativePath(rel));
             writeMigratedFile(srcPath, destPath);
         }
+        overlayCanonicalTriageCache(migratedDir, stagedDir);
         renameOrReplace(stagedDir, migratedDir);
         // Converge to a single unambiguous root: the fully-migrated legacy tree is
         // either removed (default) or retained for read-compat behind an explicit

package/dist/xbrief-migrate/migration-containment.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Refuse migrate:xbrief when legacy `vbrief/` (or any traversed entry) escapes
+ * the project tree via symlinks (#2601).
+ */
+export declare function assertMigrationSourceSafe(projectRoot: string, legacyDir: string): void;
+//# sourceMappingURL=migration-containment.d.ts.map

package/dist/xbrief-migrate/migration-containment.js

@@ -0,0 +1,37 @@
+import { lstatSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { assertProjectionContained } from "../fs/projection-containment.js";
+/**
+ * Refuse migrate:xbrief when legacy `vbrief/` (or any traversed entry) escapes
+ * the project tree via symlinks (#2601).
+ */
+export function assertMigrationSourceSafe(projectRoot, legacyDir) {
+    assertProjectionContained(projectRoot, legacyDir);
+    walkMigrationTreeRejectSymlinks(legacyDir);
+}
+function walkMigrationTreeRejectSymlinks(root) {
+    let entries;
+    try {
+        entries = readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const full = join(root, entry.name);
+        let info;
+        try {
+            info = lstatSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (info.isSymbolicLink()) {
+            throw new Error(`refusing to migrate: symlink on migration path: ${full}`);
+        }
+        if (info.isDirectory()) {
+            walkMigrationTreeRejectSymlinks(full);
+        }
+    }
+}
+//# sourceMappingURL=migration-containment.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.77.0",
+  "version": "0.79.0",
   "description": "TypeScript engine core for the Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,6 +42,10 @@
       "types": "./dist/eval-health-relocation/index.d.ts",
       "default": "./dist/eval-health-relocation/index.js"
     },
+    "./eval-triggers-relocation": {
+      "types": "./dist/eval-triggers-relocation/index.d.ts",
+      "default": "./dist/eval-triggers-relocation/index.js"
+    },
     "./xbrief-migrate": {
       "types": "./dist/xbrief-migrate/index.d.ts",
       "default": "./dist/xbrief-migrate/index.js"
@@ -62,6 +66,10 @@
       "types": "./dist/session/index.d.ts",
       "default": "./dist/session/index.js"
     },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "default": "./dist/hooks/index.js"
+    },
     "./plan-sequence": {
       "types": "./dist/plan-sequence/index.d.ts",
       "default": "./dist/plan-sequence/index.js"
@@ -106,6 +114,10 @@
       "types": "./dist/eval/run.d.ts",
       "default": "./dist/eval/run.js"
     },
+    "./eval/triggers": {
+      "types": "./dist/eval/triggers.d.ts",
+      "default": "./dist/eval/triggers.js"
+    },
     "./eval/report": {
       "types": "./dist/eval/report.d.ts",
       "default": "./dist/eval/report.js"
@@ -266,6 +278,10 @@
       "types": "./dist/umbrella-current-shape/index.d.ts",
       "default": "./dist/umbrella-current-shape/index.js"
     },
+    "./issue-sync": {
+      "types": "./dist/issue-sync/index.d.ts",
+      "default": "./dist/issue-sync/index.js"
+    },
     "./task-surface": {
       "types": "./dist/task-surface/index.d.ts",
       "default": "./dist/task-surface/index.js"
@@ -289,8 +305,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.77.0",
-    "@deftai/directive-types": "^0.77.0",
+    "@deftai/directive-content": "^0.79.0",
+    "@deftai/directive-types": "^0.79.0",
     "archiver": "^8.0.0"
   },
   "scripts": {