@deftai/directive-core 0.75.0 → 0.77.0

package/dist/vbrief-build/constants.js

@@ -1,8 +1,9 @@
-/** Canonical ``vBRIEFInfo.version`` emitted on scope vBRIEFs (#533). */
-export const EMITTED_VBRIEF_VERSION = "0.6";
+import { VBRIEF_VERSION } from "@deftai/directive-types";
+/** Canonical envelope version emitted on new scope xBRIEFs (#533, #2318). */
+export const EMITTED_VBRIEF_VERSION = VBRIEF_VERSION;
 /** Migrator provenance namespace under ``plan.metadata`` (#616). */
 export const MIGRATOR_METADATA_KEY = "x-migrator";
-export const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+/** Layout-aware PROJECT-DEFINITION paths live in ``project-definition-io.ts`` / ``policy/resolve.ts`` (#2302). */
 export const DEPRECATION_SENTINEL = "<!-- deft:deprecated-redirect -->";
 export const INTERNAL_REFERENCE_TYPES = new Set([
     "x-vbrief/plan",

package/dist/vbrief-build/index.d.ts

@@ -1,5 +1,5 @@
 export { createScopeVbrief, referenceHasRequiredFields, referenceWithDefaultTrust, setTodayForTests, slugify, TODAY, } from "./build.js";
-export { DEFAULT_STATUS_FOR_FOLDER, DEPRECATION_SENTINEL, EMITTED_VBRIEF_VERSION, EXTERNAL_REFERENCE_TYPES, FOLDER_TO_STATUSES, INTERNAL_REFERENCE_TYPES, LIFECYCLE_FOLDERS, MIGRATOR_METADATA_KEY, PROJECT_DEFINITION_REL_PATH, STATUS_TO_FOLDER, } from "./constants.js";
+export { DEFAULT_STATUS_FOR_FOLDER, DEPRECATION_SENTINEL, EMITTED_VBRIEF_VERSION, EXTERNAL_REFERENCE_TYPES, FOLDER_TO_STATUSES, INTERNAL_REFERENCE_TYPES, LIFECYCLE_FOLDERS, MIGRATOR_METADATA_KEY, STATUS_TO_FOLDER, } from "./constants.js";
 export { pythonJsonPretty } from "./json.js";
 export { cmdVbriefBuild, run, usage } from "./main.js";
 export { PARITY_SCENARIO_NAMES, renderScenarioOutput, runParityScenario, SAMPLE_PROJECT_MD, SAMPLE_ROADMAP_MD, SAMPLE_SPEC_MD, SAMPLE_SPEC_VBRIEF, } from "./parity-scenarios.js";

package/dist/vbrief-build/index.js

@@ -1,5 +1,5 @@
 export { createScopeVbrief, referenceHasRequiredFields, referenceWithDefaultTrust, setTodayForTests, slugify, TODAY, } from "./build.js";
-export { DEFAULT_STATUS_FOR_FOLDER, DEPRECATION_SENTINEL, EMITTED_VBRIEF_VERSION, EXTERNAL_REFERENCE_TYPES, FOLDER_TO_STATUSES, INTERNAL_REFERENCE_TYPES, LIFECYCLE_FOLDERS, MIGRATOR_METADATA_KEY, PROJECT_DEFINITION_REL_PATH, STATUS_TO_FOLDER, } from "./constants.js";
+export { DEFAULT_STATUS_FOR_FOLDER, DEPRECATION_SENTINEL, EMITTED_VBRIEF_VERSION, EXTERNAL_REFERENCE_TYPES, FOLDER_TO_STATUSES, INTERNAL_REFERENCE_TYPES, LIFECYCLE_FOLDERS, MIGRATOR_METADATA_KEY, STATUS_TO_FOLDER, } from "./constants.js";
 export { pythonJsonPretty } from "./json.js";
 export { cmdVbriefBuild, run, usage } from "./main.js";
 export { PARITY_SCENARIO_NAMES, renderScenarioOutput, runParityScenario, SAMPLE_PROJECT_MD, SAMPLE_ROADMAP_MD, SAMPLE_SPEC_MD, SAMPLE_SPEC_VBRIEF, } from "./parity-scenarios.js";

package/dist/verify-env/command-spawn.d.ts

@@ -0,0 +1,24 @@
+import type { SpawnResult } from "../release/types.js";
+export interface ResolveCommandOnPathOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly platform?: NodeJS.Platform;
+    readonly exists?: (path: string) => boolean;
+}
+/** Windows command shims (.cmd/.bat) need a shell; native executables do not. */
+export declare function shouldUseShellForCommand(command: string, platform?: NodeJS.Platform): boolean;
+/**
+ * Resolve an executable on PATH with PATHEXT / Path awareness (#2467 / #2548).
+ * Mirrors ts-check-lane `resolvePnpm` and verify-tools `defaultProbe`.
+ */
+export declare function resolveCommandOnPath(command: string, options?: ResolveCommandOnPathOptions): string | null;
+export interface SpawnCommandTextOptions {
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly timeoutMs?: number;
+}
+/**
+ * spawnSync wrapper that applies win32 PATHEXT / shell rules (#2467 / #2548).
+ * Retries with `shell: true` on win32 ENOENT (npm global `.cmd` shims).
+ */
+export declare function spawnCommandText(cmd: string, args: readonly string[], options?: SpawnCommandTextOptions): SpawnResult;
+//# sourceMappingURL=command-spawn.d.ts.map

package/dist/verify-env/command-spawn.js

@@ -0,0 +1,78 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { posix, win32 } from "node:path";
+import { SUBPROCESS_MAX_BUFFER } from "../subprocess/max-buffer.js";
+/** Windows command shims (.cmd/.bat) need a shell; native executables do not. */
+export function shouldUseShellForCommand(command, platform = process.platform) {
+    return platform === "win32" && /\.(?:cmd|bat)$/i.test(command);
+}
+/**
+ * Resolve an executable on PATH with PATHEXT / Path awareness (#2467 / #2548).
+ * Mirrors ts-check-lane `resolvePnpm` and verify-tools `defaultProbe`.
+ */
+export function resolveCommandOnPath(command, options = {}) {
+    const env = options.env ?? process.env;
+    const platform = options.platform ?? process.platform;
+    const exists = options.exists ?? existsSync;
+    const pathValue = env.PATH ?? env.Path ?? "";
+    if (pathValue === "") {
+        return null;
+    }
+    const isWindows = platform === "win32";
+    const exts = isWindows ? (env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";") : [""];
+    const sep = isWindows ? ";" : ":";
+    const joinPath = isWindows ? win32.join : posix.join;
+    for (const dir of pathValue.split(sep)) {
+        if (dir === "")
+            continue;
+        for (const ext of exts) {
+            const candidate = joinPath(dir, `${command}${ext}`);
+            if (exists(candidate)) {
+                return candidate;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * spawnSync wrapper that applies win32 PATHEXT / shell rules (#2467 / #2548).
+ * Retries with `shell: true` on win32 ENOENT (npm global `.cmd` shims).
+ */
+export function spawnCommandText(cmd, args, options = {}) {
+    const trySpawn = (shell) => spawnSync(cmd, [...args], {
+        cwd: options.cwd,
+        env: options.env ?? process.env,
+        encoding: "utf8",
+        timeout: options.timeoutMs,
+        maxBuffer: SUBPROCESS_MAX_BUFFER,
+        stdio: ["ignore", "pipe", "pipe"],
+        shell,
+    });
+    let result = trySpawn(shouldUseShellForCommand(cmd));
+    const spawnErr = result.error;
+    if (spawnErr?.code === "ENOENT" && process.platform === "win32") {
+        result = trySpawn(true);
+    }
+    let status = result.status;
+    let stderr = typeof result.stderr === "string" ? result.stderr : "";
+    if (status === null) {
+        if (result.signal !== null && result.signal !== undefined) {
+            status = 128;
+        }
+        else if (result.error) {
+            status = 2;
+            if (stderr.trim().length === 0) {
+                stderr = result.error.message;
+            }
+        }
+        else {
+            status = 0;
+        }
+    }
+    return {
+        status,
+        stdout: typeof result.stdout === "string" ? result.stdout : "",
+        stderr,
+    };
+}
+//# sourceMappingURL=command-spawn.js.map

package/dist/verify-env/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./command-spawn.js";
 export * from "./node-runtime.js";
 export * from "./toolchain-check.js";
 export * from "./verify-hooks-installed.js";

package/dist/verify-env/index.js

@@ -1,3 +1,4 @@
+export * from "./command-spawn.js";
 export * from "./node-runtime.js";
 export * from "./toolchain-check.js";
 export * from "./verify-hooks-installed.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.75.0",
+  "version": "0.77.0",
   "description": "TypeScript engine core for the Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -62,6 +62,10 @@
       "types": "./dist/session/index.d.ts",
       "default": "./dist/session/index.js"
     },
+    "./plan-sequence": {
+      "types": "./dist/plan-sequence/index.d.ts",
+      "default": "./dist/plan-sequence/index.js"
+    },
     "./slice": {
       "types": "./dist/slice/index.d.ts",
       "default": "./dist/slice/index.js"
@@ -285,8 +289,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.75.0",
-    "@deftai/directive-types": "^0.75.0",
+    "@deftai/directive-content": "^0.77.0",
+    "@deftai/directive-types": "^0.77.0",
     "archiver": "^8.0.0"
   },
   "scripts": {