@deftai/directive-core 0.58.0 → 0.59.0

package/dist/deposit/resolve-content.d.ts

@@ -22,6 +22,12 @@ export declare function contentPackageRootFromResolvedEntry(resolvedEntry: strin
 /**
  * Resolve the installed {@link CONTENT_PACKAGE_NAME} package root via Node module
  * resolution (`import.meta.resolve`).
+ *
+ * Resolves the package's `package.json` subpath rather than its bare specifier:
+ * the content package ships no entry point (no `main`, `exports`, or `index.js`),
+ * so a bare-specifier resolve throws. The `package.json` subpath always resolves,
+ * and {@link contentPackageRootFromResolvedEntry} walks up from it to the package
+ * root. Refs #2023.
  */
 export declare function resolveInstalledContentRoot(resolveSpecifier?: ResolveSpecifier): Promise<string>;
 export {};

package/dist/deposit/resolve-content.js

@@ -52,11 +52,17 @@ export function contentPackageRootFromResolvedEntry(resolvedEntry) {
 /**
  * Resolve the installed {@link CONTENT_PACKAGE_NAME} package root via Node module
  * resolution (`import.meta.resolve`).
+ *
+ * Resolves the package's `package.json` subpath rather than its bare specifier:
+ * the content package ships no entry point (no `main`, `exports`, or `index.js`),
+ * so a bare-specifier resolve throws. The `package.json` subpath always resolves,
+ * and {@link contentPackageRootFromResolvedEntry} walks up from it to the package
+ * root. Refs #2023.
  */
 export async function resolveInstalledContentRoot(resolveSpecifier = defaultResolveSpecifier) {
     let resolvedEntry;
     try {
-        resolvedEntry = await resolveSpecifier(CONTENT_PACKAGE_NAME);
+        resolvedEntry = await resolveSpecifier(`${CONTENT_PACKAGE_NAME}/package.json`);
     }
     catch (cause) {
         const detail = cause instanceof Error ? cause.message : String(cause);

package/dist/doctor/checks.js

@@ -253,7 +253,7 @@ export function checkInstallPathConsistency(projectRoot, installRoot, seams = {}
         return {
             name: "install-path-consistency",
             status: "fail",
-            detail: `Install root is recorded as '${effectiveInstallRoot}' (source: ${source}) but ${claimedDir} is not a directory. Pick one of two repair paths: (a) run \`.deft/core/run agents:refresh\` (Unix) / \`.deft\\core\\run agents:refresh\` (Windows) to rewrite AGENTS.md to match the on-disk framework -- pick this if the framework on disk is correct; OR (b) run \`task relocate:relocate -- --confirm\` to move the framework to the path AGENTS.md / the manifest claims -- pick this if AGENTS.md is correct. The YAML manifest (if present) is authoritative for the install-layout contract. See UPGRADING.md for the canonical drift-repair walkthrough.`,
+            detail: `Install root is recorded as '${effectiveInstallRoot}' (source: ${source}) but ${claimedDir} is not a directory. Pick one of two repair paths: (a) run \`.deft/core/run agents:refresh\` (Unix) / \`.deft\\core\\run agents:refresh\` (Windows) to rewrite AGENTS.md to match the on-disk framework -- pick this if the framework on disk is correct; OR (b) run \`npx @deftai/directive update\` to (re)deposit the framework at the path AGENTS.md / the manifest claims (the npm CLI project deposit, #1912) -- pick this if AGENTS.md is correct. The YAML manifest (if present) is authoritative for the install-layout contract. See UPGRADING.md for the canonical drift-repair walkthrough.`,
             data: {
                 claimed_install_root: installRoot,
                 effective_install_root: effectiveInstallRoot,
@@ -262,7 +262,7 @@ export function checkInstallPathConsistency(projectRoot, installRoot, seams = {}
                 claimed_dir_exists: false,
                 fallback_info_note: fallbackInfoNote || null,
                 suggested_fix: ".deft/core/run agents:refresh",
-                suggested_fix_alt: "task relocate:relocate -- --confirm",
+                suggested_fix_alt: "npx @deftai/directive update",
             },
         };
     }

package/dist/release/index.d.ts

@@ -5,9 +5,10 @@ export * from "./git.js";
 export * from "./main.js";
 export * from "./paths.js";
 export * from "./pipeline.js";
+export * from "./preflight.js";
 export * from "./pyproject.js";
 export * from "./pyproject-sync.js";
-export * from "./python-bridge.js";
+export * from "./python-steps.js";
 export * from "./spawn.js";
 export * from "./types.js";
 export * from "./version.js";

package/dist/release/index.js

@@ -6,9 +6,10 @@ export * from "./git.js";
 export * from "./main.js";
 export * from "./paths.js";
 export * from "./pipeline.js";
+export * from "./preflight.js";
 export * from "./pyproject.js";
 export * from "./pyproject-sync.js";
-export * from "./python-bridge.js";
+export * from "./python-steps.js";
 export * from "./spawn.js";
 export * from "./types.js";
 export * from "./version.js";

package/dist/release/pipeline.js

@@ -5,8 +5,9 @@ import { EXIT_CONFIG_ERROR, EXIT_OK, EXIT_VIOLATION, RELEASE_ARTIFACTS, TOTAL_ST
 import { checkTagAvailable, createGithubRelease, readTextFile, verifyReleaseDraft } from "./gh.js";
 import { checkGitClean, commitReleaseArtifacts, createTag, currentBranch, pushRelease, releaseCommitSubject, } from "./git.js";
 import { resolveScriptsDir, todayIso } from "./paths.js";
+import { runReleaseCheck } from "./preflight.js";
 import { pyprojectPathFor, syncPyprojectForRelease } from "./pyproject-sync.js";
-import { checkVbriefLifecycleSync, refreshRoadmap, runBuild, runCi, runUvLock, } from "./python-bridge.js";
+import { checkVbriefLifecycleSync, refreshRoadmap, runBuild, runUvLock } from "./python-steps.js";
 import { isPrereleaseTag } from "./version.js";
 export function emit(step, label, status, target = process.stderr) {
     target.write(`[${step}/${TOTAL_STEPS}] ${label}... ${status}\n`);
@@ -20,7 +21,7 @@ export function runPipeline(config, seams = {}) {
     const readFile = seams.readFile ?? ((p) => readFileSync(p, "utf8"));
     const writeFile = seams.writeFile ?? ((p, c) => writeFileSync(p, c, "utf8"));
     const fileExists = seams.fileExists ?? ((p) => existsSync(p));
-    const runCiFn = seams.runCi ?? ((root) => runCi(root, scriptsDir, seams));
+    const runCiFn = seams.runCi ?? ((root) => runReleaseCheck(root));
     const refreshRoadmapFn = seams.refreshRoadmap ?? ((root) => refreshRoadmap(root, scriptsDir, seams));
     const checkVbriefFn = seams.checkVbriefLifecycleSync ??
         ((root, repo) => checkVbriefLifecycleSync(root, repo, scriptsDir, seams));
@@ -100,7 +101,11 @@ export function runPipeline(config, seams = {}) {
             return EXIT_VIOLATION;
         }
     }
-    // Step 5: CI.
+    // Step 5: CI pre-flight. The functional path now invokes the native
+    // TypeScript `task check` (via `runReleaseCheck`, #2022 Phase 1) instead of
+    // the ci_local.py bridge, but the emitted label/dry-run text is kept
+    // byte-identical to the Python oracle (scripts/release.py) so the #1729
+    // golden-diff release-parity gate stays green until the oracle is retired.
     label = "Pre-flight CI (task ci:local | fallback task check)";
     if (config.skipCi) {
         emit(5, label, "SKIP (--skip-ci)");

package/dist/release/preflight.d.ts

@@ -0,0 +1,27 @@
+/**
+ * preflight.ts -- Native TypeScript release Step-5 pre-flight (#2022 Phase 1).
+ *
+ * Promotes the context-aware `task check` orchestrator (check/orchestrator.ts)
+ * to the primary release pre-flight, replacing the removed `ci_local.py`
+ * python-bridge shim. The maintainer release runs in the framework-source
+ * context, so the framework root equals the project root and the orchestrator
+ * dispatches `check:framework-source`.
+ */
+import { type CheckOrchestratorSeams } from "../check/orchestrator.js";
+/** Seams for test isolation of the native release pre-flight. */
+export interface ReleasePreflightSeams {
+    /** Override the check dispatcher (default: dispatchTaskCheck from check/orchestrator). */
+    readonly dispatchCheck?: (frameworkRoot: string, projectRoot: string, seams?: CheckOrchestratorSeams) => number;
+    /** Seams forwarded to the underlying check orchestrator (e.g. taskBin, spawnFn). */
+    readonly checkSeams?: CheckOrchestratorSeams;
+}
+/**
+ * Run the native TypeScript `task check` as the release pre-flight.
+ *
+ * Returns the pipeline's standard `[ok, message]` tuple. The maintainer release
+ * cuts the framework itself, so we pass `projectRoot` as both the framework root
+ * and the project root -- the orchestrator then resolves the framework-source
+ * context and runs `check:framework-source`.
+ */
+export declare function runReleaseCheck(projectRoot: string, seams?: ReleasePreflightSeams): [boolean, string];
+//# sourceMappingURL=preflight.d.ts.map

package/dist/release/preflight.js

@@ -0,0 +1,27 @@
+/**
+ * preflight.ts -- Native TypeScript release Step-5 pre-flight (#2022 Phase 1).
+ *
+ * Promotes the context-aware `task check` orchestrator (check/orchestrator.ts)
+ * to the primary release pre-flight, replacing the removed `ci_local.py`
+ * python-bridge shim. The maintainer release runs in the framework-source
+ * context, so the framework root equals the project root and the orchestrator
+ * dispatches `check:framework-source`.
+ */
+import { dispatchTaskCheck } from "../check/orchestrator.js";
+/**
+ * Run the native TypeScript `task check` as the release pre-flight.
+ *
+ * Returns the pipeline's standard `[ok, message]` tuple. The maintainer release
+ * cuts the framework itself, so we pass `projectRoot` as both the framework root
+ * and the project root -- the orchestrator then resolves the framework-source
+ * context and runs `check:framework-source`.
+ */
+export function runReleaseCheck(projectRoot, seams = {}) {
+    const dispatch = seams.dispatchCheck ?? dispatchTaskCheck;
+    const code = dispatch(projectRoot, projectRoot, seams.checkSeams);
+    if (code === 0) {
+        return [true, "ran native TypeScript task check"];
+    }
+    return [false, `task check failed (exit ${code})`];
+}
+//# sourceMappingURL=preflight.js.map

package/dist/release/{python-bridge.d.ts → python-steps.d.ts}

@@ -1,7 +1,6 @@
 import type { ReleaseSeams } from "./types.js";
-export declare function runCi(projectRoot: string, scriptsDir: string, seams?: ReleaseSeams): [boolean, string];
 export declare function refreshRoadmap(projectRoot: string, scriptsDir: string, seams?: ReleaseSeams): [boolean, string];
 export declare function checkVbriefLifecycleSync(projectRoot: string, repo: string, scriptsDir: string, seams?: ReleaseSeams): [boolean, number, string];
 export declare function runBuild(projectRoot: string, scriptsDir: string, version: string | null, seams?: ReleaseSeams): [boolean, string];
 export declare function runUvLock(projectRoot: string, seams?: ReleaseSeams): [boolean, string];
-//# sourceMappingURL=python-bridge.d.ts.map
+//# sourceMappingURL=python-steps.d.ts.map

package/dist/release/{python-bridge.js → python-steps.js}

@@ -1,3 +1,15 @@
+/**
+ * python-steps.ts -- Residual Python-backed release pipeline steps.
+ *
+ * #2022 Phase 1 removed the `ci_local.py` Step-5 pre-flight bridge (now native
+ * TypeScript via release/preflight.ts), retiring the former `python-bridge.ts`
+ * module. These remaining steps still shell into bundled Python and stay here
+ * until their own purge phases land:
+ *   - refreshRoadmap (Step 7)            -> scripts/roadmap_render.py
+ *   - checkVbriefLifecycleSync (Step 3)  -> scripts/reconcile_issues.py
+ *   - runBuild (Step 8)                  -> scripts/build_dist.py (Bucket B, deleted by #1860)
+ *   - runUvLock (Step 6)                 -> `uv lock`
+ */
 import { existsSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { defaultWhich, spawnText } from "./spawn.js";
@@ -9,19 +21,6 @@ function runUvPython(_scriptsDir, code, cwd, env = process.env, seams = {}) {
         timeoutMs: 300_000,
     });
 }
-export function runCi(projectRoot, scriptsDir, seams = {}) {
-    const code = [
-        "import sys",
-        `sys.path.insert(0, ${JSON.stringify(scriptsDir)})`,
-        "import ci_local",
-        `sys.exit(ci_local.main(['--root', ${JSON.stringify(projectRoot)}]))`,
-    ].join("\n");
-    const result = runUvPython(scriptsDir, code, scriptsDir, process.env, seams);
-    if (result.status !== 0) {
-        return [false, `ci:local failed (exit ${result.status})`];
-    }
-    return [true, "ran ci:local"];
-}
 export function refreshRoadmap(projectRoot, scriptsDir, seams = {}) {
     const pending = join(projectRoot, "vbrief", "pending");
     const roadmap = join(projectRoot, "ROADMAP.md");
@@ -141,4 +140,4 @@ export function runUvLock(projectRoot, seams = {}) {
     }
     return [true, "uv.lock regenerated"];
 }
-//# sourceMappingURL=python-bridge.js.map
+//# sourceMappingURL=python-steps.js.map

package/dist/vbrief-validate/precutover.d.ts

@@ -4,4 +4,28 @@ export { DEPRECATION_SENTINEL as DEPRECATED_REDIRECT_SENTINEL };
 export declare function isDeprecationRedirect(content: string): boolean;
 /** Return true for a fully current ``task spec:render`` root export. */
 export declare function isCurrentGeneratedSpecification(projectRoot: string, content: string): boolean;
+/** Structured result of a pre-cutover (pre-v0.20 document model) probe. */
+export interface PrecutoverDetection {
+    /** True when any legacy pre-v0.20 artifact still needs migration. */
+    preCutover: boolean;
+    /** Human-readable reasons; empty when the project is on the current model. */
+    reasons: string[];
+}
+/**
+ * Detect whether ``projectRoot`` still carries pre-v0.20 (pre-cutover) document-model
+ * artifacts that need migration. Mirrors the AGENTS.md "Pre-Cutover Check" rule and the
+ * legacy ``scripts/_precutover.py`` helper: a project is pre-cutover when any of the
+ * following hold:
+ *
+ * - ``SPECIFICATION.md`` exists and is neither a deprecation redirect nor a current
+ *   generated spec export;
+ * - ``PROJECT.md`` exists and is not a deprecation redirect;
+ * - ``vbrief/`` exists but is missing one or more lifecycle folders.
+ */
+export declare function detectPreCutover(projectRoot: string): PrecutoverDetection;
+/**
+ * Render the single-line pre-cutover status string surfaced by ``deft doctor``.
+ * Flags the migration-needed state with reasons, or reports a clean current-model state.
+ */
+export declare function renderPrecutoverLine(projectRoot: string): string;
 //# sourceMappingURL=precutover.d.ts.map

package/dist/vbrief-validate/precutover.js

@@ -1,4 +1,4 @@
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { DEPRECATION_SENTINEL } from "../vbrief-build/constants.js";
 export { DEPRECATION_SENTINEL as DEPRECATED_REDIRECT_SENTINEL };
@@ -27,4 +27,69 @@ function isGeneratedSpecificationExport(projectRoot, content) {
 export function isCurrentGeneratedSpecification(projectRoot, content) {
     return isGeneratedSpecificationExport(projectRoot, content) && hasCompleteLifecycle(projectRoot);
 }
+function isFile(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function safeReadText(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Detect whether ``projectRoot`` still carries pre-v0.20 (pre-cutover) document-model
+ * artifacts that need migration. Mirrors the AGENTS.md "Pre-Cutover Check" rule and the
+ * legacy ``scripts/_precutover.py`` helper: a project is pre-cutover when any of the
+ * following hold:
+ *
+ * - ``SPECIFICATION.md`` exists and is neither a deprecation redirect nor a current
+ *   generated spec export;
+ * - ``PROJECT.md`` exists and is not a deprecation redirect;
+ * - ``vbrief/`` exists but is missing one or more lifecycle folders.
+ */
+export function detectPreCutover(projectRoot) {
+    const reasons = [];
+    const specPath = join(projectRoot, "SPECIFICATION.md");
+    if (isFile(specPath)) {
+        const content = safeReadText(specPath);
+        if (!isDeprecationRedirect(content) && !isCurrentGeneratedSpecification(projectRoot, content)) {
+            reasons.push("SPECIFICATION.md is a pre-v0.20 hand-authored doc (not a deprecation redirect or current generated export)");
+        }
+    }
+    const projectMdPath = join(projectRoot, "PROJECT.md");
+    if (isFile(projectMdPath)) {
+        const content = safeReadText(projectMdPath);
+        if (!isDeprecationRedirect(content)) {
+            reasons.push("PROJECT.md is a pre-v0.20 hand-authored doc (not a deprecation redirect)");
+        }
+    }
+    const vbriefRoot = join(projectRoot, "vbrief");
+    if (existsSync(vbriefRoot)) {
+        const missing = missingLifecycleFolders(projectRoot);
+        if (missing.length > 0) {
+            reasons.push(`vbrief/ is missing lifecycle folder(s): ${missing.join(", ")}`);
+        }
+    }
+    return { preCutover: reasons.length > 0, reasons };
+}
+/**
+ * Render the single-line pre-cutover status string surfaced by ``deft doctor``.
+ * Flags the migration-needed state with reasons, or reports a clean current-model state.
+ */
+export function renderPrecutoverLine(projectRoot) {
+    const { preCutover, reasons } = detectPreCutover(projectRoot);
+    if (!preCutover) {
+        return "Pre-cutover: none -- project is on the current vBRIEF document model.";
+    }
+    // Collapse any embedded newlines so the status line stays a single line (CWE-116).
+    const summary = reasons.join("; ").replace(/\r?\n/g, " ");
+    return `Pre-cutover: migration needed -- ${summary}. Run \`deft migrate:vbrief\` to migrate.`;
+}
 //# sourceMappingURL=precutover.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.58.0",
+  "version": "0.59.0",
   "description": "TypeScript engine core for the Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -209,8 +209,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.58.0",
-    "@deftai/directive-types": "^0.58.0"
+    "@deftai/directive-content": "^0.59.0",
+    "@deftai/directive-types": "^0.59.0"
   },
   "scripts": {
     "build": "tsc -b",