pi-crew 0.11.4 → 0.11.5

package/docs/actions-reference.md

@@ -48,6 +48,7 @@ Reads the versioned `PlanRecord` list at `<stateRoot>/plans/plans.json` (ADR-4).
 | `search` | BM25-ranked agent/team discovery | Smart search |
 | `events` | Read the event log | Debug/audit |
 | `artifacts` | List run artifacts | View outputs |
+| `breakdown` | Read per-task prompt-token breakdown artifacts | Debug prompt bloat (requires `PI_CREW_PROMPT_BREAKDOWN=1`) |
 | `worktrees` | List run worktree metadata | Inspect worktrees |
 | `graph` | Load/save/list run graphs | Visualization |
 | `explain` | Explain a run or task structure | Understand a run |
@@ -77,6 +78,7 @@ Reads the versioned `PlanRecord` list at `<stateRoot>/plans/plans.json` (ADR-4).
 | **`workflow-list`** | **v0.9.0** List static + dynamic workflows | Discover workflows |
 | **`workflow-save`** | **v0.9.0** Overwrite `.dwf.ts` source (requires `confirm:true`) | Update dynamic workflow |
 | **`workflow-delete`** | **v0.9.0** Delete a `.dwf.ts` (requires `confirm:true`) | Remove dynamic workflow |
+| `compare` | Compare two runs side by side (US-021) | Diff before/after a fix, or two attempts at one goal |
 | `help` | Display help text | Help |
 
 ---
@@ -420,6 +422,26 @@ Append-only JSONL events: task.started, task.completed, run.blocked, etc.
 
 ---
 
+### `breakdown` — Per-task prompt-token breakdown
+
+G18 (opt-in measurement surface): reads the per-task
+`metadata/<taskId>.prompt-breakdown.json` artifacts and aggregates per-task
+`estTokens` totals plus the top-5 largest prompt sections. Artifacts are
+recorded only when the host Pi session is started with
+`PI_CREW_PROMPT_BREAKDOWN=1` (default off — zero cost when off).
+
+```json
+{
+  "action": "breakdown",
+  "runId": "team_...",
+  "taskId": "01_plan"
+}
+```
+
+`taskId` is optional — omit it to aggregate every task with a breakdown.
+
+---
+
 ### `worktrees` — Worktree metadata
 
 ```json

package/index.ts

@@ -4,7 +4,10 @@
  * Resolution order:
  *   1. dist/index.mjs (bundle) when present AND not explicitly disabled.
  *      Default since v0.9.17 close-out — benchmarks show bundle is
- *      ~19% faster total cold-start (post-fsync) than strip-types.
+ *      ~19% faster cold-start on a cold Node cache; with a warm
+ *      NODE_COMPILE_CACHE the gap shrinks to ~2%. The bundle's primary
+ *      value is correctness (vendored typebox) and deterministic startup,
+ *      not raw speed.
  *      See `scripts/bench-cold-start.mjs` for reproducible numbers.
  *   2. Inline strip-types loading — fallback when bundle is missing
  *      (e.g. dev clone without `npm run build:bundle`) OR when
@@ -52,9 +55,9 @@ import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
 
 // IMPORTANT: src/ imports here MUST be dynamic (lazy `import()`), never
-// top-level static imports. Published npm packages ship only dist/index.mjs
-// in the tarball (src/ is excluded by the package.json "files" field — keeps
-// the package ~5MB instead of ~16MB). A top-level static
+// top-level static imports. The npm tarball ships dist/index.mjs as the
+// entry and ALSO includes src/ (see "files" in package.json) for source
+// maps of future tooling. dist/index.mjs is ~1.6MB. A top-level static
 // `import { x } from "./src/..."` is resolved by the module loader BEFORE
 // this file's code runs, so it would break every fresh `npm install`
 // (Cannot find module './src/...'). Dynamic import() defers src/ resolution
@@ -105,7 +108,8 @@ if (!envForceOff) {
 // Lazy src/ fallback — only resolved when the bundle is unavailable
 // (dev clones without a built dist/). NEVER imported in published
 // installs, where the bundle always ships + loads above. This dynamic
-// import() is what lets us exclude src/ from the npm tarball.
+// import() keeps startup lazy so the bundle loads only when the extension
+// actually activates.
 let srcRegister:
 	| typeof import("./src/extension/register.ts").registerPiTeams
 	| undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-crew",
-	"version": "0.11.4",
+	"version": "0.11.5",
 	"description": "Pi extension for coordinated AI teams, workflows, worktrees, and async task orchestration",
 	"author": "baphuongna",
 	"license": "MIT",
@@ -136,23 +136,23 @@
 		"@earendil-works/pi-tui": "*"
 	},
 	"dependencies": {
-		"@sinclair/typebox": "^0.34.50",
-		"acorn": "^8.17.0",
+		"@sinclair/typebox": "^0.34.52",
+		"acorn": "^8.18.0",
 		"ajv": "^8.20.0",
 		"cli-highlight": "^2.1.11",
 		"diff": "^5.2.0",
-		"esbuild": "^0.28.1",
+		"esbuild": "^0.28.2",
 		"jiti": "^2.7.0",
-		"yaml": "^2.9.0"
+		"yaml": "^2.9.1"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.5.3",
+		"@biomejs/biome": "^2.5.14",
 		"@earendil-works/pi-agent-core": "^0.84.0",
 		"@earendil-works/pi-ai": "^0.84.0",
 		"@earendil-works/pi-coding-agent": "^0.84.0",
 		"@earendil-works/pi-tui": "^0.84.0",
-		"@types/node": "^25.9.5",
-		"tsx": "^4.23.0",
+		"@types/node": "^25.9.8",
+		"tsx": "^4.23.15",
 		"typescript": "^7.0.2"
 	},
 	"peerDependenciesMeta": {

package/scripts/analyze-run.mjs

@@ -12,7 +12,7 @@
  * pathological multi-GB runs, which pi-crew does not produce.
  *
  * Output:
- *   docs/perf-report-<runId>.md   — báo cáo tiếng Việt, bảng + 🔴 highlight
+ *   docs/perf/perf-report-<runId>.md — báo cáo tiếng Việt, bảng + 🔴 highlight
  *   bench/results/<runId>.json    — structured JSON
  */
 
@@ -706,7 +706,7 @@ async function main() {
 
 	// F1 (audit): validate runId to prevent path injection — runId flows into
 	// join(crewRoot, "state", "runs", runId) AND into output filenames
-	// (docs/perf-report-<runId>.md, bench/results/<runId>.json). Without this,
+	// (docs/perf/perf-report-<runId>.md, bench/results/<runId>.json). Without this,
 	// runId="../../tmp/x" would read/write outside the intended dirs.
 	if (!/^[A-Za-z0-9_.-]+$/.test(runId)) {
 		process.stderr.write(`Error: invalid runId (must be alphanumeric/_/./-): ${runId}\n`);
@@ -939,7 +939,10 @@ async function main() {
 
 	const resultsDir = join(process.cwd(), "bench", "results");
 	mkdirSync(resultsDir, { recursive: true });
-	const docsDir = join(process.cwd(), "docs");
+	// Perf reports write to docs/perf/ (runtime output, gitignored via the
+	// narrow `docs/perf/perf-report-team_*` pattern — curated perf docs in
+	// docs/perf/ stay tracked). Legacy location was docs/ top level.
+	const docsDir = join(process.cwd(), "docs", "perf");
 	mkdirSync(docsDir, { recursive: true });
 	const jsonPath = join(resultsDir, `${runId}.json`);
 	writeFileSync(jsonPath, JSON.stringify(report, null, 2));

package/skills/real-test-pi-crew/SKILL.md

@@ -1290,7 +1290,7 @@ Use this to answer "đủ full tính năng chưa?" without re-deriving. Every us
 
 | Feature | Code entry | Verify via |
 |---|---|---|
-| Team tool — 55 actions / 5 domains | `src/schema/team-tool-schema.ts:391-437`, dispatch in `src/extension/team-tool/` | 9a (read-only) + 9b/9c/9d/9e/9f theo domain |
+| Team tool — 56 actions / 5 domains | `src/schema/team-tool-schema.ts:391-437`, dispatch in `src/extension/team-tool/` | 9a (read-only) + 9b/9c/9d/9e/9f theo domain |
 | Runtime mode `child-process` (default) | `src/runtime/child-pi/` | 9b sync run + T7 |
 | Runtime mode `scaffold` (dry-run) | `src/runtime/task-runner/pre-execution.ts:176` | 9b `action='plan'`/`'plans'` (preview không spawn) hoặc run với `runtime.mode='scaffold'` |
 | Runtime mode `live-session` (experimental) | `src/runtime/live-session/` | Run với `runtime.mode='live-session'` + irc tool xuất hiện trong worker (`src/runtime/custom-tools/irc-tool.ts`) |

package/src/extension/team-tool/dispatch/index.ts

@@ -7,8 +7,8 @@
  *
  * 54→5 mapping:
  *   run     (9):  run, parallel, plan, orchestrate, resume, retry, wait, steer, goal
- *   status  (16): status, list, get, events, artifacts, summary, graph, search,
- *                 health, worktrees, checkpoint, cache, explain, onboard, recommend, help
+ *   status  (17): status, list, get, events, artifacts, breakdown, summary, graph,
+ *                 search, health, worktrees, checkpoint, cache, explain, onboard, recommend, help
  *   control (7):  cancel, invalidate, respond, cleanup, prune, forget, doctor
  *   manage  (17): create, update, delete, init, config, validate, autonomy, settings,
  *                 workflow-create/get/list/save/delete, import, imports, export, compare
@@ -36,12 +36,13 @@ const ACTION_TO_DOMAIN: Record<string, TeamDomain> = {
 	steer: "run",
 	goal: "run",
 
-	// status domain (16)
+	// status domain (17)
 	status: "status",
 	list: "status",
 	get: "status",
 	events: "status",
 	artifacts: "status",
+	breakdown: "status",
 	summary: "status",
 	graph: "status",
 	search: "status",

package/src/extension/team-tool/dispatch/status.ts

@@ -1,8 +1,9 @@
 /**
  * API-5 facade dispatch — Status domain router.
  *
- * Actions: status, list, get, events, artifacts, summary, graph, search,
- * health, worktrees, checkpoint, cache, explain, onboard, recommend, help.
+ * Actions: status, list, get, events, artifacts, breakdown, summary, graph,
+ * search, health, worktrees, checkpoint, cache, explain, onboard, recommend,
+ * help.
  *
  * Inline cases (graph, search, onboard, explain, cache, checkpoint, recommend,
  * help) are moved verbatim from the former handleTeamTool switch.
@@ -28,7 +29,7 @@ import type { PiTeamsToolResult } from "../../tool-result.ts";
 import { result, type TeamContext } from "../context.ts";
 import { handleExplain } from "../explain.ts";
 import { handleHealthMonitor } from "../health-monitor.ts";
-import { handleArtifacts, handleEvents, handleSummary } from "../inspect.ts";
+import { handleArtifacts, handleBreakdown, handleEvents, handleSummary } from "../inspect.ts";
 import { handleWorktrees } from "../lifecycle-actions.ts";
 import { handleStatus } from "../status.ts";
 
@@ -45,6 +46,7 @@ export const STATUS_DOMAIN_ACTIONS = [
 	"get",
 	"events",
 	"artifacts",
+	"breakdown",
 	"summary",
 	"graph",
 	"search",
@@ -73,6 +75,8 @@ export async function handleStatusDomain(params: TeamToolParamsValue, ctx: TeamC
 			return handleEvents(params, ctx);
 		case "artifacts":
 			return handleArtifacts(params, ctx);
+		case "breakdown":
+			return handleBreakdown(params, ctx);
 		case "worktrees":
 			return handleWorktrees(params, ctx);
 		case "summary":

package/src/extension/team-tool/inspect.ts

@@ -1,3 +1,5 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
 import type { TeamToolParamsValue } from "../../schema/team-tool-schema.ts";
 import { readEventsCursor } from "../../state/event-log/event-log.ts";
 import { loadRunManifestById } from "../../state/stores/state-store.ts";
@@ -110,3 +112,91 @@ export function handleSummary(params: TeamToolParamsValue, ctx: TeamContext): Pi
 		artifactsRoot: loaded.manifest.artifactsRoot,
 	});
 }
+
+// ─── G18 (SDD 2026-09-30 WI-3): prompt-token breakdown surface ──────────────
+
+/** File suffix of the per-task breakdown artifact written by pre-execution
+ *  (`metadata/<taskId>.prompt-breakdown.json`) when PI_CREW_PROMPT_BREAKDOWN=1. */
+const BREAKDOWN_FILE_SUFFIX = ".prompt-breakdown.json";
+
+/** Shape of one section entry in a prompt-breakdown JSON artifact
+ *  (see writeArtifact call in src/runtime/task-runner/pre-execution.ts). */
+interface PromptBreakdownSection {
+	chars: number;
+	estTokens: number;
+}
+
+/**
+ * G18: read the opt-in per-task prompt-token breakdown artifacts of a run and
+ * surface per-task totals + the top-5 largest sections. Consumers: the leader
+ * prompt (future W-F token decisions, G15/G17) and humans debugging prompt
+ * bloat. The artifacts exist only when the host session was started with
+ * PI_CREW_PROMPT_BREAKDOWN=1 (default off — zero cost when off, SR-02).
+ * Mirrors the handleArtifacts pattern: resolve run → read the manifest
+ * artifacts index → filter kind=metadata breakdown entries → read files.
+ */
+export function handleBreakdown(params: TeamToolParamsValue, ctx: TeamContext): PiTeamsToolResult {
+	if (!params.runId)
+		return result(
+			paramRequired("breakdown", "runId", "{ action: 'breakdown', runId: 'team_...' }"),
+			{ action: "breakdown", status: "error" },
+			true,
+		);
+	const runCwd = locateRunCwd(params.runId, ctx.cwd);
+	if (!runCwd) return result(`Run '${params.runId}' not found.${RUN_NOT_FOUND_HINT}`, { action: "breakdown", status: "error" }, true);
+	const loaded = loadRunManifestById(runCwd, params.runId); // NOTE: no withRunLock - best-effort only; concurrent writes may cause inconsistency
+	if (!loaded) return result(`Run '${params.runId}' not found.${RUN_NOT_FOUND_HINT}`, { action: "breakdown", status: "error" }, true);
+	// Index-driven lookup (no disk scan): the manifest artifacts index carries
+	// one metadata entry per task with a prompt breakdown.
+	const breakdownArtifacts = loaded.manifest.artifacts.filter(
+		(artifact) => artifact.kind === "metadata" && path.basename(artifact.path).endsWith(BREAKDOWN_FILE_SUFFIX),
+	);
+	const perTask: Array<{
+		taskId: string;
+		totalEstTokens: number;
+		topSections: Array<{ section: string; estTokens: number; chars: number }>;
+	}> = [];
+	for (const artifact of breakdownArtifacts) {
+		const taskId = path.basename(artifact.path).slice(0, -BREAKDOWN_FILE_SUFFIX.length);
+		if (params.taskId && taskId !== params.taskId) continue;
+		let sections: Record<string, PromptBreakdownSection>;
+		try {
+			sections = JSON.parse(fs.readFileSync(artifact.path, "utf-8")) as Record<string, PromptBreakdownSection>;
+		} catch {
+			continue; // unreadable/corrupt breakdown JSON — skip rather than fail the whole action
+		}
+		const entries = Object.entries(sections).filter((entry): entry is [string, PromptBreakdownSection] => {
+			const value = entry[1];
+			return value !== null && typeof value === "object" && typeof value.estTokens === "number";
+		});
+		const totalEstTokens = entries.reduce((sum, [, value]) => sum + value.estTokens, 0);
+		const topSections = [...entries]
+			.sort((a, b) => b[1].estTokens - a[1].estTokens)
+			.slice(0, 5)
+			.map(([section, value]) => ({ section, estTokens: value.estTokens, chars: value.chars ?? 0 }));
+		perTask.push({ taskId, totalEstTokens, topSections });
+	}
+	if (perTask.length === 0) {
+		const scope = params.taskId ? ` for task '${params.taskId}'` : "";
+		return result(
+			`No prompt-breakdown artifacts${scope} for ${loaded.manifest.runId}. Breakdown capture is opt-in: start the host Pi session with PI_CREW_PROMPT_BREAKDOWN=1 and re-run to record per-section token estimates.`,
+			{ action: "breakdown", status: "ok", runId: loaded.manifest.runId, data: { runTotal: 0, perTask: [] } },
+		);
+	}
+	const runTotal = perTask.reduce((sum, task) => sum + task.totalEstTokens, 0);
+	const lines = [
+		`Prompt-token breakdown for ${loaded.manifest.runId}:`,
+		...perTask.flatMap((task) => [
+			`- ${task.taskId}: ~${task.totalEstTokens} tokens`,
+			...task.topSections.map((section) => `    - ${section.section}: ~${section.estTokens} tokens (${section.chars} chars)`),
+		]),
+		`Run total: ~${runTotal} tokens`,
+	];
+	return result(lines.join("\n"), {
+		action: "breakdown",
+		status: "ok",
+		runId: loaded.manifest.runId,
+		artifactsRoot: loaded.manifest.artifactsRoot,
+		data: { runTotal, perTask },
+	});
+}

package/src/runtime/recovery/crash-recovery.ts

@@ -750,7 +750,12 @@ export async function reconcileAllStaleRuns(
 				const result = reconcileStaleRun(fresh.manifest, fresh.tasks, now);
 				if (result.repaired || result.verdict === "result_exists") {
 					if (result.repairedTasks) {
-						saveRunTasks(fresh.manifest, result.repairedTasks);
+						// NEW-1 (SDD 2026-09-30 WI-2): persist the FULL task array — the
+						// individual-stale branch filters `repairedTasks` down to the stale
+						// subset, and saveRunTasks full-overwrites tasks.json, which used to
+						// drop every healthy task from disk. `persistTasks` carries the full
+						// array; every other branch leaves it unset and falls back here.
+						saveRunTasks(fresh.manifest, result.persistTasks ?? result.repairedTasks);
 						for (const task of result.repairedTasks) {
 							try {
 								upsertCrewAgent(fresh.manifest, recordFromTask(fresh.manifest, task, "scaffold"));

package/src/runtime/stale-reconciler.ts

@@ -44,6 +44,13 @@ export interface ReconcileResult {
 	detail: string;
 	/** Repaired task state, returned to a locked caller for persistence. */
 	repairedTasks?: TeamTaskState[];
+	/** NEW-1 (SDD 2026-09-30 WI-2): what the caller should PERSIST — the FULL
+	 *  task array, including tasks the repair did not touch. Only the
+	 *  individual-stale branch sets it (its `repairedTasks` is filtered down to
+	 *  the stale subset, which must NOT be full-overwrite-persisted or healthy
+	 *  tasks vanish from tasks.json). Callers fall back to `repairedTasks`
+	 *  when absent — every other branch already returns the full array there. */
+	persistTasks?: TeamTaskState[];
 }
 
 /**
@@ -490,6 +497,7 @@ export function reconcileStaleRun(manifest: TeamRunManifest, tasks: TeamTaskStat
 				repaired: true,
 				detail: `No PID; ${staleTaskIds.length} individually stale task(s) repaired: ${staleTaskIds.join(", ")}`,
 				repairedTasks: repaired.filter((t) => staleTaskIds.includes(t.id)),
+				persistTasks: repaired, // NEW-1: persist FULL array (data-loss fix — SDD WI-2)
 			};
 		}
 		// Fall through: no recent activity but not all tasks stale enough yet.

package/src/runtime/task-output-context.ts

@@ -526,6 +526,16 @@ export function collectDependencyOutputContext(
 	return { dependencies: trimmedDependencies, sharedReads };
 }
 
+// ADR-5 §trust-fence: dependency output is DATA, never instructions. Mirror the
+// ask/delegate seams in src/prompt/prompt-runtime.ts (:323, :426, :589): strip
+// control chars and neutralize a smuggled closing fence tag so worker-controlled
+// content can never close the <dependency-context> fence early (see SDD 2026-09-30 WI-1).
+const DEPENDENCY_CONTROL_CHAR_PATTERN = /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g;
+
+function sanitizeFencedBody(body: string): string {
+	return body.replace(DEPENDENCY_CONTROL_CHAR_PATTERN, "").replace(/<\/dependency-context/g, "&lt;/dependency-context");
+}
+
 export function renderDependencyOutputContext(context: DependencyOutputContext): string {
 	const parts: string[] = [];
 	if (context.dependencies.length) {
@@ -565,7 +575,7 @@ export function renderDependencyOutputContext(context: DependencyOutputContext):
 			parts.push("", read.content.trim(), "");
 		}
 	}
-	return parts.join("\n").trim();
+	return sanitizeFencedBody(parts.join("\n").trim());
 }
 
 export function writeTaskSharedOutput(manifest: TeamRunManifest, step: WorkflowStep, task: TeamTaskState): ArtifactDescriptor | undefined {

package/src/runtime/task-runner/post-execution.ts

@@ -131,6 +131,7 @@ export async function finalizeTaskResult(ctx: TaskExecutionContext, execResult:
 	const skillNames = ctx.skillNames;
 	const skillPaths = ctx.skillPaths;
 	const promptArtifact = ctx.promptArtifact;
+	const breakdownArtifact = ctx.breakdownArtifact;
 	const inputsArtifact = ctx.inputsArtifact;
 	const skillArtifact = ctx.skillArtifact;
 	const coordinationArtifact = ctx.coordinationArtifact;
@@ -623,6 +624,7 @@ export async function finalizeTaskResult(ctx: TaskExecutionContext, execResult:
 		artifacts: [
 			...manifest.artifacts,
 			promptArtifact,
+			...(breakdownArtifact ? [breakdownArtifact] : []),
 			...(resultArtifact ? [resultArtifact] : []),
 			inputsArtifact,
 			coordinationArtifact,

package/src/runtime/task-runner/pre-execution.ts

@@ -71,6 +71,8 @@ export interface TaskExecutionContext {
 	skillPaths: string[] | undefined;
 	prompt: string;
 	promptArtifact: ArtifactDescriptor;
+	/** G18: prompt-breakdown artifact descriptor (undefined when PI_CREW_PROMPT_BREAKDOWN off). */
+	breakdownArtifact?: ArtifactDescriptor;
 	inputsArtifact: ArtifactDescriptor;
 	skillArtifact: ArtifactDescriptor | undefined;
 	coordinationArtifact: ArtifactDescriptor;
@@ -343,27 +345,32 @@ export async function prepareTaskExecutionContext(
 	// SR-02 phase 1: per-section breakdown artifact (opt-in via
 	// PI_CREW_PROMPT_BREAKDOWN=1). Adds the SYSTEM-side pieces the prompt
 	// builder cannot see (agent definition, skills, pre-step output).
-	if (promptBreakdownEnabled()) {
-		const sections: Record<string, number> = {
-			"system.agentDefinition": input.agent?.systemPrompt?.length ?? 0,
-			...(promptResult.sections ?? {}),
-			"dynamic.preStepOutput": preStepOutput?.length ?? 0,
-		};
-		writeArtifact(manifest.artifactsRoot, {
-			kind: "metadata",
-			relativePath: `metadata/${task.id}.prompt-breakdown.json`,
-			content: `${JSON.stringify(
-				Object.fromEntries(
-					Object.entries(sections)
-						.filter(([, chars]) => chars > 0)
-						.map(([name, chars]) => [name, { chars, estTokens: estimateTokens(chars) }]),
-				),
-				null,
-				2,
-			)}\n`,
-			producer: "prompt-breakdown",
-		});
-	}
+	// G18 (SDD Buổi-1 WI-3 follow-up): capture the descriptor so it flows
+	// through ctx into the manifest artifacts index — otherwise the
+	// `breakdown` team-tool action cannot find it on real runs.
+	const breakdownArtifact: ArtifactDescriptor | undefined = promptBreakdownEnabled()
+		? (() => {
+				const sections: Record<string, number> = {
+					"system.agentDefinition": input.agent?.systemPrompt?.length ?? 0,
+					...(promptResult.sections ?? {}),
+					"dynamic.preStepOutput": preStepOutput?.length ?? 0,
+				};
+				return writeArtifact(manifest.artifactsRoot, {
+					kind: "metadata",
+					relativePath: `metadata/${task.id}.prompt-breakdown.json`,
+					content: `${JSON.stringify(
+						Object.fromEntries(
+							Object.entries(sections)
+								.filter(([, chars]) => chars > 0)
+								.map(([name, chars]) => [name, { chars, estTokens: estimateTokens(chars) }]),
+						),
+						null,
+						2,
+					)}\n`,
+					producer: "prompt-breakdown",
+				});
+			})()
+		: undefined;
 
 	const collectedJsonEvents: Record<string, unknown>[] | undefined = collectYieldEvents ? [] : undefined;
 
@@ -415,6 +422,7 @@ export async function prepareTaskExecutionContext(
 			skillPaths,
 			prompt,
 			promptArtifact,
+			breakdownArtifact,
 			inputsArtifact,
 			skillArtifact,
 			coordinationArtifact,

package/src/schema/team-tool-schema.ts

@@ -398,7 +398,7 @@ const sharedFields = {
 	),
 };
 
-// ─── Domain action unions (10+16+7+16+6 = 55 actions) ──────────────────────
+// ─── Domain action unions (10+17+7+17+6 = 57 actions) ──────────────────────
 
 const ACTION_DESCRIPTION = "Team action. Defaults to 'list' when omitted.";
 
@@ -411,6 +411,7 @@ const STATUS_ACTIONS = [
 	"get",
 	"events",
 	"artifacts",
+	"breakdown",
 	"summary",
 	"graph",
 	"search",