@deftai/directive 0.66.0 → 0.66.2

package/dist/doctor.d.ts

@@ -1,3 +1,5 @@
 #!/usr/bin/env node
+/** Advisory when a consumer deposit carries git-vendored framework source (#2142). */
+export declare function renderStrayPackagesAdvisoryLine(projectRoot: string): string;
 export declare function run(argv: string[]): number;
 //# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.js

@@ -1,9 +1,21 @@
 #!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { parseDoctorFlags } from "@deftai/directive-core/dist/doctor/flags.js";
 import { cmdDoctor } from "@deftai/directive-core/dist/doctor/main.js";
 import { renderPrecutoverLine } from "@deftai/directive-core/dist/vbrief-validate/precutover.js";
 import { renderXbriefMigrationLine } from "@deftai/directive-core/xbrief-migrate";
+/** Advisory when a consumer deposit carries git-vendored framework source (#2142). */
+export function renderStrayPackagesAdvisoryLine(projectRoot) {
+    const packagesDir = join(projectRoot, ".deft", "core", "packages");
+    if (!existsSync(packagesDir)) {
+        return "Deposit hygiene: none -- .deft/core contains no stray packages/ source tree.";
+    }
+    return ("Deposit hygiene: advisory -- .deft/core/packages/ is present (git-vendored framework source, " +
+        "not shipped by npm @deftai/directive-content). Upgrade directive to pick up task guard fixes; " +
+        "consider removing the stray tree from version control.");
+}
 export function run(argv) {
     // #2022: surface pre-cutover (pre-v0.20 document model) migration state alongside the
     // core doctor report. Only emit on a valid, human-readable invocation: suppressed under
@@ -14,6 +26,7 @@ export function run(argv) {
         const projectRoot = flags.projectRoot ?? process.cwd();
         process.stdout.write(`${renderPrecutoverLine(projectRoot)}\n`);
         process.stdout.write(`${renderXbriefMigrationLine(projectRoot)}\n`);
+        process.stdout.write(`${renderStrayPackagesAdvisoryLine(projectRoot)}\n`);
     }
     return cmdDoctor(argv);
 }

package/dist/migrate-preflight.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { resolveFrameworkRootForProject } from "@deftai/directive-core/doctor";
 import { emitMigratePreflight, runMigratePreflight, } from "@deftai/directive-core/migrate-preflight";
 export function parseArgs(argv) {
     let projectRoot = ".";
-    let deftRoot = resolve(import.meta.dirname, "..", "..", "..");
+    let explicitDeftRoot;
     let quiet = false;
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i] ?? "";
@@ -16,7 +16,7 @@ export function parseArgs(argv) {
             if (value === undefined) {
                 return {
                     projectRoot,
-                    deftRoot,
+                    deftRoot: resolveFrameworkRootForProject(projectRoot, explicitDeftRoot),
                     quiet,
                     error: "argument --project-root: expected one argument",
                 };
@@ -32,26 +32,27 @@ export function parseArgs(argv) {
             if (value === undefined) {
                 return {
                     projectRoot,
-                    deftRoot,
+                    deftRoot: resolveFrameworkRootForProject(projectRoot, explicitDeftRoot),
                     quiet,
                     error: "argument --deft-root: expected one argument",
                 };
             }
-            deftRoot = value;
+            explicitDeftRoot = value;
             i += 1;
         }
         else if (arg.startsWith("--deft-root=")) {
-            deftRoot = arg.slice("--deft-root=".length);
+            explicitDeftRoot = arg.slice("--deft-root=".length);
         }
         else {
-            return { projectRoot, deftRoot, quiet, error: `unrecognized argument: ${arg}` };
+            return {
+                projectRoot,
+                deftRoot: resolveFrameworkRootForProject(projectRoot, explicitDeftRoot),
+                quiet,
+                error: `unrecognized argument: ${arg}`,
+            };
         }
     }
-    if (process.env.DEFT_ROOT &&
-        process.env.DEFT_ROOT.length > 0 &&
-        !argv.some((a) => a.startsWith("--deft-root"))) {
-        deftRoot = process.env.DEFT_ROOT;
-    }
+    const deftRoot = resolveFrameworkRootForProject(projectRoot, explicitDeftRoot);
     return { projectRoot, deftRoot, quiet };
 }
 export function run(argv) {

package/dist/migrate-xbrief.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { resolveFrameworkRootForProject } from "@deftai/directive-core/doctor";
 import { runXbriefMigrationCli } from "@deftai/directive-core/xbrief-migrate";
 export function parseArgs(argv) {
     let projectRoot = ".";
-    let frameworkRoot = resolve(import.meta.dirname, "..", "..", "..");
+    let explicitFrameworkRoot;
     let force = false;
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i] ?? "";
@@ -16,7 +16,7 @@ export function parseArgs(argv) {
             if (value === undefined) {
                 return {
                     projectRoot,
-                    frameworkRoot,
+                    frameworkRoot: resolveFrameworkRootForProject(projectRoot, explicitFrameworkRoot),
                     force,
                     error: "argument --project-root: expected one argument",
                 };
@@ -32,24 +32,27 @@ export function parseArgs(argv) {
             if (value === undefined) {
                 return {
                     projectRoot,
-                    frameworkRoot,
+                    frameworkRoot: resolveFrameworkRootForProject(projectRoot, explicitFrameworkRoot),
                     force,
                     error: "argument --framework-root: expected one argument",
                 };
             }
-            frameworkRoot = value;
+            explicitFrameworkRoot = value;
             i += 1;
         }
         else if (arg.startsWith("--framework-root=")) {
-            frameworkRoot = arg.slice("--framework-root=".length);
+            explicitFrameworkRoot = arg.slice("--framework-root=".length);
         }
         else {
-            return { projectRoot, frameworkRoot, force, error: `unrecognized argument: ${arg}` };
+            return {
+                projectRoot,
+                frameworkRoot: resolveFrameworkRootForProject(projectRoot, explicitFrameworkRoot),
+                force,
+                error: `unrecognized argument: ${arg}`,
+            };
         }
     }
-    if (process.env.DEFT_ROOT && process.env.DEFT_ROOT.length > 0) {
-        frameworkRoot = process.env.DEFT_ROOT;
-    }
+    const frameworkRoot = resolveFrameworkRootForProject(projectRoot, explicitFrameworkRoot);
     return { projectRoot, frameworkRoot, force };
 }
 export function run(argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.66.0",
+  "version": "0.66.2",
   "description": "Directive CLI — npm install path for the Deft Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,8 +31,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-core": "^0.66.0",
-    "@deftai/directive-content": "^0.66.0"
+    "@deftai/directive-core": "^0.66.2",
+    "@deftai/directive-content": "^0.66.2"
   },
   "scripts": {
     "build": "tsc -b"