@deftai/directive-core 0.59.0 → 0.60.0

package/dist/task-surface/index.js

@@ -0,0 +1,126 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+const UNRELEASED_RE = /## \[Unreleased\][ \t]*\n([\s\S]*?)(?=\n## \[|$)/;
+const CHANGE_NAME_RE = /^[\w][\w-]*$/;
+const COMMIT_TYPES = "feat|fix|docs|chore|refactor|test|style|perf|ci|build|revert";
+const COMMIT_SUBJECT_RE = new RegExp(`^(${COMMIT_TYPES})(\\(.+\\))?!?: .+`);
+function proposalTemplate(name) {
+    return {
+        vBRIEFInfo: { version: "0.5" },
+        plan: {
+            title: name,
+            status: "draft",
+            narratives: {
+                Problem: "What is wrong or missing.",
+                Change: "What this proposal does about it.",
+                Scope: "In scope: ...  Out of scope: ...",
+                Impact: "What existing code/specs are affected.",
+                Risks: "What could go wrong.",
+                Approach: "How to implement the change.",
+                Alternatives: "What else was considered and why not.",
+                Dependencies: "What must exist before this works.",
+            },
+        },
+    };
+}
+function tasksTemplate(name) {
+    return {
+        vBRIEFInfo: { version: "0.5" },
+        plan: { title: name, status: "draft", items: [], edges: [] },
+    };
+}
+/** Port of ``task change:changelog:check`` inline Python (#2022 Phase 2). */
+export function runChangelogCheck(projectRoot, io) {
+    const path = join(resolve(projectRoot), "CHANGELOG.md");
+    if (!existsSync(path) || !statSync(path).isFile()) {
+        io.writeOut("FAIL: CHANGELOG.md not found\n");
+        return 1;
+    }
+    const text = readFileSync(path, "utf8");
+    const match = UNRELEASED_RE.exec(text);
+    if (match === null) {
+        io.writeOut("FAIL: No [Unreleased] section found in CHANGELOG.md\n");
+        return 1;
+    }
+    const body = match[1] ?? "";
+    const entries = body.split("\n").filter((line) => line.trimStart().startsWith("- "));
+    if (entries.length === 0) {
+        io.writeOut('FAIL: [Unreleased] section has no entries (no lines starting with "- ")\n');
+        return 1;
+    }
+    io.writeOut(`OK: CHANGELOG.md [Unreleased] section has ${entries.length} entries\n`);
+    return 0;
+}
+/** Port of ``task change:init`` inline Python (#2022 Phase 2). */
+export function runChangeInit(projectRoot, name, io) {
+    const trimmed = name.trim();
+    if (trimmed.length === 0) {
+        io.writeOut("FAIL: Usage: task change:init -- <name>\n");
+        return 1;
+    }
+    if (!CHANGE_NAME_RE.test(trimmed)) {
+        io.writeOut("FAIL: Name must contain only alphanumeric characters, underscores, and hyphens\n");
+        return 1;
+    }
+    const base = join(resolve(projectRoot), "history", "changes", trimmed);
+    if (existsSync(base)) {
+        io.writeOut(`FAIL: ${base} already exists\n`);
+        return 1;
+    }
+    mkdirSync(join(base, "specs"), { recursive: true });
+    writeFileSync(join(base, "proposal.vbrief.json"), `${JSON.stringify(proposalTemplate(trimmed), null, 2)}\n`, "utf8");
+    writeFileSync(join(base, "tasks.vbrief.json"), `${JSON.stringify(tasksTemplate(trimmed), null, 2)}\n`, "utf8");
+    io.writeOut(`OK: Created change proposal at ${base}/\n`);
+    for (const file of ["proposal.vbrief.json", "tasks.vbrief.json", "specs/"]) {
+        io.writeOut(`  - ${file}\n`);
+    }
+    return 0;
+}
+/** Port of ``task commit:lint`` inline Python (#2022 Phase 2). */
+export function runCommitLint(projectRoot, io) {
+    let stdout;
+    try {
+        stdout = execFileSync("git", ["log", "--format=%B", "-1"], {
+            cwd: resolve(projectRoot),
+            encoding: "utf8",
+        });
+    }
+    catch {
+        io.writeOut("FAIL: Could not read HEAD commit message\n");
+        return 1;
+    }
+    const msg = stdout.trim();
+    const subject = msg.split("\n")[0] ?? "";
+    if (!COMMIT_SUBJECT_RE.test(subject)) {
+        io.writeOut("FAIL: Commit message does not match conventional commit format\n");
+        io.writeOut(`  Got:      ${subject}\n`);
+        io.writeOut("  Expected: type(scope): description\n");
+        io.writeOut("  Types:    feat, fix, docs, chore, refactor, test, style, perf, ci, build, revert\n");
+        return 1;
+    }
+    io.writeOut("OK: Commit message is valid conventional commit\n");
+    io.writeOut(`  Subject: ${subject}\n`);
+    return 0;
+}
+/** Port of ``task install:uninstall`` inline Python (#2022 Phase 2). */
+export function runInstallUninstall(projectRoot, io) {
+    const path = join(resolve(projectRoot), "AGENTS.md");
+    if (!existsSync(path) || !statSync(path).isFile()) {
+        io.writeOut("No deft entry found in AGENTS.md\n");
+        return 0;
+    }
+    const original = readFileSync(path, "utf8");
+    const lines = original.split(/(?<=\n)/);
+    const filtered = lines.filter((line) => !line.startsWith("See deft/main.md") && !line.startsWith("Skills: deft/skills/"));
+    const next = filtered.join("");
+    if (next !== original) {
+        writeFileSync(path, next, "utf8");
+        io.writeOut("Removed deft entry from AGENTS.md\n");
+    }
+    else {
+        io.writeOut("No deft entry found in AGENTS.md\n");
+    }
+    return 0;
+}
+//# sourceMappingURL=index.js.map

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

@@ -1,9 +1,13 @@
 import { DEPRECATION_SENTINEL } from "../vbrief-build/constants.js";
 export { DEPRECATION_SENTINEL as DEPRECATED_REDIRECT_SENTINEL };
+export declare function missingLifecycleFolders(projectRoot: string): string[];
 /** Return true when markdown content is a migration redirect stub. */
 export declare function isDeprecationRedirect(content: string): boolean;
+export declare function isGeneratedSpecificationExport(projectRoot: string, content: string): boolean;
 /** Return true for a fully current ``task spec:render`` root export. */
 export declare function isCurrentGeneratedSpecification(projectRoot: string, content: string): boolean;
+/** Return root artifact filenames that are legacy pre-v0.20 inputs (#793 / migrate preflight). */
+export declare function detectPreCutoverLegacy(projectRoot: string): string[];
 /** 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. */

package/dist/vbrief-validate/precutover.js

@@ -7,7 +7,7 @@ const GENERATED_SPEC_PURPOSE = "<!-- Purpose: rendered specification -->";
 const GENERATED_SPEC_SOURCE = "<!-- Source of truth: vbrief/specification.vbrief.json -->";
 const SPEC_SOURCE_RELPATH = join("vbrief", "specification.vbrief.json");
 const LIFECYCLE_FOLDERS = ["proposed", "pending", "active", "completed", "cancelled"];
-function missingLifecycleFolders(projectRoot) {
+export function missingLifecycleFolders(projectRoot) {
     const vbriefRoot = join(projectRoot, "vbrief");
     return LIFECYCLE_FOLDERS.filter((folder) => !existsSync(join(vbriefRoot, folder)));
 }
@@ -18,7 +18,7 @@ function hasCompleteLifecycle(projectRoot) {
 export function isDeprecationRedirect(content) {
     return content.includes(DEPRECATION_SENTINEL) || content.includes(DEPRECATION_REDIRECT_PURPOSE);
 }
-function isGeneratedSpecificationExport(projectRoot, content) {
+export function isGeneratedSpecificationExport(projectRoot, content) {
     return (content.includes(GENERATED_SPEC_PURPOSE) &&
         content.includes(GENERATED_SPEC_SOURCE) &&
         existsSync(join(projectRoot, SPEC_SOURCE_RELPATH)));
@@ -43,6 +43,28 @@ function safeReadText(path) {
         return "";
     }
 }
+function rootMarkdownIsLegacy(projectRoot, filename, content) {
+    if (isDeprecationRedirect(content))
+        return false;
+    if (filename === "SPECIFICATION.md" && isGeneratedSpecificationExport(projectRoot, content)) {
+        return false;
+    }
+    return filename === "SPECIFICATION.md" || filename === "PROJECT.md";
+}
+/** Return root artifact filenames that are legacy pre-v0.20 inputs (#793 / migrate preflight). */
+export function detectPreCutoverLegacy(projectRoot) {
+    const legacy = [];
+    for (const filename of ["SPECIFICATION.md", "PROJECT.md"]) {
+        const candidate = join(projectRoot, filename);
+        if (!isFile(candidate))
+            continue;
+        const content = safeReadText(candidate);
+        if (rootMarkdownIsLegacy(projectRoot, filename, content)) {
+            legacy.push(filename);
+        }
+    }
+    return legacy;
+}
 /**
  * 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

package/dist/verify-env/toolchain-check.d.ts

@@ -2,6 +2,10 @@ export interface ToolCheck {
     readonly name: string;
     readonly command: readonly string[];
 }
+export declare const MAINTAINER_TOOLS: readonly ToolCheck[];
+/** Consumer npm-deposit toolchain (#2022 Phase 3) -- no Python/go/uv maintainer tools. */
+export declare const CONSUMER_TOOLS: readonly ToolCheck[];
+/** @deprecated use MAINTAINER_TOOLS */
 export declare const TOOLS: readonly ToolCheck[];
 export type CommandRunner = (command: readonly string[], timeoutMs: number) => {
     returncode: number;
@@ -23,6 +27,9 @@ export declare function defaultCommandRunner(command: readonly string[], timeout
     error: "not-found" | "exception";
     message: string;
 };
-/** Run maintainer toolchain probe (mirrors scripts/toolchain-check.py). */
-export declare function runToolchainCheck(runner?: CommandRunner, tools?: readonly ToolCheck[]): ToolchainCheckResult;
+export interface ToolchainCheckOptions {
+    readonly consumer?: boolean;
+}
+/** Run maintainer or consumer toolchain probe (mirrors scripts/toolchain-check.py). */
+export declare function runToolchainCheck(runner?: CommandRunner, options?: ToolchainCheckOptions, tools?: readonly ToolCheck[]): ToolchainCheckResult;
 //# sourceMappingURL=toolchain-check.d.ts.map

package/dist/verify-env/toolchain-check.js

@@ -1,6 +1,6 @@
 import * as childProcess from "node:child_process";
 import { nodeRuntimeRemediationLines } from "./node-runtime.js";
-export const TOOLS = [
+export const MAINTAINER_TOOLS = [
     { name: "go", command: ["go", "version"] },
     { name: "uv", command: ["uv", "--version"] },
     { name: "git", command: ["git", "--version"] },
@@ -8,6 +8,16 @@ export const TOOLS = [
     { name: "node", command: ["node", "--version"] },
     { name: "pnpm", command: ["pnpm", "--version"] },
 ];
+/** Consumer npm-deposit toolchain (#2022 Phase 3) -- no Python/go/uv maintainer tools. */
+export const CONSUMER_TOOLS = [
+    { name: "git", command: ["git", "--version"] },
+    { name: "gh", command: ["gh", "--version"] },
+    { name: "node", command: ["node", "--version"] },
+    { name: "pnpm", command: ["pnpm", "--version"] },
+    { name: "task", command: ["task", "--version"] },
+];
+/** @deprecated use MAINTAINER_TOOLS */
+export const TOOLS = MAINTAINER_TOOLS;
 const DEFAULT_TIMEOUT_MS = 10_000;
 export function defaultCommandRunner(command, timeoutMs) {
     try {
@@ -30,11 +40,12 @@ export function defaultCommandRunner(command, timeoutMs) {
         };
     }
 }
-/** Run maintainer toolchain probe (mirrors scripts/toolchain-check.py). */
-export function runToolchainCheck(runner = defaultCommandRunner, tools = TOOLS) {
+/** Run maintainer or consumer toolchain probe (mirrors scripts/toolchain-check.py). */
+export function runToolchainCheck(runner = defaultCommandRunner, options = {}, tools) {
+    const selectedTools = tools ?? (options.consumer ? CONSUMER_TOOLS : MAINTAINER_TOOLS);
     const lines = [];
     const failed = [];
-    for (const tool of tools) {
+    for (const tool of selectedTools) {
         const result = runner(tool.command, DEFAULT_TIMEOUT_MS);
         if ("error" in result) {
             if (result.error === "not-found") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.59.0",
+  "version": "0.60.0",
   "description": "TypeScript engine core for the Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -190,6 +190,18 @@
       "types": "./dist/init-deposit/index.d.ts",
       "default": "./dist/init-deposit/index.js"
     },
+    "./migrate-preflight": {
+      "types": "./dist/migrate-preflight/index.d.ts",
+      "default": "./dist/migrate-preflight/index.js"
+    },
+    "./install-upgrade": {
+      "types": "./dist/install-upgrade/index.d.ts",
+      "default": "./dist/install-upgrade/index.js"
+    },
+    "./task-surface": {
+      "types": "./dist/task-surface/index.d.ts",
+      "default": "./dist/task-surface/index.js"
+    },
     "./dist/*.js": {
       "types": "./dist/*.d.ts",
       "default": "./dist/*.js"
@@ -209,8 +221,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.59.0",
-    "@deftai/directive-types": "^0.59.0"
+    "@deftai/directive-content": "^0.60.0",
+    "@deftai/directive-types": "^0.60.0"
   },
   "scripts": {
     "build": "tsc -b",