@deftai/directive 0.123.0 → 0.125.0

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

@@ -16,6 +16,14 @@ export declare const PR_VERB_MAP: Readonly<Record<string, string>>;
 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;

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

@@ -118,11 +118,52 @@ export const SUBCOMMAND_ROUTES = {
     "github-body:comment-edit": ["github-body", "comment-edit"],
     "github-body:pr-edit": ["github-body", "pr-edit"],
     "github-body:pr-lint": ["github-body", "pr-lint"],
+    // #5521: pinned AGENTS scm:body:* colon aliases → github-body engine (argv inserts subcommand)
+    "scm:body:issue:create": ["github-body", "issue-create"],
+    "scm:body:issue:edit": ["github-body", "issue-edit"],
+    "scm:body:issue:fetch": ["github-body", "issue-fetch"],
+    "scm:body:issue:lint": ["github-body", "issue-lint"],
+    "scm:body:comment:create": ["github-body", "comment-create"],
+    "scm:body:comment:edit": ["github-body", "comment-edit"],
+    "scm:body:pr:edit": ["github-body", "pr-edit"],
+    "scm:body:pr:lint": ["github-body", "pr-lint"],
     "plan-sequence:set": ["plan-sequence", "set"],
     "plan-sequence:current": ["plan-sequence", "current"],
     "plan-sequence:clear": ["plan-sequence", "clear"],
     "plan-sequence:advance": ["plan-sequence", "advance"],
 };
+/** Eight scm:body:* dual-invoke names (#5521); keep in sync with SUBCOMMAND_ROUTES above. */
+export const SCM_BODY_COLON_VERBS = [
+    "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 const ROUTER_BRANCH_COLON_VERBS = [
+    "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",
+];
 function isMetaVerb(token) {
     return token === "--help" || token === "-h" || token === "--version" || token === "-V";
 }

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

@@ -0,0 +1,18 @@
+#!/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

@@ -0,0 +1,191 @@
+#!/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/dispatch.d.ts

@@ -10,9 +10,9 @@ 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 ["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", "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"];
+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", "migrate-clause-ids", "migrate-confidence"];
+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", "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). */
@@ -177,12 +177,13 @@ export declare function printCommandsList(io?: DispatchIo): void;
  * (#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).
- * Agent-facing spelling is `deft <verb>` (works on consumer CLI and source).
- * Bare `task <verb>` is not consumer-runnable on include-only Taskfiles.
+ * 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): string;
+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. */

package/dist/dispatch.js

@@ -161,6 +161,7 @@ export const CLI_MODULE_VERBS = [
     "verify-subagent-steer",
     "subagent-pre-cancel",
     "subagent-steer-write",
+    "design-critique-spend-resolve",
     "review-monitor-register",
     "review-monitor-release",
     "verify-tools",
@@ -244,6 +245,7 @@ export const CORE_MODULE_VERBS = [
     "docs-impact",
     "migrate-clause-ids",
     "migrate-confidence",
+    "rule-to-verb-parity",
 ];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
 export const TRIAGE_ACTION_ALIAS_SUBCOMMANDS = {
@@ -378,6 +380,7 @@ export const VERB_ALIASES = {
     "verify:subagent-steer": "verify-subagent-steer",
     "subagent:pre-cancel": "subagent-pre-cancel",
     "subagent:steer": "subagent-steer-write",
+    "design-critique:spend-resolve": "design-critique-spend-resolve",
     "agent:monitor": "subagent-monitor",
     "review-monitor:register": "review-monitor-register",
     "review-monitor:release": "review-monitor-release",
@@ -389,6 +392,7 @@ export const VERB_ALIASES = {
     "validate:links": "validate-links",
     "verify:rule-ownership": "rule-ownership-lint",
     "rule:ownership-lint": "rule-ownership-lint",
+    "verify:rule-to-verb-parity": "rule-to-verb-parity",
     "verify:biome-config": "verify-biome-config",
     "verify:contained-writes": "verify-contained-writes",
     "verify:telemetry-coverage": "verify-telemetry-coverage",
@@ -2467,6 +2471,10 @@ async function loadCoreModuleHandler(verb, io) {
             const { mainEntry } = await import("@deftai/directive-core/dist/intake/github-body-cli.js");
             return mainEntry;
         }
+        case "rule-to-verb-parity": {
+            const { mainEntry } = await import("@deftai/directive-core/dist/check/rule-to-verb-parity.js");
+            return mainEntry;
+        }
         case "issue-emit": {
             const { mainEntry } = await import("@deftai/directive-core/dist/intake/issue-emit-cli.js");
             return mainEntry;
@@ -2727,6 +2735,21 @@ const SCOPE_COMMAND_NAMES = [
     "scope:record-observable-scope",
     "scope:record-intent-constraint",
 ];
+/**
+ * Static dual-invoke set for scm:body:* (#5521). Mirror of
+ * packages/cli/src/cli-router/route-argv.ts SCM_BODY_COLON_VERBS — kept here
+ * so dispatch does not import route-argv (route-argv already imports dispatch).
+ */
+const SCM_BODY_DUAL_INVOKE_VERBS = new Set([
+    "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",
+]);
 /**
  * Deduplicated command names for `directive commands`, preferring colon-style
  * task verbs over dash-style canonical stems when both exist (#2172).
@@ -2740,6 +2763,7 @@ export function preferredCommandNames() {
             ...TOP_LEVEL_COMMAND_NAMES,
             ...SCOPE_COMMAND_NAMES,
             ...aliasKeys,
+            ...SCM_BODY_DUAL_INVOKE_VERBS,
             ...unaliasedCanonicals,
         ]),
     ].sort();
@@ -2908,20 +2932,54 @@ async function invokeHandler(handler, argv) {
 }
 const PLAN_SEQUENCE_VERBS = "set|current|clear|advance";
 /**
- * Unknown-colon-verb remediation (#3439 / #2652).
- * Agent-facing spelling is `deft <verb>` (works on consumer CLI and source).
- * Bare `task <verb>` is not consumer-runnable on include-only Taskfiles.
+ * 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 function unknownColonVerbHint(verb) {
+export function unknownColonVerbHint(verb, context = "unknown") {
     if (verb.startsWith("plan-sequence:") && !(verb in PLAN_SEQUENCE_ALIAS_SUBCOMMANDS)) {
         return (`hint: plan-sequence verbs are ${PLAN_SEQUENCE_VERBS} ` +
             `(e.g. \`deft plan-sequence:current\`). '${verb}' is not a verb. ` +
             `Do not run bare \`task ${verb}\` -- consumer include-only Taskfiles cannot resolve it.\n`);
     }
     const hyphen = verb.replaceAll(":", "-");
-    return (`hint: try \`deft ${verb}\` (CLI) or \`task deft:${verb}\` (consumer Taskfile). ` +
-        `Bare \`task ${verb}\` does not exist on include-only deposits. ` +
-        `Hyphen stem: ${hyphen}.\n`);
+    const hyphenNote = `Hyphen stem \`${hyphen}\` is not primary recovery.`;
+    const listing = "List registered CLI verbs with `deft commands`.";
+    if (SCM_BODY_DUAL_INVOKE_VERBS.has(verb)) {
+        if (context === "include-only") {
+            return (`hint: try \`task deft:${verb}\` (consumer include Taskfile). ` +
+                `Bare \`task ${verb}\` is framework-only. ${hyphenNote} ${listing}\n`);
+        }
+        if (context === "no-taskfile") {
+            return (`hint: Taskfile recovery is unavailable here. ` +
+                `On a framework checkout with go-task: \`task ${verb}\`; ` +
+                `on an include-only deposit: \`task deft:${verb}\`. ${hyphenNote} ${listing}\n`);
+        }
+        if (context === "framework") {
+            return (`hint: try \`task ${verb}\` (framework Taskfile) or \`task deft:${verb}\` (consumer include). ` +
+                `${hyphenNote} ${listing}\n`);
+        }
+        return (`hint: if go-task is available, try \`task ${verb}\` (framework) or ` +
+            `\`task deft:${verb}\` (consumer include) — Taskfile recovery is conditional. ` +
+            `${hyphenNote} ${listing}\n`);
+    }
+    if (context === "include-only") {
+        return (`hint: do not retry the same \`deft ${verb}\` spelling. ` +
+            `If a Taskfile task exists, try \`task deft:${verb}\` (include-only). ` +
+            `${hyphenNote} ${listing}\n`);
+    }
+    if (context === "no-taskfile") {
+        return (`hint: do not retry the same \`deft ${verb}\` spelling. ` +
+            `Taskfile recovery is unavailable here. ${hyphenNote} ${listing}\n`);
+    }
+    if (context === "framework") {
+        return (`hint: do not retry the same \`deft ${verb}\` spelling. ` +
+            `If a Taskfile task exists, try \`task ${verb}\` (framework) or \`task deft:${verb}\` (include). ` +
+            `${hyphenNote} ${listing}\n`);
+    }
+    return (`hint: do not retry the same \`deft ${verb}\` spelling. ` +
+        `If a Taskfile task exists, try \`task ${verb}\` (framework) or \`task deft:${verb}\` (include) — ` +
+        `Taskfile recovery is conditional. ${hyphenNote} ${listing}\n`);
 }
 function versionBanner() {
     return `${identityBanner()}\n`;

package/dist/preflight-gh.d.ts

@@ -7,6 +7,8 @@ interface ParsedArgs {
     quiet?: boolean;
     error?: string;
 }
+/** Typed-only deliveryBranch union for CLI-seeded DEFAULT_BRANCHES (#5520). */
+export declare function enrichBranchesWithTypedDelivery(projectRoot: string | undefined, branches: ReadonlySet<string>): Set<string>;
 export declare function parseArgs(argv: string[]): ParsedArgs;
 export declare function run(argv: string[]): number | Promise<number>;
 export {};

package/dist/preflight-gh.js

@@ -13,7 +13,19 @@
  */
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
+import { resolveDeliveryBranch } from "@deftai/directive-core/policy";
 import { DEFAULT_BRANCHES, evaluateCommand, evaluatePrePush, parsePrePushStdin, runSelfTest, } from "@deftai/directive-core/preflight";
+/** Typed-only deliveryBranch union for CLI-seeded DEFAULT_BRANCHES (#5520). */
+export function enrichBranchesWithTypedDelivery(projectRoot, branches) {
+    const next = new Set(branches);
+    if (projectRoot === undefined || projectRoot.length === 0)
+        return next;
+    const delivery = resolveDeliveryBranch(projectRoot);
+    if (delivery.source === "typed" && delivery.error === null && delivery.branch.trim().length > 0) {
+        next.add(delivery.branch);
+    }
+    return next;
+}
 export function parseArgs(argv) {
     const parsed = { defaultBranches: new Set(DEFAULT_BRANCHES) };
     for (let i = 0; i < argv.length; i++) {
@@ -66,7 +78,8 @@ export function run(argv) {
         return 2;
     }
     const quiet = args.quiet ?? false;
-    const branches = args.defaultBranches ?? new Set(DEFAULT_BRANCHES);
+    // CLI seeds DEFAULT_BRANCHES; union typed delivery when --project-root is set (#5520).
+    const branches = enrichBranchesWithTypedDelivery(args.projectRoot, args.defaultBranches ?? new Set(DEFAULT_BRANCHES));
     if (args.mode === "self-test") {
         const [code, msg] = runSelfTest();
         if (code === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.123.0",
+  "version": "0.125.0",
   "description": "Directive CLI — npm install path for the Deft Directive framework.",
   "license": "MIT",
   "homepage": "https://deftai.github.io/directive/",
@@ -35,8 +35,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-core": "^0.123.0",
-    "@deftai/directive-content": "^0.123.0"
+    "@deftai/directive-core": "^0.125.0",
+    "@deftai/directive-content": "^0.125.0"
   },
   "scripts": {
     "build": "tsc -b",