ultimate-pi 0.20.0 → 0.22.0

package/.pi/harness/ls-lint/naming.manifest.json

@@ -0,0 +1,128 @@
+{
+	"schema_version": "1.0.0",
+	"project": "ultimate-pi",
+	"global_rules": {
+		".*": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".md": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".ts": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".tsx": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".mjs": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".js": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".json": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".yaml": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".yml": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".toml": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".py": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".sh": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".css": "regex:^[a-z]+(?:-[a-z]+)*$",
+		".html": "regex:^[a-z]+(?:-[a-z]+)*$"
+	},
+	"scoped_rules": [
+		{
+			"path": ".pi/harness/docs/adrs",
+			"rules": {
+				".md": "regex:^\\d{4}-[a-z-]+$|^template$"
+			}
+		},
+		{
+			"path": ".agents/skills",
+			"rules": {
+				".dir": "kebab-case",
+				".md": "regex:^SKILL\\.md$"
+			}
+		},
+		{
+			"path": "scripts",
+			"rules": {
+				".dir": "kebab-case"
+			}
+		},
+		{
+			"path": "docs",
+			"rules": {
+				".dir": "kebab-case"
+			}
+		},
+		{
+			"path": ".pi/scripts",
+			"rules": {
+				".dir": "snake_case"
+			}
+		},
+		{
+			"path": ".pi/agents",
+			"rules": {
+				".dir": "kebab-case"
+			}
+		}
+	],
+	"ignores": [
+		".git",
+		"node_modules",
+		"graphify-out",
+		"graphify-books-out",
+		"vendor",
+		"dist",
+		"build",
+		"coverage",
+		".web",
+		".cursor",
+		".github",
+		".agents",
+		".pi/npm",
+		".pi/harness/runs",
+		".pi/harness/debates",
+		".pi/harness/.lens",
+		".pi/wiki-search",
+		".cocoindex_code",
+		".sentrux",
+		".ls-lint",
+		".searxng",
+		".vault-meta",
+		".raw",
+		"raw",
+		"data",
+		"**/__pycache__/**",
+		"submissions",
+		"jobs",
+		"pl",
+		"**/*.png",
+		"**/*.jpg",
+		"**/*.jpeg",
+		"**/*.gif",
+		"**/*.webp",
+		"**/*.ico",
+		"**/*.svg",
+		"package-lock.json",
+		"pnpm-lock.yaml",
+		"yarn.lock",
+		"*.lock",
+		"README.md",
+		"**/README.md",
+		"SKILL.md",
+		"**/SKILL.md",
+		"CHANGELOG.md",
+		"LICENSE",
+		"AGENTS.md",
+		"CONTRIBUTING.md",
+		"THIRD_PARTY_NOTICES.md",
+		".env.example",
+		"skills-lock.json",
+		".fallow-baseline.json",
+		".graphify_detect.json",
+		".graphify_python",
+		".graphify_root",
+		".graphify_incremental.json",
+		".pi/SYSTEM.md",
+		".pi/PACKAGING.md",
+		"**/.*",
+		".pi/sounds",
+		".pi/harness/evals",
+		".pi/extensions/00-harness-project-control.ts",
+		"DOCS_BY_AUDIENCE.md",
+		"GLOSSARY.md",
+		"REPO_MAP.md",
+		"START_HERE.md",
+		"WORKFLOW_CHEAT_SHEET.md"
+	]
+}

package/.pi/harness/sentrux/architecture.manifest.json

@@ -4,7 +4,7 @@
 	"constraints": {
 		"max_cycles": 0,
 		"max_coupling": "B",
-		"max_cc": 35,
+		"max_cc": 25,
 		"no_god_files": true
 	},
 	"layers": [

package/.pi/harness/specs/auto-commit.schema.json

@@ -0,0 +1,63 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/auto-commit.schema.json",
+	"title": "AutoCommitConfig",
+	"description": "Harness auto-commit: co-author trailers, message templates, branch/push hints.",
+	"type": "object",
+	"additionalProperties": true,
+	"properties": {
+		"dryRun": { "type": "boolean" },
+		"coAuthor": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["login", "email"],
+			"properties": {
+				"login": { "type": "string", "minLength": 1 },
+				"email": { "type": "string", "minLength": 3 },
+				"required": { "type": "boolean" }
+			}
+		},
+		"branch": {
+			"type": "object",
+			"additionalProperties": true,
+			"properties": {
+				"strategy": { "type": "string" },
+				"protected": {
+					"type": "array",
+					"items": { "type": "string" }
+				}
+			}
+		},
+		"push": {
+			"type": "object",
+			"additionalProperties": true,
+			"properties": {
+				"allowedRemotes": {
+					"type": "array",
+					"items": { "type": "string" }
+				}
+			}
+		},
+		"submodules": {
+			"type": "object",
+			"additionalProperties": true,
+			"properties": {
+				"ignore": { "type": "boolean" }
+			}
+		},
+		"message": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["template", "coAuthorTrailer"],
+			"properties": {
+				"template": { "type": "string", "minLength": 1 },
+				"templateNoScope": { "type": "string", "minLength": 1 },
+				"typeDefault": { "type": "string", "minLength": 1 },
+				"scopeDefault": { "type": "string" },
+				"bodySeparator": { "type": "string" },
+				"coAuthorTrailer": { "type": "string", "minLength": 1 },
+				"maxSubjectLength": { "type": "integer", "minimum": 20, "maximum": 200 }
+			}
+		}
+	}
+}

package/.pi/harness/specs/ls-lint-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/ls-lint-manifest-proposal.schema.json",
+	"title": "LsLintManifestProposal",
+	"description": "Graphify-grounded proposal to evolve naming.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_rule",
+				"add_scoped_rule",
+				"add_ignore",
+				"change_global"
+			]
+		},
+		"summary": {
+			"type": "string",
+			"minLength": 1
+		},
+		"evidence": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["source", "ref", "summary"],
+				"properties": {
+					"source": {
+						"type": "string",
+						"enum": ["graphify", "sg", "ls-lint", "plan", "manifest"]
+					},
+					"ref": {
+						"type": "string",
+						"minLength": 1
+					},
+					"summary": {
+						"type": "string",
+						"minLength": 1
+					}
+				}
+			}
+		},
+		"manifest_patch": {
+			"type": "object",
+			"description": "JSON Merge Patch (RFC 7396) ops against naming.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/ls-lint-signal.schema.json

@@ -0,0 +1,47 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/ls-lint-signal.schema.json",
+	"title": "LsLintSignal",
+	"description": "Per-run ls-lint CLI observation for evaluator and harness-verify promotion.",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"schema_version",
+		"run_id",
+		"lint_pass",
+		"status",
+		"recorded_at"
+	],
+	"properties": {
+		"schema_version": {
+			"type": "string",
+			"const": "1.0.0"
+		},
+		"run_id": {
+			"type": "string",
+			"minLength": 1
+		},
+		"lint_pass": {
+			"type": "boolean"
+		},
+		"violation_count": {
+			"type": "integer",
+			"minimum": 0
+		},
+		"status": {
+			"type": "string",
+			"enum": ["pass", "fail", "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/naming-manifest.schema.json

@@ -0,0 +1,54 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/naming-manifest.schema.json",
+	"title": "NamingManifest",
+	"description": "Canonical harness source for .ls-lint.yml (filename and directory naming).",
+	"type": "object",
+	"additionalProperties": false,
+	"required": ["schema_version", "project", "global_rules", "ignores"],
+	"properties": {
+		"schema_version": {
+			"type": "string",
+			"const": "1.0.0"
+		},
+		"project": {
+			"type": "string",
+			"minLength": 1
+		},
+		"global_rules": {
+			"type": "object",
+			"additionalProperties": {
+				"type": "string",
+				"minLength": 1
+			}
+		},
+		"scoped_rules": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["path", "rules"],
+				"properties": {
+					"path": {
+						"type": "string",
+						"minLength": 1
+					},
+					"rules": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "string",
+							"minLength": 1
+						}
+					}
+				}
+			}
+		},
+		"ignores": {
+			"type": "array",
+			"items": {
+				"type": "string",
+				"minLength": 1
+			}
+		}
+	}
+}

package/.pi/harness/specs/plan-task-clarification.schema.json

@@ -0,0 +1,88 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://ultimate-pi.local/.pi/harness/specs/plan-task-clarification.schema.json",
+	"title": "PlanTaskClarification",
+	"description": "Upfront task contract before harness plan reconnaissance (Phase 0).",
+	"type": "object",
+	"additionalProperties": false,
+	"required": [
+		"schema_version",
+		"status",
+		"source_task",
+		"clarified_task",
+		"success_definition",
+		"in_scope",
+		"out_of_scope",
+		"acceptance_checks_draft",
+		"assumptions",
+		"risk_level",
+		"unresolved_questions",
+		"clarification_rounds",
+		"task_input_hash"
+	],
+	"properties": {
+		"schema_version": { "type": "string", "const": "1.0.0" },
+		"status": {
+			"type": "string",
+			"enum": ["draft", "needs_user", "ready"]
+		},
+		"source_task": { "type": "string", "minLength": 1 },
+		"clarified_task": { "type": "string", "minLength": 1 },
+		"success_definition": { "type": "string", "minLength": 1 },
+		"in_scope": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 }
+		},
+		"out_of_scope": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 }
+		},
+		"acceptance_checks_draft": {
+			"type": "array",
+			"minItems": 1,
+			"items": { "type": "string", "minLength": 1 }
+		},
+		"assumptions": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"risk_level": {
+			"type": "string",
+			"enum": ["low", "med", "high"]
+		},
+		"constraints": {
+			"type": "object",
+			"properties": {
+				"hard": { "type": "array", "items": { "type": "string" } },
+				"soft": { "type": "array", "items": { "type": "string" } }
+			},
+			"additionalProperties": true
+		},
+		"unresolved_questions": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"clarification_rounds": { "type": "integer", "minimum": 0 },
+		"task_input_hash": { "type": "string", "minLength": 1 },
+		"evidence_refs": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"grounding": {
+			"type": "object",
+			"properties": {
+				"repo_mentions": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"urls": { "type": "array", "items": { "type": "string" } },
+				"tools_used": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"summary": { "type": "string" }
+			},
+			"additionalProperties": true
+		}
+	}
+}

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