@structured-vibe-coding/core 0.18.0 → 0.20.0

package/dist/index.d.ts

@@ -5,16 +5,20 @@ declare const GateSchema: z.ZodObject<{
     type: z.ZodDefault<z.ZodEnum<["none", "soft", "hard"]>>;
     mode: z.ZodDefault<z.ZodEnum<["none", "human_approval", "checklist"]>>;
     checklist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Role names, or human for a person listed on the team. */
+    approvers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     overridable: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     type: "none" | "soft" | "hard";
     checklist: string[];
     mode: "none" | "human_approval" | "checklist";
     overridable: boolean;
+    approvers?: string[] | undefined;
 }, {
     type?: "none" | "soft" | "hard" | undefined;
     checklist?: string[] | undefined;
     mode?: "none" | "human_approval" | "checklist" | undefined;
+    approvers?: string[] | undefined;
     overridable?: boolean | undefined;
 }>;
 declare const ArtifactDefSchema: z.ZodObject<{
@@ -58,6 +62,15 @@ declare const StageSchema: z.ZodObject<{
     kind: z.ZodDefault<z.ZodEnum<["standard", "brainstorm", "clarify"]>>;
     /** When true, stage is optional (skippable); agents may skip if not needed */
     optional: z.ZodDefault<z.ZodBoolean>;
+    /** Role that produces this stage. */
+    owner: z.ZodOptional<z.ZodString>;
+    /** Roles who work with the owner on this stage. */
+    collaborates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * One item per matching file when the stage starts.
+     * A directory, a slash, and one star in the file name: tasks/T-*.md
+     */
+    items_from: z.ZodOptional<z.ZodString>;
     artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         path: z.ZodString;
@@ -78,16 +91,20 @@ declare const StageSchema: z.ZodObject<{
         type: z.ZodDefault<z.ZodEnum<["none", "soft", "hard"]>>;
         mode: z.ZodDefault<z.ZodEnum<["none", "human_approval", "checklist"]>>;
         checklist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Role names, or human for a person listed on the team. */
+        approvers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         overridable: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         type: "none" | "soft" | "hard";
         checklist: string[];
         mode: "none" | "human_approval" | "checklist";
         overridable: boolean;
+        approvers?: string[] | undefined;
     }, {
         type?: "none" | "soft" | "hard" | undefined;
         checklist?: string[] | undefined;
         mode?: "none" | "human_approval" | "checklist" | undefined;
+        approvers?: string[] | undefined;
         overridable?: boolean | undefined;
     }>>;
     skippable: z.ZodDefault<z.ZodBoolean>;
@@ -153,10 +170,14 @@ declare const StageSchema: z.ZodObject<{
         checklist: string[];
         mode: "none" | "human_approval" | "checklist";
         overridable: boolean;
+        approvers?: string[] | undefined;
     };
     skippable: boolean;
     title?: string | undefined;
     summary?: string | undefined;
+    owner?: string | undefined;
+    collaborates?: string[] | undefined;
+    items_from?: string | undefined;
     skip_when?: {
         flags?: string[] | undefined;
     } | undefined;
@@ -178,6 +199,9 @@ declare const StageSchema: z.ZodObject<{
     summary?: string | undefined;
     kind?: "standard" | "brainstorm" | "clarify" | undefined;
     optional?: boolean | undefined;
+    owner?: string | undefined;
+    collaborates?: string[] | undefined;
+    items_from?: string | undefined;
     artifacts?: {
         path: string;
         id: string;
@@ -188,6 +212,7 @@ declare const StageSchema: z.ZodObject<{
         type?: "none" | "soft" | "hard" | undefined;
         checklist?: string[] | undefined;
         mode?: "none" | "human_approval" | "checklist" | undefined;
+        approvers?: string[] | undefined;
         overridable?: boolean | undefined;
     } | undefined;
     skippable?: boolean | undefined;
@@ -223,6 +248,15 @@ declare const WorkflowSchema: z.ZodObject<{
         kind: z.ZodDefault<z.ZodEnum<["standard", "brainstorm", "clarify"]>>;
         /** When true, stage is optional (skippable); agents may skip if not needed */
         optional: z.ZodDefault<z.ZodBoolean>;
+        /** Role that produces this stage. */
+        owner: z.ZodOptional<z.ZodString>;
+        /** Roles who work with the owner on this stage. */
+        collaborates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * One item per matching file when the stage starts.
+         * A directory, a slash, and one star in the file name: tasks/T-*.md
+         */
+        items_from: z.ZodOptional<z.ZodString>;
         artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             path: z.ZodString;
@@ -243,16 +277,20 @@ declare const WorkflowSchema: z.ZodObject<{
             type: z.ZodDefault<z.ZodEnum<["none", "soft", "hard"]>>;
             mode: z.ZodDefault<z.ZodEnum<["none", "human_approval", "checklist"]>>;
             checklist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            /** Role names, or human for a person listed on the team. */
+            approvers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             overridable: z.ZodDefault<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
             type: "none" | "soft" | "hard";
             checklist: string[];
             mode: "none" | "human_approval" | "checklist";
             overridable: boolean;
+            approvers?: string[] | undefined;
         }, {
             type?: "none" | "soft" | "hard" | undefined;
             checklist?: string[] | undefined;
             mode?: "none" | "human_approval" | "checklist" | undefined;
+            approvers?: string[] | undefined;
             overridable?: boolean | undefined;
         }>>;
         skippable: z.ZodDefault<z.ZodBoolean>;
@@ -318,10 +356,14 @@ declare const WorkflowSchema: z.ZodObject<{
             checklist: string[];
             mode: "none" | "human_approval" | "checklist";
             overridable: boolean;
+            approvers?: string[] | undefined;
         };
         skippable: boolean;
         title?: string | undefined;
         summary?: string | undefined;
+        owner?: string | undefined;
+        collaborates?: string[] | undefined;
+        items_from?: string | undefined;
         skip_when?: {
             flags?: string[] | undefined;
         } | undefined;
@@ -343,6 +385,9 @@ declare const WorkflowSchema: z.ZodObject<{
         summary?: string | undefined;
         kind?: "standard" | "brainstorm" | "clarify" | undefined;
         optional?: boolean | undefined;
+        owner?: string | undefined;
+        collaborates?: string[] | undefined;
+        items_from?: string | undefined;
         artifacts?: {
             path: string;
             id: string;
@@ -353,6 +398,7 @@ declare const WorkflowSchema: z.ZodObject<{
             type?: "none" | "soft" | "hard" | undefined;
             checklist?: string[] | undefined;
             mode?: "none" | "human_approval" | "checklist" | undefined;
+            approvers?: string[] | undefined;
             overridable?: boolean | undefined;
         } | undefined;
         skippable?: boolean | undefined;
@@ -435,10 +481,14 @@ declare const WorkflowSchema: z.ZodObject<{
             checklist: string[];
             mode: "none" | "human_approval" | "checklist";
             overridable: boolean;
+            approvers?: string[] | undefined;
         };
         skippable: boolean;
         title?: string | undefined;
         summary?: string | undefined;
+        owner?: string | undefined;
+        collaborates?: string[] | undefined;
+        items_from?: string | undefined;
         skip_when?: {
             flags?: string[] | undefined;
         } | undefined;
@@ -477,6 +527,9 @@ declare const WorkflowSchema: z.ZodObject<{
         summary?: string | undefined;
         kind?: "standard" | "brainstorm" | "clarify" | undefined;
         optional?: boolean | undefined;
+        owner?: string | undefined;
+        collaborates?: string[] | undefined;
+        items_from?: string | undefined;
         artifacts?: {
             path: string;
             id: string;
@@ -487,6 +540,7 @@ declare const WorkflowSchema: z.ZodObject<{
             type?: "none" | "soft" | "hard" | undefined;
             checklist?: string[] | undefined;
             mode?: "none" | "human_approval" | "checklist" | undefined;
+            approvers?: string[] | undefined;
             overridable?: boolean | undefined;
         } | undefined;
         skippable?: boolean | undefined;
@@ -681,6 +735,15 @@ declare const ChangeMetaSchema: z.ZodObject<{
             kind: z.ZodDefault<z.ZodEnum<["standard", "brainstorm", "clarify"]>>;
             /** When true, stage is optional (skippable); agents may skip if not needed */
             optional: z.ZodDefault<z.ZodBoolean>;
+            /** Role that produces this stage. */
+            owner: z.ZodOptional<z.ZodString>;
+            /** Roles who work with the owner on this stage. */
+            collaborates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /**
+             * One item per matching file when the stage starts.
+             * A directory, a slash, and one star in the file name: tasks/T-*.md
+             */
+            items_from: z.ZodOptional<z.ZodString>;
             artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 path: z.ZodString;
@@ -701,16 +764,20 @@ declare const ChangeMetaSchema: z.ZodObject<{
                 type: z.ZodDefault<z.ZodEnum<["none", "soft", "hard"]>>;
                 mode: z.ZodDefault<z.ZodEnum<["none", "human_approval", "checklist"]>>;
                 checklist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                /** Role names, or human for a person listed on the team. */
+                approvers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 overridable: z.ZodDefault<z.ZodBoolean>;
             }, "strip", z.ZodTypeAny, {
                 type: "none" | "soft" | "hard";
                 checklist: string[];
                 mode: "none" | "human_approval" | "checklist";
                 overridable: boolean;
+                approvers?: string[] | undefined;
             }, {
                 type?: "none" | "soft" | "hard" | undefined;
                 checklist?: string[] | undefined;
                 mode?: "none" | "human_approval" | "checklist" | undefined;
+                approvers?: string[] | undefined;
                 overridable?: boolean | undefined;
             }>>;
             skippable: z.ZodDefault<z.ZodBoolean>;
@@ -776,10 +843,14 @@ declare const ChangeMetaSchema: z.ZodObject<{
                 checklist: string[];
                 mode: "none" | "human_approval" | "checklist";
                 overridable: boolean;
+                approvers?: string[] | undefined;
             };
             skippable: boolean;
             title?: string | undefined;
             summary?: string | undefined;
+            owner?: string | undefined;
+            collaborates?: string[] | undefined;
+            items_from?: string | undefined;
             skip_when?: {
                 flags?: string[] | undefined;
             } | undefined;
@@ -801,6 +872,9 @@ declare const ChangeMetaSchema: z.ZodObject<{
             summary?: string | undefined;
             kind?: "standard" | "brainstorm" | "clarify" | undefined;
             optional?: boolean | undefined;
+            owner?: string | undefined;
+            collaborates?: string[] | undefined;
+            items_from?: string | undefined;
             artifacts?: {
                 path: string;
                 id: string;
@@ -811,6 +885,7 @@ declare const ChangeMetaSchema: z.ZodObject<{
                 type?: "none" | "soft" | "hard" | undefined;
                 checklist?: string[] | undefined;
                 mode?: "none" | "human_approval" | "checklist" | undefined;
+                approvers?: string[] | undefined;
                 overridable?: boolean | undefined;
             } | undefined;
             skippable?: boolean | undefined;
@@ -848,10 +923,14 @@ declare const ChangeMetaSchema: z.ZodObject<{
                 checklist: string[];
                 mode: "none" | "human_approval" | "checklist";
                 overridable: boolean;
+                approvers?: string[] | undefined;
             };
             skippable: boolean;
             title?: string | undefined;
             summary?: string | undefined;
+            owner?: string | undefined;
+            collaborates?: string[] | undefined;
+            items_from?: string | undefined;
             skip_when?: {
                 flags?: string[] | undefined;
             } | undefined;
@@ -877,6 +956,9 @@ declare const ChangeMetaSchema: z.ZodObject<{
             summary?: string | undefined;
             kind?: "standard" | "brainstorm" | "clarify" | undefined;
             optional?: boolean | undefined;
+            owner?: string | undefined;
+            collaborates?: string[] | undefined;
+            items_from?: string | undefined;
             artifacts?: {
                 path: string;
                 id: string;
@@ -887,6 +969,7 @@ declare const ChangeMetaSchema: z.ZodObject<{
                 type?: "none" | "soft" | "hard" | undefined;
                 checklist?: string[] | undefined;
                 mode?: "none" | "human_approval" | "checklist" | undefined;
+                approvers?: string[] | undefined;
                 overridable?: boolean | undefined;
             } | undefined;
             skippable?: boolean | undefined;
@@ -1011,10 +1094,14 @@ declare const ChangeMetaSchema: z.ZodObject<{
                 checklist: string[];
                 mode: "none" | "human_approval" | "checklist";
                 overridable: boolean;
+                approvers?: string[] | undefined;
             };
             skippable: boolean;
             title?: string | undefined;
             summary?: string | undefined;
+            owner?: string | undefined;
+            collaborates?: string[] | undefined;
+            items_from?: string | undefined;
             skip_when?: {
                 flags?: string[] | undefined;
             } | undefined;
@@ -1086,6 +1173,9 @@ declare const ChangeMetaSchema: z.ZodObject<{
             summary?: string | undefined;
             kind?: "standard" | "brainstorm" | "clarify" | undefined;
             optional?: boolean | undefined;
+            owner?: string | undefined;
+            collaborates?: string[] | undefined;
+            items_from?: string | undefined;
             artifacts?: {
                 path: string;
                 id: string;
@@ -1096,6 +1186,7 @@ declare const ChangeMetaSchema: z.ZodObject<{
                 type?: "none" | "soft" | "hard" | undefined;
                 checklist?: string[] | undefined;
                 mode?: "none" | "human_approval" | "checklist" | undefined;
+                approvers?: string[] | undefined;
                 overridable?: boolean | undefined;
             } | undefined;
             skippable?: boolean | undefined;
@@ -1240,6 +1331,37 @@ declare const TokenUsageMetricSchema: z.ZodObject<{
     measured: true;
     model?: string | null | undefined;
 }>;
+declare const DecisionMetricSchema: z.ZodObject<{
+    workType: z.ZodEnum<["route", "classify", "check", "draft", "design", "code", "review"]>;
+    kind: z.ZodEnum<["reason", "decide"]>;
+    provider: z.ZodEnum<["command", "ollama"]>;
+    model: z.ZodNullable<z.ZodString>;
+    startedAt: z.ZodString;
+    inputTokens: z.ZodNullable<z.ZodNumber>;
+    cacheReadTokens: z.ZodNullable<z.ZodNumber>;
+    cacheWriteTokens: z.ZodNullable<z.ZodNumber>;
+    outputTokens: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "reason" | "decide";
+    startedAt: string;
+    provider: "command" | "ollama";
+    model: string | null;
+    inputTokens: number | null;
+    cacheReadTokens: number | null;
+    cacheWriteTokens: number | null;
+    outputTokens: number | null;
+    workType: "code" | "route" | "classify" | "check" | "draft" | "design" | "review";
+}, {
+    kind: "reason" | "decide";
+    startedAt: string;
+    provider: "command" | "ollama";
+    model: string | null;
+    inputTokens: number | null;
+    cacheReadTokens: number | null;
+    cacheWriteTokens: number | null;
+    outputTokens: number | null;
+    workType: "code" | "route" | "classify" | "check" | "draft" | "design" | "review";
+}>;
 declare const ChangeMetricsSchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
     phases: z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -1297,6 +1419,37 @@ declare const ChangeMetricsSchema: z.ZodObject<{
         measured: true;
         model?: string | null | undefined;
     }>, "many">;
+    decisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        workType: z.ZodEnum<["route", "classify", "check", "draft", "design", "code", "review"]>;
+        kind: z.ZodEnum<["reason", "decide"]>;
+        provider: z.ZodEnum<["command", "ollama"]>;
+        model: z.ZodNullable<z.ZodString>;
+        startedAt: z.ZodString;
+        inputTokens: z.ZodNullable<z.ZodNumber>;
+        cacheReadTokens: z.ZodNullable<z.ZodNumber>;
+        cacheWriteTokens: z.ZodNullable<z.ZodNumber>;
+        outputTokens: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "reason" | "decide";
+        startedAt: string;
+        provider: "command" | "ollama";
+        model: string | null;
+        inputTokens: number | null;
+        cacheReadTokens: number | null;
+        cacheWriteTokens: number | null;
+        outputTokens: number | null;
+        workType: "code" | "route" | "classify" | "check" | "draft" | "design" | "review";
+    }, {
+        kind: "reason" | "decide";
+        startedAt: string;
+        provider: "command" | "ollama";
+        model: string | null;
+        inputTokens: number | null;
+        cacheReadTokens: number | null;
+        cacheWriteTokens: number | null;
+        outputTokens: number | null;
+        workType: "code" | "route" | "classify" | "check" | "draft" | "design" | "review";
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     version: 1;
     phases: {
@@ -1316,6 +1469,17 @@ declare const ChangeMetricsSchema: z.ZodObject<{
         measured: true;
         model?: string | null | undefined;
     }[];
+    decisions?: {
+        kind: "reason" | "decide";
+        startedAt: string;
+        provider: "command" | "ollama";
+        model: string | null;
+        inputTokens: number | null;
+        cacheReadTokens: number | null;
+        cacheWriteTokens: number | null;
+        outputTokens: number | null;
+        workType: "code" | "route" | "classify" | "check" | "draft" | "design" | "review";
+    }[] | undefined;
 }, {
     version: 1;
     phases: {
@@ -1335,9 +1499,21 @@ declare const ChangeMetricsSchema: z.ZodObject<{
         measured: true;
         model?: string | null | undefined;
     }[];
+    decisions?: {
+        kind: "reason" | "decide";
+        startedAt: string;
+        provider: "command" | "ollama";
+        model: string | null;
+        inputTokens: number | null;
+        cacheReadTokens: number | null;
+        cacheWriteTokens: number | null;
+        outputTokens: number | null;
+        workType: "code" | "route" | "classify" | "check" | "draft" | "design" | "review";
+    }[] | undefined;
 }>;
 type PhaseMetric = z.infer<typeof PhaseMetricSchema>;
 type TokenUsageMetric = z.infer<typeof TokenUsageMetricSchema>;
+type DecisionMetric = z.infer<typeof DecisionMetricSchema>;
 type ChangeMetrics = z.infer<typeof ChangeMetricsSchema>;
 interface MetricsImportResult {
     imported: number;
@@ -1349,6 +1525,7 @@ interface MetricsImportResult {
 }
 declare function emptyChangeMetrics(): ChangeMetrics;
 declare function readChangeMetrics(projectRoot: string, config: Config, changeId: string): Promise<ChangeMetrics>;
+declare function recordDecisionMetric(projectRoot: string, config: Config, changeId: string, draft: DecisionMetric): Promise<void>;
 declare function startPhase(projectRoot: string, config: Config, changeId: string, phase: string, startedAt?: string): Promise<void>;
 declare function transitionPhase(projectRoot: string, config: Config, changeId: string, fromPhase: string, toPhase: string | null, at?: string, fromStartedAt?: string): Promise<void>;
 /**
@@ -1827,6 +2004,11 @@ declare function syncChangeHead(projectRoot: string, config: Config, changeId: s
 }): Promise<SyncChangeResult>;
 
 declare function listWorkflowNames(projectRoot: string): Promise<string[]>;
+/** Workflow packs shipped inside this CLI build. */
+declare function listBundledWorkflowNames(): Promise<string[]>;
+/** Bundled workflow names that this project has not copied into `.sdd/workflows/`. */
+declare function missingBundledWorkflows(projectRoot: string): Promise<string[]>;
+declare function workflowUnavailableMessage(name: string, available: string[], bundled: string[]): string;
 declare function loadWorkflow(projectRoot: string, name: string): Promise<Workflow>;
 /** Resolve effective stages for a change (workflow + per-change overrides). */
 declare function resolveStages(workflow: Workflow, meta: ChangeMeta): Stage[];
@@ -1855,6 +2037,9 @@ declare function recommendWorkflow(projectRoot: string, title: string, config: C
     alternatives: string[];
 }>;
 
+/** cl100k counts for each workflow file, its artifact templates, and the active change. */
+declare function formatTokenInventory(projectRoot: string, config: Config): Promise<string>;
+
 interface ChangeContext {
     id: string;
     /** Absolute directory used for file reads and writes. */
@@ -1881,7 +2066,7 @@ declare function resolveChangeId(projectRoot: string, config: Config, changeId?:
  */
 declare function incompletePriorStageErrors(ctx: ChangeContext): Promise<string[]>;
 /** Artifact + gate + verify checks before leaving the current stage. */
-declare function canLeaveStage(ctx: ChangeContext, config: Config): Promise<{
+declare function canLeaveStage(ctx: ChangeContext, config: Config, projectRoot?: string): Promise<{
     ok: boolean;
     errors: string[];
     warnings: string[];
@@ -2005,6 +2190,29 @@ declare function saveGeneratedManifest(path: string, manifest: GeneratedManifest
 declare function reconcileGeneratedTree(projectRoot: string, sourceDir: string, destinationDir: string, destinationRelative: string, manifest: GeneratedManifest, force: boolean): Promise<ReconcileGeneratedResult>;
 declare function describeKept(k: KeptFile): string;
 
+/** One product role, in the order the host agent must run. */
+interface ProductTeamMember {
+    order: number;
+    name: string;
+    job: string;
+    accepts: string;
+    file: string;
+    source: "repo" | "user";
+}
+/**
+ * Directory whose `.sdd/` holds a user-default team.
+ * `SDD_HOME` overrides the home directory so a test does not read a real `~/.sdd`.
+ */
+declare function productTeamHome(): string;
+/**
+ * Product team for the host entrypoint.
+ * A repo `team.yaml` sets the order. Role files in name order are the fallback.
+ * A user-global team is used only when the repo has neither.
+ */
+declare function loadProductTeam(projectRoot: string): Promise<ProductTeamMember[]>;
+/** Markdown block for protocol, AGENTS.md, the host rule, and the handoff. */
+declare function renderProductTeamSection(members: ProductTeamMember[]): string;
+
 /**
  * AI coding agents (not IDEs).
  * Speckit-style: one integration at a time; public keys: `copilot` | `claude` | `grok` | `ollama` | `kilo`.
@@ -2158,7 +2366,7 @@ declare function installAgentIntegration(opts: InstallAgentOptions): Promise<Ins
  */
 declare function installAgentIntegrations(opts: InstallAgentsOptions): Promise<InstallAgentsResult>;
 /** Thin agent body shared across hosts (same text). Paths come from config. */
-declare function renderThinAgent(role: SddAgentRole, config?: Config): string;
+declare function renderThinAgent(role: SddAgentRole, config?: Config, team?: ProductTeamMember[]): string;
 interface InstalledAgentSnapshot {
     /** Public key: copilot | claude | grok | ollama | kilo */
     ai: string;
@@ -2193,8 +2401,8 @@ declare function refreshActiveAgentContext(projectRoot: string): Promise<string
 /** Default-path protocol text. Generated files use {@link renderProtocolMd}. */
 declare const PROTOCOL_MD: string;
 /** Single playbook — paths come from project config, not hard-coded defaults. */
-declare function renderProtocolMd(config: Pick<Config, "memory_path" | "changes_path">): string;
-declare function renderAgentsMd(integ: AgentIntegration, config?: Config): string;
+declare function renderProtocolMd(config: Pick<Config, "memory_path" | "changes_path">, team?: ProductTeamMember[]): string;
+declare function renderAgentsMd(integ: AgentIntegration, config?: Config, team?: ProductTeamMember[]): string;
 
 interface InitOptions {
     projectRoot: string;
@@ -2277,6 +2485,7 @@ declare function uniqueChangeDirName(base: string, taken: Set<string>): string;
  */
 declare function defaultsRoot(): string;
 declare function defaultWorkflowsDir(): string;
+declare function defaultTeamsDir(): string;
 declare function defaultTemplatesDir(): string;
 declare function defaultMemoryDir(): string;
 declare function defaultMcpYamlPath(): string;
@@ -2764,9 +2973,9 @@ declare const McpSourceSchema: z.ZodObject<{
     };
     priority: number;
     enabled: boolean;
+    command: string;
     args: string[];
     transport: "stdio";
-    command: string;
     env: Record<string, string>;
     cwd?: string | undefined;
     invoke?: {
@@ -2873,9 +3082,9 @@ declare const McpConfigSchema: z.ZodObject<{
         };
         priority: number;
         enabled: boolean;
+        command: string;
         args: string[];
         transport: "stdio";
-        command: string;
         env: Record<string, string>;
         cwd?: string | undefined;
         invoke?: {
@@ -2920,9 +3129,9 @@ declare const McpConfigSchema: z.ZodObject<{
         };
         priority: number;
         enabled: boolean;
+        command: string;
         args: string[];
         transport: "stdio";
-        command: string;
         env: Record<string, string>;
         cwd?: string | undefined;
         invoke?: {
@@ -3051,7 +3260,21 @@ declare function gatherMcpContextForChange(projectRoot: string, ctx: ChangeConte
 declare function formatMcpContextForHandoff(results: McpFetchResult[]): string;
 declare function listMatchingSourceIds(sources: McpSource[], match: McpMatchContext): string[];
 
-interface RoleProfile {
+interface RoleLists {
+    stages: string[];
+    owns: string[];
+    inputs: string[];
+    outputs: string[];
+    collaborates: string[];
+    reviews: string[];
+    approvers: string[];
+    never: string[];
+    askHumanWhen: string[];
+    skills: string[];
+    rules: string[];
+    goals: string[];
+}
+interface RoleProfile extends RoleLists {
     name: string;
     label: string;
     job: string;
@@ -3066,6 +3289,27 @@ interface RoleModel {
         prompt: string;
     }): Promise<string>;
 }
+declare const WORK_TYPES: readonly ["route", "classify", "check", "draft", "design", "code", "review"];
+type WorkType = (typeof WORK_TYPES)[number];
+declare function isWorkType(value: string): value is WorkType;
+/** Route, classify, and check are cheap decisions. The other work types reason. */
+declare function workKind(workType: WorkType): "reason" | "decide";
+interface DecisionModel {
+    decide<T extends string>(input: {
+        state: string;
+        question: string;
+        options: readonly T[];
+    }): Promise<{
+        pick: T;
+        probs: Record<T, number>;
+    }>;
+}
+interface ModelChoice {
+    id: string;
+    kind: "reason" | "decide";
+    provider: "rules" | "command" | "ollama";
+    why: string;
+}
 interface RoleCommandResult {
     exitCode: number;
     stdout: string;
@@ -3117,6 +3361,10 @@ interface RunRoleInput {
     stop?: boolean;
     model?: RoleModel;
     now?: () => Date;
+    /** One draft for the guide. Writes stay inside this role, and a team file is not used. */
+    guide?: {
+        changeDir: string;
+    };
 }
 interface AllowRoleInput {
     runId: string;
@@ -3126,18 +3374,52 @@ interface AllowRoleInput {
 declare function runRole(root: string, input: RunRoleInput): Promise<RoleCommandResult>;
 declare function allowRole(root: string, input: AllowRoleInput): Promise<RoleCommandResult>;
 
+declare function roleContextBody(root: string, name: string): Promise<string>;
+declare function setRoleContext(root: string, input: {
+    name: string;
+    text?: string;
+    knowledge?: string;
+    generate?: boolean;
+}): Promise<RoleCommandResult>;
+
+type Duty = "planning" | "architecture" | "construction";
+declare function dutyForStage(id: string, allIds: string[]): Duty;
+declare function prepareGuide(root: string, input?: {
+    workflow?: string;
+    agents?: false | AgentTarget;
+}): Promise<RoleCommandResult>;
+declare function runGuide(root: string, input?: {
+    title?: string;
+    answer?: string;
+    workflow?: string;
+    model?: RoleModel;
+    agents?: false | AgentTarget;
+    now?: () => Date;
+}): Promise<RoleCommandResult>;
+
+declare function recordSignoff(root: string, input: {
+    note?: string;
+    stage?: string;
+    change?: string;
+}): Promise<RoleCommandResult>;
+declare function recordDecisionRequest(root: string, input: {
+    note?: string;
+    change?: string;
+}): Promise<RoleCommandResult>;
+
 declare function createRole(root: string, input: {
     name: string;
     label: string;
     job: string;
     description?: string;
     askFirst?: boolean;
-}): Promise<RoleCommandResult>;
+} & Partial<RoleLists>): Promise<RoleCommandResult>;
 declare function editRole(root: string, nameInput: string, patch: {
     label?: string;
     job?: string;
     description?: string;
     askFirst?: boolean;
+    stages?: string[];
 }): Promise<RoleCommandResult>;
 declare function pinRole(root: string, name: string): Promise<RoleCommandResult>;
 declare function hideRole(root: string, name: string): Promise<RoleCommandResult>;
@@ -3148,6 +3430,547 @@ declare function showRoles(root: string, opts?: {
 declare function duplicateRole(root: string, nameInput: string): Promise<RoleCommandResult>;
 declare function deleteRole(root: string, nameInput: string): Promise<RoleCommandResult>;
 
+/** Project team file written to `.sdd/team.yaml`. */
+declare const TeamSchema: z.ZodEffects<z.ZodObject<{
+    template: z.ZodOptional<z.ZodString>;
+    branch: z.ZodString;
+    rooms: z.ZodObject<{
+        commit: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        commit: boolean;
+    }, {
+        commit: boolean;
+    }>;
+    bots: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        role: z.ZodString;
+        wip: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        role: string;
+        wip: number;
+    }, {
+        name: string;
+        role: string;
+        wip: number;
+    }>, "many">;
+    humans: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+    }, {
+        name: string;
+    }>, "many">>;
+    role_wip: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    limits: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        loop_max_steps: z.ZodOptional<z.ZodNumber>;
+        room_rounds: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        loop_max_steps?: number | undefined;
+        room_rounds?: number | undefined;
+    }, {
+        loop_max_steps?: number | undefined;
+        room_rounds?: number | undefined;
+    }>, {
+        loop_max_steps?: number | undefined;
+        room_rounds?: number | undefined;
+    }, {
+        loop_max_steps?: number | undefined;
+        room_rounds?: number | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    branch: string;
+    bots: {
+        name: string;
+        role: string;
+        wip: number;
+    }[];
+    rooms: {
+        commit: boolean;
+    };
+    humans: {
+        name: string;
+    }[];
+    template?: string | undefined;
+    role_wip?: Record<string, number> | undefined;
+    limits?: {
+        loop_max_steps?: number | undefined;
+        room_rounds?: number | undefined;
+    } | undefined;
+}, {
+    branch: string;
+    bots: {
+        name: string;
+        role: string;
+        wip: number;
+    }[];
+    rooms: {
+        commit: boolean;
+    };
+    template?: string | undefined;
+    humans?: {
+        name: string;
+    }[] | undefined;
+    role_wip?: Record<string, number> | undefined;
+    limits?: {
+        loop_max_steps?: number | undefined;
+        room_rounds?: number | undefined;
+    } | undefined;
+}>, {
+    branch: string;
+    bots: {
+        name: string;
+        role: string;
+        wip: number;
+    }[];
+    rooms: {
+        commit: boolean;
+    };
+    humans: {
+        name: string;
+    }[];
+    template?: string | undefined;
+    role_wip?: Record<string, number> | undefined;
+    limits?: {
+        loop_max_steps?: number | undefined;
+        room_rounds?: number | undefined;
+    } | undefined;
+}, {
+    branch: string;
+    bots: {
+        name: string;
+        role: string;
+        wip: number;
+    }[];
+    rooms: {
+        commit: boolean;
+    };
+    template?: string | undefined;
+    humans?: {
+        name: string;
+    }[] | undefined;
+    role_wip?: Record<string, number> | undefined;
+    limits?: {
+        loop_max_steps?: number | undefined;
+        room_rounds?: number | undefined;
+    } | undefined;
+}>;
+type TeamConfig = z.infer<typeof TeamSchema>;
+
+declare const ModelEntrySchema: z.ZodDiscriminatedUnion<"provider", [z.ZodObject<{
+    kind: z.ZodLiteral<"decide">;
+    provider: z.ZodLiteral<"rules">;
+}, "strict", z.ZodTypeAny, {
+    kind: "decide";
+    provider: "rules";
+}, {
+    kind: "decide";
+    provider: "rules";
+}>, z.ZodObject<{
+    kind: z.ZodEnum<["decide", "reason"]>;
+    provider: z.ZodLiteral<"command">;
+    command_env: z.ZodString;
+    min_confidence: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    kind: "reason" | "decide";
+    provider: "command";
+    command_env: string;
+    min_confidence?: number | undefined;
+}, {
+    kind: "reason" | "decide";
+    provider: "command";
+    command_env: string;
+    min_confidence?: number | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"decide">;
+    provider: z.ZodLiteral<"ollama">;
+    model: z.ZodString;
+    base_url_env: z.ZodString;
+    min_confidence: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    kind: "decide";
+    provider: "ollama";
+    model: string;
+    base_url_env: string;
+    min_confidence?: number | undefined;
+}, {
+    kind: "decide";
+    provider: "ollama";
+    model: string;
+    base_url_env: string;
+    min_confidence?: number | undefined;
+}>]>;
+type ModelEntry = z.infer<typeof ModelEntrySchema>;
+declare const ModelsConfigSchema: z.ZodEffects<z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    models: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<"provider", [z.ZodObject<{
+        kind: z.ZodLiteral<"decide">;
+        provider: z.ZodLiteral<"rules">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "decide";
+        provider: "rules";
+    }, {
+        kind: "decide";
+        provider: "rules";
+    }>, z.ZodObject<{
+        kind: z.ZodEnum<["decide", "reason"]>;
+        provider: z.ZodLiteral<"command">;
+        command_env: z.ZodString;
+        min_confidence: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "reason" | "decide";
+        provider: "command";
+        command_env: string;
+        min_confidence?: number | undefined;
+    }, {
+        kind: "reason" | "decide";
+        provider: "command";
+        command_env: string;
+        min_confidence?: number | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"decide">;
+        provider: z.ZodLiteral<"ollama">;
+        model: z.ZodString;
+        base_url_env: z.ZodString;
+        min_confidence: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "decide";
+        provider: "ollama";
+        model: string;
+        base_url_env: string;
+        min_confidence?: number | undefined;
+    }, {
+        kind: "decide";
+        provider: "ollama";
+        model: string;
+        base_url_env: string;
+        min_confidence?: number | undefined;
+    }>]>>;
+    defaults: z.ZodObject<{
+        by_work_type: z.ZodRecord<z.ZodEnum<["route", "classify", "check", "draft", "design", "code", "review"]>, z.ZodString>;
+        fallback_reason: z.ZodString;
+        fallback_decide: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        by_work_type: Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>;
+        fallback_reason: string;
+        fallback_decide: string;
+    }, {
+        by_work_type: Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>;
+        fallback_reason: string;
+        fallback_decide: string;
+    }>;
+    overrides: z.ZodOptional<z.ZodObject<{
+        bots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodEnum<["route", "classify", "check", "draft", "design", "code", "review"]>, z.ZodString>>>;
+        stages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodEnum<["route", "classify", "check", "draft", "design", "code", "review"]>, z.ZodString>>>;
+        roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodEnum<["route", "classify", "check", "draft", "design", "code", "review"]>, z.ZodString>>>;
+    }, "strict", z.ZodTypeAny, {
+        stages?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        bots?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        roles?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+    }, {
+        stages?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        bots?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        roles?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    version: 1;
+    models: Record<string, {
+        kind: "decide";
+        provider: "rules";
+    } | {
+        kind: "reason" | "decide";
+        provider: "command";
+        command_env: string;
+        min_confidence?: number | undefined;
+    } | {
+        kind: "decide";
+        provider: "ollama";
+        model: string;
+        base_url_env: string;
+        min_confidence?: number | undefined;
+    }>;
+    defaults: {
+        by_work_type: Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>;
+        fallback_reason: string;
+        fallback_decide: string;
+    };
+    overrides?: {
+        stages?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        bots?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        roles?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+    } | undefined;
+}, {
+    version: 1;
+    models: Record<string, {
+        kind: "decide";
+        provider: "rules";
+    } | {
+        kind: "reason" | "decide";
+        provider: "command";
+        command_env: string;
+        min_confidence?: number | undefined;
+    } | {
+        kind: "decide";
+        provider: "ollama";
+        model: string;
+        base_url_env: string;
+        min_confidence?: number | undefined;
+    }>;
+    defaults: {
+        by_work_type: Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>;
+        fallback_reason: string;
+        fallback_decide: string;
+    };
+    overrides?: {
+        stages?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        bots?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        roles?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+    } | undefined;
+}>, {
+    version: 1;
+    models: Record<string, {
+        kind: "decide";
+        provider: "rules";
+    } | {
+        kind: "reason" | "decide";
+        provider: "command";
+        command_env: string;
+        min_confidence?: number | undefined;
+    } | {
+        kind: "decide";
+        provider: "ollama";
+        model: string;
+        base_url_env: string;
+        min_confidence?: number | undefined;
+    }>;
+    defaults: {
+        by_work_type: Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>;
+        fallback_reason: string;
+        fallback_decide: string;
+    };
+    overrides?: {
+        stages?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        bots?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        roles?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+    } | undefined;
+}, {
+    version: 1;
+    models: Record<string, {
+        kind: "decide";
+        provider: "rules";
+    } | {
+        kind: "reason" | "decide";
+        provider: "command";
+        command_env: string;
+        min_confidence?: number | undefined;
+    } | {
+        kind: "decide";
+        provider: "ollama";
+        model: string;
+        base_url_env: string;
+        min_confidence?: number | undefined;
+    }>;
+    defaults: {
+        by_work_type: Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>;
+        fallback_reason: string;
+        fallback_decide: string;
+    };
+    overrides?: {
+        stages?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        bots?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+        roles?: Record<string, Partial<Record<"code" | "route" | "classify" | "check" | "draft" | "design" | "review", string>>> | undefined;
+    } | undefined;
+}>;
+type ModelsConfig = z.infer<typeof ModelsConfigSchema>;
+declare function loadModels(root: string): Promise<{
+    config: ModelsConfig;
+} | {
+    error: string;
+} | null>;
+declare function checkModels(root: string): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+}>;
+
+interface ModelContext {
+    workType: WorkType;
+    role?: string;
+    bot?: string;
+    stage?: string;
+}
+/** Pure precedence: bot, stage, role, work-type default, then the fallback for that kind. */
+declare function selectModel(config: ModelsConfig, ctx: ModelContext): ModelChoice;
+
+interface DecideInput<T extends string> {
+    models: ModelsConfig | null;
+    ctx: ModelContext & {
+        workType: WorkType;
+    };
+    state: string;
+    question: string;
+    options: readonly T[];
+    env: Readonly<Record<string, string | undefined>>;
+    fetch?: typeof fetch;
+    runCommand?: (command: string, stdin: string) => Promise<string>;
+    now?: () => Date;
+    metrics?: {
+        projectRoot: string;
+        config: Config;
+        changeId: string;
+    };
+}
+interface DecisionOutcome<T extends string> {
+    pick: T | "human";
+    source: "rules" | "decide" | "reason" | "human";
+    choice: ModelChoice | null;
+    confidence: number | null;
+}
+declare function decide<T extends string>(input: DecideInput<T>): Promise<DecisionOutcome<T>>;
+
+declare function spawnModelCommand(command: string, stdin: string): Promise<string>;
+declare function modelFromEnv(env: Readonly<Record<string, string | undefined>>): RoleModel | undefined;
+
+declare function formatModels(config: ModelsConfig): string;
+declare function explainModel(config: ModelsConfig, workType: WorkType, ctx: {
+    role?: string;
+    bot?: string;
+    stage?: string;
+}): string;
+
+interface RouteItem {
+    id?: string;
+    stage?: string;
+    artifact?: string;
+    skill?: string;
+    bot?: string;
+}
+interface RouteDeps {
+    env?: Readonly<Record<string, string | undefined>>;
+    fetch?: typeof fetch;
+    runCommand?: (command: string, stdin: string) => Promise<string>;
+    now?: () => Date;
+}
+type RouteHit = {
+    kind: "role";
+    role: string;
+    reason: string;
+    rule: string;
+} | {
+    kind: "ask";
+    reason: string;
+};
+declare function routeRole(root: string, input: RouteItem, deps?: RouteDeps): Promise<RoleCommandResult>;
+declare function queueRole(root: string, bot?: string): Promise<RoleCommandResult>;
+declare function takeRole(root: string, input: RouteItem): Promise<RoleCommandResult>;
+
+declare function gitUserName(root: string): string | null;
+declare function listTeamTemplates(): Promise<string[]>;
+declare function listRoleTemplates(): Promise<string[]>;
+declare function initTeam(root: string, template: string, gitUser: string | null): Promise<RoleCommandResult>;
+declare function readTeamConfig(root: string): Promise<{
+    team: TeamConfig;
+} | {
+    error: string;
+}>;
+declare function formatTeam(team: TeamConfig, gitUser: string | null): string;
+declare function resolveBot(team: TeamConfig, name: string): TeamConfig["bots"][number] | {
+    error: string;
+};
+declare function showTeam(root: string, gitUser: string | null): Promise<RoleCommandResult>;
+declare function checkTeam(root: string): Promise<RoleCommandResult>;
+declare function createRoleFromTemplate(root: string, input: {
+    name: string;
+    template: string;
+    label?: string;
+    job?: string;
+    description?: string;
+}): Promise<RoleCommandResult>;
+
+interface Fact {
+    key: string;
+    value: string;
+    ts: string;
+    by: string;
+    source: string;
+}
+declare function getFacts(root: string, query?: {
+    keys?: string[];
+    query?: string;
+}): Promise<Fact[]>;
+declare function setFact(root: string, input: {
+    key?: string;
+    value?: string;
+    source?: string;
+}): Promise<RoleCommandResult>;
+declare function showFact(root: string, key?: string): Promise<RoleCommandResult>;
+declare function listFacts(root: string, query?: string): Promise<RoleCommandResult>;
+
+interface Lesson {
+    ts: string;
+    by: string;
+    text: string;
+    source?: string;
+    tags?: string[];
+}
+declare function showMemory(root: string, bot: string): Promise<RoleCommandResult>;
+declare function addLesson(root: string, bot: string, text: string): Promise<RoleCommandResult>;
+declare function migrateTeamMemory(root: string): Promise<RoleCommandResult>;
+
+interface PackedFile {
+    path: string;
+    text: string;
+}
+interface WorkItem {
+    text: string;
+}
+interface Brain {
+    role: RoleProfile;
+    bot: TeamConfig["bots"][number];
+    memory: string;
+    lessons: Lesson[];
+    facts: Fact[];
+    inputs: PackedFile[];
+    prompt: string;
+    warning: string;
+}
+declare function loadBrain(root: string, cfg: TeamConfig, bot: string, item: WorkItem, budgetTokens: number): Promise<Brain | {
+    error: string;
+}>;
+
+declare function runLoop(input: {
+    root: string;
+    cfg: TeamConfig;
+    brain: Brain;
+    model: RoleModel;
+    file: string;
+    roleName: string;
+    logName: string;
+}): Promise<RoleCommandResult>;
+
+declare function showRoom(root: string, input: {
+    change?: string;
+    stage?: string;
+}): Promise<RoleCommandResult>;
+declare function postRoom(root: string, input: {
+    change?: string;
+    stage?: string;
+    from?: string;
+    type?: string;
+    text?: string;
+    cite?: string;
+    evidence?: string[];
+}): Promise<RoleCommandResult>;
+declare function reviewRoom(root: string, input: {
+    change?: string;
+    stage?: string;
+    roles?: string[];
+    model?: RoleModel;
+    env?: Readonly<Record<string, string | undefined>>;
+    runCommand?: (command: string, stdin: string) => Promise<string>;
+}): Promise<RoleCommandResult>;
+
 interface StoryNode {
     changeId: string;
     title: string;
@@ -3182,4 +4005,4 @@ declare function formatEpicGraph(nodes: StoryNode[]): {
 /** Graph errors, then open dependencies. Null means the branch may be created. */
 declare function branchBlock(nodes: StoryNode[], story: string): string | null;
 
-export { AGENT_INTEGRATIONS, AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdapterExtractResult, AdapterRegistry, type AdvanceResult, type AgentInstallPlan, AgentInstallPreflightError, type AgentIntegration, type AgentTarget, type AgentTargetOption, type AllowRoleInput, type ArtifactDef, ArtifactDefSchema, type BuildRefinePlanOptions, type CallMcpToolResult, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type ChangeMetrics, ChangeMetricsSchema, type ChangePhaseOrder, type CodeContextCaps, type CodeContextGap, type CodeContextGapCode, type CodeContextRequest, type CodeContextResult, type CodeContextSummary, type CodeSlice, type Complexity, type Config, ConfigSchema, type CreateChangeInput, DEFAULT_CODE_CONTEXT_CAPS, DEFAULT_INIT_INTEGRATION, EMBEDDINGS_UNAVAILABLE, EMBEDDING_MODEL, type Embedder, type FastembedHooks, type FocusPlan, type Gate, GateSchema, type GatherMcpOptions, type GenerateCodeContextDeps, type GeneratedManifest, type GeneratedState, type GitHeadRunner, type GreenfieldFeature, type IndexStats, type InitOptions, type InitResult, type InstallAgentOptions, type InstallAgentResult, type InstallAgentsOptions, type InstallAgentsResult, type InstalledAgentSnapshot, type KeptFile, type KeptReason, type LanguageAdapter, type McpConfig, McpConfigSchema, type McpFetchResult, type McpInvoke, McpInvokeSchema, type McpMatchContext, type McpSource, McpSourceSchema, type McpWhen, McpWhenSchema, type MetricsImportResult, PROTOCOL_MD, type PhaseMetric, PhaseMetricSchema, type PhaseTiming, type PhaseTimingRow, type PlannedWrite, type PriceCard, type Prices, RRF_K, type RawHit, type ReconcileGeneratedResult, type RefineArtifactRef, type RefineMode, type RefinePlan, type RemoveAgentHostsResult, type RenderChangeReportInput, type RoleCommandResult, type RoleModel, type RoleProfile, type RunRoleInput, SDD_AGENT_ROLES, SDD_CORE_VERSION, SDD_DIR, SUMMARY_TOKEN_CAP, type SddAgentRole, type SddAgentRoleId, SddError, type SearchConfig, SearchConfigError, type SearchHit, type SearchProvider, type SearchQuery, type SearchResult, type SearchRuntime, type SearchScope, type Stage, StageSchema, type StartFeatureInput, type StartGreenfieldInput, type StartGreenfieldResult, type StoryDraft, type StoryNode, type SymbolInfo, type SymbolKind, type SyncChangeResult, type TokenCounts, type TokenUsageMetric, TokenUsageMetricSchema, VerifyCommandSchema, type VerifyResult, type VerifyStatus, type Workflow, WorkflowSchema, acceptNetwork, activePointerPath, activeStages, addMcpSource, advanceStage, agentHostPaths, agentKickoffMessage, allowRole, approveGate, archiveDir, assertAgentInstallable, assertSessionLogAllowed, branchBlock, budgetForStage, buildAgentPrompt, buildContext, buildRefinePlan, buildRetrievedInner, callMcpSourceTool, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, changesPathRel, chunkCode, chunkMarkdown, classifyPath, clearActiveIf, clearRegisteredSearchProviders, compareChangesByFirstPhase, completeChange, configPath, contentHash, copyDir, copyDirSkipExisting, costFor, countTokens, createBuiltinProvider, createChange, createFastembedEmbedder, createRole, defaultConfig, defaultMcpConfig, defaultMcpYamlPath, defaultMemoryDir, defaultPricesYamlPath, defaultSearchYamlPath, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, deleteRole, describeFsError, describeKept, displayArchivePath, displayChangePath, domainsDir, duplicateRole, editRole, embedSearchQuery, emptyChangeMetrics, ensureDir, ensureMcpConfig, errorMessage, executeSearch, explainMatch, extractiveSummary, fallbackAdapter, fallbackIncompleteStageId, fallbackWarning, fastembedImportCount, findFeaturesBacklogPath, firstActiveStageId, formatDuration, formatEpicGraph, formatJsonSummary, formatMcpContextForHandoff, formatStatus, ftsTokens, fuseByRank, fuseHits, gatherMcpContext, gatherMcpContextForChange, generateCodeContext, generatedState, getActiveChangeId, getHeadSha, getIntegration, getStage, guidancePaths, handoffRole, hideRole, importSessionMetrics, incompletePriorStageErrors, indexDbPath, inferComplexity, initProject, installAgentIntegration, installAgentIntegrations, integrationKeyFor, interpolate, interpolateArgs, isHardDenied, isIgnoredPath, isInitialized, isPrunedDir, isSddError, isSecretPath, isStageSkipped, isSubstantiveArtifactContent, keywordHits, listBacklogFeatures, listChanges, listDirs, listFiles, listMatchingSourceIds, listMcpSourceTools, listScopeHits, listWorkflowNames, loadChangeMeta, loadConfig, loadEpicStories, loadExcluder, loadGeneratedManifest, loadInstalledAgent, loadMcpConfig, loadPrices, loadSearchConfig, loadWorkflow, markGenerated, matchMcpSources, mcpConfigPath, mcpTimeoutMs, memoryDir, memoryPathRel, mergeCaps, mergeConfigDefaults, mergeRankedHits, nextStageId, nowIso, optionForTarget, packHits, parseAgentTargets, parseFeaturesBacklog, parseIntegration, parseStoryDraft, pathExists, phaseTiming, pinRole, planAgentIntegration, planNetwork, promoteGreenfieldToMemory, rankScope, readChangeMetrics, readHandoffCodePoints, readText, readYaml, rebuildNetwork, recommendWorkflow, reconcileGeneratedTree, refreshActiveAgentContext, refreshConfiguredGuidance, registerSearchProvider, removeMcpSource, removeOtherAgentHosts, removeOtherAgentHostsDetailed, removePath, renderAgentsMd, renderBlock, renderChangeReport, renderMemoryIndex, renderProtocolMd, renderSddReadme, renderThinAgent, repairRequiredIgnores, reportAllChanges, reportChange, resolveActiveDirectory, resolveChangeId, resolveEmbedder, resolveFocus, resolveSearchProvider, resolveStages, rrf, runLocalVerify, runNetwork, runRole, saveChangeMeta, saveConfig, saveGeneratedManifest, saveMcpConfig, scopeForPath, sddRoot, searchConfigPath, searchPreamble, setActiveChange, setRoleMessaging, shouldAutoSkip, showRoleGroup, showRoles, skipStage, slugify, startFeatureFromBacklog, startGreenfield, startPhase, storyIdTaken, switchWorkflow, syncChangeHead, templatesDir, toProcessEnv, todayIsoDate, tokenizeKeywords, transitionPhase, typescriptAdapter, uniqueChangeDirName, updateFeatureStatus, validBranchName, withMcpSource, workflowsDir, writeAgentHandoff, writeRefineBrief, writeText, writeTextIfMissing, writeYaml };
+export { AGENT_INTEGRATIONS, AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdapterExtractResult, AdapterRegistry, type AdvanceResult, type AgentInstallPlan, AgentInstallPreflightError, type AgentIntegration, type AgentTarget, type AgentTargetOption, type AllowRoleInput, type ArtifactDef, ArtifactDefSchema, type BuildRefinePlanOptions, type CallMcpToolResult, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type ChangeMetrics, ChangeMetricsSchema, type ChangePhaseOrder, type CodeContextCaps, type CodeContextGap, type CodeContextGapCode, type CodeContextRequest, type CodeContextResult, type CodeContextSummary, type CodeSlice, type Complexity, type Config, ConfigSchema, type CreateChangeInput, DEFAULT_CODE_CONTEXT_CAPS, DEFAULT_INIT_INTEGRATION, type DecideInput, type DecisionMetric, DecisionMetricSchema, type DecisionModel, type DecisionOutcome, type Duty, EMBEDDINGS_UNAVAILABLE, EMBEDDING_MODEL, type Embedder, type FastembedHooks, type FocusPlan, type Gate, GateSchema, type GatherMcpOptions, type GenerateCodeContextDeps, type GeneratedManifest, type GeneratedState, type GitHeadRunner, type GreenfieldFeature, type IndexStats, type InitOptions, type InitResult, type InstallAgentOptions, type InstallAgentResult, type InstallAgentsOptions, type InstallAgentsResult, type InstalledAgentSnapshot, type KeptFile, type KeptReason, type LanguageAdapter, type McpConfig, McpConfigSchema, type McpFetchResult, type McpInvoke, McpInvokeSchema, type McpMatchContext, type McpSource, McpSourceSchema, type McpWhen, McpWhenSchema, type MetricsImportResult, type ModelChoice, type ModelContext, type ModelEntry, type ModelsConfig, ModelsConfigSchema, PROTOCOL_MD, type PhaseMetric, PhaseMetricSchema, type PhaseTiming, type PhaseTimingRow, type PlannedWrite, type PriceCard, type Prices, type ProductTeamMember, RRF_K, type RawHit, type ReconcileGeneratedResult, type RefineArtifactRef, type RefineMode, type RefinePlan, type RemoveAgentHostsResult, type RenderChangeReportInput, type RoleCommandResult, type RoleLists, type RoleModel, type RoleProfile, type RouteDeps, type RouteHit, type RouteItem, type RunRoleInput, SDD_AGENT_ROLES, SDD_CORE_VERSION, SDD_DIR, SUMMARY_TOKEN_CAP, type SddAgentRole, type SddAgentRoleId, SddError, type SearchConfig, SearchConfigError, type SearchHit, type SearchProvider, type SearchQuery, type SearchResult, type SearchRuntime, type SearchScope, type Stage, StageSchema, type StartFeatureInput, type StartGreenfieldInput, type StartGreenfieldResult, type StoryDraft, type StoryNode, type SymbolInfo, type SymbolKind, type SyncChangeResult, type TeamConfig, TeamSchema, type TokenCounts, type TokenUsageMetric, TokenUsageMetricSchema, VerifyCommandSchema, type VerifyResult, type VerifyStatus, WORK_TYPES, type WorkType, type Workflow, WorkflowSchema, acceptNetwork, activePointerPath, activeStages, addLesson, addMcpSource, advanceStage, agentHostPaths, agentKickoffMessage, allowRole, approveGate, archiveDir, assertAgentInstallable, assertSessionLogAllowed, branchBlock, budgetForStage, buildAgentPrompt, buildContext, buildRefinePlan, buildRetrievedInner, callMcpSourceTool, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, changesPathRel, checkModels, checkTeam, chunkCode, chunkMarkdown, classifyPath, clearActiveIf, clearRegisteredSearchProviders, compareChangesByFirstPhase, completeChange, configPath, contentHash, copyDir, copyDirSkipExisting, costFor, countTokens, createBuiltinProvider, createChange, createFastembedEmbedder, createRole, createRoleFromTemplate, decide, defaultConfig, defaultMcpConfig, defaultMcpYamlPath, defaultMemoryDir, defaultPricesYamlPath, defaultSearchYamlPath, defaultTeamsDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, deleteRole, describeFsError, describeKept, displayArchivePath, displayChangePath, domainsDir, duplicateRole, dutyForStage, editRole, embedSearchQuery, emptyChangeMetrics, ensureDir, ensureMcpConfig, errorMessage, executeSearch, explainMatch, explainModel, extractiveSummary, fallbackAdapter, fallbackIncompleteStageId, fallbackWarning, fastembedImportCount, findFeaturesBacklogPath, firstActiveStageId, formatDuration, formatEpicGraph, formatJsonSummary, formatMcpContextForHandoff, formatModels, formatStatus, formatTeam, formatTokenInventory, ftsTokens, fuseByRank, fuseHits, gatherMcpContext, gatherMcpContextForChange, generateCodeContext, generatedState, getActiveChangeId, getFacts, getHeadSha, getIntegration, getStage, gitUserName, guidancePaths, handoffRole, hideRole, importSessionMetrics, incompletePriorStageErrors, indexDbPath, inferComplexity, initProject, initTeam, installAgentIntegration, installAgentIntegrations, integrationKeyFor, interpolate, interpolateArgs, isHardDenied, isIgnoredPath, isInitialized, isPrunedDir, isSddError, isSecretPath, isStageSkipped, isSubstantiveArtifactContent, isWorkType, keywordHits, listBacklogFeatures, listBundledWorkflowNames, listChanges, listDirs, listFacts, listFiles, listMatchingSourceIds, listMcpSourceTools, listRoleTemplates, listScopeHits, listTeamTemplates, listWorkflowNames, loadBrain, loadChangeMeta, loadConfig, loadEpicStories, loadExcluder, loadGeneratedManifest, loadInstalledAgent, loadMcpConfig, loadModels, loadPrices, loadProductTeam, loadSearchConfig, loadWorkflow, markGenerated, matchMcpSources, mcpConfigPath, mcpTimeoutMs, memoryDir, memoryPathRel, mergeCaps, mergeConfigDefaults, mergeRankedHits, migrateTeamMemory, missingBundledWorkflows, modelFromEnv, nextStageId, nowIso, optionForTarget, packHits, parseAgentTargets, parseFeaturesBacklog, parseIntegration, parseStoryDraft, pathExists, phaseTiming, pinRole, planAgentIntegration, planNetwork, postRoom, prepareGuide, productTeamHome, promoteGreenfieldToMemory, queueRole, rankScope, readChangeMetrics, readHandoffCodePoints, readTeamConfig, readText, readYaml, rebuildNetwork, recommendWorkflow, reconcileGeneratedTree, recordDecisionMetric, recordDecisionRequest, recordSignoff, refreshActiveAgentContext, refreshConfiguredGuidance, registerSearchProvider, removeMcpSource, removeOtherAgentHosts, removeOtherAgentHostsDetailed, removePath, renderAgentsMd, renderBlock, renderChangeReport, renderMemoryIndex, renderProductTeamSection, renderProtocolMd, renderSddReadme, renderThinAgent, repairRequiredIgnores, reportAllChanges, reportChange, resolveActiveDirectory, resolveBot, resolveChangeId, resolveEmbedder, resolveFocus, resolveSearchProvider, resolveStages, reviewRoom, roleContextBody, routeRole, rrf, runGuide, runLocalVerify, runLoop, runNetwork, runRole, saveChangeMeta, saveConfig, saveGeneratedManifest, saveMcpConfig, scopeForPath, sddRoot, searchConfigPath, searchPreamble, selectModel, setActiveChange, setFact, setRoleContext, setRoleMessaging, shouldAutoSkip, showFact, showMemory, showRoleGroup, showRoles, showRoom, showTeam, skipStage, slugify, spawnModelCommand, startFeatureFromBacklog, startGreenfield, startPhase, storyIdTaken, switchWorkflow, syncChangeHead, takeRole, templatesDir, toProcessEnv, todayIsoDate, tokenizeKeywords, transitionPhase, typescriptAdapter, uniqueChangeDirName, updateFeatureStatus, validBranchName, withMcpSource, workKind, workflowUnavailableMessage, workflowsDir, writeAgentHandoff, writeRefineBrief, writeText, writeTextIfMissing, writeYaml };