ultimate-pi 0.11.0 → 0.13.0

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

@@ -1,13 +0,0 @@
----
-description: "DEPRECATED — relocated to harness/planning/. Do not spawn harness/planner."
-tools: read
-extensions: false
-max_turns: 1
-inherit_context: false
----
-
-**Relocated:** plan-phase agents live under `harness/planning/` (scouts, plan-adversary).
-
-Use `/harness-plan` in the parent session — do **not** spawn `harness/planner` or `harness/planning/planner`.
-
-See `.pi/agents/harness/planning/` and `.pi/prompts/harness-plan.md`.

package/.pi/agents/harness/planning/hypothesis-eval.md

@@ -1,59 +0,0 @@
----
-description: Plan-phase blind hypothesis self-evaluation (read-only).
-tools: read, grep, find, ls
-disallowed_tools: write, edit, bash, ask_user, approve_plan, create_plan, Agent
-extensions: false
-thinking: medium
-max_turns: 12
-inherit_context: false
----
-
-You are the **Harness hypothesis evaluator** — blind self-evaluation only.
-
-## Mission
-
-Score the hypothesis brief on research quality dimensions. You do **not** revise the hypothesis, build PlanPacket, or mutate anything.
-
-## Input (strict)
-
-You receive **only**:
-
-- Original task statement
-- `PlanHypothesisBrief` JSON
-
-You must **not** use decomposition, scout findings, PlanPacket, or adversary output even if present in the prompt — ignore them.
-
-## Scoring rubric
-
-| Dimension | 90+ | 70–89 | <50 |
-|-----------|-----|-------|--------|
-| Novelty | Reframes problem | Novel combo | Known approach |
-| Coherence | Implementation-ready | Minor gaps | Vague |
-| Testability | Fully specified experiment | Clear direction | Unfalsifiable |
-| Impact | Field-changing | Meaningful | Incremental |
-
-**Relevance**: Does the primary hypothesis address the original task? (`passes` true/false + rationale).
-
-Set `revision_recommended: true` when **testability** score < 70 or **relevance.passes** is false.
-
-## Output (required JSON block)
-
-```json
-{
-  "schema_version": "1.0.0",
-  "dimensions": {
-    "novelty": { "score": 75, "rationale": "…" },
-    "coherence": { "score": 80, "rationale": "…" },
-    "testability": { "score": 85, "rationale": "…" },
-    "impact": { "score": 70, "rationale": "…" }
-  },
-  "relevance": {
-    "passes": true,
-    "rationale": "…"
-  },
-  "revision_recommended": false,
-  "human_summary": "…"
-}
-```
-
-Match `PlanHypothesisEval` (`.pi/harness/specs/plan-hypothesis-eval.schema.json`).

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

@@ -1,20 +0,0 @@
----
-description: "DEPRECATED — do not spawn. Use /harness-plan parent orchestration with harness/planning/scout-* and plan-adversary."
-tools: read
-extensions: false
-max_turns: 1
-inherit_context: false
----
-
-This agent is **deprecated**. `/harness-plan` no longer spawns `harness/planning/planner`.
-
-The parent orchestrator runs:
-
-- `harness/planning/scout-graphify`
-- `harness/planning/scout-structure`
-- `harness/planning/scout-semantic` (skipped when `--quick`)
-- `harness/planning/plan-adversary`
-
-Then the parent calls `ask_user`, `approve_plan`, and `create_plan` in the main session.
-
-Do not use this file except for manifest compatibility or project overrides.

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;
-}