wicked-crew 0.7.39 → 0.7.45

package/dist/api/routes.d.ts

@@ -1,11 +1,11 @@
 import type { FastifyInstance } from 'fastify';
+import { PlanSchema } from './plan-schema.js';
 import type { RecordedStallFrame } from './stall-frame-index.js';
 import { z } from 'zod';
 import { CoreAdapter } from '../core/adapter.js';
 import type { CodeGraphData, CoreEvent, RepoFinding } from '../core/types.js';
 import { type GateCache } from './gate-cache.js';
 import type { ElicitationCache } from './elicitation-cache.js';
-import { QeGateCache } from '../qe/gate-events.js';
 import type { ConformanceRule, SessionView, SteeringType } from '../core/types.js';
 import { SeatHealthTracker } from './seat-health.js';
 import { type RosterWithStanding } from './roster-standing.js';
@@ -14,17 +14,24 @@ import type { ChatTranscriptStore } from './chat-transcripts.js';
 import { ChatScopeIndex } from './chat-scope.js';
 import { DocRunIndex } from '../interactive/doc-run-index.js';
 import { TestSetIndex } from '../qe/test-sets.js';
+import { parseEstateTotals } from '../projects/graph.js';
 import { type ProjectRoutesDeps } from '../projects/routes.js';
+import type { McpBroker } from '../mcp/broker.js';
+import type { McpCallRecordSource } from '../mcp/call-records.js';
+import type { McpRegistry } from '../mcp/registry.js';
 import { type SkillsRuntime } from '../skills/runtime.js';
+import { type PhaseSkillArming, type RunSkillGapIndex } from '../skills/phase-skill-gaps.js';
 import { type StateHomeWatch } from '../projects/state-home-preflight.js';
 import type { EvalRunStore } from './eval-store.js';
 import { InteractiveBridgePool } from '../interactive/bridge-pool.js';
 import { type PullRequestResolution } from '../core/deliver.js';
 import type { DocGroundingStore } from '../interactive/doc-grounding.js';
 import type { DocLedgerSweep } from '../interactive/doc-ledger-sweep.js';
+import { type LinkedIssuesResult } from '../core/linked-issues.js';
 import { AuditLog } from './audit.js';
 import { type ErrorRing } from './diagnostics.js';
 import { RetryIndex } from './retry-index.js';
+import { DeliveryFreeze } from './delivery-freeze.js';
 import { GroupIndex } from './group-index.js';
 import { RunTimingIndex } from './run-timing-index.js';
 import { GuidanceIndex } from './guidance-index.js';
@@ -33,6 +40,10 @@ import { DeliveryDerivationCache } from './delivery-cache.js';
 import { type DeliverExec, type WorktreeReprovisioner } from './post-hoc-deliver.js';
 import { type AuthMode } from './auth.js';
 export { API_PREFIX } from './api-prefix.js';
+/** How long `GET /health` waits on the engine's actor before answering `ping: "busy"` (crew#471). */
+export declare const HEALTH_PING_WAIT_MS = 1000;
+/** `HealthResponse.ping` while the engine's actor is occupied: the daemon serves, the engine is busy. */
+export declare const ENGINE_BUSY_PING = "busy";
 /**
  * `codeGraphDb(repo)` for a repo surface, or `null` after answering **503** — a CURRENT engine that
  * resolved no repo-graph root (`code_graph_root_unresolvable`, wicked-core#406) is a daemon-
@@ -51,16 +62,7 @@ export interface RepoGraphReply {
     reason?: string;
     finding?: RepoFinding;
 }
-/**
- * The whole-graph counts from `wicked-estate stats --db` stdout (`nodes=N edges=M files=F …`, the
- * first line estate prints — `main.rs`'s `stats` summary). `undefined` when the line does not parse
- * (an older/newer estate, an error message): the caller leaves `CodeGraphData.totals` ABSENT.
- */
-export declare function parseEstateTotals(stdout: string): {
-    nodes: number;
-    edges: number;
-    files: number;
-} | undefined;
+export { parseEstateTotals };
 /**
  * Map an APPROVED policy proposal (estate `proposal.approve` → `handed_off`) into a steering
  * ConformanceRule (DES-MEM-FACETED-001 §5.2). A policy proposal's `kind_type` is
@@ -98,7 +100,8 @@ export declare function policyProposalToRule(proposalId: string, kindType: strin
  * schema does not accept — so `.strict()` is what turns that trip into a 400 instead of an
  * unworkflowed run reported as `201`.
  */
-export declare const LaunchSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+export { PlanSchema };
+export declare const LaunchSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
     problem: z.ZodString;
     sessionId: z.ZodOptional<z.ZodString>;
     clisJson: z.ZodOptional<z.ZodString>;
@@ -106,6 +109,52 @@ export declare const LaunchSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodE
     humanConfirm: z.ZodOptional<z.ZodString>;
     repoRef: z.ZodOptional<z.ZodString>;
     workflow: z.ZodOptional<z.ZodString>;
+    /** DES-TEAMING-002 T3 — a user-composed plan (`LaunchRunBody.plan`), forwarded to the engine,
+     *  which publishes `plan.proposed{by:"human"}` and holds it at a `plan_approval` gate when the
+     *  approval matrix says so. Mutually exclusive with `workflow` (refine below). */
+    plan: z.ZodOptional<z.ZodObject<{
+        steps: z.ZodArray<z.ZodObject<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        touch: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        override: z.ZodOptional<z.ZodObject<{
+            remove: z.ZodArray<z.ZodString, "many">;
+            reason: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            reason: string;
+            remove: string[];
+        }, {
+            reason: string;
+            remove: string[];
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    }, {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    }>>;
     /** DES-PROJECT-001 §2.2 — file the run into a project; membership attaches atomically with
      *  the launch record. Unknown/archived ⇒ the launch fails (never a silent unfiled run). */
     projectId: z.ZodOptional<z.ZodString>;
@@ -161,258 +210,750 @@ export declare const LaunchSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodE
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }>, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }>, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }>, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }>, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }>, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
-    sessionId?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
-    humanConfirm?: string | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }, {
     problem: string;
     workflow?: string | undefined;
     deliver?: "pr" | "none" | undefined;
     revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
     projectId?: string | undefined;
     repoRef?: string | undefined;
     actor?: string | undefined;
+    sessionId?: string | undefined;
     chatId?: string | undefined;
     channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
     campaignId?: string | undefined;
     groupLabel?: string | undefined;
-    clisJson?: string | undefined;
+    retryOf?: string | undefined;
+    entityMode?: "shared" | "isolated" | undefined;
+    deliverGate?: "auto" | "human" | undefined;
+}>, {
+    problem: string;
+    workflow?: string | undefined;
+    deliver?: "pr" | "none" | undefined;
+    revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    projectId?: string | undefined;
+    repoRef?: string | undefined;
+    actor?: string | undefined;
     sessionId?: string | undefined;
+    chatId?: string | undefined;
+    channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
+    humanConfirm?: string | undefined;
+    campaignId?: string | undefined;
+    groupLabel?: string | undefined;
     retryOf?: string | undefined;
     entityMode?: "shared" | "isolated" | undefined;
+    deliverGate?: "auto" | "human" | undefined;
+}, {
+    problem: string;
+    workflow?: string | undefined;
+    deliver?: "pr" | "none" | undefined;
+    revisesPr?: number | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    projectId?: string | undefined;
+    repoRef?: string | undefined;
+    actor?: string | undefined;
+    sessionId?: string | undefined;
+    chatId?: string | undefined;
+    channel?: "cli" | "studio" | "api" | undefined;
+    clisJson?: string | undefined;
     humanConfirm?: string | undefined;
+    campaignId?: string | undefined;
+    groupLabel?: string | undefined;
+    retryOf?: string | undefined;
+    entityMode?: "shared" | "isolated" | undefined;
     deliverGate?: "auto" | "human" | undefined;
 }>;
+/** The escalation arms (wicked-core#469 / #467): approve-shaped, no `amend` / `amendScope`.
+ *  `extend` | `targeted` | `accept_partial` answer the gate of a repo-checks floor that did not
+ *  finish (`repo_checks_timeout`) — the engine re-runs the floor on the tree as it stands with 2×
+ *  bounds, the targeted test set, or the unfinished checks waived; `accept_suggestion` adopts the
+ *  evaluator's discarded, pinned edit as the creator's amendment. The ENGINE refuses each at any
+ *  other gate (a 409 naming the gate it answers). */
+export declare const ESCALATION_ACTIONS: readonly ["extend", "targeted", "accept_partial", "accept_suggestion"];
 /** `POST /runs/:id/gate` (api-types 0.38.0 `GateDecision`; DES-L1 PR-2). Additive arms: `action`
  *  names the arm (`approve` | `request_changes` | `reject`; absent = today's two-arm mapping of
  *  `approve`), `amendScope` says where an approve's `amend` lands (`cursor` = the gated unit, today's
  *  behaviour | `creator` = the first creator phase at/after the cursor — an intake steer reaches the
  *  phase that implements). `request_changes` sends a NOT-PASS review back to the creator with the
  *  findings in context (`amend` = the operator's note). A disagreement between `action` and
- *  `approve` is a 400 that names both. */
-export declare const GateSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+ *  `approve` is a 400 that names both. The escalation arms ({@link ESCALATION_ACTIONS}) require
+ *  `approve: true` and take no `amend` / `amendScope` / `plan`.
+ *
+ *  `amend_intent` (wicked-core#555) approves the gate AND AMENDS THE RUN'S INTENT: `amend` is
+ *  what the acceptance list now says (required, non-empty), `approve: true`, and no `amendScope`
+ *  — an intent amendment reaches every unit at or after the cursor, which is what makes it reach
+ *  the LATER EVALUATOR. It is the only arm that can descope a run mid-flight. */
+export declare const GateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
     approve: z.ZodBoolean;
     amend: z.ZodOptional<z.ZodString>;
-    action: z.ZodOptional<z.ZodEnum<["approve", "request_changes", "reject"]>>;
+    action: z.ZodOptional<z.ZodEnum<["approve", "request_changes", "reject", "edit_plan", "amend_intent", "extend", "targeted", "accept_partial", "accept_suggestion"]>>;
     amendScope: z.ZodOptional<z.ZodEnum<["cursor", "creator"]>>;
+    /** DES-TEAMING-002 T3 — approve a `plan_approval` gate WITH AN EDIT (`GateDecision.plan`). */
+    plan: z.ZodOptional<z.ZodObject<{
+        steps: z.ZodArray<z.ZodObject<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        touch: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        override: z.ZodOptional<z.ZodObject<{
+            remove: z.ZodArray<z.ZodString, "many">;
+            reason: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            reason: string;
+            remove: string[];
+        }, {
+            reason: string;
+            remove: string[];
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    }, {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    }>>;
+    /** api-types 0.44.0 — the gate this decision answers (its unit `ord`). A mismatch with the run's
+     *  open gate is a 409 `gate_changed`: the decision was made on a gate that is no longer open. */
+    ord: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
     approve: boolean;
-    action?: "approve" | "request_changes" | "reject" | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
     amend?: string | undefined;
     amendScope?: "creator" | "cursor" | undefined;
 }, {
     approve: boolean;
-    action?: "approve" | "request_changes" | "reject" | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
     amend?: string | undefined;
     amendScope?: "creator" | "cursor" | undefined;
 }>, {
     approve: boolean;
-    action?: "approve" | "request_changes" | "reject" | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
     amend?: string | undefined;
     amendScope?: "creator" | "cursor" | undefined;
 }, {
     approve: boolean;
-    action?: "approve" | "request_changes" | "reject" | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
     amend?: string | undefined;
     amendScope?: "creator" | "cursor" | undefined;
 }>, {
     approve: boolean;
-    action?: "approve" | "request_changes" | "reject" | undefined;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
     amend?: string | undefined;
     amendScope?: "creator" | "cursor" | undefined;
 }, {
     approve: boolean;
-    action?: "approve" | "request_changes" | "reject" | undefined;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}>, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}>, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}>, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}>, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}>, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
+    amend?: string | undefined;
+    amendScope?: "creator" | "cursor" | undefined;
+}, {
+    approve: boolean;
+    plan?: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    } | undefined;
+    action?: "edit_plan" | "approve" | "extend" | "targeted" | "accept_partial" | "accept_suggestion" | "request_changes" | "reject" | "amend_intent" | undefined;
+    ord?: number | undefined;
     amend?: string | undefined;
     amendScope?: "creator" | "cursor" | undefined;
 }>;
@@ -434,14 +975,14 @@ export declare const OpenTerminalSchema: z.ZodObject<{
     governed: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     cwd: string;
-    cols: number;
     rows: number;
+    cols: number;
     cmd?: string[] | undefined;
     governed?: boolean | undefined;
 }, {
     cwd: string;
-    cols: number;
     rows: number;
+    cols: number;
     cmd?: string[] | undefined;
     governed?: boolean | undefined;
 }>;
@@ -467,15 +1008,38 @@ export declare const RetireMemorySchema: z.ZodObject<{
 }, {
     scope_prefix: string;
 }>;
+/** `POST /memory/retire-item` body (studio#206): ONE memory, by its `memory_id` from `GET /memory`.
+ *  `.strict()`: a stray `scope_prefix` is a 400, never read as a wider erase than one row. */
+export declare const RetireMemoryItemSchema: z.ZodObject<{
+    memory_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    memory_id: string;
+}, {
+    memory_id: string;
+}>;
 /** The actor/audit deps (task #88) — threaded from `createServer`. */
 export interface SecurityDeps {
     audit: AuditLog;
     authMode: AuthMode;
 }
+/** What `registerRoutes` hands back to the server assembly: the ONE gate decision path, for the
+ *  daemon-side actors that answer gates (standing orders, behaviour 10). */
+export interface RegisteredRoutes {
+    decideGate: (id: string, decision: unknown, actor: import('../core/types.js').Actor, extraDetail?: Record<string, unknown>) => Promise<{
+        code: number;
+        body: unknown;
+    }>;
+}
 export interface RuntimeDeps {
+    /** Freeze deliveries (studio idea 15) — `createServer` hydrates one from the audit trail so a
+     *  restart keeps the freeze; a directly-driven route set gets a fresh (thawed) switch. */
+    deliveryFreeze?: DeliveryFreeze;
     /** DES-L9: how `revisesPr` is resolved to a PR head branch (`gh pr view`, 5 s). Injectable so
      *  route tests answer without gh; production uses `core/deliver.ts::resolvePullRequest`. */
     resolvePullRequest?: (repoRoot: string, number: number) => Promise<PullRequestResolution>;
+    /** crew#627: how the issues a launch's intent links are read (`gh issue view`, 5 s each).
+     *  Injectable so route tests answer without gh; production uses `core/linked-issues.ts`. */
+    resolveLinkedIssues?: (problem: string, repoRoot: string | undefined, repoRef: string | undefined) => Promise<LinkedIssuesResult>;
     seatHealth?: SeatHealthTracker;
     /** wicked-studio#284: the stall watchdog's remembered frames for a run — merged into
      *  `GET /runs/:id/events` at serve time so a reloaded page sees the `workerStalled` /
@@ -530,7 +1094,7 @@ export interface RuntimeDeps {
      *  reads then answer the stat-only tri-state until a test sweeps or warms it explicitly. */
     deliveryCache?: DeliveryDerivationCache;
     /** Def-awareness for the delivery derivation (crew#481 / D-14) — `createServer` injects the
-     *  `runCanDeliver(view, resolveRunWorkflow(view, adapter.listWorkflows()))` closure it also hands
+     *  `runCanDeliver(view, runWorkflowDef(view, adapter.listWorkflows()))` closure it also hands
      *  its cache, so the campaigns rollup and the run DTOs classify from ONE predicate. A
      *  directly-driven route set derives the same closure over the adapter's registry when it has
      *  one, else every completed repo-scoped run stays a candidate (today's read). */
@@ -595,6 +1159,21 @@ export interface RuntimeDeps {
      *  (seeded from the installed plugin, published); a directly-driven route set gets none and
      *  `/skills*` answers 503 unless a test injects one over a fixture root. */
     skills?: SkillsRuntime;
+    /** The MCP tools registry (DES-MCP-TOOLS-001 S2) — `createServer` builds one over
+     *  `<state home>/mcp`; a directly-driven route set gets none and `/mcp/*` answers 503 unless a
+     *  test injects one over a scratch dir. */
+    mcp?: McpRegistry;
+    /** The MCP broker's call path (DES-MCP-TOOLS-001 S3) over that registry; absent → `POST /mcp/call` 503. */
+    mcpBroker?: McpBroker;
+    /** The broker's call records (DES-MCP-TOOLS-001 S7), the ones `GET /mcp/usage` folds; absent → 503. */
+    mcpCalls?: McpCallRecordSource;
+    /** crew#661 — each drafting seam's ARM-TIME skill outcome: the subsystems whose phases run without
+     *  a declared skill (`/diagnostics.skills.phaseSkillGaps` + `skills.phase-skill` findings, and
+     *  `/health.warnings`). Absent = nothing armed here (a directly-driven route set): no gaps. */
+    phaseSkills?: PhaseSkillArming;
+    /** crew#661 — the runs launched with such a gap (`AgentSession.skill_gaps`), hydrated from the
+     *  trail. Absent = no run carries the field. */
+    runSkillGaps?: RunSkillGapIndex;
     /** The live state-home classification (wicked-core#411 / crew#497) — `createServer` surveys the
      *  daemon state home at boot and hands the watch here; the routes re-survey on demand, report it
      *  on `/diagnostics.stateHome` + `/health.warnings`, and answer `POST /runs` 409 while a handed
@@ -612,6 +1191,10 @@ export interface RuntimeDeps {
     /** crew#619 — called when a run is launched with a `chatId`, to retain that chat's transcript
      *  until the run terminates. Absent in directly-driven route sets (tests). */
     linkChatRun?: (chatId: string, runId: string) => void;
+    /** crew#642 — entity-count probe for the chat scope's `ownGraph` liveness check. Injectable so
+     *  route tests never shell `wicked-estate` against mkdtemp fixtures. Absent = the dep carries
+     *  its own default (shells `estate stats --db`). */
+    entityCount?: (dbPath: string) => Promise<number>;
 }
 /**
  * The daemon REST surface. Every endpoint is a thin wrapper over one adapter /
@@ -631,18 +1214,23 @@ export declare const ChatOpenSchema: z.ZodObject<{
     /** File the chat into a project (`crew.chat` membership) — and, with no `repoRefs`, scope it to
      *  every registered `crew.repo` member of that project (crew#502). */
     projectId: z.ZodOptional<z.ZodString>;
+    /** The scope the caller NAMES (studio#323 R4) — omitted ⇒ the legacy inference. Shape rules
+     *  (which kinds need / refuse `projectId` / `repoRefs`) are the resolver's (`chat-scope.ts`). */
+    scopeKind: z.ZodOptional<z.ZodEnum<["system", "everything", "project", "repo", "repos", "none"]>>;
 }, "strict", z.ZodTypeAny, {
     projectId?: string | undefined;
     repoRef?: string | undefined;
     chatId?: string | undefined;
     clis?: string[] | undefined;
     repoRefs?: string[] | undefined;
+    scopeKind?: "none" | "repo" | "repos" | "system" | "project" | "everything" | undefined;
 }, {
     projectId?: string | undefined;
     repoRef?: string | undefined;
     chatId?: string | undefined;
     clis?: string[] | undefined;
     repoRefs?: string[] | undefined;
+    scopeKind?: "none" | "repo" | "repos" | "system" | "project" | "everything" | undefined;
 }>;
-export declare function registerRoutes(app: FastifyInstance, adapter: CoreAdapter, gateCache: GateCache, elicitationCache: ElicitationCache, qeGateEvents?: QeGateCache, projects?: ProjectRoutesDeps, security?: SecurityDeps, runtime?: RuntimeDeps): void;
+export declare function registerRoutes(app: FastifyInstance, adapter: CoreAdapter, gateCache: GateCache, elicitationCache: ElicitationCache, projects?: ProjectRoutesDeps, security?: SecurityDeps, runtime?: RuntimeDeps): RegisteredRoutes;
 //# sourceMappingURL=routes.d.ts.map