@jtf19/vibecoding-kit 0.1.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 (619) hide show
  1. package/AGENTS.md +84 -0
  2. package/CHANGELOG.md +28 -0
  3. package/CLAUDE.md +137 -0
  4. package/CODE_OF_CONDUCT.md +30 -0
  5. package/CONTRIBUTING.md +69 -0
  6. package/LICENSE +67 -0
  7. package/README.md +162 -0
  8. package/SECURITY.md +34 -0
  9. package/adapters/claude/install.md +70 -0
  10. package/adapters/claude/plugin.json +38 -0
  11. package/adapters/claude/settings.example.json +15 -0
  12. package/adapters/codex/hooks.example.json +15 -0
  13. package/adapters/codex/install.md +72 -0
  14. package/adapters/codex/plugin.json +58 -0
  15. package/adapters/cursor/hooks.example.json +17 -0
  16. package/adapters/cursor/install.md +72 -0
  17. package/adapters/cursor/plugin.json +42 -0
  18. package/adapters/opencode/install.md +95 -0
  19. package/adapters/opencode/plugin.js +56 -0
  20. package/adapters/opencode/plugin.json +58 -0
  21. package/adapters/pi/extension.ts +56 -0
  22. package/adapters/pi/install.md +95 -0
  23. package/adapters/pi/plugin.json +58 -0
  24. package/bin/vibe-cli-usage.mjs +43 -0
  25. package/bin/vibe.mjs +120 -0
  26. package/docs/acceptance-checklist.md +1226 -0
  27. package/docs/architecture-debt-burndown.md +537 -0
  28. package/docs/architecture.md +77 -0
  29. package/docs/ci-evidence-onboarding.md +143 -0
  30. package/docs/development.md +71 -0
  31. package/docs/evidence-authoring.md +188 -0
  32. package/docs/golden-path.md +179 -0
  33. package/docs/install-acceptance-checklist.md +90 -0
  34. package/docs/install-claude.md +41 -0
  35. package/docs/install-codex.md +41 -0
  36. package/docs/install-cursor.md +41 -0
  37. package/docs/install-experience-roadmap.md +394 -0
  38. package/docs/install.md +119 -0
  39. package/docs/maintainer-guide.md +197 -0
  40. package/docs/phase-1-implementation.md +848 -0
  41. package/docs/phase-2-roadmap.md +142 -0
  42. package/docs/quick-recipes.md +115 -0
  43. package/docs/readiness-interpretation.md +105 -0
  44. package/docs/readiness-troubleshooting.md +209 -0
  45. package/docs/release-check-reference.md +63 -0
  46. package/docs/release-guide.md +481 -0
  47. package/docs/release-notes.md +75 -0
  48. package/docs/runtime-contract.md +1010 -0
  49. package/docs/runtime-maintainer-validation.md +212 -0
  50. package/docs/runtime-roadmap.md +2265 -0
  51. package/docs/skill-authoring-guide.md +150 -0
  52. package/docs/submodule-guide.md +131 -0
  53. package/docs/team-adoption.md +113 -0
  54. package/docs/user-guide.md +108 -0
  55. package/docs/vibecoding-fork-analysis.md +398 -0
  56. package/docs/workflow-chaining.md +539 -0
  57. package/examples/ci/README.md +61 -0
  58. package/examples/ci/ci-evidence-input.example.json +56 -0
  59. package/examples/ci/generate-diff-coverage.mjs +90 -0
  60. package/examples/ci/generate-test-evidence.mjs +82 -0
  61. package/examples/ci/github-actions-readiness.yml +108 -0
  62. package/examples/claude-project/README.md +57 -0
  63. package/examples/codex-project/README.md +57 -0
  64. package/examples/cursor-project/README.md +57 -0
  65. package/examples/full-chain/README.md +63 -0
  66. package/examples/full-chain/architecture-design.md +128 -0
  67. package/examples/full-chain/commit-readiness.json +31 -0
  68. package/examples/full-chain/delivery-traceability.yaml +32 -0
  69. package/examples/full-chain/diff-coverage.json +73 -0
  70. package/examples/full-chain/evidence.json +20 -0
  71. package/examples/full-chain/implementation-plan.md +54 -0
  72. package/examples/full-chain/product-acceptance.md +86 -0
  73. package/examples/full-chain/product-discovery.md +84 -0
  74. package/examples/full-chain/product-spec.md +88 -0
  75. package/examples/full-chain/scenario-acceptance.yaml +32 -0
  76. package/examples/full-chain/test-evidence.json +29 -0
  77. package/examples/full-chain/ui-design-contract.md +87 -0
  78. package/examples/golden-path/README.md +84 -0
  79. package/examples/golden-path/diff-coverage.json +66 -0
  80. package/examples/golden-path/implementation-plan.md +62 -0
  81. package/examples/golden-path/product-spec.md +96 -0
  82. package/examples/golden-path/test-evidence.json +29 -0
  83. package/examples/runtime-fixtures/architecture-design.md +128 -0
  84. package/examples/runtime-fixtures/commit-readiness.json +31 -0
  85. package/examples/runtime-fixtures/delivery-traceability.yaml +32 -0
  86. package/examples/runtime-fixtures/diff-coverage.json +73 -0
  87. package/examples/runtime-fixtures/evidence.json +20 -0
  88. package/examples/runtime-fixtures/implementation-plan.md +54 -0
  89. package/examples/runtime-fixtures/negative/commit-readiness-boundary-escalated.json +27 -0
  90. package/examples/runtime-fixtures/negative/delivery-traceability-bad-ref.yaml +32 -0
  91. package/examples/runtime-fixtures/negative/diff-coverage-changed-file-without-task-ref.json +40 -0
  92. package/examples/runtime-fixtures/negative/diff-coverage-operation-mismatch.json +38 -0
  93. package/examples/runtime-fixtures/negative/diff-coverage-required-task-missing.json +24 -0
  94. package/examples/runtime-fixtures/negative/diff-coverage-unexpected-file.json +20 -0
  95. package/examples/runtime-fixtures/negative/test-evidence-missing-output-digest.json +23 -0
  96. package/examples/runtime-fixtures/negative/test-evidence-risky-task-missing.json +29 -0
  97. package/examples/runtime-fixtures/product-acceptance.md +86 -0
  98. package/examples/runtime-fixtures/product-discovery.md +84 -0
  99. package/examples/runtime-fixtures/product-spec.md +88 -0
  100. package/examples/runtime-fixtures/scenario-acceptance.yaml +32 -0
  101. package/examples/runtime-fixtures/test-evidence.json +29 -0
  102. package/examples/runtime-fixtures/ui-design-contract.md +87 -0
  103. package/hooks/post-tool-compact/README.md +47 -0
  104. package/hooks/session-start/README.md +112 -0
  105. package/hooks/session-start/session-start-state-boundary-contract.mjs +161 -0
  106. package/hooks/session-start/session-start.md +29 -0
  107. package/hooks/session-start/session-start.mjs +49 -0
  108. package/hooks/workflow-handoff/README.md +44 -0
  109. package/hooks/workflow-handoff/workflow-handoff.md +11 -0
  110. package/package.json +72 -0
  111. package/skills/using-vibecoding/SKILL.md +396 -0
  112. package/skills/vibe-brainstorming/SKILL.md +98 -0
  113. package/skills/vibe-context-compact/SKILL.md +95 -0
  114. package/skills/vibe-debugging/SKILL.md +87 -0
  115. package/skills/vibe-dispatching-parallel-work/SKILL.md +144 -0
  116. package/skills/vibe-executing-plans/SKILL.md +114 -0
  117. package/skills/vibe-finishing-a-development-branch/SKILL.md +110 -0
  118. package/skills/vibe-implementation/SKILL.md +84 -0
  119. package/skills/vibe-planning/SKILL.md +102 -0
  120. package/skills/vibe-product-acceptance/SKILL.md +106 -0
  121. package/skills/vibe-product-discovery/SKILL.md +107 -0
  122. package/skills/vibe-product-spec/SKILL.md +105 -0
  123. package/skills/vibe-receiving-code-review/SKILL.md +110 -0
  124. package/skills/vibe-requesting-code-review/SKILL.md +106 -0
  125. package/skills/vibe-review/SKILL.md +106 -0
  126. package/skills/vibe-subagent-driven-development/SKILL.md +198 -0
  127. package/skills/vibe-systematic-debugging/SKILL.md +106 -0
  128. package/skills/vibe-test-driven-development/SKILL.md +112 -0
  129. package/skills/vibe-ui-design/SKILL.md +107 -0
  130. package/skills/vibe-verification/SKILL.md +84 -0
  131. package/skills/vibe-verification-before-completion/SKILL.md +170 -0
  132. package/skills/vibe-workspace-isolation/SKILL.md +158 -0
  133. package/skills/vibe-writing-plans/SKILL.md +137 -0
  134. package/skills/vibe-writing-skills/SKILL.md +118 -0
  135. package/templates/AGENTS.md +88 -0
  136. package/templates/CLAUDE.md +88 -0
  137. package/templates/VIBE-CODING.md +157 -0
  138. package/templates/architecture-design.md +139 -0
  139. package/templates/delivery-traceability.yaml +52 -0
  140. package/templates/evidence/README.md +117 -0
  141. package/templates/evidence/diff-coverage.json +34 -0
  142. package/templates/evidence/test-evidence.json +29 -0
  143. package/templates/implementation-plan.md +73 -0
  144. package/templates/product-acceptance.md +84 -0
  145. package/templates/product-discovery.md +81 -0
  146. package/templates/product-spec.md +84 -0
  147. package/templates/scenario-acceptance.yaml +37 -0
  148. package/templates/ui-design-contract.md +86 -0
  149. package/tools/vibe-architecture-check/README.md +66 -0
  150. package/tools/vibe-architecture-check/index.mjs +691 -0
  151. package/tools/vibe-compact/README.md +65 -0
  152. package/tools/vibe-compact/compact-contract.mjs +63 -0
  153. package/tools/vibe-compact/index.mjs +111 -0
  154. package/tools/vibe-doctor/README.md +200 -0
  155. package/tools/vibe-doctor/index.mjs +1721 -0
  156. package/tools/vibe-init/README.md +231 -0
  157. package/tools/vibe-init/index.mjs +369 -0
  158. package/tools/vibe-init/init-cli-args.mjs +100 -0
  159. package/tools/vibe-init/init-entry-merge-model.mjs +33 -0
  160. package/tools/vibe-init/init-install-manifest-model.mjs +137 -0
  161. package/tools/vibe-init/init-installed-agent-experience-contract.mjs +172 -0
  162. package/tools/vibe-init/init-platform-model.mjs +11 -0
  163. package/tools/vibe-init/init-presentation.mjs +149 -0
  164. package/tools/vibe-lifecycle/README.md +37 -0
  165. package/tools/vibe-lifecycle/index.mjs +365 -0
  166. package/tools/vibe-lifecycle/lifecycle-cli-args.mjs +104 -0
  167. package/tools/vibe-lifecycle/lifecycle-summary-model.mjs +67 -0
  168. package/tools/vibe-lifecycle/lifecycle-uninstall-plan-model.mjs +11 -0
  169. package/tools/vibe-plugin-pack/README.md +105 -0
  170. package/tools/vibe-plugin-pack/index.mjs +302 -0
  171. package/tools/vibe-plugin-pack/plugin-pack-cli.mjs +39 -0
  172. package/tools/vibe-plugin-pack/plugin-pack-manifest.mjs +37 -0
  173. package/tools/vibe-profile/index.mjs +212 -0
  174. package/tools/vibe-release-check/README.md +123 -0
  175. package/tools/vibe-release-check/command-manifest/release-check-base-commands.mjs +23 -0
  176. package/tools/vibe-release-check/command-manifest/release-check-closeout-commands.mjs +16 -0
  177. package/tools/vibe-release-check/command-manifest/release-check-command-metadata.mjs +32 -0
  178. package/tools/vibe-release-check/command-manifest/release-check-completion-commands.mjs +41 -0
  179. package/tools/vibe-release-check/command-manifest/release-check-full-chain-commands.mjs +12 -0
  180. package/tools/vibe-release-check/command-manifest/release-check-golden-path-commands.mjs +12 -0
  181. package/tools/vibe-release-check/command-manifest/release-check-install-commands.mjs +26 -0
  182. package/tools/vibe-release-check/command-manifest/release-check-learning-smoke-commands.mjs +21 -0
  183. package/tools/vibe-release-check/command-manifest/release-check-methodology-commands.mjs +27 -0
  184. package/tools/vibe-release-check/command-manifest/release-check-runtime-smoke-commands.mjs +116 -0
  185. package/tools/vibe-release-check/command-manifest/release-check-token-smoke-commands.mjs +21 -0
  186. package/tools/vibe-release-check/index.mjs +223 -0
  187. package/tools/vibe-release-check/release-check-behavior-smoke.mjs +177 -0
  188. package/tools/vibe-release-check/release-check-cli.mjs +37 -0
  189. package/tools/vibe-release-check/release-check-command-manifest.mjs +49 -0
  190. package/tools/vibe-release-check/release-check-completion-fixtures.mjs +151 -0
  191. package/tools/vibe-release-check/release-check-completion-suite.mjs +110 -0
  192. package/tools/vibe-release-check/release-check-dispatch.mjs +116 -0
  193. package/tools/vibe-release-check/release-check-full-chain-suite.mjs +55 -0
  194. package/tools/vibe-release-check/release-check-golden-path-suite.mjs +85 -0
  195. package/tools/vibe-release-check/release-check-install-marker-specs.mjs +133 -0
  196. package/tools/vibe-release-check/release-check-install-suite.mjs +112 -0
  197. package/tools/vibe-release-check/release-check-json-assertion-helpers.mjs +157 -0
  198. package/tools/vibe-release-check/release-check-json-markers.mjs +33 -0
  199. package/tools/vibe-release-check/release-check-learning-fixture-specs.mjs +199 -0
  200. package/tools/vibe-release-check/release-check-learning-suite.mjs +249 -0
  201. package/tools/vibe-release-check/release-check-live-behavior-smoke-fixture.mjs +406 -0
  202. package/tools/vibe-release-check/release-check-methodology-suite.mjs +108 -0
  203. package/tools/vibe-release-check/release-check-package-boundary-smoke.mjs +111 -0
  204. package/tools/vibe-release-check/release-check-platform-transcript-smoke-fixture.mjs +150 -0
  205. package/tools/vibe-release-check/release-check-readonly-marker-data.mjs +1 -0
  206. package/tools/vibe-release-check/release-check-readonly-marker-smoke-specs.mjs +170 -0
  207. package/tools/vibe-release-check/release-check-run-summary.mjs +67 -0
  208. package/tools/vibe-release-check/release-check-runtime-automation-fixtures.mjs +1 -0
  209. package/tools/vibe-release-check/release-check-runtime-automation-governance-reply-trace-smoke-helpers.mjs +224 -0
  210. package/tools/vibe-release-check/release-check-runtime-automation-governance-smoke-specs.mjs +215 -0
  211. package/tools/vibe-release-check/release-check-runtime-automation-governance-suite.mjs +5 -0
  212. package/tools/vibe-release-check/release-check-runtime-automation-methodology-smoke-specs.mjs +157 -0
  213. package/tools/vibe-release-check/release-check-runtime-automation-methodology-suite.mjs +130 -0
  214. package/tools/vibe-release-check/release-check-runtime-automation-platform-smoke-helpers.mjs +306 -0
  215. package/tools/vibe-release-check/release-check-runtime-automation-platform-suite.mjs +30 -0
  216. package/tools/vibe-release-check/release-check-runtime-automation-smoke-fixtures.mjs +53 -0
  217. package/tools/vibe-release-check/release-check-runtime-automation-source-candidate-smoke-helpers.mjs +506 -0
  218. package/tools/vibe-release-check/release-check-runtime-automation-source-suite.mjs +5 -0
  219. package/tools/vibe-release-check/release-check-runtime-automation-subagents-lifecycle-smoke-helpers.mjs +305 -0
  220. package/tools/vibe-release-check/release-check-runtime-automation-subagents-suite.mjs +25 -0
  221. package/tools/vibe-release-check/release-check-runtime-automation-suite.mjs +25 -0
  222. package/tools/vibe-release-check/release-check-runtime-daemon-bounded-run-smoke-helpers.mjs +243 -0
  223. package/tools/vibe-release-check/release-check-runtime-daemon-suite.mjs +5 -0
  224. package/tools/vibe-release-check/release-check-runtime-dispatch-fixtures.mjs +129 -0
  225. package/tools/vibe-release-check/release-check-runtime-dispatch-suite.mjs +5 -0
  226. package/tools/vibe-release-check/release-check-runtime-execution-approval-smoke-helpers.mjs +274 -0
  227. package/tools/vibe-release-check/release-check-runtime-execution-approval-suite.mjs +5 -0
  228. package/tools/vibe-release-check/release-check-runtime-execution-base-suite.mjs +388 -0
  229. package/tools/vibe-release-check/release-check-runtime-execution-recovery-suite.mjs +412 -0
  230. package/tools/vibe-release-check/release-check-runtime-execution-scheduler-suite.mjs +261 -0
  231. package/tools/vibe-release-check/release-check-runtime-execution-suite.mjs +11 -0
  232. package/tools/vibe-release-check/release-check-runtime-flow-smoke.mjs +347 -0
  233. package/tools/vibe-release-check/release-check-runtime-handoff-fixture-specs.mjs +211 -0
  234. package/tools/vibe-release-check/release-check-runtime-handoff-fixtures.mjs +11 -0
  235. package/tools/vibe-release-check/release-check-runtime-handoff-smoke-specs.mjs +86 -0
  236. package/tools/vibe-release-check/release-check-runtime-handoff-suite.mjs +316 -0
  237. package/tools/vibe-release-check/release-check-runtime-ledger-fixture-specs.mjs +9 -0
  238. package/tools/vibe-release-check/release-check-runtime-ledger-fixtures.mjs +51 -0
  239. package/tools/vibe-release-check/release-check-runtime-ledger-suite.mjs +24 -0
  240. package/tools/vibe-release-check/release-check-runtime-scheduler-fixture-specs.mjs +129 -0
  241. package/tools/vibe-release-check/release-check-runtime-scheduler-fixtures.mjs +10 -0
  242. package/tools/vibe-release-check/release-check-runtime-sdd-suite.mjs +535 -0
  243. package/tools/vibe-release-check/release-check-runtime-smoke-harness.mjs +140 -0
  244. package/tools/vibe-release-check/release-check-runtime-surface-expectations.mjs +106 -0
  245. package/tools/vibe-release-check/release-check-runtime-surface-smoke.mjs +112 -0
  246. package/tools/vibe-release-check/release-check-runtime-task-artifact-suite.mjs +105 -0
  247. package/tools/vibe-release-check/release-check-runtime-task-fixture-specs.mjs +270 -0
  248. package/tools/vibe-release-check/release-check-runtime-task-fixtures.mjs +19 -0
  249. package/tools/vibe-release-check/release-check-runtime.mjs +53 -0
  250. package/tools/vibe-release-check/release-check-stage103-118-fixtures.mjs +214 -0
  251. package/tools/vibe-release-check/release-check-stage103-118-smoke-specs.mjs +97 -0
  252. package/tools/vibe-release-check/release-check-stage103-118-smoke.mjs +861 -0
  253. package/tools/vibe-release-check/release-check-stage11-smoke.mjs +66 -0
  254. package/tools/vibe-release-check/release-check-stage119-120-fixture-specs.mjs +119 -0
  255. package/tools/vibe-release-check/release-check-stage119-120-smoke.mjs +325 -0
  256. package/tools/vibe-release-check/release-check-stage12-smoke.mjs +59 -0
  257. package/tools/vibe-release-check/release-check-stage121-136-fixture-specs.mjs +26 -0
  258. package/tools/vibe-release-check/release-check-stage121-136-fixtures.mjs +591 -0
  259. package/tools/vibe-release-check/release-check-stage121-136-smoke.mjs +917 -0
  260. package/tools/vibe-release-check/release-check-stage13-smoke.mjs +78 -0
  261. package/tools/vibe-release-check/release-check-stage137-140-smoke.mjs +534 -0
  262. package/tools/vibe-release-check/release-check-stage14-smoke.mjs +101 -0
  263. package/tools/vibe-release-check/release-check-stage141-148-smoke.mjs +1143 -0
  264. package/tools/vibe-release-check/release-check-stage15-smoke.mjs +132 -0
  265. package/tools/vibe-release-check/release-check-stage50-53-smoke.mjs +429 -0
  266. package/tools/vibe-release-check/release-check-subagent-adapter-bridge-smoke.mjs +162 -0
  267. package/tools/vibe-release-check/release-check-suite-plan-smoke.mjs +86 -0
  268. package/tools/vibe-release-check/release-check-suites.mjs +164 -0
  269. package/tools/vibe-release-check/release-check-test-run-smoke.mjs +59 -0
  270. package/tools/vibe-release-check/release-check-timing.mjs +98 -0
  271. package/tools/vibe-release-check/release-check-token-suite.mjs +260 -0
  272. package/tools/vibe-release-check/release-check-workflow-entry-suite.mjs +195 -0
  273. package/tools/vibe-release-check/release-check-workflow-governance-fixtures.mjs +138 -0
  274. package/tools/vibe-release-check/release-check-workflow-governance-smoke-suite.mjs +768 -0
  275. package/tools/vibe-release-check/release-check-workflow-ux-smoke.mjs +456 -0
  276. package/tools/vibe-runtime/README.md +2637 -0
  277. package/tools/vibe-runtime/index.mjs +3117 -0
  278. package/tools/vibe-runtime/runtime-adapter-bootstrap-matrix.mjs +264 -0
  279. package/tools/vibe-runtime/runtime-adapter-entry-acceptance.mjs +310 -0
  280. package/tools/vibe-runtime/runtime-adapter-packaging-consistency-command.mjs +131 -0
  281. package/tools/vibe-runtime/runtime-adapter-packaging-consistency.mjs +253 -0
  282. package/tools/vibe-runtime/runtime-advice-hub-model.mjs +175 -0
  283. package/tools/vibe-runtime/runtime-agent-session-start-contract.mjs +138 -0
  284. package/tools/vibe-runtime/runtime-artifact-ref-validation.mjs +281 -0
  285. package/tools/vibe-runtime/runtime-automatic-verification-gate-contract.mjs +134 -0
  286. package/tools/vibe-runtime/runtime-automation-boundary-text.mjs +7 -0
  287. package/tools/vibe-runtime/runtime-automation-command.mjs +367 -0
  288. package/tools/vibe-runtime/runtime-automation-plan-model.mjs +239 -0
  289. package/tools/vibe-runtime/runtime-automation-policy-model.mjs +175 -0
  290. package/tools/vibe-runtime/runtime-automation-readiness.mjs +347 -0
  291. package/tools/vibe-runtime/runtime-autopilot-lab-profile-contract.mjs +223 -0
  292. package/tools/vibe-runtime/runtime-behavioral-evaluation-contract.mjs +529 -0
  293. package/tools/vibe-runtime/runtime-behavioral-negative-gate-matrix.mjs +274 -0
  294. package/tools/vibe-runtime/runtime-bounded-attempt-policy-model.mjs +13 -0
  295. package/tools/vibe-runtime/runtime-bounded-foreground-command-executor-contract.mjs +288 -0
  296. package/tools/vibe-runtime/runtime-capability-registry.mjs +250 -0
  297. package/tools/vibe-runtime/runtime-cli-args.mjs +550 -0
  298. package/tools/vibe-runtime/runtime-cli-command-specs.mjs +63 -0
  299. package/tools/vibe-runtime/runtime-cli-dispatch.mjs +21 -0
  300. package/tools/vibe-runtime/runtime-cli-evidence-option-specs.mjs +193 -0
  301. package/tools/vibe-runtime/runtime-cli-evidence-options.mjs +28 -0
  302. package/tools/vibe-runtime/runtime-cli-from-options.mjs +222 -0
  303. package/tools/vibe-runtime/runtime-cli-low-risk-option-specs.mjs +128 -0
  304. package/tools/vibe-runtime/runtime-cli-main.mjs +32 -0
  305. package/tools/vibe-runtime/runtime-cli-option-default-families.mjs +454 -0
  306. package/tools/vibe-runtime/runtime-cli-option-defaults.mjs +33 -0
  307. package/tools/vibe-runtime/runtime-cli-option-handlers.mjs +82 -0
  308. package/tools/vibe-runtime/runtime-cli-usage.mjs +316 -0
  309. package/tools/vibe-runtime/runtime-cli-value-options.mjs +74 -0
  310. package/tools/vibe-runtime/runtime-close-loop-dashboard.mjs +283 -0
  311. package/tools/vibe-runtime/runtime-closeout-parity-contract.mjs +214 -0
  312. package/tools/vibe-runtime/runtime-command-container.mjs +26 -0
  313. package/tools/vibe-runtime/runtime-command-surface-registry.mjs +383 -0
  314. package/tools/vibe-runtime/runtime-command-wrapper-deps.mjs +13 -0
  315. package/tools/vibe-runtime/runtime-commit-readiness-envelope.mjs +281 -0
  316. package/tools/vibe-runtime/runtime-completion-boundary-text.mjs +7 -0
  317. package/tools/vibe-runtime/runtime-completion-bundle-contract.mjs +71 -0
  318. package/tools/vibe-runtime/runtime-completion-chain-assembly.mjs +48 -0
  319. package/tools/vibe-runtime/runtime-completion-command.mjs +50 -0
  320. package/tools/vibe-runtime/runtime-completion-evidence-bundle.mjs +269 -0
  321. package/tools/vibe-runtime/runtime-completion-evidence-descriptors.mjs +156 -0
  322. package/tools/vibe-runtime/runtime-completion-local-evidence-gates.mjs +164 -0
  323. package/tools/vibe-runtime/runtime-completion-presentation.mjs +71 -0
  324. package/tools/vibe-runtime/runtime-completion-readiness-summary.mjs +159 -0
  325. package/tools/vibe-runtime/runtime-confirmed-one-shot-plan.mjs +300 -0
  326. package/tools/vibe-runtime/runtime-context-budget-entry-defaults-command.mjs +77 -0
  327. package/tools/vibe-runtime/runtime-context-budget-entry-defaults.mjs +341 -0
  328. package/tools/vibe-runtime/runtime-contract-marker-registry.mjs +13 -0
  329. package/tools/vibe-runtime/runtime-contributor-guardrail-command.mjs +78 -0
  330. package/tools/vibe-runtime/runtime-contributor-guardrail-evidence.mjs +319 -0
  331. package/tools/vibe-runtime/runtime-control-plane-command.mjs +237 -0
  332. package/tools/vibe-runtime/runtime-control-plane-evals-artifacts.mjs +123 -0
  333. package/tools/vibe-runtime/runtime-control-plane-evals-boundary-model.mjs +75 -0
  334. package/tools/vibe-runtime/runtime-control-plane-evals-cases.mjs +547 -0
  335. package/tools/vibe-runtime/runtime-control-plane-evals-command.mjs +527 -0
  336. package/tools/vibe-runtime/runtime-control-plane-evals-report-validation.mjs +209 -0
  337. package/tools/vibe-runtime/runtime-control-plane-planner-artifacts.mjs +457 -0
  338. package/tools/vibe-runtime/runtime-control-plane-planning-command.mjs +563 -0
  339. package/tools/vibe-runtime/runtime-control-plane-planning-input.mjs +99 -0
  340. package/tools/vibe-runtime/runtime-control-plane-planning-listing.mjs +48 -0
  341. package/tools/vibe-runtime/runtime-control-plane-planning-presentation.mjs +246 -0
  342. package/tools/vibe-runtime/runtime-control-plane-planning-validation.mjs +529 -0
  343. package/tools/vibe-runtime/runtime-control-plane-readonly-command.mjs +537 -0
  344. package/tools/vibe-runtime/runtime-control-plane-readonly-deps.mjs +146 -0
  345. package/tools/vibe-runtime/runtime-control-plane-release-evidence.mjs +525 -0
  346. package/tools/vibe-runtime/runtime-control-plane-release-gates.mjs +369 -0
  347. package/tools/vibe-runtime/runtime-control-plane-router-planning-model.mjs +152 -0
  348. package/tools/vibe-runtime/runtime-control-plane-routing-artifacts.mjs +588 -0
  349. package/tools/vibe-runtime/runtime-controlled-change-delivery-contract.mjs +165 -0
  350. package/tools/vibe-runtime/runtime-controlled-execution-gate-contract.mjs +141 -0
  351. package/tools/vibe-runtime/runtime-controlled-long-running-automation-contract.mjs +184 -0
  352. package/tools/vibe-runtime/runtime-controlled-subagent-orchestration-contract.mjs +169 -0
  353. package/tools/vibe-runtime/runtime-daemon-command.mjs +166 -0
  354. package/tools/vibe-runtime/runtime-daemon-state-lifecycle-model.mjs +359 -0
  355. package/tools/vibe-runtime/runtime-delivery-methodology-command.mjs +17 -0
  356. package/tools/vibe-runtime/runtime-delivery-methodology-gates.mjs +277 -0
  357. package/tools/vibe-runtime/runtime-diff-coverage-envelope.mjs +301 -0
  358. package/tools/vibe-runtime/runtime-dispatch-command.mjs +484 -0
  359. package/tools/vibe-runtime/runtime-dispatch-readonly-artifacts.mjs +406 -0
  360. package/tools/vibe-runtime/runtime-dispatch-state-lifecycle-model.mjs +199 -0
  361. package/tools/vibe-runtime/runtime-durable-state-recovery-contract.mjs +172 -0
  362. package/tools/vibe-runtime/runtime-entry-advice-model.mjs +201 -0
  363. package/tools/vibe-runtime/runtime-entry-deps-builder.mjs +54 -0
  364. package/tools/vibe-runtime/runtime-entry-presentation.mjs +82 -0
  365. package/tools/vibe-runtime/runtime-entry-summary-model.mjs +343 -0
  366. package/tools/vibe-runtime/runtime-entry-trigger-discipline.mjs +341 -0
  367. package/tools/vibe-runtime/runtime-entry-trigger-tightening-command.mjs +79 -0
  368. package/tools/vibe-runtime/runtime-entry-trigger-tightening.mjs +357 -0
  369. package/tools/vibe-runtime/runtime-eval-catalog-model.mjs +101 -0
  370. package/tools/vibe-runtime/runtime-eval-transcript-fixtures.mjs +218 -0
  371. package/tools/vibe-runtime/runtime-evidence-intake-envelope.mjs +278 -0
  372. package/tools/vibe-runtime/runtime-evidence-repair-model.mjs +180 -0
  373. package/tools/vibe-runtime/runtime-executable-plan-contract.mjs +428 -0
  374. package/tools/vibe-runtime/runtime-execution-approval-lifecycle-models.mjs +278 -0
  375. package/tools/vibe-runtime/runtime-execution-candidate-approval-artifacts.mjs +227 -0
  376. package/tools/vibe-runtime/runtime-execution-command.mjs +544 -0
  377. package/tools/vibe-runtime/runtime-execution-enabled-bridge-model.mjs +113 -0
  378. package/tools/vibe-runtime/runtime-execution-enabled-closeout-boundary.mjs +89 -0
  379. package/tools/vibe-runtime/runtime-execution-enabled-preflight-model.mjs +185 -0
  380. package/tools/vibe-runtime/runtime-execution-enabled-profile-contract.mjs +127 -0
  381. package/tools/vibe-runtime/runtime-execution-enabled-run-envelope.mjs +153 -0
  382. package/tools/vibe-runtime/runtime-execution-evidence-binder.mjs +537 -0
  383. package/tools/vibe-runtime/runtime-execution-plan-artifacts.mjs +136 -0
  384. package/tools/vibe-runtime/runtime-execution-policy-artifacts.mjs +377 -0
  385. package/tools/vibe-runtime/runtime-execution-presentation.mjs +174 -0
  386. package/tools/vibe-runtime/runtime-execution-readonly-artifacts.mjs +228 -0
  387. package/tools/vibe-runtime/runtime-execution-run-preflight-artifacts.mjs +265 -0
  388. package/tools/vibe-runtime/runtime-execution-safety-artifacts.mjs +131 -0
  389. package/tools/vibe-runtime/runtime-execution-state-write-lifecycle-model.mjs +99 -0
  390. package/tools/vibe-runtime/runtime-experience-friction-matrix.mjs +395 -0
  391. package/tools/vibe-runtime/runtime-experience-learning-pattern.mjs +354 -0
  392. package/tools/vibe-runtime/runtime-experience-regression-dashboard.mjs +398 -0
  393. package/tools/vibe-runtime/runtime-experience-upgrade-command.mjs +92 -0
  394. package/tools/vibe-runtime/runtime-experience-upgrade-prioritizer.mjs +451 -0
  395. package/tools/vibe-runtime/runtime-foreground-worker-plan.mjs +275 -0
  396. package/tools/vibe-runtime/runtime-git-diff-read-model.mjs +322 -0
  397. package/tools/vibe-runtime/runtime-governance-attestation.mjs +304 -0
  398. package/tools/vibe-runtime/runtime-governance-command.mjs +609 -0
  399. package/tools/vibe-runtime/runtime-governance-convergence-reports.mjs +601 -0
  400. package/tools/vibe-runtime/runtime-governance-pr-models.mjs +551 -0
  401. package/tools/vibe-runtime/runtime-governance-presentation.mjs +67 -0
  402. package/tools/vibe-runtime/runtime-governance-route-model.mjs +194 -0
  403. package/tools/vibe-runtime/runtime-governance-surface-reports.mjs +495 -0
  404. package/tools/vibe-runtime/runtime-hooks-boundary-model.mjs +356 -0
  405. package/tools/vibe-runtime/runtime-hooks-command.mjs +286 -0
  406. package/tools/vibe-runtime/runtime-human-completion-evidence-model.mjs +220 -0
  407. package/tools/vibe-runtime/runtime-human-friendly-aliases.mjs +250 -0
  408. package/tools/vibe-runtime/runtime-implementation-methodology-command.mjs +17 -0
  409. package/tools/vibe-runtime/runtime-implementation-methodology-gates.mjs +164 -0
  410. package/tools/vibe-runtime/runtime-implementation-task-registry.mjs +334 -0
  411. package/tools/vibe-runtime/runtime-install-experience-command.mjs +120 -0
  412. package/tools/vibe-runtime/runtime-install-experience-score.mjs +334 -0
  413. package/tools/vibe-runtime/runtime-installed-multiround-ux-acceptance.mjs +149 -0
  414. package/tools/vibe-runtime/runtime-interaction-command-domain-registry.mjs +46 -0
  415. package/tools/vibe-runtime/runtime-interaction-command.mjs +648 -0
  416. package/tools/vibe-runtime/runtime-interaction-completion-command.mjs +220 -0
  417. package/tools/vibe-runtime/runtime-interaction-entry-command.mjs +130 -0
  418. package/tools/vibe-runtime/runtime-interaction-workflow-envelopes.mjs +412 -0
  419. package/tools/vibe-runtime/runtime-learning-advice-model.mjs +157 -0
  420. package/tools/vibe-runtime/runtime-learning-artifact-model.mjs +509 -0
  421. package/tools/vibe-runtime/runtime-learning-audit-model.mjs +106 -0
  422. package/tools/vibe-runtime/runtime-learning-interaction-command.mjs +220 -0
  423. package/tools/vibe-runtime/runtime-learning-observation-model.mjs +124 -0
  424. package/tools/vibe-runtime/runtime-learning-presentation.mjs +84 -0
  425. package/tools/vibe-runtime/runtime-learning-run-preview-model.mjs +184 -0
  426. package/tools/vibe-runtime/runtime-lease-command.mjs +95 -0
  427. package/tools/vibe-runtime/runtime-lease-state-lifecycle-model.mjs +247 -0
  428. package/tools/vibe-runtime/runtime-list-presentation.mjs +7 -0
  429. package/tools/vibe-runtime/runtime-live-behavior-transcript-model.mjs +164 -0
  430. package/tools/vibe-runtime/runtime-local-behavior-eval-contracts-command.mjs +76 -0
  431. package/tools/vibe-runtime/runtime-local-behavior-eval-contracts.mjs +382 -0
  432. package/tools/vibe-runtime/runtime-local-commit-automation-gate.mjs +254 -0
  433. package/tools/vibe-runtime/runtime-local-json-input.mjs +32 -0
  434. package/tools/vibe-runtime/runtime-methodology-coverage-map.mjs +398 -0
  435. package/tools/vibe-runtime/runtime-methodology-coverage-marker-specs.mjs +61 -0
  436. package/tools/vibe-runtime/runtime-methodology-coverage-presentation.mjs +26 -0
  437. package/tools/vibe-runtime/runtime-methodology-gate-model.mjs +154 -0
  438. package/tools/vibe-runtime/runtime-methodology-gate-output-envelope.mjs +4 -0
  439. package/tools/vibe-runtime/runtime-methodology-interaction-command.mjs +147 -0
  440. package/tools/vibe-runtime/runtime-methodology-presentation.mjs +76 -0
  441. package/tools/vibe-runtime/runtime-methodology-route-model.mjs +93 -0
  442. package/tools/vibe-runtime/runtime-next-action-console.mjs +388 -0
  443. package/tools/vibe-runtime/runtime-next-action-evidence-prompts-command.mjs +84 -0
  444. package/tools/vibe-runtime/runtime-next-action-evidence-prompts.mjs +327 -0
  445. package/tools/vibe-runtime/runtime-observability-command.mjs +96 -0
  446. package/tools/vibe-runtime/runtime-observability-presentation.mjs +30 -0
  447. package/tools/vibe-runtime/runtime-observability-readiness-model.mjs +204 -0
  448. package/tools/vibe-runtime/runtime-patch-queue-contract.mjs +151 -0
  449. package/tools/vibe-runtime/runtime-plan-action-manifest.mjs +334 -0
  450. package/tools/vibe-runtime/runtime-planner-route-model.mjs +75 -0
  451. package/tools/vibe-runtime/runtime-platform-acceptance-command.mjs +216 -0
  452. package/tools/vibe-runtime/runtime-platform-capability-artifacts.mjs +156 -0
  453. package/tools/vibe-runtime/runtime-platform-capability-model.mjs +105 -0
  454. package/tools/vibe-runtime/runtime-platform-command.mjs +329 -0
  455. package/tools/vibe-runtime/runtime-platform-presentation.mjs +78 -0
  456. package/tools/vibe-runtime/runtime-platform-session-artifacts.mjs +857 -0
  457. package/tools/vibe-runtime/runtime-platform-transcript-example-pack.mjs +293 -0
  458. package/tools/vibe-runtime/runtime-platform-transcript-intake-model.mjs +247 -0
  459. package/tools/vibe-runtime/runtime-platform-transcript-replay-model.mjs +371 -0
  460. package/tools/vibe-runtime/runtime-policy-catalog.mjs +54 -0
  461. package/tools/vibe-runtime/runtime-product-methodology-command.mjs +17 -0
  462. package/tools/vibe-runtime/runtime-product-methodology-gates.mjs +316 -0
  463. package/tools/vibe-runtime/runtime-progressive-entry-ux.mjs +237 -0
  464. package/tools/vibe-runtime/runtime-queue-command.mjs +98 -0
  465. package/tools/vibe-runtime/runtime-queue-state-lifecycle-model.mjs +318 -0
  466. package/tools/vibe-runtime/runtime-readiness-gate-split.mjs +196 -0
  467. package/tools/vibe-runtime/runtime-readonly-local-json-output-envelope.mjs +24 -0
  468. package/tools/vibe-runtime/runtime-recovery-classification-models.mjs +412 -0
  469. package/tools/vibe-runtime/runtime-recovery-command.mjs +107 -0
  470. package/tools/vibe-runtime/runtime-recovery-presentation.mjs +65 -0
  471. package/tools/vibe-runtime/runtime-recovery-state-lifecycle-model.mjs +419 -0
  472. package/tools/vibe-runtime/runtime-release-command-deps.mjs +4 -0
  473. package/tools/vibe-runtime/runtime-release-command.mjs +225 -0
  474. package/tools/vibe-runtime/runtime-release-state-lifecycle-model.mjs +48 -0
  475. package/tools/vibe-runtime/runtime-reply-artifact-lifecycle-model.mjs +84 -0
  476. package/tools/vibe-runtime/runtime-reply-command.mjs +488 -0
  477. package/tools/vibe-runtime/runtime-retry-command.mjs +223 -0
  478. package/tools/vibe-runtime/runtime-retry-run-gate-model.mjs +151 -0
  479. package/tools/vibe-runtime/runtime-review-envelope.mjs +449 -0
  480. package/tools/vibe-runtime/runtime-review-feedback-gate.mjs +160 -0
  481. package/tools/vibe-runtime/runtime-runbook-executor-preview-contract.mjs +361 -0
  482. package/tools/vibe-runtime/runtime-scheduler-command.mjs +8 -0
  483. package/tools/vibe-runtime/runtime-scheduler-risk-artifacts.mjs +775 -0
  484. package/tools/vibe-runtime/runtime-scheduler-state-lifecycle-model.mjs +53 -0
  485. package/tools/vibe-runtime/runtime-sdd-consumption-command.mjs +386 -0
  486. package/tools/vibe-runtime/runtime-sdd-evidence-chain-model.mjs +200 -0
  487. package/tools/vibe-runtime/runtime-sdd-handoff-chain-model.mjs +168 -0
  488. package/tools/vibe-runtime/runtime-sdd-implementer-artifact-model.mjs +90 -0
  489. package/tools/vibe-runtime/runtime-sdd-loop-command.mjs +659 -0
  490. package/tools/vibe-runtime/runtime-sdd-plan-preflight-model.mjs +121 -0
  491. package/tools/vibe-runtime/runtime-sdd-review-package-command.mjs +197 -0
  492. package/tools/vibe-runtime/runtime-sdd-review-package-model.mjs +183 -0
  493. package/tools/vibe-runtime/runtime-sdd-task-brief-model.mjs +144 -0
  494. package/tools/vibe-runtime/runtime-self-test-gate-profile.mjs +225 -0
  495. package/tools/vibe-runtime/runtime-sequential-stage-runbook.mjs +406 -0
  496. package/tools/vibe-runtime/runtime-session-checkpoint-model.mjs +217 -0
  497. package/tools/vibe-runtime/runtime-session-skill-command.mjs +241 -0
  498. package/tools/vibe-runtime/runtime-session-start-example-command.mjs +122 -0
  499. package/tools/vibe-runtime/runtime-session-start-example-pack.mjs +290 -0
  500. package/tools/vibe-runtime/runtime-session-start-shape-acceptance.mjs +344 -0
  501. package/tools/vibe-runtime/runtime-skill-contract-schema.mjs +221 -0
  502. package/tools/vibe-runtime/runtime-skill-route-registry.mjs +47 -0
  503. package/tools/vibe-runtime/runtime-skill-runtime-traceability-map.mjs +268 -0
  504. package/tools/vibe-runtime/runtime-source-merge-apply-boundary-model.mjs +130 -0
  505. package/tools/vibe-runtime/runtime-source-merge-artifacts.mjs +920 -0
  506. package/tools/vibe-runtime/runtime-source-merge-command.mjs +160 -0
  507. package/tools/vibe-runtime/runtime-source-merge-entry-command.mjs +153 -0
  508. package/tools/vibe-runtime/runtime-source-patch-plan-model.mjs +119 -0
  509. package/tools/vibe-runtime/runtime-stage-scriptlet.mjs +430 -0
  510. package/tools/vibe-runtime/runtime-staged-commit-readiness.mjs +469 -0
  511. package/tools/vibe-runtime/runtime-state-directory-model.mjs +7 -0
  512. package/tools/vibe-runtime/runtime-state-io.mjs +41 -0
  513. package/tools/vibe-runtime/runtime-state-paths.mjs +231 -0
  514. package/tools/vibe-runtime/runtime-state-presence-model.mjs +6 -0
  515. package/tools/vibe-runtime/runtime-state-risk-paths.mjs +70 -0
  516. package/tools/vibe-runtime/runtime-subagent-adapter-dispatch-command.mjs +266 -0
  517. package/tools/vibe-runtime/runtime-subagent-boundary-contracts.mjs +118 -0
  518. package/tools/vibe-runtime/runtime-subagent-permission-command.mjs +78 -0
  519. package/tools/vibe-runtime/runtime-subagent-permission-gate-model.mjs +131 -0
  520. package/tools/vibe-runtime/runtime-subagent-permission-visibility.mjs +294 -0
  521. package/tools/vibe-runtime/runtime-subagents-artifact-specs.mjs +257 -0
  522. package/tools/vibe-runtime/runtime-subagents-command.mjs +10 -0
  523. package/tools/vibe-runtime/runtime-subagents-eligibility-model.mjs +340 -0
  524. package/tools/vibe-runtime/runtime-subagents-platform-session-proxies.mjs +54 -0
  525. package/tools/vibe-runtime/runtime-subagents-presentation.mjs +91 -0
  526. package/tools/vibe-runtime/runtime-subagents-risk-artifacts.mjs +853 -0
  527. package/tools/vibe-runtime/runtime-subagents-stage-artifact-model.mjs +538 -0
  528. package/tools/vibe-runtime/runtime-subagents-tail-routing-model.mjs +48 -0
  529. package/tools/vibe-runtime/runtime-suite-plan-model.mjs +194 -0
  530. package/tools/vibe-runtime/runtime-superpowers-comparison-matrix.mjs +399 -0
  531. package/tools/vibe-runtime/runtime-superpowers-gap-matrix.mjs +307 -0
  532. package/tools/vibe-runtime/runtime-superpowers-parity-command.mjs +102 -0
  533. package/tools/vibe-runtime/runtime-superpowers-parity-profile-contract.mjs +183 -0
  534. package/tools/vibe-runtime/runtime-superpowers-parity-scorecard.mjs +460 -0
  535. package/tools/vibe-runtime/runtime-superpowers-regression-guard.mjs +270 -0
  536. package/tools/vibe-runtime/runtime-superpowers-style-eval-pack.mjs +367 -0
  537. package/tools/vibe-runtime/runtime-task-commit-gates.mjs +62 -0
  538. package/tools/vibe-runtime/runtime-task-commit-readiness.mjs +66 -0
  539. package/tools/vibe-runtime/runtime-task-commit-sidecar.mjs +65 -0
  540. package/tools/vibe-runtime/runtime-tdd-trace-contract.mjs +277 -0
  541. package/tools/vibe-runtime/runtime-test-evidence-model.mjs +196 -0
  542. package/tools/vibe-runtime/runtime-test-run-command-deps.mjs +7 -0
  543. package/tools/vibe-runtime/runtime-test-run-command.mjs +108 -0
  544. package/tools/vibe-runtime/runtime-token-economy-model.mjs +336 -0
  545. package/tools/vibe-runtime/runtime-token-interaction-command.mjs +381 -0
  546. package/tools/vibe-runtime/runtime-token-savior-budget.mjs +370 -0
  547. package/tools/vibe-runtime/runtime-tokens-command-deps.mjs +17 -0
  548. package/tools/vibe-runtime/runtime-tokens-command.mjs +117 -0
  549. package/tools/vibe-runtime/runtime-tokens-presentation.mjs +45 -0
  550. package/tools/vibe-runtime/runtime-trace-command.mjs +283 -0
  551. package/tools/vibe-runtime/runtime-trace-source-registry.mjs +132 -0
  552. package/tools/vibe-runtime/runtime-verification-gate-chain-model.mjs +131 -0
  553. package/tools/vibe-runtime/runtime-verification-repair-loop-plan.mjs +188 -0
  554. package/tools/vibe-runtime/runtime-workflow-alias-boundary-text.mjs +7 -0
  555. package/tools/vibe-runtime/runtime-workflow-alias-interaction-command.mjs +145 -0
  556. package/tools/vibe-runtime/runtime-workflow-command-deps.mjs +41 -0
  557. package/tools/vibe-runtime/runtime-workflow-command.mjs +191 -0
  558. package/tools/vibe-runtime/runtime-workflow-discipline-summary.mjs +164 -0
  559. package/tools/vibe-runtime/runtime-workflow-entry-envelopes.mjs +156 -0
  560. package/tools/vibe-runtime/runtime-workflow-ledger-command.mjs +239 -0
  561. package/tools/vibe-runtime/runtime-workflow-ledger-state-lifecycle-model.mjs +46 -0
  562. package/tools/vibe-runtime/runtime-workflow-loop-contract.mjs +259 -0
  563. package/tools/vibe-runtime/runtime-workflow-next-step-gate-model.mjs +106 -0
  564. package/tools/vibe-runtime/runtime-workflow-presentation.mjs +355 -0
  565. package/tools/vibe-runtime/runtime-workflow-readiness-model.mjs +176 -0
  566. package/tools/vibe-runtime/runtime-workflow-run-plan-model.mjs +207 -0
  567. package/tools/vibe-runtime/runtime-workflow-start-model.mjs +229 -0
  568. package/tools/vibe-runtime/runtime-workflow-state-artifacts.mjs +381 -0
  569. package/tools/vibe-runtime/runtime-workflow-state-helpers.mjs +456 -0
  570. package/tools/vibe-runtime/runtime-workflow-state-summary.mjs +65 -0
  571. package/tools/vibe-runtime/runtime-workflow-state-validation.mjs +104 -0
  572. package/tools/vibe-runtime/runtime-workflow-ux-model.mjs +205 -0
  573. package/tools/vibe-runtime/runtime-workspace-boundary-text.mjs +7 -0
  574. package/tools/vibe-runtime/runtime-workspace-isolation-command.mjs +295 -0
  575. package/tools/vibe-runtime/state-core-paths.mjs +113 -0
  576. package/tools/vibe-runtime/state-extension-paths.mjs +198 -0
  577. package/tools/vibe-runtime/state-safe-paths.mjs +2 -0
  578. package/tools/vibe-runtime-check/README.md +110 -0
  579. package/tools/vibe-runtime-check/architecture-tool-contracts.mjs +150 -0
  580. package/tools/vibe-runtime-check/index.mjs +186 -0
  581. package/tools/vibe-runtime-check/install-summary-adoption-contracts.mjs +115 -0
  582. package/tools/vibe-runtime-check/marker-contract-core.mjs +20 -0
  583. package/tools/vibe-runtime-check/product-artifact-contracts.mjs +24 -0
  584. package/tools/vibe-runtime-check/release-check-install-placement-contracts.mjs +166 -0
  585. package/tools/vibe-runtime-check/release-runtime-suite-layer-contracts.mjs +137 -0
  586. package/tools/vibe-runtime-check/runtime-architecture-manifest-drift-contracts.mjs +128 -0
  587. package/tools/vibe-runtime-check/runtime-automation-readiness-contracts.mjs +404 -0
  588. package/tools/vibe-runtime-check/runtime-capability-registry-contracts.mjs +299 -0
  589. package/tools/vibe-runtime-check/runtime-check-diagnostics-presentation.mjs +71 -0
  590. package/tools/vibe-runtime-check/runtime-cli-surface-contracts.mjs +156 -0
  591. package/tools/vibe-runtime-check/runtime-close-loop-contracts.mjs +163 -0
  592. package/tools/vibe-runtime-check/runtime-contract-delivery-registry.mjs +19 -0
  593. package/tools/vibe-runtime-check/runtime-contract-implementation-registry.mjs +23 -0
  594. package/tools/vibe-runtime-check/runtime-contract-local-evidence-registry.mjs +43 -0
  595. package/tools/vibe-runtime-check/runtime-contract-product-registry.mjs +83 -0
  596. package/tools/vibe-runtime-check/runtime-contract-registry.mjs +19 -0
  597. package/tools/vibe-runtime-check/runtime-control-plane-contracts.mjs +14 -0
  598. package/tools/vibe-runtime-check/runtime-doc-contract-marker-specs.mjs +349 -0
  599. package/tools/vibe-runtime-check/runtime-doc-contracts.mjs +24 -0
  600. package/tools/vibe-runtime-check/runtime-doc-marker-contracts.mjs +25 -0
  601. package/tools/vibe-runtime-check/runtime-entry-size-contracts.mjs +477 -0
  602. package/tools/vibe-runtime-check/runtime-experience-cli-contract-specs.mjs +98 -0
  603. package/tools/vibe-runtime-check/runtime-experience-cli-contracts.mjs +12 -0
  604. package/tools/vibe-runtime-check/runtime-experience-contracts.mjs +187 -0
  605. package/tools/vibe-runtime-check/runtime-governance-learning-token-contract-specs.mjs +92 -0
  606. package/tools/vibe-runtime-check/runtime-governance-learning-token-contracts.mjs +12 -0
  607. package/tools/vibe-runtime-check/runtime-high-risk-boundary-contracts.mjs +35 -0
  608. package/tools/vibe-runtime-check/runtime-high-risk-boundary-matrix.mjs +75 -0
  609. package/tools/vibe-runtime-check/runtime-index-import-boundary-contracts.mjs +192 -0
  610. package/tools/vibe-runtime-check/runtime-optimization-boundary-contracts.mjs +49 -0
  611. package/tools/vibe-runtime-check/runtime-pure-model-boundary-contracts.mjs +176 -0
  612. package/tools/vibe-runtime-check/runtime-release-closeout-contracts.mjs +25 -0
  613. package/tools/vibe-runtime-check/runtime-roadmap-marker-specs.mjs +559 -0
  614. package/tools/vibe-runtime-check/runtime-source-bundle.mjs +119 -0
  615. package/tools/vibe-runtime-check/runtime-tool-readme-contracts.mjs +93 -0
  616. package/tools/vibe-runtime-check/runtime-tool-readme-marker-specs.mjs +952 -0
  617. package/tools/vibe-runtime-check/workflow-skill-contracts.mjs +129 -0
  618. package/tools/vibe-runtime-check/workflow-skill-route-registry-contracts.mjs +106 -0
  619. package/tools/vibe-runtime-check/workflow-ux-contracts.mjs +46 -0
@@ -0,0 +1,138 @@
1
+ import {
2
+ agentBehaviorBoundaryAssertions,
3
+ agentBehaviorForbiddenActions,
4
+ normalizeSuperpowersParityProfileName,
5
+ } from './runtime-superpowers-parity-profile-contract.mjs';
6
+
7
+ const CONTRACT_STAGE = 'Stage 15';
8
+ const CONTRACT_KIND = 'agent-session-start-behavior-contract';
9
+ const EXPECTED_FIRST_SKILL = 'using-vibecoding';
10
+ const EXPECTED_SKILL_PATH = '.vibecoding/skills/using-vibecoding/SKILL.md';
11
+ const STAGE15_BOUNDARY_MARKERS = 'runtime_action auto_execution platform_api external_network model_invocation git_write business_source_write';
12
+
13
+ export function agentSessionStartBoundaryAssertions() {
14
+ return {
15
+ ...agentBehaviorBoundaryAssertions(),
16
+ agent_session_start_contract_artifact: false,
17
+ full_skill_injection: false,
18
+ hidden_execution: false,
19
+ workflow_start_artifact: false,
20
+ prompt_mutation: false,
21
+ command_execution: false,
22
+ check_execution: false,
23
+ test_execution: false,
24
+ workflow_execution: false,
25
+ skill_execution: false,
26
+ subagent_dispatch: false,
27
+ daemon: false,
28
+ watcher: false,
29
+ shell_interception: false,
30
+ source_merge: false,
31
+ };
32
+ }
33
+
34
+ export function buildAgentSessionStartContract({
35
+ profile = 'vibe-guided',
36
+ selectedSkill = '',
37
+ routeReason = '',
38
+ nextGate = '',
39
+ entrySummary = {},
40
+ readiness = {},
41
+ normalizedIntent = 'unknown',
42
+ prompt = '',
43
+ profileSource = 'explicit-or-default',
44
+ digestObject,
45
+ } = {}) {
46
+ const normalizedProfile = normalizeSuperpowersParityProfileName(profile);
47
+ const strict = normalizedProfile === 'superpowers-parity';
48
+ const boundaryAssertions = agentSessionStartBoundaryAssertions();
49
+ const forbiddenActions = agentBehaviorForbiddenActions();
50
+ const contract = {
51
+ version: 1,
52
+ stage: CONTRACT_STAGE,
53
+ contract_kind: CONTRACT_KIND,
54
+ automation_profile: normalizedProfile,
55
+ profile_source: profileSource,
56
+ discipline_level: strict ? 'strict-skill-first-visible-route' : 'lightweight-using-vibecoding-route',
57
+ prompt: String(prompt || '').trim(),
58
+ normalized_intent: normalizedIntent,
59
+ expected_first_skill: EXPECTED_FIRST_SKILL,
60
+ skill_path: EXPECTED_SKILL_PATH,
61
+ registry_fallback_to_file_path: true,
62
+ visible_first_sentence: strict
63
+ ? `我会先按文件路径读取 \`${EXPECTED_SKILL_PATH}\`,用 \`${EXPECTED_FIRST_SKILL}\` 声明当前 route、验证策略和 stop condition 后再继续。`
64
+ : `我会先按文件路径读取 \`${EXPECTED_SKILL_PATH}\`,用 \`${EXPECTED_FIRST_SKILL}\` 做轻量分流,并说明可见下一步。`,
65
+ selected_skill_after_entry: selectedSkill || EXPECTED_FIRST_SKILL,
66
+ route_reason: routeReason || 'Use Vibecoding entry routing before implementation.',
67
+ next_gate: nextGate || entrySummary.first_user_decision || 'manual workflow judgment',
68
+ route_required_before_implementation: true,
69
+ plan_or_todo_required_when_planning: Boolean(strict || entrySummary.entry_classification === 'planning_needed' || normalizedIntent === 'plan'),
70
+ validation_strategy_required_before_change: true,
71
+ stop_conditions: [
72
+ 'goal, scope, acceptance, or validation strategy is missing',
73
+ 'requested action needs source write, command execution, subagent, platform API, or git without explicit scoped permission',
74
+ 'bug or failure lacks reproduction and root-cause evidence',
75
+ 'completion claim lacks fresh verification evidence',
76
+ ],
77
+ context_policy: {
78
+ default_context: 'tiny_context',
79
+ full_skill_injection: false,
80
+ load_only_bootstrap_contract_first: true,
81
+ upgrade_to_balanced_context_when: [
82
+ 'implementation, debugging, or completion verification needs evidence detail',
83
+ 'handoff, stage transition, or risk boundary requires more context',
84
+ ],
85
+ },
86
+ visible_receipt_requirements: {
87
+ must_name_entry_skill: EXPECTED_FIRST_SKILL,
88
+ must_show_next_manual_action: true,
89
+ must_not_claim_skill_execution_from_receipt: true,
90
+ must_not_claim_command_execution_from_receipt: true,
91
+ },
92
+ readiness_summary: {
93
+ ready_to_start: readiness.ready_to_start === true,
94
+ required_gate_kinds: readiness.required_gate_kinds || [],
95
+ readiness_digest: readiness.readiness_digest || '',
96
+ },
97
+ entry_summary: {
98
+ entry_classification: entrySummary.entry_classification || 'unknown',
99
+ state_gap_is_expected: entrySummary.state_gap_is_expected === true,
100
+ first_user_decision: entrySummary.first_user_decision || '',
101
+ readiness_blocker_count: entrySummary.readiness_blocker_count || 0,
102
+ },
103
+ forbidden_actions: forbiddenActions,
104
+ boundary_assertions: boundaryAssertions,
105
+ writes: false,
106
+ state_directory_created: false,
107
+ local_only: true,
108
+ deterministic: true,
109
+ };
110
+ return {
111
+ ...contract,
112
+ contract_digest: typeof digestObject === 'function' ? digestObject(contract) : '',
113
+ };
114
+ }
115
+
116
+ export function agentSessionStartContractDigestPayload(contract) {
117
+ return {
118
+ stage: contract.stage,
119
+ contract_kind: contract.contract_kind,
120
+ automation_profile: contract.automation_profile,
121
+ profile_source: contract.profile_source,
122
+ discipline_level: contract.discipline_level,
123
+ expected_first_skill: contract.expected_first_skill,
124
+ skill_path: contract.skill_path,
125
+ registry_fallback_to_file_path: contract.registry_fallback_to_file_path,
126
+ visible_first_sentence: contract.visible_first_sentence,
127
+ selected_skill_after_entry: contract.selected_skill_after_entry,
128
+ next_gate: contract.next_gate,
129
+ route_required_before_implementation: contract.route_required_before_implementation,
130
+ plan_or_todo_required_when_planning: contract.plan_or_todo_required_when_planning,
131
+ validation_strategy_required_before_change: contract.validation_strategy_required_before_change,
132
+ stop_conditions: contract.stop_conditions,
133
+ context_policy: contract.context_policy,
134
+ visible_receipt_requirements: contract.visible_receipt_requirements,
135
+ forbidden_actions: contract.forbidden_actions,
136
+ boundary_assertions: contract.boundary_assertions,
137
+ };
138
+ }
@@ -0,0 +1,281 @@
1
+ import crypto from 'node:crypto';
2
+
3
+ const traceabilityRefBindings = Object.freeze({
4
+ requirement_ref: ['product_discovery', 'product_spec'],
5
+ product_story_ref: ['product_spec'],
6
+ ui_flow_ref: ['ui_design'],
7
+ architecture_decision_ref: ['architecture'],
8
+ scenario_ref: ['scenarios'],
9
+ product_acceptance_ref: ['product_acceptance'],
10
+ });
11
+
12
+ const artifactInputSpecs = Object.freeze([
13
+ ['product_discovery', 'fromProductDiscovery', 'completion ref validation --from-product-discovery'],
14
+ ['product_spec', 'fromProductSpec', 'completion ref validation --from-product-spec'],
15
+ ['ui_design', 'fromUiDesign', 'completion ref validation --from-ui-design'],
16
+ ['architecture', 'fromArchitecture', 'completion ref validation --from-architecture'],
17
+ ['scenarios', 'fromScenarios', 'completion ref validation --from-scenarios'],
18
+ ['product_acceptance', 'fromProductAcceptance', 'completion ref validation --from-product-acceptance'],
19
+ ['traceability', 'fromTraceability', 'completion ref validation --from-traceability'],
20
+ ]);
21
+
22
+ const referenceRegistryKeys = Object.freeze({
23
+ requirement_refs: 'requirement_ref',
24
+ product_story_refs: 'product_story_ref',
25
+ ui_flow_refs: 'ui_flow_ref',
26
+ architecture_decision_refs: 'architecture_decision_ref',
27
+ scenario_refs: 'scenario_ref',
28
+ product_acceptance_refs: 'product_acceptance_ref',
29
+ });
30
+
31
+ const fallbackRefPatterns = Object.freeze({
32
+ requirement_ref: /\breq-[A-Za-z0-9._-]+\b/g,
33
+ product_story_ref: /\bstory-[A-Za-z0-9._-]+\b/g,
34
+ ui_flow_ref: /\bflow-[A-Za-z0-9._-]+\b/g,
35
+ architecture_decision_ref: /\badr-[A-Za-z0-9._-]+\b/g,
36
+ scenario_ref: /(?:^|\n)\s*-\s*id:\s*([A-Za-z0-9._-]+)\s*(?:\n|$)/g,
37
+ product_acceptance_ref: /\bacceptance-[A-Za-z0-9._-]+\b/g,
38
+ });
39
+
40
+ export function completionCrossArtifactRefValidation(root, options = {}, { readLocalTextArtifact }) {
41
+ const sources = readArtifactSources(root, options, readLocalTextArtifact);
42
+ const traceabilitySource = sources.traceability;
43
+ if (!traceabilitySource) {
44
+ return skippedRefValidation('traceability artifact not provided');
45
+ }
46
+
47
+ const index = buildArtifactReferenceIndex(sources);
48
+ const traceabilityRefs = parseDeliveryTraceabilityRefs(traceabilitySource.text);
49
+ const validation = validateTraceabilityRefsAgainstIndex(traceabilityRefs, index);
50
+ const payload = {
51
+ outcome: validation.missing_refs.length === 0 && validation.unbound_ref_types.length === 0 ? 'pass' : 'blocked',
52
+ checked_ref_types: Object.keys(traceabilityRefBindings),
53
+ matched_refs: validation.matched_refs,
54
+ missing_refs: validation.missing_refs,
55
+ unbound_ref_types: validation.unbound_ref_types,
56
+ link_count: traceabilityRefs.links.length,
57
+ source_index_digests: Object.fromEntries(Object.entries(sources).map(([slot, source]) => [slot, source.digest])),
58
+ boundary_assertions: {
59
+ writes: false,
60
+ command_execution: false,
61
+ test_execution: false,
62
+ git: false,
63
+ git_write: false,
64
+ },
65
+ };
66
+ return {
67
+ status: 'provided',
68
+ ok: payload.outcome === 'pass',
69
+ ref_validation: {
70
+ ...payload,
71
+ validation_digest: digestObject(payload),
72
+ },
73
+ blocked_reasons: [
74
+ ...validation.missing_refs.map((item) => `traceability_ref_missing: ${item.ref_type}=${item.ref} not found in ${item.expected_slots.join('|')}`),
75
+ ...validation.unbound_ref_types.map((item) => `traceability_ref_unbound: ${item.ref_type} has no provided source artifact (${item.expected_slots.join('|')})`),
76
+ ],
77
+ };
78
+ }
79
+
80
+ export function buildArtifactReferenceIndex(sources = {}) {
81
+ const slots = Object.keys(sources).filter((slot) => slot !== 'traceability');
82
+ const refs = {};
83
+ const sourceSlots = {};
84
+ for (const refType of Object.keys(traceabilityRefBindings)) {
85
+ refs[refType] = new Map();
86
+ sourceSlots[refType] = [];
87
+ }
88
+
89
+ for (const slot of slots) {
90
+ const source = sources[slot];
91
+ if (!source?.text) continue;
92
+ const slotRefs = collectRefsFromArtifact(slot, source.text);
93
+ for (const [refType, values] of Object.entries(slotRefs)) {
94
+ if (!refs[refType]) continue;
95
+ if (values.length > 0 && !sourceSlots[refType].includes(slot)) sourceSlots[refType].push(slot);
96
+ for (const ref of values) {
97
+ const locations = refs[refType].get(ref) || [];
98
+ refs[refType].set(ref, [...new Set([...locations, slot])]);
99
+ }
100
+ }
101
+ }
102
+
103
+ return { refs, source_slots: sourceSlots };
104
+ }
105
+
106
+ export function parseDeliveryTraceabilityRefs(text) {
107
+ const links = parseTraceabilityLinks(text);
108
+ return {
109
+ links: links.map((link) => ({
110
+ id: link.id,
111
+ refs: Object.fromEntries(Object.keys(traceabilityRefBindings).map((refType) => [refType, scalarValue(link.block, refType)]).filter(([, value]) => Boolean(value))),
112
+ })),
113
+ };
114
+ }
115
+
116
+ export function validateTraceabilityRefsAgainstIndex(traceabilityRefs, index) {
117
+ const matchedRefs = [];
118
+ const missingRefs = [];
119
+ const unboundRefTypes = [];
120
+
121
+ for (const link of traceabilityRefs.links) {
122
+ for (const [refType, ref] of Object.entries(link.refs)) {
123
+ const expectedSlots = traceabilityRefBindings[refType] || [];
124
+ const providedSlots = expectedSlots.filter((slot) => (index.source_slots[refType] || []).includes(slot));
125
+ if (providedSlots.length === 0) {
126
+ unboundRefTypes.push({ link_id: link.id, ref_type: refType, ref, expected_slots: expectedSlots });
127
+ continue;
128
+ }
129
+ const locations = index.refs[refType]?.get(ref) || [];
130
+ if (locations.length > 0) {
131
+ matchedRefs.push({ link_id: link.id, ref_type: refType, ref, locations });
132
+ } else {
133
+ missingRefs.push({ link_id: link.id, ref_type: refType, ref, expected_slots: expectedSlots });
134
+ }
135
+ }
136
+ }
137
+
138
+ return { matched_refs: matchedRefs, missing_refs: missingRefs, unbound_ref_types: dedupeRefFindings(unboundRefTypes) };
139
+ }
140
+
141
+ export function scenarioRefsFromArtifactText(text) {
142
+ return [...new Set(collectRefsFromArtifact('scenarios', text).scenario_ref || [])];
143
+ }
144
+
145
+ function readArtifactSources(root, options, readLocalTextArtifact) {
146
+ const sources = {};
147
+ for (const [slot, optionKey, label] of artifactInputSpecs) {
148
+ const input = options[optionKey] || '';
149
+ if (!input) continue;
150
+ sources[slot] = readLocalTextArtifact(root, input, label);
151
+ }
152
+ return sources;
153
+ }
154
+
155
+ function skippedRefValidation(reason) {
156
+ return {
157
+ status: 'skipped',
158
+ ok: true,
159
+ ref_validation: {
160
+ outcome: 'skipped',
161
+ reason,
162
+ checked_ref_types: Object.keys(traceabilityRefBindings),
163
+ matched_refs: [],
164
+ missing_refs: [],
165
+ unbound_ref_types: [],
166
+ link_count: 0,
167
+ source_index_digests: {},
168
+ validation_digest: digestObject({ outcome: 'skipped', reason }),
169
+ },
170
+ blocked_reasons: [],
171
+ };
172
+ }
173
+
174
+ function collectRefsFromArtifact(slot, text) {
175
+ const refs = parseReferenceRegistry(text);
176
+ for (const [refType, pattern] of Object.entries(fallbackRefPatterns)) {
177
+ refs[refType] = [...new Set([...(refs[refType] || []), ...matchesForPattern(pattern, text)])];
178
+ }
179
+ if (slot === 'scenarios') refs.scenario_ref = [...new Set([...(refs.scenario_ref || []), ...parseScenarioIds(text)])];
180
+ return refs;
181
+ }
182
+
183
+ function parseReferenceRegistry(text) {
184
+ const section = sectionText(text, 'Reference Registry');
185
+ const refs = {};
186
+ const lines = section.split(/\r?\n/);
187
+ let currentKey = '';
188
+ for (const line of lines) {
189
+ const keyMatch = line.match(/^\s*([A-Za-z0-9_]+):\s*(.*?)\s*$/);
190
+ if (keyMatch) {
191
+ currentKey = referenceRegistryKeys[keyMatch[1]] || '';
192
+ if (currentKey) refs[currentKey] = [...(refs[currentKey] || []), ...inlineListValues(keyMatch[2])];
193
+ continue;
194
+ }
195
+ const itemMatch = line.match(/^\s*-\s*([A-Za-z0-9._-]+)\s*$/);
196
+ if (itemMatch && currentKey) refs[currentKey] = [...(refs[currentKey] || []), itemMatch[1]];
197
+ }
198
+ return Object.fromEntries(Object.entries(refs).map(([key, values]) => [key, [...new Set(values.filter(Boolean))]]));
199
+ }
200
+
201
+ function parseTraceabilityLinks(text) {
202
+ const lines = text.split(/\r?\n/);
203
+ const blocks = [];
204
+ let current = null;
205
+ for (const line of lines) {
206
+ const start = line.match(/^\s*-\s+id:\s*(\S.*?)\s*$/);
207
+ if (start) {
208
+ if (current) blocks.push(current);
209
+ current = { id: stripQuotes(start[1]), lines: [line] };
210
+ continue;
211
+ }
212
+ if (current) current.lines.push(line);
213
+ }
214
+ if (current) blocks.push(current);
215
+ return blocks.map((block) => ({ id: block.id, block: block.lines.join('\n') }));
216
+ }
217
+
218
+ function scalarValue(block, key) {
219
+ const match = block.match(new RegExp(`(?:^|\\n)\\s*${escapeRegExp(key)}:\\s*(\\S.*?)\\s*(?:\\n|$)`));
220
+ return stripQuotes(match?.[1] || '');
221
+ }
222
+
223
+ function sectionText(text, section) {
224
+ const match = text.match(new RegExp(`^##\\s+${escapeRegExp(section)}\\s*$([\\s\\S]*?)(?=^##\\s+|$)`, 'm'));
225
+ return match?.[1] || '';
226
+ }
227
+
228
+ function inlineListValues(value) {
229
+ const normalized = String(value || '').trim();
230
+ if (!normalized) return [];
231
+ if (normalized.startsWith('[') && normalized.endsWith(']')) {
232
+ return normalized.slice(1, -1).split(',').map(stripQuotes).filter(Boolean);
233
+ }
234
+ return [stripQuotes(normalized)].filter(Boolean);
235
+ }
236
+
237
+ function matchesForPattern(pattern, text) {
238
+ const values = [];
239
+ pattern.lastIndex = 0;
240
+ let match;
241
+ while ((match = pattern.exec(text))) values.push(stripQuotes(match[1] || match[0]));
242
+ return values;
243
+ }
244
+
245
+ function parseScenarioIds(text) {
246
+ const values = [];
247
+ const regex = /(?:^|\n)\s*-\s+id:\s*([A-Za-z0-9._-]+)\s*(?:\n|$)/g;
248
+ let match;
249
+ while ((match = regex.exec(text))) values.push(stripQuotes(match[1]));
250
+ return values;
251
+ }
252
+
253
+ function dedupeRefFindings(findings) {
254
+ const seen = new Set();
255
+ return findings.filter((item) => {
256
+ const key = `${item.link_id}\0${item.ref_type}\0${item.ref}`;
257
+ if (seen.has(key)) return false;
258
+ seen.add(key);
259
+ return true;
260
+ });
261
+ }
262
+
263
+ function stripQuotes(value) {
264
+ return String(value || '').trim().replace(/^['"]|['"]$/g, '');
265
+ }
266
+
267
+ function escapeRegExp(value) {
268
+ return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
269
+ }
270
+
271
+ function digestObject(value) {
272
+ return crypto.createHash('sha256').update(stableStringify(value)).digest('hex');
273
+ }
274
+
275
+ function stableStringify(value) {
276
+ if (Array.isArray(value)) return `[${value.map(stableStringify).join(',')}]`;
277
+ if (value && typeof value === 'object') {
278
+ return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`).join(',')}}`;
279
+ }
280
+ return JSON.stringify(value);
281
+ }
@@ -0,0 +1,134 @@
1
+ const CONTRACT_STAGE = 'stage-4-automatic-verification-gates';
2
+ const CONTRACT_KIND = 'automatic-verification-gate-contract';
3
+
4
+ const gateOrder = Object.freeze([
5
+ 'stage_runbook_bound',
6
+ 'execution_evidence_bound',
7
+ 'test_evidence_checked',
8
+ 'diff_coverage_checked',
9
+ 'commit_readiness_checked',
10
+ 'freshness_checked',
11
+ 'coverage_checked',
12
+ 'missing_evidence_reported',
13
+ 'failed_evidence_reported',
14
+ 'next_manual_action_recorded',
15
+ ]);
16
+
17
+ const localEvidenceFields = Object.freeze([
18
+ 'stage_runbook',
19
+ 'execution_evidence',
20
+ 'test_evidence',
21
+ 'diff_coverage',
22
+ 'commit_readiness',
23
+ 'freshness',
24
+ 'coverage',
25
+ 'blocked_reasons',
26
+ 'next_manual_action',
27
+ ]);
28
+
29
+ function defaultBoundaryAssertions() {
30
+ return {
31
+ evidence_artifact_write: false,
32
+ sidecar_write: false,
33
+ state_directory_created: false,
34
+ command_execution: false,
35
+ check_execution: false,
36
+ test_execution: false,
37
+ validation_execution: false,
38
+ runtime_action: false,
39
+ auto_test_run: false,
40
+ automatic_verification_execution: false,
41
+ repair_execution: false,
42
+ formatting_execution: false,
43
+ code_generation: false,
44
+ source_write: false,
45
+ business_source_write: false,
46
+ git: false,
47
+ git_write: false,
48
+ commit: false,
49
+ push: false,
50
+ pr: false,
51
+ merge: false,
52
+ platform_api: false,
53
+ external_network: false,
54
+ model_invocation: false,
55
+ mcp: false,
56
+ subagent: false,
57
+ };
58
+ }
59
+
60
+ function automaticVerificationGateFindings(contract) {
61
+ const boundary = contract.boundary_assertions || {};
62
+ const unexpected = Object.keys(defaultBoundaryAssertions())
63
+ .filter((key) => boundary[key] !== false)
64
+ .map((key) => `boundary must remain false: ${key}`);
65
+ return [
66
+ ...(contract.stage === CONTRACT_STAGE ? [] : [`stage must be ${CONTRACT_STAGE}`]),
67
+ ...(contract.contract_kind === CONTRACT_KIND ? [] : [`contract_kind must be ${CONTRACT_KIND}`]),
68
+ ...(contract.reads_local_evidence_only === true ? [] : ['reads_local_evidence_only must be true']),
69
+ ...(contract.runtime_runs_checks_by_default === false ? [] : ['runtime_runs_checks_by_default must be false']),
70
+ ...(contract.completion_claim_requires_evidence === true ? [] : ['completion_claim_requires_evidence must be true']),
71
+ ...(Array.isArray(contract.blocked_reasons) ? [] : ['blocked_reasons must be an array']),
72
+ ...(contract.next_manual_action ? [] : ['next_manual_action is required']),
73
+ ...unexpected,
74
+ ];
75
+ }
76
+
77
+ export function buildAutomaticVerificationGateContract({
78
+ phase = 'verification-gate',
79
+ stageRunbookBound = false,
80
+ executionEvidenceBound = false,
81
+ completionBundleBound = false,
82
+ evidenceItemCount = 0,
83
+ missingEvidenceCount = 0,
84
+ staleEvidenceCount = 0,
85
+ failedEvidenceCount = 0,
86
+ unexpectedDiffCount = 0,
87
+ blockedReasons = [],
88
+ nextManualAction = 'Add or repair local verification evidence before claiming completion.',
89
+ } = {}) {
90
+ const normalizedBlockedReasons = [...new Set((blockedReasons || []).map((item) => String(item || '').trim()).filter(Boolean))];
91
+ const contract = {
92
+ version: 1,
93
+ stage: CONTRACT_STAGE,
94
+ contract_kind: CONTRACT_KIND,
95
+ phase,
96
+ local_evidence_fields: localEvidenceFields,
97
+ gate_order: gateOrder,
98
+ stage_runbook_bound: Boolean(stageRunbookBound),
99
+ execution_evidence_bound: Boolean(executionEvidenceBound),
100
+ completion_bundle_bound: Boolean(completionBundleBound),
101
+ evidence_item_count: Number.isFinite(evidenceItemCount) ? evidenceItemCount : 0,
102
+ missing_evidence_count: Number.isFinite(missingEvidenceCount) ? missingEvidenceCount : 0,
103
+ stale_evidence_count: Number.isFinite(staleEvidenceCount) ? staleEvidenceCount : 0,
104
+ failed_evidence_count: Number.isFinite(failedEvidenceCount) ? failedEvidenceCount : 0,
105
+ unexpected_diff_count: Number.isFinite(unexpectedDiffCount) ? unexpectedDiffCount : 0,
106
+ blocked_reasons: normalizedBlockedReasons,
107
+ next_manual_action: nextManualAction,
108
+ reads_local_evidence_only: true,
109
+ runtime_runs_checks_by_default: false,
110
+ completion_claim_requires_evidence: true,
111
+ manual_repair_only: true,
112
+ writes: false,
113
+ local_only: true,
114
+ deterministic: true,
115
+ boundary_assertions: defaultBoundaryAssertions(),
116
+ };
117
+ const findings = automaticVerificationGateFindings(contract);
118
+ return {
119
+ ...contract,
120
+ ready_for_completion_claim: findings.length === 0 && normalizedBlockedReasons.length === 0,
121
+ gate_pass: findings.length === 0,
122
+ findings,
123
+ };
124
+ }
125
+
126
+ export function automaticVerificationGateContractMarkers() {
127
+ return {
128
+ stage: CONTRACT_STAGE,
129
+ kind: CONTRACT_KIND,
130
+ local_evidence_fields: localEvidenceFields,
131
+ gate_order: gateOrder,
132
+ forbidden_boundaries: Object.keys(defaultBoundaryAssertions()),
133
+ };
134
+ }
@@ -0,0 +1,7 @@
1
+ export const automationReadinessActionText = 'runtime automation readiness matrix classified fixed local registry capabilities into auto_safe, confirm_required, advice_only, and forbidden categories read-only. No automation plan, one-shot execution, state directory, sidecar, command execution, scheduler, daemon, retry, runtime action, workflow execution, verification command, git, PR, push, merge, tag, platform API, external network, model, worktree, subagent, MCP, or business source mutation occurred.';
2
+
3
+ export const automationReadinessBoundaryText = 'Boundary: writes=false; automation_readiness_artifact=false; automation_plan_artifact=false; one_shot_execution_artifact=false; command_execution=false; scheduler=false; daemon=false; retry=false; git=false; pr=false; push=false; merge=false; platform_api=false; external_network=false; model_invocation=false; subagent=false; business_source_write=false';
4
+
5
+ export const automationStageRunbookActionText = 'sequential-stage-runbook plus runbook-executor-preview dry-run contract was computed read-only from one local plan file, optional Stage 117 executable plan JSON, automation readiness registry digest, autopilot-lab budget contract, and registry. No command execution, check/test execution, source write, plan mutation, runbook artifact write, sidecar write, state directory, git, commit, PR, push, merge, tag, platform API, external network, model, MCP, subagent, scheduler, daemon, retry, worktree, or business source mutation occurred.';
6
+
7
+ export const automationConfirmedPlanActionText = 'confirmed-one-shot-execution-plan contract was computed read-only from one local plan file, Stage 107 commit readiness, Stage 103 automation readiness, registry, and --confirm-plan. Confirmation means plan contract confirmation only. No action execution, command execution, check/test execution, repair, formatting, code generation, sidecar write, git, commit, PR, push, merge, platform API, external network, model, subagent, MCP, daemon, scheduler, retry, or business source mutation occurred.';