@deftai/directive-core 0.55.1 → 0.55.2

package/dist/codebase/map-fresh.js

@@ -8,8 +8,14 @@ export function checkCodebaseMapFresh(projectRoot, options) {
     const resolvedOutput = isAbsolute(options.outputPath)
         ? options.outputPath
         : join(projectRoot, options.outputPath);
+    // #1932: the generated MAP is an on-demand, gitignored artifact. An absent
+    // projection is OK (advisory) -- the gate must not force per-branch regeneration
+    // + commit, which guaranteed mechanical MAP.md collisions across concurrent
+    // branches. When a MAP IS present locally the freshness check below still flags
+    // it if stale; the durable plan.architecture.codeStructure stays gated by
+    // codebase:validate-structure.
     if (!existsSync(resolvedOutput)) {
-        return [`generated codebase MAP is missing: ${resolvedOutput}`];
+        return [];
     }
     let current;
     try {

package/dist/engine-version.d.ts

@@ -0,0 +1,3 @@
+/** Reads `@deftai/directive-core` version from the installed package.json adjacent to dist/ or src/. */
+export declare function readCorePackageVersion(): string;
+//# sourceMappingURL=engine-version.d.ts.map

package/dist/engine-version.js

@@ -0,0 +1,23 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const FALLBACK_VERSION = "0.0.0";
+function parsePackageVersion(raw) {
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== "object") {
+        return FALLBACK_VERSION;
+    }
+    const version = parsed.version;
+    return typeof version === "string" && version.length > 0 ? version : FALLBACK_VERSION;
+}
+/** Reads `@deftai/directive-core` version from the installed package.json adjacent to dist/ or src/. */
+export function readCorePackageVersion() {
+    try {
+        const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+        return parsePackageVersion(readFileSync(pkgPath, "utf8"));
+    }
+    catch {
+        return FALLBACK_VERSION;
+    }
+}
+//# sourceMappingURL=engine-version.js.map

package/dist/index.js

@@ -1,3 +1,4 @@
+import { readCorePackageVersion } from "./engine-version.js";
 /**
  * `@deftai/directive-core` — the deft directive engine core.
  *
@@ -50,6 +51,6 @@ export * as wipCap from "./wip-cap/index.js";
 export const CORE_PACKAGE = "@deftai/directive-core";
 /** Returns identifying metadata for the core engine package. */
 export function engineInfo() {
-    return { name: CORE_PACKAGE, version: "0.0.0" };
+    return { name: CORE_PACKAGE, version: readCorePackageVersion() };
 }
 //# sourceMappingURL=index.js.map

package/dist/release-e2e/constants.d.ts

@@ -11,6 +11,8 @@ export declare const REHEARSAL_VERSION = "0.0.1";
  * .github/workflows/npm-publish.yml (types -> core -> content -> cli).
  */
 export declare const NPM_PUBLISH_PACKAGES: readonly ["types", "core", "content", "cli"];
+/** #1925: throwaway dist-tag so dry-run does not apply `latest` to 0.0.1. */
+export declare const NPM_E2E_REHEARSAL_TAG = "e2e-rehearsal";
 export declare const NPM_INSTALL_TIMEOUT_SECONDS = 600;
 export declare const NPM_BUILD_TIMEOUT_SECONDS = 600;
 export declare const NPM_PUBLISH_DRYRUN_TIMEOUT_SECONDS = 180;

package/dist/release-e2e/constants.js

@@ -11,6 +11,8 @@ export const REHEARSAL_VERSION = "0.0.1";
  * .github/workflows/npm-publish.yml (types -> core -> content -> cli).
  */
 export const NPM_PUBLISH_PACKAGES = ["types", "core", "content", "cli"];
+/** #1925: throwaway dist-tag so dry-run does not apply `latest` to 0.0.1. */
+export const NPM_E2E_REHEARSAL_TAG = "e2e-rehearsal";
 export const NPM_INSTALL_TIMEOUT_SECONDS = 600;
 export const NPM_BUILD_TIMEOUT_SECONDS = 600;
 export const NPM_PUBLISH_DRYRUN_TIMEOUT_SECONDS = 180;

package/dist/release-e2e/npm-ops.d.ts

@@ -21,7 +21,9 @@ export declare function alignNpmPackageVersions(cloneDir: string, version: strin
  *   2. Resolve pnpm (or `corepack pnpm`) and `pnpm install --frozen-lockfile`.
  *   3. `pnpm -w run build`; dist/ must exist for the dist-only files allowlist.
  *   4. Align the four package.json versions + resolve the workspace protocol.
- *   5. `npm publish --dry-run --access public` per package in dependency order.
+ *   5. `npm publish --dry-run --access public --tag e2e-rehearsal` per package
+ *      in dependency order (#1925 bypasses implicit-`latest` when the rehearsal
+ *      sentinel is below the highest published version).
  *
  * Returns [ok, reason] like verifyDraftRelease / verifyTag.
  */

package/dist/release-e2e/npm-ops.js

@@ -1,7 +1,7 @@
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { defaultWhich, spawnText } from "../release/spawn.js";
-import { NPM_BUILD_TIMEOUT_SECONDS, NPM_INSTALL_TIMEOUT_SECONDS, NPM_PUBLISH_DRYRUN_TIMEOUT_SECONDS, NPM_PUBLISH_PACKAGES, } from "./constants.js";
+import { NPM_BUILD_TIMEOUT_SECONDS, NPM_E2E_REHEARSAL_TAG, NPM_INSTALL_TIMEOUT_SECONDS, NPM_PUBLISH_DRYRUN_TIMEOUT_SECONDS, NPM_PUBLISH_PACKAGES, } from "./constants.js";
 /**
  * npm publish dry-run rehearsal (#1910) -- the TS port of the
  * scripts/release_e2e.py helpers of the same name. Mirrors
@@ -102,7 +102,9 @@ export function alignNpmPackageVersions(cloneDir, version) {
  *   2. Resolve pnpm (or `corepack pnpm`) and `pnpm install --frozen-lockfile`.
  *   3. `pnpm -w run build`; dist/ must exist for the dist-only files allowlist.
  *   4. Align the four package.json versions + resolve the workspace protocol.
- *   5. `npm publish --dry-run --access public` per package in dependency order.
+ *   5. `npm publish --dry-run --access public --tag e2e-rehearsal` per package
+ *      in dependency order (#1925 bypasses implicit-`latest` when the rehearsal
+ *      sentinel is below the highest published version).
  *
  * Returns [ok, reason] like verifyDraftRelease / verifyTag.
  */
@@ -135,7 +137,7 @@ export function rehearseNpmPublish(cloneDir, version, seams = {}) {
     }
     for (const pkg of NPM_PUBLISH_PACKAGES) {
         const pkgDir = join(cloneDir, "packages", pkg);
-        [ok, reason] = runNpmStep([npmPath, "publish", "--dry-run", "--access", "public"], pkgDir, env, `npm publish --dry-run packages/${pkg}`, NPM_PUBLISH_DRYRUN_TIMEOUT_SECONDS, seams);
+        [ok, reason] = runNpmStep([npmPath, "publish", "--dry-run", "--access", "public", "--tag", NPM_E2E_REHEARSAL_TAG], pkgDir, env, `npm publish --dry-run --tag ${NPM_E2E_REHEARSAL_TAG} packages/${pkg}`, NPM_PUBLISH_DRYRUN_TIMEOUT_SECONDS, seams);
         if (!ok) {
             return [false, reason];
         }

package/dist/swarm/routing-verify.js

@@ -73,7 +73,7 @@ export function verifyRouting(options) {
         if (undecided.length === 0 && invalid.length === 0) {
             return {
                 exitCode: EXIT_OK,
-                report: `[deft routing] provider '${provider}': all ${roles.length} gated role(s) decided.`,
+                report: `[deft routing] provider '${provider}': all ${roles.length} gated role(s) decided.\n[deft routing] NOTE: plan.policy.swarmSubagentBackend enum is deprecated (#1891); use 'task swarm:routing-set' / .deft/routing.local.json instead.`,
             };
         }
         const parts = [];
@@ -85,7 +85,7 @@ export function verifyRouting(options) {
         }
         return {
             exitCode: EXIT_OK,
-            report: `[deft routing] provider '${provider}' -- ${parts.join("; ")}. Decide before swarm dispatch: ${ROUTING_SET_CMD}`,
+            report: `[deft routing] provider '${provider}' -- ${parts.join("; ")}. Decide before swarm dispatch: ${ROUTING_SET_CMD}\n[deft routing] NOTE: plan.policy.swarmSubagentBackend enum is deprecated (#1891); use 'task swarm:routing-set' / .deft/routing.local.json instead.`,
         };
     }
     if (undecided.length > 0) {

package/dist/swarm/subagent-backend.d.ts

@@ -1,11 +1,27 @@
+/**
+ * @deprecated This module is superseded by per-role operator model routing
+ * (`.deft/routing.local.json`) introduced in #1739 / #1863.
+ *
+ * Use `task swarm:routing-set` and `task verify:routing` instead.
+ * See `packages/core/src/swarm/routing.ts` for the current implementation.
+ *
+ * The enum and associated helpers remain functional for consumers that have not
+ * yet migrated; they will be removed in a future major cleanup tracked by #1860.
+ *
+ * @see {@link https://github.com/deftai/directive/issues/1739} Superseding PR
+ * @see {@link https://github.com/deftai/directive/issues/1860} Hard deletion tracking
+ */
 import { LEAF_CODING_WORKER_ROLE } from "./constants.js";
+/** @deprecated Superseded by `.deft/routing.local.json` routing (#1739). Use `task swarm:routing-set`. */
 export declare const KNOWN_SUBAGENT_BACKEND_IDS: Set<string>;
+/** @deprecated Superseded by `.deft/routing.local.json` routing (#1739). Use `task swarm:routing-set`. */
 export interface SubagentBackendDescriptor {
     readonly backend_id: string;
     readonly display_name: string;
     readonly roles: readonly string[];
     readonly available: boolean;
 }
+/** @deprecated Superseded by `.deft/routing.local.json` routing (#1739). Use `task swarm:routing-set`. */
 export interface SwarmSubagentBackendResult {
     readonly backend_id: string | null;
     readonly source: string;

package/dist/swarm/subagent-backend.js

@@ -1,6 +1,20 @@
+/**
+ * @deprecated This module is superseded by per-role operator model routing
+ * (`.deft/routing.local.json`) introduced in #1739 / #1863.
+ *
+ * Use `task swarm:routing-set` and `task verify:routing` instead.
+ * See `packages/core/src/swarm/routing.ts` for the current implementation.
+ *
+ * The enum and associated helpers remain functional for consumers that have not
+ * yet migrated; they will be removed in a future major cleanup tracked by #1860.
+ *
+ * @see {@link https://github.com/deftai/directive/issues/1739} Superseding PR
+ * @see {@link https://github.com/deftai/directive/issues/1860} Hard deletion tracking
+ */
 import { loadProjectDefinition } from "../policy/resolve.js";
 import { LEAF_CODING_WORKER_ROLE, SUBAGENT_BACKEND_SET_CMD } from "./constants.js";
 const TRUTHY = new Set(["1", "true", "yes", "on"]);
+/** @deprecated Superseded by `.deft/routing.local.json` routing (#1739). Use `task swarm:routing-set`. */
 export const KNOWN_SUBAGENT_BACKEND_IDS = new Set(["composer", "grok-build", "cursor-cloud"]);
 const SUBAGENT_BACKEND_CATALOG = {
     composer: {

package/package.json

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