@deftai/directive 0.126.1 → 0.127.0

package/dist/bin.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=bin.d.ts.map

package/dist/branch-fixtures.d.ts

@@ -1,45 +0,0 @@
-export interface ScenarioResult {
-    readonly name: string;
-    readonly exitCode: number;
-    readonly stdout: string;
-    readonly stderr: string;
-}
-export interface ParityScenario {
-    readonly name: string;
-    readonly branch: "default" | "feature" | "detached";
-    readonly defaultBranchName?: string;
-    readonly plan?: Record<string, unknown> | null;
-    readonly allowMissingProjectDefinition?: boolean;
-    readonly env?: Record<string, string | undefined>;
-}
-export interface ParityResult {
-    readonly ok: boolean;
-    readonly scenarios: Array<{
-        readonly name: string;
-        readonly exitMismatch: boolean;
-        readonly pythonExit: number;
-        readonly tsExit: number;
-        readonly messageMismatch: boolean;
-        readonly pythonMessage: string;
-        readonly tsMessage: string;
-    }>;
-}
-/** Scenarios exercised by the parity harness (mirrors Python contract cases). */
-export declare const PARITY_SCENARIOS: readonly ParityScenario[];
-/** Normalise gate message for comparison (trim, collapse whitespace). */
-export declare function normaliseMessage(stdout: string, stderr: string, exitCode: number): string;
-/** Build a fixture git repo for one scenario. */
-export declare function buildScenarioRepo(scenario: ParityScenario): {
-    root: string;
-};
-/** Diff python vs TS gate outputs for one scenario. */
-export declare function diffParity(python: ScenarioResult, ts: ScenarioResult): {
-    exitMismatch: boolean;
-    messageMismatch: boolean;
-    pythonMessage: string;
-    tsMessage: string;
-};
-/** Run all parity scenarios and return a structured result. */
-/** Render a human-readable parity report (exported for unit tests). */
-export declare function renderReport(result: ParityResult): string;
-//# sourceMappingURL=branch-fixtures.d.ts.map

package/dist/branch-fixtures.js

@@ -1,156 +0,0 @@
-/** Test fixtures extracted from legacy parity harness (#2083). */
-import { execFileSync } from "node:child_process";
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-function gitCommit(cwd, message) {
-    execFileSync("git", ["commit", "-q", "-m", message], {
-        cwd,
-        env: {
-            ...process.env,
-            GIT_AUTHOR_NAME: "deft-parity",
-            GIT_AUTHOR_EMAIL: "parity@test.local",
-            GIT_COMMITTER_NAME: "deft-parity",
-            GIT_COMMITTER_EMAIL: "parity@test.local",
-        },
-    });
-}
-function writeProjectDef(root, plan) {
-    const dir = join(root, "xbrief");
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(join(dir, "PROJECT-DEFINITION.xbrief.json"), `${JSON.stringify({
-        xBRIEFInfo: { version: "0.8" },
-        plan: { title: "T", status: "running", items: [], ...plan },
-    }, null, 2)}\n`, { encoding: "utf8" });
-}
-/** Scenarios exercised by the parity harness (mirrors Python contract cases). */
-export const PARITY_SCENARIOS = [
-    {
-        name: "setup-exemption",
-        branch: "default",
-        plan: null,
-        env: { DEFT_SETUP_INTERVIEW: "1", DEFT_ALLOW_DEFAULT_BRANCH_COMMIT: "" },
-    },
-    {
-        name: "feature-branch",
-        branch: "feature",
-        plan: { policy: { allowDirectCommitsToMaster: false } },
-        env: { DEFT_SETUP_INTERVIEW: "", DEFT_ALLOW_DEFAULT_BRANCH_COMMIT: "" },
-    },
-    {
-        name: "detached-head",
-        branch: "detached",
-        plan: { policy: { allowDirectCommitsToMaster: false } },
-        env: { DEFT_SETUP_INTERVIEW: "", DEFT_ALLOW_DEFAULT_BRANCH_COMMIT: "" },
-    },
-    {
-        name: "master-blocked",
-        branch: "default",
-        defaultBranchName: "master",
-        plan: { policy: { allowDirectCommitsToMaster: false } },
-        env: { DEFT_SETUP_INTERVIEW: "", DEFT_ALLOW_DEFAULT_BRANCH_COMMIT: "" },
-    },
-    {
-        name: "master-opt-out-typed",
-        branch: "default",
-        defaultBranchName: "master",
-        plan: { policy: { allowDirectCommitsToMaster: true } },
-        env: { DEFT_SETUP_INTERVIEW: "", DEFT_ALLOW_DEFAULT_BRANCH_COMMIT: "" },
-    },
-    {
-        name: "env-bypass",
-        branch: "default",
-        defaultBranchName: "master",
-        plan: { policy: { allowDirectCommitsToMaster: false } },
-        env: { DEFT_SETUP_INTERVIEW: "", DEFT_ALLOW_DEFAULT_BRANCH_COMMIT: "1" },
-    },
-    {
-        name: "missing-pd-config-error",
-        branch: "default",
-        defaultBranchName: "master",
-        plan: undefined,
-        env: { DEFT_SETUP_INTERVIEW: "", DEFT_ALLOW_DEFAULT_BRANCH_COMMIT: "" },
-    },
-    {
-        name: "missing-pd-bootstrap",
-        branch: "default",
-        defaultBranchName: "master",
-        plan: undefined,
-        allowMissingProjectDefinition: true,
-        env: { DEFT_SETUP_INTERVIEW: "", DEFT_ALLOW_DEFAULT_BRANCH_COMMIT: "" },
-    },
-    {
-        name: "malformed-typed-field",
-        branch: "default",
-        defaultBranchName: "master",
-        plan: { policy: { allowDirectCommitsToMaster: "yes" } },
-        env: { DEFT_SETUP_INTERVIEW: "", DEFT_ALLOW_DEFAULT_BRANCH_COMMIT: "" },
-    },
-];
-/** Normalise gate message for comparison (trim, collapse whitespace). */
-export function normaliseMessage(stdout, stderr, exitCode) {
-    const raw = exitCode === 0 ? stdout : stderr;
-    return raw
-        .trim()
-        .replace(/\s+/g, " ")
-        .replace(/PROJECT-DEFINITION not found at [^\s)]+/g, "PROJECT-DEFINITION not found at <ROOT>");
-}
-/** Build a fixture git repo for one scenario. */
-export function buildScenarioRepo(scenario) {
-    const root = mkdtempSync(join(tmpdir(), "deft-branch-parity-"));
-    const defaultBranch = scenario.defaultBranchName ?? "master";
-    try {
-        writeFileSync(join(root, "README.md"), "# parity\n", "utf8");
-        if (scenario.plan !== null && scenario.plan !== undefined) {
-            writeProjectDef(root, scenario.plan);
-        }
-        execFileSync("git", ["init", "-q"], { cwd: root });
-        execFileSync("git", ["branch", "-M", defaultBranch], { cwd: root });
-        execFileSync("git", ["add", "-A"], { cwd: root });
-        gitCommit(root, "init");
-        if (scenario.branch === "feature") {
-            execFileSync("git", ["checkout", "-q", "-b", "feat/parity"], { cwd: root });
-        }
-        else if (scenario.branch === "detached") {
-            execFileSync("git", ["checkout", "-q", "--detach"], { cwd: root });
-        }
-    }
-    catch (err) {
-        rmSync(root, { recursive: true, force: true });
-        throw err;
-    }
-    return { root };
-}
-/** Diff python vs TS gate outputs for one scenario. */
-export function diffParity(python, ts) {
-    const pythonMessage = normaliseMessage(python.stdout, python.stderr, python.exitCode);
-    const tsMessage = normaliseMessage(ts.stdout, ts.stderr, ts.exitCode);
-    return {
-        exitMismatch: python.exitCode !== ts.exitCode,
-        messageMismatch: pythonMessage !== tsMessage,
-        pythonMessage,
-        tsMessage,
-    };
-}
-/** Run all parity scenarios and return a structured result. */
-/** Render a human-readable parity report (exported for unit tests). */
-export function renderReport(result) {
-    if (result.ok) {
-        return `verify_branch parity: CLEAN -- Python and TS agree on ${result.scenarios.length} scenario(s).`;
-    }
-    const lines = ["verify_branch parity: DIVERGENCE"];
-    for (const s of result.scenarios) {
-        if (s.exitMismatch || s.messageMismatch) {
-            lines.push(`  scenario: ${s.name}`);
-            if (s.exitMismatch) {
-                lines.push(`    exit mismatch: python=${s.pythonExit} ts=${s.tsExit}`);
-            }
-            if (s.messageMismatch) {
-                lines.push(`    python: ${s.pythonMessage}`);
-                lines.push(`    ts:     ${s.tsMessage}`);
-            }
-        }
-    }
-    return lines.join("\n");
-}
-//# sourceMappingURL=branch-fixtures.js.map

package/dist/cache.d.ts

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

package/dist/cache.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-import { fileURLToPath } from "node:url";
-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)));
-}
-/* v8 ignore stop */
-export { main };
-//# sourceMappingURL=cache.js.map

package/dist/capacity-backfill.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=capacity-backfill.d.ts.map

package/dist/capacity-backfill.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-import { runCapacityBackfillCli } from "@deftai/directive-core/capacity";
-const result = await runCapacityBackfillCli(process.argv.slice(2));
-if (result.stdout)
-    process.stdout.write(result.stdout);
-if (result.stderr)
-    process.stderr.write(result.stderr);
-process.exit(result.exitCode);
-//# sourceMappingURL=capacity-backfill.js.map

package/dist/capacity-show.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=capacity-show.d.ts.map

package/dist/capacity-show.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-import { runCapacityShowCli } from "@deftai/directive-core/capacity";
-const result = runCapacityShowCli(process.argv.slice(2));
-if (result.stdout)
-    process.stdout.write(result.stdout);
-if (result.stderr)
-    process.stderr.write(result.stderr);
-process.exit(result.exitCode);
-//# sourceMappingURL=capacity-show.js.map

package/dist/change-init.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=change-init.d.ts.map

package/dist/change-init.js

@@ -1,59 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { runChangeInit } from "@deftai/directive-core/task-surface";
-function parseArgs(argv) {
-    let projectRoot = ".";
-    let name = "";
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i] ?? "";
-        if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { projectRoot, name, error: "argument --project-root: expected one argument" };
-            }
-            projectRoot = value;
-            i += 1;
-        }
-        else if (arg.startsWith("--project-root=")) {
-            projectRoot = arg.slice("--project-root=".length);
-        }
-        else if (arg === "--name") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { projectRoot, name, error: "argument --name: expected one argument" };
-            }
-            name = value;
-            i += 1;
-        }
-        else if (arg.startsWith("--name=")) {
-            name = arg.slice("--name=".length);
-        }
-        else if (!arg.startsWith("-") && name.length === 0) {
-            name = arg;
-        }
-        else {
-            return { projectRoot, name, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return { projectRoot, name };
-}
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`change-init: ${args.error}\n`);
-        return 2;
-    }
-    return runChangeInit(resolve(args.projectRoot), args.name, {
-        writeOut: (text) => {
-            process.stdout.write(text);
-        },
-        writeErr: (text) => {
-            process.stderr.write(text);
-        },
-    });
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=change-init.js.map

package/dist/changelog-check.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=changelog-check.d.ts.map

package/dist/changelog-check.js

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { runChangelogCheck } from "@deftai/directive-core/task-surface";
-function parseChangelogCheckArgs(argv) {
-    let projectRoot = ".";
-    let againstMergeBase = false;
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i] ?? "";
-        if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return {
-                    projectRoot,
-                    againstMergeBase,
-                    error: "argument --project-root: expected one argument",
-                };
-            }
-            projectRoot = value;
-            i += 1;
-        }
-        else if (arg.startsWith("--project-root=")) {
-            projectRoot = arg.slice("--project-root=".length);
-        }
-        else if (arg === "--against-merge-base") {
-            againstMergeBase = true;
-        }
-        else {
-            return { projectRoot, againstMergeBase, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return { projectRoot, againstMergeBase };
-}
-export function run(argv) {
-    const args = parseChangelogCheckArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`changelog-check: ${args.error}\n`);
-        return 2;
-    }
-    return runChangelogCheck(resolve(args.projectRoot), {
-        writeOut: (text) => {
-            process.stdout.write(text);
-        },
-        writeErr: (text) => {
-            process.stderr.write(text);
-        },
-    }, { againstMergeBase: args.againstMergeBase });
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=changelog-check.js.map

package/dist/check.d.ts

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-export interface ParsedArgs {
-    frameworkRoot?: string;
-    projectRoot: string;
-    noCache?: boolean;
-    error?: string;
-}
-/**
- * Resolve check's framework-root from `projectRoot` without last-resort
- * `resolveDefaultFrameworkRoot` (#4722). Returns null on miss (fail-closed).
- */
-export declare function resolveCheckFrameworkRoot(projectRoot: string, explicitRoot?: string | null): string | null;
-export declare function parseArgs(argv: readonly string[]): ParsedArgs;
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=check.d.ts.map

package/dist/check.js

@@ -1,150 +0,0 @@
-#!/usr/bin/env node
-/**
- * check.ts -- CLI wrapper for the context-aware `task check` orchestrator (#1854, #1713).
- *
- * Usage: deft-ts check [--framework-root <path>] [--project-root <path>] [--no-cache]
- *
- * Omitted --project-root defaults to cwd. Omitted --framework-root walks
- * explicit / DEFT_ROOT / source checkout / .deft/core / legacy deft/ and
- * fail-closes instead of resolveDefaultFrameworkRoot (#4722).
- */
-import { statSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { dispatchTaskCheck } from "@deftai/directive-core/check";
-import { DEFT_REPO_POSITIVE_MARKERS } from "@deftai/directive-core/doctor";
-import { refuseIfWslOwnershipBlocked } from "./wsl-ownership-guard.js";
-function isFrameworkSourceCheckoutAt(projectRoot) {
-    try {
-        if (!statSync(join(projectRoot, "main.md")).isFile()) {
-            return false;
-        }
-    }
-    catch {
-        return false;
-    }
-    return DEFT_REPO_POSITIVE_MARKERS.every((marker) => {
-        try {
-            return statSync(join(projectRoot, marker)).isFile();
-        }
-        catch {
-            return false;
-        }
-    });
-}
-/**
- * Resolve check's framework-root from `projectRoot` without last-resort
- * `resolveDefaultFrameworkRoot` (#4722). Returns null on miss (fail-closed).
- */
-export function resolveCheckFrameworkRoot(projectRoot, explicitRoot) {
-    const explicit = explicitRoot?.trim();
-    if (explicit) {
-        return resolve(explicit);
-    }
-    const envRoot = process.env.DEFT_ROOT?.trim();
-    if (envRoot) {
-        return resolve(envRoot);
-    }
-    const root = resolve(projectRoot);
-    if (isFrameworkSourceCheckoutAt(root)) {
-        return root;
-    }
-    for (const rel of [join(".deft", "core"), "deft"]) {
-        const candidate = join(root, rel);
-        try {
-            if (statSync(candidate).isDirectory()) {
-                return candidate;
-            }
-        }
-        catch {
-            // try next candidate
-        }
-    }
-    return null;
-}
-function takeRootOptionValue(argv, index, flag) {
-    const next = argv[index + 1];
-    if (next === undefined || next.length === 0 || next.startsWith("-")) {
-        return { error: `argument ${flag}: expected one argument`, next: index };
-    }
-    return { value: next, next: index + 1 };
-}
-export function parseArgs(argv) {
-    let projectRoot = process.cwd();
-    let explicitFrameworkRoot;
-    let noCache = false;
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i] ?? "";
-        if (arg === "--no-cache") {
-            noCache = true;
-        }
-        else if (arg === "--project-root") {
-            const taken = takeRootOptionValue(argv, i, "--project-root");
-            if (taken.error !== undefined) {
-                return { projectRoot, error: taken.error };
-            }
-            projectRoot = taken.value ?? projectRoot;
-            i = taken.next;
-        }
-        else if (arg.startsWith("--project-root=")) {
-            const value = arg.slice("--project-root=".length);
-            if (value.length === 0) {
-                return { projectRoot, error: "argument --project-root: expected one argument" };
-            }
-            projectRoot = value;
-        }
-        else if (arg === "--framework-root") {
-            const taken = takeRootOptionValue(argv, i, "--framework-root");
-            if (taken.error !== undefined) {
-                return { projectRoot, error: taken.error };
-            }
-            explicitFrameworkRoot = taken.value;
-            i = taken.next;
-        }
-        else if (arg.startsWith("--framework-root=")) {
-            const value = arg.slice("--framework-root=".length);
-            if (value.length === 0) {
-                return { projectRoot, error: "argument --framework-root: expected one argument" };
-            }
-            explicitFrameworkRoot = value;
-        }
-        else {
-            return {
-                projectRoot,
-                error: `unrecognized argument: ${arg}`,
-            };
-        }
-    }
-    const parsed = { projectRoot };
-    if (noCache) {
-        parsed.noCache = true;
-    }
-    const frameworkRoot = resolveCheckFrameworkRoot(projectRoot, explicitFrameworkRoot);
-    if (frameworkRoot !== null) {
-        parsed.frameworkRoot = frameworkRoot;
-    }
-    return parsed;
-}
-const FRAMEWORK_ROOT_MISS = "check: no framework-root at this project (source checkout, .deft/core, or legacy deft/). Run directive init.\n";
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`check: ${args.error}\n`);
-        return 2;
-    }
-    if (args.frameworkRoot === undefined) {
-        process.stderr.write(FRAMEWORK_ROOT_MISS);
-        return 2;
-    }
-    // #1617: live WSL ownership gate before first protected check write/orchestration.
-    const blocked = refuseIfWslOwnershipBlocked(args.projectRoot);
-    if (blocked !== null)
-        return blocked;
-    return dispatchTaskCheck(args.frameworkRoot, args.projectRoot, { noCache: args.noCache });
-}
-/* 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=check.js.map

package/dist/cli-package-version.d.ts

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

package/dist/cli-package-version.js

@@ -1,23 +0,0 @@
-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` version from the installed CLI package.json adjacent to dist/ or src/. */
-export function readCliPackageVersion() {
-    try {
-        const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
-        return parsePackageVersion(readFileSync(pkgPath, "utf8"));
-    }
-    catch {
-        return FALLBACK_VERSION;
-    }
-}
-//# sourceMappingURL=cli-package-version.js.map

package/dist/cli-router/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * CLI router entry: `directive <namespace> <verb>` → flat dispatcher (#1670 / #11 S3).
- */
-import { type DispatchIo } from "../dispatch.js";
-export { DEFERRED_TOP_LEVEL_VERBS, PR_VERB_MAP, type RoutedArgv, type RouteKind, routeArgv, SCOPE_LIFECYCLE_VERBS, STUBBED_TOP_LEVEL_VERBS, SUBCOMMAND_ROUTES, TOP_LEVEL_UX_VERBS, taskKeyToDispatchArgv, VERIFY_VERB_MAP, } from "./route-argv.js";
-/** Route user argv then dispatch to the existing engine handlers. */
-export declare function routeAndDispatch(argv: readonly string[], io?: DispatchIo): Promise<number>;
-//# sourceMappingURL=index.d.ts.map

package/dist/cli-router/index.js

@@ -1,44 +0,0 @@
-/**
- * CLI router entry: `directive <namespace> <verb>` → flat dispatcher (#1670 / #11 S3).
- */
-import { dispatch, runDirectiveBootstrap } from "../dispatch.js";
-import { runInit } from "../init-cli/init.js";
-import { runMigrate } from "../init-cli/migrate.js";
-import { runUpdate } from "../init-cli/update.js";
-import { routeArgv } from "./route-argv.js";
-function defaultIo() {
-    return {
-        writeOut: (text) => {
-            process.stdout.write(text);
-        },
-        writeErr: (text) => {
-            process.stderr.write(text);
-        },
-    };
-}
-export { DEFERRED_TOP_LEVEL_VERBS, PR_VERB_MAP, routeArgv, SCOPE_LIFECYCLE_VERBS, STUBBED_TOP_LEVEL_VERBS, SUBCOMMAND_ROUTES, TOP_LEVEL_UX_VERBS, taskKeyToDispatchArgv, VERIFY_VERB_MAP, } from "./route-argv.js";
-/** Route user argv then dispatch to the existing engine handlers. */
-export async function routeAndDispatch(argv, io) {
-    const routed = routeArgv(argv);
-    if (routed.kind === "stub") {
-        const message = routed.stubMessage ?? "directive: command not available";
-        const sink = io ?? defaultIo();
-        sink.writeErr(`${message}\n`);
-        return 2;
-    }
-    const [first, ...rest] = routed.argv;
-    if (first === "init") {
-        return runInit(rest, io ?? defaultIo());
-    }
-    if (first === "update") {
-        return runUpdate(rest, io ?? defaultIo());
-    }
-    if (first === "migrate") {
-        return runMigrate(rest, io ?? defaultIo());
-    }
-    if (first === "bootstrap") {
-        return runDirectiveBootstrap(rest, io ?? defaultIo());
-    }
-    return dispatch(routed.argv, io);
-}
-//# sourceMappingURL=index.js.map

package/dist/cli-router/route-argv.d.ts

@@ -1,40 +0,0 @@
-/**
- * Maps `directive <namespace> <verb>` argv to flat dispatcher verbs (#1670 / #11 S3).
- * Mirrors the `task <namespace>:<verb>` surface one-to-one.
- */
-/** Top-level UX verbs promoted above the namespace layer (#1670). */
-export declare const TOP_LEVEL_UX_VERBS: readonly ["init", "update", "migrate", "bootstrap", "check", "doctor", "version", "feature"];
-/** Stubbed until a later story lands the handler (#1670 / #11). */
-export declare const STUBBED_TOP_LEVEL_VERBS: Set<string>;
-/** Registered but not yet implemented as TS handlers. */
-export declare const DEFERRED_TOP_LEVEL_VERBS: Set<string>;
-/** scope:* lifecycle verbs routed through scope-lifecycle handler. */
-export declare const SCOPE_LIFECYCLE_VERBS: Set<string>;
-/** pr:* task names that do not hyphenate 1:1 to handler stems. */
-export declare const PR_VERB_MAP: Readonly<Record<string, string>>;
-/** verify:* aliases that map to non-verify-* handler stems. */
-export declare const VERIFY_VERB_MAP: Readonly<Record<string, string>>;
-/** Namespace handlers that require a subcommand token after the handler stem. */
-export declare const SUBCOMMAND_ROUTES: Readonly<Record<string, readonly [string, string]>>;
-/** Eight scm:body:* dual-invoke names (#5521); keep in sync with SUBCOMMAND_ROUTES above. */
-export declare const SCM_BODY_COLON_VERBS: readonly ["scm:body:issue:create", "scm:body:issue:edit", "scm:body:issue:fetch", "scm:body:issue:lint", "scm:body:comment:create", "scm:body:comment:edit", "scm:body:pr:edit", "scm:body:pr:lint"];
-/**
- * Colon forms handled by explicit `routeNamespaceVerb` branches (not SUBCOMMAND_ROUTES /
- * PR_VERB_MAP / VERIFY_VERB_MAP / SCOPE_LIFECYCLE_VERBS). Scraped by rule-to-verb parity
- * so valid citations like `deft framework:doctor` pass (#5521).
- */
-export declare const ROUTER_BRANCH_COLON_VERBS: readonly ["framework:doctor", "agents:refresh", "scope:demote", "scope:decompose", "scope:undo", "scope:record-approved-scope", "scope:record-observable-scope", "scope:record-intent-constraint", "scm:issue:design-critique-chip", "scm:issue:design-critique-stale-ready", "scm:issue:work-claim", "issue:ingest", "issue:emit", "issue:sync-from-xbrief"];
-export type RouteKind = "dispatch" | "stub";
-export interface RoutedArgv {
-    kind: RouteKind;
-    argv: string[];
-    stubMessage?: string;
-}
-/**
- * Transform user-facing argv (`directive <ns> <verb>` or top-level UX) into
- * flat dispatcher argv consumed by `dispatch()`.
- */
-export declare function routeArgv(argv: readonly string[]): RoutedArgv;
-/** Map `namespace:verb` task key to flat dispatcher argv (test seam). */
-export declare function taskKeyToDispatchArgv(taskKey: string, rest?: readonly string[]): string[] | null;
-//# sourceMappingURL=route-argv.d.ts.map