@cat-factory/orchestration 0.25.1 → 0.27.0

package/dist/modules/brainstorm/brainstorm.logic.d.ts

@@ -0,0 +1,38 @@
+import type { Block, BrainstormStage, RequirementReviewItem } from '@cat-factory/kernel';
+export { coerceReviewItems, disposeReview, extractJson, hasNotesToIncorporate, type ReviewDisposition, } from '../requirements/requirements.logic.js';
+/** Everything a brainstorm agent reasons over for one stage. */
+export interface BrainstormContext {
+    block: Pick<Block, 'title' | 'type' | 'description'>;
+    /** Which dialogue this is — selects the seed subject + the option framing. */
+    stage: BrainstormStage;
+    /**
+     * The requirements refined in prior stages (a requirements review's incorporated doc, or a
+     * requirements-brainstorm's converged direction). Present only for the `architecture` stage;
+     * when present it is the primary seed and the raw description becomes background.
+     */
+    refinedRequirements?: string;
+    /**
+     * The converged direction produced by a prior incorporation. When present (a re-run or a
+     * redo), it is the authoritative direction the agent reasons over. Absent on the first pass.
+     */
+    convergedDoc?: string;
+    /** The human's freeform "do it differently" comment when redoing a merge. Absent otherwise. */
+    reworkFeedback?: string;
+}
+/**
+ * Render the subject under brainstorm as a single Markdown document — the converged
+ * direction when one exists (a later cycle), else the refined requirements (architecture)
+ * or the rough description (requirements). Used both as the agent's input and as the base
+ * the incorporate step rewrites.
+ */
+export declare function renderBrainstormSubject(ctx: BrainstormContext): string;
+export declare function buildBrainstormPrompt(ctx: BrainstormContext): string;
+/**
+ * Build the user prompt for the brainstorm-rework step: the gathered subject plus the
+ * options the human picked (folded in) and dismissed (kept out). Works with an empty item
+ * list (the "nothing to decide" path simply restates the direction in the standard
+ * structure). The stage's rework system prompt (in `@cat-factory/agents`) defines the
+ * output shape.
+ */
+export declare function buildBrainstormReworkPrompt(ctx: BrainstormContext, items: RequirementReviewItem[]): string;
+//# sourceMappingURL=brainstorm.logic.d.ts.map

package/dist/modules/brainstorm/brainstorm.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brainstorm.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/brainstorm/brainstorm.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAWxF,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,KAAK,iBAAiB,GACvB,MAAM,uCAAuC,CAAA;AAE9C,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC,CAAA;IACpD,8EAA8E;IAC9E,KAAK,EAAE,eAAe,CAAA;IACtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAKD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAqBtE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CA8BpE;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,qBAAqB,EAAE,GAC7B,MAAM,CA0CR"}

package/dist/modules/brainstorm/brainstorm.logic.js

@@ -0,0 +1,106 @@
+// Pure logic for the brainstorm (structured-dialogue) agent: assembling the subject the
+// agent reasons over (the rough description for `requirements`, the refined requirements
+// for `architecture`), and building the option-generation + rework prompts. The item
+// parsing / disposition helpers are subject-agnostic and REUSED from the requirements
+// logic — this file only supplies the brainstorm-specific subject + prompts.
+//
+// Re-export the shared helpers so the brainstorm service imports its whole logic surface
+// from here (one import site), mirroring how `requirements.logic` / `clarity.logic` are
+// their services' surfaces.
+export { coerceReviewItems, disposeReview, extractJson, hasNotesToIncorporate, } from '../requirements/requirements.logic.js';
+const stageNoun = (stage) => stage === 'architecture' ? 'technical approach' : 'requirements direction';
+/**
+ * Render the subject under brainstorm as a single Markdown document — the converged
+ * direction when one exists (a later cycle), else the refined requirements (architecture)
+ * or the rough description (requirements). Used both as the agent's input and as the base
+ * the incorporate step rewrites.
+ */
+export function renderBrainstormSubject(ctx) {
+    if (ctx.convergedDoc?.trim()) {
+        return [
+            `# ${ctx.block.title} (${ctx.block.type})`,
+            '',
+            `## Current ${stageNoun(ctx.stage)} (under discussion)`,
+            ctx.convergedDoc.trim(),
+        ].join('\n');
+    }
+    const lines = [`# ${ctx.block.title} (${ctx.block.type})`, ''];
+    if (ctx.stage === 'architecture' && ctx.refinedRequirements?.trim()) {
+        lines.push('## Refined requirements (the basis for the approach)', ctx.refinedRequirements.trim());
+    }
+    else {
+        // For the architecture stage with no refined requirements threaded in, the raw description
+        // is the seed — the same fallback as the requirements stage.
+        lines.push('## Rough idea', ctx.block.description?.trim() || '(no description provided)');
+    }
+    return lines.join('\n');
+}
+export function buildBrainstormPrompt(ctx) {
+    const optionSubject = ctx.stage === 'architecture'
+        ? 'open architectural / technical decisions'
+        : 'open product / requirements decisions';
+    return [
+        `Here is the ${ctx.stage === 'architecture' ? 'work to find an approach for' : 'rough idea to shape into requirements'}:`,
+        '',
+        renderBrainstormSubject(ctx),
+        '',
+        `Surface the ${optionSubject} and, for EACH, PROPOSE the realistic options with their ` +
+            'trade-offs laid out plainly. Produce a JSON object of this exact shape:',
+        '{',
+        '  "items": [',
+        '    {',
+        '      "category": "gap|clarification|assumption|risk|question",',
+        '      "severity": "low|medium|high",',
+        '      "title": "the decision to make, as a short headline",',
+        '      "detail": "the realistic options and their trade-offs (benefit vs cost/risk), ending with a specific question the human can answer to choose"',
+        '    }',
+        '  ]',
+        '}',
+        '',
+        'Assign a severity to EVERY item — no item may omit it. Use `high` for a decision that ' +
+            'shapes everything downstream, `medium` for an important-but-contained choice, and ' +
+            '`low` for a minor preference. Raise between 1 and 12 items, ordered by severity (high ' +
+            'first). Do NOT pick for the human — your job is to lay out the options and trade-offs ' +
+            'clearly. If the direction is already crisp and there is nothing left to decide, return ' +
+            'an empty items array. Output JSON only.',
+    ].join('\n');
+}
+/**
+ * Build the user prompt for the brainstorm-rework step: the gathered subject plus the
+ * options the human picked (folded in) and dismissed (kept out). Works with an empty item
+ * list (the "nothing to decide" path simply restates the direction in the standard
+ * structure). The stage's rework system prompt (in `@cat-factory/agents`) defines the
+ * output shape.
+ */
+export function buildBrainstormReworkPrompt(ctx, items) {
+    const lines = ['Current basis:', '', renderBrainstormSubject(ctx), ''];
+    const answered = items.filter((i) => (i.status === 'answered' || i.status === 'resolved') && i.reply?.trim());
+    const dismissed = items.filter((i) => i.status === 'dismissed');
+    if (answered.length) {
+        lines.push('Decisions the human made (commit to these):', '');
+        for (const i of answered) {
+            lines.push(`- Decision (${i.category}): ${i.title} — ${i.detail}`);
+            lines.push(`  Chosen: ${i.reply?.trim() || '(no choice recorded)'}`);
+        }
+        lines.push('');
+    }
+    if (dismissed.length) {
+        lines.push('Options the human ruled out (do NOT include these):', '');
+        for (const i of dismissed)
+            lines.push(`- ${i.title}`);
+        lines.push('');
+    }
+    if (!answered.length && !dismissed.length) {
+        lines.push('The human made no specific choices — restate the direction cleanly in the standard ' +
+            'structure without inventing new commitments.', '');
+    }
+    if (ctx.reworkFeedback?.trim()) {
+        lines.push('', 'The human was UNHAPPY with your previous direction and asked you to redo it with this ' +
+            'specific steering — follow it closely:', '', ctx.reworkFeedback.trim(), '');
+    }
+    lines.push(`Write the ${stageNoun(ctx.stage)} as a single self-contained Markdown document in the ` +
+        'standard structure described in your instructions, committing to every decision above. ' +
+        'Output the document only.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=brainstorm.logic.js.map

package/dist/modules/brainstorm/brainstorm.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brainstorm.logic.js","sourceRoot":"","sources":["../../../src/modules/brainstorm/brainstorm.logic.ts"],"names":[],"mappings":"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"}

package/dist/modules/execution/AgentContextBuilder.d.ts

@@ -1,5 +1,6 @@
-import type { AccountRepository, AgentRunContext, Block, BlockRepository, ClarityReviewRepository, DocumentRepository, ExecutionInstance, PipelineStep, RequirementReviewRepository, TaskRepository, WorkspaceRepository } from '@cat-factory/kernel';
+import type { AccountRepository, AgentRunContext, Block, BlockRepository, BrainstormSessionRepository, ClarityReviewRepository, DocumentRepository, ExecutionInstance, PipelineStep, RequirementReviewRepository, TaskRepository, WorkspaceRepository } from '@cat-factory/kernel';
 import type { EnvironmentProvisioningService } from '@cat-factory/integrations';
+import { type TesterEnvironment } from './tester-infra.logic.js';
 /**
  * The `revision` slice of an agent context when a step is being re-run with feedback
  * — either a human's "request changes" on its approval gate, or a downstream
@@ -37,6 +38,7 @@ export interface AgentContextBuilderDeps {
     tasks?: TaskRepository;
     requirementReviews?: RequirementReviewRepository;
     clarityReviews?: ClarityReviewRepository;
+    brainstormSessions?: BrainstormSessionRepository;
     environmentProvisioning?: EnvironmentProvisioningService;
     /**
      * Optional: resolves fragment ids against the merged tenant catalog (managed +
@@ -44,6 +46,13 @@ export interface AgentContextBuilderDeps {
      * pool, so curated and living-document fragments actually reach a run.
      */
     fragmentResolver?: FragmentBodyResolver;
+    /**
+     * Optional: the deployment's default Tester environment when neither the task nor its
+     * service frame pins one (the floor of {@link resolveTesterEnvironment}). Absent →
+     * `ephemeral`. MUST match the resolver `ExecutionService` uses for its start-time infra
+     * gate, so the materialised value the job runs with agrees with what the gate checked.
+     */
+    resolveTesterFallbackDefault?: (workspaceId: string) => Promise<TesterEnvironment>;
 }
 /**
  * Assembles the {@link AgentRunContext} for a pipeline step from the run + block state:
@@ -89,6 +98,14 @@ export declare class AgentContextBuilder {
      * clarity review yet. The clarity mirror of {@link resolveReworkedRequirements}.
      */
     private resolveClarifiedBrief;
+    /**
+     * The converged architecture direction for a block — the document the
+     * `architecture-brainstorm` dialogue settled on — or `null` when the feature is unwired or
+     * the block has no settled architecture session. Surfaced additively as a prior output (it
+     * augments, never replaces, the description), the brainstorm analogue of
+     * {@link resolveReworkedRequirements}.
+     */
+    private resolveBrainstormDirection;
     /**
      * Resolve the best-practice fragments to fold into a step's system prompt. Service
      * fragments reach an agent ONLY when its kind carries the `code-aware` trait: those

package/dist/modules/execution/AgentContextBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentContextBuilder.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/AgentContextBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,KAAK,EACL,eAAe,EACf,uBAAuB,EAGvB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,2BAA2B,EAE3B,cAAc,EACd,mBAAmB,EACpB,MAAM,qBAAqB,CAAA;AAK5B,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAA;AAE/E;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG;IACxD,QAAQ,CAAC,EAAE;QACT,gBAAgB,EAAE,MAAM,CAAA;QACxB,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE;YAAE,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KACrD,CAAA;CACF,CA6BA;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAA;CACjG;AAED,4FAA4F;AAC5F,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,eAAe,EAAE,eAAe,CAAA;IAChC,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,kBAAkB,CAAC,EAAE,2BAA2B,CAAA;IAChD,cAAc,CAAC,EAAE,uBAAuB,CAAA;IACxC,uBAAuB,CAAC,EAAE,8BAA8B,CAAA;IACxD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;CACxC;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,uBAAuB,EAAI;IAE9D,kFAAkF;IAC5E,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,OAAO,EACpB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,eAAe,CAAC,CAmG1B;IAED,wFAAwF;IAClF,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxF;IAED;;;;;;;;OAQG;IACG,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAqBjD;IAED;;;OAGG;YACW,6BAA6B;IAS3C;;;;;OAKG;YACW,2BAA2B;IAYzC;;;;OAIG;YACW,qBAAqB;IAYnC;;;;;;;;;OASG;YACW,gBAAgB;IAmC9B;;;;;OAKG;YACW,yBAAyB;IASvC;;;;;;;;;;;OAWG;YACW,oBAAoB;IAgDlC;;;;;OAKG;YACW,kBAAkB;CAIjC"}
+{"version":3,"file":"AgentContextBuilder.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/AgentContextBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,KAAK,EACL,eAAe,EACf,2BAA2B,EAC3B,uBAAuB,EAGvB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,2BAA2B,EAE3B,cAAc,EACd,mBAAmB,EACpB,MAAM,qBAAqB,CAAA;AAK5B,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAA;AAC/E,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAE1F;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG;IACxD,QAAQ,CAAC,EAAE;QACT,gBAAgB,EAAE,MAAM,CAAA;QACxB,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE;YAAE,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KACrD,CAAA;CACF,CA6BA;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAA;CACjG;AAED,4FAA4F;AAC5F,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,eAAe,EAAE,eAAe,CAAA;IAChC,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,kBAAkB,CAAC,EAAE,2BAA2B,CAAA;IAChD,cAAc,CAAC,EAAE,uBAAuB,CAAA;IACxC,kBAAkB,CAAC,EAAE,2BAA2B,CAAA;IAChD,uBAAuB,CAAC,EAAE,8BAA8B,CAAA;IACxD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;IACvC;;;;;OAKG;IACH,4BAA4B,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACnF;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,uBAAuB,EAAI;IAE9D,kFAAkF;IAC5E,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,OAAO,EACpB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,eAAe,CAAC,CA4H1B;IAED,wFAAwF;IAClF,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxF;IAED;;;;;;;;OAQG;IACG,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAqBjD;IAED;;;OAGG;YACW,6BAA6B;IAS3C;;;;;OAKG;YACW,2BAA2B;IAYzC;;;;OAIG;YACW,qBAAqB;IAYnC;;;;;;OAMG;YACW,0BAA0B;IAgBxC;;;;;;;;;OASG;YACW,gBAAgB;IAmC9B;;;;;OAKG;YACW,yBAAyB;IASvC;;;;;;;;;;;OAWG;YACW,oBAAoB;IAgDlC;;;;;OAKG;YACW,kBAAkB;CAIjC"}

package/dist/modules/execution/AgentContextBuilder.js

@@ -2,6 +2,7 @@ import { buildExcerpt, CONTEXT_BUDGET } from '@cat-factory/kernel';
 import { CODE_AWARE_TRAIT, hasTrait } from '@cat-factory/agents';
 import { getFragment } from '@cat-factory/prompt-fragments';
 import { extractReferences } from '@cat-factory/integrations';
+import { resolveTesterEnvironment } from './tester-infra.logic.js';
 /**
  * The `revision` slice of an agent context when a step is being re-run with feedback
  * — either a human's "request changes" on its approval gate, or a downstream
@@ -82,13 +83,31 @@ export class AgentContextBuilder {
         // agentConfig so the Tester job body, the prompt fragment and the start-time infra
         // gate all read the same value — the stored block is left untouched (the per-task
         // override stays explicit).
-        const agentConfig = service?.defaultTestEnvironment && !block.agentConfig?.['tester.environment']
-            ? { ...block.agentConfig, 'tester.environment': service.defaultTestEnvironment }
-            : block.agentConfig;
-        const priorOutputs = instance.steps
-            .slice(0, instance.currentStep)
-            .filter((s) => s.output)
-            .map((s) => ({ agentKind: s.agentKind, output: s.output }));
+        // Resolve the effective environment (task pin > service default > deployment fallback)
+        // and materialise it when the task hasn't pinned its own, so the Tester job body, the
+        // prompt fragment and the start-time infra gate all read the SAME value. The fallback
+        // (local mode: `local` by default, `ephemeral` when delegating to a provider) is the
+        // same resolver the gate uses, so the run can't disagree with what was checked at start.
+        const agentConfig = block.agentConfig?.['tester.environment']
+            ? block.agentConfig
+            : {
+                ...block.agentConfig,
+                'tester.environment': resolveTesterEnvironment(undefined, service?.defaultTestEnvironment, await this.deps.resolveTesterFallbackDefault?.(workspaceId)),
+            };
+        // A finalized architecture-brainstorm direction is surfaced ADDITIVELY (it does not
+        // replace the description) as a synthetic prior output so the architect and downstream
+        // agents read it as context — the brainstorm session's converged direction feeding the
+        // next stage's prompt (reviews are task-scoped, so frames/modules skip the lookup).
+        const architectureDirection = block.level === 'task' ? await this.resolveBrainstormDirection(workspaceId, block.id) : null;
+        const priorOutputs = [
+            ...(architectureDirection
+                ? [{ agentKind: 'architecture-brainstorm', output: architectureDirection }]
+                : []),
+            ...instance.steps
+                .slice(0, instance.currentStep)
+                .filter((s) => s.output)
+                .map((s) => ({ agentKind: s.agentKind, output: s.output })),
+        ];
         // Resolve the best-practice fragments to inject for this step. `code-aware` kinds
         // get the running service's selected fragments unioned with the block's own pins;
         // other kinds keep only their block pins. Recorded on the step for observability.
@@ -103,6 +122,9 @@ export class AgentContextBuilder {
             ...(instance.initiatedBy != null ? { initiatedByUserId: instance.initiatedBy } : {}),
             stepIndex: instance.currentStep,
             isFinalStep,
+            // The future-looking Follow-up companion is enabled for this (coder) step: the
+            // container executor appends the follow-up guidance + sets the harness to stream items.
+            ...(step.followUps?.enabled ? { followUpCompanion: true } : {}),
             // Consensus config for this step (copied onto the step at run start). Read only
             // by the optional consensus executor, which decides — possibly gated on the
             // block estimate below — whether to run the multi-model process. Absent ⇒ standard.
@@ -233,6 +255,22 @@ export class AgentContextBuilder {
         }
         return null;
     }
+    /**
+     * The converged architecture direction for a block — the document the
+     * `architecture-brainstorm` dialogue settled on — or `null` when the feature is unwired or
+     * the block has no settled architecture session. Surfaced additively as a prior output (it
+     * augments, never replaces, the description), the brainstorm analogue of
+     * {@link resolveReworkedRequirements}.
+     */
+    async resolveBrainstormDirection(workspaceId, blockId) {
+        if (!this.deps.brainstormSessions)
+            return null;
+        const session = await this.deps.brainstormSessions.getByBlockStage(workspaceId, blockId, 'architecture');
+        if (session?.status === 'incorporated' && session.convergedDirection) {
+            return session.convergedDirection;
+        }
+        return null;
+    }
     /**
      * Resolve the best-practice fragments to fold into a step's system prompt. Service
      * fragments reach an agent ONLY when its kind carries the `code-aware` trait: those

package/dist/modules/execution/AgentContextBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentContextBuilder.js","sourceRoot":"","sources":["../../../src/modules/execution/AgentContextBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentContextBuilder.js","sourceRoot":"","sources":["../../../src/modules/execution/AgentContextBuilder.ts"],"names":[],"mappings":"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"}

package/dist/modules/execution/ExecutionService.d.ts

@@ -1,4 +1,4 @@
-import type { AgentFailureKind, Block, BlueprintService, ExecutionInstance, MergePresetRepository, PullRequestMerger, StepReviewComment, SubscriptionActivationRepository, TicketTrackerProvider, IssueWritebackProvider } from '@cat-factory/kernel';
+import type { AgentFailureKind, Block, BlueprintService, ExecutionInstance, FollowUpsStepState, MergePresetRepository, PullRequestMerger, StepReviewComment, SubscriptionActivationRepository, TicketTrackerProvider, IssueWritebackProvider } from '@cat-factory/kernel';
 import type { RunInitiatorScope } from '@cat-factory/kernel';
 import { type HasPersonalSubscription } from './individualVendors.logic.js';
 import { type ProviderCapabilities, type SubscriptionVendor } from '@cat-factory/kernel';
@@ -7,7 +7,8 @@ import type { NotificationService } from '../notifications/NotificationService.j
 import type { WorkspaceSettingsService } from '../settings/WorkspaceSettingsService.js';
 import type { RequirementReviewService } from '../requirements/RequirementReviewService.js';
 import type { ClarityReviewService } from '../clarity/ClarityReviewService.js';
-import type { IterationCapChoice, RequirementReview, ClarityReview, ResolveRequirementsExceededChoice } from '@cat-factory/kernel';
+import type { BrainstormService } from '../brainstorm/BrainstormService.js';
+import type { IterationCapChoice, RequirementReview, ClarityReview, BrainstormSession, BrainstormStage, ResolveRequirementsExceededChoice } from '@cat-factory/kernel';
 import type { LlmObservabilityService } from '../observability/LlmObservabilityService.js';
 import type { AccountRepository, BlockRepository, ExecutionRepository, PipelineRepository, WorkspaceRepository } from '@cat-factory/kernel';
 import type { Clock, IdGenerator } from '@cat-factory/kernel';
@@ -18,11 +19,13 @@ import type { DocumentRepository } from '@cat-factory/kernel';
 import type { TaskRepository } from '@cat-factory/kernel';
 import type { RequirementReviewRepository } from '@cat-factory/kernel';
 import type { ClarityReviewRepository } from '@cat-factory/kernel';
+import type { BrainstormSessionRepository } from '@cat-factory/kernel';
 import type { EnvironmentProvisioningService, EnvironmentTeardownService } from '@cat-factory/integrations';
 import type { BranchUpdater } from '@cat-factory/kernel';
 import type { BoardService } from '../board/BoardService.js';
 import type { SpendService } from '@cat-factory/spend';
 import type { AdvanceOptions, AdvanceResult } from './advance.js';
+import { type TesterEnvironment } from './tester-infra.logic.js';
 /**
  * Structural view of the Kaizen agent's scheduler the engine calls at run completion.
  * Kept minimal so the execution engine doesn't depend on the concrete `KaizenService`.
@@ -90,6 +93,19 @@ export interface ExecutionServiceDependencies {
      * answer → incorporate → re-review loop). Absent → the gate step passes through.
      */
     clarityReviewService?: ClarityReviewService;
+    /**
+     * Optional: the brainstorm (structured-dialogue) feature's services, one per stage, present
+     * when the brainstorm module is wired. Drive the special `requirements-brainstorm` /
+     * `architecture-brainstorm` gate steps (inline option-generator + the iterative propose →
+     * pick → incorporate → re-run loop). Absent → the gate steps pass through.
+     */
+    brainstormServices?: Record<BrainstormStage, BrainstormService>;
+    /**
+     * Optional: persistence for the brainstorm feature. Read by the agent-context builder to
+     * surface a converged `architecture-brainstorm` direction to the architect (the mirror of
+     * `requirementReviewRepository`). Absent → no substitution.
+     */
+    brainstormSessionRepository?: BrainstormSessionRepository;
     /**
      * Optional: resolves fragment ids against the merged tenant catalog (managed +
      * document-backed fragments), live-resolving linked Confluence/Notion/GitHub
@@ -214,6 +230,29 @@ export interface ExecutionServiceDependencies {
      * Absent (tests / GitHub not connected) → pre/post-ops are skipped.
      */
     resolveRunRepoContext?: ResolveRunRepoContext;
+    /**
+     * Optional: the deployment's default Tester environment when neither the task nor its
+     * service frame pins one — the floor of {@link resolveTesterEnvironment}. Absent →
+     * `ephemeral` (Cloudflare/Node, where there is no host runtime to test on). The local
+     * facade wires it to `local` (host Docker / DinD) by default, flipping to `ephemeral`
+     * when the workspace opts into its environment provider (`delegateTestEnvToProvider`).
+     * Used identically by the start gate and the agent-context materialisation so they agree.
+     */
+    resolveTesterFallbackDefault?: (workspaceId: string) => Promise<TesterEnvironment>;
+    /**
+     * Optional: whether the workspace REQUIRES its environment provider for the Tester (the
+     * local-mode "delegate test environments" opt-in). When it resolves true, an `ephemeral`
+     * Tester run with no provider connected is refused at start instead of failing later at
+     * provision time. Absent → false (Cloudflare/Node).
+     */
+    resolveRequireEnvironmentProvider?: (workspaceId: string) => Promise<boolean>;
+    /**
+     * Optional: assert the workspace has a usable container-agent backend before a run
+     * starts (local mode delegating agents to a runner pool that isn't registered throws a
+     * clean {@link ConflictError} here). Absent → no start-time check (Cloudflare/Node have
+     * a fixed backend; a missing local pool still fails loudly at dispatch).
+     */
+    assertAgentBackendConfigured?: (workspaceId: string) => Promise<void>;
 }
 /** Reconciles a Blueprinter step's tree onto the board in place (BoardScanService). */
 export interface BlueprintReconciler {
@@ -245,6 +284,7 @@ export declare class ExecutionService {
     private readonly requirementReviewService?;
     private readonly kaizenScheduler?;
     private readonly clarityReviewService?;
+    private readonly brainstormServices?;
     private readonly environmentProvisioning?;
     private readonly environmentTeardown?;
     private readonly branchUpdater?;
@@ -264,6 +304,9 @@ export declare class ExecutionService {
     private readonly requirementsKind;
     /** The clarity (bug-report triage) subject for {@link reviewGate}. */
     private readonly clarityKind;
+    /** The two brainstorm (structured-dialogue) subjects for {@link reviewGate}, by stage. */
+    private readonly requirementsBrainstormKind;
+    private readonly architectureBrainstormKind;
     private readonly blueprintReconciler?;
     private readonly notificationService?;
     private readonly workspaceSettingsService?;
@@ -283,6 +326,12 @@ export declare class ExecutionService {
      * without a checkout. Absent (tests / GitHub not connected) → pre/post-ops are skipped.
      */
     private readonly resolveRunRepoContext?;
+    /** Local-mode floor for the Tester environment (default `ephemeral`). See deps doc. */
+    private readonly resolveTesterFallbackDefault?;
+    /** Whether the workspace requires its env provider for the Tester (local-mode opt-in). */
+    private readonly resolveRequireEnvironmentProvider?;
+    /** Start-time assertion that a container-agent backend is configured (local-mode pool). */
+    private readonly assertAgentBackendConfigured?;
     /** Lazily-built polling-gate registry, keyed by `agentKind`. See {@link gateFor}. */
     private gateRegistryCache?;
     /**
@@ -290,7 +339,7 @@ export declare class ExecutionService {
      * {@link stepResolverFor} and {@link StepCompletionResolver}.
      */
     private stepResolverCache?;
-    constructor({ workspaceRepository, blockRepository, pipelineRepository, executionRepository, accountRepository, idGenerator, clock, agentExecutor, workRunner, executionEventPublisher, boardService, spendService, documentRepository, taskRepository, requirementReviewRepository, requirementReviewService, kaizenScheduler, clarityReviewRepository, clarityReviewService, fragmentResolver, environmentProvisioning, environmentTeardown, branchUpdater, blueprintReconciler, notificationService, workspaceSettingsService, llmObservability, pullRequestMerger, mergePresetRepository, ticketTrackerProvider, issueWriteback, subscriptionActivationRepository, resolveWorkspaceModelDefault, resolveProviderCapabilities, localTestInfraSupported, resolveRunRepoContext, runInitiatorScope, }: ExecutionServiceDependencies);
+    constructor({ workspaceRepository, blockRepository, pipelineRepository, executionRepository, accountRepository, idGenerator, clock, agentExecutor, workRunner, executionEventPublisher, boardService, spendService, documentRepository, taskRepository, requirementReviewRepository, requirementReviewService, kaizenScheduler, clarityReviewRepository, clarityReviewService, brainstormServices, brainstormSessionRepository, fragmentResolver, environmentProvisioning, environmentTeardown, branchUpdater, blueprintReconciler, notificationService, workspaceSettingsService, llmObservability, pullRequestMerger, mergePresetRepository, ticketTrackerProvider, issueWriteback, subscriptionActivationRepository, resolveWorkspaceModelDefault, resolveProviderCapabilities, localTestInfraSupported, resolveRunRepoContext, resolveTesterFallbackDefault, resolveRequireEnvironmentProvider, assertAgentBackendConfigured, runInitiatorScope, }: ExecutionServiceDependencies);
     private requireWorkspace;
     private requireBlock;
     /**
@@ -729,6 +778,60 @@ export declare class ExecutionService {
      * run leaves behind are untouched. Best-effort: no notification service (tests) is a no-op.
      */
     private clearWaitingNotification;
+    /**
+     * Append the items the harness streamed since the last poll onto the Coder step's
+     * follow-up state as fresh `pending` items. A no-op when the companion is off or nothing
+     * was streamed. Returns whether anything was added (so the poller persists + emits).
+     */
+    private appendStreamedFollowUps;
+    /**
+     * The Follow-up companion gate, evaluated when the Coder step completes: park the run on
+     * a durable decision while any item is undecided; else loop the Coder for the queued /
+     * answered items (within the budget); else fall through (return undefined) so the normal
+     * advance/finish logic runs. Returns an {@link AdvanceResult} only when it parks or loops.
+     */
+    private evaluateFollowUpGate;
+    /**
+     * Reset the Coder step and fold the human's queued follow-ups / answered questions into
+     * its rework so the next pass extends the prior work. Marks those items `sentToCoder` so
+     * a later completion doesn't re-loop them, and counts the loop against the budget. Shared
+     * by the at-completion path ({@link evaluateFollowUpGate}) and the parked-resume path.
+     */
+    private loopCoderForFollowUps;
+    /** Raise the "follow-ups need decisions" inbox card when the Coder parks on undecided items. */
+    private raiseFollowUpPending;
+    /**
+     * The run's "active" follow-up companion step for a read with no item context (the GET /
+     * the inbox-card open). A pipeline may carry MORE THAN ONE follow-up-enabled Coder step,
+     * so this must not blindly pick the first: prefer the step the run is currently on (a Coder
+     * parked on its follow-up gate), else the latest enabled step that has surfaced items, else
+     * the first enabled one.
+     */
+    private activeFollowUpStep;
+    /** Read a run's live follow-up companion state (the active Coder step's items), or null. */
+    getFollowUps(workspaceId: string, executionId: string): Promise<FollowUpsStepState | null>;
+    /**
+     * Locate the run + the Coder step that OWNS the addressed item + the item, throwing 404
+     * when absent. Routes by item id (not "the first enabled step") so a pipeline carrying more
+     * than one follow-up-enabled Coder step decides each item on the step that surfaced it —
+     * otherwise a later Coder's items 404 and its gate can never be cleared.
+     */
+    private loadFollowUpItem;
+    /** File a `follow_up` item as a tracker issue (GitHub / Jira), recording the ticket ref. */
+    fileFollowUp(workspaceId: string, executionId: string, itemId: string): Promise<FollowUpsStepState>;
+    /** Queue a `follow_up` item to send back to the Coder on its next pass. */
+    queueFollowUp(workspaceId: string, executionId: string, itemId: string): Promise<FollowUpsStepState>;
+    /** Answer a `question` item; the answer is folded into the Coder's next pass. */
+    answerFollowUp(workspaceId: string, executionId: string, itemId: string, answer: string): Promise<FollowUpsStepState>;
+    /** Dismiss a follow-up / question item without acting on it. */
+    dismissFollowUp(workspaceId: string, executionId: string, itemId: string): Promise<FollowUpsStepState>;
+    /**
+     * Persist an item decision and, when the run is PARKED on this step's follow-up gate and
+     * every item is now decided, drive it forward: loop the Coder for the queued / answered
+     * items (within the budget), else advance past the gate. When the run is not parked (the
+     * Coder is still running, or it already moved on) this only persists + emits the change.
+     */
+    private driveFollowUpsAfterDecision;
     /** Provision inputs (`{{input.*}}`) derived from the block under deployment. */
     private deployInputs;
     /**
@@ -792,6 +895,25 @@ export declare class ExecutionService {
      * the requirements kind.
      */
     private buildClarityKind;
+    /**
+     * A brainstorm (structured-dialogue) subject for {@link reviewGate}, parameterised by stage.
+     * Otherwise identical to the requirements kind — the service handles its own upstream context
+     * (the architecture stage seeds from the refined requirements). The brainstorm services
+     * resolve their model exactly like the requirements reviewer, so the cap knobs are reused.
+     */
+    private buildBrainstormKind;
+    /** Pick the brainstorm kind for a stage (the dedicated window drives both via the same loop). */
+    private brainstormKindFor;
+    /** Run a fresh brainstorm pass over a block + stage (off-path inspector / window surface). */
+    reviewBrainstorm(workspaceId: string, blockId: string, stage: BrainstormStage): Promise<BrainstormSession>;
+    /** Incorporate the human's picks ASYNCHRONOUSLY (the brainstorm mirror of {@link incorporateRequirements}). */
+    incorporateBrainstorm(workspaceId: string, blockId: string, stage: BrainstormStage, feedback?: string): Promise<BrainstormSession>;
+    /** Re-run the brainstorm against the converged direction (one more pass). */
+    reReviewBrainstorm(workspaceId: string, blockId: string, stage: BrainstormStage): Promise<BrainstormSession>;
+    /** Proceed: settle the brainstorm (last converged direction wins downstream) and advance. */
+    proceedBrainstorm(workspaceId: string, blockId: string, stage: BrainstormStage): Promise<BrainstormSession>;
+    /** Resolve a brainstorm that hit its iteration cap (extra-round / proceed / stop-reset). */
+    resolveBrainstormExceeded(workspaceId: string, blockId: string, stage: BrainstormStage, choice: ResolveRequirementsExceededChoice): Promise<BrainstormSession>;
     /**
      * Run a fresh reviewer pass over a block's collected requirements, snapshotting the
      * task's merge-preset knobs (iteration budget + tolerated severity) onto the review.