ultimate-pi 0.10.1 → 0.12.0

package/CHANGELOG.md

@@ -4,6 +4,30 @@ All notable changes to this project are documented in this file.
 
 ## [Unreleased]
 
+## [v0.12.0] — 2026-05-18
+
+### ✨ Features
+
+- **Harness subagents:** vendor `pi-subagents`; spawn budget, precheck, and policy bridge.
+- **Router spawn auth:** forward concrete provider/model + API key to subprocesses using `--no-extensions` (fixes planning scout 401 with `router/auto`).
+- **Plan review gate:** debate orchestration, execution-plan schemas, `write_harness_yaml`, plan-phase smoke fixture (ADR 0035).
+
+### 🔧 Chores
+
+- Stop tracking harness runtime and local graphify artifacts in git.
+
+## [v0.11.0] — 2026-05-17
+
+### ✨ Features
+
+- **Harness Darwin plan pipeline:** decomposition and hypothesis agents with plan-adversary, scouts, and structured plan brief schemas (ADR 0034).
+- **Harness plan review:** `plan-review.md` for editor review; extension load guard.
+- **Cursor Pi experts:** cursor-pi domain expert agents.
+
+### 🔄 CI/CD
+
+- **Biome:** ignore harness runtime JSON; format committed harness plan pipeline sources.
+
 ## [v0.10.1] — 2026-05-17
 
 ### 🐛 Fixes

package/THIRD_PARTY_NOTICES.md

@@ -14,3 +14,11 @@
 - **License:** MIT (see upstream repository)  
 - **Pinned revision:** See [vendor/pi-vcc/UPSTREAM_PIN.md](vendor/pi-vcc/UPSTREAM_PIN.md)  
 - ultimate-pi loads it from [`vendor/pi-vcc`](vendor/pi-vcc) via [`.pi/extensions/ultimate-pi-vcc.ts`](.pi/extensions/ultimate-pi-vcc.ts). Harness configuration is env-only: `HARNESS_VCC_COMPACTION`, `HARNESS_VCC_DEBUG` ([`.pi/extensions/lib/harness-vcc-settings.ts`](.pi/extensions/lib/harness-vcc-settings.ts)). Maintainer refresh: `npm run vendor:sync-vcc`.
+
+## pi-subagents (vendored)
+
+- **Project:** https://github.com/narumiruna/pi-extensions (`extensions/pi-subagents`)  
+- **npm:** `@narumitw/pi-subagents@0.1.26`  
+- **License:** MIT ([vendor/pi-subagents/LICENSE](vendor/pi-subagents/LICENSE))  
+- **Pinned revision:** See [vendor/pi-subagents/UPSTREAM_PIN.md](vendor/pi-subagents/UPSTREAM_PIN.md)  
+- ultimate-pi loads it from [`vendor/pi-subagents`](vendor/pi-subagents) via [`.pi/extensions/harness-subagents.ts`](.pi/extensions/harness-subagents.ts) with harness discovery, spawn gates, and subprocess env. Maintainer refresh: `npm run vendor:sync-subagents`.

package/biome.json

@@ -12,7 +12,10 @@
 			"**/*.{ts,tsx,js,jsx,json,jsonc,css}",
 			"!graphify-out/**/*",
 			"!graphify-books-out/**/*",
-			"!vendor/**/*"
+			"!vendor/**/*",
+			"!.pi/harness/active-run.json",
+			"!.pi/harness/runs/**/run-context.yaml",
+			"!.pi/harness/runs/**/plan-packet.yaml"
 		]
 	},
 	"formatter": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ultimate-pi",
-	"version": "0.10.1",
+	"version": "0.12.0",
 	"description": "Ultimate AI coding harness for pi.dev — extensible skills, Obsidian wiki knowledge layer, compressed context, deterministic output",
 	"keywords": [
 		"pi-package",
@@ -73,16 +73,17 @@
 		"@earendil-works/pi-coding-agent": "*"
 	},
 	"scripts": {
-		"check:ts": "tsc --noEmit --target ES2023 --lib ES2023 --moduleResolution nodenext --module nodenext --skipLibCheck .pi/extensions/00-ultimate-pi-system-prompt.ts .pi/lib/harness-run-context.ts .pi/lib/harness-ui-state.ts .pi/extensions/harness-run-context.ts .pi/extensions/lib/harness-vcc-settings.ts .pi/extensions/dotenv-loader.ts .pi/extensions/lib/posthog-node.d.ts .pi/extensions/lib/harness-posthog.ts .pi/extensions/lib/harness-paths.ts .pi/extensions/pi-model-router-harness.ts .pi/extensions/provider-payload-sanitize.ts .pi/extensions/harness-telemetry.ts .pi/extensions/harness-ask-user.ts .pi/extensions/harness-plan-approval.ts .pi/extensions/lib/ask-user/schema.ts .pi/extensions/lib/ask-user/types.ts .pi/extensions/lib/ask-user/validate.ts .pi/extensions/lib/ask-user/dialog.ts .pi/extensions/lib/ask-user/fallback.ts .pi/extensions/lib/ask-user/render.ts .pi/extensions/lib/plan-approval/types.ts .pi/extensions/lib/plan-approval/schema.ts .pi/extensions/lib/plan-approval/validate.ts .pi/extensions/lib/plan-approval/format-plan.ts .pi/extensions/lib/plan-approval/dialog.ts .pi/extensions/lib/plan-approval/fallback.ts .pi/extensions/lib/plan-approval/render.ts .pi/extensions/lib/plan-approval/create-plan.ts .pi/extensions/lib/harness-subagents/parent-harness-ui-bridge.ts .pi/extensions/lib/harness-subagents/parent-harness-ui-hooks.ts .pi/extensions/lib/harness-subagents/parent-ask-user-bridge.ts .pi/extensions/trace-recorder.ts .pi/extensions/observation-bus.ts .pi/extensions/drift-monitor.ts .pi/extensions/policy-gate.ts .pi/extensions/budget-guard.ts .pi/extensions/debate-orchestrator.ts .pi/extensions/harness-live-widget.ts .pi/extensions/sentrux-rules-sync.ts .pi/extensions/custom-header.ts .pi/extensions/lib/harness-subagents/agent-loader.ts .pi/extensions/lib/harness-subagents/agent-parser.ts .pi/extensions/lib/harness-subagents/agent-manifest.ts .pi/extensions/lib/harness-subagents/blackboard.ts .pi/extensions/lib/harness-subagents/blackboard-tool.ts .pi/extensions/lib/harness-subagents/spawn-policy.ts .pi/extensions/lib/harness-subagents/types-blackboard.ts .pi/extensions/harness-web-tools.ts .pi/extensions/harness-web-guard.ts .pi/extensions/lib/harness-web/run-cli.ts",
+		"check:ts": "tsc --noEmit --target ES2023 --lib ES2023 --moduleResolution nodenext --module nodenext --skipLibCheck .pi/extensions/custom-system-prompt.ts .pi/lib/harness-run-context.ts .pi/lib/harness-ui-state.ts .pi/extensions/harness-run-context.ts .pi/extensions/lib/harness-vcc-settings.ts .pi/extensions/dotenv-loader.ts .pi/extensions/lib/posthog-node.d.ts .pi/extensions/lib/harness-posthog.ts .pi/extensions/lib/harness-paths.ts .pi/extensions/pi-model-router-harness.ts .pi/extensions/provider-payload-sanitize.ts .pi/extensions/harness-telemetry.ts .pi/extensions/harness-ask-user.ts .pi/extensions/harness-plan-approval.ts .pi/extensions/lib/ask-user/schema.ts .pi/extensions/lib/ask-user/types.ts .pi/extensions/lib/ask-user/validate.ts .pi/extensions/lib/ask-user/dialog.ts .pi/extensions/lib/ask-user/fallback.ts .pi/extensions/lib/ask-user/render.ts .pi/extensions/lib/plan-approval/types.ts .pi/extensions/lib/plan-approval/schema.ts .pi/extensions/lib/plan-approval/validate.ts .pi/extensions/lib/plan-approval/format-plan.ts .pi/extensions/lib/plan-approval/dialog.ts .pi/extensions/lib/plan-approval/fallback.ts .pi/extensions/lib/plan-approval/render.ts .pi/extensions/lib/plan-approval/create-plan.ts .pi/extensions/harness-subagents.ts .pi/extensions/lib/harness-subagents-bridge.ts .pi/extensions/lib/harness-subagent-auth.ts .pi/extensions/lib/harness-subagent-policy.ts .pi/extensions/lib/harness-subagent-precheck.ts .pi/extensions/lib/harness-spawn-budget.ts .pi/extensions/lib/spawn-policy.ts vendor/pi-subagents/src/agents.ts vendor/pi-subagents/src/subagents.ts .pi/extensions/trace-recorder.ts .pi/extensions/observation-bus.ts .pi/extensions/drift-monitor.ts .pi/extensions/policy-gate.ts .pi/extensions/budget-guard.ts .pi/extensions/debate-orchestrator.ts .pi/extensions/harness-live-widget.ts .pi/extensions/sentrux-rules-sync.ts .pi/extensions/custom-header.ts .pi/extensions/harness-web-tools.ts .pi/extensions/harness-web-guard.ts .pi/extensions/lib/harness-web/run-cli.ts",
 		"vendor:sync-router": "bash .pi/scripts/vendor-sync-pi-model-router.sh",
 		"vendor:sync-vcc": "bash .pi/scripts/vendor-sync-pi-vcc.sh",
+		"vendor:sync-subagents": "bash .pi/scripts/vendor-sync-pi-subagents.sh",
 		"release": "bash .pi/scripts/release.sh",
 		"lint": "biome check",
 		"lint:fix": "biome check --fix",
 		"format": "biome format --write",
 		"format:check": "biome format",
 		"prepare": "lefthook install",
-		"test": "node --test test/harness-verify.test.mjs test/harness-ask-user.test.mjs test/harness-subagents-loader.test.mjs test/harness-subagents-import-path.test.mjs test/sentrux-rules-sync.test.mjs test/harness-budget-guard.test.mjs && npx -y tsx --test test/harness-vcc-settings.test.ts test/harness-plan-phase-policy.test.mjs test/harness-subagent-policy.test.mjs test/harness-turn-routing.test.mjs test/plan-approval-format.test.mjs test/plan-approval-dialog.test.mjs test/plan-approval-sync.test.mjs test/plan-create-plan.test.mjs",
+		"test": "node --test test/harness-verify.test.mjs test/harness-ask-user.test.mjs test/harness-subagents-loader.test.mjs test/harness-subagent-precheck.test.mjs test/sentrux-rules-sync.test.mjs test/harness-budget-guard.test.mjs && node .pi/harness/evals/smoke/smoke-harness-plan.mjs --fixture && npx -y tsx --test test/harness-vcc-settings.test.ts test/harness-plan-phase-policy.test.mjs test/harness-subagent-policy.test.mjs test/harness-spawn-budget.test.mjs test/harness-turn-routing.test.mjs test/plan-approval-format.test.mjs test/plan-approval-dialog.test.mjs test/plan-approval-sync.test.mjs test/plan-create-plan.test.mjs test/plan-review-format.test.mjs test/debate-plan-phase.test.mjs",
 		"test:vcc": "npx -y tsx --test vendor/pi-vcc/tests/*.test.ts",
 		"harness:sentrux-bootstrap": "node .pi/scripts/harness-sentrux-bootstrap.mjs",
 		"harness:sentrux-sync": "node .pi/scripts/sentrux-rules-sync.mjs --force",
@@ -96,7 +97,8 @@
 		"@earendil-works/pi-tui": "0.74.1",
 		"@sinclair/typebox": "^0.34.49",
 		"lefthook": "2.1.6",
-		"typescript": "^6.0.3"
+		"typescript": "^6.0.3",
+		"yaml": "^2.8.0"
 	},
 	"dependencies": {
 		"@posthog/pi": "latest",

package/.pi/agents/harness/planner.md

@@ -1,54 +0,0 @@
----
-description: Harness planner that compiles strict PlanPacket contracts before execution.
-tools: read, grep, find, ls, ask_user, approve_plan, create_plan
-disallowed_tools: write, edit, bash
-extensions: false
-thinking: medium
-max_turns: 20
-inherit_context: false
----
-
-You are the Harness Planner.
-
-## Mission
-
-Compile a strict, machine-readable `PlanPacket`, get user approval, and persist it with **`create_plan`**. You do **not** use `write` or `edit` — those are blocked. The parent orchestrator does not write `plan-packet.json`.
-
-## Spawn context
-
-Read the `HarnessSpawnContext` JSON in the spawn prompt (`schema_version`, `mode`, `task_summary`, `plan_packet_path`, `risk_level`, `quick`, etc.). Never set `inherit_context: true` on harness agents.
-
-## Process
-
-1. Use graphify context (`graphify-out/GRAPH_REPORT.md` or wiki) before claiming architecture — do not read harness spec JSON files from disk.
-2. Parse task scope, constraints, and acceptance intent from spawn context.
-3. **Greenfield** (`mode: create`) vs **revise** (`mode: revise`) — when revising, read the existing packet at `plan_packet_path` if present and amend.
-4. `--quick` / `quick: true` narrows breadth, never safety or rollback requirements.
-5. Build a complete `PlanPacket`: `plan_id`, `task_id`, `scope`, `assumptions`, `risk_level`, `acceptance_checks`, `rollback_plan` with `revert_command`, `revert_branch`, `patch_bundle`, `revert_commit_ready: true`.
-6. Escalate `risk_level` to `high` for blast radius, uncertainty, or policy-sensitive surfaces.
-7. If scope is ambiguous, call `ask_user` with structured options — do not return `needs_clarification` without trying `ask_user` first when options are clear.
-8. Call **`approve_plan`** with the full `plan_packet` (and optional `human_summary`). The parent TUI shows a scrollable plan plus **Approve** / **Request changes** / **Cancel**. On Request changes, revise and call `approve_plan` again.
-9. After the user selects **Approve**, call **`create_plan`** with the same `plan_packet` to write canonical `plan-packet.json` for this run.
-
-## Guardrails
-
-- Never call `write`, `edit`, or mutating `bash` — use **`create_plan`** only for the plan file.
-- Never speculate about code you have not read.
-- Do not execute or widen implementation scope.
-
-## Output (required JSON block)
-
-End with a single fenced `json` block the parent can parse:
-
-```json
-{
-  "status": "ready",
-  "plan_packet": { },
-  "human_summary": "…",
-  "clarification": null
-}
-```
-
-Use `"status": "needs_clarification"` only when blocked after `ask_user` or user cancelled; include `clarification` when the parent must intervene without a live subagent.
-
-When `create_plan` succeeds, set `status` to `"ready"` and confirm `plan_packet_path` was written.

package/.pi/extensions/lib/harness-subagents/agent-loader.ts

@@ -1,126 +0,0 @@
-/**
- * Recursive discovery: $UP_PKG/.pi/agents/** + project .pi/agents/** overrides.
- */
-
-import { createHash } from "node:crypto";
-import { type Dirent, existsSync, readdirSync, readFileSync } from "node:fs";
-import { join, relative } from "node:path";
-import { getAgentDir } from "@earendil-works/pi-coding-agent";
-import { parseAgentMarkdown } from "./agent-parser.js";
-import type { AgentConfig } from "./vendored/types.js";
-
-export type AgentSource = "package" | "project" | "global";
-
-export interface DiscoveredAgentFile {
-	id: string;
-	path: string;
-	source: AgentSource;
-	content: string;
-}
-
-/** Reject path traversal and unsafe ids. */
-export function isSafeAgentId(id: string): boolean {
-	if (!id || id.includes("..") || id.startsWith("/") || id.includes("\\")) {
-		return false;
-	}
-	return /^[a-zA-Z0-9][a-zA-Z0-9/_-]*$/.test(id);
-}
-
-function walkAgentsDir(
-	rootDir: string,
-	source: AgentSource,
-	out: Map<string, DiscoveredAgentFile>,
-): void {
-	if (!existsSync(rootDir)) return;
-
-	const stack: string[] = [rootDir];
-	while (stack.length > 0) {
-		const dir = stack.pop()!;
-		let entries: Dirent[];
-		try {
-			entries = readdirSync(dir, { withFileTypes: true });
-		} catch {
-			continue;
-		}
-
-		for (const entry of entries) {
-			const full = join(dir, entry.name);
-			if (entry.isDirectory()) {
-				stack.push(full);
-				continue;
-			}
-			if (!entry.name.endsWith(".md")) continue;
-
-			const rel = relative(rootDir, full).replace(/\\/g, "/");
-			const id = rel.replace(/\.md$/i, "");
-			if (!isSafeAgentId(id)) continue;
-
-			let content: string;
-			try {
-				content = readFileSync(full, "utf-8");
-			} catch {
-				continue;
-			}
-
-			out.set(id, { id, path: full, source, content });
-		}
-	}
-}
-
-/**
- * Discover agent files from package, global, and project (low → high priority).
- */
-export function discoverAgentFiles(
-	cwd: string,
-	packageRoot: string,
-): Map<string, DiscoveredAgentFile> {
-	const files = new Map<string, DiscoveredAgentFile>();
-
-	const packageAgents = join(packageRoot, ".pi", "agents");
-	const globalDir = join(getAgentDir(), "agents");
-	const projectDir = join(cwd, ".pi", "agents");
-
-	walkAgentsDir(packageAgents, "package", files);
-	walkAgentsDir(globalDir, "global", files);
-	walkAgentsDir(projectDir, "project", files);
-
-	return files;
-}
-
-/** Load merged AgentConfig map (project overrides package for same id). */
-export function loadHarnessAgents(
-	cwd: string,
-	packageRoot: string,
-): Map<string, AgentConfig> {
-	const agents = new Map<string, AgentConfig>();
-	for (const file of discoverAgentFiles(cwd, packageRoot).values()) {
-		agents.set(file.id, parseAgentMarkdown(file.id, file.content, file.source));
-	}
-	return agents;
-}
-
-export function sha256Content(content: string): string {
-	return createHash("sha256").update(content, "utf8").digest("hex");
-}
-
-/** Package-only manifest entries (path → hash). */
-export function loadPackageAgentHashes(
-	packageRoot: string,
-): Map<string, { path: string; sha256: string }> {
-	const packageAgents = join(packageRoot, ".pi", "agents");
-	const out = new Map<string, { path: string; sha256: string }>();
-	const files = new Map<string, DiscoveredAgentFile>();
-	walkAgentsDir(packageAgents, "package", files);
-	for (const f of files.values()) {
-		out.set(f.id, { path: f.path, sha256: sha256Content(f.content) });
-	}
-	return out;
-}
-
-/** Legacy hook used by pi-subagents custom-agents.ts replacement. */
-export function loadCustomAgents(
-	cwd: string,
-	packageRoot: string,
-): Map<string, AgentConfig> {
-	return loadHarnessAgents(cwd, packageRoot);
-}

package/.pi/extensions/lib/harness-subagents/agent-manifest.ts

@@ -1,119 +0,0 @@
-/**
- * agents.manifest.json drift detection (package agents vs installed hashes).
- */
-
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-import {
-	type DiscoveredAgentFile,
-	loadPackageAgentHashes,
-	sha256Content,
-} from "./agent-loader.js";
-
-export interface ManifestEntry {
-	path: string;
-	sha256: string;
-}
-
-export interface AgentsManifest {
-	schema_version: string;
-	package: string;
-	package_version: string;
-	generated_at: string;
-	agents: Record<string, ManifestEntry>;
-}
-
-export interface DriftItem {
-	id: string;
-	kind: "missing_in_manifest" | "hash_mismatch" | "missing_on_disk";
-	expected?: string;
-	actual?: string;
-}
-
-export interface DriftReport {
-	ok: boolean;
-	packageVersion: string;
-	items: DriftItem[];
-}
-
-function readPackageVersion(packageRoot: string): string {
-	try {
-		const pkg = JSON.parse(
-			readFileSync(join(packageRoot, "package.json"), "utf-8"),
-		) as { version?: string };
-		return pkg.version ?? "unknown";
-	} catch {
-		return "unknown";
-	}
-}
-
-export function readAgentsManifest(packageRoot: string): AgentsManifest | null {
-	const path = join(packageRoot, ".pi", "harness", "agents.manifest.json");
-	try {
-		return JSON.parse(readFileSync(path, "utf-8")) as AgentsManifest;
-	} catch {
-		return null;
-	}
-}
-
-export function getDriftReport(packageRoot: string): DriftReport {
-	const manifest = readAgentsManifest(packageRoot);
-	const onDisk = loadPackageAgentHashes(packageRoot);
-	const packageVersion = readPackageVersion(packageRoot);
-	const items: DriftItem[] = [];
-
-	if (!manifest) {
-		return {
-			ok: false,
-			packageVersion,
-			items: [{ id: "*", kind: "missing_on_disk" }],
-		};
-	}
-
-	for (const [id, entry] of onDisk) {
-		const expected = manifest.agents[id];
-		if (!expected) {
-			items.push({ id, kind: "missing_in_manifest" });
-			continue;
-		}
-		if (expected.sha256 !== entry.sha256) {
-			items.push({
-				id,
-				kind: "hash_mismatch",
-				expected: expected.sha256,
-				actual: entry.sha256,
-			});
-		}
-	}
-
-	for (const id of Object.keys(manifest.agents)) {
-		if (!onDisk.has(id)) {
-			items.push({ id, kind: "missing_on_disk" });
-		}
-	}
-
-	return { ok: items.length === 0, packageVersion, items };
-}
-
-export function buildManifestFromFiles(
-	files: Iterable<DiscoveredAgentFile>,
-	packageName: string,
-	packageVersion: string,
-): AgentsManifest {
-	const agents: Record<string, ManifestEntry> = {};
-	for (const f of files) {
-		if (f.source !== "package") continue;
-		const relPath = `.pi/agents/${f.id}.md`;
-		agents[f.id] = {
-			path: relPath,
-			sha256: sha256Content(f.content),
-		};
-	}
-	return {
-		schema_version: "1.0.0",
-		package: packageName,
-		package_version: packageVersion,
-		generated_at: new Date().toISOString(),
-		agents,
-	};
-}

package/.pi/extensions/lib/harness-subagents/agent-parser.ts

@@ -1,87 +0,0 @@
-/**
- * Parse harness agent .md files into AgentConfig (path id = posix relative path).
- */
-
-import { parseFrontmatter } from "@earendil-works/pi-coding-agent";
-import { BUILTIN_TOOL_NAMES } from "./vendored/agent-types.js";
-import type {
-	AgentConfig,
-	MemoryScope,
-	ThinkingLevel,
-} from "./vendored/types.js";
-
-function str(val: unknown): string | undefined {
-	return typeof val === "string" ? val : undefined;
-}
-
-function nonNegativeInt(val: unknown): number | undefined {
-	return typeof val === "number" && val >= 0 ? val : undefined;
-}
-
-function parseCsvField(val: unknown): string[] | undefined {
-	if (val === undefined || val === null) return undefined;
-	const s = String(val).trim();
-	if (!s || s === "none") return undefined;
-	const items = s
-		.split(",")
-		.map((t) => t.trim())
-		.filter(Boolean);
-	return items.length > 0 ? items : undefined;
-}
-
-function csvList(val: unknown, defaults: string[]): string[] {
-	if (val === undefined || val === null) return defaults;
-	return parseCsvField(val) ?? [];
-}
-
-function csvListOptional(val: unknown): string[] | undefined {
-	return parseCsvField(val);
-}
-
-function parseMemory(val: unknown): MemoryScope | undefined {
-	if (val === "user" || val === "project" || val === "local") return val;
-	return undefined;
-}
-
-function inheritField(val: unknown): true | string[] | false {
-	if (val === undefined || val === null || val === true) return true;
-	if (val === false || val === "none") return false;
-	const items = csvList(val, []);
-	return items.length > 0 ? items : false;
-}
-
-export function parseAgentMarkdown(
-	agentId: string,
-	content: string,
-	source: "package" | "project" | "global",
-): AgentConfig {
-	const { frontmatter: fm, body } =
-		parseFrontmatter<Record<string, unknown>>(content);
-
-	const yamlName = str(fm.name);
-	const displayName = str(fm.display_name) ?? yamlName;
-
-	return {
-		name: agentId,
-		displayName,
-		description: str(fm.description) ?? agentId,
-		builtinToolNames: csvList(fm.tools, BUILTIN_TOOL_NAMES),
-		disallowedTools: csvListOptional(fm.disallowed_tools),
-		extensions: inheritField(fm.extensions ?? fm.inherit_extensions),
-		skills: inheritField(fm.skills ?? fm.inherit_skills),
-		model: str(fm.model),
-		thinking: str(fm.thinking) as ThinkingLevel | undefined,
-		maxTurns: nonNegativeInt(fm.max_turns),
-		systemPrompt: body.trim(),
-		promptMode: fm.prompt_mode === "append" ? "append" : "replace",
-		inheritContext:
-			fm.inherit_context != null ? fm.inherit_context === true : undefined,
-		runInBackground:
-			fm.run_in_background != null ? fm.run_in_background === true : undefined,
-		isolated: fm.isolated != null ? fm.isolated === true : undefined,
-		memory: parseMemory(fm.memory),
-		isolation: fm.isolation === "worktree" ? "worktree" : undefined,
-		enabled: fm.enabled !== false,
-		source: source === "package" ? "global" : source,
-	};
-}

package/.pi/extensions/lib/harness-subagents/blackboard-tool.ts

@@ -1,118 +0,0 @@
-/**
- * Orchestrator blackboard tool (list/read/query/wait/delete).
- */
-
-import { defineTool, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { Type } from "@sinclair/typebox";
-import type { Blackboard } from "./blackboard.js";
-import type { BlackboardQuery } from "./types-blackboard.js";
-
-function textResult(text: string) {
-	return {
-		content: [{ type: "text" as const, text }],
-		details: {},
-	};
-}
-
-export function registerBlackboardTool(
-	pi: ExtensionAPI,
-	blackboard: Blackboard,
-): void {
-	pi.registerTool(
-		defineTool({
-			name: "blackboard",
-			label: "Blackboard",
-			description:
-				"Shared knowledge store for harness orchestration. Actions: list, read, query, wait, delete. " +
-				"Use namespaced keys (e.g. scout:findings). Spawn context injection is capped at ~8k chars.",
-			parameters: Type.Object({
-				action: Type.Union([
-					Type.Literal("list"),
-					Type.Literal("read"),
-					Type.Literal("query"),
-					Type.Literal("wait"),
-					Type.Literal("delete"),
-				]),
-				key: Type.Optional(Type.String()),
-				pattern: Type.Optional(Type.String()),
-				agent_id: Type.Optional(Type.String()),
-				agent_name: Type.Optional(Type.String()),
-				category: Type.Optional(Type.String()),
-				timeout_ms: Type.Optional(
-					Type.Number({ description: "For wait action (default 30000)." }),
-				),
-			}),
-			execute: async (_id, params) => {
-				const action = params.action as string;
-
-				if (action === "list") {
-					return textResult(blackboard.serialize());
-				}
-
-				if (action === "read") {
-					const key = params.key as string | undefined;
-					if (!key) return textResult("read requires key.");
-					const entry = blackboard.get(key);
-					if (!entry) {
-						return textResult(`No entry for key "${key}".`);
-					}
-					return textResult(JSON.stringify(entry, null, 2));
-				}
-
-				if (action === "query") {
-					const q: BlackboardQuery = {};
-					if (params.pattern) q.pattern = params.pattern as string;
-					if (params.agent_id) q.agentId = params.agent_id as string;
-					if (params.agent_name) q.agentName = params.agent_name as string;
-					if (params.category) q.category = params.category as string;
-					if (params.key) q.keys = [params.key as string];
-					return textResult(JSON.stringify(blackboard.toJSON(q), null, 2));
-				}
-
-				if (action === "delete") {
-					const key = params.key as string | undefined;
-					if (!key) return textResult("delete requires key.");
-					const removed = blackboard.delete(key);
-					return textResult(
-						removed ? `Deleted "${key}".` : `Key "${key}" not found.`,
-					);
-				}
-
-				if (action === "wait") {
-					const pattern = (params.pattern ?? params.key) as string | undefined;
-					if (!pattern) {
-						return textResult("wait requires pattern or key.");
-					}
-					const timeoutMs = (params.timeout_ms as number) ?? 30_000;
-					const start = Date.now();
-					while (Date.now() - start < timeoutMs) {
-						const matches = blackboard.query({ pattern });
-						if (matches.length > 0) {
-							return textResult(
-								JSON.stringify(blackboard.toJSON({ pattern }), null, 2),
-							);
-						}
-						await new Promise((r) => setTimeout(r, 200));
-					}
-					return textResult(`Timeout waiting for pattern "${pattern}".`);
-				}
-
-				return textResult("Unknown action.");
-			},
-		}),
-	);
-}
-
-export function buildBlackboardContextInjection(
-	blackboard: Blackboard,
-	spec?: { agentId?: string; keys?: string[]; agentName?: string },
-): string | undefined {
-	if (!spec) return undefined;
-	const q: BlackboardQuery = {};
-	if (spec.agentId) q.agentId = spec.agentId;
-	if (spec.agentName) q.agentName = spec.agentName;
-	if (spec.keys?.length) q.keys = spec.keys;
-	const serialized = blackboard.serialize(q);
-	if (serialized === "(blackboard is empty)") return undefined;
-	return serialized;
-}