@deftai/directive 0.56.1 → 0.57.0

package/dist/agents-refresh.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+export interface AgentsRefreshArgs {
+    projectRoot: string;
+    check: boolean;
+    dryRun: boolean;
+    error?: string;
+}
+export declare function parseAgentsRefreshArgs(argv: readonly string[]): AgentsRefreshArgs;
+export declare function runAgentsRefresh(argv: readonly string[]): number;
+export declare function run(argv: readonly string[]): number;
+//# sourceMappingURL=agents-refresh.d.ts.map

package/dist/agents-refresh.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+/**
+ * agents:refresh — rewrite AGENTS.md managed section from the canonical template (#768 / #1996).
+ */
+import { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { agentsRefreshPlan } from "@deftai/directive-core/platform";
+export function parseAgentsRefreshArgs(argv) {
+    let projectRoot = process.cwd();
+    let check = false;
+    let dryRun = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i] ?? "";
+        if (arg === "--check") {
+            check = true;
+        }
+        else if (arg === "--dry-run") {
+            dryRun = true;
+        }
+        else if (arg === "--project-root") {
+            const next = argv[i + 1];
+            if (next === undefined) {
+                return { projectRoot, check, dryRun, error: "missing --project-root value" };
+            }
+            projectRoot = next;
+            i += 1;
+        }
+        else if (arg.startsWith("--project-root=")) {
+            projectRoot = arg.slice("--project-root=".length);
+        }
+        else {
+            return { projectRoot, check, dryRun, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return { projectRoot: resolve(projectRoot), check, dryRun };
+}
+export function runAgentsRefresh(argv) {
+    const args = parseAgentsRefreshArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`agents:refresh: ${args.error}\n`);
+        return 2;
+    }
+    const plan = agentsRefreshPlan(args.projectRoot);
+    const state = String(plan.state ?? "unknown");
+    if (args.check) {
+        if (state === "current")
+            return 0;
+        process.stderr.write(`agents:refresh --check: AGENTS.md state is ${state}\n`);
+        return 1;
+    }
+    if (state === "current") {
+        process.stdout.write("AGENTS.md managed section is current — no changes.\n");
+        return 0;
+    }
+    if (state === "template-missing" || state === "template-malformed" || state === "unreadable") {
+        process.stderr.write(`agents:refresh failed: ${state}\n`);
+        return 2;
+    }
+    const newContent = plan.new_content;
+    if (typeof newContent !== "string") {
+        process.stderr.write("agents:refresh failed: plan produced no new_content\n");
+        return 2;
+    }
+    const path = String(plan.path ?? resolve(args.projectRoot, "AGENTS.md"));
+    if (args.dryRun) {
+        process.stdout.write(`[dry-run] would write ${path} (state=${state})\n`);
+        return 0;
+    }
+    writeFileSync(path, newContent, "utf8");
+    process.stdout.write(`AGENTS.md updated (state=${state}).\n`);
+    return 0;
+}
+export function run(argv) {
+    return runAgentsRefresh(argv);
+}
+/* v8 ignore start -- entry guard */
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+/* v8 ignore stop */
+//# sourceMappingURL=agents-refresh.js.map

package/dist/cache.d.ts

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { main } from "../../core/dist/cache/main.js";
+import { main } from "@deftai/directive-core/dist/cache/main.js";
 export { main };
 //# sourceMappingURL=cache.d.ts.map

package/dist/cache.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { main } from "../../core/dist/cache/main.js";
+import { main } from "@deftai/directive-core/dist/cache/main.js";
 /* v8 ignore start -- entry guard; behaviour covered via main() unit tests */
 if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
     process.exit(main(process.argv.slice(2)));

package/dist/cli-router/route-argv.js

@@ -126,6 +126,12 @@ function routeNamespaceVerb(ns, verb, rest) {
     if (resolveCanonicalVerb(colonKey) !== null) {
         return { kind: "dispatch", argv: [colonKey, ...rest] };
     }
+    if (ns === "framework" && verb === "doctor") {
+        return { kind: "dispatch", argv: ["doctor", ...rest] };
+    }
+    if (ns === "agents" && verb === "refresh") {
+        return { kind: "dispatch", argv: ["agents-refresh", ...rest] };
+    }
     if (ns === "scope") {
         if (SCOPE_LIFECYCLE_VERBS.has(verb)) {
             return { kind: "dispatch", argv: ["scope-lifecycle", verb, ...rest] };

package/dist/dispatch.d.ts

@@ -8,7 +8,7 @@ export interface DispatchIo {
     writeErr: (text: string) => void;
 }
 /** CLI modules in packages/cli/src (excluding parity harnesses and bin/index). */
-export declare const CLI_MODULE_VERBS: readonly ["cache", "check", "capacity-backfill", "capacity-show", "codebase-default-extractor", "codebase-map", "codebase-map-fresh", "codebase-projection-registry", "codebase-provider", "doctor", "parity", "policy", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "verify-branch", "verify-encoding", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-bridge-drift", "verify-capacity", "verify-content-manifest", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-stubs", "rule-ownership-lint", "verify-story-ready", "verify-tools", "verify-wip-cap"];
+export declare const CLI_MODULE_VERBS: readonly ["agents-refresh", "cache", "check", "capacity-backfill", "capacity-show", "codebase-default-extractor", "codebase-map", "codebase-map-fresh", "codebase-projection-registry", "codebase-provider", "doctor", "parity", "policy", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "verify-branch", "verify-encoding", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-bridge-drift", "verify-capacity", "verify-content-manifest", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-stubs", "rule-ownership-lint", "verify-story-ready", "verify-tools", "verify-wip-cap"];
 /** Core-only CLI entrypoints without a packages/cli wrapper. */
 export declare const CORE_MODULE_VERBS: readonly ["scm", "github-auth-modes", "github-body", "issue-emit", "issue-ingest", "reconcile-issues", "swarm-launch", "swarm-complete-cohort", "swarm-readiness", "swarm-routing-verify", "swarm-routing-set", "swarm-verify-review-clean", "swarm-worktrees", "framework-commands", "pack-render", "packs-slice", "prd-render", "project-render", "roadmap-render", "spec-render", "spec-validate", "code-structure-validate", "pack-migrate-skills", "pack-migrate-rules", "pack-migrate-strategies", "pack-migrate-patterns", "pack-migrate-swarm-spec", "policy-set", "scope-undo", "scope-demote", "scope-decompose", "changelog-resolve-unreleased", "architecture-preflight-sor"];
 /** Task-style aliases (framework_commands / Taskfile names). */

package/dist/dispatch.js

@@ -17,6 +17,7 @@ const HANDLER_KEYS = [
 ];
 /** CLI modules in packages/cli/src (excluding parity harnesses and bin/index). */
 export const CLI_MODULE_VERBS = [
+    "agents-refresh",
     "cache",
     "check",
     "capacity-backfill",
@@ -158,6 +159,7 @@ export const VERB_ALIASES = {
     "triage:scope": "triage-scope",
     "triage:accept": "triage-actions",
     "triage:status": "triage-actions",
+    "agents:refresh": "agents-refresh",
     "session:start": "framework-commands",
     "toolchain:check": "toolchain-check",
     "ts:check-lane": "ts-check-lane",
@@ -343,55 +345,55 @@ function loadPythonScriptHandler(scriptName) {
 async function loadCoreModuleHandler(verb, io) {
     switch (verb) {
         case "scm": {
-            const { main } = await import("../../core/dist/scm/main.js");
+            const { main } = await import("@deftai/directive-core/dist/scm/main.js");
             return (argv) => main(argv);
         }
         case "github-auth-modes": {
-            const { mainEntry } = await import("../../core/dist/intake/github-auth-modes-cli.js");
+            const { mainEntry } = await import("@deftai/directive-core/dist/intake/github-auth-modes-cli.js");
             return mainEntry;
         }
         case "github-body": {
-            const { mainEntry } = await import("../../core/dist/intake/github-body-cli.js");
+            const { mainEntry } = await import("@deftai/directive-core/dist/intake/github-body-cli.js");
             return mainEntry;
         }
         case "issue-emit": {
-            const { mainEntry } = await import("../../core/dist/intake/issue-emit-cli.js");
+            const { mainEntry } = await import("@deftai/directive-core/dist/intake/issue-emit-cli.js");
             return mainEntry;
         }
         case "issue-ingest": {
-            const { mainEntry } = await import("../../core/dist/intake/issue-ingest-cli.js");
+            const { mainEntry } = await import("@deftai/directive-core/dist/intake/issue-ingest-cli.js");
             return mainEntry;
         }
         case "reconcile-issues": {
-            const { mainEntry } = await import("../../core/dist/intake/reconcile-issues-cli.js");
+            const { mainEntry } = await import("@deftai/directive-core/dist/intake/reconcile-issues-cli.js");
             return mainEntry;
         }
         case "swarm-launch": {
-            const { launchMain } = await import("../../core/dist/swarm/launch-cli.js");
+            const { launchMain } = await import("@deftai/directive-core/dist/swarm/launch-cli.js");
             return launchMain;
         }
         case "swarm-complete-cohort": {
-            const { completeCohortMain } = await import("../../core/dist/swarm/complete-cohort-cli.js");
+            const { completeCohortMain } = await import("@deftai/directive-core/dist/swarm/complete-cohort-cli.js");
             return completeCohortMain;
         }
         case "swarm-readiness": {
-            const { readinessMain } = await import("../../core/dist/swarm/readiness-cli.js");
+            const { readinessMain } = await import("@deftai/directive-core/dist/swarm/readiness-cli.js");
             return readinessMain;
         }
         case "swarm-routing-verify": {
-            const { routingVerifyMain } = await import("../../core/dist/swarm/routing-verify-cli.js");
+            const { routingVerifyMain } = await import("@deftai/directive-core/dist/swarm/routing-verify-cli.js");
             return routingVerifyMain;
         }
         case "swarm-routing-set": {
-            const { routingSetMain } = await import("../../core/dist/swarm/routing-set-cli.js");
+            const { routingSetMain } = await import("@deftai/directive-core/dist/swarm/routing-set-cli.js");
             return routingSetMain;
         }
         case "swarm-verify-review-clean": {
-            const { verifyReviewCleanMain } = await import("../../core/dist/swarm/verify-review-clean-cli.js");
+            const { verifyReviewCleanMain } = await import("@deftai/directive-core/dist/swarm/verify-review-clean-cli.js");
             return verifyReviewCleanMain;
         }
         case "swarm-worktrees": {
-            const { worktreesMain } = await import("../../core/dist/swarm/worktrees-cli.js");
+            const { worktreesMain } = await import("@deftai/directive-core/dist/swarm/worktrees-cli.js");
             return worktreesMain;
         }
         case "framework-commands": {
@@ -399,15 +401,15 @@ async function loadCoreModuleHandler(verb, io) {
             return (argv) => frameworkCommandsMain(argv);
         }
         case "pack-render": {
-            const { main } = await import("../../core/dist/packs/pack-render.js");
+            const { main } = await import("@deftai/directive-core/dist/packs/pack-render.js");
             return (argv) => main([...argv]);
         }
         case "packs-slice": {
-            const { main } = await import("../../core/dist/packs/packs-slice.js");
+            const { main } = await import("@deftai/directive-core/dist/packs/packs-slice.js");
             return (argv) => main([...argv]);
         }
         case "roadmap-render": {
-            const { main } = await import("../../core/dist/render/roadmap-render.js");
+            const { main } = await import("@deftai/directive-core/dist/render/roadmap-render.js");
             return (argv) => main(argv);
         }
         case "spec-validate": {
@@ -459,23 +461,23 @@ async function loadCoreModuleHandler(verb, io) {
         case "policy-set":
             return loadPythonScriptHandler("policy_set.py");
         case "scope-undo": {
-            const { undoMain } = await import("../../core/dist/scope/main.js");
+            const { undoMain } = await import("@deftai/directive-core/dist/scope/main.js");
             return undoMain;
         }
         case "scope-demote": {
-            const { demoteMain } = await import("../../core/dist/scope/main.js");
+            const { demoteMain } = await import("@deftai/directive-core/dist/scope/main.js");
             return demoteMain;
         }
         case "scope-decompose": {
-            const { decomposeMain } = await import("../../core/dist/scope/decompose.js");
+            const { decomposeMain } = await import("@deftai/directive-core/dist/scope/decompose.js");
             return decomposeMain;
         }
         case "changelog-resolve-unreleased": {
-            const { changelogResolveUnreleasedMain } = await import("../../core/dist/platform/changelog-cli.js");
+            const { changelogResolveUnreleasedMain } = await import("@deftai/directive-core/dist/platform/changelog-cli.js");
             return changelogResolveUnreleasedMain;
         }
         case "architecture-preflight-sor": {
-            const { architecturePreflightSorMain } = await import("../../core/dist/architecture/sor-preflight.js");
+            const { architecturePreflightSorMain } = await import("@deftai/directive-core/dist/architecture/sor-preflight.js");
             return architecturePreflightSorMain;
         }
         default:

package/dist/doc-cli-parity.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Doc ↔ CLI parity gate (#1996).
+ *
+ * Extracts npm-canonical CLI invocations from UPGRADING.md and the AGENTS.md
+ * managed-section template, then asserts each resolves through the top-level
+ * router to a registered dispatcher verb (or an explicitly allowlisted legacy
+ * back-compat surface documented post-#1912).
+ */
+/** Documented legacy surfaces that remain in prose but are not npm-router verbs. */
+export declare const LEGACY_DOC_VERB_KEYS: Set<string>;
+export interface DocCliReference {
+    readonly source: string;
+    readonly raw: string;
+    readonly normalized: string;
+}
+export interface DocCliParityFailure {
+    readonly source: string;
+    readonly raw: string;
+    readonly reason: string;
+}
+/** Pull CLI command references from UPGRADING.md + agents-entry managed section. */
+export declare function extractDocCliReferences(repoRoot?: string): DocCliReference[];
+/** Strip flags/placeholders; return null when the literal is not a CLI verb invocation. */
+export declare function normalizeDocCommand(raw: string): string | null;
+/** Validate one normalized doc command against the router + registeredVerbs(). */
+export declare function validateDocCliCommand(normalized: string): string | null;
+/** Run the parity gate; returns failure rows (empty == pass). */
+export declare function collectDocCliParityFailures(repoRoot?: string): DocCliParityFailure[];
+//# sourceMappingURL=doc-cli-parity.d.ts.map

package/dist/doc-cli-parity.js

@@ -0,0 +1,159 @@
+/**
+ * Doc ↔ CLI parity gate (#1996).
+ *
+ * Extracts npm-canonical CLI invocations from UPGRADING.md and the AGENTS.md
+ * managed-section template, then asserts each resolves through the top-level
+ * router to a registered dispatcher verb (or an explicitly allowlisted legacy
+ * back-compat surface documented post-#1912).
+ */
+import { readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { hasCommand } from "@deftai/directive-core/render";
+import { routeArgv } from "./cli-router/route-argv.js";
+import { registeredVerbs, resolveCanonicalVerb, VERB_ALIASES } from "./dispatch.js";
+/** Documented legacy surfaces that remain in prose but are not npm-router verbs. */
+export const LEGACY_DOC_VERB_KEYS = new Set(["setup", "upgrade", "relocate"]);
+const CLI_PREFIX_RE = /^(?:directive|deft|npx @deftai\/directive)\s+/;
+const BACKTICK_COMMAND_RE = /`((?:directive|deft|npx @deftai\/directive)\s+[^`]+)`/g;
+const TOP_LEVEL_UX = new Set(["init", "update", "migrate"]);
+function repoRootFromModule() {
+    return resolve(import.meta.dirname, "..", "..", "..");
+}
+function extractManagedSection(text) {
+    const open = text.indexOf("<!-- deft:managed-section");
+    if (open < 0)
+        return text;
+    const close = text.indexOf("<!-- /deft:managed-section -->", open);
+    if (close < 0)
+        return text.slice(open);
+    return text.slice(open, close);
+}
+/** Pull CLI command references from UPGRADING.md + agents-entry managed section. */
+export function extractDocCliReferences(repoRoot = repoRootFromModule()) {
+    const sources = [
+        ["content/UPGRADING.md", readFileSync(join(repoRoot, "content/UPGRADING.md"), "utf8")],
+        [
+            "content/templates/agents-entry.md",
+            extractManagedSection(readFileSync(join(repoRoot, "content/templates/agents-entry.md"), "utf8")),
+        ],
+    ];
+    const seen = new Set();
+    const out = [];
+    for (const [source, text] of sources) {
+        for (const match of text.matchAll(BACKTICK_COMMAND_RE)) {
+            const raw = match[1]?.trim() ?? "";
+            if (!CLI_PREFIX_RE.test(raw))
+                continue;
+            const normalized = normalizeDocCommand(raw);
+            if (normalized === null)
+                continue;
+            const key = `${source}\0${normalized}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push({ source, raw, normalized });
+        }
+    }
+    return out.sort((a, b) => a.source.localeCompare(b.source) || a.normalized.localeCompare(b.normalized));
+}
+function stripAnglePlaceholders(text) {
+    let out = text;
+    let start = out.indexOf("<");
+    while (start >= 0) {
+        const end = out.indexOf(">", start + 1);
+        if (end < 0)
+            break;
+        out = `${out.slice(0, start)}${out.slice(end + 1)}`;
+        start = out.indexOf("<");
+    }
+    return out.trim();
+}
+/** Strip flags/placeholders; return null when the literal is not a CLI verb invocation. */
+export function normalizeDocCommand(raw) {
+    let rest = raw.replace(CLI_PREFIX_RE, "").trim();
+    if (rest.length === 0)
+        return null;
+    const dd = rest.indexOf(" --");
+    if (dd >= 0)
+        rest = rest.slice(0, dd).trim();
+    rest = rest.replace(/\s+\[[^\]]*\]/g, "").trim();
+    rest = rest.replace(/\s+--[^\s]+(\s+[^\s]+)?/g, "").trim();
+    rest = stripAnglePlaceholders(rest);
+    if (rest.includes("/") || rest.includes(".md") || rest.includes("*"))
+        return null;
+    if (/^deft-install\b/.test(rest))
+        return null;
+    if (/^deft-directive\b/.test(rest))
+        return null;
+    if (/^deftai\b/.test(rest))
+        return null;
+    const first = rest.split(/\s+/)[0] ?? "";
+    if (!/^[\w:-]+$/.test(first))
+        return null;
+    if (first.includes(":")) {
+        return first;
+    }
+    return first;
+}
+function tokenizeDocVerb(normalized) {
+    if (normalized.includes(":")) {
+        const colon = normalized.indexOf(":");
+        return [normalized.slice(0, colon), normalized.slice(colon + 1)];
+    }
+    return [normalized];
+}
+function colonKeyFromNormalized(normalized) {
+    if (normalized.includes(":"))
+        return normalized;
+    return null;
+}
+function isRegisteredHandler(flatVerb) {
+    const verbs = new Set(registeredVerbs());
+    if (verbs.has(flatVerb))
+        return true;
+    const canon = resolveCanonicalVerb(flatVerb);
+    return canon !== null && verbs.has(canon);
+}
+/** Validate one normalized doc command against the router + registeredVerbs(). */
+export function validateDocCliCommand(normalized) {
+    const colonKey = colonKeyFromNormalized(normalized);
+    if (colonKey !== null) {
+        if (LEGACY_DOC_VERB_KEYS.has(colonKey)) {
+            return null;
+        }
+        if (colonKey in VERB_ALIASES || hasCommand(colonKey)) {
+            return null;
+        }
+    }
+    else if (LEGACY_DOC_VERB_KEYS.has(normalized)) {
+        return null;
+    }
+    const tokens = tokenizeDocVerb(normalized);
+    const routed = routeArgv(tokens);
+    if (routed.kind === "stub") {
+        return routed.stubMessage ?? "routes to stub handler";
+    }
+    const head = routed.argv[0];
+    if (head === undefined || head.length === 0) {
+        return "router produced empty argv";
+    }
+    if (TOP_LEVEL_UX.has(head)) {
+        return null;
+    }
+    if (isRegisteredHandler(head)) {
+        return null;
+    }
+    return `unregistered handler '${head}' (tokens=${JSON.stringify(tokens)}, routed=${JSON.stringify(routed.argv.slice(0, 3))})`;
+}
+/** Run the parity gate; returns failure rows (empty == pass). */
+export function collectDocCliParityFailures(repoRoot = repoRootFromModule()) {
+    const failures = [];
+    for (const ref of extractDocCliReferences(repoRoot)) {
+        const reason = validateDocCliCommand(ref.normalized);
+        if (reason !== null) {
+            failures.push({ source: ref.source, raw: ref.raw, reason });
+        }
+    }
+    return failures;
+}
+//# sourceMappingURL=doc-cli-parity.js.map

package/dist/doctor.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdDoctor } from "../../core/dist/doctor/main.js";
+import { cmdDoctor } from "@deftai/directive-core/dist/doctor/main.js";
 export function run(argv) {
     return cmdDoctor(argv);
 }

package/dist/pr-closing-keywords.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdPrCheckClosingKeywords } from "../../core/dist/pr-closing-keywords/main.js";
+import { cmdPrCheckClosingKeywords } from "@deftai/directive-core/dist/pr-closing-keywords/main.js";
 export function run(argv) {
     return cmdPrCheckClosingKeywords(argv);
 }

package/dist/pr-merge-readiness.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdPrMergeReadiness } from "../../core/dist/pr-merge-readiness/main.js";
+import { cmdPrMergeReadiness } from "@deftai/directive-core/dist/pr-merge-readiness/main.js";
 export function run(argv) {
     return cmdPrMergeReadiness(argv);
 }

package/dist/pr-monitor.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdPrMonitor } from "../../core/dist/pr-monitor/main.js";
+import { cmdPrMonitor } from "@deftai/directive-core/dist/pr-monitor/main.js";
 export function run(argv) {
     return cmdPrMonitor(argv);
 }

package/dist/pr-protected-issues.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdPrProtectedIssues } from "../../core/dist/pr-protected-issues/main.js";
+import { cmdPrProtectedIssues } from "@deftai/directive-core/dist/pr-protected-issues/main.js";
 export function run(argv) {
     return cmdPrProtectedIssues(argv);
 }

package/dist/pr-wait-mergeable.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdPrWaitMergeable } from "../../core/dist/pr-wait-mergeable/main.js";
+import { cmdPrWaitMergeable } from "@deftai/directive-core/dist/pr-wait-mergeable/main.js";
 export function run(argv) {
     return cmdPrWaitMergeable(argv);
 }

package/dist/release-e2e.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdReleaseE2e } from "../../core/dist/release-e2e/main.js";
+import { cmdReleaseE2e } from "@deftai/directive-core/dist/release-e2e/main.js";
 export function run(argv) {
     return cmdReleaseE2e(argv);
 }

package/dist/release-publish.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdReleasePublish } from "../../core/dist/release-publish/main.js";
+import { cmdReleasePublish } from "@deftai/directive-core/dist/release-publish/main.js";
 export function run(argv) {
     return cmdReleasePublish(argv);
 }

package/dist/release-rollback.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdRollback } from "../../core/dist/release-rollback/main.js";
+import { cmdRollback } from "@deftai/directive-core/dist/release-rollback/main.js";
 export function run(argv) {
     return cmdRollback(argv);
 }

package/dist/release.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { cmdRelease } from "../../core/dist/release/main.js";
+import { cmdRelease } from "@deftai/directive-core/dist/release/main.js";
 export function run(argv) {
     return cmdRelease(argv);
 }

package/dist/scope-lifecycle.js

@@ -4,10 +4,15 @@
  * Delegates to packages/core/dist/scope/cli.js.
  */
 import { spawnSync } from "node:child_process";
-import { dirname, join } from "node:path";
+import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
+const require = createRequire(import.meta.url);
+// Resolve the core CLI by its published package name so it works both in the
+// source monorepo and under a flattened npm install (#1993). The bare specifier
+// resolves via @deftai/directive-core's "./dist/*.js" export map; a hand-built
+// relative path would point at the non-existent "@deftai/core" once published.
 function coreCliPath() {
-    return join(dirname(fileURLToPath(import.meta.url)), "../../core/dist/scope/cli.js");
+    return require.resolve("@deftai/directive-core/dist/scope/cli.js");
 }
 /** Run scope lifecycle with argv; returns process exit code. */
 export function run(argv) {

package/dist/slice.js

@@ -4,10 +4,15 @@
  * Delegates to the core implementation at packages/core/dist/slice/cli.js.
  */
 import { spawnSync } from "node:child_process";
-import { dirname, join } from "node:path";
+import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
+const require = createRequire(import.meta.url);
+// Resolve the core CLI by its published package name so it works both in the
+// source monorepo and under a flattened npm install (#1993). The bare specifier
+// resolves via @deftai/directive-core's "./dist/*.js" export map; a hand-built
+// relative path would point at the non-existent "@deftai/core" once published.
 function coreCliPath() {
-    return join(dirname(fileURLToPath(import.meta.url)), "../../core/dist/slice/cli.js");
+    return require.resolve("@deftai/directive-core/dist/slice/cli.js");
 }
 /** Run slice verbs with argv; returns process exit code. */
 export function run(argv) {

package/dist/triage-actions-parity.js

@@ -11,7 +11,7 @@ import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { cachePut } from "../../core/dist/cache/operations.js";
+import { cachePut } from "@deftai/directive-core/dist/cache/operations.js";
 /** Strip volatile UUIDs and timestamps before compare. */
 export function normalizeOutput(text) {
     return text

package/dist/triage-actions.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { accept, createDefaultDeps, deferAction, formatDecision, history, markDuplicate, needsAc, reject, reset, status, TriageError, UpstreamCloseError, } from "../../core/dist/triage/actions/index.js";
+import { accept, createDefaultDeps, deferAction, formatDecision, history, markDuplicate, needsAc, reject, reset, status, TriageError, UpstreamCloseError, } from "@deftai/directive-core/dist/triage/actions/index.js";
 const VALID_CMDS = new Set([
     "accept",
     "reject",

package/dist/triage-bootstrap.d.ts

@@ -13,7 +13,7 @@ export interface ParsedArgs {
     emitJson: boolean;
     error?: string;
 }
-type BootstrapModule = typeof import("../../core/dist/triage/bootstrap/index.js");
+type BootstrapModule = typeof import("@deftai/directive-core/dist/triage/bootstrap/index.js");
 /** Parse triage-bootstrap CLI args, mirroring the Python argparse surface. */
 export declare function parseArgs(argv: string[]): ParsedArgs;
 /** Run triage:bootstrap with an injected core module (test seam). */

package/dist/triage-bootstrap.js

@@ -1,10 +1,13 @@
 #!/usr/bin/env node
 import { statSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 async function loadBootstrapModule() {
-    const corePath = join(dirname(fileURLToPath(import.meta.url)), "../../core/dist/triage/bootstrap/index.js");
-    return import(pathToFileURL(corePath).href);
+    // Direct dynamic import of the published package subpath -- resolves via core's
+    // "./dist/*.js" export map in both the monorepo and a flat npm install (#1993).
+    // The prior hand-built relative path broke once published (and my mechanical
+    // import rewrite turned it into a non-existent path under packages/cli/dist).
+    return import("@deftai/directive-core/dist/triage/bootstrap/index.js");
 }
 /** Parse triage-bootstrap CLI args, mirroring the Python argparse surface. */
 export function parseArgs(argv) {

package/dist/triage-bulk.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { bulkActionWithDefaults, CacheEmptyError } from "../../core/dist/triage/bulk/index.js";
-import { interceptHelp } from "../../core/dist/triage/help/index.js";
+import { bulkActionWithDefaults, CacheEmptyError, } from "@deftai/directive-core/dist/triage/bulk/index.js";
+import { interceptHelp } from "@deftai/directive-core/dist/triage/help/index.js";
 export function parseArgs(argv) {
     const parsed = {
         action: "",

package/dist/triage-classify.js

@@ -2,7 +2,7 @@
 import { statSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { listProject, validateProject } from "../../core/dist/triage/classify/index.js";
+import { listProject, validateProject } from "@deftai/directive-core/dist/triage/classify/index.js";
 /** Parse triage-classify CLI args, mirroring the Python argparse surface. */
 export function parseArgs(argv) {
     const parsed = {

package/dist/triage-help.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
-import { runHelp } from "../../core/dist/triage/help/index.js";
+import { runHelp } from "@deftai/directive-core/dist/triage/help/index.js";
 export function run(argv) {
     return runHelp(argv);
 }

package/dist/triage-queue.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { activeReferencedIssueNumbers, buildQueue, collectOrphanIssueNumbers, DEFAULT_QUEUE_LIMIT, loadCachedIssues, loadSliceRecords, readAuditEntries, renderQueue, resolveRankingLabels, resolveRepo, } from "../../core/dist/triage/queue/index.js";
+import { activeReferencedIssueNumbers, buildQueue, collectOrphanIssueNumbers, DEFAULT_QUEUE_LIMIT, loadCachedIssues, loadSliceRecords, readAuditEntries, renderQueue, resolveRankingLabels, resolveRepo, } from "@deftai/directive-core/dist/triage/queue/index.js";
 /** Parse triage-queue CLI args for the queue subcommand. */
 export function parseArgs(argv) {
     const parsed = {

package/dist/triage-reconcile.js

@@ -2,7 +2,7 @@
 import { statSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { emitReconcileJson, reconcile, reconcileSummary, } from "../../core/dist/triage/reconcile/index.js";
+import { emitReconcileJson, reconcile, reconcileSummary, } from "@deftai/directive-core/dist/triage/reconcile/index.js";
 export function parseArgs(argv) {
     const parsed = {
         projectRoot: process.env.DEFT_PROJECT_ROOT ?? ".",

package/dist/triage-refresh.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { refreshActive } from "../../core/dist/triage/refresh/index.js";
+import { refreshActive } from "@deftai/directive-core/dist/triage/refresh/index.js";
 export function parseArgs(argv) {
     let projectRoot = ".";
     for (let i = 0; i < argv.length; i += 1) {

package/dist/triage-scope-drift.js

@@ -2,7 +2,7 @@
 import { statSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { addIgnore, computeDrift, renderDriftReport, } from "../../core/dist/triage/scope-drift/index.js";
+import { addIgnore, computeDrift, renderDriftReport, } from "@deftai/directive-core/dist/triage/scope-drift/index.js";
 export function parseArgs(argv) {
     const parsed = { projectRoot: process.env.DEFT_PROJECT_ROOT ?? "." };
     for (let i = 0; i < argv.length; i += 1) {

package/dist/triage-scope.js

@@ -4,10 +4,15 @@
  * Delegates to the core implementation at packages/core/dist/triage/scope/cli.js.
  */
 import { spawnSync } from "node:child_process";
-import { dirname, join } from "node:path";
+import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
+const require = createRequire(import.meta.url);
+// Resolve the core CLI by its published package name so it works both in the
+// source monorepo and under a flattened npm install (#1993). The bare specifier
+// resolves via @deftai/directive-core's "./dist/*.js" export map; a hand-built
+// relative path would point at the non-existent "@deftai/core" once published.
 function coreCliPath() {
-    return join(dirname(fileURLToPath(import.meta.url)), "../../core/dist/triage/scope/cli.js");
+    return require.resolve("@deftai/directive-core/dist/triage/scope/cli.js");
 }
 /** Run triage:scope with argv; returns process exit code. */
 export function run(argv) {

package/dist/triage-smoketest.js

@@ -2,8 +2,8 @@
 import { existsSync, statSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { interceptHelp } from "../../core/dist/triage/help/index.js";
-import { DEFAULT_FIXTURE_REL, parseSmoketestArgs, runSmoketest, } from "../../core/dist/triage/smoketest/index.js";
+import { interceptHelp } from "@deftai/directive-core/dist/triage/help/index.js";
+import { DEFAULT_FIXTURE_REL, parseSmoketestArgs, runSmoketest, } from "@deftai/directive-core/dist/triage/smoketest/index.js";
 function resolveDeftRoot() {
     if (process.env.DEFT_ROOT !== undefined && process.env.DEFT_ROOT.length > 0) {
         return resolve(process.env.DEFT_ROOT);

package/dist/triage-subscribe.js

@@ -2,8 +2,8 @@
 import { existsSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { interceptHelp } from "../../core/dist/triage/help/index.js";
-import { RECONCILE_HINT, subscribe, unsubscribe } from "../../core/dist/triage/subscribe/index.js";
+import { interceptHelp } from "@deftai/directive-core/dist/triage/help/index.js";
+import { RECONCILE_HINT, subscribe, unsubscribe, } from "@deftai/directive-core/dist/triage/subscribe/index.js";
 export function parseArgs(argv) {
     const parsed = {
         op: "",

package/dist/triage-summary.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { appendHistory, computeSummary, formatSummary, pythonStyleStringify, SUMMARY_HISTORY_REL_PATH, summaryResultToRecord, utcIso, } from "../../core/dist/triage/summary/index.js";
+import { appendHistory, computeSummary, formatSummary, pythonStyleStringify, SUMMARY_HISTORY_REL_PATH, summaryResultToRecord, utcIso, } from "@deftai/directive-core/dist/triage/summary/index.js";
 /** Parse triage-summary CLI args, mirroring the Python argparse surface. */
 export function parseArgs(argv) {
     const parsed = {

package/dist/triage-welcome.js

@@ -2,7 +2,7 @@
 import { statSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { runDefaultMode } from "../../core/dist/triage/welcome/default-mode.js";
+import { runDefaultMode } from "@deftai/directive-core/dist/triage/welcome/default-mode.js";
 export function parseArgs(argv) {
     const parsed = {
         projectRoot: process.env.DEFT_PROJECT_ROOT ?? ".",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.56.1",
+  "version": "0.57.0",
   "description": "Directive CLI — npm install path for the Deft Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,8 +42,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-core": "^0.56.1",
-    "@deftai/directive-content": "^0.56.1"
+    "@deftai/directive-core": "^0.57.0",
+    "@deftai/directive-content": "^0.57.0"
   },
   "scripts": {
     "build": "tsc -b"