@khoavu882/doflow 0.0.0-stage → 2.0.0-beta.3

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 (407) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +132 -2
  3. package/bin/doflow.js +44 -0
  4. package/core/.antigravity-plugin/hooks.json +39 -0
  5. package/core/.antigravity-plugin/mcp_config.json +18 -0
  6. package/core/.antigravity-plugin/plugin.json +31 -0
  7. package/core/.claude-plugin/marketplace.json +20 -0
  8. package/core/.claude-plugin/plugin.json +21 -0
  9. package/core/.codex-plugin/marketplace.json +20 -0
  10. package/core/.codex-plugin/plugin.json +35 -0
  11. package/core/.plugin/plugin.json +19 -0
  12. package/core/harnesses/antigravity/hooks/pre-implementation-gate.sh +9 -0
  13. package/core/harnesses/antigravity/hooks/stop-check.sh +10 -0
  14. package/core/harnesses/claude/hooks/lib.sh +304 -0
  15. package/core/harnesses/claude/hooks/mcp-tool-guard.sh +20 -0
  16. package/core/harnesses/claude/hooks/permission-audit.sh +47 -0
  17. package/core/harnesses/claude/hooks/post-compact.sh +74 -0
  18. package/core/harnesses/claude/hooks/post-edit-lint.sh +36 -0
  19. package/core/harnesses/claude/hooks/post-tool-failure.sh +47 -0
  20. package/core/harnesses/claude/hooks/pre-bash-guard.sh +20 -0
  21. package/core/harnesses/claude/hooks/pre-compact.sh +43 -0
  22. package/core/harnesses/claude/hooks/pre-implement-gate.sh +21 -0
  23. package/core/harnesses/claude/hooks/session-end.sh +89 -0
  24. package/core/harnesses/claude/hooks/session-start.sh +5 -0
  25. package/core/harnesses/claude/hooks/skill-config-audit.sh +39 -0
  26. package/core/harnesses/claude/hooks/stop-check.sh +5 -0
  27. package/core/harnesses/claude/hooks/subagent-audit.sh +7 -0
  28. package/core/harnesses/claude/hooks/user-prompt-submit.sh +5 -0
  29. package/core/harnesses/claude/settings/keybindings.json +20 -0
  30. package/core/harnesses/claude/settings/settings.json +201 -0
  31. package/core/harnesses/claude/statusline/doflow-statusline.sh +49 -0
  32. package/core/harnesses/codex/agents/core-implementer.toml +7 -0
  33. package/core/harnesses/codex/agents/quality-guardian.toml +8 -0
  34. package/core/harnesses/codex/agents/research-writer.toml +8 -0
  35. package/core/harnesses/codex/agents/spec-analyst.toml +8 -0
  36. package/core/harnesses/codex/agents/system-architect.toml +9 -0
  37. package/core/harnesses/codex/config/config.toml +10 -0
  38. package/core/harnesses/codex/hooks/hooks.json +122 -0
  39. package/core/harnesses/codex/hooks/lib.sh +335 -0
  40. package/core/harnesses/codex/hooks/mcp-tool-guard.sh +18 -0
  41. package/core/harnesses/codex/hooks/post-edit-lint.impl.sh +52 -0
  42. package/core/harnesses/codex/hooks/post-edit-lint.sh +6 -0
  43. package/core/harnesses/codex/hooks/pre-bash-guard.sh +18 -0
  44. package/core/harnesses/codex/hooks/pre-compact.impl.sh +46 -0
  45. package/core/harnesses/codex/hooks/pre-compact.sh +9 -0
  46. package/core/harnesses/codex/hooks/pre-implement-gate.sh +19 -0
  47. package/core/harnesses/codex/hooks/session-end.impl.sh +92 -0
  48. package/core/harnesses/codex/hooks/session-end.sh +5 -0
  49. package/core/harnesses/codex/hooks/session-start.sh +5 -0
  50. package/core/harnesses/codex/hooks/stop-check.sh +8 -0
  51. package/core/harnesses/codex/hooks/subagent-audit.sh +8 -0
  52. package/core/harnesses/codex/hooks/user-prompt-submit.sh +6 -0
  53. package/core/harnesses/gemini/hooks/hooks.json +77 -0
  54. package/core/harnesses/gemini/hooks/lib.sh +302 -0
  55. package/core/harnesses/gemini/hooks/mcp-tool-guard.sh +21 -0
  56. package/core/harnesses/gemini/hooks/post-edit-lint.sh +39 -0
  57. package/core/harnesses/gemini/hooks/pre-bash-guard.sh +21 -0
  58. package/core/harnesses/gemini/hooks/pre-compact.sh +38 -0
  59. package/core/harnesses/gemini/hooks/pre-implement-gate.sh +22 -0
  60. package/core/harnesses/gemini/hooks/session-end.impl.sh +89 -0
  61. package/core/harnesses/gemini/hooks/session-end.sh +5 -0
  62. package/core/harnesses/gemini/hooks/session-start.sh +5 -0
  63. package/core/harnesses/gemini/settings/adapter-defaults.json +4 -0
  64. package/core/harnesses/kiro/agents/doflow.json +58 -0
  65. package/core/harnesses/kiro/hooks/doflow.json +53 -0
  66. package/core/harnesses/kiro/hooks/lib.sh +324 -0
  67. package/core/harnesses/kiro/hooks/mcp-tool-guard.sh +9 -0
  68. package/core/harnesses/kiro/hooks/pre-bash-guard.sh +9 -0
  69. package/core/harnesses/kiro/hooks/pre-implement-gate.sh +9 -0
  70. package/core/harnesses/kiro/hooks/session-start.sh +9 -0
  71. package/core/harnesses/kiro/hooks/stop-check.sh +43 -0
  72. package/core/harnesses/shared/hooks/ENVELOPE_MIGRATION.md +39 -0
  73. package/core/harnesses/shared/hooks/adapters/antigravity.js +111 -0
  74. package/core/harnesses/shared/hooks/adapters/arg-fields.js +19 -0
  75. package/core/harnesses/shared/hooks/adapters/gemini.js +114 -0
  76. package/core/harnesses/shared/hooks/hooks.json +47 -0
  77. package/core/harnesses/shared/hooks/policies/blocked-patterns.conf +91 -0
  78. package/core/harnesses/shared/hooks/policies/capture-failure.sh +97 -0
  79. package/core/harnesses/shared/hooks/policies/deny-json.sh +29 -0
  80. package/core/harnesses/shared/hooks/policies/lib.sh +501 -0
  81. package/core/harnesses/shared/hooks/policies/mcp-policy.conf +21 -0
  82. package/core/harnesses/shared/hooks/policies/mcp-tool-guard.sh +91 -0
  83. package/core/harnesses/shared/hooks/policies/pre-bash-guard.sh +328 -0
  84. package/core/harnesses/shared/hooks/policies/pre-implementation-gate.sh +496 -0
  85. package/core/harnesses/shared/hooks/policies/prompt-nudge.jq +131 -0
  86. package/core/harnesses/shared/hooks/policies/session-context.sh +141 -0
  87. package/core/harnesses/shared/hooks/policies/stop-check.sh +264 -0
  88. package/core/harnesses/shared/hooks/policies/subagent-audit.sh +46 -0
  89. package/core/harnesses/shared/hooks/policies/user-prompt-submit.sh +235 -0
  90. package/core/harnesses/shared/hooks/stream-hook-runner.js +590 -0
  91. package/core/harnesses/shared/locator/doflow-run +87 -0
  92. package/core/registry/advice.json +101 -0
  93. package/core/registry/assets.json +792 -0
  94. package/core/registry/capabilities.json +120 -0
  95. package/core/registry/contracts.json +189 -0
  96. package/core/registry/external-tools.json +191 -0
  97. package/core/registry/harnesses.json +2062 -0
  98. package/core/registry/lifecycle.json +231 -0
  99. package/core/registry/mcp.json +18 -0
  100. package/core/registry/models.json +79 -0
  101. package/core/registry/readiness-templates.json +118 -0
  102. package/core/registry/routes.json +47 -0
  103. package/core/registry/storage.json +1057 -0
  104. package/core/registry/verification.json +258 -0
  105. package/core/registry/workflows.json +790 -0
  106. package/core/shared/agent-specs/core-implementer.md +73 -0
  107. package/core/shared/agent-specs/quality-guardian.md +28 -0
  108. package/core/shared/agent-specs/research-writer.md +31 -0
  109. package/core/shared/agent-specs/spec-analyst.md +33 -0
  110. package/core/shared/agent-specs/system-architect.md +29 -0
  111. package/core/shared/guidance/DOFLOW_CORE.md +8 -0
  112. package/core/shared/guidance/FLAGS.md +25 -0
  113. package/core/shared/guidance/PRINCIPLES.md +61 -0
  114. package/core/shared/guidance/VERSION +1 -0
  115. package/core/shared/guidance/mcp/MCP_Context7.md +18 -0
  116. package/core/shared/guidance/mcp/MCP_Sequential.md +17 -0
  117. package/core/shared/guidance/modes/MODE_Brainstorming.md +46 -0
  118. package/core/shared/guidance/modes/MODE_DeepResearch.md +69 -0
  119. package/core/shared/guidance/modes/MODE_Introspection.md +33 -0
  120. package/core/shared/guidance/modes/MODE_Orchestration.md +57 -0
  121. package/core/shared/guidance/modes/MODE_Task_Management.md +74 -0
  122. package/core/shared/guidance/pointers/claude-gemini.md +2 -0
  123. package/core/shared/guidance/pointers/codex.md +6 -0
  124. package/core/shared/guidance/references/ARTIFACT_FORMAT.md +373 -0
  125. package/core/shared/guidance/references/ARTIFACT_VOICE.md +104 -0
  126. package/core/shared/guidance/references/CONSTITUTION_BASE.md +47 -0
  127. package/core/shared/guidance/references/DIAGRAM_GUIDE.md +161 -0
  128. package/core/shared/guidance/references/DOFLOW_CHAIN.md +87 -0
  129. package/core/shared/guidance/references/EVIDENCE_LEDGER.md +93 -0
  130. package/core/shared/guidance/references/MODEL_SELECTION.md +74 -0
  131. package/core/shared/guidance/references/ORCHESTRATION.md +36 -0
  132. package/core/shared/guidance/references/RESEARCH_CONFIG.md +21 -0
  133. package/core/shared/guidance/references/WORKFLOW_HANDOFF.md +81 -0
  134. package/core/shared/guidance/rules/RULE_01_SAFETY.md +25 -0
  135. package/core/shared/guidance/rules/RULE_02_WORKFLOW.md +23 -0
  136. package/core/shared/guidance/rules/RULE_03_QUALITY.md +14 -0
  137. package/core/shared/guidance/rules/RULE_04_QUESTIONS.md +46 -0
  138. package/core/shared/scripts/doflow/assets/mermaid-theme.json +46 -0
  139. package/core/shared/scripts/doflow/bash/do-exec-paths.sh +167 -0
  140. package/core/shared/scripts/doflow/bash/do-git-state.sh +546 -0
  141. package/core/shared/scripts/doflow/bash/do-parallel-check.sh +208 -0
  142. package/core/shared/scripts/doflow/bash/do-paths.sh +347 -0
  143. package/core/shared/scripts/doflow/bash/do-prereqs.sh +66 -0
  144. package/core/shared/scripts/doflow/bash/do-review-package.sh +127 -0
  145. package/core/shared/scripts/doflow/bash/do-task-brief.sh +698 -0
  146. package/core/shared/scripts/doflow/bash/render-audit.sh +224 -0
  147. package/core/shared/scripts/doflow/bash/render-diagrams.sh +177 -0
  148. package/core/shared/scripts/doflow/bash/render-puml.sh +223 -0
  149. package/core/shared/scripts/doflow/bash/sync-context.sh +66 -0
  150. package/core/shared/scripts/doflow/bash/validate-artifacts.sh +526 -0
  151. package/core/shared/scripts/doflow/bin/doflow-run +592 -0
  152. package/core/shared/skills/do/SKILL.md +128 -0
  153. package/core/shared/skills/do/references/estimation.md +13 -0
  154. package/core/shared/skills/do/references/pm_routing.md +25 -0
  155. package/core/shared/skills/do/references/tool_matrix.md +52 -0
  156. package/core/shared/skills/do-brainstorm/SKILL.md +252 -0
  157. package/core/shared/skills/do-code-review/README.md +49 -0
  158. package/core/shared/skills/do-code-review/SKILL.md +333 -0
  159. package/core/shared/skills/do-code-review/assets/sample_c_clean.c +71 -0
  160. package/core/shared/skills/do-code-review/assets/sample_c_smells.c +66 -0
  161. package/core/shared/skills/do-code-review/assets/sample_cpp_shift.cpp +19 -0
  162. package/core/shared/skills/do-code-review/assets/sample_csharp_clean.cs +100 -0
  163. package/core/shared/skills/do-code-review/assets/sample_csharp_smells.cs +78 -0
  164. package/core/shared/skills/do-code-review/assets/sample_java_clean.java +55 -0
  165. package/core/shared/skills/do-code-review/assets/sample_java_smells.java +56 -0
  166. package/core/shared/skills/do-code-review/assets/sample_json_clean.json +7 -0
  167. package/core/shared/skills/do-code-review/assets/sample_markdown_clean.md +30 -0
  168. package/core/shared/skills/do-code-review/assets/sample_markdown_smells.md +29 -0
  169. package/core/shared/skills/do-code-review/assets/sample_shell_heredoc.sh +38 -0
  170. package/core/shared/skills/do-code-review/assets/sample_shell_smells.sh +15 -0
  171. package/core/shared/skills/do-code-review/assets/sample_typescript_strings.ts +36 -0
  172. package/core/shared/skills/do-code-review/assets/sample_yaml_smells.yaml +6 -0
  173. package/core/shared/skills/do-code-review/content-types/config.md +83 -0
  174. package/core/shared/skills/do-code-review/content-types/markdown.md +132 -0
  175. package/core/shared/skills/do-code-review/expected_outputs/sample_c_clean_quality.json +79 -0
  176. package/core/shared/skills/do-code-review/expected_outputs/sample_c_smells_quality.json +169 -0
  177. package/core/shared/skills/do-code-review/expected_outputs/sample_cpp_shift_quality.json +49 -0
  178. package/core/shared/skills/do-code-review/expected_outputs/sample_csharp_clean_quality.json +149 -0
  179. package/core/shared/skills/do-code-review/expected_outputs/sample_csharp_smells_quality.json +157 -0
  180. package/core/shared/skills/do-code-review/expected_outputs/sample_java_clean_quality.json +67 -0
  181. package/core/shared/skills/do-code-review/expected_outputs/sample_java_smells_quality.json +97 -0
  182. package/core/shared/skills/do-code-review/expected_outputs/sample_json_clean_quality.json +33 -0
  183. package/core/shared/skills/do-code-review/expected_outputs/sample_markdown_clean_quality.json +1 -0
  184. package/core/shared/skills/do-code-review/expected_outputs/sample_markdown_smells_quality.json +16 -0
  185. package/core/shared/skills/do-code-review/expected_outputs/sample_shell_heredoc_quality.json +54 -0
  186. package/core/shared/skills/do-code-review/expected_outputs/sample_shell_smells_quality.json +91 -0
  187. package/core/shared/skills/do-code-review/expected_outputs/sample_typescript_strings_quality.json +60 -0
  188. package/core/shared/skills/do-code-review/expected_outputs/sample_yaml_smells_quality.json +46 -0
  189. package/core/shared/skills/do-code-review/languages/c.md +103 -0
  190. package/core/shared/skills/do-code-review/languages/cpp.md +103 -0
  191. package/core/shared/skills/do-code-review/languages/csharp.md +97 -0
  192. package/core/shared/skills/do-code-review/languages/dart.md +108 -0
  193. package/core/shared/skills/do-code-review/languages/go.md +92 -0
  194. package/core/shared/skills/do-code-review/languages/java.md +103 -0
  195. package/core/shared/skills/do-code-review/languages/kotlin.md +88 -0
  196. package/core/shared/skills/do-code-review/languages/php.md +109 -0
  197. package/core/shared/skills/do-code-review/languages/python.md +94 -0
  198. package/core/shared/skills/do-code-review/languages/ruby.md +105 -0
  199. package/core/shared/skills/do-code-review/languages/rust.md +99 -0
  200. package/core/shared/skills/do-code-review/languages/shell.md +90 -0
  201. package/core/shared/skills/do-code-review/languages/swift.md +88 -0
  202. package/core/shared/skills/do-code-review/languages/typescript.md +97 -0
  203. package/core/shared/skills/do-code-review/review-policy.json +47 -0
  204. package/core/shared/skills/do-code-review/rules/universal.md +49 -0
  205. package/core/shared/skills/do-code-review/scripts/code_quality_checker.py +1696 -0
  206. package/core/shared/skills/do-code-review/scripts/doc_quality_checker.py +532 -0
  207. package/core/shared/skills/do-code-review/scripts/pr_analyzer.py +620 -0
  208. package/core/shared/skills/do-code-review/scripts/review_report_generator.py +505 -0
  209. package/core/shared/skills/do-constitution/SKILL.md +72 -0
  210. package/core/shared/skills/do-design/SKILL.md +212 -0
  211. package/core/shared/skills/do-diagnose/SKILL.md +156 -0
  212. package/core/shared/skills/do-diagnose/references/code_audit.md +15 -0
  213. package/core/shared/skills/do-diagnose/references/refactoring.md +12 -0
  214. package/core/shared/skills/do-diagnose/references/root_cause.md +17 -0
  215. package/core/shared/skills/do-document/SKILL.md +81 -0
  216. package/core/shared/skills/do-document/references/api-reference.md +42 -0
  217. package/core/shared/skills/do-document/references/deep_research.md +18 -0
  218. package/core/shared/skills/do-document/references/embedded-research.md +11 -0
  219. package/core/shared/skills/do-document/references/implementation-flow.md +105 -0
  220. package/core/shared/skills/do-document/references/index_generator.md +9 -0
  221. package/core/shared/skills/do-document/references/user-guide.md +22 -0
  222. package/core/shared/skills/do-execute-plan/SKILL.md +261 -0
  223. package/core/shared/skills/do-execute-plan/references/handoff_record.md +57 -0
  224. package/core/shared/skills/do-execute-plan/references/parallel_dispatch.md +92 -0
  225. package/core/shared/skills/do-execute-plan/references/readiness_gate.md +155 -0
  226. package/core/shared/skills/do-execute-plan/references/run_position.md +63 -0
  227. package/core/shared/skills/do-execute-plan/references/scaffold.md +441 -0
  228. package/core/shared/skills/do-execute-plan/references/task_attempts.md +41 -0
  229. package/core/shared/skills/do-flow/SKILL.md +186 -0
  230. package/core/shared/skills/do-flow/references/task_classes.md +134 -0
  231. package/core/shared/skills/do-git/SKILL.md +115 -0
  232. package/core/shared/skills/do-git/references/hotfix-ritual.md +44 -0
  233. package/core/shared/skills/do-git/references/lifecycle-policy.md +54 -0
  234. package/core/shared/skills/do-git/references/release-ritual.md +64 -0
  235. package/core/shared/skills/do-implement/SKILL.md +222 -0
  236. package/core/shared/skills/do-plan/SKILL.md +219 -0
  237. package/core/shared/skills/do-test/SKILL.md +113 -0
  238. package/core/shared/templates/doflow/constitution-template.md +28 -0
  239. package/core/shared/templates/doflow/data-model-template.md +169 -0
  240. package/core/shared/templates/doflow/design-template.md +193 -0
  241. package/core/shared/templates/doflow/external-contract-template.md +35 -0
  242. package/core/shared/templates/doflow/intent-template.md +45 -0
  243. package/core/shared/templates/doflow/plan-template.md +151 -0
  244. package/core/shared/templates/doflow/question-log-template.md +51 -0
  245. package/core/shared/templates/doflow/requirement-template.md +126 -0
  246. package/core/shared/templates/doflow/specs-template.md +55 -0
  247. package/core/shared/templates/doflow/state-template.md +59 -0
  248. package/core/shared/workflows/do-flow-chain.md +17 -0
  249. package/package.json +46 -4
  250. package/src/adapters/antigravity/index.ts +631 -0
  251. package/src/adapters/claude/index.ts +548 -0
  252. package/src/adapters/claude/mcp.ts +94 -0
  253. package/src/adapters/codex/agents.ts +208 -0
  254. package/src/adapters/codex/config.ts +272 -0
  255. package/src/adapters/codex/hooks.ts +203 -0
  256. package/src/adapters/codex/index.ts +707 -0
  257. package/src/adapters/codex/mcp.ts +271 -0
  258. package/src/adapters/codex/native-projection.ts +34 -0
  259. package/src/adapters/copilot/index.ts +413 -0
  260. package/src/adapters/copy-tree.ts +620 -0
  261. package/src/adapters/gemini/hooks.ts +210 -0
  262. package/src/adapters/gemini/index.ts +390 -0
  263. package/src/adapters/hook-commands.ts +60 -0
  264. package/src/adapters/index.ts +106 -0
  265. package/src/adapters/kiro/index.ts +310 -0
  266. package/src/adapters/mcp-entries.ts +331 -0
  267. package/src/adapters/opencode/index.ts +466 -0
  268. package/src/adapters/pi/index.ts +279 -0
  269. package/src/adapters/pi/json-members.ts +185 -0
  270. package/src/adapters/pi/mcp.ts +373 -0
  271. package/src/adapters/resolve-source.ts +19 -0
  272. package/src/cli/commands/install.ts +218 -0
  273. package/src/cli/commands/list-backups.ts +21 -0
  274. package/src/cli/commands/reconcile.ts +120 -0
  275. package/src/cli/commands/remove.ts +82 -0
  276. package/src/cli/commands/rollback.ts +172 -0
  277. package/src/cli/commands/self-update.ts +33 -0
  278. package/src/cli/commands/status.ts +138 -0
  279. package/src/cli/commands/tools.ts +92 -0
  280. package/src/cli/commands/update.ts +162 -0
  281. package/src/cli/index.ts +568 -0
  282. package/src/cli/runtime-commands.ts +281 -0
  283. package/src/cli/shared.ts +218 -0
  284. package/src/helper/bash-helper.ts +34 -0
  285. package/src/helper/git.ts +24 -0
  286. package/src/helper/guardrails.ts +49 -0
  287. package/src/helper/harness-paths.ts +140 -0
  288. package/src/helper/marker-merge.ts +116 -0
  289. package/src/helper/prompt.ts +61 -0
  290. package/src/helper/repo-root.ts +29 -0
  291. package/src/helper/settings-merge.ts +151 -0
  292. package/src/helper/settings-scope.ts +33 -0
  293. package/src/helper/toml.ts +244 -0
  294. package/src/install/backup-set.ts +149 -0
  295. package/src/install/backup.ts +724 -0
  296. package/src/install/context.ts +58 -0
  297. package/src/install/manifest.ts +145 -0
  298. package/src/install/mcp.ts +254 -0
  299. package/src/install/paths.ts +84 -0
  300. package/src/install/targets.ts +90 -0
  301. package/src/install/tool-lifecycle.ts +151 -0
  302. package/src/lifecycle/bash-availability.ts +25 -0
  303. package/src/lifecycle/index.ts +812 -0
  304. package/src/lifecycle/mcp-index.ts +28 -0
  305. package/src/lifecycle/policies.ts +73 -0
  306. package/src/lifecycle/view.ts +175 -0
  307. package/src/registry/index.ts +611 -0
  308. package/src/release/sync-plugin-versions.ts +66 -0
  309. package/src/runtime/advice/cli.ts +283 -0
  310. package/src/runtime/advice/client.ts +324 -0
  311. package/src/runtime/advice/config.ts +189 -0
  312. package/src/runtime/advice/doctor.ts +169 -0
  313. package/src/runtime/advice/endpoint-guard.ts +134 -0
  314. package/src/runtime/advice/kinds.ts +154 -0
  315. package/src/runtime/advice/providers/ollama-systemone.ts +209 -0
  316. package/src/runtime/advice/record.ts +166 -0
  317. package/src/runtime/advice/registry.ts +170 -0
  318. package/src/runtime/advice/strength.ts +66 -0
  319. package/src/runtime/brief-tools.ts +342 -0
  320. package/src/runtime/c4-project.ts +371 -0
  321. package/src/runtime/capability-router.ts +484 -0
  322. package/src/runtime/checkouts.ts +170 -0
  323. package/src/runtime/claims.ts +468 -0
  324. package/src/runtime/cli-result.ts +55 -0
  325. package/src/runtime/cli.ts +678 -0
  326. package/src/runtime/command-detect.ts +516 -0
  327. package/src/runtime/context-pack.ts +492 -0
  328. package/src/runtime/decision-register.ts +493 -0
  329. package/src/runtime/evidence-ledger.ts +338 -0
  330. package/src/runtime/failure/capture.ts +272 -0
  331. package/src/runtime/failure/classifier.ts +68 -0
  332. package/src/runtime/failure/cli.ts +178 -0
  333. package/src/runtime/failure/home.ts +64 -0
  334. package/src/runtime/failure/store.ts +226 -0
  335. package/src/runtime/feature-resolve.ts +79 -0
  336. package/src/runtime/freshness.ts +177 -0
  337. package/src/runtime/health.ts +863 -0
  338. package/src/runtime/history-compactor.ts +237 -0
  339. package/src/runtime/implementation-gate.ts +321 -0
  340. package/src/runtime/inventory/coverage.ts +218 -0
  341. package/src/runtime/inventory/identity.ts +65 -0
  342. package/src/runtime/inventory/index.ts +705 -0
  343. package/src/runtime/inventory/precedence.ts +134 -0
  344. package/src/runtime/inventory/read-scopes.ts +131 -0
  345. package/src/runtime/inventory/siblings.ts +192 -0
  346. package/src/runtime/knowledge/chunker.ts +124 -0
  347. package/src/runtime/knowledge/hybrid.ts +149 -0
  348. package/src/runtime/knowledge/index-store.ts +145 -0
  349. package/src/runtime/knowledge/retrieval.ts +194 -0
  350. package/src/runtime/leak-scan.ts +185 -0
  351. package/src/runtime/lifecycle/cli.ts +276 -0
  352. package/src/runtime/lifecycle/event-store.ts +340 -0
  353. package/src/runtime/lifecycle/fold.ts +353 -0
  354. package/src/runtime/lifecycle/followup.ts +432 -0
  355. package/src/runtime/lifecycle/goal.ts +249 -0
  356. package/src/runtime/lifecycle/intent-writer.ts +86 -0
  357. package/src/runtime/lifecycle/overview.ts +292 -0
  358. package/src/runtime/lifecycle/release.ts +241 -0
  359. package/src/runtime/lifecycle/report-store.ts +221 -0
  360. package/src/runtime/lifecycle/retention.ts +212 -0
  361. package/src/runtime/lifecycle/root.ts +71 -0
  362. package/src/runtime/lifecycle/status.ts +353 -0
  363. package/src/runtime/lifecycle/store-upkeep.ts +393 -0
  364. package/src/runtime/locator-resolve.ts +158 -0
  365. package/src/runtime/mask.ts +210 -0
  366. package/src/runtime/mcp-consultations.ts +412 -0
  367. package/src/runtime/mcp-reach.ts +157 -0
  368. package/src/runtime/model-router.ts +153 -0
  369. package/src/runtime/outcome.ts +467 -0
  370. package/src/runtime/reach.ts +148 -0
  371. package/src/runtime/readiness-record.ts +150 -0
  372. package/src/runtime/readiness.ts +435 -0
  373. package/src/runtime/recovery.ts +282 -0
  374. package/src/runtime/research-request.ts +231 -0
  375. package/src/runtime/retrieval-plan.ts +578 -0
  376. package/src/runtime/scaffold/artifacts.ts +217 -0
  377. package/src/runtime/scaffold/fingerprint.ts +56 -0
  378. package/src/runtime/scaffold/generate.ts +911 -0
  379. package/src/runtime/scaffold/languages.ts +245 -0
  380. package/src/runtime/storage/cli.ts +64 -0
  381. package/src/runtime/storage/engine.ts +249 -0
  382. package/src/runtime/storage/registry.ts +130 -0
  383. package/src/runtime/storage/roots.ts +63 -0
  384. package/src/runtime/storage/rules.ts +282 -0
  385. package/src/runtime/storage/upkeep.ts +243 -0
  386. package/src/runtime/storage/work-status.ts +326 -0
  387. package/src/runtime/task-attempts.ts +415 -0
  388. package/src/runtime/task-classifier.ts +550 -0
  389. package/src/runtime/task-scope.ts +130 -0
  390. package/src/runtime/task-state.ts +176 -0
  391. package/src/runtime/trace/indicators.ts +235 -0
  392. package/src/runtime/trace/ledger.ts +626 -0
  393. package/src/runtime/trace/render.ts +76 -0
  394. package/src/runtime/trace/views.ts +459 -0
  395. package/src/runtime/verification/contract-runner.ts +341 -0
  396. package/src/runtime/verification/engine.ts +1461 -0
  397. package/src/runtime/verification/registry.ts +130 -0
  398. package/src/runtime/verification/scope-bound.ts +418 -0
  399. package/src/runtime/verification/test-selection.ts +172 -0
  400. package/src/runtime/workflow-engine.ts +588 -0
  401. package/src/runtime/workflow-orchestrator.ts +953 -0
  402. package/src/runtime/worktree.ts +340 -0
  403. package/src/state/index.ts +193 -0
  404. package/src/state/lockfile.ts +136 -0
  405. package/src/state/run-lock.ts +408 -0
  406. package/types/node-commonjs.d.ts +68 -0
  407. package/types/runtime.d.ts +91 -0
@@ -0,0 +1,231 @@
1
+ {
2
+ "version": 1,
3
+ "policies": [
4
+ {
5
+ "id": "pre-implementation-gate",
6
+ "intent": "require-implementation-prerequisites",
7
+ "tier": "core",
8
+ "requires": [
9
+ "hooks"
10
+ ],
11
+ "mappings": {
12
+ "claude": {
13
+ "event": "PreToolUse",
14
+ "status": "supported"
15
+ },
16
+ "codex": {
17
+ "event": "PreToolUse",
18
+ "status": "different",
19
+ "prerequisites": [
20
+ "hook-review"
21
+ ]
22
+ },
23
+ "gemini": {
24
+ "event": "BeforeTool",
25
+ "status": "different"
26
+ },
27
+ "opencode": {
28
+ "status": "unavailable",
29
+ "fallback": "guidance"
30
+ },
31
+ "pi": {
32
+ "status": "unavailable",
33
+ "fallback": "guidance"
34
+ },
35
+ "copilot": {
36
+ "status": "unavailable",
37
+ "fallback": "guidance"
38
+ },
39
+ "kiro": {
40
+ "event": "PreToolUse",
41
+ "status": "supported"
42
+ },
43
+ "antigravity": {
44
+ "event": "PreToolUse",
45
+ "status": "supported"
46
+ }
47
+ }
48
+ },
49
+ {
50
+ "id": "pre-bash-guard",
51
+ "intent": "block-destructive-commands",
52
+ "tier": "enhanced",
53
+ "requires": [
54
+ "hooks"
55
+ ],
56
+ "mappings": {
57
+ "claude": {
58
+ "event": "PreToolUse",
59
+ "status": "supported"
60
+ },
61
+ "codex": {
62
+ "event": "PreToolUse",
63
+ "status": "different",
64
+ "prerequisites": [
65
+ "hook-review"
66
+ ]
67
+ },
68
+ "gemini": {
69
+ "event": "BeforeTool",
70
+ "status": "different"
71
+ },
72
+ "opencode": {
73
+ "status": "unavailable",
74
+ "fallback": "guidance"
75
+ },
76
+ "pi": {
77
+ "status": "unavailable",
78
+ "fallback": "guidance"
79
+ },
80
+ "copilot": {
81
+ "status": "unavailable",
82
+ "fallback": "guidance"
83
+ },
84
+ "kiro": {
85
+ "event": "PreToolUse",
86
+ "status": "supported"
87
+ },
88
+ "antigravity": {
89
+ "status": "unavailable",
90
+ "fallback": "guidance"
91
+ }
92
+ }
93
+ },
94
+ {
95
+ "id": "session-context",
96
+ "intent": "capture-session-context",
97
+ "tier": "enhanced",
98
+ "requires": [
99
+ "hooks"
100
+ ],
101
+ "mappings": {
102
+ "claude": {
103
+ "event": "SessionStart",
104
+ "status": "supported"
105
+ },
106
+ "codex": {
107
+ "event": "SessionStart",
108
+ "status": "supported",
109
+ "prerequisites": [
110
+ "hook-review"
111
+ ]
112
+ },
113
+ "gemini": {
114
+ "event": "SessionStart",
115
+ "status": "supported"
116
+ },
117
+ "opencode": {
118
+ "status": "unavailable",
119
+ "fallback": "guidance"
120
+ },
121
+ "pi": {
122
+ "status": "unavailable",
123
+ "fallback": "guidance"
124
+ },
125
+ "copilot": {
126
+ "status": "unavailable",
127
+ "fallback": "guidance"
128
+ },
129
+ "kiro": {
130
+ "event": "SessionStart",
131
+ "status": "supported"
132
+ },
133
+ "antigravity": {
134
+ "status": "unavailable",
135
+ "fallback": "guidance"
136
+ }
137
+ }
138
+ },
139
+ {
140
+ "id": "mcp-tool-guard",
141
+ "intent": "enforce-mcp-policy",
142
+ "tier": "enhanced",
143
+ "requires": [
144
+ "hooks",
145
+ "mcp"
146
+ ],
147
+ "mappings": {
148
+ "claude": {
149
+ "event": "PreToolUse",
150
+ "status": "supported"
151
+ },
152
+ "codex": {
153
+ "event": "PreToolUse",
154
+ "status": "different",
155
+ "prerequisites": [
156
+ "hook-review"
157
+ ]
158
+ },
159
+ "gemini": {
160
+ "event": "BeforeTool",
161
+ "status": "different"
162
+ },
163
+ "opencode": {
164
+ "status": "unavailable",
165
+ "fallback": "guidance"
166
+ },
167
+ "pi": {
168
+ "status": "unavailable",
169
+ "fallback": "guidance"
170
+ },
171
+ "copilot": {
172
+ "status": "unavailable",
173
+ "fallback": "guidance"
174
+ },
175
+ "kiro": {
176
+ "event": "PreToolUse",
177
+ "status": "supported"
178
+ },
179
+ "antigravity": {
180
+ "status": "unavailable",
181
+ "fallback": "guidance"
182
+ }
183
+ }
184
+ },
185
+ {
186
+ "id": "stop-check",
187
+ "intent": "check-completion-before-stop",
188
+ "tier": "enhanced",
189
+ "requires": [
190
+ "hooks"
191
+ ],
192
+ "mappings": {
193
+ "claude": {
194
+ "event": "Stop",
195
+ "status": "supported"
196
+ },
197
+ "codex": {
198
+ "event": "Stop",
199
+ "status": "supported",
200
+ "prerequisites": [
201
+ "hook-review"
202
+ ]
203
+ },
204
+ "gemini": {
205
+ "status": "unavailable",
206
+ "fallback": "guidance"
207
+ },
208
+ "opencode": {
209
+ "status": "unavailable",
210
+ "fallback": "guidance"
211
+ },
212
+ "pi": {
213
+ "status": "unavailable",
214
+ "fallback": "guidance"
215
+ },
216
+ "copilot": {
217
+ "status": "unavailable",
218
+ "fallback": "guidance"
219
+ },
220
+ "kiro": {
221
+ "event": "Stop",
222
+ "status": "supported"
223
+ },
224
+ "antigravity": {
225
+ "event": "Stop",
226
+ "status": "supported"
227
+ }
228
+ }
229
+ }
230
+ ]
231
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "version": 1,
3
+ "servers": [
4
+ {"id": "context7", "transport": "stdio", "command": "npx", "args": ["-y", "@upstash/context7-mcp"], "selection": "optional", "shortFlag": "--c7", "doc": "mcp/MCP_Context7.md",
5
+ "trigger": "The work is about to state, as fact, the behaviour, interface, configuration or version detail of a named library, framework, API, SDK, CLI tool or service.",
6
+ "steps": [
7
+ {"skill": "do-brainstorm", "file": "SKILL.md"},
8
+ {"skill": "do-design", "file": "SKILL.md"},
9
+ {"skill": "do-document", "file": "references/embedded-research.md", "expectedWhen": "research-request"}
10
+ ]},
11
+ {"id": "sequential-thinking", "transport": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"], "selection": "optional", "shortFlag": "--seq", "doc": "mcp/MCP_Sequential.md",
12
+ "trigger": "The work settles a decision with more than one interacting part or competing option and records the choice.",
13
+ "steps": [
14
+ {"skill": "do-brainstorm", "file": "SKILL.md"},
15
+ {"skill": "do-design", "file": "SKILL.md"}
16
+ ]}
17
+ ]
18
+ }
@@ -0,0 +1,79 @@
1
+ {
2
+ "version": 1,
3
+ "providers": [
4
+ {
5
+ "id": "claude",
6
+ "displayName": "Claude Code hosted models",
7
+ "kind": "hosted",
8
+ "evidence": [
9
+ "https://code.claude.com/docs/en/model-config"
10
+ ],
11
+ "tiers": [
12
+ "capable-long",
13
+ "capable"
14
+ ]
15
+ },
16
+ {
17
+ "id": "codex",
18
+ "displayName": "Codex CLI models",
19
+ "kind": "hosted",
20
+ "evidence": [
21
+ "https://learn.chatgpt.com/docs/models"
22
+ ],
23
+ "tiers": [
24
+ "capable",
25
+ "cheap-fast"
26
+ ]
27
+ },
28
+ {
29
+ "id": "copilot",
30
+ "displayName": "GitHub Copilot model catalogue",
31
+ "kind": "hosted",
32
+ "evidence": [
33
+ "https://docs.github.com/en/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat"
34
+ ],
35
+ "tiers": [
36
+ "cheap-fast",
37
+ "capable"
38
+ ]
39
+ },
40
+ {
41
+ "id": "ollama",
42
+ "displayName": "Ollama local models",
43
+ "kind": "local",
44
+ "evidence": [
45
+ "https://ollama.com"
46
+ ],
47
+ "tiers": [
48
+ "cheap-fast"
49
+ ]
50
+ }
51
+ ],
52
+ "dispatchTiers": {
53
+ "tiers": ["light", "standard", "frontier"],
54
+ "default": "standard",
55
+ "byOwner": {
56
+ "system-architect": "frontier",
57
+ "core-implementer": "standard",
58
+ "quality-guardian": "standard",
59
+ "spec-analyst": "standard",
60
+ "research-writer": "standard"
61
+ }
62
+ },
63
+ "roles": [
64
+ {
65
+ "id": "triage",
66
+ "prefer": "cheap-fast",
67
+ "fallback": "any-healthy"
68
+ },
69
+ {
70
+ "id": "reasoning",
71
+ "prefer": "capable-long",
72
+ "fallback": "capable"
73
+ },
74
+ {
75
+ "id": "review",
76
+ "require": "different-family"
77
+ }
78
+ ]
79
+ }
@@ -0,0 +1,118 @@
1
+ {
2
+ "version": 1,
3
+ "templates": {
4
+ "bug": {
5
+ "name": "Bug Fix Readiness",
6
+ "description": "Verifies bug reproduction, affected code locators, supported root-cause claim, blast radius, and regression test plan.",
7
+ "requirements": {
8
+ "reproduction": {
9
+ "description": "Reproduction step or failing test verified by an executed command",
10
+ "required": true,
11
+ "evidenceKinds": ["runtime-observation", "test-result"],
12
+ "requiresObservation": true
13
+ },
14
+ "affected_code": {
15
+ "description": "Exact files and symbols identified with source locators",
16
+ "required": true,
17
+ "evidenceKinds": ["exact-search", "semantic-retrieval"]
18
+ },
19
+ "root_cause": {
20
+ "description": "Root cause claim supported by evidence",
21
+ "required": true,
22
+ "requiresClaimStatus": "supported",
23
+ "requiresClaimRole": "root-cause"
24
+ },
25
+ "blast_radius": {
26
+ "description": "Downstream callers and dependent components mapped",
27
+ "required": true,
28
+ "evidenceKinds": ["structural", "exact-search"]
29
+ },
30
+ "regression_verification": {
31
+ "description": "Targeted verification command or test defined",
32
+ "required": true
33
+ }
34
+ }
35
+ },
36
+ "feature": {
37
+ "name": "Feature Implementation Readiness",
38
+ "description": "Verifies acceptance criteria, affected component mappings, and verification plan.",
39
+ "requirements": {
40
+ "scope_clear": {
41
+ "description": "Acceptance criteria and scope boundaries defined",
42
+ "required": true
43
+ },
44
+ "affected_components": {
45
+ "description": "Target components and integration points identified",
46
+ "required": true,
47
+ "evidenceKinds": ["structural", "semantic-retrieval"]
48
+ },
49
+ "verification_plan": {
50
+ "description": "Test execution plan and assertions established",
51
+ "required": true
52
+ }
53
+ }
54
+ },
55
+ "refactor": {
56
+ "name": "Refactoring Readiness",
57
+ "description": "Verifies structural call graphs, behavioral invariants, baseline green tests, and blast radius.",
58
+ "requirements": {
59
+ "architecture_mapped": {
60
+ "description": "Current architecture and call graphs mapped",
61
+ "required": true,
62
+ "evidenceKinds": ["structural"]
63
+ },
64
+ "invariants_captured": {
65
+ "description": "Structural and behavioral invariants identified",
66
+ "required": true
67
+ },
68
+ "baseline_tests": {
69
+ "description": "Baseline test suite passing prior to edits, established by an executed run exiting 0",
70
+ "required": true,
71
+ "evidenceKinds": ["test-result"],
72
+ "requiresObservation": true,
73
+ "expectedExit": "zero"
74
+ },
75
+ "blast_radius": {
76
+ "description": "Affected dependents mapped",
77
+ "required": true,
78
+ "evidenceKinds": ["structural", "exact-search"]
79
+ }
80
+ }
81
+ },
82
+ "trivial-edit": {
83
+ "name": "Trivial Edit Readiness",
84
+ "description": "Verifies target file/symbol locator and isolated single-file scope.",
85
+ "requirements": {
86
+ "target_identified": {
87
+ "description": "Target file and exact line locator identified",
88
+ "required": true,
89
+ "evidenceKinds": ["exact-search"]
90
+ },
91
+ "scope_verified": {
92
+ "description": "Single-file scope verified without cascading dependents",
93
+ "required": true
94
+ }
95
+ }
96
+ },
97
+ "dependency-change": {
98
+ "name": "Dependency Change Readiness",
99
+ "description": "Verifies upstream release notes, repository usage impact, and build verification commands.",
100
+ "requirements": {
101
+ "compatibility_checked": {
102
+ "description": "Upstream release notes and breaking changes reviewed",
103
+ "required": true,
104
+ "evidenceKinds": ["documentation"]
105
+ },
106
+ "usage_impact": {
107
+ "description": "All repository usages of dependency mapped",
108
+ "required": true,
109
+ "evidenceKinds": ["exact-search", "structural"]
110
+ },
111
+ "verification_command": {
112
+ "description": "Build and test verification commands established",
113
+ "required": true
114
+ }
115
+ }
116
+ }
117
+ }
118
+ }
@@ -0,0 +1,47 @@
1
+ {
2
+ "version": 1,
3
+ "routes": {
4
+ "locate-known-symbol": {
5
+ "description": "Locate definition or occurrences of a known identifier or path.",
6
+ "capability": "code.exact-search",
7
+ "fallback": []
8
+ },
9
+ "locate-concept": {
10
+ "description": "Find implementation of an abstract feature or business logic.",
11
+ "capability": "code.semantic-search",
12
+ "fallback": [
13
+ "code.exact-search"
14
+ ]
15
+ },
16
+ "trace-dependency": {
17
+ "description": "Trace callers, callees, or module dependencies.",
18
+ "capability": "code.relationships",
19
+ "fallback": [
20
+ "code.exact-search"
21
+ ]
22
+ },
23
+ "estimate-blast-radius": {
24
+ "description": "Assess downstream impact of modifying a symbol or file.",
25
+ "capability": "code.impact-analysis",
26
+ "fallback": [
27
+ "code.relationships",
28
+ "code.exact-search"
29
+ ]
30
+ },
31
+ "inspect-history": {
32
+ "description": "Understand why code was changed or view recent commits.",
33
+ "capability": "history.search",
34
+ "fallback": []
35
+ },
36
+ "verify-runtime-behavior": {
37
+ "description": "Verify behavior against unit, integration, or regression tests.",
38
+ "capability": "behavior.verify",
39
+ "fallback": []
40
+ },
41
+ "compress-command": {
42
+ "description": "Execute large-output CLI command with token compression.",
43
+ "capability": "command.compress",
44
+ "fallback": []
45
+ }
46
+ }
47
+ }