ultimate-pi 0.7.0 → 0.9.0

package/.pi/harness/specs/harness-spawn-context.schema.json

@@ -0,0 +1,65 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/harness-spawn-context.schema.json",
+	"title": "HarnessSpawnContext",
+	"description": "Structured context passed from harness slash-command orchestrators to harness/* subagents.",
+	"type": "object",
+	"additionalProperties": false,
+	"required": ["schema_version", "agent", "mode"],
+	"properties": {
+		"schema_version": {
+			"type": "string",
+			"const": "1.0.0"
+		},
+		"agent": {
+			"type": "string",
+			"minLength": 1,
+			"description": "Target subagent id, e.g. harness/planner"
+		},
+		"mode": {
+			"type": "string",
+			"enum": [
+				"create",
+				"revise",
+				"execute",
+				"benchmark",
+				"verdict",
+				"adversary",
+				"trace",
+				"incident",
+				"tune"
+			]
+		},
+		"run_id": {
+			"type": "string"
+		},
+		"plan_packet_path": {
+			"type": "string"
+		},
+		"run_dir": {
+			"type": "string"
+		},
+		"task_summary": {
+			"type": "string"
+		},
+		"risk_level": {
+			"type": "string",
+			"enum": ["low", "med", "high"]
+		},
+		"quick": {
+			"type": "boolean"
+		},
+		"acceptance_checks": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"artifact_paths": {
+			"type": "object",
+			"additionalProperties": { "type": "string" }
+		},
+		"handoff_summary": {
+			"type": "string",
+			"description": "Prior phase bullet summary for chained spawns (harness-auto)"
+		}
+	}
+}

package/.pi/harness/specs/harness-turn.schema.json

@@ -0,0 +1,18 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"title": "HarnessTurn",
+	"description": "Recorded on Pi input event when user invokes a /harness-* prompt template (raw slash, before expansion).",
+	"type": "object",
+	"required": ["schema_version", "command", "args", "source", "invoked_at"],
+	"additionalProperties": false,
+	"properties": {
+		"schema_version": { "const": "1.0.0" },
+		"command": {
+			"type": "string",
+			"pattern": "^harness-[a-z0-9-]+$"
+		},
+		"args": { "type": "string" },
+		"source": { "const": "slash" },
+		"invoked_at": { "type": "string", "format": "date-time" }
+	}
+}

package/.pi/lib/harness-agent-output.ts

@@ -0,0 +1,41 @@
+/**
+ * Parse structured JSON blocks from harness subagent assistant output.
+ */
+
+const JSON_FENCE_RE = /```(?:json)?\s*([\s\S]*?)```/i;
+
+export function extractJsonBlock(text: string): string | null {
+	const trimmed = text.trim();
+	if (trimmed.startsWith("{")) {
+		return trimmed;
+	}
+	const match = JSON_FENCE_RE.exec(text);
+	if (match?.[1]) {
+		return match[1].trim();
+	}
+	const lastBrace = trimmed.lastIndexOf("{");
+	const lastClose = trimmed.lastIndexOf("}");
+	if (lastBrace >= 0 && lastClose > lastBrace) {
+		return trimmed.slice(lastBrace, lastClose + 1);
+	}
+	return null;
+}
+
+export function parseHarnessAgentJson<T extends Record<string, unknown>>(
+	text: string,
+): { ok: true; value: T } | { ok: false; error: string } {
+	const block = extractJsonBlock(text);
+	if (!block) {
+		return { ok: false, error: "no JSON block found in subagent output" };
+	}
+	try {
+		const value = JSON.parse(block) as T;
+		if (!value || typeof value !== "object") {
+			return { ok: false, error: "parsed value is not an object" };
+		}
+		return { ok: true, value };
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		return { ok: false, error: message };
+	}
+}