@deftai/directive 0.125.2 → 0.126.0-beta.1

package/dist/content-validate-cli/verify-capacity.js

@@ -1,54 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { verifyCapacity } from "@deftai/directive-core/validate-content";
-/** Parse verify-capacity CLI args, mirroring scripts/verify_capacity.py. */
-export function parseArgs(argv) {
-    const parsed = { projectRoot: ".", quiet: false };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--quiet") {
-            parsed.quiet = true;
-        }
-        else if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --project-root: expected one argument" };
-            }
-            parsed.projectRoot = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--project-root=")) {
-            parsed.projectRoot = arg.slice("--project-root=".length);
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return parsed;
-}
-/** Run the gate and return the process exit code. */
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`verify_capacity: ${args.error}\n`);
-        return 2;
-    }
-    const result = verifyCapacity.evaluate({
-        projectRoot: resolve(args.projectRoot),
-        quiet: args.quiet,
-    });
-    if (result.code === 0) {
-        if (!args.quiet && result.message.length > 0) {
-            process.stdout.write(`${result.message}\n`);
-        }
-    }
-    else {
-        process.stderr.write(`${result.message}\n`);
-    }
-    return result.code;
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=verify-capacity.js.map

package/dist/coverage-hotspots.d.ts

@@ -1,18 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    projectRoot: string;
-    coverageDir: string | null;
-    minHeadroomPp: number | null;
-    baseRef: string | null;
-    pathFilter: string[];
-    useDiffPaths: boolean;
-    json: boolean;
-    quiet: boolean;
-    error?: string;
-}
-/** Parse coverage-hotspots CLI args. */
-export declare function parseArgs(argv: string[]): ParsedArgs;
-/** Run coverage-hotspots and return the process exit code. */
-export declare function run(argv: string[]): number;
-export {};
-//# sourceMappingURL=coverage-hotspots.d.ts.map

package/dist/coverage-hotspots.js

@@ -1,158 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { evaluateCoverageHotspots, formatJsonReport } from "@deftai/directive-core";
-function parseNumber(raw) {
-    const value = Number.parseFloat(raw);
-    if (!Number.isFinite(value)) {
-        return null;
-    }
-    return value;
-}
-/** Parse coverage-hotspots CLI args. */
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        coverageDir: null,
-        minHeadroomPp: null,
-        baseRef: null,
-        pathFilter: [],
-        useDiffPaths: true,
-        json: false,
-        quiet: false,
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--json") {
-            parsed.json = true;
-        }
-        else if (arg === "--quiet") {
-            parsed.quiet = true;
-        }
-        else if (arg === "--no-diff-filter") {
-            parsed.useDiffPaths = false;
-        }
-        else if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --project-root: expected one argument" };
-            }
-            parsed.projectRoot = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--project-root=")) {
-            parsed.projectRoot = arg.slice("--project-root=".length);
-        }
-        else if (arg === "--coverage-dir") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --coverage-dir: expected one argument" };
-            }
-            parsed.coverageDir = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--coverage-dir=")) {
-            parsed.coverageDir = arg.slice("--coverage-dir=".length);
-        }
-        else if (arg === "--min-headroom-pp") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --min-headroom-pp: expected one argument" };
-            }
-            const num = parseNumber(value);
-            if (num === null) {
-                return { ...parsed, error: "argument --min-headroom-pp: expected a number" };
-            }
-            parsed.minHeadroomPp = num;
-            i += 1;
-        }
-        else if (arg?.startsWith("--min-headroom-pp=")) {
-            const num = parseNumber(arg.slice("--min-headroom-pp=".length));
-            if (num === null) {
-                return { ...parsed, error: "argument --min-headroom-pp: expected a number" };
-            }
-            parsed.minHeadroomPp = num;
-        }
-        else if (arg === "--base-ref") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --base-ref: expected one argument" };
-            }
-            parsed.baseRef = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--base-ref=")) {
-            parsed.baseRef = arg.slice("--base-ref=".length);
-        }
-        else if (arg === "--path" || arg === "--paths") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: `argument ${arg}: expected one argument` };
-            }
-            parsed.pathFilter.push(...value
-                .split(",")
-                .map((part) => part.trim())
-                .filter(Boolean));
-            parsed.useDiffPaths = false;
-            i += 1;
-        }
-        else if (arg?.startsWith("--path=") || arg?.startsWith("--paths=")) {
-            const prefix = arg.startsWith("--path=") ? "--path=" : "--paths=";
-            parsed.pathFilter.push(...arg
-                .slice(prefix.length)
-                .split(",")
-                .map((part) => part.trim())
-                .filter(Boolean));
-            parsed.useDiffPaths = false;
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return parsed;
-}
-/** Run coverage-hotspots and return the process exit code. */
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`coverage-hotspots: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    const result = evaluateCoverageHotspots({
-        projectRoot,
-        coverageDir: args.coverageDir ?? undefined,
-        minHeadroomPp: args.minHeadroomPp ?? undefined,
-        baseRef: args.baseRef,
-        pathFilter: args.pathFilter.length > 0 ? args.pathFilter : null,
-        useDiffPaths: args.useDiffPaths,
-    });
-    // Exit 3 = authorized coverage N/A (#5421); keep machine-readable artifact on stdout for --json.
-    if (result.exitCode === 3) {
-        if (args.json && result.applicability) {
-            process.stdout.write(`${JSON.stringify(result.applicability, null, 2)}\n`);
-        }
-        else if (!args.quiet) {
-            process.stderr.write(`${result.message}\n`);
-        }
-        return result.exitCode;
-    }
-    if (result.exitCode === 2 || result.report === null) {
-        process.stderr.write(`${result.message}\n`);
-        return result.exitCode;
-    }
-    const payload = args.json ? formatJsonReport(result.report) : result.message;
-    if (result.exitCode === 0) {
-        if (!args.quiet) {
-            process.stdout.write(payload);
-        }
-    }
-    else {
-        process.stderr.write(payload);
-    }
-    return result.exitCode;
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=coverage-hotspots.js.map

package/dist/design-critique-spend-resolve.d.ts

@@ -1,18 +0,0 @@
-#!/usr/bin/env node
-export declare const DESIGN_CRITIQUE_SPEND_RESOLVE_HELP = "design-critique:spend-resolve \u2014 record spend-recommend then resolve (#5466)\n\nUsage:\n  deft design-critique:spend-resolve --utterance <text> --recommend N=1|N\u22653 [--project-root PATH] [--session-id ID] [--json]\n  deft design-critique:spend-resolve --open-gate [--utterance <text>] [--project-root PATH] [--session-id ID]\n  deft design-critique:spend-resolve --clear [--project-root PATH] [--session-id ID]\n  deft design-critique:spend-resolve --utterance <text> --unclosable-recommend [--project-root PATH] [--session-id ID]\n\nOptions:\n  --utterance TEXT          Operator chat utterance (required except --open-gate/--clear)\n  --recommend N=1|N\u22653       Closed Dual-stop recommendation (required on bare arc)\n  --unclosable-recommend    Parent-declared unclosable recommend; permit lawful ask\n  --open-gate               Open deny-default session-scoped arc-spend-state at arc start\n  --clear                   Clear session arc-spend-state when the arc ends or is abandoned\n  --session-id ID           Session that owns arc-spend-state (default: DEFT_SESSION_ID / env)\n  --project-root PATH       Project root for arc-spend-state scratch (default: cwd)\n  --json                    Emit structured result\n\nExit codes:\n  0  Resolved / gate opened / cleared\n  1  Refused (missing/invalid recommend, ambiguous, or unclosable ask path)\n  2  Config / usage error\n";
-export interface DesignCritiqueSpendResolveArgs {
-    utterance: string | null;
-    recommend: string | null;
-    projectRoot: string;
-    sessionId: string | null;
-    emitJson: boolean;
-    help: boolean;
-    openGate: boolean;
-    clear: boolean;
-    unclosableRecommend: boolean;
-    error?: string;
-}
-export declare function parseDesignCritiqueSpendResolveArgs(argv: readonly string[]): DesignCritiqueSpendResolveArgs;
-export declare function run(argv: readonly string[]): number;
-export declare function main(argv: readonly string[]): number;
-//# sourceMappingURL=design-critique-spend-resolve.d.ts.map

package/dist/design-critique-spend-resolve.js

@@ -1,191 +0,0 @@
-#!/usr/bin/env node
-/**
- * design-critique:spend-resolve — callable spend front door (#5466 Prefer-A).
- * Records closed spend-recommend: + resolved spend:/spend-ask: via
- * parseOperatorSpend / evaluateSpendRecord. Bare arc requires --recommend;
- * never asks; never defaults N=1. Does not copy run-posture missing-token
- * auto-resolve onto spend.
- */
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { clearArcSpendState, openArcSpendGate, resolveDesignCritiqueSpend, } from "@deftai/directive-core/dist/design-critique/spend.js";
-export const DESIGN_CRITIQUE_SPEND_RESOLVE_HELP = `design-critique:spend-resolve — record spend-recommend then resolve (#5466)
-
-Usage:
-  deft design-critique:spend-resolve --utterance <text> --recommend N=1|N≥3 [--project-root PATH] [--session-id ID] [--json]
-  deft design-critique:spend-resolve --open-gate [--utterance <text>] [--project-root PATH] [--session-id ID]
-  deft design-critique:spend-resolve --clear [--project-root PATH] [--session-id ID]
-  deft design-critique:spend-resolve --utterance <text> --unclosable-recommend [--project-root PATH] [--session-id ID]
-
-Options:
-  --utterance TEXT          Operator chat utterance (required except --open-gate/--clear)
-  --recommend N=1|N≥3       Closed Dual-stop recommendation (required on bare arc)
-  --unclosable-recommend    Parent-declared unclosable recommend; permit lawful ask
-  --open-gate               Open deny-default session-scoped arc-spend-state at arc start
-  --clear                   Clear session arc-spend-state when the arc ends or is abandoned
-  --session-id ID           Session that owns arc-spend-state (default: DEFT_SESSION_ID / env)
-  --project-root PATH       Project root for arc-spend-state scratch (default: cwd)
-  --json                    Emit structured result
-
-Exit codes:
-  0  Resolved / gate opened / cleared
-  1  Refused (missing/invalid recommend, ambiguous, or unclosable ask path)
-  2  Config / usage error
-`;
-export function parseDesignCritiqueSpendResolveArgs(argv) {
-    const acc = {
-        utterance: null,
-        recommend: null,
-        projectRoot: ".",
-        sessionId: null,
-        emitJson: false,
-        help: false,
-        openGate: false,
-        clear: false,
-        unclosableRecommend: false,
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        // Accept a lone go-task / deft separator so documented `-- --utterance` forms work.
-        if (arg === "--") {
-            continue;
-        }
-        if (arg === "--help" || arg === "-h") {
-            return { ...acc, help: true };
-        }
-        if (arg === "--json") {
-            acc.emitJson = true;
-            continue;
-        }
-        if (arg === "--open-gate") {
-            acc.openGate = true;
-            continue;
-        }
-        if (arg === "--clear") {
-            acc.clear = true;
-            continue;
-        }
-        if (arg === "--unclosable-recommend") {
-            acc.unclosableRecommend = true;
-            continue;
-        }
-        if (arg === "--utterance") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...acc, error: "argument --utterance: expected one argument" };
-            }
-            acc.utterance = value;
-            i += 1;
-            continue;
-        }
-        if (arg?.startsWith("--utterance=")) {
-            acc.utterance = arg.slice("--utterance=".length);
-            continue;
-        }
-        if (arg === "--recommend") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...acc, error: "argument --recommend: expected one argument" };
-            }
-            acc.recommend = value;
-            i += 1;
-            continue;
-        }
-        if (arg?.startsWith("--recommend=")) {
-            acc.recommend = arg.slice("--recommend=".length);
-            continue;
-        }
-        if (arg === "--session-id") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return { ...acc, error: "argument --session-id: expected one argument" };
-            }
-            acc.sessionId = value;
-            i += 1;
-            continue;
-        }
-        if (arg?.startsWith("--session-id=")) {
-            acc.sessionId = arg.slice("--session-id=".length);
-            continue;
-        }
-        if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...acc, error: "argument --project-root: expected one argument" };
-            }
-            acc.projectRoot = value;
-            i += 1;
-            continue;
-        }
-        if (arg?.startsWith("--project-root=")) {
-            acc.projectRoot = arg.slice("--project-root=".length);
-            continue;
-        }
-        return { ...acc, error: `unknown argument: ${arg}` };
-    }
-    return acc;
-}
-export function run(argv) {
-    const args = parseDesignCritiqueSpendResolveArgs(argv);
-    if (args.help) {
-        process.stdout.write(`${DESIGN_CRITIQUE_SPEND_RESOLVE_HELP}\n`);
-        return 0;
-    }
-    if (args.error !== undefined) {
-        process.stderr.write(`design-critique:spend-resolve: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    const sessionId = args.sessionId;
-    if (args.clear) {
-        const removed = clearArcSpendState(projectRoot, { sessionId });
-        if (args.emitJson) {
-            process.stdout.write(`${JSON.stringify({ ok: true, cleared: removed }, null, 2)}\n`);
-        }
-        else {
-            process.stdout.write(removed
-                ? "design-critique:spend-resolve: cleared arc-spend-state\n"
-                : "design-critique:spend-resolve: no arc-spend-state to clear\n");
-        }
-        return 0;
-    }
-    if (args.openGate) {
-        const state = openArcSpendGate(projectRoot, { utterance: args.utterance, sessionId });
-        if (args.emitJson) {
-            process.stdout.write(`${JSON.stringify({ ok: true, opened: true, state }, null, 2)}\n`);
-        }
-        else {
-            process.stdout.write("design-critique:spend-resolve: opened arc spend gate (ask denied until --recommend or lawful ask)\n");
-        }
-        return 0;
-    }
-    if (args.utterance === null || args.utterance.trim().length === 0) {
-        process.stderr.write("design-critique:spend-resolve: --utterance is required\n" +
-            "Remediation: deft design-critique:spend-resolve --utterance <text> --recommend N=1|N≥3\n");
-        return 2;
-    }
-    const result = resolveDesignCritiqueSpend({
-        utterance: args.utterance,
-        recommendRaw: args.recommend,
-        unclosableRecommend: args.unclosableRecommend,
-        projectRoot,
-        sessionId,
-    });
-    if (args.emitJson) {
-        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    }
-    else if (result.ok) {
-        process.stdout.write(`${result.lines.join("\n")}\n`);
-    }
-    else {
-        process.stderr.write(`${result.message}\n`);
-    }
-    return result.ok ? 0 : 1;
-}
-export function main(argv) {
-    return run(argv);
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=design-critique-spend-resolve.js.map

package/dist/directive-finish-loop.d.ts

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

package/dist/directive-finish-loop.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-import { fileURLToPath } from "node:url";
-import { cmdDirectiveFinishLoop } from "@deftai/directive-core/dist/finish-loop/main.js";
-export function run(argv) {
-    return cmdDirectiveFinishLoop(argv);
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=directive-finish-loop.js.map

package/dist/dispatch.d.ts

@@ -1,193 +0,0 @@
-/**
- * Unified `directive <verb> [args]` dispatcher (#1828 s0).
- * Routes to ported command modules in packages/cli and packages/core.
- */
-import { spawnSync } from "node:child_process";
-import { type WhichFn } from "@deftai/directive-core/scm";
-export type CommandHandler = (argv: string[]) => number | Promise<number>;
-export interface DispatchIo {
-    writeOut: (text: string) => void;
-    writeErr: (text: string) => void;
-}
-/** CLI modules in packages/cli/src (excluding parity harnesses and bin/index). */
-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", "ownership-doctor", "ownership-fix", "verify-ownership", "install-upgrade", "install-uninstall", "migrate-preflight", "migrate-xbrief", "migrate-category-b", "framework-check-updates", "hook-dispatch", "umbrella-current-shape", "changelog-check", "change-init", "commit-lint", "coverage-hotspots", "policy", "authz", "escalation-cli", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "pr-finish-loop", "directive-finish-loop", "pre-pr-run", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "release-wait-npm", "scope-lifecycle", "scope-record-approved-scope", "scope-record-observable-scope", "scope-record-intent-constraint", "scm-sync-default", "lifecycle-event", "lifecycle-stats", "session-start", "session-ready", "occupancy-steal", "occupancy-release", "occupancy-heartbeat", "occupancy-grant", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-strip-withdrawn", "triage-evaluate", "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", "xbrief-create", "xbrief-verify", "xbrief-adopt-stored-plan-id", "verify-branch", "verify-encoding", "verify-forward-coverage", "verify-test-boundary", "verify-class-checks", "verify-presentation-coverage", "verify-scope-provenance", "verify-consumer-check-contract", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-biome-config", "verify-bridge-drift", "verify-capacity", "verify-contained-writes", "verify-telemetry-coverage", "verify-content-manifest", "verify-deposit-closure", "verify-consumer-hard-stops", "verify-closing-keywords", "verify-skill-external-fetch-gate", "verify-semantic-single-source", "verify-contract-drift", "verify-cursor-tier1", "verify-openclaw-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "verify-spec-prd-fresh", "verify-spec-drift", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-cohort-review-monitors", "verify-l4-owner", "verify-subagent-alive", "verify-subagent-steer", "subagent-pre-cancel", "subagent-steer-write", "design-critique-spend-resolve", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-pr-closeout-attestable", "verify-lifecycle-visible", "verify-completed-tracked", "verify-completed-write-guard", "verify-literal-ac", "verify-ac", "verify-agents-md-budget", "verify-consumer-header-placeholder", "verify-agents-md-advisory", "verify-persisted-planning-narratives", "verify-eval-health-relocation", "verify-eval-triggers-relocation", "verify-evaluator-surface", "verify-observable-scope", "verify-operator-scope-limit", "verify-presentation-ceiling", "verify-intent-constraint", "verify-durable-effect-acquisition", "verify-consumer-test-lane", "eval-health", "eval-run", "eval-report", "eval-triggers"];
-/** Core-only CLI entrypoints without a packages/cli wrapper. */
-export declare const CORE_MODULE_VERBS: readonly ["scm", "scm-readiness", "github-auth-modes", "github-body", "issue-emit", "issue-ingest", "issue-sync-from-xbrief", "reconcile-issues", "swarm-launch", "swarm-complete-cohort", "swarm-finalize-cohort", "swarm-finalize-owed", "swarm-pre-dispatch", "swarm-readiness", "swarm-routing-verify", "swarm-routing-set", "swarm-verify-review-clean", "swarm-worktrees", "framework-commands", "pack-render", "packs-slice", "prd-render", "export-spec", "project-render", "project-write-narratives", "roadmap-render", "rule-map", "spec-render", "spec-reconstruct", "spec-validate", "code-structure-validate", "pack-migrate-skills", "pack-migrate-rules", "pack-migrate-strategies", "pack-migrate-patterns", "pack-migrate-swarm-spec", "policy-set", "setup-ghx", "scope-undo", "scope-demote", "scope-decompose", "changelog-resolve-unreleased", "architecture-preflight-sor", "feedback-file", "value-readback", "product-signal", "freshness-report", "decision-write", "decision-list", "docs-impact", "tutorial", "migrate-clause-ids", "migrate-confidence", "rule-to-verb-parity"];
-/** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
-export declare const TRIAGE_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
-/** Colon aliases for policy subcommands (mirrors cli-router SUBCOMMAND_ROUTES). */
-export declare const POLICY_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
-/** Colon aliases for authz subcommands (#2944). */
-export declare const AUTHZ_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
-/** Colon aliases for escalation subcommands (#518). */
-export declare const ESCALATION_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
-/** Colon aliases for plan-sequence subcommands (#2402). */
-export declare const PLAN_SEQUENCE_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
-/** Colon aliases for the Directive Tutorial (#4981). */
-export declare const TUTORIAL_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
-/** Colon aliases for product-signal subcommands (#2693). */
-export declare const PRODUCT_SIGNAL_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
-/** Colon aliases for freshness subcommands (#3117). */
-export declare const FRESHNESS_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
-/** Task-style aliases (framework_commands / Taskfile names). */
-export declare const VERB_ALIASES: Readonly<Record<string, string>>;
-/** Pinned ghx version (display only) — keep in lockstep with .github/workflows/ci.yml env.GHX_VERSION. */
-export declare const GHX_VERSION = "v1.5.1";
-/**
- * Immutable commit SHA the GHX_VERSION tag resolved to at vendor time
- * (2026-07-02, via `gh api repos/brunoborges/ghx/git/refs/tags/v1.5.1`).
- * Fetch URLs pin to this SHA rather than the mutable tag name so a future
- * tag force-move on brunoborges/ghx cannot silently swap the fetched bytes
- * out from under the vendored SHA-256 hashes below (#2178).
- */
-export declare const GHX_COMMIT_SHA = "aa4a2786660e27392b0d3e8886f140e0a0261a0c";
-export declare const INSTALL_PS1_URL = "https://raw.githubusercontent.com/brunoborges/ghx/aa4a2786660e27392b0d3e8886f140e0a0261a0c/install.ps1";
-export declare const INSTALL_SH_URL = "https://raw.githubusercontent.com/brunoborges/ghx/aa4a2786660e27392b0d3e8886f140e0a0261a0c/install.sh";
-/**
- * SHA-256 of the installer scripts at GHX_COMMIT_SHA, vendored so the
- * download-verify-execute pipeline below can refuse to run tampered bytes.
- * Matches `.github/workflows/ci.yml` env.GHX_INSTALL_SH_SHA256 /
- * GHX_INSTALL_PS1_SHA256 (#1070 / #1328) — keep both in lockstep (#2178).
- */
-export declare const GHX_INSTALL_SH_SHA256 = "08c768feb6d2bc485079898f7e76c2b07576cbb1188a356acf99dac0fc55d1cb";
-export declare const GHX_INSTALL_PS1_SHA256 = "5f67eab68970ecc55bb0fc1b8399ba6f3ce4b2aadeee39255d628e96d187a5ed";
-export type SetupGhxHost = "windows" | "darwin" | "linux" | string;
-/** Downloads a URL and resolves to its raw bytes. Injectable so tests never hit the network. */
-export type GhxDownloadFn = (url: string) => Promise<Buffer>;
-/** True when `buf`'s SHA-256 (hex) matches `expectedHex`, case- and whitespace-insensitive. */
-export declare function verifyGhxSha256(buf: Buffer, expectedHex: string): boolean;
-export interface GhxInstallerAsset {
-    url: string;
-    sha256: string;
-    fileExt: "sh" | "ps1";
-}
-export declare function resolveGhxInstallerAsset(host: SetupGhxHost): GhxInstallerAsset;
-export interface SetupGhxDeps {
-    whichFn?: WhichFn;
-    readConsentLine?: () => string;
-    runInstall?: (host: SetupGhxHost) => number | Promise<number>;
-    downloadFn?: GhxDownloadFn;
-    runner?: typeof spawnSync;
-}
-export declare function ghxPresent(whichFn?: WhichFn): boolean;
-export declare function detectSetupGhxHost(): SetupGhxHost;
-export declare function promptSetupGhxConsent(io: DispatchIo, readLine?: () => string): boolean;
-/**
- * Downloads `asset`, verifies it against its vendored SHA-256, and writes it
- * to a private local temp file. Returns the local path, ready for direct
- * local-file execution (never piped into a shell). Throws -- without
- * writing or executing anything -- on a hash mismatch (#2178). Split out
- * from `fetchAndVerifyGhxInstaller` so tests can exercise the download ->
- * verify -> write pipeline against a synthetic asset/hash without depending
- * on the real vendored constants or the network.
- */
-export declare function fetchAndVerifyGhxInstallerAsset(asset: GhxInstallerAsset, downloadFn?: GhxDownloadFn): Promise<string>;
-/**
- * Downloads the pinned installer for `host`, verifies it against the
- * vendored SHA-256, and writes it to a private local temp file. Returns the
- * local path, ready for direct local-file execution (never piped into a
- * shell). Throws -- without writing or executing anything -- on a hash
- * mismatch (#2178).
- */
-export declare function fetchAndVerifyGhxInstaller(host: SetupGhxHost, downloadFn?: GhxDownloadFn): Promise<string>;
-/**
- * Executes an already-downloaded, hash-verified installer from its local
- * temp path. No live pipe (`curl | bash` / `irm | iex`) and no
- * `-ExecutionPolicy Bypass` -- the file is written by Node, so it never
- * carries a Windows Mark-of-the-Web zone identifier the way a browser or
- * `Invoke-WebRequest` download would; `RemoteSigned` treats it as a local,
- * unsigned-but-trusted script (#2178).
- */
-export declare function executeVerifiedGhxInstaller(host: SetupGhxHost, installerPath: string, whichFn?: WhichFn, runner?: typeof spawnSync): number;
-/**
- * Downloads, hash-verifies, and executes `asset` for `host`. Cleans up the
- * temp file (and its containing directory) regardless of outcome. Split out
- * from `installSetupGhx` so tests can exercise the full download -> verify
- * -> execute -> cleanup pipeline against a synthetic asset without depending
- * on the real vendored constants or the network (#2178).
- */
-export declare function installVerifiedGhxAsset(asset: GhxInstallerAsset, host: SetupGhxHost, whichFn?: WhichFn, runner?: typeof spawnSync, downloadFn?: GhxDownloadFn): Promise<number>;
-/**
- * Downloads, hash-verifies, and executes the ghx installer for `host`.
- * Cleans up the temp file (and its containing directory) regardless of
- * outcome (#2178).
- */
-export declare function installSetupGhx(host: SetupGhxHost, whichFn?: WhichFn, runner?: typeof spawnSync, downloadFn?: GhxDownloadFn): Promise<number>;
-/** Native `setup:ghx` handler (replaces scripts/setup_ghx.py shell-out, #2022 Phase 1). */
-export declare function runSetupGhx(argv: string[], io: DispatchIo, deps?: SetupGhxDeps): Promise<number>;
-export declare const SETUP_SKILL_REL_PATH = ".deft/core/skills/deft-directive-setup/SKILL.md";
-export type BootstrapPhaseLabel = "user" | "project" | "spec";
-export type BootstrapReEntry = "none" | "prompt" | "reconfigure" | "force";
-export interface DirectiveBootstrapArgs {
-    projectRoot: string;
-    jumpProject: boolean;
-    strategy: string | null;
-    reconfigure: boolean;
-    force: boolean;
-    json: boolean;
-    error?: string;
-}
-export interface DirectiveBootstrapPlan {
-    phase: 1 | 2 | 3;
-    phaseLabel: BootstrapPhaseLabel;
-    reEntry: BootstrapReEntry;
-    strategy: string | null;
-}
-export interface DirectiveBootstrapHandoff {
-    handoff: "deft-directive-setup";
-    skill_path: string;
-    project_root: string;
-    deposited: boolean;
-    phase: 1 | 2 | 3;
-    phase_label: BootstrapPhaseLabel;
-    re_entry: BootstrapReEntry;
-    strategy: string | null;
-}
-export interface DirectiveBootstrapDeps {
-    deftCorePresent?: (projectRoot: string) => boolean;
-    userMdPresent?: (projectRoot: string) => boolean;
-    projectDefPresent?: (projectRoot: string) => boolean;
-    runInitDeposit?: (projectRoot: string, io: DispatchIo) => Promise<number>;
-}
-/** Parse `directive bootstrap` argv (#2022 Phase 4). */
-export declare function parseDirectiveBootstrapArgs(argv: readonly string[]): DirectiveBootstrapArgs;
-/** Resolve phase intent and deliberate re-entry signal from parsed args + on-disk state. */
-export declare function resolveDirectiveBootstrapPlan(args: DirectiveBootstrapArgs, deps: Required<DirectiveBootstrapDeps>): DirectiveBootstrapPlan;
-/** Native `directive bootstrap` handler (#2022 Phase 4). */
-export declare function runDirectiveBootstrap(argv: string[], io: DispatchIo, deps?: DirectiveBootstrapDeps): Promise<number>;
-/** Native `policy-set` dispatcher (replaces the policy_set.py shell-out, #2022 Phase 1). */
-export declare function runPolicySet(argv: string[], io: DispatchIo): number;
-/** Resolve a user-facing verb to its canonical handler key. */
-export declare function resolveCanonicalVerb(verb: string): string | null;
-/** Sorted list of all registered verb names (canonical + aliases). */
-export declare function registeredVerbs(): readonly string[];
-/**
- * Deduplicated command names for `directive commands`, preferring colon-style
- * task verbs over dash-style canonical stems when both exist (#2172).
- */
-export declare function preferredCommandNames(): readonly string[];
-/** Major.minor label for the curated help title (#2172). */
-export declare function helpVersionLabel(): string;
-/**
- * Print the exhaustive registered-command list for `directive commands` (#2172).
- * Lists deduplicated preferred names (colon-style when available).
- */
-export declare function printCommandsList(io?: DispatchIo): void;
-/**
- * Print curated top-level help: title/version, usage, common options, grouped
- * common commands, and a pointer to `directive commands` for the full list
- * (#2172). Preserves the init/update/doctor first-run guidance from #2273.
- */
-export declare function printHelp(io?: DispatchIo): void;
-export type UnknownColonHintContext = "framework" | "include-only" | "no-taskfile" | "unknown";
-/**
- * Unknown-colon-verb remediation (#3439 / #2652 / #5521).
- * Never re-suggest the failing `deft <verb>` spelling. Prefer Taskfile
- * dual-invoke forms when known; demote hyphen stems; no `task --list` shell-out.
- */
-export declare function unknownColonVerbHint(verb: string, context?: UnknownColonHintContext): string;
-/** Dispatch argv to a registered verb; returns the handler exit code. */
-export declare function dispatch(argv: string[], io?: DispatchIo): Promise<number>;
-/** Test seam: reset lazy handler cache between cases. */
-export declare function resetHandlerCacheForTests(): void;
-//# sourceMappingURL=dispatch.d.ts.map