ultimate-pi 0.19.1 → 0.22.0

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

@@ -0,0 +1,173 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/sentrux-diagnostics.schema.json",
+	"title": "SentruxDiagnostics",
+	"description": "Pro-shaped repair-oriented diagnostics synthesized from OSS Sentrux report (no MCP/Pro).",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"schema_version",
+		"synthesized_at",
+		"project_root",
+		"quality_signal",
+		"bottleneck",
+		"bottleneck_inferred",
+		"root_causes",
+		"diagnostics"
+	],
+	"properties": {
+		"schema_version": {
+			"type": "string",
+			"const": "1.0.0"
+		},
+		"synthesized_at": {
+			"type": "string",
+			"format": "date-time"
+		},
+		"project_root": {
+			"type": "string",
+			"minLength": 1
+		},
+		"report_sha256": {
+			"type": "string"
+		},
+		"quality_signal": {
+			"type": ["integer", "null"]
+		},
+		"gate_status": {
+			"type": "string",
+			"enum": ["pass", "degraded", "unknown"]
+		},
+		"bottleneck": {
+			"type": "string",
+			"enum": [
+				"modularity",
+				"equality",
+				"acyclicity",
+				"stability",
+				"abstraction"
+			]
+		},
+		"bottleneck_inferred": {
+			"type": "boolean"
+		},
+		"root_causes": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 },
+			"minItems": 1
+		},
+		"diagnostics": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": [
+				"god_files",
+				"hotspots",
+				"complex_functions",
+				"cycles",
+				"violations_summary"
+			],
+			"properties": {
+				"god_files": {
+					"type": "array",
+					"items": { "$ref": "#/$defs/god_file" }
+				},
+				"hotspots": {
+					"type": "array",
+					"items": { "$ref": "#/$defs/hotspot" }
+				},
+				"complex_functions": {
+					"type": "array",
+					"items": { "$ref": "#/$defs/complex_function" }
+				},
+				"cycles": {
+					"type": "array",
+					"items": { "$ref": "#/$defs/cycle" }
+				},
+				"violations_summary": {
+					"type": "array",
+					"items": { "$ref": "#/$defs/violation_summary" }
+				},
+				"gate_degraded_reasons": {
+					"type": "array",
+					"items": { "type": "string" }
+				}
+			}
+		},
+		"graphify_refs": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["path", "summary"],
+				"properties": {
+					"path": { "type": "string" },
+					"summary": { "type": "string" }
+				}
+			}
+		}
+	},
+	"$defs": {
+		"god_file": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["path"],
+			"properties": {
+				"path": { "type": "string" },
+				"fan_out": { "type": ["integer", "null"] },
+				"reason": { "type": "string" }
+			}
+		},
+		"hotspot": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["path", "score"],
+			"properties": {
+				"path": { "type": "string" },
+				"score": { "type": "number" },
+				"churn_14d": { "type": ["integer", "null"] },
+				"reason": { "type": "string" }
+			}
+		},
+		"complex_function": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["file", "func", "cc"],
+			"properties": {
+				"file": { "type": "string" },
+				"func": { "type": "string" },
+				"cc": { "type": "integer" },
+				"priority": {
+					"type": "string",
+					"enum": ["critical", "high", "medium", "low"]
+				}
+			}
+		},
+		"cycle": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["members"],
+			"properties": {
+				"members": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"reason": { "type": "string" }
+			}
+		},
+		"violation_summary": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["rule", "count", "severity"],
+			"properties": {
+				"rule": { "type": "string" },
+				"count": { "type": "integer", "minimum": 0 },
+				"severity": { "type": "string" },
+				"sample_files": {
+					"type": "array",
+					"items": { "type": "string" },
+					"maxItems": 5
+				}
+			}
+		}
+	}
+}

package/.pi/harness/specs/sentrux-repair-plan.schema.json

@@ -0,0 +1,133 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/sentrux-repair-plan.schema.json",
+	"title": "SentruxRepairPlan",
+	"description": "Actionable repair plan from sentrux-repair-advisor (steer/executor input).",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"schema_version",
+		"status",
+		"summary",
+		"bottleneck",
+		"root_causes",
+		"actions",
+		"human_required"
+	],
+	"properties": {
+		"schema_version": {
+			"type": "string",
+			"const": "1.0.0"
+		},
+		"status": {
+			"type": "string",
+			"enum": ["ok", "partial", "blocked"]
+		},
+		"summary": {
+			"type": "string",
+			"minLength": 1
+		},
+		"bottleneck": {
+			"type": "string",
+			"enum": [
+				"modularity",
+				"equality",
+				"acyclicity",
+				"stability",
+				"abstraction"
+			]
+		},
+		"root_causes": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 },
+			"minItems": 1
+		},
+		"actions": {
+			"type": "array",
+			"minItems": 1,
+			"items": { "$ref": "#/$defs/action" }
+		},
+		"do_not_touch": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"verification": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"human_required": {
+			"type": "boolean"
+		},
+		"open_questions": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"evidence": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["source", "ref", "summary"],
+				"properties": {
+					"source": {
+						"type": "string",
+						"enum": [
+							"sentrux-report",
+							"sentrux-diagnostics",
+							"graphify",
+							"plan",
+							"diff"
+						]
+					},
+					"ref": { "type": "string", "minLength": 1 },
+					"summary": { "type": "string", "minLength": 1 }
+				}
+			}
+		}
+	},
+	"$defs": {
+		"action": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["id", "priority", "kind", "target", "instruction"],
+			"properties": {
+				"id": {
+					"type": "string",
+					"pattern": "^[a-z][a-z0-9-]*$"
+				},
+				"priority": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 10
+				},
+				"kind": {
+					"type": "string",
+					"enum": [
+						"refactor",
+						"extract",
+						"move",
+						"split",
+						"tune",
+						"document",
+						"defer"
+					]
+				},
+				"target": {
+					"type": "string",
+					"minLength": 1
+				},
+				"instruction": {
+					"type": "string",
+					"minLength": 1
+				},
+				"acceptance": {
+					"type": "string"
+				},
+				"rule_ids": {
+					"type": "array",
+					"items": { "type": "string" }
+				}
+			}
+		}
+	}
+}

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

@@ -0,0 +1,119 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/sentrux-report.schema.json",
+	"title": "SentruxReport",
+	"description": "Single-scan Sentrux check + gate capture for a harness run (OSS CLI parse).",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"schema_version",
+		"captured_at",
+		"project_root",
+		"parser_version",
+		"check",
+		"gate"
+	],
+	"properties": {
+		"schema_version": {
+			"type": "string",
+			"const": "1.0.0"
+		},
+		"captured_at": {
+			"type": "string",
+			"format": "date-time"
+		},
+		"project_root": {
+			"type": "string",
+			"minLength": 1
+		},
+		"parser_version": {
+			"type": "string",
+			"minLength": 1
+		},
+		"sentrux_cli_version": {
+			"type": ["string", "null"]
+		},
+		"upstream_json_available": {
+			"type": "boolean"
+		},
+		"check": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["parse_ok", "check_pass", "violations"],
+			"properties": {
+				"parse_ok": { "type": "boolean" },
+				"parse_errors": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"rules_checked": { "type": ["integer", "null"] },
+				"quality_signal": { "type": ["integer", "null"] },
+				"check_pass": { "type": "boolean" },
+				"violations": {
+					"type": "array",
+					"items": { "$ref": "#/$defs/violation" }
+				},
+				"stdout_sha256": { "type": "string" }
+			}
+		},
+		"gate": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["parse_ok", "status", "degraded_reasons"],
+			"properties": {
+				"parse_ok": { "type": "boolean" },
+				"parse_errors": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"status": {
+					"type": "string",
+					"enum": ["pass", "degraded", "unknown"]
+				},
+				"quality_before": { "type": ["integer", "null"] },
+				"quality_after": { "type": ["integer", "null"] },
+				"metrics": {
+					"type": "array",
+					"items": {
+						"type": "object",
+						"additionalProperties": false,
+						"required": ["name", "before", "after"],
+						"properties": {
+							"name": { "type": "string" },
+							"before": { "type": "string" },
+							"after": { "type": "string" }
+						}
+					}
+				},
+				"degraded_reasons": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"stdout_sha256": { "type": "string" }
+			}
+		}
+	},
+	"$defs": {
+		"violation": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["severity", "rule", "message", "files"],
+			"properties": {
+				"severity": {
+					"type": "string",
+					"enum": ["error", "warning", "info"]
+				},
+				"rule": { "type": "string", "minLength": 1 },
+				"message": { "type": "string" },
+				"files": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"related_rules": {
+					"type": "array",
+					"items": { "type": "string" }
+				}
+			}
+		}
+	}
+}

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

@@ -15,7 +15,7 @@
 	"properties": {
 		"schema_version": {
 			"type": "string",
-			"const": "1.0.0"
+			"oneOf": [{ "const": "1.0.0" }, { "const": "1.1.0" }]
 		},
 		"run_id": {
 			"type": "string",
@@ -38,6 +38,39 @@
 		"phase": {
 			"type": "string",
 			"enum": ["execute", "evaluate", "review"]
+		},
+		"quality_signal": {
+			"type": "integer"
+		},
+		"bottleneck": {
+			"type": "string",
+			"enum": [
+				"modularity",
+				"equality",
+				"acyclicity",
+				"stability",
+				"abstraction"
+			]
+		},
+		"violation_count": {
+			"type": "integer",
+			"minimum": 0
+		},
+		"report_path": {
+			"type": "string",
+			"description": "Run-relative path to sentrux-report.json"
+		},
+		"diagnostics_path": {
+			"type": "string",
+			"description": "Run-relative path to sentrux-diagnostics.json"
+		},
+		"repair_plan_path": {
+			"type": "string",
+			"description": "Run-relative path to sentrux-repair-plan.yaml"
+		},
+		"degraded_reasons": {
+			"type": "array",
+			"items": { "type": "string" }
 		}
 	}
 }

package/.pi/lib/agents-policy.d.mts

@@ -1,18 +1,4 @@
-export function packageAgentsPolicyPath(packageRoot: string): string;
-export function projectAgentsPolicyPath(projectRoot: string): string;
-export function projectPoliciesDir(projectRoot: string): string;
-
-export interface AgentPolicySpec {
-	kind: string;
-	effectiveTools: string[];
-	extensionsOff: boolean;
-	readOnly: boolean;
-	maxTurns?: number;
-	thinking?: string;
-	submitTool?: string;
-}
-
-export interface AllowsAgentToolInput {
+export type AllowsAgentToolInput = {
 	packageRoot: string;
 	projectRoot: string;
 	agentId: string;
@@ -20,51 +6,44 @@ export interface AllowsAgentToolInput {
 	toolInput?: Record<string, unknown>;
 	isSubprocess?: boolean;
 	isParentOrchestrator?: boolean;
-}
+};
 
-export function loadAgentsPolicyMerged(
+export function allowsAgentTool(input: AllowsAgentToolInput): boolean;
+export function applyAgentPolicyToConfig(
+	agent: Record<string, unknown>,
+	packageRoot: string,
+	projectRoot: string,
+): Record<string, unknown>;
+export function findProjectRootFromAgentsDir(projectAgentsDir: string): string;
+export function getAgentKind(
 	packageRoot: string,
 	projectRoot: string,
-): {
-	schemaVersion: string;
-	kinds: Map<string, unknown>;
-	agents: Map<string, unknown>;
-	defaults: unknown;
-};
-
-export function resolveEffectiveTools(
 	agentId: string,
-	merged: ReturnType<typeof loadAgentsPolicyMerged>,
-): AgentPolicySpec;
-
+): string;
 export function getAgentPolicySpec(
 	packageRoot: string,
 	projectRoot: string,
 	agentId: string,
-): AgentPolicySpec | null;
-
-export function getAgentKind(
+): unknown;
+export function harnessSubagentPhaseHint(
 	packageRoot: string,
 	projectRoot: string,
 	agentId: string,
-): string;
-
+): string | undefined;
+export function isAgtGovernanceActive(projectRoot: string): boolean;
 export function isHarnessPlanningAgent(agentId: string): boolean;
-
-export function harnessSubagentPhaseHint(
+export function loadAgentsPolicyMerged(
 	packageRoot: string,
 	projectRoot: string,
+): unknown;
+export function packageAgentsPolicyPath(packageRoot: string): string;
+export function projectAgentsPolicyPath(projectRoot: string): string;
+export function projectPoliciesDir(projectRoot: string): string;
+export function resolveEffectiveTools(
 	agentId: string,
-): string | null;
-
-export function allowsAgentTool(input: AllowsAgentToolInput): boolean;
-
-export function applyAgentPolicyToConfig<T extends { name: string }>(
-	agent: T,
+	merged: unknown,
+): string[];
+export function resolveExtensionBundlePaths(
 	packageRoot: string,
-	projectRoot: string,
-): T;
-
-export function findProjectRootFromAgentsDir(projectAgentsDir: string): string;
-
-export function isAgtGovernanceActive(projectRoot: string): boolean;
+	bundleName: string,
+): string[];