ultimate-pi 0.18.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (314) hide show
  1. package/.agents/skills/harness-debate-plan/SKILL.md +1 -1
  2. package/.agents/skills/harness-decisions/SKILL.md +2 -3
  3. package/.agents/skills/harness-governor/SKILL.md +6 -5
  4. package/.agents/skills/harness-orchestration/SKILL.md +4 -4
  5. package/.agents/skills/harness-review/SKILL.md +7 -7
  6. package/.agents/skills/harness-sentrux-setup/SKILL.md +4 -3
  7. package/.agents/skills/harness-steer/SKILL.md +1 -1
  8. package/.agents/skills/sentrux/SKILL.md +9 -9
  9. package/.pi/PACKAGING.md +4 -4
  10. package/.pi/SYSTEM.md +54 -120
  11. package/.pi/agents/harness/incident-recorder.md +0 -1
  12. package/.pi/agents/harness/planning/decompose.md +1 -3
  13. package/.pi/agents/harness/planning/execution-plan-author.md +0 -2
  14. package/.pi/agents/harness/planning/hypothesis-validator.md +0 -2
  15. package/.pi/agents/harness/planning/hypothesis.md +0 -2
  16. package/.pi/agents/harness/planning/implementation-researcher.md +0 -2
  17. package/.pi/agents/harness/planning/plan-adversary.md +0 -2
  18. package/.pi/agents/harness/planning/plan-evaluator.md +1 -3
  19. package/.pi/agents/harness/planning/planning-context.md +0 -2
  20. package/.pi/agents/harness/planning/review-integrator.md +0 -2
  21. package/.pi/agents/harness/planning/sprint-contract-auditor.md +0 -2
  22. package/.pi/agents/harness/planning/stack-researcher.md +0 -2
  23. package/.pi/agents/harness/{adversary.md → reviewing/adversary.md} +0 -2
  24. package/.pi/agents/harness/{evaluator.md → reviewing/evaluator.md} +0 -2
  25. package/.pi/agents/harness/{tie-breaker.md → reviewing/tie-breaker.md} +0 -2
  26. package/.pi/agents/harness/{executor.md → running/executor.md} +0 -2
  27. package/.pi/agents/harness/sentrux-bootstrap.md +0 -1
  28. package/.pi/agents/harness/sentrux-steward.md +0 -2
  29. package/.pi/agents/harness/trace-librarian.md +0 -1
  30. package/.pi/extensions/00-harness-project-control.ts +133 -0
  31. package/.pi/extensions/00-posthog-network-bootstrap.ts +1 -1
  32. package/.pi/extensions/agt-kill-switch.ts +57 -0
  33. package/.pi/extensions/agt-prompt-guard.ts +32 -0
  34. package/.pi/extensions/budget-guard.ts +2 -0
  35. package/.pi/extensions/custom-footer.ts +46 -145
  36. package/.pi/extensions/custom-header.ts +1 -1
  37. package/.pi/extensions/custom-system-prompt.ts +1 -1
  38. package/.pi/extensions/debate-orchestrator.ts +7 -5
  39. package/.pi/extensions/harness-ask-user.ts +8 -8
  40. package/.pi/extensions/harness-debate-tools.ts +27 -43
  41. package/.pi/extensions/harness-lens.ts +94 -0
  42. package/.pi/extensions/harness-live-widget.ts +33 -2
  43. package/.pi/extensions/harness-plan-approval.ts +12 -12
  44. package/.pi/extensions/harness-run-context.ts +1214 -852
  45. package/.pi/extensions/harness-subagent-governance.ts +8 -0
  46. package/.pi/extensions/harness-subagent-submit.ts +36 -164
  47. package/.pi/extensions/harness-subagents.ts +4 -4
  48. package/.pi/extensions/harness-telemetry.ts +3 -1
  49. package/.pi/extensions/harness-web-tools.ts +3 -3
  50. package/.pi/extensions/observation-bus.ts +2 -0
  51. package/.pi/extensions/policy-gate.ts +27 -5
  52. package/.pi/extensions/review-integrity.ts +91 -10
  53. package/.pi/extensions/sentrux-rules-sync.ts +3 -1
  54. package/.pi/extensions/subagent-governance.ts +92 -0
  55. package/.pi/extensions/test-diff-integrity.ts +1 -0
  56. package/.pi/extensions/trace-recorder.ts +3 -1
  57. package/.pi/extensions/{ultimate-pi-vcc.ts → vcc-compaction.ts} +1 -1
  58. package/.pi/harness/README.md +6 -2
  59. package/.pi/harness/agents.manifest.json +38 -49
  60. package/.pi/harness/agents.policy.yaml +275 -0
  61. package/.pi/harness/corpus/graphify-kb-updater.config.json +55 -0
  62. package/.pi/harness/docs/adrs/0006-sentrux-dual-layer.md +2 -1
  63. package/.pi/harness/docs/adrs/0030-inhouse-vcc-compaction.md +1 -1
  64. package/.pi/harness/docs/adrs/0035-plan-phase-review-gate.md +1 -1
  65. package/.pi/harness/docs/adrs/0044-harness-steer-loop.md +3 -2
  66. package/.pi/harness/docs/adrs/0045-harness-lens-minimal-contract.md +49 -0
  67. package/.pi/harness/docs/adrs/0045-phase-scoped-agent-directories.md +33 -0
  68. package/.pi/harness/docs/adrs/0046-agt-policy-engine.md +51 -0
  69. package/.pi/harness/docs/adrs/0047-agt-layered-security.md +39 -0
  70. package/.pi/harness/docs/adrs/0048-tool-call-hook-order.md +25 -0
  71. package/.pi/harness/docs/adrs/0049-agents-policy-manifest.md +36 -0
  72. package/.pi/harness/docs/adrs/README.md +6 -0
  73. package/.pi/harness/docs/graphify-kb-updater-runbook.md +11 -5
  74. package/.pi/harness/docs/practice-map.md +2 -2
  75. package/.pi/harness/evolution/README.md +1 -2
  76. package/.pi/harness/examples/agents.policy.project.yaml +19 -0
  77. package/.pi/harness/examples/policies/custom-deny-bash.yaml +9 -0
  78. package/.pi/harness/policies/bash-denylists.yaml +5 -0
  79. package/.pi/harness/policies/defaults.yaml +51 -0
  80. package/.pi/harness/policies/orchestrator.yaml +18 -0
  81. package/.pi/harness/policies/phases.yaml +10 -0
  82. package/.pi/harness/policies/roles.yaml +5 -0
  83. package/.pi/harness/policies/web-guard.yaml +5 -0
  84. package/.pi/harness/policies/workflow-sequences.yaml +9 -0
  85. package/.pi/harness/sentrux/architecture.manifest.json +26 -4
  86. package/.pi/harness/specs/harness-spawn-context.schema.json +1 -1
  87. package/.pi/harness/specs/observation.schema.json +2 -1
  88. package/.pi/lib/agents-policy.d.mts +70 -0
  89. package/.pi/lib/agents-policy.mjs +325 -0
  90. package/.pi/lib/agents-policy.ts +19 -0
  91. package/.pi/lib/agt/audit-run-sink.ts +52 -0
  92. package/.pi/lib/agt/build-evaluation-context.ts +285 -0
  93. package/.pi/lib/agt/config.ts +28 -0
  94. package/.pi/lib/agt/delegation.ts +69 -0
  95. package/.pi/lib/agt/evaluate-policy.ts +56 -0
  96. package/.pi/lib/agt/identity-registry.ts +41 -0
  97. package/.pi/lib/agt/index.ts +55 -0
  98. package/.pi/lib/agt/kill-switch-state.ts +11 -0
  99. package/.pi/lib/agt/legacy-evaluate.ts +101 -0
  100. package/.pi/lib/agt/policy-engine.ts +154 -0
  101. package/.pi/lib/agt/rings.ts +21 -0
  102. package/.pi/lib/agt/sre-hooks.ts +45 -0
  103. package/.pi/lib/agt/trust-run-store.ts +26 -0
  104. package/.pi/lib/agt/workflow-history.ts +29 -0
  105. package/.pi/lib/agt-governance-active.ts +14 -0
  106. package/.pi/lib/agt-tool-guard.ts +78 -0
  107. package/.pi/lib/ask-user/dialog.ts +314 -0
  108. package/.pi/{extensions/lib → lib}/debate-bus-core.ts +10 -10
  109. package/.pi/{extensions/lib → lib}/debate-bus-state.ts +1 -1
  110. package/.pi/{extensions/lib → lib}/extension-load-guard.ts +21 -0
  111. package/.pi/lib/harness-agt-tool-guard.ts +5 -0
  112. package/.pi/{extensions/lib → lib}/harness-artifact-gate.ts +6 -16
  113. package/.pi/lib/harness-debate-core-deps.ts +14 -0
  114. package/.pi/lib/harness-debate-workflow-deps.ts +43 -0
  115. package/.pi/lib/harness-lens/.gitattributes +1 -0
  116. package/.pi/lib/harness-lens/clients/edit-autopatch.ts +88 -0
  117. package/.pi/lib/harness-lens/clients/file-kinds.ts +380 -0
  118. package/.pi/lib/harness-lens/clients/file-time.ts +215 -0
  119. package/.pi/lib/harness-lens/clients/file-utils.ts +484 -0
  120. package/.pi/lib/harness-lens/clients/format-service.ts +276 -0
  121. package/.pi/lib/harness-lens/clients/formatters.ts +1000 -0
  122. package/.pi/lib/harness-lens/clients/git-guard.ts +31 -0
  123. package/.pi/lib/harness-lens/clients/indent-retarget.ts +90 -0
  124. package/.pi/lib/harness-lens/clients/installer/index.ts +2368 -0
  125. package/.pi/lib/harness-lens/clients/latency-logger.ts +80 -0
  126. package/.pi/lib/harness-lens/clients/lens-config.ts +43 -0
  127. package/.pi/lib/harness-lens/clients/lens-events.ts +164 -0
  128. package/.pi/lib/harness-lens/clients/lsp/aggregation.ts +91 -0
  129. package/.pi/lib/harness-lens/clients/lsp/client.ts +1466 -0
  130. package/.pi/lib/harness-lens/clients/lsp/config.ts +216 -0
  131. package/.pi/lib/harness-lens/clients/lsp/edits.ts +297 -0
  132. package/.pi/lib/harness-lens/clients/lsp/index.ts +1355 -0
  133. package/.pi/lib/harness-lens/clients/lsp/interactive-install.ts +424 -0
  134. package/.pi/lib/harness-lens/clients/lsp/language.ts +223 -0
  135. package/.pi/lib/harness-lens/clients/lsp/launch.ts +939 -0
  136. package/.pi/lib/harness-lens/clients/lsp/lsp-index.ts +11 -0
  137. package/.pi/lib/harness-lens/clients/lsp/path-utils.ts +12 -0
  138. package/.pi/lib/harness-lens/clients/lsp/server-strategies.ts +81 -0
  139. package/.pi/lib/harness-lens/clients/lsp/server.ts +1971 -0
  140. package/.pi/lib/harness-lens/clients/path-utils.ts +182 -0
  141. package/.pi/lib/harness-lens/clients/pipeline.ts +360 -0
  142. package/.pi/lib/harness-lens/clients/project-profile.ts +117 -0
  143. package/.pi/lib/harness-lens/clients/runtime-agent-end.ts +112 -0
  144. package/.pi/lib/harness-lens/clients/runtime-config.ts +33 -0
  145. package/.pi/lib/harness-lens/clients/runtime-coordinator.ts +186 -0
  146. package/.pi/lib/harness-lens/clients/runtime-tool-result.ts +171 -0
  147. package/.pi/lib/harness-lens/clients/safe-spawn.ts +339 -0
  148. package/.pi/lib/harness-lens/clients/secrets-scanner.ts +214 -0
  149. package/.pi/lib/harness-lens/clients/tool-policy.ts +2072 -0
  150. package/.pi/lib/harness-lens/clients/types.ts +59 -0
  151. package/.pi/lib/harness-lens/clients/widget-state.ts +283 -0
  152. package/.pi/lib/harness-lens/index.ts +532 -0
  153. package/.pi/lib/harness-lens/tools/lsp-diagnostics.ts +706 -0
  154. package/.pi/lib/harness-lens/tools/lsp-navigation.ts +1246 -0
  155. package/.pi/{extensions/lib → lib}/harness-posthog.ts +3 -0
  156. package/.pi/lib/harness-project-config.ts +91 -0
  157. package/.pi/lib/harness-run-context-responses.ts +9 -0
  158. package/.pi/lib/harness-run-context.ts +1 -3
  159. package/.pi/{extensions/lib/spawn-policy.ts → lib/harness-spawn-policy.ts} +4 -3
  160. package/.pi/{extensions/lib → lib}/harness-spawn-topology.ts +5 -28
  161. package/.pi/lib/harness-subagent-auth.ts +51 -0
  162. package/.pi/{extensions/lib → lib}/harness-subagent-precheck.ts +13 -10
  163. package/.pi/{extensions/lib → lib}/harness-subagent-submit-pipeline.ts +3 -3
  164. package/.pi/lib/harness-subagent-submit-register.ts +163 -0
  165. package/.pi/{extensions/lib → lib}/harness-subagent-submit-registry.ts +1 -55
  166. package/.pi/{extensions/lib → lib}/harness-subagents-bridge.ts +53 -14
  167. package/.pi/{extensions/lib → lib}/harness-subprocess-bootstrap.ts +1 -1
  168. package/.pi/lib/harness-ui-state.ts +27 -12
  169. package/.pi/{extensions/lib → lib}/plan-approval/create-plan.ts +2 -2
  170. package/.pi/{extensions/lib → lib}/plan-approval/format-plan.ts +2 -2
  171. package/.pi/{extensions/lib → lib}/plan-approval/plan-review.ts +162 -201
  172. package/.pi/{extensions/lib → lib}/plan-approval/render.ts +1 -1
  173. package/.pi/{extensions/lib → lib}/plan-approval/resolve-disk.ts +2 -2
  174. package/.pi/{extensions/lib → lib}/plan-approval/types.ts +1 -1
  175. package/.pi/{extensions/lib → lib}/plan-approval/validate.ts +3 -3
  176. package/.pi/{extensions/lib → lib}/plan-approval-readiness.ts +3 -52
  177. package/.pi/{extensions/lib → lib}/plan-debate-envelope.ts +1 -1
  178. package/.pi/{extensions/lib → lib}/plan-debate-gate.ts +1 -1
  179. package/.pi/{extensions/lib → lib}/plan-debate-lane.ts +1 -4
  180. package/.pi/{extensions/lib → lib}/plan-messenger.ts +1 -1
  181. package/.pi/prompts/harness-auto.md +2 -2
  182. package/.pi/prompts/harness-plan.md +4 -6
  183. package/.pi/prompts/harness-review.md +9 -9
  184. package/.pi/prompts/harness-run.md +7 -7
  185. package/.pi/prompts/harness-setup.md +42 -68
  186. package/.pi/prompts/harness-steer.md +2 -2
  187. package/.pi/scripts/README.md +3 -5
  188. package/.pi/scripts/generate-agents-policy-yaml.mjs +148 -0
  189. package/.pi/scripts/graphify-kb-updater.mjs +48 -8
  190. package/.pi/scripts/harness-agents-manifest.mjs +61 -4
  191. package/.pi/scripts/harness-agt-doctor.ts +36 -0
  192. package/.pi/scripts/harness-cli-verify.sh +9 -2
  193. package/.pi/scripts/harness-project-toggle.mjs +129 -0
  194. package/.pi/scripts/harness-sentrux-cli.mjs +142 -0
  195. package/.pi/scripts/harness-verify.mjs +113 -39
  196. package/.pi/scripts/harness-web-policy-guard.mjs +2 -2
  197. package/.pi/scripts/validate-plan-dag.mjs +65 -74
  198. package/.pi/scripts/vendor-pi-vcc-settings.stub.ts +2 -2
  199. package/.pi/scripts/vendor-sync-pi-vcc.sh +1 -1
  200. package/.pi/skills/architecture/broker-domain/SKILL.md +65 -0
  201. package/.pi/skills/architecture/cqrs/SKILL.md +63 -0
  202. package/.pi/skills/architecture/event-driven/SKILL.md +60 -0
  203. package/.pi/skills/architecture/hexagonal-ports-adapters/SKILL.md +66 -0
  204. package/.pi/skills/architecture/layered/SKILL.md +68 -0
  205. package/.pi/skills/architecture/microkernel/SKILL.md +62 -0
  206. package/.pi/skills/architecture/microservices/SKILL.md +64 -0
  207. package/.pi/skills/architecture/modular-monolith/SKILL.md +65 -0
  208. package/.pi/skills/architecture/orchestration-driven-soa/SKILL.md +61 -0
  209. package/.pi/skills/architecture/pipeline/SKILL.md +63 -0
  210. package/.pi/skills/architecture/service-based/SKILL.md +64 -0
  211. package/.pi/skills/architecture/service-mesh/SKILL.md +60 -0
  212. package/.pi/skills/architecture/space-based/SKILL.md +60 -0
  213. package/.pi/skills/ast-grep/SKILL.md +40 -321
  214. package/.pi/skills/delivery/debugging-discipline/SKILL.md +36 -0
  215. package/.pi/skills/delivery/documentation-update/SKILL.md +33 -0
  216. package/.pi/skills/delivery/requirements-to-implementation/SKILL.md +34 -0
  217. package/.pi/skills/delivery/risk-based-verification/SKILL.md +43 -0
  218. package/.pi/skills/delivery/tradeoff-analysis/SKILL.md +34 -0
  219. package/.pi/skills/engineering/api-contract-design/SKILL.md +38 -0
  220. package/.pi/skills/engineering/cohesion-coupling/SKILL.md +43 -0
  221. package/.pi/skills/engineering/complexity-control/SKILL.md +31 -0
  222. package/.pi/skills/engineering/defensive-programming/SKILL.md +38 -0
  223. package/.pi/skills/engineering/dependency-management/SKILL.md +29 -0
  224. package/.pi/skills/engineering/domain-modeling/SKILL.md +32 -0
  225. package/.pi/skills/engineering/error-handling/SKILL.md +37 -0
  226. package/.pi/skills/engineering/legacy-code-seams/SKILL.md +35 -0
  227. package/.pi/skills/engineering/naming-and-intent/SKILL.md +29 -0
  228. package/.pi/skills/engineering/refactoring-safe-evolution/SKILL.md +35 -0
  229. package/.pi/skills/engineering/routine-function-design/SKILL.md +34 -0
  230. package/.pi/skills/engineering/small-change-discipline/SKILL.md +35 -0
  231. package/.pi/skills/lsp-navigation/SKILL.md +89 -0
  232. package/.pi/skills/quality/code-review-self-check/SKILL.md +35 -0
  233. package/.pi/skills/quality/privacy-data-handling/SKILL.md +26 -0
  234. package/.pi/skills/quality/security-review/SKILL.md +34 -0
  235. package/.pi/skills/quality/test-strategy/SKILL.md +33 -0
  236. package/.pi/skills/quality/testability-design/SKILL.md +33 -0
  237. package/.pi/skills/systems/concurrency-safety/SKILL.md +32 -0
  238. package/.pi/skills/systems/data-modeling-migrations/SKILL.md +31 -0
  239. package/.pi/skills/systems/observability-instrumentation/SKILL.md +32 -0
  240. package/.pi/skills/systems/performance-measurement/SKILL.md +35 -0
  241. package/.pi/skills/systems/reliability-design/SKILL.md +32 -0
  242. package/.sentrux/rules.toml +20 -4
  243. package/AGENTS.md +5 -0
  244. package/CHANGELOG.md +26 -0
  245. package/README.md +85 -58
  246. package/THIRD_PARTY_NOTICES.md +12 -21
  247. package/package.json +15 -7
  248. package/vendor/pi-subagents/src/agents.ts +45 -1
  249. package/vendor/pi-subagents/src/subagents.ts +866 -811
  250. package/vendor/pi-vcc/src/core/brief.ts +68 -99
  251. package/vendor/pi-vcc/src/core/settings.ts +2 -2
  252. package/.agents/skills/caveman/SKILL.md +0 -67
  253. package/.pi/agents/harness/meta-optimizer.md +0 -36
  254. package/.pi/agents/harness/planning/scout-graphify.md +0 -39
  255. package/.pi/agents/harness/planning/scout-semantic.md +0 -41
  256. package/.pi/agents/harness/planning/scout-structure.md +0 -37
  257. package/.pi/extensions/lib/ask-user/dialog.ts +0 -260
  258. package/.pi/extensions/lib/harness-subagent-auth.ts +0 -209
  259. package/.pi/extensions/lib/harness-subagent-policy.ts +0 -236
  260. package/.pi/extensions/pi-model-router-harness.ts +0 -42
  261. package/.pi/harness/evolution/meta-optimizer.mjs +0 -99
  262. package/.pi/harness/specs/router-tuning-proposal.schema.json +0 -114
  263. package/.pi/model-router.example.json +0 -36
  264. package/.pi/prompts/harness-critic.md +0 -10
  265. package/.pi/prompts/harness-eval.md +0 -10
  266. package/.pi/prompts/harness-router-tune.md +0 -52
  267. package/.pi/scripts/harness-generate-model-router.mjs +0 -327
  268. package/.pi/scripts/harness-model-router-routing.test.mjs +0 -97
  269. package/.pi/scripts/harness-sync-model-router.mjs +0 -97
  270. package/.pi/scripts/vendor-sync-pi-model-router.sh +0 -47
  271. package/vendor/pi-model-router/.prettierignore +0 -4
  272. package/vendor/pi-model-router/.prettierrc +0 -5
  273. package/vendor/pi-model-router/AGENTS.md +0 -39
  274. package/vendor/pi-model-router/LICENSE +0 -21
  275. package/vendor/pi-model-router/README.md +0 -99
  276. package/vendor/pi-model-router/UPSTREAM_PIN.md +0 -10
  277. package/vendor/pi-model-router/docs/ARCHITECTURE.md +0 -54
  278. package/vendor/pi-model-router/extensions/commands.ts +0 -720
  279. package/vendor/pi-model-router/extensions/config.ts +0 -348
  280. package/vendor/pi-model-router/extensions/constants.ts +0 -1
  281. package/vendor/pi-model-router/extensions/index.ts +0 -478
  282. package/vendor/pi-model-router/extensions/provider.ts +0 -580
  283. package/vendor/pi-model-router/extensions/routing.ts +0 -564
  284. package/vendor/pi-model-router/extensions/state.ts +0 -52
  285. package/vendor/pi-model-router/extensions/types.ts +0 -95
  286. package/vendor/pi-model-router/extensions/ui.ts +0 -144
  287. package/vendor/pi-model-router/model-router.example.json +0 -48
  288. package/vendor/pi-model-router/package.json +0 -48
  289. package/vendor/pi-model-router/tsconfig.json +0 -16
  290. /package/.pi/{prompts → harness/docs}/planning-rubrics.md +0 -0
  291. /package/.pi/{extensions/lib → lib}/ask-user/fallback.ts +0 -0
  292. /package/.pi/{extensions/lib → lib}/ask-user/render.ts +0 -0
  293. /package/.pi/{extensions/lib → lib}/ask-user/schema.ts +0 -0
  294. /package/.pi/{extensions/lib → lib}/ask-user/types.ts +0 -0
  295. /package/.pi/{extensions/lib → lib}/ask-user/validate-core.mjs +0 -0
  296. /package/.pi/{extensions/lib → lib}/ask-user/validate.ts +0 -0
  297. /package/.pi/{extensions/lib → lib}/harness-cocoindex-refresh.ts +0 -0
  298. /package/.pi/{extensions/lib → lib}/harness-paths.ts +0 -0
  299. /package/.pi/{extensions/lib → lib}/harness-spawn-budget.ts +0 -0
  300. /package/.pi/{extensions/lib → lib}/harness-vcc-settings.ts +0 -0
  301. /package/.pi/{extensions/lib → lib}/harness-web/run-cli.ts +0 -0
  302. /package/.pi/{extensions/lib → lib}/plan-approval/dialog.ts +0 -0
  303. /package/.pi/{extensions/lib → lib}/plan-approval/schema.ts +0 -0
  304. /package/.pi/{extensions/lib → lib}/plan-debate-eligibility.ts +0 -0
  305. /package/.pi/{extensions/lib → lib}/plan-debate-focus.ts +0 -0
  306. /package/.pi/{extensions/lib → lib}/plan-debate-id.ts +0 -0
  307. /package/.pi/{extensions/lib → lib}/plan-debate-lanes.ts +0 -0
  308. /package/.pi/{extensions/lib → lib}/plan-debate-round-status.ts +0 -0
  309. /package/.pi/{extensions/lib → lib}/plan-debate-write-guard.ts +0 -0
  310. /package/.pi/{extensions/lib → lib}/plan-review-gate.ts +0 -0
  311. /package/.pi/{extensions/lib → lib}/plan-review-integrator-rules.ts +0 -0
  312. /package/.pi/{extensions/lib → lib}/plan-scope-guard.ts +0 -0
  313. /package/.pi/{extensions/lib → lib}/posthog-client.ts +0 -0
  314. /package/.pi/{extensions/lib → lib}/posthog-node.d.ts +0 -0
@@ -1,348 +0,0 @@
1
- import { existsSync, readFileSync } from 'node:fs';
2
- import { join } from 'node:path';
3
- import { getAgentDir } from '@earendil-works/pi-coding-agent';
4
- import type { ThinkingLevel } from '@earendil-works/pi-agent-core';
5
- import type {
6
- RouterConfig,
7
- RouterProfile,
8
- RoutedTierConfig,
9
- ConfigLoadResult,
10
- ParsedConfigFile,
11
- RouterTier,
12
- RoutingRule,
13
- } from './types.js';
14
-
15
- export const ROUTER_TIERS = ['high', 'medium', 'low'] as const;
16
-
17
- export const FALLBACK_CONFIG: RouterConfig = {
18
- defaultProfile: 'auto',
19
- debug: false,
20
- profiles: {
21
- auto: {
22
- high: { model: 'openai/gpt-5.4-pro', thinking: 'off' },
23
- medium: { model: 'google/gemini-flash-latest', thinking: 'off' },
24
- low: { model: 'openai/gpt-5.4-nano', thinking: 'off' },
25
- },
26
- },
27
- };
28
-
29
- export const THINKING_LEVELS: readonly ThinkingLevel[] = [
30
- 'off',
31
- 'minimal',
32
- 'low',
33
- 'medium',
34
- 'high',
35
- 'xhigh',
36
- ];
37
- export const ROUTER_PIN_VALUES = ['auto', 'high', 'medium', 'low'] as const;
38
-
39
- export const isObjectRecord = (
40
- value: unknown,
41
- ): value is Record<string, unknown> =>
42
- typeof value === 'object' && value !== null;
43
-
44
- export const isThinkingLevel = (value: unknown): value is ThinkingLevel =>
45
- typeof value === 'string' && THINKING_LEVELS.includes(value as ThinkingLevel);
46
-
47
- export const isRouterTier = (value: unknown): value is RouterTier =>
48
- value === 'high' || value === 'medium' || value === 'low';
49
-
50
- export const parseConfigFile = (path: string): ParsedConfigFile => {
51
- if (!existsSync(path)) {
52
- return { config: {}, warnings: [] };
53
- }
54
-
55
- try {
56
- const parsed = JSON.parse(readFileSync(path, 'utf-8')) as unknown;
57
- if (!isObjectRecord(parsed)) {
58
- return {
59
- config: {},
60
- warnings: [`Ignored router config at ${path}: expected a JSON object.`],
61
- };
62
- }
63
- return { config: parsed as Partial<RouterConfig>, warnings: [] };
64
- } catch (error) {
65
- return {
66
- config: {},
67
- warnings: [
68
- `Failed to parse router config at ${path}: ${error instanceof Error ? error.message : String(error)}`,
69
- ],
70
- };
71
- }
72
- };
73
-
74
- export const mergeConfig = (
75
- base: RouterConfig,
76
- override: Partial<RouterConfig>,
77
- ): RouterConfig => {
78
- const mergedProfiles: Record<string, RouterProfile> = { ...base.profiles };
79
- for (const [name, profile] of Object.entries(override.profiles ?? {})) {
80
- const existing = mergedProfiles[name];
81
- const nextProfile = profile as Partial<RouterProfile>;
82
- mergedProfiles[name] = {
83
- high: {
84
- ...(existing?.high ?? FALLBACK_CONFIG.profiles.auto.high),
85
- ...(nextProfile.high ?? {}),
86
- },
87
- medium: {
88
- ...(existing?.medium ?? FALLBACK_CONFIG.profiles.auto.medium),
89
- ...(nextProfile.medium ?? {}),
90
- },
91
- low: {
92
- ...(existing?.low ?? FALLBACK_CONFIG.profiles.auto.low),
93
- ...(nextProfile.low ?? {}),
94
- },
95
- };
96
- }
97
- return {
98
- defaultProfile: override.defaultProfile ?? base.defaultProfile,
99
- debug: override.debug ?? base.debug,
100
- classifierModel: override.classifierModel ?? base.classifierModel,
101
- phaseBias: override.phaseBias ?? base.phaseBias,
102
- largeContextThreshold:
103
- override.largeContextThreshold ?? base.largeContextThreshold,
104
- maxSessionBudget: override.maxSessionBudget ?? base.maxSessionBudget,
105
- rules: override.rules ?? base.rules,
106
- profiles: mergedProfiles,
107
- };
108
- };
109
-
110
- export const parseCanonicalModelRef = (
111
- value: string,
112
- ): { provider: string; modelId: string } => {
113
- const slashIndex = value.indexOf('/');
114
- if (slashIndex === -1) {
115
- throw new Error(
116
- `Invalid model reference "${value}". Expected "provider/model".`,
117
- );
118
- }
119
- const provider = value.slice(0, slashIndex).trim();
120
- const modelId = value.slice(slashIndex + 1).trim();
121
- if (!provider || !modelId) {
122
- throw new Error(
123
- `Invalid model reference "${value}". Expected "provider/model".`,
124
- );
125
- }
126
- return { provider, modelId };
127
- };
128
-
129
- export const normalizeTierConfig = (
130
- value: unknown,
131
- fallback: RoutedTierConfig,
132
- profileName: string,
133
- tier: RouterTier,
134
- warnings: string[],
135
- ): RoutedTierConfig => {
136
- if (!isObjectRecord(value)) {
137
- warnings.push(
138
- `Profile "${profileName}" has invalid ${tier} tier config. Falling back to ${fallback.model}.`,
139
- );
140
- return { ...fallback };
141
- }
142
-
143
- const model = typeof value.model === 'string' ? value.model.trim() : '';
144
- let parsedModel = fallback.model;
145
- if (!model) {
146
- warnings.push(
147
- `Profile "${profileName}" ${tier} tier is missing a model. Falling back to ${fallback.model}.`,
148
- );
149
- } else {
150
- try {
151
- parseCanonicalModelRef(model);
152
- parsedModel = model;
153
- } catch (error) {
154
- warnings.push(error instanceof Error ? error.message : String(error));
155
- }
156
- }
157
-
158
- const thinking = isThinkingLevel(value.thinking)
159
- ? value.thinking
160
- : fallback.thinking;
161
- if (value.thinking !== undefined && !isThinkingLevel(value.thinking)) {
162
- warnings.push(
163
- `Profile "${profileName}" ${tier} tier has invalid thinking level. Falling back to ${fallback.thinking ?? 'medium'}.`,
164
- );
165
- }
166
-
167
- let fallbacks: string[] | undefined = undefined;
168
- if (Array.isArray(value.fallbacks)) {
169
- fallbacks = [];
170
- for (const f of value.fallbacks) {
171
- if (typeof f === 'string') {
172
- try {
173
- parseCanonicalModelRef(f);
174
- fallbacks.push(f);
175
- } catch (error) {
176
- warnings.push(
177
- `Invalid fallback model "${f}" in profile "${profileName}" ${tier} tier: ${error instanceof Error ? error.message : String(error)}`,
178
- );
179
- }
180
- }
181
- }
182
- }
183
-
184
- return { model: parsedModel, thinking, fallbacks };
185
- };
186
-
187
- export const normalizeConfig = (raw: RouterConfig): ConfigLoadResult => {
188
- const warnings: string[] = [];
189
- const normalizedProfiles: Record<string, RouterProfile> = {};
190
- const fallbackAuto = FALLBACK_CONFIG.profiles.auto;
191
-
192
- for (const [name, profile] of Object.entries(raw.profiles ?? {})) {
193
- normalizedProfiles[name] = {
194
- high: normalizeTierConfig(
195
- profile?.high,
196
- fallbackAuto.high,
197
- name,
198
- 'high',
199
- warnings,
200
- ),
201
- medium: normalizeTierConfig(
202
- profile?.medium,
203
- fallbackAuto.medium,
204
- name,
205
- 'medium',
206
- warnings,
207
- ),
208
- low: normalizeTierConfig(
209
- profile?.low,
210
- fallbackAuto.low,
211
- name,
212
- 'low',
213
- warnings,
214
- ),
215
- };
216
- }
217
-
218
- if (Object.keys(normalizedProfiles).length === 0) {
219
- normalizedProfiles.auto = fallbackAuto;
220
- warnings.push(
221
- 'No valid router profiles found. Falling back to the built-in auto profile.',
222
- );
223
- }
224
-
225
- let defaultProfile =
226
- typeof raw.defaultProfile === 'string' && raw.defaultProfile.trim()
227
- ? raw.defaultProfile.trim()
228
- : undefined;
229
- if (!defaultProfile || !normalizedProfiles[defaultProfile]) {
230
- const fallbackProfile = normalizedProfiles[
231
- FALLBACK_CONFIG.defaultProfile ?? 'auto'
232
- ]
233
- ? (FALLBACK_CONFIG.defaultProfile ?? 'auto')
234
- : Object.keys(normalizedProfiles).sort()[0];
235
- if (defaultProfile && !normalizedProfiles[defaultProfile]) {
236
- warnings.push(
237
- `Default router profile "${defaultProfile}" was not found. Falling back to "${fallbackProfile}".`,
238
- );
239
- }
240
- defaultProfile = fallbackProfile;
241
- }
242
-
243
- const phaseBias =
244
- typeof raw.phaseBias === 'number'
245
- ? Math.max(0, Math.min(1, raw.phaseBias))
246
- : 0.5;
247
-
248
- const largeContextThreshold =
249
- typeof raw.largeContextThreshold === 'number' &&
250
- raw.largeContextThreshold > 0
251
- ? raw.largeContextThreshold
252
- : undefined;
253
-
254
- const maxSessionBudget =
255
- typeof raw.maxSessionBudget === 'number' && raw.maxSessionBudget > 0
256
- ? raw.maxSessionBudget
257
- : undefined;
258
-
259
- const rules: RoutingRule[] = [];
260
- if (Array.isArray(raw.rules)) {
261
- for (const rule of raw.rules) {
262
- if (isObjectRecord(rule)) {
263
- const matches = rule.matches;
264
- const tier = rule.tier;
265
- if (
266
- (typeof matches === 'string' || Array.isArray(matches)) &&
267
- isRouterTier(tier)
268
- ) {
269
- rules.push({
270
- matches,
271
- tier,
272
- reason: typeof rule.reason === 'string' ? rule.reason : undefined,
273
- });
274
- } else {
275
- warnings.push(
276
- `Ignored invalid routing rule: ${JSON.stringify(rule)}`,
277
- );
278
- }
279
- }
280
- }
281
- }
282
-
283
- let classifierModel =
284
- typeof raw.classifierModel === 'string'
285
- ? raw.classifierModel.trim()
286
- : undefined;
287
- if (classifierModel) {
288
- try {
289
- parseCanonicalModelRef(classifierModel);
290
- } catch (error) {
291
- warnings.push(
292
- `Invalid classifierModel: ${error instanceof Error ? error.message : String(error)}`,
293
- );
294
- classifierModel = undefined;
295
- }
296
- }
297
-
298
- return {
299
- config: {
300
- defaultProfile,
301
- debug: typeof raw.debug === 'boolean' ? raw.debug : false,
302
- classifierModel,
303
- phaseBias,
304
- largeContextThreshold,
305
- maxSessionBudget,
306
- rules: rules.length > 0 ? rules : undefined,
307
- profiles: normalizedProfiles,
308
- },
309
- warnings,
310
- };
311
- };
312
-
313
- export const loadRouterConfig = (cwd: string): ConfigLoadResult => {
314
- const globalPath = join(getAgentDir(), 'model-router.json');
315
- const projectPath = join(cwd, '.pi', 'model-router.json');
316
- const globalResult = parseConfigFile(globalPath);
317
- const projectResult = parseConfigFile(projectPath);
318
- const merged = mergeConfig(
319
- mergeConfig(FALLBACK_CONFIG, globalResult.config),
320
- projectResult.config,
321
- );
322
- const normalized = normalizeConfig(merged);
323
- return {
324
- config: normalized.config,
325
- warnings: [
326
- ...globalResult.warnings,
327
- ...projectResult.warnings,
328
- ...normalized.warnings,
329
- ],
330
- };
331
- };
332
-
333
- export const profileNames = (config: RouterConfig): string[] => {
334
- return Object.keys(config.profiles).sort();
335
- };
336
-
337
- export const resolveProfileName = (
338
- config: RouterConfig,
339
- requested?: string,
340
- ): string => {
341
- if (requested && config.profiles[requested]) {
342
- return requested;
343
- }
344
- if (config.defaultProfile && config.profiles[config.defaultProfile]) {
345
- return config.defaultProfile;
346
- }
347
- return profileNames(config)[0] ?? 'auto';
348
- };
@@ -1 +0,0 @@
1
- export const MAX_DEBUG_HISTORY = 12;