ultimate-pi 0.16.0 → 0.18.0

package/.pi/harness/evals/smoke/fixtures/plan-phase/minimal-med-fast/research-brief.yaml

@@ -0,0 +1,62 @@
+decomposition:
+  schema_version: "1.0.0"
+  problem_restatement: Light-profile smoke for two-focus debate
+hypothesis:
+  schema_version: "1.0.0"
+  primary:
+    claim: Light debate covers spec and quality only
+    mechanism: Eligibility profile light with min_focus_rounds 2
+    prediction: planDebateOutcomeComplete passes with two rounds
+    experiment: Run smoke-harness-plan.mjs --fixture minimal-low-light
+implementation:
+  schema_version: "1.0.0"
+  problem_framing: Low-risk fixture for selective debate
+  sub_problems: [spec coverage, quality coverage]
+  internal_references:
+    - path: test/plan-debate-eligibility.test.mjs
+      relevance: Eligibility unit tests
+      reuse_signal: high
+  external_references: []
+  solution_patterns:
+    - name: light profile gate
+      provenance: ADR-0036
+      fit: Reduces debate cost on trivial tasks
+      tradeoffs:
+        pros: [Fewer rounds]
+        cons: []
+      risks: []
+  similar_implementations:
+    - name: minimal-med four-focus fixture
+      what_it_solves: Full debate coverage
+      gap_vs_us: Light uses two focuses only
+  recommended_approach:
+    summary: Two review rounds with spec then quality
+    recommended_approach_confidence: high
+    confidence_rationale: Deterministic fixture aligned with eligibility rules
+    evidence_refs:
+      - .pi/extensions/lib/plan-debate-eligibility.ts
+      - test/plan-debate-eligibility.test.mjs
+  anti_patterns: []
+  open_questions: []
+stack:
+  schema_version: "1.0.0"
+  problem_framing: Node harness tooling
+  constraints: []
+  options:
+    - name: extend current stack
+      category: brownfield
+      fit_summary: Use existing ultimate-pi harness
+      tradeoffs:
+        pros: [No new deps]
+        cons: []
+      risks: []
+      evidence_refs: []
+      recommendation_rank: 1
+  recommended_primary: extend current stack
+  rationale: Fixture validates in-repo harness
+eval:
+  schema_version: "1.0.0"
+  revision_recommended: false
+  relevance:
+    passes: true
+    rationale: Hypothesis matches light smoke task

package/.pi/harness/evals/smoke/sentrux-stub.json

@@ -2,5 +2,5 @@
 	"schema_version": "1.0.0",
 	"signal_type": "stub",
 	"score": 0.5,
-	"note": "Placeholder until Sentrux MCP is wired. Satisfies HARNESS_SENTRUX_REQUIRED gate in harness:verify."
+	"note": "Fallback when HARNESS_RUN_DIR/artifacts/sentrux-signal.yaml is absent. Prefer run signal from /harness-run (ADR 0006)."
 }

package/.pi/harness/evals/smoke/smoke-harness-plan.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * smoke-harness-plan — fixture validation for plan-phase pipeline (CI).
- * Usage: node .pi/harness/evals/smoke/smoke-harness-plan.mjs --fixture [minimal-med|minimal-low-light]
+ * Usage: node .pi/harness/evals/smoke/smoke-harness-plan.mjs --fixture [minimal-med|minimal-low-light|minimal-med-fast]
  */
 
 import { access, readFile } from "node:fs/promises";
@@ -26,16 +26,26 @@ async function scanFocusCoverage(fixtureRoot, requiredFocus) {
 	let last_round_index = 0;
 	const { readdir } = await import("node:fs/promises");
 	const files = (await readdir(art)).filter((f) =>
-		/^review-round-r\d+\.yaml$/i.test(f),
+		/^review-round(?:-r\d+|-consolidated|-parallel-probes)\.yaml$/i.test(f),
 	);
 	for (const name of files.sort()) {
-		const m = /^review-round-r(\d+)\.yaml$/i.exec(name);
+		const consolidated = /^review-round-consolidated\.yaml$/i.test(name);
+		const parallelProbes = /^review-round-parallel-probes\.yaml$/i.test(name);
+		const m = consolidated
+			? ["review-round-consolidated.yaml", "1"]
+			: parallelProbes
+				? ["review-round-parallel-probes.yaml", "1"]
+				: /^review-round-r(\d+)\.yaml$/i.exec(name);
 		if (!m) continue;
-		const roundIndex = Number(m[1]);
+		const roundIndex = consolidated ? 1 : Number(m[1]);
 		if (roundIndex > last_round_index) last_round_index = roundIndex;
 		const draft = parseYaml(await readFile(join(art, name), "utf-8"));
 		const focus = String(draft.debate_round_focus ?? "").trim();
-		if (requiredFocus.includes(focus)) covered.add(focus);
+		if (focus === "all") {
+			for (const f of requiredFocus) covered.add(f);
+		} else if (requiredFocus.includes(focus)) {
+			covered.add(focus);
+		}
 		if (roundIndex === last_round_index) {
 			last_review_gate_ready = draft.review_gate_ready === true;
 		}
@@ -110,22 +120,33 @@ async function runFixture(name) {
 	ok("research-brief.yaml structure");
 
 	const isLight = name === "minimal-low-light";
-	const requiredFocus = isLight ? ["spec", "quality"] : ["spec", "wbs", "schedule", "quality"];
-	const debateRounds = isLight
-		? ["review-round-r1.yaml", "review-round-r2.yaml"]
-		: [
-				"review-round-r1.yaml",
-				"review-round-r2.yaml",
-				"review-round-r3.yaml",
-				"review-round-r4.yaml",
-			];
+	const isFast = name === "minimal-med-fast";
+	const requiredFocus =
+		isLight || isFast
+			? ["spec", "quality"]
+			: ["spec", "wbs", "schedule", "quality"];
+	const debateRounds = isFast
+		? ["review-round-consolidated.yaml"]
+		: isLight
+			? ["review-round-r1.yaml", "review-round-r2.yaml"]
+			: [
+					"review-round-r1.yaml",
+					"review-round-r2.yaml",
+					"review-round-r3.yaml",
+					"review-round-r4.yaml",
+				];
 	const seenFocus = new Set();
 	for (const fileName of debateRounds) {
 		const p = join(fixtureRoot, "artifacts", fileName);
 		await access(p, constants.R_OK);
 		const draft = parseYaml(await readFile(p, "utf-8"));
 		if (!draft.schema_version) fail(`${fileName} missing schema_version`);
-		if (draft.debate_round_focus) seenFocus.add(draft.debate_round_focus);
+		const f = String(draft.debate_round_focus ?? "").trim();
+		if (f === "all") {
+			for (const req of requiredFocus) seenFocus.add(req);
+		} else if (f) {
+			seenFocus.add(f);
+		}
 	}
 	for (const focus of requiredFocus) {
 		if (!seenFocus.has(focus)) {
@@ -135,7 +156,7 @@ async function runFixture(name) {
 	ok(`debate round YAML artifacts (${requiredFocus.length} focuses)`);
 
 	const coverage = await scanFocusCoverage(fixtureRoot, requiredFocus);
-	const minRounds = isLight ? 2 : 4;
+	const minRounds = isFast ? 1 : isLight ? 2 : 4;
 	if (!planOutcomeComplete(coverage, requiredFocus, minRounds)) {
 		fail("debate outcome incomplete for fixture coverage");
 	}
@@ -144,6 +165,9 @@ async function runFixture(name) {
 	if (isLight && packet.risk_level !== "low") {
 		fail("minimal-low-light fixture must use risk_level low");
 	}
+	if (isFast && packet.risk_level !== "med") {
+		fail("minimal-med-fast fixture must use risk_level med");
+	}
 
 	console.log(`smoke-harness-plan: all ${name} fixture checks passed`);
 }
@@ -161,7 +185,9 @@ async function main() {
 		);
 		return;
 	}
-	fail("Usage: smoke-harness-plan.mjs --fixture [minimal-med|minimal-low-light] | --live");
+	fail(
+		"Usage: smoke-harness-plan.mjs --fixture [minimal-med|minimal-low-light|minimal-med-fast] | --live",
+	);
 }
 
 main().catch((err) => {

package/.pi/harness/specs/README.md

@@ -13,7 +13,7 @@ This directory is the canonical contract surface for Phase 1 harness artifacts.
 
 These schemas define the minimum machine-readable contracts for:
 
-- planning (`PlanPacket`, `PlanDecompositionBrief`, `PlanHypothesisBrief`, `PlanHypothesisEval`, `PlanAdversaryBrief`)
+- planning (`PlanPacket`, `PlanPlanningContext`, `PlanDecompositionBrief`, `PlanHypothesisBrief`, `PlanHypothesisEval`, `PlanAdversaryBrief`, legacy `PlanScoutFindings`)
 - execution telemetry (`RunTrace`, `HarnessRunRecord`)
 - PostHog harness events (`HarnessPostHogEvent`)
 - observation bus (`HarnessObservation`)

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

@@ -75,6 +75,17 @@
 		},
 		"turn_override_run_id": {
 			"type": ["string", "null"]
+		},
+		"steer_approved": {
+			"type": "boolean"
+		},
+		"steer_attempt": {
+			"type": "integer",
+			"minimum": 0
+		},
+		"steer_max_attempts": {
+			"type": "integer",
+			"minimum": 1
 		}
 	}
 }

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

@@ -23,6 +23,7 @@
 				"revise",
 				"plan_review",
 				"execute",
+				"repair",
 				"benchmark",
 				"verdict",
 				"adversary",
@@ -61,6 +62,19 @@
 		"handoff_summary": {
 			"type": "string",
 			"description": "Prior phase bullet summary for chained spawns (harness-auto)"
+		},
+		"critical_path_work_item_ids": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 },
+			"description": "Limiting-step work item ids from execution_plan.schedule_metadata (execute phase)"
+		},
+		"repair_brief_path": {
+			"type": "string",
+			"description": "Path to repair-brief.yaml (steer / repair mode)"
+		},
+		"executor_strategy": {
+			"type": "string",
+			"enum": ["single_pass", "per_lake", "per_work_item"]
 		}
 	}
 }

package/.pi/harness/specs/plan-execution-plan.schema.json

@@ -36,9 +36,41 @@
 			"items": { "$ref": "#/$defs/risk" }
 		},
 		"schedule_metadata": { "$ref": "#/$defs/schedule_metadata" },
-		"dag_validation": { "$ref": "#/$defs/dag_validation" }
+		"dag_validation": { "$ref": "#/$defs/dag_validation" },
+		"lakes": {
+			"type": "array",
+			"items": { "$ref": "#/$defs/lake" }
+		},
+		"executor_strategy": {
+			"type": "string",
+			"enum": ["single_pass", "per_lake", "per_work_item"]
+		},
+		"critical_path_lake_ids": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 }
+		}
 	},
 	"$defs": {
+		"lake": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["lake_id", "title", "outcome", "done_criteria"],
+			"properties": {
+				"lake_id": { "type": "string", "minLength": 1 },
+				"title": { "type": "string", "minLength": 1 },
+				"outcome": { "type": "string", "minLength": 1 },
+				"done_criteria": { "type": "string", "minLength": 1 },
+				"context_bundle_path": { "type": "string", "minLength": 1 },
+				"files": {
+					"type": "array",
+					"items": { "type": "string", "minLength": 1 }
+				},
+				"out_of_scope": {
+					"type": "array",
+					"items": { "type": "string", "minLength": 1 }
+				}
+			}
+		},
 		"phase": {
 			"type": "object",
 			"additionalProperties": false,
@@ -107,6 +139,12 @@
 					"type": "array",
 					"minItems": 1,
 					"items": { "type": "string", "minLength": 1 }
+				},
+				"lake_id": { "type": "string", "minLength": 1 },
+				"context_bundle_path": { "type": "string", "minLength": 1 },
+				"context_refs": {
+					"type": "array",
+					"items": { "type": "string", "minLength": 1 }
 				}
 			}
 		},

package/.pi/harness/specs/plan-packet.schema.json

@@ -94,6 +94,10 @@
 		},
 		"execution_plan": {
 			"$ref": "plan-execution-plan.schema.json"
+		},
+		"executor_strategy": {
+			"type": "string",
+			"enum": ["single_pass", "per_lake", "per_work_item"]
 		}
 	}
 }

package/.pi/harness/specs/plan-phase-status.schema.json

@@ -0,0 +1,17 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/plan-phase-status.schema.json",
+	"title": "PlanPhaseStatus",
+	"description": "Orchestrator-recorded plan phase outcome before baseline approval.",
+	"type": "object",
+	"additionalProperties": false,
+	"required": ["schema_version", "plan_status"],
+	"properties": {
+		"schema_version": { "type": "string", "const": "1.0.0" },
+		"plan_status": {
+			"type": "string",
+			"enum": ["ready", "partial", "needs_clarification"]
+		},
+		"notes": { "type": "string" }
+	}
+}

package/.pi/harness/specs/plan-phase-waiver.schema.json

@@ -0,0 +1,25 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/plan-phase-waiver.schema.json",
+	"title": "PlanPhaseWaiver",
+	"description": "Explicit human waiver for partial scouts or plan-phase blockers before approve_plan.",
+	"type": "object",
+	"additionalProperties": false,
+	"required": ["schema_version", "waived"],
+	"properties": {
+		"schema_version": { "type": "string", "const": "1.0.0" },
+		"waived": {
+			"type": "array",
+			"minItems": 1,
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["reason", "rationale"],
+				"properties": {
+					"reason": { "type": "string", "minLength": 1 },
+					"rationale": { "type": "string", "minLength": 1 }
+				}
+			}
+		}
+	}
+}

package/.pi/harness/specs/plan-planning-context.schema.json

@@ -0,0 +1,50 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/plan-planning-context.schema.json",
+	"title": "PlanPlanningContext",
+	"type": "object",
+	"additionalProperties": true,
+	"required": ["schema_version", "status", "summary", "coverage"],
+	"properties": {
+		"schema_version": { "type": "string", "const": "1.0.0" },
+		"status": {
+			"type": "string",
+			"enum": ["ok", "partial", "failed", "error"]
+		},
+		"task_ref": { "type": "string" },
+		"summary": { "type": "string", "minLength": 1 },
+		"coverage": {
+			"type": "object",
+			"required": ["architecture", "structure"],
+			"properties": {
+				"architecture": { "$ref": "#/$defs/coverageLane" },
+				"structure": { "$ref": "#/$defs/coverageLane" },
+				"semantic": { "$ref": "#/$defs/coverageLane" }
+			},
+			"additionalProperties": true
+		},
+		"findings": { "type": "array" },
+		"key_paths": { "type": "array", "items": { "type": "string" } },
+		"evidence_refs": { "type": "array" },
+		"open_questions": { "type": "array" }
+	},
+	"$defs": {
+		"coverageLane": {
+			"type": "object",
+			"required": ["status"],
+			"properties": {
+				"status": {
+					"type": "string",
+					"enum": ["ok", "partial", "skipped", "failed", "error"]
+				},
+				"tools_used": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"summary": { "type": "string" },
+				"key_paths": { "type": "array", "items": { "type": "string" } }
+			},
+			"additionalProperties": true
+		}
+	}
+}

package/.pi/harness/specs/plan-review-round-draft.schema.json

@@ -16,7 +16,7 @@
 		"round_index": { "type": "integer", "minimum": 1, "maximum": 12 },
 		"debate_round_focus": {
 			"type": "string",
-			"enum": ["spec", "wbs", "schedule", "quality"]
+			"enum": ["spec", "wbs", "schedule", "quality", "all"]
 		},
 		"round_summary": { "type": "string", "minLength": 1 },
 		"validation_summary": { "type": "string" },

package/.pi/harness/specs/repair-brief.schema.json

@@ -0,0 +1,45 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/repair-brief.schema.json",
+	"title": "RepairBrief",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"schema_version",
+		"run_id",
+		"steer_attempt",
+		"remediation_class",
+		"source_artifacts",
+		"fix_directives"
+	],
+	"properties": {
+		"schema_version": { "type": "string", "const": "1.0.0" },
+		"run_id": { "type": "string", "minLength": 1 },
+		"steer_attempt": { "type": "integer", "minimum": 1 },
+		"remediation_class": {
+			"type": "string",
+			"enum": ["implementation_gap", "plan_gap", "rollback", "inconclusive"]
+		},
+		"source_artifacts": {
+			"type": "object",
+			"additionalProperties": { "type": "string" }
+		},
+		"failed_acceptance_check_ids": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 }
+		},
+		"priority_lake_ids": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 }
+		},
+		"fix_directives": {
+			"type": "array",
+			"minItems": 1,
+			"items": { "type": "string", "minLength": 1 }
+		},
+		"constraints": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 }
+		}
+	}
+}

package/.pi/harness/specs/review-outcome.schema.json

@@ -0,0 +1,46 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/review-outcome.schema.json",
+	"title": "ReviewOutcome",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"schema_version",
+		"run_id",
+		"status",
+		"remediation_class",
+		"recommended_next"
+	],
+	"properties": {
+		"schema_version": { "type": "string", "const": "1.0.0" },
+		"run_id": { "type": "string", "minLength": 1 },
+		"status": {
+			"type": "string",
+			"enum": ["pass", "fail", "inconclusive"]
+		},
+		"remediation_class": {
+			"type": "string",
+			"enum": [
+				"pass",
+				"implementation_gap",
+				"plan_gap",
+				"rollback",
+				"inconclusive"
+			]
+		},
+		"recommended_next": { "type": "string", "minLength": 1 },
+		"failed_acceptance_check_ids": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 }
+		},
+		"steer_attempt": { "type": "integer", "minimum": 0 },
+		"review_tier": {
+			"type": "string",
+			"enum": ["full", "lite"]
+		},
+		"source_artifacts": {
+			"type": "object",
+			"additionalProperties": { "type": "string" }
+		}
+	}
+}

package/.pi/harness/specs/sentrux-manifest-proposal.schema.json

@@ -0,0 +1,80 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/sentrux-manifest-proposal.schema.json",
+	"title": "SentruxManifestProposal",
+	"description": "Graphify-grounded proposal to evolve architecture.manifest.json (intent layer). Chair applies after approval.",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"schema_version",
+		"change_class",
+		"summary",
+		"evidence",
+		"manifest_patch",
+		"adr_required",
+		"human_required"
+	],
+	"properties": {
+		"schema_version": {
+			"type": "string",
+			"const": "1.0.0"
+		},
+		"change_class": {
+			"type": "string",
+			"enum": [
+				"none",
+				"tune_constraint",
+				"add_boundary",
+				"add_layer",
+				"split_layer"
+			]
+		},
+		"summary": {
+			"type": "string",
+			"minLength": 1
+		},
+		"evidence": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["source", "ref", "summary"],
+				"properties": {
+					"source": {
+						"type": "string",
+						"enum": ["graphify", "sg", "sentrux", "plan", "manifest"]
+					},
+					"ref": {
+						"type": "string",
+						"minLength": 1
+					},
+					"summary": {
+						"type": "string",
+						"minLength": 1
+					}
+				}
+			}
+		},
+		"manifest_patch": {
+			"type": "object",
+			"description": "JSON Merge Patch (RFC 7396) ops against architecture.manifest.json",
+			"additionalProperties": true
+		},
+		"adr_required": {
+			"type": "boolean"
+		},
+		"adr_draft": {
+			"type": "string"
+		},
+		"human_required": {
+			"type": "boolean"
+		},
+		"open_questions": {
+			"type": "array",
+			"items": {
+				"type": "string",
+				"minLength": 1
+			}
+		}
+	}
+}

package/.pi/harness/specs/sentrux-signal.schema.json

@@ -0,0 +1,43 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/sentrux-signal.schema.json",
+	"title": "SentruxSignal",
+	"description": "Per-run Sentrux CLI observation for evaluator and harness-verify promotion.",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"schema_version",
+		"run_id",
+		"check_pass",
+		"gate_status",
+		"recorded_at"
+	],
+	"properties": {
+		"schema_version": {
+			"type": "string",
+			"const": "1.0.0"
+		},
+		"run_id": {
+			"type": "string",
+			"minLength": 1
+		},
+		"check_pass": {
+			"type": "boolean"
+		},
+		"gate_status": {
+			"type": "string",
+			"enum": ["pass", "degraded", "skipped", "not_installed"]
+		},
+		"quality_signal_summary": {
+			"type": "string"
+		},
+		"recorded_at": {
+			"type": "string",
+			"format": "date-time"
+		},
+		"phase": {
+			"type": "string",
+			"enum": ["execute", "evaluate", "review"]
+		}
+	}
+}

package/.pi/harness/specs/steer-state.schema.json

@@ -0,0 +1,20 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/steer-state.schema.json",
+	"title": "SteerState",
+	"type": "object",
+	"additionalProperties": false,
+	"required": ["schema_version", "run_id", "attempt", "max_attempts", "active"],
+	"properties": {
+		"schema_version": { "type": "string", "const": "1.0.0" },
+		"run_id": { "type": "string", "minLength": 1 },
+		"attempt": { "type": "integer", "minimum": 0 },
+		"max_attempts": { "type": "integer", "minimum": 1 },
+		"active": { "type": "boolean" },
+		"steer_approved": { "type": "boolean" },
+		"last_review_tier": {
+			"type": "string",
+			"enum": ["full", "lite"]
+		}
+	}
+}