@deftai/directive-core 0.61.2 → 0.63.0

package/dist/vbrief-validate/precutover.js

@@ -98,13 +98,20 @@ export function detectPreCutover(projectRoot) {
     }
     return { preCutover: reasons.length > 0, reasons };
 }
+/** Last release that ships `scripts/migrate_vbrief.py` on the consumer deposit path (#2068). */
+export const FROZEN_PRECUTOVER_MIGRATION_TAG = "v0.59.0";
+export function frozenPreCutoverMigrationGuidance() {
+    return (`Current npm releases no longer ship in-product \`task migrate:vbrief\`. Pin framework ${FROZEN_PRECUTOVER_MIGRATION_TAG} ` +
+        `(frozen Go installer or git tag), install Python 3.11+ and uv, run \`task migrate:vbrief\` once from that payload, ` +
+        `then upgrade to current npm. See UPGRADING.md § Frozen pre-v0.20 document-model migration (#2068).`);
+}
 export function renderPrecutoverLine(projectRoot) {
     const { preCutover, reasons } = detectPreCutover(projectRoot);
     if (!preCutover) {
         return "Pre-cutover: none -- project is on the current vBRIEF document model.";
     }
     const summary = reasons.join("; ").replace(/\r?\n/g, " ");
-    return `Pre-cutover: migration needed -- ${summary}. Run \`deft migrate:vbrief\` to migrate.`;
+    return `Pre-cutover: migration needed -- ${summary}. ${frozenPreCutoverMigrationGuidance()}`;
 }
 // Re-export for classify callers (#2013).
 export { isFullSpecState, isGreenfieldSpecExport };

package/dist/verify-env/verify-hooks-installed.d.ts

@@ -16,6 +16,8 @@ export interface EvaluateOptions {
     readonly gitConfigReader?: GitConfigReader;
     readonly platform?: NodeJS.Platform;
 }
+/** Drop shell ``#`` comment lines before pattern scans (#2049 shipped-hook false positives). */
+export declare function stripShellCommentLines(content: string): string;
 /** Pure evaluator mirroring scripts/verify_hooks_installed.py::evaluate. */
 export declare function evaluate(projectRoot: string, options?: EvaluateOptions): EvaluateResult;
 //# sourceMappingURL=verify-hooks-installed.d.ts.map

package/dist/verify-env/verify-hooks-installed.js

@@ -69,15 +69,31 @@ function readHookContent(hookPath) {
         return null;
     }
 }
+/** Drop shell ``#`` comment lines before pattern scans (#2049 shipped-hook false positives). */
+export function stripShellCommentLines(content) {
+    return content
+        .split(/\r?\n/)
+        .filter((line) => !/^\s*#/.test(line))
+        .join("\n");
+}
+function executableHookBody(content) {
+    return stripShellCommentLines(content);
+}
 function usesLegacyPythonDispatch(content) {
-    return LEGACY_HOOK_PATTERNS.some((pattern) => pattern.test(content));
+    const body = executableHookBody(content);
+    return LEGACY_HOOK_PATTERNS.some((pattern) => pattern.test(body));
 }
 function hookInvokesDeftCli(content, requiredCommands) {
-    if (!/\bdeft\b/.test(content))
+    const body = executableHookBody(content);
+    if (!/\bdeft\b/.test(body))
         return false;
     if (usesLegacyPythonDispatch(content))
         return false;
-    return requiredCommands.every((cmd) => content.includes(cmd));
+    return requiredCommands.every((cmd) => body.includes(cmd));
+}
+function prePushInvokesVerifyBranch(content) {
+    const body = executableHookBody(content);
+    return /\bdeft\s+verify:branch\b/.test(body);
 }
 function validateHookContent(hookName, content, requiredCommands) {
     if (content === null) {
@@ -176,7 +192,7 @@ export function evaluate(projectRoot, options = {}) {
             stream: "stderr",
         };
     }
-    if (prePushContent?.includes("verify:branch")) {
+    if (prePushContent && prePushInvokesVerifyBranch(prePushContent)) {
         return {
             code: 1,
             message: "❌ deft hooks wired but NON-FUNCTIONAL: pre-push must not invoke verify:branch (#1814).\n" +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.61.2",
+  "version": "0.63.0",
   "description": "TypeScript engine core for the Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -194,6 +194,14 @@
       "types": "./dist/migrate-preflight/index.d.ts",
       "default": "./dist/migrate-preflight/index.js"
     },
+    "./check-updates": {
+      "types": "./dist/check-updates/index.d.ts",
+      "default": "./dist/check-updates/index.js"
+    },
+    "./umbrella-current-shape": {
+      "types": "./dist/umbrella-current-shape/index.d.ts",
+      "default": "./dist/umbrella-current-shape/index.js"
+    },
     "./install-upgrade": {
       "types": "./dist/install-upgrade/index.d.ts",
       "default": "./dist/install-upgrade/index.js"
@@ -221,11 +229,15 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.61.2",
-    "@deftai/directive-types": "^0.61.2"
+    "@deftai/directive-content": "^0.63.0",
+    "@deftai/directive-types": "^0.63.0",
+    "archiver": "^8.0.0"
   },
   "scripts": {
     "build": "tsc -b",
     "test": "pnpm -w exec vitest run --coverage packages/core/src"
+  },
+  "devDependencies": {
+    "@types/archiver": "^8.0.0"
   }
 }

package/dist/release/pyproject-sync.d.ts

@@ -1,6 +0,0 @@
-import type { ReleaseSeams } from "./types.js";
-export declare function syncPyprojectForRelease(pyprojectPath: string, version: string, options: {
-    dryRun: boolean;
-}, seams?: ReleaseSeams): [string, string | null];
-export declare function pyprojectPathFor(projectRoot: string): string;
-//# sourceMappingURL=pyproject-sync.d.ts.map

package/dist/release/pyproject-sync.js

@@ -1,52 +0,0 @@
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { join } from "node:path";
-import { updatePyprojectVersion } from "./pyproject.js";
-import { NonPublishableVersionError, toPep440 } from "./version.js";
-export function syncPyprojectForRelease(pyprojectPath, version, options, seams = {}) {
-    const exists = seams.fileExists ??
-        ((p) => {
-            try {
-                return existsSync(p) && statSync(p).isFile();
-            }
-            catch {
-                return false;
-            }
-        });
-    const read = seams.readFile ?? ((p) => readFileSync(p, "utf8"));
-    if (!exists(pyprojectPath)) {
-        return ["no pyproject.toml; skipping sync", null];
-    }
-    let pepVersion;
-    try {
-        pepVersion = toPep440(version);
-    }
-    catch (err) {
-        if (err instanceof NonPublishableVersionError) {
-            return [`non-publishable tag (${err.message}); skipping pyproject sync`, null];
-        }
-        if (err instanceof Error) {
-            return [`FAIL (cannot normalize version to PEP 440: ${err.message})`, null];
-        }
-        return [`FAIL (cannot normalize version to PEP 440: ${String(err)})`, null];
-    }
-    const original = read(pyprojectPath);
-    let newText;
-    try {
-        newText = updatePyprojectVersion(original, pepVersion);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        return [`FAIL (pyproject.toml: ${msg})`, null];
-    }
-    if (newText === original) {
-        return [`pyproject already at ${pepVersion}`, null];
-    }
-    if (options.dryRun) {
-        return [`pyproject [project].version -> ${pepVersion}`, null];
-    }
-    return [`pyproject [project].version -> ${pepVersion}`, newText];
-}
-export function pyprojectPathFor(projectRoot) {
-    return join(projectRoot, "pyproject.toml");
-}
-//# sourceMappingURL=pyproject-sync.js.map

package/dist/release/pyproject.d.ts

@@ -1,3 +0,0 @@
-/** Rewrite [project].version in pyproject.toml content (#771). */
-export declare function updatePyprojectVersion(text: string, version: string): string;
-//# sourceMappingURL=pyproject.d.ts.map

package/dist/release/pyproject.js

@@ -1,33 +0,0 @@
-import { PYPROJECT_VERSION_LINE_RE } from "./constants.js";
-/** Rewrite [project].version in pyproject.toml content (#771). */
-export function updatePyprojectVersion(text, version) {
-    if (typeof text !== "string") {
-        throw new Error(`text must be a string, got ${typeof text}`);
-    }
-    if (typeof version !== "string" || !version.trim()) {
-        throw new Error("version must be a non-empty string");
-    }
-    const lines = text.split(/(?<=\n)/);
-    let inProjectSection = false;
-    for (let idx = 0; idx < lines.length; idx += 1) {
-        const line = lines[idx] ?? "";
-        const stripped = line.trim();
-        if (!stripped || stripped.startsWith("#")) {
-            continue;
-        }
-        if (stripped.startsWith("[") && stripped.endsWith("]")) {
-            inProjectSection = stripped === "[project]";
-            continue;
-        }
-        if (inProjectSection && PYPROJECT_VERSION_LINE_RE.test(stripped)) {
-            const newLine = line.replace(PYPROJECT_VERSION_LINE_RE, `version = "${version}"`);
-            if (newLine === line) {
-                return text;
-            }
-            lines[idx] = newLine;
-            return lines.join("");
-        }
-    }
-    throw new Error("pyproject.toml has no [project] section with a version key");
-}
-//# sourceMappingURL=pyproject.js.map

package/dist/release/python-steps.d.ts

@@ -1,6 +0,0 @@
-import type { ReleaseSeams } from "./types.js";
-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-steps.d.ts.map

package/dist/release/python-steps.js

@@ -1,143 +0,0 @@
-/**
- * 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";
-function runUvPython(_scriptsDir, code, cwd, env = process.env, seams = {}) {
-    const spawn = seams.spawnText ?? spawnText;
-    return spawn("uv", ["run", "python", "-c", code], {
-        cwd,
-        env: { ...env, PYTHONUTF8: "1" },
-        timeoutMs: 300_000,
-    });
-}
-export function refreshRoadmap(projectRoot, scriptsDir, seams = {}) {
-    const pending = join(projectRoot, "vbrief", "pending");
-    const roadmap = join(projectRoot, "ROADMAP.md");
-    const completed = join(projectRoot, "vbrief", "completed");
-    const code = [
-        "import sys",
-        `sys.path.insert(0, ${JSON.stringify(scriptsDir)})`,
-        "import roadmap_render",
-        `ok, msg = roadmap_render.render_roadmap(${JSON.stringify(pending)}, ${JSON.stringify(roadmap)}, completed_dir=${JSON.stringify(completed)})`,
-        "if ok:",
-        "    sys.exit(0)",
-        "print(msg, file=sys.stderr)",
-        "sys.exit(1)",
-    ].join("\n");
-    const result = runUvPython(scriptsDir, code, projectRoot, process.env, seams);
-    if (result.status !== 0) {
-        const msg = result.stderr.trim() || result.stdout.trim();
-        return [false, `roadmap:render failed: ${msg}`];
-    }
-    return [true, "ROADMAP.md re-rendered"];
-}
-export function checkVbriefLifecycleSync(projectRoot, repo, scriptsDir, seams = {}) {
-    const code = [
-        "import json, sys",
-        "from pathlib import Path",
-        `scripts_dir = Path(${JSON.stringify(scriptsDir)})`,
-        "sys.path.insert(0, str(scripts_dir))",
-        "try:",
-        "    import reconcile_issues",
-        "except ImportError as exc:",
-        "    print(json.dumps({'ok': False, 'mismatch_count': -1, 'reason': f'reconcile_issues import failed: {exc}'}))",
-        "    sys.exit(0)",
-        `project_root = Path(${JSON.stringify(projectRoot)})`,
-        `repo = ${JSON.stringify(repo)}`,
-        "vbrief_dir = project_root / 'vbrief'",
-        "if not vbrief_dir.is_dir():",
-        "    print(json.dumps({'ok': False, 'mismatch_count': -1, 'reason': f'vbrief directory not found at {vbrief_dir}'}))",
-        "    sys.exit(0)",
-        "issue_to_vbriefs = reconcile_issues.scan_vbrief_dir(vbrief_dir)",
-        "issue_state_map = reconcile_issues.fetch_issue_states(repo, set(issue_to_vbriefs.keys()), cwd=project_root)",
-        "if issue_state_map is None:",
-        "    print(json.dumps({'ok': False, 'mismatch_count': -1, 'reason': 'failed to fetch issue states from gh'}))",
-        "    sys.exit(0)",
-        "report = reconcile_issues.reconcile(issue_to_vbriefs, issue_state_map)",
-        "mismatches = [rel for entry in report.get('no_open_issue', []) for rel in entry.get('vbrief_files', []) if not reconcile_issues.is_terminal_lifecycle_path(rel)]",
-        "count = len(mismatches)",
-        "if count == 0:",
-        "    print(json.dumps({'ok': True, 'mismatch_count': 0, 'reason': 'no mismatches'}))",
-        "else:",
-        "    suffix = ' ...' if count > 5 else ''",
-        "    preview = ', '.join(mismatches[:5])",
-        "    reason = f'{count} closed-issue vBRIEF(s) not in completed/ or cancelled/: {preview}{suffix}'",
-        "    print(json.dumps({'ok': False, 'mismatch_count': count, 'reason': reason}))",
-    ].join("\n");
-    const result = runUvPython(scriptsDir, code, projectRoot, process.env, seams);
-    try {
-        const payload = JSON.parse(result.stdout.trim());
-        return [payload.ok, payload.mismatch_count, payload.reason];
-    }
-    catch {
-        return [
-            false,
-            -1,
-            `reconcile_issues bridge failed: ${result.stderr.trim() || result.stdout.trim()}`,
-        ];
-    }
-}
-export function runBuild(projectRoot, scriptsDir, version, seams = {}) {
-    const env = { ...process.env };
-    if (version) {
-        env.DEFT_RELEASE_VERSION = version;
-    }
-    else {
-        delete env.DEFT_RELEASE_VERSION;
-    }
-    const code = [
-        "import sys",
-        "from pathlib import Path",
-        `sys.path.insert(0, ${JSON.stringify(scriptsDir)})`,
-        "from framework_commands import run_framework_command",
-        `root = Path(${JSON.stringify(projectRoot)})`,
-        "result = run_framework_command('build', project_root=root, framework_root=root)",
-        "sys.exit(result.code)",
-    ].join("\n");
-    const result = runUvPython(scriptsDir, code, projectRoot, env, seams);
-    if (result.status !== 0) {
-        return [false, `build failed (exit ${result.status})`];
-    }
-    const suffix = version ? ` (DEFT_RELEASE_VERSION=${version})` : "";
-    return [true, `build ran clean${suffix}`];
-}
-export function runUvLock(projectRoot, seams = {}) {
-    const exists = seams.fileExists ??
-        ((p) => {
-            try {
-                return existsSync(p) && statSync(p).isFile();
-            }
-            catch {
-                return false;
-            }
-        });
-    if (!exists(join(projectRoot, "pyproject.toml"))) {
-        return [true, "no pyproject.toml; skipping uv lock"];
-    }
-    const whichUv = seams.whichUv ?? defaultWhich;
-    const uvPath = whichUv("uv");
-    if (uvPath === null) {
-        process.stderr.write("WARNING: uv binary not on PATH; skipping uv.lock regeneration " +
-            "(see #774). Run `uv lock` manually before pushing the release tag.\n");
-        return [true, "uv binary not on PATH; skipping uv lock"];
-    }
-    const spawn = seams.spawnText ?? spawnText;
-    const result = spawn(uvPath, ["lock"], { cwd: projectRoot, timeoutMs: 300_000 });
-    if (result.status !== 0) {
-        const stderr = result.stderr.trim();
-        return [false, `uv lock failed (exit ${result.status}): ${stderr}`];
-    }
-    return [true, "uv.lock regenerated"];
-}
-//# sourceMappingURL=python-steps.js.map