@khoavu882/doflow 2.0.0-beta.5 → 2.0.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 (471) hide show
  1. package/README.md +12 -11
  2. package/bin/doflow.js +21 -11
  3. package/core/.antigravity-plugin/plugin.json +1 -2
  4. package/core/.claude-plugin/plugin.json +1 -1
  5. package/core/.codex-plugin/plugin.json +1 -1
  6. package/core/.plugin/plugin.json +1 -1
  7. package/core/harnesses/claude/hooks/lib.sh +43 -24
  8. package/core/harnesses/claude/hooks/permission-audit.sh +3 -0
  9. package/core/harnesses/claude/hooks/post-compact.sh +35 -32
  10. package/core/harnesses/claude/hooks/post-edit-lint.sh +2 -0
  11. package/core/harnesses/claude/hooks/post-shell-observe.sh +48 -0
  12. package/core/harnesses/claude/hooks/post-tool-failure.sh +3 -0
  13. package/core/harnesses/claude/hooks/pre-compact.sh +23 -27
  14. package/core/harnesses/claude/hooks/session-end.sh +23 -10
  15. package/core/harnesses/claude/hooks/skill-config-audit.sh +3 -0
  16. package/core/harnesses/claude/settings/settings.json +18 -0
  17. package/core/harnesses/claude/statusline/doflow-statusline.sh +1 -0
  18. package/core/harnesses/codex/agents/core-implementer.toml +1 -0
  19. package/core/harnesses/codex/agents/delivery-lead.toml +10 -0
  20. package/core/harnesses/codex/agents/quality-guardian.toml +1 -1
  21. package/core/harnesses/codex/agents/research-writer.toml +1 -1
  22. package/core/harnesses/codex/agents/reviewer.toml +10 -0
  23. package/core/harnesses/codex/agents/spec-analyst.toml +1 -1
  24. package/core/harnesses/codex/agents/system-architect.toml +1 -1
  25. package/core/harnesses/codex/hooks/lib.sh +44 -25
  26. package/core/harnesses/codex/hooks/post-edit-lint.impl.sh +3 -1
  27. package/core/harnesses/codex/hooks/pre-compact.impl.sh +29 -26
  28. package/core/harnesses/codex/hooks/session-end.impl.sh +23 -10
  29. package/core/harnesses/codex/hooks/subagent-audit.sh +1 -0
  30. package/core/harnesses/copilot/hooks/doflow-lib.sh +93 -0
  31. package/core/harnesses/copilot/hooks/doflow-mcp-tool-guard.sh +9 -0
  32. package/core/harnesses/copilot/hooks/doflow-pre-bash-guard.sh +9 -0
  33. package/core/harnesses/copilot/hooks/doflow-pre-implement-gate.sh +9 -0
  34. package/core/harnesses/copilot/hooks/doflow-session-start.sh +9 -0
  35. package/core/harnesses/copilot/hooks/doflow-stop-check.sh +9 -0
  36. package/core/harnesses/copilot/hooks/doflow-subagent-start.sh +9 -0
  37. package/core/harnesses/copilot/hooks/doflow-subagent-stop.sh +9 -0
  38. package/core/harnesses/copilot/hooks/doflow.json +57 -0
  39. package/core/harnesses/kiro/agents/doflow.json +1 -1
  40. package/core/harnesses/kiro/hooks/lib.sh +26 -6
  41. package/core/harnesses/kiro/hooks/mcp-tool-guard.sh +1 -0
  42. package/core/harnesses/kiro/hooks/pre-bash-guard.sh +1 -0
  43. package/core/harnesses/kiro/hooks/pre-implement-gate.sh +1 -0
  44. package/core/harnesses/kiro/hooks/session-start.sh +1 -0
  45. package/core/harnesses/kiro/hooks/stop-check.sh +1 -0
  46. package/core/harnesses/pi/extensions/doflow-guard.js +8 -0
  47. package/core/harnesses/shared/hooks/ENVELOPE_MIGRATION.md +0 -1
  48. package/core/harnesses/shared/hooks/bridge/bridge.sh +102 -9
  49. package/core/harnesses/shared/hooks/bridge/envelope.jq +87 -18
  50. package/core/harnesses/shared/hooks/bridge/observe-model.sh +75 -0
  51. package/core/harnesses/shared/hooks/bridge/respond.sh +10 -2
  52. package/core/harnesses/shared/hooks/policies/blocked-patterns.conf +28 -14
  53. package/core/harnesses/shared/hooks/policies/capture-failure.sh +48 -15
  54. package/core/harnesses/shared/hooks/policies/compact-text.sh +46 -0
  55. package/core/harnesses/shared/hooks/policies/contract.sh +3 -0
  56. package/core/harnesses/shared/hooks/policies/deny-json.sh +2 -11
  57. package/core/harnesses/shared/hooks/policies/emission-rules.sh +37 -0
  58. package/core/harnesses/shared/hooks/policies/emission.jq +209 -0
  59. package/core/harnesses/shared/hooks/policies/emission.sh +383 -0
  60. package/core/harnesses/shared/hooks/policies/identity.sh +177 -0
  61. package/core/harnesses/shared/hooks/policies/lib.sh +63 -40
  62. package/core/harnesses/shared/hooks/policies/mcp-tool-guard.sh +3 -2
  63. package/core/harnesses/shared/hooks/policies/pre-bash-guard.sh +213 -12
  64. package/core/harnesses/shared/hooks/policies/pre-implementation-gate.sh +114 -38
  65. package/core/harnesses/shared/hooks/policies/session-context.sh +30 -1
  66. package/core/harnesses/shared/hooks/policies/stop-check.sh +20 -9
  67. package/core/harnesses/shared/hooks/policies/subagent-audit.sh +5 -2
  68. package/core/harnesses/shared/hooks/policies/summary-store.sh +347 -0
  69. package/core/harnesses/shared/hooks/policies/user-prompt-submit.sh +60 -155
  70. package/core/harnesses/shared/hooks/stream-hook-runner.js +47 -8
  71. package/core/harnesses/shared/locator/doflow-run +2 -3
  72. package/core/registry/advice.json +3 -3
  73. package/core/registry/assets.json +55 -82
  74. package/core/registry/capabilities.json +12 -0
  75. package/core/registry/contracts.json +58 -31
  76. package/core/registry/contribution-points.json +32 -0
  77. package/core/registry/gates.json +32 -0
  78. package/core/registry/guidance-caps.json +40 -0
  79. package/core/registry/harnesses.json +1442 -363
  80. package/core/registry/lifecycle.json +485 -304
  81. package/core/registry/mcp.json +5 -1
  82. package/core/registry/models.json +7 -1
  83. package/core/registry/package-templates/README.md +19 -0
  84. package/core/registry/package-templates/agent/files/agent.md +9 -0
  85. package/core/registry/package-templates/agent/template.json +4 -0
  86. package/core/registry/package-templates/capability-provider/files/provider.json +9 -0
  87. package/core/registry/package-templates/capability-provider/template.json +11 -0
  88. package/core/registry/package-templates/debate-preset/files/preset.json +26 -0
  89. package/core/registry/package-templates/debate-preset/template.json +4 -0
  90. package/core/registry/package-templates/review-preset/files/preset.json +30 -0
  91. package/core/registry/package-templates/review-preset/template.json +4 -0
  92. package/core/registry/package-templates/skill/files/SKILL.md +8 -0
  93. package/core/registry/package-templates/skill/template.json +4 -0
  94. package/core/registry/package-templates/worker/files/worker.json +92 -0
  95. package/core/registry/package-templates/worker/template.json +11 -0
  96. package/core/registry/packages/doflow/doflow-package.json +15 -0
  97. package/core/registry/packages/doflow/presets/debate-3.json +26 -0
  98. package/core/registry/protocols.json +61 -0
  99. package/core/registry/routes.json +17 -0
  100. package/core/registry/rules.json +431 -0
  101. package/core/registry/settings.json +276 -0
  102. package/core/registry/storage.json +679 -31
  103. package/core/registry/telemetry.json +236 -0
  104. package/core/registry/transcripts.json +142 -0
  105. package/core/registry/verification.json +76 -1
  106. package/core/registry/workflows.json +55 -0
  107. package/core/shared/agent-specs/core-implementer.md +3 -0
  108. package/core/shared/agent-specs/delivery-lead.md +68 -0
  109. package/core/shared/agent-specs/quality-guardian.md +5 -1
  110. package/core/shared/agent-specs/research-writer.md +10 -3
  111. package/core/shared/agent-specs/reviewer.md +53 -0
  112. package/core/shared/agent-specs/spec-analyst.md +5 -6
  113. package/core/shared/agent-specs/system-architect.md +5 -1
  114. package/core/shared/guidance/DOFLOW_CORE.md +1 -5
  115. package/core/shared/guidance/modes/MODE_DeepResearch.md +1 -1
  116. package/core/shared/guidance/modes/MODE_Orchestration.md +4 -3
  117. package/core/shared/guidance/modes/MODE_Task_Management.md +14 -14
  118. package/core/shared/guidance/pointers/codex.md +1 -4
  119. package/core/shared/guidance/references/ARTIFACT_FORMAT.md +30 -16
  120. package/core/shared/guidance/references/ARTIFACT_VOICE.md +3 -2
  121. package/core/shared/guidance/references/CONSTITUTION_BASE.md +17 -15
  122. package/core/shared/guidance/references/DIAGRAM_GUIDE.md +1 -1
  123. package/core/shared/guidance/references/DOFLOW_CHAIN.md +17 -19
  124. package/core/shared/guidance/references/EVIDENCE_LEDGER.md +7 -8
  125. package/core/shared/guidance/references/MODEL_SELECTION.md +5 -3
  126. package/core/shared/guidance/references/ORCHESTRATION.md +1 -2
  127. package/core/shared/guidance/rules/RULES.md +45 -0
  128. package/core/shared/scripts/doflow/bash/do-args.sh +37 -0
  129. package/core/shared/scripts/doflow/bash/do-exec-paths.sh +4 -0
  130. package/core/shared/scripts/doflow/bash/do-git-state.sh +15 -4
  131. package/core/shared/scripts/doflow/bash/do-parallel-check.sh +4 -0
  132. package/core/shared/scripts/doflow/bash/do-paths.sh +40 -2
  133. package/core/shared/scripts/doflow/bash/do-prereqs.sh +2 -1
  134. package/core/shared/scripts/doflow/bash/do-review-package.sh +4 -0
  135. package/core/shared/scripts/doflow/bash/do-task-brief.sh +58 -16
  136. package/core/shared/scripts/doflow/bash/render-audit.sh +26 -2
  137. package/core/shared/scripts/doflow/bash/render-diagrams.sh +1 -0
  138. package/core/shared/scripts/doflow/bash/render-puml.sh +2 -1
  139. package/core/shared/scripts/doflow/bash/validate-artifacts.sh +48 -4
  140. package/core/shared/scripts/doflow/bin/doflow-run +149 -34
  141. package/core/shared/skills/do/SKILL.md +12 -10
  142. package/core/shared/skills/do/references/advice_calls.md +26 -0
  143. package/core/shared/skills/do/references/pm_routing.md +1 -2
  144. package/core/shared/skills/do/references/program_mode.md +31 -0
  145. package/core/shared/skills/do-brainstorm/SKILL.md +20 -74
  146. package/core/shared/skills/do-brainstorm/references/handoff_branches.md +35 -0
  147. package/core/shared/skills/do-brainstorm/references/intent_seed.md +21 -0
  148. package/core/shared/skills/do-brainstorm/references/round_log.md +17 -0
  149. package/core/shared/skills/do-code-review/SKILL.md +41 -144
  150. package/core/shared/skills/do-code-review/content-types/markdown.md +24 -2
  151. package/core/shared/skills/do-code-review/references/tools.md +90 -0
  152. package/core/shared/skills/do-code-review/scripts/doc_quality_checker.py +549 -7
  153. package/core/shared/skills/do-design/SKILL.md +18 -17
  154. package/core/shared/skills/do-diagnose/SKILL.md +14 -4
  155. package/core/shared/skills/do-document/SKILL.md +11 -1
  156. package/core/shared/skills/do-document/references/deep_research.md +1 -2
  157. package/core/shared/skills/do-document/references/embedded-research.md +18 -6
  158. package/core/shared/skills/do-document/references/implementation-flow.md +5 -6
  159. package/core/shared/skills/do-execute-plan/SKILL.md +15 -58
  160. package/core/shared/skills/do-execute-plan/references/handoff_record.md +7 -2
  161. package/core/shared/skills/do-execute-plan/references/parallel_dispatch.md +13 -0
  162. package/core/shared/skills/do-execute-plan/references/readiness_gate.md +26 -1
  163. package/core/shared/skills/do-execute-plan/references/run_position.md +13 -1
  164. package/core/shared/skills/do-execute-plan/references/scaffold.md +17 -9
  165. package/core/shared/skills/do-execute-plan/references/state_checkpoint.md +11 -0
  166. package/core/shared/skills/do-execute-plan/references/task_attempts.md +78 -24
  167. package/core/shared/skills/do-flow/SKILL.md +8 -9
  168. package/core/shared/skills/do-flow/references/task_classes.md +2 -2
  169. package/core/shared/skills/do-git/SKILL.md +4 -0
  170. package/core/shared/skills/do-implement/SKILL.md +4 -7
  171. package/core/shared/skills/do-plan/SKILL.md +26 -15
  172. package/core/shared/skills/do-test/SKILL.md +7 -4
  173. package/core/shared/templates/doflow/constitution-template.md +9 -3
  174. package/core/shared/templates/doflow/data-model-template.md +1 -1
  175. package/core/shared/templates/doflow/design-template.md +113 -16
  176. package/core/shared/templates/doflow/plan-template.md +11 -10
  177. package/core/shared/templates/doflow/question-log-template.md +14 -2
  178. package/core/shared/templates/doflow/requirement-template.md +1 -1
  179. package/core/worker-evidence/antigravity/checks.json +14 -0
  180. package/core/worker-evidence/codex/2026-10-18-cli-check.json +107 -0
  181. package/core/worker-evidence/codex/2026-10-18-live-run-edit.json +73 -0
  182. package/core/worker-evidence/codex/2026-10-18-live-run-read-only.json +62 -0
  183. package/core/worker-evidence/codex/2026-10-24-cli-check.json +126 -0
  184. package/core/worker-evidence/codex/checks.json +38 -0
  185. package/package.json +10 -6
  186. package/src/adapters/antigravity/index.js +143 -66
  187. package/src/adapters/claude/index.js +24 -4
  188. package/src/adapters/codex/agents.js +25 -15
  189. package/src/adapters/codex/index.js +48 -13
  190. package/src/adapters/codex/native-projection.js +6 -2
  191. package/src/adapters/copilot/index.js +58 -23
  192. package/src/adapters/copy-tree.js +290 -44
  193. package/src/adapters/guidance-manifest.js +71 -0
  194. package/src/adapters/guidance-pointer.js +19 -0
  195. package/src/adapters/hook-commands.js +6 -10
  196. package/src/adapters/index.js +1 -0
  197. package/src/adapters/kiro/index.js +23 -12
  198. package/src/adapters/opencode/index.js +8 -8
  199. package/src/adapters/pi/hooks.js +2 -1
  200. package/src/adapters/pi/index.js +14 -7
  201. package/src/adapters/resolve-source.js +26 -2
  202. package/src/cli/commands/install.js +2 -1
  203. package/src/cli/commands/reconcile.js +53 -9
  204. package/src/cli/commands/remove.js +2 -2
  205. package/src/cli/commands/rollback.js +6 -3
  206. package/src/cli/commands/self-update.js +18 -9
  207. package/src/cli/commands/status.js +21 -2
  208. package/src/cli/commands/ui.js +99 -0
  209. package/src/cli/commands/update.js +2 -1
  210. package/src/cli/index.js +322 -29
  211. package/src/cli/runtime-commands.js +209 -57
  212. package/src/cli/shared.js +0 -2
  213. package/src/helper/git.js +1 -1
  214. package/src/helper/guardrails.js +1 -1
  215. package/src/helper/marker-merge.js +31 -13
  216. package/src/helper/package-ids.js +37 -0
  217. package/src/helper/semver.js +94 -0
  218. package/src/install/backup.js +105 -15
  219. package/src/install/context.js +1 -1
  220. package/src/install/targets.js +31 -16
  221. package/src/lifecycle/coverage.js +20 -3
  222. package/src/lifecycle/hook-tier.js +160 -0
  223. package/src/lifecycle/index.js +412 -78
  224. package/src/lifecycle/retired-harnesses.js +318 -0
  225. package/src/lifecycle/view.js +35 -15
  226. package/src/registry/index.js +551 -26
  227. package/src/registry/worker-ids.js +45 -0
  228. package/src/release/build-package.js +0 -3
  229. package/src/release/docs-blocks.js +492 -0
  230. package/src/release/preflight.js +425 -0
  231. package/src/release/rehearse.js +401 -0
  232. package/src/release/release-workflow.js +733 -0
  233. package/src/release/sync-plugin-versions.js +43 -7
  234. package/src/runtime/advice/bench-gate.js +25 -0
  235. package/src/runtime/advice/cli.js +59 -16
  236. package/src/runtime/advice/client.js +32 -9
  237. package/src/runtime/advice/config.js +98 -133
  238. package/src/runtime/advice/doctor.js +1 -1
  239. package/src/runtime/advice/elevation.js +97 -0
  240. package/src/runtime/advice/endpoint-guard.js +9 -3
  241. package/src/runtime/advice/mode.js +37 -0
  242. package/src/runtime/advice/record.js +18 -5
  243. package/src/runtime/advice/registry.js +4 -1
  244. package/src/runtime/advice/shadow-config.js +229 -0
  245. package/src/runtime/advice/shadow-dispatcher.js +276 -0
  246. package/src/runtime/brief-rules.js +81 -0
  247. package/src/runtime/brief-tools.js +111 -34
  248. package/src/runtime/candidate.js +20 -11
  249. package/src/runtime/capabilities/executor.js +450 -0
  250. package/src/runtime/capabilities/loopback.js +41 -0
  251. package/src/runtime/capabilities/sanitizer.js +88 -0
  252. package/src/runtime/capability-router.js +135 -3
  253. package/src/runtime/checkouts.js +73 -11
  254. package/src/runtime/claims.js +13 -7
  255. package/src/runtime/cli.js +196 -19
  256. package/src/runtime/config-home.js +42 -0
  257. package/src/runtime/context/arbitrate.js +767 -0
  258. package/src/runtime/context/delivery-store.js +4 -6
  259. package/src/runtime/context/emission-rules.js +118 -0
  260. package/src/runtime/context/identity.js +227 -0
  261. package/src/runtime/context/primary-command.js +117 -0
  262. package/src/runtime/context/primary.js +344 -0
  263. package/src/runtime/context/summary-store.js +655 -0
  264. package/src/runtime/context-pack.js +154 -78
  265. package/src/runtime/decision-register.js +13 -4
  266. package/src/runtime/dispatch/admission.js +392 -0
  267. package/src/runtime/dispatch/attempt-end.js +274 -0
  268. package/src/runtime/dispatch/command.js +628 -0
  269. package/src/runtime/dispatch/controls.js +904 -0
  270. package/src/runtime/dispatch/envelope.js +276 -0
  271. package/src/runtime/dispatch/grants.js +310 -0
  272. package/src/runtime/dispatch/integrate.js +617 -0
  273. package/src/runtime/dispatch/loop.js +1835 -0
  274. package/src/runtime/dispatch/store.js +352 -0
  275. package/src/runtime/dispatch/verify-run.js +201 -0
  276. package/src/runtime/evidence-ledger.js +34 -7
  277. package/src/runtime/failure/capture.js +3 -1
  278. package/src/runtime/failure/cli.js +25 -9
  279. package/src/runtime/failure/home.js +57 -30
  280. package/src/runtime/failure/store.js +7 -2
  281. package/src/runtime/feature-pointer.js +174 -0
  282. package/src/runtime/feature-resolve.js +13 -2
  283. package/src/runtime/fleet/command.js +77 -0
  284. package/src/runtime/fleet/projects.js +178 -0
  285. package/src/runtime/fleet/tree.js +383 -0
  286. package/src/runtime/freshness.js +33 -3
  287. package/src/runtime/git-memo.js +46 -0
  288. package/src/runtime/guidance/ablation.js +427 -0
  289. package/src/runtime/health.js +565 -17
  290. package/src/runtime/history-compactor.js +13 -3
  291. package/src/runtime/implementation-gate.js +277 -22
  292. package/src/runtime/inventory/coverage.js +1 -1
  293. package/src/runtime/inventory/index.js +1 -1
  294. package/src/runtime/inventory/precedence.js +2 -2
  295. package/src/runtime/inventory/siblings.js +6 -4
  296. package/src/runtime/knowledge/code-corpus.js +277 -0
  297. package/src/runtime/knowledge/code-lexical.js +130 -0
  298. package/src/runtime/knowledge/code-retrieval.js +307 -0
  299. package/src/runtime/knowledge/code-validation.js +106 -0
  300. package/src/runtime/knowledge/gp3-gate.js +74 -0
  301. package/src/runtime/knowledge/graph-adapter.js +288 -0
  302. package/src/runtime/knowledge/graph-fallback.js +394 -0
  303. package/src/runtime/knowledge/hybrid.js +136 -8
  304. package/src/runtime/knowledge/retrieval.js +34 -1
  305. package/src/runtime/knowledge/rtk-compress.js +77 -0
  306. package/src/runtime/knowledge/semble-bridge.py +106 -0
  307. package/src/runtime/knowledge/semble-lifecycle.js +114 -0
  308. package/src/runtime/knowledge/semble-provider.js +365 -0
  309. package/src/runtime/lifecycle/cli.js +16 -6
  310. package/src/runtime/lifecycle/event-store.js +8 -6
  311. package/src/runtime/lifecycle/followup.js +6 -1
  312. package/src/runtime/lifecycle/overview.js +24 -1
  313. package/src/runtime/lifecycle/report-store.js +8 -10
  314. package/src/runtime/lifecycle/retention.js +95 -31
  315. package/src/runtime/lifecycle/root.js +9 -1
  316. package/src/runtime/lifecycle/status.js +34 -17
  317. package/src/runtime/lifecycle/store-upkeep.js +56 -7
  318. package/src/runtime/mask.js +134 -7
  319. package/src/runtime/mcp-consultations.js +40 -6
  320. package/src/runtime/model-router.js +79 -7
  321. package/src/runtime/models/catalogue.js +191 -0
  322. package/src/runtime/models/command.js +153 -0
  323. package/src/runtime/off-words.js +12 -0
  324. package/src/runtime/outcome.js +2 -2
  325. package/src/runtime/packages/command.js +1009 -0
  326. package/src/runtime/packages/contributions.js +116 -0
  327. package/src/runtime/packages/digest.js +132 -0
  328. package/src/runtime/packages/fetch.js +182 -0
  329. package/src/runtime/packages/grants.js +192 -0
  330. package/src/runtime/packages/index-file.js +134 -0
  331. package/src/runtime/packages/instruction.js +90 -0
  332. package/src/runtime/packages/manifest.js +331 -0
  333. package/src/runtime/packages/points.js +477 -0
  334. package/src/runtime/packages/programs.js +216 -0
  335. package/src/runtime/packages/scaffold.js +277 -0
  336. package/src/runtime/packages/source.js +90 -0
  337. package/src/runtime/packages/state.js +164 -0
  338. package/src/runtime/packages/store.js +449 -0
  339. package/src/runtime/packages/tar.js +106 -0
  340. package/src/runtime/packages/view.js +406 -0
  341. package/src/runtime/plan-check.js +59 -0
  342. package/src/runtime/plan-content.js +324 -0
  343. package/src/runtime/policy-init.js +118 -0
  344. package/src/runtime/profiles/doctor.js +96 -0
  345. package/src/runtime/profiles/resolve.js +244 -0
  346. package/src/runtime/profiles/rollback.js +254 -0
  347. package/src/runtime/profiles/sampler.js +41 -0
  348. package/src/runtime/readiness-record.js +16 -11
  349. package/src/runtime/readiness.js +46 -5
  350. package/src/runtime/research-request.js +50 -25
  351. package/src/runtime/retrieval-plan.js +10 -30
  352. package/src/runtime/retrieval-record.js +75 -5
  353. package/src/runtime/review/command.js +246 -0
  354. package/src/runtime/review/dominance.js +68 -0
  355. package/src/runtime/review/findings.js +434 -0
  356. package/src/runtime/review/identity.js +255 -0
  357. package/src/runtime/review/protocol-command.js +109 -0
  358. package/src/runtime/review/protocols.js +405 -0
  359. package/src/runtime/review/resolve-protocol.js +302 -0
  360. package/src/runtime/review/start.js +530 -0
  361. package/src/runtime/roadmap/facts.js +479 -0
  362. package/src/runtime/roadmap/gates.js +270 -0
  363. package/src/runtime/roadmap/loop.js +1636 -0
  364. package/src/runtime/roadmap/merge.js +381 -0
  365. package/src/runtime/roadmap/rows.js +1113 -0
  366. package/src/runtime/roadmap/seed.js +951 -0
  367. package/src/runtime/rules-report.js +336 -0
  368. package/src/runtime/scaffold/artifacts.js +60 -9
  369. package/src/runtime/scaffold/generate.js +21 -9
  370. package/src/runtime/settings/autopilot.js +106 -0
  371. package/src/runtime/settings/cli.js +280 -0
  372. package/src/runtime/settings/config-write.js +314 -0
  373. package/src/runtime/settings/files.js +271 -0
  374. package/src/runtime/settings/legacy.js +154 -0
  375. package/src/runtime/settings/lexical.js +56 -0
  376. package/src/runtime/settings/prepared-run.js +269 -0
  377. package/src/runtime/settings/project-layers.js +118 -0
  378. package/src/runtime/settings/refs.js +288 -0
  379. package/src/runtime/settings/registry.js +553 -0
  380. package/src/runtime/settings/resolve.js +713 -0
  381. package/src/runtime/settings/shared.js +37 -0
  382. package/src/runtime/settings/worker-billing.js +107 -0
  383. package/src/runtime/settings/write.js +269 -0
  384. package/src/runtime/slot-command.js +78 -0
  385. package/src/runtime/slots.js +671 -0
  386. package/src/runtime/source-version.js +1 -0
  387. package/src/runtime/state-root.js +217 -0
  388. package/src/runtime/storage/cli.js +12 -5
  389. package/src/runtime/storage/engine.js +9 -2
  390. package/src/runtime/storage/registry.js +14 -1
  391. package/src/runtime/storage/roots.js +66 -16
  392. package/src/runtime/storage/rules.js +82 -10
  393. package/src/runtime/storage/upkeep.js +10 -2
  394. package/src/runtime/storage/work-status.js +245 -26
  395. package/src/runtime/task-attempts.js +589 -69
  396. package/src/runtime/task-classifier.js +47 -11
  397. package/src/runtime/task-graph.js +373 -0
  398. package/src/runtime/task-run.js +778 -0
  399. package/src/runtime/task-scope.js +176 -55
  400. package/src/runtime/task-sources.js +147 -0
  401. package/src/runtime/task-state.js +374 -64
  402. package/src/runtime/team/admission.js +301 -0
  403. package/src/runtime/team/envelope.js +324 -0
  404. package/src/runtime/team/review-guard.js +156 -0
  405. package/src/runtime/trace/analyze.js +427 -0
  406. package/src/runtime/trace/baseline.js +770 -0
  407. package/src/runtime/trace/ledger.js +63 -140
  408. package/src/runtime/trace/otlp-export.js +568 -0
  409. package/src/runtime/trace/otlp-map.js +481 -0
  410. package/src/runtime/trace/spans.js +745 -0
  411. package/src/runtime/trace/telemetry.js +225 -0
  412. package/src/runtime/trace/views.js +1 -0
  413. package/src/runtime/transcripts/command.js +98 -0
  414. package/src/runtime/transcripts/cursor.js +326 -0
  415. package/src/runtime/transcripts/read.js +126 -0
  416. package/src/runtime/transcripts/readers/claude-jsonl.js +74 -0
  417. package/src/runtime/transcripts/readers/codex-rollout.js +70 -0
  418. package/src/runtime/transcripts/readers/copilot-events.js +90 -0
  419. package/src/runtime/transcripts/readers/kiro-jsonl.js +77 -0
  420. package/src/runtime/transcripts/readers/pi-jsonl.js +59 -0
  421. package/src/runtime/transcripts/registry.js +161 -0
  422. package/src/runtime/transcripts/stats.js +161 -0
  423. package/src/runtime/verification/check-key.js +628 -0
  424. package/src/runtime/verification/contract-runner.js +546 -11
  425. package/src/runtime/verification/engine.js +499 -9
  426. package/src/runtime/verification/impact.js +617 -0
  427. package/src/runtime/verification/inflight.js +205 -0
  428. package/src/runtime/verification/registry.js +176 -0
  429. package/src/runtime/verification/reuse.js +184 -0
  430. package/src/runtime/verification/telemetry-emit.js +254 -0
  431. package/src/runtime/verification/test-selection.js +67 -7
  432. package/src/runtime/worker/active.js +90 -0
  433. package/src/runtime/worker/cancel.js +222 -0
  434. package/src/runtime/worker/catalogue.js +122 -0
  435. package/src/runtime/worker/command.js +677 -0
  436. package/src/runtime/worker/evidence.js +288 -0
  437. package/src/runtime/worker/launch.js +288 -0
  438. package/src/runtime/worker/models.js +137 -0
  439. package/src/runtime/worker/parsers.js +218 -0
  440. package/src/runtime/worker/probes/index.js +706 -0
  441. package/src/runtime/worker/process-tree.js +415 -0
  442. package/src/runtime/worker/quota.js +43 -0
  443. package/src/runtime/worker/readiness.js +713 -0
  444. package/src/runtime/worker/run-store.js +166 -0
  445. package/src/runtime/worker/supervisor.js +541 -0
  446. package/src/runtime/worker/worktree-check.js +252 -0
  447. package/src/runtime/workflow-engine.js +5 -1
  448. package/src/runtime/workflow-orchestrator.js +578 -63
  449. package/src/runtime/worktree.js +149 -22
  450. package/src/state/index.js +1 -1
  451. package/src/state/lockfile.js +64 -10
  452. package/src/state/run-lock.js +1 -1
  453. package/types/node-commonjs.d.ts +106 -7
  454. package/core/harnesses/gemini/hooks/hooks.json +0 -77
  455. package/core/harnesses/gemini/hooks/lib.sh +0 -302
  456. package/core/harnesses/gemini/hooks/mcp-tool-guard.sh +0 -10
  457. package/core/harnesses/gemini/hooks/post-edit-lint.sh +0 -39
  458. package/core/harnesses/gemini/hooks/pre-bash-guard.sh +0 -10
  459. package/core/harnesses/gemini/hooks/pre-compact.sh +0 -38
  460. package/core/harnesses/gemini/hooks/pre-implement-gate.sh +0 -10
  461. package/core/harnesses/gemini/hooks/session-end.impl.sh +0 -89
  462. package/core/harnesses/gemini/hooks/session-end.sh +0 -5
  463. package/core/harnesses/gemini/hooks/session-start.sh +0 -7
  464. package/core/harnesses/gemini/settings/adapter-defaults.json +0 -4
  465. package/core/shared/guidance/FLAGS.md +0 -25
  466. package/core/shared/guidance/rules/RULE_01_SAFETY.md +0 -25
  467. package/core/shared/guidance/rules/RULE_02_WORKFLOW.md +0 -23
  468. package/core/shared/guidance/rules/RULE_03_QUALITY.md +0 -14
  469. package/core/shared/guidance/rules/RULE_04_QUESTIONS.md +0 -46
  470. package/src/adapters/gemini/hooks.js +0 -251
  471. package/src/adapters/gemini/index.js +0 -429
@@ -0,0 +1,706 @@
1
+ 'use strict';
2
+
3
+ const fs = require('node:fs');
4
+ const os = require('node:os');
5
+ const path = require('node:path');
6
+ const { execFile } = require('node:child_process');
7
+ const { promisify } = require('node:util');
8
+ const execFileAsync = promisify(execFile);
9
+
10
+
11
+
12
+
13
+
14
+
15
+
16
+
17
+
18
+
19
+
20
+
21
+
22
+
23
+ const DEFAULT_PROBE_TIMEOUT_MS = 3000;
24
+
25
+ const RELOGIN_HINTS = {
26
+ claude: 'claude login',
27
+ codex: 'codex login',
28
+ opencode: 'opencode auth login <provider>',
29
+ pi: 'pi',
30
+ copilot: 'copilot login',
31
+ kiro: 'kiro-cli login',
32
+ antigravity: 'agy',
33
+ };
34
+
35
+ const HARNESS_BINARIES = {
36
+ claude: 'claude',
37
+ codex: 'codex',
38
+ opencode: 'opencode',
39
+ pi: 'pi',
40
+ copilot: 'copilot',
41
+ kiro: 'kiro-cli',
42
+ antigravity: 'agy',
43
+ };
44
+
45
+ const DEFAULT_MODELS = {
46
+ claude: [
47
+ { id: 'claude-3-7-sonnet', displayName: 'Claude 3.7 Sonnet', family: 'claude' },
48
+ { id: 'claude-3-5-sonnet', displayName: 'Claude 3.5 Sonnet', family: 'claude' },
49
+ { id: 'claude-3-5-haiku', displayName: 'Claude 3.5 Haiku', family: 'claude' },
50
+ ],
51
+ codex: [
52
+ { id: 'o3-mini', displayName: 'o3-mini', family: 'openai' },
53
+ { id: 'o1', displayName: 'o1', family: 'openai' },
54
+ { id: 'gpt-4o', displayName: 'GPT-4o', family: 'openai' },
55
+ ],
56
+ opencode: [
57
+ { id: 'claude-3-7-sonnet', displayName: 'Claude 3.7 Sonnet', family: 'claude' },
58
+ { id: 'gpt-4o', displayName: 'GPT-4o', family: 'openai' },
59
+ ],
60
+ pi: [
61
+ { id: 'claude-3-7-sonnet', displayName: 'Claude 3.7 Sonnet', family: 'claude' },
62
+ ],
63
+ copilot: [
64
+ { id: 'claude-3.5-sonnet', displayName: 'Claude 3.5 Sonnet', family: 'claude' },
65
+ { id: 'gpt-4o', displayName: 'GPT-4o', family: 'openai' },
66
+ ],
67
+ kiro: [
68
+ { id: 'claude-3-7-sonnet', displayName: 'Claude 3.7 Sonnet', family: 'claude' },
69
+ ],
70
+ antigravity: [
71
+ { id: 'gemini-2.5-pro', displayName: 'Gemini 2.5 Pro', family: 'gemini' },
72
+ { id: 'gemini-2.5-flash', displayName: 'Gemini 2.5 Flash', family: 'gemini' },
73
+ ],
74
+ };
75
+
76
+ async function executeCommand(
77
+ bin ,
78
+ args ,
79
+ options
80
+ ) {
81
+ const timeout = options.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
82
+ const runner = options.execFileImpl;
83
+
84
+ if (runner) {
85
+ return new Promise((resolve) => {
86
+ try {
87
+ const proc = runner(bin, args, { timeout, env: options.env }, (err , stdout , stderr ) => {
88
+ if (err) {
89
+ resolve({
90
+ ok: false,
91
+ stdout: String(stdout || ''),
92
+ stderr: String(stderr || err.message || ''),
93
+ code: err.code || 1,
94
+ });
95
+ } else {
96
+ resolve({
97
+ ok: true,
98
+ stdout: String(stdout || '').trim(),
99
+ stderr: String(stderr || '').trim(),
100
+ code: 0,
101
+ });
102
+ }
103
+ });
104
+ if (proc && typeof proc.then === 'function') {
105
+ proc.then(
106
+ (res ) => resolve({ ok: true, stdout: String(res.stdout || '').trim(), stderr: String(res.stderr || '').trim(), code: 0 }),
107
+ (err ) => resolve({ ok: false, stdout: String(err.stdout || ''), stderr: String(err.stderr || err.message || ''), code: err.code || 1 })
108
+ );
109
+ }
110
+ } catch (err ) {
111
+ resolve({
112
+ ok: false,
113
+ stdout: '',
114
+ stderr: err.message || String(err),
115
+ code: err.code || 'ERR',
116
+ });
117
+ }
118
+ });
119
+ }
120
+
121
+ try {
122
+ const { stdout, stderr } = await execFileAsync(bin, args, { timeout, env: options.env });
123
+ return { ok: true, stdout: String(stdout || '').trim(), stderr: String(stderr || '').trim(), code: 0 };
124
+ } catch (err ) {
125
+ return {
126
+ ok: false,
127
+ stdout: String(err.stdout || ''),
128
+ stderr: String(err.stderr || err.message || ''),
129
+ code: err.code || 1,
130
+ };
131
+ }
132
+ }
133
+
134
+ function parseVersion(text ) {
135
+ const match = text.match(/\b\d+\.\d+(?:\.\d+)?(?:-[A-Za-z0-9.]+)?\b/);
136
+ return match ? match[0] : null;
137
+ }
138
+
139
+ const probeClaude = async (options = {}) => {
140
+ const env = options.env ?? process.env;
141
+ const fsImpl = options.fsImpl ?? fs;
142
+ const home = options.homeDir ?? os.homedir();
143
+ const binary = HARNESS_BINARIES.claude;
144
+ const reloginHint = RELOGIN_HINTS.claude;
145
+
146
+ const ver = await executeCommand(binary, ['--version'], options);
147
+ if (!ver.ok && (ver.code === 'ENOENT' || ver.stderr.includes('ENOENT') || ver.stderr.includes('not found'))) {
148
+ return {
149
+ harnessId: 'claude',
150
+ binary,
151
+ installed: false,
152
+ version: null,
153
+ loginState: 'logged-out',
154
+ reloginHint,
155
+ detectedMode: 'unverified',
156
+ derivedBilling: 'unknown',
157
+ offeredModels: DEFAULT_MODELS.claude,
158
+ lastSyncedAt: new Date().toISOString(),
159
+ };
160
+ }
161
+
162
+ const installed = true;
163
+ const version = ver.ok ? parseVersion(ver.stdout) : null;
164
+
165
+ if (env.ANTHROPIC_API_KEY && env.ANTHROPIC_API_KEY.trim()) {
166
+ return {
167
+ harnessId: 'claude',
168
+ binary,
169
+ installed,
170
+ version,
171
+ loginState: 'logged-in',
172
+ reloginHint: null,
173
+ detectedMode: 'api-key',
174
+ derivedBilling: 'metered',
175
+ offeredModels: DEFAULT_MODELS.claude,
176
+ lastSyncedAt: new Date().toISOString(),
177
+ };
178
+ }
179
+
180
+ const claudeJson = path.join(home, '.claude.json');
181
+ let hasSession = false;
182
+ try {
183
+ if (fsImpl.existsSync(claudeJson)) {
184
+ const data = JSON.parse(fsImpl.readFileSync(claudeJson, 'utf8'));
185
+ if (data && (data.oauthAccount || data.sessionKey || data.token || data.userID)) {
186
+ hasSession = true;
187
+ }
188
+ }
189
+ } catch {
190
+ // unreadable
191
+ }
192
+
193
+ if (hasSession) {
194
+ return {
195
+ harnessId: 'claude',
196
+ binary,
197
+ installed,
198
+ version,
199
+ loginState: 'logged-in',
200
+ reloginHint: null,
201
+ detectedMode: 'subscription',
202
+ derivedBilling: 'free',
203
+ offeredModels: DEFAULT_MODELS.claude,
204
+ lastSyncedAt: new Date().toISOString(),
205
+ };
206
+ }
207
+
208
+ return {
209
+ harnessId: 'claude',
210
+ binary,
211
+ installed,
212
+ version,
213
+ loginState: 'logged-out',
214
+ reloginHint,
215
+ detectedMode: 'unverified',
216
+ derivedBilling: 'unknown',
217
+ offeredModels: DEFAULT_MODELS.claude,
218
+ lastSyncedAt: new Date().toISOString(),
219
+ };
220
+ };
221
+
222
+ const probeCodex = async (options = {}) => {
223
+ const env = options.env ?? process.env;
224
+ const fsImpl = options.fsImpl ?? fs;
225
+ const home = options.homeDir ?? os.homedir();
226
+ const binary = HARNESS_BINARIES.codex;
227
+ const reloginHint = RELOGIN_HINTS.codex;
228
+
229
+ const ver = await executeCommand(binary, ['--version'], options);
230
+ if (!ver.ok && (ver.code === 'ENOENT' || ver.stderr.includes('ENOENT') || ver.stderr.includes('not found'))) {
231
+ return {
232
+ harnessId: 'codex',
233
+ binary,
234
+ installed: false,
235
+ version: null,
236
+ loginState: 'logged-out',
237
+ reloginHint,
238
+ detectedMode: 'unverified',
239
+ derivedBilling: 'unknown',
240
+ offeredModels: DEFAULT_MODELS.codex,
241
+ lastSyncedAt: new Date().toISOString(),
242
+ };
243
+ }
244
+
245
+ const installed = true;
246
+ const version = ver.ok ? parseVersion(ver.stdout) : null;
247
+
248
+ const status = await executeCommand(binary, ['login', 'status'], options);
249
+ if (!status.ok) {
250
+ return {
251
+ harnessId: 'codex',
252
+ binary,
253
+ installed,
254
+ version,
255
+ loginState: 'logged-out',
256
+ reloginHint,
257
+ detectedMode: 'unverified',
258
+ derivedBilling: 'unknown',
259
+ offeredModels: DEFAULT_MODELS.codex,
260
+ lastSyncedAt: new Date().toISOString(),
261
+ };
262
+ }
263
+
264
+ const configToml = path.join(home, '.codex', 'config.toml');
265
+ let configText = '';
266
+ try {
267
+ if (fsImpl.existsSync(configToml)) {
268
+ configText = fsImpl.readFileSync(configToml, 'utf8');
269
+ }
270
+ } catch {
271
+ // ignore
272
+ }
273
+
274
+ let detectedMode = 'subscription';
275
+ let derivedBilling = 'free';
276
+
277
+ if (env.OPENAI_API_KEY && env.OPENAI_API_KEY.trim()) {
278
+ detectedMode = 'api-key';
279
+ derivedBilling = 'metered';
280
+ } else if (configText.includes('[model_providers]') || configText.includes('api_key')) {
281
+ detectedMode = 'api-key';
282
+ derivedBilling = 'metered';
283
+ } else if (configText.includes('forced_login_method = "chatgpt"') || status.stdout.toLowerCase().includes('chatgpt')) {
284
+ detectedMode = 'subscription';
285
+ derivedBilling = 'free';
286
+ }
287
+
288
+ return {
289
+ harnessId: 'codex',
290
+ binary,
291
+ installed,
292
+ version,
293
+ loginState: 'logged-in',
294
+ reloginHint: null,
295
+ detectedMode,
296
+ derivedBilling,
297
+ offeredModels: DEFAULT_MODELS.codex,
298
+ lastSyncedAt: new Date().toISOString(),
299
+ };
300
+ };
301
+
302
+ const probeOpencode = async (options = {}) => {
303
+ const binary = HARNESS_BINARIES.opencode;
304
+ const reloginHint = RELOGIN_HINTS.opencode;
305
+
306
+ const ver = await executeCommand(binary, ['--version'], options);
307
+ if (!ver.ok && (ver.code === 'ENOENT' || ver.stderr.includes('ENOENT') || ver.stderr.includes('not found'))) {
308
+ return {
309
+ harnessId: 'opencode',
310
+ binary,
311
+ installed: false,
312
+ version: null,
313
+ loginState: 'logged-out',
314
+ reloginHint,
315
+ detectedMode: 'unverified',
316
+ derivedBilling: 'unknown',
317
+ offeredModels: DEFAULT_MODELS.opencode,
318
+ lastSyncedAt: new Date().toISOString(),
319
+ };
320
+ }
321
+
322
+ const installed = true;
323
+ const version = ver.ok ? parseVersion(ver.stdout) : null;
324
+
325
+ const authRes = await executeCommand(binary, ['auth', 'list', '--format', 'json'], options);
326
+ if (!authRes.ok) {
327
+ return {
328
+ harnessId: 'opencode',
329
+ binary,
330
+ installed,
331
+ version,
332
+ loginState: 'logged-out',
333
+ reloginHint,
334
+ detectedMode: 'unverified',
335
+ derivedBilling: 'unknown',
336
+ offeredModels: DEFAULT_MODELS.opencode,
337
+ lastSyncedAt: new Date().toISOString(),
338
+ };
339
+ }
340
+
341
+ try {
342
+ const parsed = JSON.parse(authRes.stdout);
343
+ const accounts = Array.isArray(parsed) ? parsed : (parsed.accounts || parsed.providers || Object.values(parsed));
344
+ if (Array.isArray(accounts) && accounts.length > 0) {
345
+ const isOauth = accounts.some((a ) =>
346
+ (typeof a === 'string' && a.includes('oauth')) ||
347
+ a.type === 'oauth' || a.method === 'oauth' || a.authType === 'oauth'
348
+ );
349
+ return {
350
+ harnessId: 'opencode',
351
+ binary,
352
+ installed,
353
+ version,
354
+ loginState: 'logged-in',
355
+ reloginHint: null,
356
+ detectedMode: isOauth ? 'subscription' : 'api-key',
357
+ derivedBilling: isOauth ? 'free' : 'metered',
358
+ offeredModels: DEFAULT_MODELS.opencode,
359
+ lastSyncedAt: new Date().toISOString(),
360
+ };
361
+ }
362
+ } catch {
363
+ // not valid json or empty
364
+ }
365
+
366
+ return {
367
+ harnessId: 'opencode',
368
+ binary,
369
+ installed,
370
+ version,
371
+ loginState: 'logged-out',
372
+ reloginHint,
373
+ detectedMode: 'unverified',
374
+ derivedBilling: 'unknown',
375
+ offeredModels: DEFAULT_MODELS.opencode,
376
+ lastSyncedAt: new Date().toISOString(),
377
+ };
378
+ };
379
+
380
+ const probePi = async (options = {}) => {
381
+ const env = options.env ?? process.env;
382
+ const fsImpl = options.fsImpl ?? fs;
383
+ const home = options.homeDir ?? os.homedir();
384
+ const binary = HARNESS_BINARIES.pi;
385
+ const reloginHint = RELOGIN_HINTS.pi;
386
+
387
+ const ver = await executeCommand(binary, ['--version'], options);
388
+ if (!ver.ok && (ver.code === 'ENOENT' || ver.stderr.includes('ENOENT') || ver.stderr.includes('not found'))) {
389
+ return {
390
+ harnessId: 'pi',
391
+ binary,
392
+ installed: false,
393
+ version: null,
394
+ loginState: 'logged-out',
395
+ reloginHint,
396
+ detectedMode: 'unverified',
397
+ derivedBilling: 'unknown',
398
+ offeredModels: DEFAULT_MODELS.pi,
399
+ lastSyncedAt: new Date().toISOString(),
400
+ };
401
+ }
402
+
403
+ const installed = true;
404
+ const version = ver.ok ? parseVersion(ver.stdout) : null;
405
+
406
+ const piModelsJson = path.join(home, '.pi', 'agent', 'models.json');
407
+ let hasKey = Boolean(env.ANTHROPIC_API_KEY || env.OPENAI_API_KEY);
408
+ let customModels = DEFAULT_MODELS.pi;
409
+
410
+ try {
411
+ if (fsImpl.existsSync(piModelsJson)) {
412
+ const data = JSON.parse(fsImpl.readFileSync(piModelsJson, 'utf8'));
413
+ if (data && typeof data === 'object') {
414
+ hasKey = true;
415
+ if (Array.isArray(data.models)) {
416
+ customModels = data.models.map((m ) => ({
417
+ id: typeof m === 'string' ? m : m.id,
418
+ displayName: typeof m === 'object' ? m.name || m.displayName : undefined,
419
+ }));
420
+ }
421
+ }
422
+ }
423
+ } catch {
424
+ // ignore
425
+ }
426
+
427
+ if (hasKey) {
428
+ return {
429
+ harnessId: 'pi',
430
+ binary,
431
+ installed,
432
+ version,
433
+ loginState: 'logged-in',
434
+ reloginHint: null,
435
+ detectedMode: 'api-key',
436
+ derivedBilling: 'metered',
437
+ offeredModels: customModels,
438
+ lastSyncedAt: new Date().toISOString(),
439
+ };
440
+ }
441
+
442
+ return {
443
+ harnessId: 'pi',
444
+ binary,
445
+ installed,
446
+ version,
447
+ loginState: 'logged-out',
448
+ reloginHint,
449
+ detectedMode: 'unverified',
450
+ derivedBilling: 'unknown',
451
+ offeredModels: customModels,
452
+ lastSyncedAt: new Date().toISOString(),
453
+ };
454
+ };
455
+
456
+ const probeCopilot = async (options = {}) => {
457
+ const env = options.env ?? process.env;
458
+ const binary = HARNESS_BINARIES.copilot;
459
+ const reloginHint = RELOGIN_HINTS.copilot;
460
+
461
+ const ver = await executeCommand(binary, ['--version'], options);
462
+ if (!ver.ok && (ver.code === 'ENOENT' || ver.stderr.includes('ENOENT') || ver.stderr.includes('not found'))) {
463
+ return {
464
+ harnessId: 'copilot',
465
+ binary,
466
+ installed: false,
467
+ version: null,
468
+ loginState: 'logged-out',
469
+ reloginHint,
470
+ detectedMode: 'unverified',
471
+ derivedBilling: 'unknown',
472
+ offeredModels: DEFAULT_MODELS.copilot,
473
+ lastSyncedAt: new Date().toISOString(),
474
+ };
475
+ }
476
+
477
+ const installed = true;
478
+ const version = ver.ok ? parseVersion(ver.stdout) : null;
479
+
480
+ let loggedIn = Boolean((env.COPILOT_GITHUB_TOKEN && env.COPILOT_GITHUB_TOKEN.trim()) || (env.GITHUB_TOKEN && env.GITHUB_TOKEN.trim()));
481
+
482
+ if (!loggedIn) {
483
+ const ghCheck = await executeCommand('gh', ['auth', 'status'], options);
484
+ if (ghCheck.ok || (ghCheck.stdout && ghCheck.stdout.includes('Logged in to github.com'))) {
485
+ loggedIn = true;
486
+ }
487
+ }
488
+
489
+ if (loggedIn) {
490
+ return {
491
+ harnessId: 'copilot',
492
+ binary,
493
+ installed,
494
+ version,
495
+ loginState: 'logged-in',
496
+ reloginHint: null,
497
+ detectedMode: 'subscription',
498
+ derivedBilling: 'free',
499
+ offeredModels: DEFAULT_MODELS.copilot,
500
+ lastSyncedAt: new Date().toISOString(),
501
+ };
502
+ }
503
+
504
+ return {
505
+ harnessId: 'copilot',
506
+ binary,
507
+ installed,
508
+ version,
509
+ loginState: 'logged-out',
510
+ reloginHint,
511
+ detectedMode: 'unverified',
512
+ derivedBilling: 'unknown',
513
+ offeredModels: DEFAULT_MODELS.copilot,
514
+ lastSyncedAt: new Date().toISOString(),
515
+ };
516
+ };
517
+
518
+ const probeKiro = async (options = {}) => {
519
+ const env = options.env ?? process.env;
520
+ const fsImpl = options.fsImpl ?? fs;
521
+ const home = options.homeDir ?? os.homedir();
522
+ const binary = HARNESS_BINARIES.kiro;
523
+ const reloginHint = RELOGIN_HINTS.kiro;
524
+
525
+ const ver = await executeCommand(binary, ['--version'], options);
526
+ if (!ver.ok && (ver.code === 'ENOENT' || ver.stderr.includes('ENOENT') || ver.stderr.includes('not found'))) {
527
+ return {
528
+ harnessId: 'kiro',
529
+ binary,
530
+ installed: false,
531
+ version: null,
532
+ loginState: 'logged-out',
533
+ reloginHint,
534
+ detectedMode: 'unverified',
535
+ derivedBilling: 'unknown',
536
+ offeredModels: DEFAULT_MODELS.kiro,
537
+ lastSyncedAt: new Date().toISOString(),
538
+ };
539
+ }
540
+
541
+ const installed = true;
542
+ const version = ver.ok ? parseVersion(ver.stdout) : null;
543
+
544
+ if (env.KIRO_API_KEY && env.KIRO_API_KEY.trim()) {
545
+ return {
546
+ harnessId: 'kiro',
547
+ binary,
548
+ installed,
549
+ version,
550
+ loginState: 'logged-in',
551
+ reloginHint: null,
552
+ detectedMode: 'api-key',
553
+ derivedBilling: 'metered',
554
+ offeredModels: DEFAULT_MODELS.kiro,
555
+ lastSyncedAt: new Date().toISOString(),
556
+ };
557
+ }
558
+
559
+ const kiroDir = path.join(home, '.kiro');
560
+ let hasSubscription = false;
561
+ try {
562
+ if (fsImpl.existsSync(kiroDir)) {
563
+ const files = fsImpl.readdirSync(kiroDir);
564
+ hasSubscription = files.some((f ) => f.includes('session') || f.includes('token') || f.includes('credentials'));
565
+ }
566
+ } catch {
567
+ // ignore
568
+ }
569
+
570
+ if (hasSubscription) {
571
+ return {
572
+ harnessId: 'kiro',
573
+ binary,
574
+ installed,
575
+ version,
576
+ loginState: 'logged-in',
577
+ reloginHint: null,
578
+ detectedMode: 'subscription',
579
+ derivedBilling: 'free',
580
+ offeredModels: DEFAULT_MODELS.kiro,
581
+ lastSyncedAt: new Date().toISOString(),
582
+ };
583
+ }
584
+
585
+ return {
586
+ harnessId: 'kiro',
587
+ binary,
588
+ installed,
589
+ version,
590
+ loginState: 'logged-out',
591
+ reloginHint,
592
+ detectedMode: 'unverified',
593
+ derivedBilling: 'unknown',
594
+ offeredModels: DEFAULT_MODELS.kiro,
595
+ lastSyncedAt: new Date().toISOString(),
596
+ };
597
+ };
598
+
599
+ const probeAntigravity = async (options = {}) => {
600
+ const env = options.env ?? process.env;
601
+ const fsImpl = options.fsImpl ?? fs;
602
+ const home = options.homeDir ?? os.homedir();
603
+ const binary = HARNESS_BINARIES.antigravity;
604
+ const reloginHint = RELOGIN_HINTS.antigravity;
605
+
606
+ const ver = await executeCommand(binary, ['--version'], options);
607
+ if (!ver.ok && (ver.code === 'ENOENT' || ver.stderr.includes('ENOENT') || ver.stderr.includes('not found'))) {
608
+ return {
609
+ harnessId: 'antigravity',
610
+ binary,
611
+ installed: false,
612
+ version: null,
613
+ loginState: 'logged-out',
614
+ reloginHint,
615
+ detectedMode: 'unverified',
616
+ derivedBilling: 'unknown',
617
+ offeredModels: DEFAULT_MODELS.antigravity,
618
+ lastSyncedAt: new Date().toISOString(),
619
+ };
620
+ }
621
+
622
+ const installed = true;
623
+ const version = ver.ok ? parseVersion(ver.stdout) : null;
624
+
625
+ if (env.AGY_ADC_AUTH === 'true' || env.GOOGLE_APPLICATION_CREDENTIALS) {
626
+ return {
627
+ harnessId: 'antigravity',
628
+ binary,
629
+ installed,
630
+ version,
631
+ loginState: 'logged-in',
632
+ reloginHint: null,
633
+ detectedMode: 'api-key',
634
+ derivedBilling: 'metered',
635
+ offeredModels: DEFAULT_MODELS.antigravity,
636
+ lastSyncedAt: new Date().toISOString(),
637
+ };
638
+ }
639
+
640
+ const agyDir = path.join(home, '.gemini', 'antigravity-cli');
641
+ let hasToken = false;
642
+ try {
643
+ if (fsImpl.existsSync(agyDir)) {
644
+ const files = fsImpl.readdirSync(agyDir);
645
+ hasToken = files.some((f ) => f.includes('token') || f.includes('profile') || f.endsWith('.json'));
646
+ }
647
+ } catch {
648
+ // ignore
649
+ }
650
+
651
+ if (hasToken) {
652
+ return {
653
+ harnessId: 'antigravity',
654
+ binary,
655
+ installed,
656
+ version,
657
+ loginState: 'logged-in',
658
+ reloginHint: null,
659
+ detectedMode: 'subscription',
660
+ derivedBilling: 'free',
661
+ offeredModels: DEFAULT_MODELS.antigravity,
662
+ lastSyncedAt: new Date().toISOString(),
663
+ };
664
+ }
665
+
666
+ return {
667
+ harnessId: 'antigravity',
668
+ binary,
669
+ installed,
670
+ version,
671
+ loginState: 'logged-out',
672
+ reloginHint,
673
+ detectedMode: 'unverified',
674
+ derivedBilling: 'unknown',
675
+ offeredModels: DEFAULT_MODELS.antigravity,
676
+ lastSyncedAt: new Date().toISOString(),
677
+ };
678
+ };
679
+
680
+ const PROBES = {
681
+ claude: probeClaude,
682
+ codex: probeCodex,
683
+ opencode: probeOpencode,
684
+ pi: probePi,
685
+ copilot: probeCopilot,
686
+ kiro: probeKiro,
687
+ antigravity: probeAntigravity,
688
+ };
689
+
690
+ const HARNESS_IDS = Object.keys(PROBES);
691
+
692
+ module.exports = {
693
+ DEFAULT_PROBE_TIMEOUT_MS,
694
+ RELOGIN_HINTS,
695
+ HARNESS_BINARIES,
696
+ DEFAULT_MODELS,
697
+ probeClaude,
698
+ probeCodex,
699
+ probeOpencode,
700
+ probePi,
701
+ probeCopilot,
702
+ probeKiro,
703
+ probeAntigravity,
704
+ PROBES,
705
+ HARNESS_IDS,
706
+ };