@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,2265 @@
1
+ # Runtime Roadmap
2
+
3
+ 本文档定义 Vibecoding Kit 流程自动 runtime 的分阶段路线。
4
+
5
+ 文档层级:L3 维护者 / 治理层。这里保留 runtime stage、边界、检查和长期演进细节;新用户和业务项目 agent 不应从这里开始,而应先读 `README.md`、`docs/user-guide.md` 和 `docs/quick-recipes.md`。
6
+
7
+ ## 目标
8
+
9
+ 把当前显式 `Workflow Handoff` 升级为可观测、可恢复、可检查的本地状态机。
10
+
11
+ runtime 是可选层,不替代 workflow skill。skill 仍是语义来源,runtime 只读取 contract、检查状态和生成建议。
12
+
13
+ ## Adoption priority track
14
+
15
+ P39-P43 聚焦降低日常采用成本,而不是扩大执行面:
16
+
17
+ 1. `first 10 minutes` quickstart:README 和 runtime README 必须让用户先理解 install、profile、workflow start 和 readiness 的只读路径。
18
+ 2. `profile --explain` 人类可读输出:普通用户应能一眼区分 `default`、`legacy-workflow-discipline`、`execution-enabled`。
19
+ 3. `docs/quick-recipes.md`:只提供可复制的 read-only / smoke / boundary recipe,并标注 `writes=false`、`.tmp`、`.vibecoding-state` 和 Windows PowerShell 注意事项。
20
+ 4. installed template parity:`templates/AGENTS.md`、`templates/CLAUDE.md` 和 install smoke 保持业务项目降级交互协议,不注入源码仓库完整 workflow。
21
+ 5. controlled execution next boundary:只审查 contract、negative markers、execution surface 和 release smoke,不新增 action catalog、不新增 business source write、不新增 git write、不新增 platform API/subagent/model/MCP/daemon/watcher/hidden background chain。
22
+
23
+ ## 维护性边界
24
+
25
+ 本路线的实现侧保持 owner module 收敛:runtime entry 只做 CLI 路由和 dispatcher glue,command container、state path、state IO、completion descriptor、completion chain assembly、readiness summary、bundle invariant、runtime-check marker contract 和 release smoke manifest 都由具名模块拥有。后续新增 stage、smoke 或 marker 时优先扩展对应 domain owner,不扩大 `tools/vibe-runtime/index.mjs`、`tools/vibe-runtime-check/index.mjs` 或 `runtime-completion-evidence-bundle.mjs`。
26
+
27
+ 核心依赖方向保持不变:runtime core 不依赖 CLI / doctor / runtime-check / release-check,runtime-check / release-check 只作为外层验证聚合器读取源码、文档和本地 fixture。
28
+
29
+ 技术债务按维护者账本处理,不作为“顺手优化”隐藏在功能任务里。当前债务分为文档债务、架构债务、验证债务和产品体验债务;具体 owner、paydown 方式和阻塞验证见 `docs/runtime-maintainer-validation.md` 的 `Technical Debt Register`。任何债务偿还都不得通过提高 architecture baseline、降低 runtime-check 严格度、删除 negative smoke 或扩展 execution surface 完成。
30
+
31
+ ## Long-term productization task index
32
+
33
+ P54 把 Stage 121-156 从“能力 stage 长表”整理为长期产品任务总账。该索引只做规划和验收路由,不新增 runtime command、不改变 suite 范围、不授权执行。
34
+
35
+ | 任务 | Stage 来源 | 产品主题 | Owner | 验收重点 |
36
+ | --- | --- | --- | --- | --- |
37
+ | P55 `adoption_funnel_v2` | Stage 126/127/143 | 安装前、首次安装、首次会话、首次 evidence、首次收口 | README / user guide / quick recipes / team adoption | L1/L2/L3 路径清楚,用户不必读 stage 长表 |
38
+ | P56 `installed_first_session_acceptance` | Stage 131/134/142 | installed project 首次会话验收 | templates / adapters / install smoke | lightweight routing、no full skill injection、no auto execution |
39
+ | P57 `evidence_supply_chain_v2` | Stage 124/151-156 | 本地 evidence supply chain | templates/evidence / docs/evidence / examples/ci | requirement/product/UI/architecture/task/test/diff/completion digest chain |
40
+ | P58 `artifact_gate_productization` | Stage 151-156 | Product / UI / Architecture artifact gate | templates / examples/full-chain / release-check | gate 只读,full-chain demo 可复验 |
41
+ | P59 `behavior_eval_pack_v2` | Stage 121/138/145 | deterministic behavior eval pack | release-check / examples / reference docs | negative fixture 覆盖自动提交、隐式 subagent、跳过 evidence、误读 `ok=false`、无验证完成声明;无 live eval/model judge |
42
+ | P60 `experience_loop_v2` | Stage 126-132/139/143 | friction → next action → dashboard → evidence prompt | runtime README / roadmap / release-check | 只给人工下一步和证据缺口,不执行 check/test/workflow |
43
+ | P61 `token_context_economy_v2` | Stage 128/144 | entry context budget defaults | runtime README / quick recipes / templates | tiny/balanced/full maintenance,no prompt mutation/embeddings/remote config |
44
+ | P62 `adapter_plugin_maturity` | Stage 122/137/148 | adapter packaging consistency and install score | plugin pack / adapters / release guide | dry-run audit,不 publish/tag/release/upload |
45
+ | P63 `legacy_workflow_discipline_expression_v2` | Stage 133/140/P25-P31 | safe governance vs opt-in parity | README / roadmap / runtime README | `legacy-workflow-discipline` 与 `execution-enabled` 分离 |
46
+ | P64 `contributor_closeout_guardrails` | Stage 20/120/124/146/147 | session close、completion、commit、PR、subagent 收口纪律 | release guide / maintainer validation / release-check | `session --close` 只读复用 completion evidence bundle;当前合同不授权 git/PR/subagent,仅给人工下一步 |
47
+ | P65 `architecture_paydown_sprint` | Technical Debt Register | owner-local extraction | runtime / runtime-check / release-check owners | active/new 0,baseline total 不高于 394,不提高 baseline |
48
+ | P66 `release_evidence_governance` | P52 + Stage 121-156 | 长期 release evidence matrix | release-check reference / maintainer validation | 按影响范围绑定 release/runtime/arch gates,确认 state absence |
49
+
50
+ P54 任务索引固定边界:`runtime_command_added=false`、`execution_surface_added=false`、`state_directory_created=false`、`command_execution=false`、`test_execution=false`、`workflow_execution=false`、`skill_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`git_write=false`、`business_source_write=false`。
51
+
52
+ ### P60 Experience Loop v2 delivery frame
53
+
54
+ P60 不新增 runtime command,只把已存在的 Stage 126-132 / 139 / 143 产品能力整理成一个可解释闭环:`experience_friction_matrix -> next_action_console -> experience_regression_dashboard -> experience_upgrade_prioritizer -> next_action_evidence_prompts`。
55
+
56
+ 该闭环的职责边界是把“体验问题”翻译成三类人工可执行信息:`manual_next_action_only`、`evidence_gap_only`、`do_not_do_yet_visible`。维护者阅读顺序固定为:先看 friction priority,再看 next action,再看 dashboard regression blocker,再看 upgrade order,最后用 prompt cards 补齐 evidence。P60 验收只检查文档和 marker 是否保护该链路;不运行 check/test/workflow,不写 evidence,不创建 `.vibecoding-state/`,不扩大 `execution-enabled` 或 `legacy-workflow-discipline`。
57
+
58
+ P60 marker 固定为:`p60_experience_loop_v2`、`friction_to_next_action_to_dashboard_to_upgrade_to_prompts`、`manual_next_action_only`、`evidence_gap_only`、`do_not_do_yet_visible`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`workflow_execution=false`、`evidence_write=false`、`state_directory_created=false`、`git_write=false`、`subagent=false`、`platform_api=false`、`model_invocation=false`。
59
+
60
+ ## 分层路线
61
+
62
+ ```text
63
+ 阶段 0:Runtime Contract
64
+ 定义 skill contract、handoff contract、执行边界和禁止动作。
65
+
66
+ 阶段 1:只读 Runtime Check
67
+ 检查 workflow skill 是否具备可被 runtime 消费的结构。
68
+
69
+ 阶段 2:Workflow State Ledger
70
+ 用户显式启用后,把当前 workflow 状态记录到本地状态目录。
71
+
72
+ 阶段 3:半自动 Orchestrator
73
+ 根据 state 和 contract 输出下一步建议,默认 dry-run。
74
+
75
+ 阶段 4:Task Brief / Review Gate 文件化
76
+ 生成任务 brief、review gate 和 evidence 文件,不自动派发 reviewer。
77
+
78
+ 阶段 5:平台 Adapter Runtime Bridge
79
+ 把可选 runtime 能力暴露给 Claude、Codex、Cursor,默认不启用。
80
+
81
+ 阶段 6:Confirm Dispatch Gate
82
+ 用户显式确认后写入 adapter-readable dispatch event,但不执行 skill。
83
+
84
+ 阶段 6.5:Dispatch Event Audit Gate
85
+ 只读列出、查看和校验 dispatch event,不标记 consumed。
86
+
87
+ 阶段 7:Dispatch Claim / Ack Gate
88
+ 显式领取和确认 dispatch event 的处理状态,防止重复 pickup;不执行 skill。
89
+
90
+ 阶段 8:Adapter Pickup Package Gate
91
+ 输出 adapter / human 可读取的 pickup package;不接 Claude、Codex 或 Cursor API。
92
+
93
+ 阶段 9:Supervised Executor Gate
94
+ 在人工确认下生成并记录受监管执行 envelope;默认仍不做无人值守执行。
95
+
96
+ 阶段 10:Optional Daemon / Watcher Gate
97
+ 只在前序状态机稳定后评估 `--once` 或 watcher;默认关闭。
98
+
99
+ 阶段 11:Supervised Real Executor v1
100
+ 在显式 `--confirm --run` 下执行 allowlist 内本地受监管 runtime action,记录 execution lifecycle;不接平台 API、不改业务源码。
101
+
102
+ 阶段 12:Executor Candidate Planning
103
+ 从 dispatch / claim / workflow ledger / execution history 生成可验证执行候选;默认 no-write,不执行 runtime action。
104
+
105
+ 阶段 13:Dry-run Simulation / Approval Package
106
+ 把候选转换成仿真和审批包;只模拟 expected writes、evidence 和 recovery,不执行 runtime action。
107
+
108
+ 阶段 14:Controlled Automatic Execution
109
+ 在显式 approval、policy、lock/lease 和 allowlist 下执行受控本地 runtime action;仍不执行 workflow skill、不接平台 API、不改业务源码。
110
+
111
+ P32-P38:execution-enabled 受控本地执行 profile
112
+ `execution-enabled` 是 profile alias,绑定 `execution_profile` 与 `controlled-local-runtime`,只允许显式 config write boundary、execution preflight、candidate/approval/queue、foreground controlled local run 和 evidence audit;source/git/subagent not authorized,且不授权 hidden background chain、platform API、model invocation、MCP、daemon、watcher、business source write、commit、push、PR 或 merge。
113
+
114
+ 阶段 15:Auto-run Policy DSL
115
+ 把自动执行许可收敛为内置可验证 policy profile / DSL / digest;不扩大执行能力。
116
+
117
+ 阶段 16:Candidate Queue / Scheduler Scan
118
+ 把多个 candidate 聚合为可排序、可审计 queue;scheduler scan 默认只读,不自动执行。
119
+
120
+ 阶段 17:Approval Lifecycle
121
+ 把 approval artifact 扩展为本地 lifecycle sidecar,支持显式 transition、过期/撤销/拒绝/消费 gate;不接外部审批平台。
122
+
123
+ 阶段 18:Runtime Action Catalog
124
+ 把可执行 runtime action 固化为内置只读 catalog、digest 和 action gate;未知 action 默认拒绝。
125
+
126
+ 阶段 19:Lease / Recovery / Retry Package
127
+ 把 lock、running execution、stale 状态和 retry 候选收敛成可审计恢复包;不自动 retry、不清理 lock。
128
+
129
+ 阶段 20:Observability and Readiness Scoring
130
+ 汇总 queue、lease、recovery 和 execution history 为 deterministic readiness score;只解释,不改变 gate。
131
+
132
+ 阶段 21:Scheduler Plan / Dry-run Scheduler
133
+ 把 queue promotion preview 升级为可验证 scheduler plan;默认只读,不执行 auto-run。
134
+
135
+ 阶段 22:Scheduler Policy / Runtime Budget
136
+ 为 scheduler once-run 增加内置 policy、budget、kill switch 和 digest gate;不读取远程 policy、不动态执行配置。
137
+
138
+ 阶段 23:Single-shot Scheduler Worker
139
+ 在显式确认下执行一次 scheduler 选择:扫描、重验、拿 scheduler lease、调用既有 controlled auto-run,并写 scheduler run audit;不启动 loop/daemon。
140
+
141
+ 阶段 24:Recovery Classifier
142
+ 把 lease、execution、queue blocked 和 scheduler lease 状态分类为可验证 recovery findings;默认只读,不执行恢复。
143
+
144
+ 阶段 25:Confirmed Auto Recovery
145
+ 在显式确认下每次最多处理一个 eligible recovery finding,只写 recovery run / retry package audit;不清理、不删除、不执行 retry。
146
+
147
+ 阶段 26:Scheduler + Recovery Integration
148
+ scheduler plan 展示 recovery hints;`scheduler --once --recover --confirm` 只走 confirmed recovery path,每次最多一个 finding,不混合 normal execution。
149
+
150
+ 阶段 27:Bounded Auto Retry
151
+ 只对严格识别的 transient failure 允许一次显式确认 retry,绑定 retry package、approval、policy、budget 和 catalog digest;不扩大 action catalog。
152
+
153
+ 阶段 28:Foreground Bounded Loop
154
+ 提供有限轮次 foreground loop/run envelope,带 heartbeat、stop file、kill switch、max iterations 和 no duplicate execution;不注册 watcher、不创建后台服务。
155
+
156
+ 阶段 29:Unified Runtime Trace Ledger
157
+ 把 scheduler、recovery、retry、daemon loop、reply 和 observability 本地产物串成 digest-bound trace ledger;只读审计或显式确认写 trace,不执行动作。
158
+
159
+ 阶段 30:Readiness / Observability Expansion
160
+ 将 readiness 扩展到 retry、foreground loop、reply pipeline 和 runtime trace health;只解释健康状态,不改变 gate。
161
+
162
+ Reply A-D:Automatic Reply Pipeline
163
+ 自动回复单独拆线:Reply Draft、Reply Approval、Local Outbox、Adapter-specific Send;第一批只写本地 draft/approval/outbox/send gate audit,不发送外部消息。
164
+
165
+ Reply E:Source-bound Local Reply Draft
166
+ `reply --draft --source-bound` 把本地回复草稿绑定 workflow、latest execution、scheduler/recovery/retry run、observability snapshot 和 runtime trace manifest;仍不调用模型、不发送外部消息。
167
+
168
+ Reply F:Source-bound Reply Review Gate
169
+ `reply --review <draft-file>` 为 source-bound draft 写本地 review sidecar,approval/outbox/send 必须递归验证 review -> draft -> source manifest;仍不生成新回复、不调用模型、不发送外部消息。
170
+
171
+ 阶段 31:Governance Attestation / Boundary Audit
172
+ `governance --attest` 把 trace、observability 和 reply review chain 汇总为本地治理断言,证明边界未越界;只做证明,不执行、不修复。
173
+
174
+ 阶段 32:Methodology Gate Ledger / external reference 方法论吸收
175
+ `methodology --gate --kind <spec|plan|tdd|debug|review|completion>` 把 spec、plan、TDD、debugging、review 和 completion 纪律转为本地可验证 gate ledger;只证明流程纪律,不执行 workflow skill。
176
+
177
+ 阶段 33:Hook Intent Contract
178
+ 把 hook 从隐式执行器降级成可审计输入;默认只读,显式确认也只写 hook intent,不触发 scheduler、不派发 subagent。
179
+
180
+ 阶段 34:Scheduler Plan from Hook
181
+ 把已验证 hook intent 转换为 scheduler dry-run plan artifact;默认只读,显式确认也只写计划,不运行 scheduler、不派发 subagent。
182
+
183
+ 阶段 35:Subagent Dispatch Eligibility Gate
184
+ 把 `vibe-subagent-driven-development` 的用户许可、brief 完整性、文件隔离、review gate、fallback 和平台能力前置条件机器化为本地 eligibility artifact;不派发 subagent、不创建 session。
185
+
186
+ 阶段 36:Approved Subagent Dispatch Artifact
187
+ 从已验证 scheduler hook plan 与 subagent eligibility 生成 approved dispatch order;只写派发单,不调用平台 API、不启动 subagent session。
188
+
189
+ 阶段 37:Single-shot Agent Scheduler Run
190
+ 显式确认后消费一个 approved dispatch,写 scheduler run、subagent lease 和 local result audit;前台单次,不启动 watcher/daemon,不创建真实平台 session。
191
+
192
+ 阶段 61:Local Learning Observation Ledger
193
+ `learning --observe --from-file <session-evidence-file>` 只从本地 evidence file 生成 `.vibecoding-state/learning/*.learning-observation.json`;preview 不写状态,confirm 只写 learning sidecar,不自动修改 skills、prompt、hook、AGENTS.md 或 CLAUDE.md。
194
+ 阶段 151:Product/UI Methodology Artifact Gate
195
+ `methodology --gate --kind <product-discovery|product-spec|ui-design|product-acceptance|scenario-acceptance> --from-file <artifact>` 只读检查标准 artifact、source_skill、next_skill、必填 section/field、evidence 和边界断言;不写 state、不执行 skill。
196
+
197
+ 阶段 152:Product Completion Evidence Bundle
198
+ `completion --evidence-bundle --from-product-discovery ... --from-evidence ...` 只读聚合产品/UI/场景/验收/工程证据 digest,输出 readiness、evidence gaps 和 next_manual_action;不运行测试、不浏览器、不 git。
199
+
200
+ 阶段 153:Architecture Design Artifact Gate
201
+ `methodology --gate --kind <architecture-design|delivery-traceability> --from-file <artifact>` 的 architecture-design 分支只读检查架构 owner、layer、dependency direction、data flow、state lifecycle、contract sync、blast radius、verification strategy、Evidence 和 Boundary,输出 `delivery-methodology-gate` 与 `gate_digest`。
202
+
203
+ 阶段 154:Delivery Traceability Artifact Gate
204
+ `methodology --gate --kind <architecture-design|delivery-traceability> --from-file <artifact>` 的 delivery-traceability 分支只读检查需求、产品、UI、架构、任务、测试、场景、验收和 commit-readiness ref 的 traceability links,输出 `delivery-methodology-gate`、link count、statuses 和 boundary assertions。
205
+
206
+ 阶段 155:Full-chain Product Completion Evidence Bundle
207
+ `completion --evidence-bundle --from-product-discovery ... --from-architecture ... --from-traceability ... --from-commit-readiness ...` 只读聚合 `architecture_chain`、`traceability_chain`、`implementation_chain`、`release_readiness_chain`、`test_evidence_digest`、`diff_coverage_digest` 和 `commit_readiness_digest`;保持 `commit_execution_authorized=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`。
208
+ ```
209
+
210
+
211
+ 当前已落地阶段 0、阶段 1、阶段 2,并进入阶段 3 JSON handoff 互操作和 `next --dry-run` 文本建议增强;Stage 4 第一批开始提供显式 artifacts 文件化产物:
212
+
213
+ - runtime roadmap。
214
+ - runtime contract。
215
+ - 只读 `vibe-runtime-check`。
216
+ - 显式 `vibe-runtime` state ledger。
217
+ - `JSON handoff` 推荐格式。
218
+ - `JSON-first` handoff 解析与 `legacy fallback` 兼容。
219
+ - `next --dry-run` 输出 `idle` / `ready` / `blocked` / `stopped` 文本建议。
220
+ - `status` 输出只读 ledger 摘要,包括范围、风险、验收、文件、证据、任务状态、task dependency readiness 和 review 状态。
221
+ - `record-handoff` 成功后输出 handoff quality 文本提示,提示不阻止写入、不改变状态结构、不执行下一步。
222
+ - `artifacts --dry-run` 默认预览 task brief、review gate 和 evidence skeleton,不写文件。
223
+ - `artifacts --write` 只写 `.vibecoding-state/task-brief.md`、`.vibecoding-state/review-gate.md` 和 `.vibecoding-state/evidence.md`,不写业务源码或 repo 根目录。
224
+ - `tasks --dry-run` 默认预览任务级 brief、report、review gate 和 evidence skeleton,不写文件。
225
+ - `tasks --write` 只写 `.vibecoding-state/tasks/<task-id>/brief.md`、`report.md`、`review-gate.md` 和 `evidence.md`,不写业务源码或执行任务;task id 必须通过路径安全校验,包括拒绝路径穿越、Windows 保留设备名和尾随 `.` / 空格。
226
+ - `validate-handoff --from-file` 只读校验 handoff,输出 normalized 摘要和 handoff quality 提示,不创建 `.vibecoding-state/` 或写 workflow state。
227
+ - `tasks --dry-run --task <task-id>` / `tasks --write --task <task-id>` 支持只预览或写入一个已记录 task 的 artifacts,找不到 task 或 task id 不安全时失败且不写文件。
228
+ - `depends_on` 支持同一 workflow handoff 内 task dependency contract:依赖 id 必须安全、存在、不能自依赖,且 dependency graph 不能成环。
229
+ - `status`、`validate-handoff`、`next --dry-run` 和任务级 artifacts 可展示只读 `Task readiness` 摘要;readiness 只辅助人工判断,不自动选择或执行 task。
230
+ - Stage 4.7 `status --json`、`validate-handoff --json`、`next --dry-run --json` 和 `tasks --dry-run --json` 提供统一 JSON envelope,包含 `schema_version`、`command`、`mode`、`ok`、`state_present`、`summary`、`tasks`、`quality` 和 `action`,用于未来 adapter bridge 消费。
231
+ - Stage 5.x `next --dry-run --dispatch-intent` 提供 adapter-ready 的只读 intent preview;`--json` 输出 `intent`、`gates`、`runtimeBridge`、`platform_hints` 和 `safety.dispatch_event=false`,但不写 dispatch event、不执行 skill、不调用 subagent / MCP / daemon、不触碰 git / worktree。
232
+ - Stage 6.x `next --confirm --dispatch` 提供显式确认的 confirm-dispatch gate;所有 gate 通过后只写 `.vibecoding-state/dispatches/<timestamp>.json`,输出 adapter-readable dispatch envelope,不执行 skill、不调用平台 API / subagent / MCP / daemon、不触碰 git / worktree / branch / stash、不写业务源码。
233
+ - Stage 6.x `next --confirm --dispatch --json` 输出可解析 confirm-dispatch envelope,并写入同一 dispatch event;该 `--json` 是执行结果 envelope,不属于 Stage 4/5 read-only JSON。
234
+ - Stage 6.5 `dispatches --list`、`dispatches --show <event-file>` 和 `dispatches --verify <event-file>` 提供 read-only dispatch audit;只读取 `.vibecoding-state/dispatches/`,输出 confirm-dispatch event verification 摘要,不执行 skill、不调用平台 API / subagent / MCP / daemon、不触碰 git / worktree、不写业务源码。
235
+ - Stage 7 `dispatches --claim <event-file> --actor <id>`、`dispatches --ack <event-file> --actor <id> --status <picked|skipped|failed>` 和 `dispatches --claims` 提供 dispatch claim / ack state;只写 `.vibecoding-state/dispatch-claims/<event-file>.claim.json`,不修改原始 dispatch event,不执行 skill、不调用平台 API / subagent / MCP / daemon、不触碰 git / worktree、不写业务源码。Stage 7.1/7.2/7.3 覆盖 claim input hardening、ack lifecycle hardening 和 claims audit hardening;Stage 7.5/7.6/7.9/7.10 进一步覆盖 stale claim audit、recovery preview、`skipped` / `failed` ack reason 必填和 claim event digest enforcement。
236
+ - Stage 8 保持为 Adapter Pickup Package Gate:输出 adapter / human 可读取的 pickup package,不接 Claude、Codex 或 Cursor API。Stage 8.1/8.2/8.3 覆盖 pickup package manifest、pickup readiness gates 和 pickup read-only audit;Stage 8.4/8.6-8.10 增强 `ready_for_adapter`、`event_valid`、`claim_picked`、`target_skill_present`、`entry_file_present`、`event_sha256` / `claim_sha256` / `workflow_sha256` / `handoff_sha256`、`dispatches --pickup-verify`、`dispatches --pickup-dry-run`、platform capability matrix 和 no-session adapter dry-run。
237
+ - Stage 9 保持为 Supervised Executor Gate:在人工确认下生成并记录受监管 planned execution envelope,不做无人值守执行。Stage 9.1-9.11 拆成完整 planned execution contract:dry-run execution plan、confirm planned envelope、claim picked gate、no execution boundary、execution envelope safety、immutability、execution preflight audit、planned envelope verify、stable `idempotency_key`、execution policy snapshot 和 write boundary preview;兼容 marker 仍保留 Stage 9.1 execution preflight gates、Stage 9.2 execution preflight audit / planned execution envelope、Stage 9.3 immutability guarantees 和 Stage 9.5 idempotency / policy snapshot。
238
+ - Stage 10 保持为 Optional Daemon / Watcher Gate:默认关闭,优先评估 `--once` 而不是常驻后台 worker。Stage 10.1/10.2 覆盖 daemon command gate 和 once-run envelope;Stage 10.3-10.6/10.8/10.11-10.13 覆盖 scheduler scan dry-run、scheduler policy dry-run、stale claim / stale running audit、retry policy preview、once scan no-op envelope、concurrency lock contract、watcher disabled contract 和 lease / heartbeat model;不扫描执行队列、不调用 `execute`、不 pickup claim、不修改 dispatch/claim/execution。
239
+ - Stage 11 `execute --from-dispatch <event-file> --confirm --actor <id> --run` 提供 Supervised Real Executor v1:只执行 allowlist 内本地受监管 runtime action,写入 `.vibecoding-state/executions/<timestamp>-<dispatch-hash>.execution.json` lifecycle record,状态包含 `planned` / `running` / `succeeded` / `failed` / `timed_out` / `cancelled`;同时提供 `executions --list`、`executions --show <execution-file>` 和 `executions --verify <execution-file>` 只读 execution audit。不接 Claude / Codex / Cursor API,不调用 subagent / MCP / daemon,不触碰 git / worktree,不写业务源码。
240
+ - Stage 11.1 `Execution Audit Hardening` 收紧 Supervised Real Executor v1:`execute --confirm --run` 先持久化同一 execution file 的 `running` record,再原子更新为 terminal status;`executions --verify` 对 `supervised-run` 强制 lifecycle、terminal status、timestamp、evidence、allowlist 和 safety 边界,文本 safety 与 JSON safety 保持一致。
241
+ - Stage 11.2 `Run Preflight Parity` 让 `--run` record 带上与 `--preflight` 一致的 gates、policy 和 write boundary 摘要,方便审计为什么允许进入 runtime action。
242
+ - Stage 11.3 `Runtime Action Contract` 固定唯一 runtime action 为 `generate-supervised-handoff-package`,record 必须包含 action contract、input summary、output summary,并继续保持 `skill_execution=false` 和 `business_source_write=false`。
243
+ - Stage 11.4 `Terminal Failure Lifecycle` 支持进入 run 后把同一 execution file 从 `running` 原子更新为 `failed`,失败 evidence 可被 `executions --verify` 审计。
244
+ - Stage 11.5 `Timeout Lifecycle Boundary` 支持受控 timeout terminal status:`timed_out`,保留 running 起点、timeout evidence 和 safety 边界。
245
+ - Stage 11.6 `Cancellation Lifecycle Boundary` 支持可审计 `cancelled` terminal status;无法完成更新时仍以 stale `running` record 暴露。
246
+ - Stage 11.7 `Execution Stale / Active Audit` 让 `executions --list/show/verify` 输出 active、terminal、age_ms 和 stale 分类;审计保持只读。
247
+ - Stage 11.8 `Run Idempotency Guard` 阻止同一 event digest、actor 和 target skill 的 active running run 重复启动;terminal 历史只作为审计记录。
248
+ - Stage 11.9 `Run Policy Snapshot Hardening` 对 supervised-run 强校验 policy name/version、allowlist snapshot、forbidden actions 和 runtime action contract。
249
+ - Stage 151 `Product/UI Methodology Artifact Gate` 新增 `methodology --gate --kind <product-discovery|product-spec|ui-design|product-acceptance|scenario-acceptance> --from-file <artifact>`:只读检查标准 artifact、source_skill、next_skill、必填 section/field、evidence 和 boundary assertions,输出 `product_methodology_gate`、`gate_digest` 与 blocked reasons;不写 `.vibecoding-state/`、不执行 workflow skill、不运行测试/浏览器、不调用 subagent/MCP/platform/git。
250
+ - Stage 152 `Product Completion Evidence Bundle` 新增 `completion --evidence-bundle --from-product-discovery ... --from-product-spec ... --from-ui-design ... --from-scenarios ... --from-product-acceptance ... --from-evidence ...`:只读聚合产品/UI/场景/验收/工程证据 digest,输出 `requirements_chain`、`product_readiness`、`ui_readiness`、`engineering_readiness`、`evidence_gaps`、`blocked_reasons`、`next_manual_action` 和 `bundle_digest`;不执行验证命令、不写 evidence、不 git。
251
+ - Stage 153 `Architecture Design Artifact Gate` 新增 `methodology --gate --kind <architecture-design|delivery-traceability> --from-file <artifact>` 的 architecture-design 只读分支:检查 `architecture-design` artifact 的 owner、layer、dependency direction、data flow、state lifecycle、contract sync、blast radius、verification strategy、Evidence 和 Boundary,输出 `delivery-methodology-gate`、`gate_digest` 与 blocked reasons。
252
+ - Stage 154 `Delivery Traceability Artifact Gate` 新增 `methodology --gate --kind <architecture-design|delivery-traceability> --from-file <artifact>` 的 delivery-traceability 只读分支:检查 `delivery-traceability` links、需求/产品/UI/架构/任务/测试/场景/验收 ref、status enum、boundary assertions 和 digest。
253
+ - Stage 155 `Full-chain Product Completion Evidence Bundle` 扩展 `completion --evidence-bundle --from-product-discovery ... --from-architecture ... --from-traceability ... --from-commit-readiness ...`:只读聚合 `architecture_chain`、`traceability_chain`、`implementation_chain`、`release_readiness_chain`、`test_evidence_digest`、`diff_coverage_digest` 和 `commit_readiness_digest`;保持 `commit_execution_authorized=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`。
254
+ - Stage 11.10 `Release / Docs / Smoke Sync` 同步 roadmap、contract、README、acceptance checklist、runtime-check marker 和 release smoke,覆盖成功 run、失败/超时/取消 lifecycle、active duplicate guard、corrupted record 和只读 audit。
255
+ - Stage 12 `Executor Candidate Planning` 新增 `execute --candidate`:从 dispatch event、claim、workflow ledger、pickup digest 和 execution history 生成 execution candidate envelope;Stage 12.1-12.10 覆盖 Candidate Source Model、Candidate Readiness Gates、Candidate Policy Intent、Candidate Risk Profile、Candidate Idempotency Preview、Candidate History Awareness、Candidate Audit Commands、Candidate Persistence Boundary、Candidate Verification 和 Docs / Check / Smoke Sync。Stage 12 默认 no-write;`--confirm` 只写 `.vibecoding-state/execution-candidates/<timestamp>-<dispatch-hash>.candidate.json`,不写 executions、不执行 runtime action、不改 dispatch/claim。
256
+ - Stage 13 `Dry-run Simulation / Approval Package` 新增 `execute --approval-package --approval <candidate-file> --confirm`:把 Stage 12 candidate 转换成审批包;Stage 13.1-13.10 覆盖 Simulation Input Contract、Simulated Action Plan、Approval Package Manifest、Recovery Plan Preview、Evidence Completeness Preview、Simulation Policy Verification、Approval State Boundary、Replayable Dry-run Output、Simulation Audit Commands 和 Docs / Check / Smoke Sync。审批包只写 `.vibecoding-state/execution-approvals/<timestamp>-<candidate-hash>.approval.json`,不执行 runtime action。
257
+ - Stage 14 `Controlled Automatic Execution` 新增 `execute --from-dispatch <event-file> --confirm --actor <id> --run --auto-run --approval <approval-file>`:显式绑定 Stage 13 approval、policy snapshot、local lock 和 allowlist 后执行唯一受控 runtime action。Stage 14.1-14.10 覆盖 Auto-run Explicit Enable Gate、Auto-run Policy Contract、Approval Binding Gate、Active Lock / Lease Gate、Controlled Runtime Action Execution、Auto-run Lifecycle Record、Compensation / Recovery Evidence、Auto-run Audit Commands、Auto-run Negative Policy Smoke 和 Release / Docs / Smoke Sync。Stage 2 controlled execution contract 同步输出 `controlled_execution_gate`,包含 `stage='stage-2-controlled-execution'`、gate order、manual approval、evidence audit 和 negative fixtures;arbitrary shell string、hidden background chain、automatic repair or repeat-on-failure、git/source mutation、platform API/model/MCP、real subagent session、scheduler/daemon/watcher 必须全部 blocked。Stage 14 仍不执行 workflow skill、不接平台 API、不调用 subagent/MCP/daemon、不触碰 git/worktree、不写业务源码。
258
+ - Stage 15 `Auto-run Policy DSL` 新增内置 `policies --list` 与 `policies --show <profile>`:把 auto-run policy 收敛为 `strict`、`controlled-local-runtime`、`review-only` 三个 builtin data-only profile,profile snapshot 包含 name、version、stage、profile、mode、default_enabled=false、allowlist、runtime actions、forbidden actions、expected writes、risk ceiling、approval、limits 和 `policy_digest`。Stage 15.1-15.10 覆盖 Policy Profile Model、Policy DSL Schema、Policy Source Boundary、Policy Evaluation Envelope、Risk Gate Contract、Approval Requirement Contract、Policy Snapshot Binding、Policy Audit Commands、Policy Negative Smoke 和 Docs / Check / Smoke Sync。Stage 15 不加载外部脚本、不动态 eval、不读取远程 policy、不执行 runtime action。
259
+ - Stage 16 `Candidate Queue / Scheduler Scan` 新增 `queue --scan`、`queue --scan --confirm`、`queue --list`、`queue --show <queue-file>` 和 `queue --verify <queue-file>`:从 `.vibecoding-state/execution-candidates/` 与 `.vibecoding-state/execution-approvals/` 生成 deterministic queue item、blocked reasons、priority 和 promotion preview。Stage 16.1-16.10 覆盖 Queue Source Model、Queue Item Envelope、Queue Readiness Gates、Queue Priority Model、Scheduler Scan Contract、Optional Queue Persistence Boundary、Queue Audit Commands、Scheduler Promotion Preview、Queue Negative Smoke 和 Docs / Check / Smoke Sync。Stage 16 默认 no-write;只有 `queue --scan --confirm` 写 `.vibecoding-state/execution-queue/*.queue.json`,不调用 `execute --auto-run`,不启动 daemon/worker/watcher,不修改 dispatch/claim/execution。
260
+ - Stage 17 `Approval Lifecycle` 新增 `approvals --list`、`approvals --show <approval-file>`、`approvals --verify <approval-file>` 和 `approvals --transition <approval-file> --status <approved|rejected|expired|revoked> --actor <id> --reason <text> [--confirm]`:approval confirm 会写 `.vibecoding-state/approval-lifecycle/*.approval-lifecycle.json` sidecar,记录 state、audit trail、candidate digest、policy digest 和 action catalog digest;transition 默认 preview no-write,只有显式 `--confirm` 写 lifecycle sidecar。rejected、expired、revoked、consumed 会阻断 controlled auto-run;成功 controlled auto-run 会写 consumed lifecycle evidence,不改原 approval artifact。
261
+ - Stage 18 `Runtime Action Catalog` 新增 `actions --list`、`actions --show <action-id>` 和 `actions --verify <action-id>`:唯一内置 action 为 `generate-supervised-handoff-package`,catalog 固定 builtin data-only、`default_allow_unknown=false`、`catalog_digest`、capability、risk、required inputs、writes、idempotency 和 recovery boundary。candidate、approval、policy evaluation、queue scan 和 controlled auto-run 都绑定并校验 action catalog digest;未知 action 默认 blocked。
262
+ - Stage 19 `Lease / Recovery / Retry Package` 新增 `leases --list`、`leases --show <lease-file>`、`leases --verify <lease-file>`、`recovery --preview`、`recovery --preview --confirm`、`recovery --show <recovery-file>` 和 `recovery --verify <recovery-file>`:读取 auto-run locks、running executions、queue blocked 状态和 retry candidates,生成 recovery package preview。Stage 19.1-19.10 覆盖 Lease Source Model、Lease Envelope Schema、Lease Audit Command、Recovery Package Model、Recovery Package Persistence Boundary、Retry Eligibility Model、Retry Package Contract、Recovery / Retry Audit Commands、Negative Smoke 和 Docs / Check / Smoke Sync。Stage 19 默认 no-write;只有 `recovery --preview --confirm` 写 `.vibecoding-state/recovery-packages/*.recovery.json`,不释放 lock、不删除 execution、不自动 retry、不重放 auto-run。
263
+ - Stage 20 `Observability and Readiness Scoring` 新增 `observability --summary`、`readiness --score` 和显式 `--confirm` snapshot:从 workflow、queue、candidate、approval、execution、lock/lease 和 recovery package 汇总 deterministic readiness score。Stage 20.1-20.10 覆盖 Observability Source Model、Readiness Score Schema、Scoring Dimensions、Deterministic Scoring Rules、Readiness Gate Mapping、Observability Command、Optional Snapshot Boundary、Report / Text Output、Negative Smoke 和 Docs / Check / Smoke Sync。Stage 20 默认 no-write;只有 `observability --summary --confirm` 或 `readiness --score --confirm` 写 `.vibecoding-state/observability/*.observability.json`,不改变 gate、不提升 queue item、不触发执行。
264
+ - Stage 21 `Scheduler Plan / Dry-run Scheduler` 新增 `scheduler --plan`、`scheduler --plan --confirm`、`scheduler --list-plans`、`scheduler --show-plan <plan-file>` 和 `scheduler --verify-plan <plan-file>`:从 queue scan、approval lifecycle、policy digest、action catalog digest、lease 和 readiness 摘要生成 deterministic scheduler plan。Stage 21.1-21.5 覆盖 Scheduler Source Model、Scheduler Plan Envelope、Scheduler Plan Command、Plan Audit Commands 和 Negative Smoke。Stage 21 默认 no-write;只有 `scheduler --plan --confirm` 写 `.vibecoding-state/scheduler-plans/*.scheduler-plan.json`,不调用 `execute --auto-run`、不写 execution、不启动 daemon/worker/watcher。
265
+ - Stage 22 `Scheduler Policy / Runtime Budget` 新增 scheduler policy / budget gate:内置 profile 包含 `scheduler-dry-run`、`single-local-auto-run`、`recovery-only`,runtime budget 固定 max one run per invocation、no retry、no recovery apply 和 kill switch。Stage 22.1-22.6 覆盖 Scheduler Policy Profiles、Runtime Budget Model、Policy/Budget Digest Binding、Scheduler Policy Commands、Optional Budget Snapshot 和 Negative Smoke。policy/budget 只作为 gate,不读取远程配置、不动态 eval、不扩大 runtime action catalog。
266
+ - Stage 23 `Single-shot Scheduler Worker` 新增 `scheduler --once --confirm`:在显式确认下从 Stage 21 plan 选择一个 ready item,重新验证 candidate、approval、lifecycle、policy、scheduler policy、budget、action catalog、lock、lease 和 idempotency key,获取 scheduler lease 后复用既有 controlled auto-run,并写 scheduler run audit。Stage 23.1-23.7 覆盖 Scheduler Once Gate、Revalidation Chain、Scheduler Lease、Controlled Auto-run Delegation、Scheduler Run Audit、Idempotency / No Duplicate Execution 和 Negative Smoke。Stage 23 不实现 loop/daemon、不自动恢复、不自动 retry、不自动回复、不接平台 API。
267
+ - Stage 24 `Recovery Classifier` 新增 `recovery --classify`、`recovery --classify --confirm`、`recovery --list-classifications`、`recovery --show-classification <classification-file>` 和 `recovery --verify-classification <classification-file>`:把 lease、execution、queue blocked、scheduler lease 和 recovery package 状态收敛为 recovery findings。Stage 24.1-24.4 覆盖 taxonomy、classifier command、classification artifact 和 verification;默认 no-write,只有 `--confirm` 写 `.vibecoding-state/recovery-classifications/*.recovery-classification.json`,不执行恢复、不释放 lock、不删除 execution、不 retry。
268
+ - Stage 25 `Confirmed Auto Recovery` 新增 `recovery --apply <classification-file>` 和 `recovery --apply <classification-file> --confirm`:从已验证 classification 中选择一个 eligible finding,写 recovery run audit;`package_retry_candidate` 只额外写 `.vibecoding-state/retry-packages/*.retry-package.json`,不执行 retry、不创建 approval、不触发 auto-run。Stage 25.1-25.4 覆盖 recovery policy/action catalog、apply preview、confirmed apply 和 idempotency/negative gates。
269
+ - Stage 26 `Scheduler + Recovery Integration` 扩展 `scheduler --plan` recovery hints,并新增 `scheduler --once --recover --confirm`:显式 single-shot recovery mode 只走 Stage 25 confirmed recovery path,每次最多 apply 一个 recovery finding,不与 normal queue execution 混合。Stage 26.1-26.4 覆盖 scheduler recovery hints、scheduler recovery mode、at-most-one combined semantics 和 integrated smoke/docs。Stage 26 不实现 daemon/loop、不自动清理、不自动 retry、不接平台 API。
270
+ - Stage 27 `Bounded Auto Retry` 新增 `retry --list-packages`、`retry --show-package <retry-package-file>`、`retry --verify-package <retry-package-file>` 和 `retry --run <retry-package-file> [--confirm]`:只从 Stage 25 retry package 进入一次显式确认 retry gate,绑定 source execution digest、approval、candidate、execution policy、retry policy、retry budget 和 action catalog digest;重复 retry、source digest drift、非 `failed` / `timed_out` source、terminal approval lifecycle、active lock/lease 都必须阻断。Stage 27 不创建新 approval、不修改原 execution/candidate/approval、不执行 workflow skill、不接平台 API、不调用 subagent/MCP、不触碰 git/worktree/业务源码。
271
+ - Stage 28 `Foreground Bounded Loop` 新增 `daemon --loop --dry-run`、`daemon --loop --confirm --max-iterations <n>`、`daemon --stop --confirm --reason <text>` 和 `daemon --loops/list/show/verify` 审计能力:loop 是前台有限轮次 run envelope,写 `.vibecoding-state/daemon-loops/` 与 `.vibecoding-state/daemon-heartbeats/`,stop file 写 `.vibecoding-state/daemon-stop/stop.json`。Stage 28 不启动后台 worker、不注册 watcher、不 fork、不长驻;命令退出即结束。
272
+ - Stage 29 `Unified Runtime Trace Ledger` 新增 `traces --build [--dry-run|--confirm]`、`traces --list/show/verify`:trace 写入 `.vibecoding-state/runtime-traces/*.runtime-trace.json`,绑定 scheduler plan/run、recovery classification/run、retry package/run、daemon loop/heartbeat、reply draft/approval/outbox/send-run 和 observability snapshot 的 digest。Stage 29 不修改源 artifact、不执行 scheduler/retry/reply、不启动 loop。
273
+ - Stage 30 `Readiness / Observability Expansion` 扩展 `observability --summary` / `readiness --score`:新增 `retry_health`、`loop_health`、`reply_health` 和 `trace_health` 维度,标记 retry/loop/reply/trace 的 verification failure、duplicate retry、stop file、send gate 和 trace drift。Stage 30 默认 no-write;`--confirm` 仍只写 `.vibecoding-state/observability/*.observability.json`,不改变 gate、不触发执行。
274
+ - Reply A-D `Automatic Reply Pipeline` 新增 `reply --draft`、`reply --approve <draft-file>`、`reply --outbox <approval-file>`、`reply --send <outbox-file>` 和 `reply --list/show/verify`:只写 `.vibecoding-state/reply-drafts/`、`reply-approvals/`、`reply-outbox/`、`reply-send-runs/` 本地 artifact。Reply D 只写 send-disabled gate audit,`sent=false`、`send_allowed=false`、`external_delivery=false`,不调用 Slack/GitHub/Linear/邮箱/IDE API。
275
+ - Reply E `Source-bound Local Reply Draft` 扩展 `reply --draft --source-bound`:draft 写入 source manifest,绑定 workflow、latest execution、latest scheduler/recovery/retry run、latest observability snapshot 和 latest runtime trace 的文件名与 digest。`reply --verify` 与 `reply --approve` 会拒绝 source manifest drift;仍固定 `model_invocation=false`、`external_delivery=false`、`send_allowed=false`。
276
+ - Reply F `Source-bound Reply Review Gate` 新增 `reply --review <draft-file>`:默认只读 preview,`--confirm` 只写 `.vibecoding-state/reply-reviews/*.reply-review.json`。source-bound draft 进入 approval 前必须存在 approved review sidecar;approval/outbox/send verify 会递归追溯 review、draft 和 source manifest。
277
+ - Stage 31 `Governance Attestation / Boundary Audit` 新增 `governance --attest [--dry-run|--confirm]`、`governance --list/show/verify`:只读取 runtime trace、observability snapshot 和 reply review chain,生成 `.vibecoding-state/governance/*.governance-attestation.json`。attestation 固定 `platform_api=false`、`external_delivery=false`、`model_invocation=false`、`git=false`、`worktree=false`、`subagent=false`、`mcp=false`、`business_source_write=false`,只证明边界,不修复、不执行。
278
+ ## P63:Legacy Workflow Discipline 产品表达 v2
279
+
280
+ P63 `p63_legacy_workflow_discipline_expression_v2` 把 Stage 133 / Stage 140 与 P25-P31 的对标表达收敛成三层 profile 合同:
281
+
282
+ - `default`:safe governance mode,默认轻量分流、人工确认和本地只读 evidence。
283
+ - `legacy-workflow-discipline`:opt-in workflow governance/parity mode,只增强 workflow receipt、continuous next gate、plan/brief/review handoff、behavior/evidence discipline。
284
+ - `execution-enabled`:单独的受控本地执行 profile,必须走 preflight、approval、allowlist 和 evidence audit。
285
+
286
+ 边界固定:`legacy-workflow-discipline != execution-enabled`、`execution_profile=manual`、`execution_enabled=false`、`subagent=false`、`model_invocation=false`、`platform_api=false`、`git_write=false`、`business_source_write=false`、`hidden_execution=false`、`source_apply=false`、`auto_commit=false`、`auto_pr=false`。
287
+
288
+ P63 不新增 runtime command、不改变 JSON envelope、不自动切换 profile、不调用平台 API、不调用模型、不创建 subagent session、不写业务源码、不执行 git。任何执行面扩展仍必须进入单独的 `execution-enabled` 评审链。
289
+
290
+ ## P51:Feedback / Learning / Token 产品入口
291
+
292
+ P51 不新增执行能力,而是把现有 convergence、learning observation、experience pattern、token advice 和 token budget 收口成维护者可解释的只读产品入口:
293
+
294
+ ```bash
295
+ node tools/vibe-runtime/index.mjs governance --convergence --report --json
296
+ node tools/vibe-runtime/index.mjs learning --observe --from-file <session-evidence-file> --preview --json
297
+ node tools/vibe-runtime/index.mjs learning --experience-pattern --from-friction <local-friction-json> --json
298
+ node tools/vibe-runtime/index.mjs tokens --advice --intent verification --json
299
+ node tools/vibe-runtime/index.mjs tokens --savior-budget --prompt <text> --json
300
+ ```
301
+
302
+ 入口职责:`governance --convergence` 解释能力差距,`learning --observe --preview` 展示候选观察,`learning --experience-pattern` 判断是否值得进入人工 skill authoring,`tokens --advice` 和 `tokens --savior-budget` 给出确定性上下文预算建议。P51 固定 `candidate_only=true`、`promotion_required=true`、`preview_only=true`、`skill_mutation=false`、`prompt_mutation=false`、`shell_interception=false`、`model_invocation=false`、`platform_api=false`、`subagent=false`、`git_write=false`、`business_source_write=false`;不得修改正式 skills、入口模板、hook 或 prompt,也不得调用模型、平台 API、真实 subagent、MCP 或 shell interception。
303
+
304
+ ## Stage 61:Local Learning Observation Ledger
305
+
306
+ - Stage 61 `Local Learning Observation Ledger` 新增 `learning --observe --from-file <session-evidence-file> [--preview|--confirm]`、`learning --list`、`learning --show <learning-file>` 和 `learning --verify <learning-file>`:只从 root-relative 本地 JSON evidence 抽取 user corrections、failure fixes、repeated workflows、preferences、project constraints 和 observations,写入 `.vibecoding-state/learning/*.learning-observation.json`。Stage 61 sidecar 固定 `artifact_kind='learning-observation'`、`source_file`、`source_digest`、`project_id`、`scope='project'|'global-candidate'`、`domain='workflow'|'debugging'|'testing'|'code-style'|'governance'|'token-economy'`、`confidence_delta`、`evidence_excerpt_digest`、`signals_digest`、`signal_count`、`candidate_only=true`、`promotion_required=true` 和 `learning_observation_digest`。preview 固定 `state_directory_created=false`,confirm 只写 learning sidecar,不自动生成 candidate instinct、不 promotion、不写正式 `skills/`、`AGENTS.md` 或 `CLAUDE.md`,并保持 `skill_mutation=false`、`prompt_mutation=false`、`hook_registration=false`、`shell_interception=false`、`external_network=false`、`model_invocation=false`、`platform_api=false`、`git=false`、`worktree=false`、`runtime_action=false`、`subagent=false`。
307
+
308
+ ## Stage 62:Candidate Instinct and Promotion Gate
309
+
310
+ - Stage 62 `Candidate Instinct and Promotion Gate` 新增 `learning --instincts --from-observations <learning-observation-file...> [--preview|--confirm]` 与 `learning --promote --instinct <candidate-instinct-file> [--preview|--confirm]`:只从已验证 `.learning-observation.json` 生成 `.vibecoding-state/learning/*.candidate-instinct.json`,再从 candidate 生成 `.vibecoding-state/learning/*.learning-promotion.json`。Candidate sidecar 固定 `artifact_kind='candidate-instinct'`、`stage='Stage 62'`、`atomic=true`、`one_trigger=true`、`one_action=true`、`trigger`、`action`、`confidence`、`evidence_backed=true`、`evidence_observations[]`、`observation_digests`、`evidence_digest`、`candidate_instinct_digest`、`promotion_required=true`、`formal_skill_mutation=false`、`cross_project_share=false`。Promotion sidecar 固定 `artifact_kind='learning-promotion'`、`stage='Stage 62'`、`instinct_file`、`instinct_file_digest`、`candidate_instinct_digest`、`promotion_target='manual-skill-authoring'`、`human_approval_required=true`、`automatic_promotion=false`、`writes_formal_skills=false`、`writes_agents_md=false`、`writes_claude_md=false`、`required_workflow` 包含 `vibe-writing-skills` 和 `learning_promotion_digest`。preview 不写 candidate/promotion sidecar;confirm 只写 learning 目录下对应一个 sidecar;`learning --list/show/verify` 可审计 observation、candidate instinct 与 learning promotion。Stage 62 verify 拒绝 observation digest drift、candidate digest drift、promotion digest drift、路径穿越、非 atomic candidate、confidence 越界、跨项目共享越权,以及 `skill_mutation=false`、`prompt_mutation=false`、`hook_registration=false`、`shell_interception=false`、`external_network=false`、`model_invocation=false`、`platform_api=false`、`git=false`、`worktree=false`、`runtime_action=false`、`subagent=false` 之外的边界扩权。Stage 62 不写正式 `skills/`、`AGENTS.md`、`CLAUDE.md` 或 hook 配置;真正 promotion 必须显式进入 `vibe-writing-skills`,再经计划、测试、review。
311
+
312
+ Stage 15 小阶段:
313
+
314
+ - Stage 15.1 Policy Profile Model:定义 `strict`、`controlled-local-runtime`、`review-only` 三个内置 profile。
315
+ - Stage 15.2 Policy DSL Schema:固定 allowlist、runtime actions、forbidden actions、expected writes、risk ceiling、approval 和 limits 字段。
316
+ - Stage 15.3 Policy Source Boundary:policy 只来自 builtin data,不执行外部配置、动态 eval 或远程读取。
317
+ - Stage 15.4 Policy Evaluation Envelope:输出 allowed / blocked、matched rules、blocked reasons 和 policy digest。
318
+ - Stage 15.5 Risk Gate Contract:阻断 business source write、git、worktree、platform API、subagent、MCP、daemon 和 skill execution。
319
+ - Stage 15.6 Approval Requirement Contract:明确 approval required 和 freshness boundary。
320
+ - Stage 15.7 Policy Snapshot Binding:candidate、approval 和 controlled auto-run 绑定同一 policy digest。
321
+ - Stage 15.8 Policy Audit Commands:`policies --list` / `policies --show <profile>` 只读输出 policy snapshot。
322
+ - Stage 15.9 Policy Negative Smoke:覆盖 unknown profile、forbidden risk、non-allowlisted target/action 和 digest mismatch。
323
+ - Stage 15.10 Docs / Check / Smoke Sync:同步 roadmap、contract、README、acceptance、runtime-check 和 release smoke。
324
+
325
+ Stage 16 小阶段:
326
+
327
+ - Stage 16.1 Queue Source Model:队列来源为 candidate artifacts、approval artifacts、execution history 和 auto-run locks。
328
+ - Stage 16.2 Queue Item Envelope:固定 candidate file、event file、target skill、actor、idempotency key、policy digest、approval digest、status、priority 和 blocked reasons。
329
+ - Stage 16.3 Queue Readiness Gates:检查 candidate ready、policy allowed、approval valid、active lock clear、no active run 和 not stale。
330
+ - Stage 16.4 Queue Priority Model:ready first,再用稳定文件名 tie-breaker,避免随机排序。
331
+ - Stage 16.5 Scheduler Scan Contract:`queue --scan` 默认只读,不写 queue,不执行 auto-run。
332
+ - Stage 16.6 Optional Queue Persistence Boundary:`queue --scan --confirm` 只写 `.vibecoding-state/execution-queue/*.queue.json`。
333
+ - Stage 16.7 Queue Audit Commands:`queue --list/show/verify` 只读审计 queue snapshot。
334
+ - Stage 16.8 Scheduler Promotion Preview:只输出 promotion preview,不调用 `execute --auto-run`。
335
+ - Stage 16.9 Queue Negative Smoke:覆盖 missing approval、bad policy digest、active lock、active running、corrupted queue 和 path traversal。
336
+ - Stage 16.10 Docs / Check / Smoke Sync:同步文档、marker 和 release smoke。
337
+
338
+ - `tasks --dry-run --task <task-id> --json` 支持精确单任务 JSON selection,输出 selected task ids、readiness、blocked_by、review_status 和 artifact_paths,不输出 artifact 正文,不写 task artifacts;输出任务列表只包含选中 task,但 readiness / blocked_by 仍按完整 ledger dependency graph 计算。
339
+ - 写入类命令不支持 `--json`;`record-handoff --json`、`artifacts --json`、`tasks --write --json` 和 `reset --json` 必须明确失败,避免只读输出和写入动作边界混淆,release smoke 必须覆盖这些负向分支。
340
+ - 任务级 `review_status` 支持 `not_started`、`requested`、`clean`、`needs_fix`、`waived`,只用于可观测摘要和 review gate artifacts。
341
+ - 发布检查可聚合 runtime check 和 runtime ledger smoke。
342
+
343
+ 当前不落地:
344
+
345
+ - 不默认创建 `.vibecoding-state/`;只在用户显式运行 `vibe-runtime record-handoff` 时创建。
346
+ - 不写 workflow state。
347
+ - 不自动选择或执行 `next_skill`。
348
+ - 不自动调用 subagent。
349
+ - 不创建 worktree。
350
+ - 不执行 git 写入。
351
+ - 不安装依赖。
352
+ - 不引入 MCP、agent graph、daemon 或后台 worker。
353
+
354
+ ## 未来状态模型
355
+
356
+ 状态文件仅在用户显式启用 runtime 后生成,建议路径:
357
+
358
+ ```text
359
+ .vibecoding-state/workflow.json
360
+ .vibecoding-state/task-brief.md
361
+ .vibecoding-state/review-gate.md
362
+ .vibecoding-state/evidence.md
363
+ .vibecoding-state/tasks/<task-id>/brief.md
364
+ .vibecoding-state/tasks/<task-id>/report.md
365
+ .vibecoding-state/tasks/<task-id>/review-gate.md
366
+ .vibecoding-state/dispatches/<event-file>.json
367
+ .vibecoding-state/dispatch-claims/<event-file>.claim.json
368
+ .vibecoding-state/executions/<timestamp>-<dispatch-hash>.execution.json
369
+ .vibecoding-state/execution-candidates/<timestamp>-<dispatch-hash>.candidate.json
370
+ .vibecoding-state/execution-approvals/<timestamp>-<candidate-hash>.approval.json
371
+ .vibecoding-state/approval-lifecycle/<approval-hash>.approval-lifecycle.json
372
+ .vibecoding-state/auto-run-locks/<idempotency-hash>.lock.json
373
+ .vibecoding-state/execution-queue/<timestamp>.queue.json
374
+ .vibecoding-state/daemon-runs/<timestamp>.daemon-run.json
375
+ ```
376
+
377
+ Stage 7 claim 状态结构:
378
+
379
+ ```json
380
+ {
381
+ "schema_version": 1,
382
+ "command": "dispatches",
383
+ "mode": "dispatch-claim",
384
+ "event_file": "2026-06-23T09-10-52-474Z.json",
385
+ "event_sha256": "hex digest",
386
+ "actor": "manual-user",
387
+ "status": "claimed",
388
+ "claimed_at": "",
389
+ "updated_at": "",
390
+ "ack": {
391
+ "status": "",
392
+ "reason": ""
393
+ },
394
+ "safety": {
395
+ "dispatch_event_modified": false,
396
+ "auto_execution": false,
397
+ "platform_api": false,
398
+ "subagent": false,
399
+ "mcp": false,
400
+ "daemon": false,
401
+ "git": false,
402
+ "worktree": false,
403
+ "business_source_write": false
404
+ }
405
+ }
406
+ ```
407
+
408
+ 合法 claim 状态第一批仅包含 `claimed`、`picked`、`skipped`、`failed`;不使用 `consumed`,避免暗示自动执行已经完成。
409
+
410
+ Stage 7.5 / 7.6 增强只做 claim audit 和 recovery preview:`dispatches --claims` 输出 `age_ms`、`stale`、event digest match、`reassign_allowed=false`、`retry_allowed=false` 和 manual action;不会自动 reassign,不会改 dispatch event 或 claim state。Stage 7.9 / 7.10 进一步把 `skipped` / `failed` 的 ack reason 变成必填 contract,并在 ack 时强制 claim `event_sha256` 与当前 dispatch event digest 一致。
411
+
412
+ Stage 8.4 / 8.6-8.10 增强把 pickup package 变成 adapter 输入契约层:`dispatches --pickup` 输出 `ready_for_adapter`、`event_valid`、`claim_picked`、`target_skill_present`、`entry_file_present`,并绑定 `event_sha256`、`claim_sha256`、`workflow_sha256` 和 `handoff_sha256`。`dispatches --pickup-verify` 独立验证 pickup package;`dispatches --pickup-dry-run` 只模拟 adapter 会读取的 entry、dispatch、claim 和 digest,不创建 session、不调用平台 API、不写状态。Claude entry file 固定为 `CLAUDE.md`,Cursor / Codex entry file 固定为 `AGENTS.md`;三者当前都是 manual/no-session/no-API/no-stdin automation。
413
+
414
+ Stage 9.1-9.11 增强把 Supervised Executor Gate 拆成完整 planned execution contract:9.1 `--dry-run` 只预览 execution plan;9.2 `--confirm --actor` 只写 planned envelope;9.3 claim picked gate 覆盖 dry-run / preflight / confirm / run;9.4 no execution boundary 固定不执行 workflow skill、不接平台 API、不触碰 git/worktree;9.5 execution envelope safety 固定所有 no-platform/no-subagent/no-MCP/no-daemon/no-git/no-worktree/no-business-source-write 标记;9.6 immutability 保证 dispatch event 和 claim state 成功/失败均不被修改;9.7 `execute --from-dispatch <event-file> --preflight` 只读审计 gates 与 write boundary,不写 `.vibecoding-state/executions/`;9.8 planned envelope verify 覆盖 corrupted planned safety;9.9 stable `idempotency_key` 基于 event digest、actor 和 target skill;9.10 policy snapshot 记录 policy name/version、allowlisted skills 和 forbidden actions;9.11 write boundary preview 输出 expected writes 和 forbidden write boundary。Stage 9.2 / 9.5 兼容摘要:`--confirm --actor` 写入的 planned envelope 包含 policy name/version、allowlisted skills snapshot、expected write boundary 和 stable `idempotency_key`。
415
+
416
+ Stage 10.3-10.6 / 10.8 / 10.11-10.13 增强增加 scheduler scan dry-run 和 daemon contract:`daemon --scan --dry-run` 只读扫描 dispatches、claims 和 executions,输出 candidates、blocked items、stale claims、stale running executions、failed/timed_out retry preview、`retry_allowed=false`、lock / lease contract 和 watcher disabled;不会创建 daemon-runs,不 pickup、不 execute、不 retry、不改状态文件。`daemon --once --confirm` 写入的 no-op envelope 也记录 `scan_noop=true`、`scheduler_policy_dry_run=true`、`lock_acquired=false`、`lease_required=true` 和 `heartbeat_started=false`。
417
+
418
+ Stage 17.1-17.10 增强把 approval artifact 扩展为本地 lifecycle sidecar:`approvals --list/show/verify` 只读审计 approval 与 `.vibecoding-state/approval-lifecycle/*.approval-lifecycle.json`;`approvals --transition` 默认 preview no-write,只有 `--confirm` 写 sidecar,不修改原 approval。lifecycle state 覆盖 `approved`、`rejected`、`expired`、`revoked`、`consumed`,并记录 audit trail、candidate digest、policy digest、action catalog digest 和 lifecycle digest。controlled auto-run 前会检查 lifecycle gate,rejected / expired / revoked / consumed 全部 blocked;成功 auto-run 会写 consumed evidence。
419
+
420
+ Stage 18.1-18.10 增强把 runtime action 固化为内置 catalog:`actions --list/show/verify` 只读输出唯一 action `generate-supervised-handoff-package` 的 capability、risk、required inputs、writes、idempotency、recovery 和 policy profile。catalog 固定 builtin data-only、`default_allow_unknown=false`、`catalog_digest`;candidate、approval、policy evaluation、queue scan 和 controlled auto-run 都绑定并校验 catalog digest,未知 action 默认 blocked。
421
+
422
+ 建议状态结构:
423
+
424
+ ```json
425
+ {
426
+ "current_skill": "vibe-writing-plans",
427
+ "next_skill": "vibe-test-driven-development",
428
+ "reason": "plan is ready",
429
+ "status": "handoff-recorded",
430
+ "scope": [],
431
+ "risks": [],
432
+ "acceptance": [],
433
+ "files": [],
434
+ "evidence": [],
435
+ "tasks": [
436
+ {
437
+ "id": "task-1",
438
+ "title": "task title",
439
+ "status": "pending",
440
+ "review_status": "not_started",
441
+ "review_notes": [],
442
+ "review_evidence": [],
443
+ "review_risks": [],
444
+ "review_waiver": "",
445
+ "files": [],
446
+ "depends_on": [],
447
+ "acceptance": [],
448
+ "evidence": [],
449
+ "risks": [],
450
+ "notes": [],
451
+ "stop_condition": ""
452
+ }
453
+ ],
454
+ "stop_condition": "",
455
+ "updated_at": ""
456
+ }
457
+ ```
458
+
459
+ ## 状态演变
460
+
461
+ ```text
462
+ Idle
463
+ -> SkillSelected
464
+ -> HandoffRecorded
465
+ -> WaitingConfirmation
466
+ -> NextSuggested
467
+ -> SkillSelected | Stopped
468
+ ```
469
+
470
+ 任何进入高风险动作前都必须停在 `WaitingConfirmation`。
471
+
472
+ ## Stage 2 Ledger 命令
473
+
474
+ 当前 `vibe-runtime` 只提供显式 state ledger:
475
+
476
+ ```text
477
+ node tools/vibe-runtime/index.mjs status
478
+ node tools/vibe-runtime/index.mjs status --json
479
+ node tools/vibe-runtime/index.mjs validate-handoff --from-file handoff.md
480
+ node tools/vibe-runtime/index.mjs validate-handoff --from-file handoff.md --json
481
+ node tools/vibe-runtime/index.mjs record-handoff --from-file handoff.md
482
+ node tools/vibe-runtime/index.mjs next --dry-run
483
+ node tools/vibe-runtime/index.mjs next --dry-run --json
484
+ node tools/vibe-runtime/index.mjs next --dry-run --dispatch-intent
485
+ node tools/vibe-runtime/index.mjs next --dry-run --dispatch-intent --json
486
+ node tools/vibe-runtime/index.mjs dispatches --pickup <event-file>
487
+ node tools/vibe-runtime/index.mjs dispatches --pickup <event-file> --platform claude
488
+ node tools/vibe-runtime/index.mjs artifacts --dry-run
489
+ node tools/vibe-runtime/index.mjs artifacts --write
490
+ node tools/vibe-runtime/index.mjs tasks --dry-run
491
+ node tools/vibe-runtime/index.mjs tasks --dry-run --json
492
+ node tools/vibe-runtime/index.mjs tasks --write
493
+ node tools/vibe-runtime/index.mjs tasks --dry-run --task task-1
494
+ node tools/vibe-runtime/index.mjs tasks --dry-run --task task-1 --json
495
+ node tools/vibe-runtime/index.mjs tasks --write --task task-1
496
+ node tools/vibe-runtime/index.mjs reset --confirm
497
+ ```
498
+
499
+ 边界:
500
+
501
+ - `status` 只读,不创建文件;有状态时可展示当前 ledger 摘要。
502
+ - `status --json` 只读输出 JSON envelope;无状态时 `state_present: false`,且不创建 `.vibecoding-state/`。
503
+ - `validate-handoff --from-file` 只读校验 handoff,`--json` 输出 normalized summary、tasks 和 quality hints,不写 workflow state。
504
+ - `record-handoff` 只写 `.vibecoding-state/workflow.json`。
505
+ - `next --dry-run` 只输出下一步建议,不执行下一步;`--json` 输出建议状态、manual_action、task readiness 和 review summary。
506
+ - `artifacts --dry-run` 只预览 task brief、review gate 和 evidence skeleton,不写文件。
507
+ - `artifacts --write` 只写 `.vibecoding-state/*.md` 文件,不写业务源码、不执行下一步。
508
+ - `tasks --dry-run` 只预览任务级 brief、report、review gate 和 evidence skeleton,不写文件;`--json` 只输出 task selection、readiness、blocked_by、review_status 和 artifact_paths。
509
+ - `tasks --write` 只写 `.vibecoding-state/tasks/<task-id>/*.md` 文件,不写业务源码、不执行任务。
510
+ - `--json` 只支持只读命令;写入类命令遇到 `--json` 必须失败。
511
+ - `reset --confirm` 只删除 `.vibecoding-state/`。
512
+ - 不提供 `next --confirm`,半自动 orchestrator 留到后续阶段。
513
+
514
+ ## Stage 3 JSON handoff 互操作与 dry-run 建议
515
+
516
+ 当前 Stage 3 建立输入格式互操作基础,并增强 `next --dry-run` 文本建议;仍不启用自动 orchestrator。
517
+
518
+ ```text
519
+ node tools/vibe-runtime/index.mjs record-handoff --from-file handoff.json
520
+ node tools/vibe-runtime/index.mjs record-handoff --from-file handoff.md
521
+ ```
522
+
523
+ 边界:
524
+
525
+ - JSON handoff 是推荐输入格式。
526
+ - JSON-first 解析优先读取纯 JSON 文件或 markdown fenced JSON block。
527
+ - legacy fallback 保留旧 YAML-like handoff 兼容。
528
+ - `record-handoff` 成功后输出 handoff quality 提示;提示只提醒空范围、风险、验收、文件、证据和停止条件语义,不阻止写入、不自动修复、不执行下一步。
529
+ - no automatic next_skill execution:`next --dry-run` 仍只输出建议。
530
+ - `next --dry-run` 用文本显示 `idle` / `ready` / `blocked` / `stopped`,帮助用户判断是否应手动进入下一 skill。
531
+ - `stop_condition` 有实际内容时必须显示阻塞态,而不是建议继续执行。
532
+ - 不提供 `next --confirm`。
533
+ - 不调用 subagent、不创建 worktree、不执行 git 写入。
534
+
535
+ ## 高风险动作
536
+
537
+ 以下动作默认禁止自动执行:
538
+
539
+ - git 写入、提交、reset、checkout、stash、tag、push。
540
+ - worktree 创建、切换、删除。
541
+ - subagent dispatch。
542
+ - 依赖安装。
543
+ - 文件清理。
544
+ - 跨平台 adapter 修改。
545
+ - MCP、agent graph、daemon、后台 worker 启动。
546
+
547
+ 未来即使引入执行器,也必须满足:
548
+
549
+ - dry-run 默认开启。
550
+ - 用户显式确认。
551
+ - 输出可复现命令或计划。
552
+ - 记录 evidence。
553
+ - 有停止和恢复路径。
554
+
555
+ Stage 9 Supervised Executor Gate 第一批只允许 `execute --from-dispatch` 读取 dispatch event 和 claim,`--dry-run` 预览 execution plan,`--confirm --actor` 写入 `.vibecoding-state/executions/` execution envelope。它不执行 skill,不调用平台 API,不调用 subagent / MCP / daemon,不触碰 git / worktree,不写业务源码,也不修改 dispatch event 或 claim state。
556
+
557
+ Stage 10 Optional Daemon / Watcher Gate 第一批只允许 `daemon --dry-run` 预览 once-run gate,或 `daemon --once --confirm` 写入 `.vibecoding-state/daemon-runs/` daemon run envelope。默认不启用 daemon,不启动 watcher,不做 long-running worker,不扫描并执行所有 dispatches,不调用 `execute`,不执行 skill,不调用平台 API,不触碰 git / worktree。
558
+
559
+ ## 与现有工具关系
560
+
561
+ ```text
562
+ vibe-doctor
563
+ 检查安装布局、分发资产和入口文件一致性。
564
+
565
+ vibe-runtime-check
566
+ 检查 workflow contract 是否可被 runtime 消费。
567
+
568
+ vibe-runtime
569
+ 在用户显式运行时记录和读取 .vibecoding-state/workflow.json,不执行下一步。
570
+
571
+ vibe-release-check
572
+ 聚合发布前检查,可包含 runtime check。
573
+ ```
574
+
575
+ ## Stage 33:Hook Intent Contract
576
+
577
+ 目标:先把 hook 从隐式执行器降级成可审计输入,而不是直接接管 session 或 scheduler。
578
+
579
+ 命令边界:
580
+
581
+ ```text
582
+ node tools/vibe-runtime/index.mjs hooks --catalog
583
+ node tools/vibe-runtime/index.mjs hooks --preview
584
+ node tools/vibe-runtime/index.mjs hooks --preview --confirm
585
+ node tools/vibe-runtime/index.mjs hooks --list
586
+ node tools/vibe-runtime/index.mjs hooks --show <hook-intent-file>
587
+ node tools/vibe-runtime/index.mjs hooks --verify <hook-intent-file>
588
+ ```
589
+
590
+ 状态产物:
591
+
592
+ ```text
593
+ .vibecoding-state/hook-intents/<timestamp>.hook-intent.json
594
+ ```
595
+
596
+ Stage 33 固定 `default_enabled=false`、`hook_enabled=false`、`scheduler_execution=false`、`subagent_dispatch=false`、`platform_api=false`。`--catalog` 和 `--preview` 保持 no-write;`--confirm` 只写 hook intent artifact;`--verify` 校验 digest、source drift 和 safety boundary。hook intent 可被后续 Stage 34 scheduler plan 消费,但本阶段不触发 scheduler、不派发 subagent、不创建 session、不接平台 API。
597
+
598
+ ## Stage 34:Scheduler Plan from Hook
599
+
600
+ 目标:把 hook intent 接入 scheduler,但只生成计划,不运行 scheduler。
601
+
602
+ 命令边界:
603
+
604
+ ```text
605
+ node tools/vibe-runtime/index.mjs scheduler --from-hook <hook-intent-file> --plan
606
+ node tools/vibe-runtime/index.mjs scheduler --from-hook <hook-intent-file> --plan --confirm
607
+ node tools/vibe-runtime/index.mjs scheduler --show <scheduler-hook-plan-file>
608
+ node tools/vibe-runtime/index.mjs scheduler --verify <scheduler-hook-plan-file>
609
+ ```
610
+
611
+ 状态产物:
612
+
613
+ ```text
614
+ .vibecoding-state/scheduler-hook-plans/<timestamp>.scheduler-hook-plan.json
615
+ ```
616
+
617
+ Stage 34 固定 `scheduler_profile=scheduler-dry-run`,从已验证 hook intent 读取输入,并汇总 queue readiness、blocked reasons、budget、lease requirement 和 required approvals。`--from-hook --plan` no-write;`--confirm` 只写 scheduler hook plan artifact。该阶段不创建 lease、不执行 queue item、不运行 scheduler once、不派发 subagent、不创建 session、不接平台 API。hook intent drift、plan digest drift、安全边界漂移或 runtime/subagent 允许位打开必须 verify 失败。
618
+
619
+ ## Stage 38-40:Result Review / Bounded Hook Loop / Automation Proof
620
+
621
+ Stage 38 使用 `subagents --ingest-result` 和 `subagents --review-gate` 将 Stage 37 local result 转成 review gate sidecar,状态目录为 `.vibecoding-state/subagent-results/` 与 `.vibecoding-state/subagent-reviews/`。该阶段不 merge 结果、不写业务源码、不创建 session。
622
+
623
+ Stage 39 使用 `hooks --hook-run --max-iterations <n> --confirm` 记录 bounded foreground hook loop sidecar,状态目录为 `.vibecoding-state/hook-runs/` 与 `.vibecoding-state/hook-heartbeats/`。固定 `long_running=false`、`watcher=false`、`daemon=false`、`hidden_worker=false`。
624
+
625
+ Stage 40 将 `hook_runs`、`hook_heartbeats`、`subagent_results`、`subagent_reviews` 纳入 trace source types,governance 增加 `automation_artifacts` / `automation_policy`,methodology 增加 `methodology --gate --kind automation`。证明链只证明 approved + traced + reviewed + bounded,不触发执行。
626
+
627
+ ## Stage 41:Platform Adapter Capability Contract
628
+
629
+ Stage 41 新增 `platforms` 命令族,用于把平台 adapter 能力写成可审计 sidecar:
630
+
631
+ ```bash
632
+ node tools/vibe-runtime/index.mjs platforms --catalog --json
633
+ node tools/vibe-runtime/index.mjs platforms --probe cursor --json
634
+ node tools/vibe-runtime/index.mjs platforms --probe cursor --confirm --json
635
+ node tools/vibe-runtime/index.mjs platforms --list --json
636
+ node tools/vibe-runtime/index.mjs platforms --show <platform-capability-file> --json
637
+ node tools/vibe-runtime/index.mjs platforms --verify <platform-capability-file> --json
638
+ ```
639
+
640
+ 状态目录:
641
+
642
+ ```text
643
+ .vibecoding-state/platform-capabilities/<timestamp>.platform-capability.json
644
+ ```
645
+
646
+ 该阶段只使用 builtin contract data,记录 `supports_session_create`、`supports_result_capture`、`supports_patch_output`、`supports_cancel`、`supports_timeout`、`adapter_digest` 与 `catalog_digest`。固定 `platform_api=false`、`model_invocation=false`、`session_create=false`、`business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`,并输出 `allowed_followup=['platform-session-approval-only']`。capability drift、adapter/catalog digest drift、file alias drift 或 followup 扩权必须阻断后续阶段。
647
+
648
+ ## Stage 42:Real Subagent Session Approval
649
+
650
+ Stage 42 新增独立 session approval gate:
651
+
652
+ ```bash
653
+ node tools/vibe-runtime/index.mjs subagents --session-approval --from-dispatch <subagent-dispatch-file> --capability <platform-capability-file> --json
654
+ node tools/vibe-runtime/index.mjs subagents --session-approval --from-dispatch <subagent-dispatch-file> --capability <platform-capability-file> --confirm --json
655
+ node tools/vibe-runtime/index.mjs subagents --verify <platform-session-approval-file> --json
656
+ ```
657
+
658
+ 状态目录:
659
+
660
+ ```text
661
+ .vibecoding-state/platform-session-approvals/<timestamp>.platform-session-approval.json
662
+ ```
663
+
664
+ approval 绑定 Stage 36 dispatch、Stage 35 eligibility、Stage 34 scheduler hook plan、workflow/task digest 和 Stage 41 capability digest,并记录 `user_consent_present=true`、单 session budget、timeout、允许输出格式与 `allowed_followup=['platform-session-create-only']`。该阶段仍固定 `session_create=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`;它只批准下一阶段的 create-session gate,不创建真实 session。
665
+
666
+ ## Stage 43:Real Platform Subagent Session
667
+
668
+ Stage 43 新增真实 session 产物链:
669
+
670
+ ```bash
671
+ node tools/vibe-runtime/index.mjs subagents --create-session --from-approval <platform-session-approval-file> --confirm --json
672
+ node tools/vibe-runtime/index.mjs subagents --cancel-session <platform-session-file> --confirm --json
673
+ node tools/vibe-runtime/index.mjs subagents --verify <platform-session-file|platform-session-lease-file|platform-session-result-file|platform-session-cancel-file> --json
674
+ ```
675
+
676
+ 状态目录:
677
+
678
+ ```text
679
+ .vibecoding-state/platform-sessions/<timestamp>.platform-session.json
680
+ .vibecoding-state/platform-session-leases/<timestamp>.platform-session-lease.json
681
+ .vibecoding-state/platform-session-results/<timestamp>.platform-session-result.json
682
+ .vibecoding-state/platform-session-cancellations/<timestamp>.platform-session-cancel.json
683
+ ```
684
+
685
+ Stage 43 允许 `session_create=true`、`platform_api=true`、`model_invocation=true` 只出现在 session artifact 内,并绑定 Stage 42 approval、prompt digest、transcript digest、adapter operation digest 和 result payload digest。`business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false` 仍为硬边界;平台结果只能进入 result sidecar,下一步是 `platform-session-result-review-only`。
686
+
687
+ ## Stage 44:Real Session Result Ingestion / Review
688
+
689
+ Stage 44 新增真实 session result 的 intake / review gate:
690
+
691
+ ```bash
692
+ node tools/vibe-runtime/index.mjs subagents --ingest-session-result <platform-session-result-file> --confirm --json
693
+ node tools/vibe-runtime/index.mjs subagents --review-session-result <platform-session-intake-file> --confirm --json
694
+ node tools/vibe-runtime/index.mjs subagents --verify <platform-session-intake-file|platform-session-review-file> --json
695
+ ```
696
+
697
+ 状态目录:
698
+
699
+ ```text
700
+ .vibecoding-state/platform-session-intake/<timestamp>.platform-session-intake.json
701
+ .vibecoding-state/platform-session-reviews/<timestamp>.platform-session-review.json
702
+ ```
703
+
704
+ Stage 44 绑定 Stage 43 result digest、session digest、approval digest、prompt digest、transcript digest、result payload digest、patch digest 与 files touched。review 通过后只允许 `allowed_followup=['source-change-candidate-only']`,仍保持 `business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`。
705
+
706
+ ## Stage 45:Source Change Candidate / Patch Sandbox
707
+
708
+ Stage 45 新增 `source` 命令族,让真实代码变更只进入候选区和 sandbox sidecar:
709
+
710
+ ```bash
711
+ node tools/vibe-runtime/index.mjs source --candidate --from-session-review <platform-session-review-file> --confirm --json
712
+ node tools/vibe-runtime/index.mjs source --apply-sandbox <source-change-candidate-file> --confirm --json
713
+ node tools/vibe-runtime/index.mjs source --verify <source-change-candidate-file|source-sandbox-run-file> --json
714
+ ```
715
+
716
+ 状态目录:
717
+
718
+ ```text
719
+ .vibecoding-state/source-change-candidates/<timestamp>.source-change-candidate.json
720
+ .vibecoding-state/source-sandbox-runs/<timestamp>.source-sandbox-run.json
721
+ ```
722
+
723
+ Stage 45 绑定 Stage 44 review digest、source result digest、session digest、base sha、patch digest、diff digest、allowed files、forbidden files 与 sandbox actual touched files。candidate 只允许 `source-sandbox-apply-only`,sandbox 只允许 `source-verification-only`,且 `business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`。
724
+
725
+ ## Stage 46:Verification Evidence Gate
726
+
727
+ Stage 46 新增 `source --verify-change`,把 sandbox run 转成验证证据 sidecar:
728
+
729
+ ```bash
730
+ node tools/vibe-runtime/index.mjs source --verify-change <source-sandbox-run-file> --confirm --json
731
+ node tools/vibe-runtime/index.mjs source --verify <source-verification-file> --json
732
+ ```
733
+
734
+ 状态目录:
735
+
736
+ ```text
737
+ .vibecoding-state/source-verifications/<timestamp>.source-verification.json
738
+ ```
739
+
740
+ Stage 46 绑定 sandbox digest、candidate digest、base sha、diff digest、files touched、evidence digest 与 evidence policy digest。verification 只允许 `merge-readiness-only`,且 `business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`。`command_execution=true` 只表示前台执行 allowlisted verification commands。缺失、失败或不在 allowlist 的验证证据必须阻断后续 merge readiness。
741
+
742
+ ## Stage 47:Merge Readiness / Auto Merge Approval
743
+
744
+ Stage 47 新增 `merge` 命令族,在 controlled apply 前生成 readiness 与 approval sidecar:
745
+
746
+ ```bash
747
+ node tools/vibe-runtime/index.mjs merge --readiness --from-verification <source-verification-file> --confirm --json
748
+ node tools/vibe-runtime/index.mjs merge --approve <merge-readiness-file> --confirm --json
749
+ node tools/vibe-runtime/index.mjs merge --verify <merge-readiness-file|merge-approval-file> --json
750
+ ```
751
+
752
+ 状态目录:
753
+
754
+ ```text
755
+ .vibecoding-state/merge-readiness/<timestamp>.merge-readiness.json
756
+ .vibecoding-state/merge-approvals/<timestamp>.merge-approval.json
757
+ ```
758
+
759
+ Stage 47 readiness 绑定 Stage 46 verification digest、sandbox digest、candidate digest、base sha、diff digest、files touched、runtime trace digest、governance digest 与 methodology digest。readiness 只允许 `merge-approval-only`,approval 只允许 `controlled-merge-apply-only`。Stage 47 必须保持 `business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`、`auto_apply=false`,只证明治理链路满足合并前置条件,不执行 apply。
760
+
761
+ ## Stage 48:Controlled Auto Merge Apply
762
+
763
+ Stage 48 新增 `merge --apply`,只接受 Stage 47 approval,并生成 controlled apply 产物:
764
+
765
+ ```bash
766
+ node tools/vibe-runtime/index.mjs merge --apply <merge-approval-file> --confirm --json
767
+ node tools/vibe-runtime/index.mjs merge --verify <merge-apply-file> --json
768
+ ```
769
+
770
+ 状态目录:
771
+
772
+ ```text
773
+ .vibecoding-state/merge-applies/<timestamp>.merge-apply.json
774
+ ```
775
+
776
+ Stage 48 使用 `controlled-local-marker-apply` 模式,只写 allowlisted 文件 `docs/runtime-auto-merge-ledger.md` 与 `.vibecoding-state/merge-applies/`。apply artifact 绑定 approval digest、readiness digest、verification digest、base sha、before/after sha、applied files、before/after file digests 与 marker digest。Stage 48 允许 `business_source_write=true`、`source_merge=true`、`worktree=true` 出现在 apply artifact 中,但 `git=false`、`commit=false`、`push=false`、`pr=false`、`force=false` 必须保持 false;不做 commit / push / PR。
777
+
778
+ ## Stage 49:Planner Engine / Workflow Route / Task Graph
779
+
780
+ Stage 49 新增 `planner` 命令族,把需求理解、workflow route、任务拆解与 brief skeleton 变成可审计 sidecar:
781
+
782
+ ```bash
783
+ node tools/vibe-runtime/index.mjs planner --route --from-file <path> --json
784
+ node tools/vibe-runtime/index.mjs planner --route --from-hook <hook-intent-file> --confirm --json
785
+ node tools/vibe-runtime/index.mjs planner --decompose --from-route <planner-route-file> --confirm --json
786
+ node tools/vibe-runtime/index.mjs planner --briefs --from-plan <planner-plan-file> --confirm --json
787
+ node tools/vibe-runtime/index.mjs planner --verify <planner-artifact-file> --json
788
+ ```
789
+
790
+ 状态目录:
791
+
792
+ ```text
793
+ .vibecoding-state/planner-routes/<timestamp>.planner-route.json
794
+ .vibecoding-state/planner-plans/<timestamp>.planner-plan.json
795
+ .vibecoding-state/planner-briefs/<timestamp>.planner-briefs.json
796
+ ```
797
+
798
+ Stage 49 route 会把输入稳定映射到 `intent_type`、`selected_workflow`、`workflow_candidates`、`risk_level`、`risk_score` 和 `blocked_reasons`。plan 会输出 `task_graph`、`dependency_edges`、`conflict_groups`、`subagent_candidates`、`verification_strategy` 与 `required_gates`。briefs 会输出 `brief_kind`、`brief_items`、`required_capabilities`、`suggested_platforms` 与 `token_budget_policy`。三类 artifact 都是 digest-bound sidecar,默认只读 preview;`--confirm` 也只写本地状态目录,不 dispatch、不 create-session、不调用平台 API、不写业务源码。
799
+
800
+ Stage 49 还把 `planner_routes`、`planner_plans`、`planner_briefs` 接入 `traces --build` source types,证明 planning control-plane 已纳入现有可审计链,而不是并行再造一套 runtime。
801
+
802
+ ## Stage 50:Router / Orchestrator Plan / Controlled Dispatch Strategy
803
+
804
+ Stage 50 新增 `router` 与 `orchestrator` 命令族,把 Stage 49 的 briefs 映射成 deterministic 平台排序、agent profile、lane / mutex / escalation 计划,但仍然只写上游控制 sidecar:
805
+
806
+ ```bash
807
+ node tools/vibe-runtime/index.mjs router --plan --from-briefs <planner-briefs-file> --json
808
+ node tools/vibe-runtime/index.mjs router --plan --from-briefs <planner-briefs-file> --confirm --json
809
+ node tools/vibe-runtime/index.mjs router --approve <router-plan-file> --confirm --json
810
+ node tools/vibe-runtime/index.mjs orchestrator --plan --from-router <router-approval-file> --confirm --json
811
+ node tools/vibe-runtime/index.mjs orchestrator --dispatch-plan <orchestrator-plan-file> --confirm --json
812
+ node tools/vibe-runtime/index.mjs orchestrator --verify <orchestrator-artifact-file> --json
813
+ ```
814
+
815
+ 状态目录:
816
+
817
+ ```text
818
+ .vibecoding-state/router-plans/<timestamp>.router-plan.json
819
+ .vibecoding-state/router-approvals/<timestamp>.router-approval.json
820
+ .vibecoding-state/orchestrator-plans/<timestamp>.orchestrator-plan.json
821
+ .vibecoding-state/orchestrator-dispatch-plans/<timestamp>.orchestrator-dispatch-plan.json
822
+ ```
823
+
824
+ router plan 会输出 `brief_routes`、`platform_rankings`、`agent_profiles`、`fallback_routes` 与 `concurrency_budget`;router approval 负责把 Stage 50 的策略冻结成 `orchestrator-plan-only` followup。orchestrator plan 会输出 `lanes`、`dispatch_order`、`mutex_groups`、`escalation_rules`、`retry_policy_refs` 与 `session_strategy`;orchestrator dispatch plan 会把这些策略收敛成只允许 `scheduler-dispatch-plan-only` / `session-approval-only` 的受控 dispatch strategy sidecar。
825
+
826
+ Stage 50 继续保持 `dispatch=false`、`session_create=false`、`platform_api=false`、`business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`。它复用 Stage 41 capability catalog、Stage 35 eligibility、Stage 42 session approval 的既有边界,只解释“该怎么路由”,不越过任何执行 gate。
827
+
828
+ Stage 50 还把 `router_plans`、`router_approvals`、`orchestrator_plans`、`orchestrator_dispatch_plans` 接入 `traces --build` source types,使 routing / orchestration plan 也进入统一证明链。
829
+
830
+ ### Stage 50 → Stage 35/36 Bridge
831
+
832
+ Stage 50 bridge 让 orchestrator dispatch plan 进入既有 Stage 35/36,而不是绕过旧链路:
833
+
834
+ ```bash
835
+ node tools/vibe-runtime/index.mjs subagents --eligibility --from-orchestrator <orchestrator-dispatch-plan-file> --task <task-id> --confirm --json
836
+ node tools/vibe-runtime/index.mjs subagents --dispatch --from-orchestrator <orchestrator-dispatch-plan-file> --eligibility <subagent-eligibility-file> --confirm --json
837
+ node tools/vibe-runtime/index.mjs subagents --verify <subagent-dispatch-file> --json
838
+ ```
839
+
840
+ bridge eligibility 的 gate source 固定为 `stage-50-orchestrator-dispatch-plan`,并绑定 `source.kind='orchestrator-dispatch-plan'`。bridge dispatch 继续写既有 Stage 36 `.subagent-dispatch.json`,同时绑定 `orchestrator_dispatch_plan_file`、`orchestrator_dispatch_plan_digest` 与 `orchestrator_dispatch_plan_artifact_digest`。
841
+
842
+ 该 bridge 只补消费接线,不执行 dispatch、不 create-session、不调用平台 API;Stage 42 仍消费 `.subagent-dispatch.json`,不直接消费 `.orchestrator-dispatch-plan.json`。
843
+
844
+ ## Stage 51:Behavioral Eval Harness / Scenario / Adversarial Session Eval
845
+
846
+ Stage 51 新增 `evals` 命令族,把“artifact 合法”提升到“行为是否按控制平面约束执行”的本地 deterministic 评测层。它仍然只写 sidecar,不接管真实工作区,不 dispatch、不 create-session、不调用平台 API:
847
+
848
+ ```bash
849
+ node tools/vibe-runtime/index.mjs evals --catalog --json
850
+ node tools/vibe-runtime/index.mjs evals --run-contract contract-core --json
851
+ node tools/vibe-runtime/index.mjs evals --run-contract contract-core --confirm --json
852
+ node tools/vibe-runtime/index.mjs evals --run-scenario scenario-routing --confirm --json
853
+ node tools/vibe-runtime/index.mjs evals --run-behavior behavior-workflow --confirm --json
854
+ node tools/vibe-runtime/index.mjs evals --run-adversarial adversarial-guardrails --confirm --json
855
+ node tools/vibe-runtime/index.mjs evals --verify <eval-artifact-file> --json
856
+ ```
857
+
858
+ 状态目录:
859
+
860
+ ```text
861
+ .vibecoding-state/eval-suites/<timestamp>.eval-suite.json
862
+ .vibecoding-state/eval-runs/<timestamp>.eval-run.json
863
+ .vibecoding-state/eval-reports/<timestamp>.eval-report.json
864
+ ```
865
+
866
+ Stage 51 catalog 会稳定列出 `contract-core`、`scenario-routing`、`behavior-workflow`、`adversarial-guardrails` 四类 suite。suite artifact 绑定 `suite_id`、`eval_kind`、`cases`、`references`、`catalog_digest`、`fixture_policy` 与 `allowed_followup=['eval-run-only']`。run artifact 绑定 suite file/digest、`case_results`、`summary`、`planner_feedback`、`router_feedback`、`gate_failures` 与 `allowed_followup=['eval-report-only']`。report artifact 绑定 run file/digest、`outcome`、`failing_case_ids` 与局部反馈聚合,`allowed_followup=[]`。
867
+
868
+ Stage 51 judge 固定 `deterministic_judge=true`、`isolated_root_required=true`、`workspace_mutation=false`、`sidecar_only=true`。contract suite 证明 followup / trace / safety 边界;scenario suite 使用 transcript behavioral judge 检查模糊需求先走 brainstorming、未复现 bug 先走 systematic debugging、高风险多任务先走 isolation + verification;behavior suite 既检查 planner/router/orchestrator 的 gates / ranking / mutex 行为,也通过 sandbox replay judge 本地复放 `transcript-fixture -> planner-route -> planner-decompose -> planner-briefs -> router-plan -> orchestrator-plan -> orchestrator-dispatch-plan -> stage-35-eligibility-bridge`;adversarial suite 稳定阻断 skip-review merge、direct subagent、bypass-router session 与 skip-verification finish 路径。
869
+
870
+ `case_results` 会保留 `fixture`、`transcript_judge`、`replay_trace` 与 digest evidence。`transcript-behavioral-judge` 和 `sandbox-replay-judge` 是 Stage 51 当前仅有的行为 judge 类型。`artifact_contract_pass_does_not_imply_behavior_pass=true` 明确表示 contract suite 通过不等于行为通过;release smoke 必须同时覆盖 transcript behavioral judge 与 sandbox replay judge。
871
+
872
+ Stage 51 继续保持 `dispatch=false`、`session_create=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`runtime_action=false`、`business_source_write=false`、`source_merge=false`、`subagent_dispatch=false`、`git=false`、`worktree=false`。`traces --build --confirm` 会把 `eval_suites`、`eval_runs` 与 `eval_reports` 纳入 source types,使 behavioral eval 结果也进入统一 proof chain。
873
+
874
+ ## Stage 52:Runtime Release Gate / Eval-backed Promotion
875
+
876
+ Stage 52 新增 `release` 命令族,把 Stage 51 的四类 eval report 聚合为本地 release gate sidecar。它只证明 evidence 齐全且 digest 可复验,不自动发布、不 commit、不 push、不 PR、不 merge:
877
+
878
+ ```bash
879
+ node tools/vibe-runtime/index.mjs release --gate --from-evals <eval-report-file>... --json
880
+ node tools/vibe-runtime/index.mjs release --gate --from-evals <eval-report-file>... --confirm --json
881
+ node tools/vibe-runtime/index.mjs release --verify-gate <release-gate-file> --json
882
+ ```
883
+
884
+ 状态目录:
885
+
886
+ ```text
887
+ .vibecoding-state/release-gates/<timestamp>.release-gate.json
888
+ ```
889
+
890
+ Release gate 必须覆盖 `contract-core`、`scenario-routing`、`behavior-workflow`、`adversarial-guardrails`。artifact 绑定 `required_suites`、`covered_suites`、每个 eval report 的 file digest / report digest / run digest、`eval_catalog_digest`、`required_suites_digest`、`sources_digest` 与 `gate_digest`。
891
+
892
+ Stage 52 明确继承 Stage 51 的行为边界:`scenario-routing` 与 `adversarial-guardrails` 必须有 `transcript-behavioral-judge`,`behavior-workflow` 必须有 `sandbox-replay-judge`,`artifact_contract_pass_does_not_imply_behavior_pass=true` 表示 `contract-core` 通过不能替代行为评估通过。
893
+
894
+ Stage 52 继续保持 `dispatch=false`、`session_create=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`runtime_action=false`、`business_source_write=false`、`source_merge=false`、`pr=false`、`push=false`、`merge=false`、`git=false`、`worktree=false`。`release --verify-gate` 必须拒绝 eval report digest drift、suite 缺失、followup 扩权和安全扩权。`traces --build --confirm` 会把 `release_gates` 纳入 source types。
895
+
896
+ ## Stage 53:Runtime Observability / Feedback Ledger
897
+
898
+ Stage 53 新增 `feedback` 命令族,把 planner/router/orchestrator/eval/release 的反馈投影成可解释 ledger。它只聚合既有 artifact,不修改策略、不重跑 planner/router/eval、不触发执行:
899
+
900
+ ```bash
901
+ node tools/vibe-runtime/index.mjs feedback --ledger --from-planner <planner-artifact>... --from-router <router-artifact>... --from-orchestrator <orchestrator-artifact>... --from-evals <eval-report-file>... --from-release-gate <release-gate-file>... --json
902
+ node tools/vibe-runtime/index.mjs feedback --ledger --from-planner <planner-artifact>... --from-router <router-artifact>... --from-orchestrator <orchestrator-artifact>... --from-evals <eval-report-file>... --from-release-gate <release-gate-file>... --confirm --json
903
+ node tools/vibe-runtime/index.mjs feedback --verify-ledger <feedback-ledger-file> --json
904
+ ```
905
+
906
+ 状态目录:
907
+
908
+ ```text
909
+ .vibecoding-state/feedback-ledgers/<timestamp>.feedback-ledger.json
910
+ ```
911
+
912
+ Feedback ledger 会把 `blocked_reasons`、`required_gates`、`allowed_followup`、router/orchestrator `fallback`、`concurrency budget`、`planner_feedback`、`router_feedback`、`gate_failures` 与 failing eval cases 归一化为 entries,并绑定 `sources_digest`、`entries_digest`、`coverage_digest` 与 `ledger_digest`。
913
+
914
+ Stage 53 继续保持 `dispatch=false`、`session_create=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`runtime_action=false`、`business_source_write=false`、`source_merge=false`、`pr=false`、`push=false`、`merge=false`、`git=false`、`worktree=false`。`feedback --verify-ledger` 必须拒绝来源文件漂移、entries drift、coverage drift 和安全扩权。`traces --build --confirm` 会把 `feedback_ledgers` 纳入 source types。
915
+
916
+ ## Stage 54:Runtime Policy Catalog / Guardrail Versioning
917
+
918
+ Stage 54 把 planner/router/orchestrator/eval/release/feedback 中散落的 guardrail 收敛成只读 builtin policy catalog:
919
+
920
+ ```bash
921
+ node tools/vibe-runtime/index.mjs policies --catalog --json
922
+ node tools/vibe-runtime/index.mjs policies --summary --json
923
+ ```
924
+
925
+ Policy catalog 覆盖 `workflow-route-policy`、`platform-ranking-policy`、`mutex-fallback-policy`、`eval-judge-policy` 与 `safety-boundary-policy`。`policies --summary` 是 catalog 的只读摘要视图,输出 `catalog_digest`、policy 数量、policy id、覆盖 stage / covers 和 `writes_state=false` / `runtime_action=false` 边界,不创建 `.vibecoding-state/`。catalog 固定 `source=builtin-data-only`、`dynamic_code=false`、`remote_config=false`、`default_allow_unknown=false`,不支持远程策略、不动态下载、不绕过旧 gate。
926
+
927
+ Stage 49/50/51/52/53 新产物会绑定 `policy_catalog_digest`。对应 `--verify` 会拒绝 policy drift,确保 route、platform ranking、fallback/mutex、eval judge 与 safety boundary 的解释依据和产物 digest 同步演进。
928
+
929
+ ## Stage 55:Installed Runtime Opt-in / Manifest Boundary
930
+
931
+ Stage 55 把 installed project 的 runtime 接入明确收敛为 opt-in manifest,而不是本地 runtime 分发:
932
+
933
+ ```bash
934
+ node tools/vibe-init/index.mjs --target <project-root> --platform cursor --with-runtime
935
+ node tools/vibe-doctor/index.mjs <project-root>
936
+ ```
937
+
938
+ manifest 只写:
939
+
940
+ ```text
941
+ <project-root>/.vibecoding/runtime-installed.json
942
+ ```
943
+
944
+ manifest 必须固定 `manifest_kind='installed-runtime-opt-in'`、`opt_in=true`、`default_enabled=false`,并声明 installed project 只承载 `.vibecoding/` 元数据,不承载本地 `tools/vibe-runtime/` 或 `tools/vibe-doctor/` 执行入口。
945
+
946
+ 推荐调用必须显式指向 external kit repo / package,并把业务项目作为 `\<project-root\>` 参数传入。doctor 必须拒绝任何把 installed project 伪装成完整 runtime 分发体的字段,例如直接声明本地 `tools/` entrypoint 或把自动 state 创建、hooks、daemon、MCP、runtime action 默认打开。
947
+
948
+ Stage 55 继续保持 `creates_state_directory_by_default=false`、`auto_runtime_enabled=false`、`hook_registration=false`、`daemon=false`、`watcher=false`、`mcp=false`、`platform_api=false`、`session_create=false`、`runtime_action=false`、`business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`、`external_network=false`。
949
+
950
+ Stage 18 在安装配置内补充 `installed_agent_experience_contract`,合同 kind 固定为 `installed-agent-experience-contract-v2`。该合同覆盖 `first_turn`、`continue_task`、`bug_debug` 和 `completion_closeout` 四类 copy-ready prompt,安装输出必须至少展示首轮入口验收和完成收口验收两条 prompt;`.vibecoding/config.json` 必须同步 profile summary、`skill_bootstrap`、`expected_response_shape`、`closeout_summary_entry='completion_evidence.task_completion_summary'` 和 forbidden action markers。default 仍是 lightweight routing summary;`legacy-workflow-discipline` 只显示 strict skill-first visible route,不授权 `hidden_execution`、`command_execution`、`skill_execution`、`subagent`、`business_source_write`、`git_write`、`platform_api` 或 `model_invocation`。
951
+
952
+ ## Stage 56:Runtime Compatibility / Migration Check
953
+
954
+ Stage 56 把 compatibility / migration 收敛为只读报告,不做自动迁移:
955
+
956
+ ```bash
957
+ node tools/vibe-runtime/index.mjs governance --compatibility --report
958
+ node tools/vibe-runtime/index.mjs governance --compatibility --report --json
959
+ ```
960
+
961
+ report 必须基于当前 runtime 的真实内建基线输出:
962
+
963
+ - `policy_catalog_digest`
964
+ - `eval_catalog_digest`
965
+ - `known_trace_source_types`
966
+ - 历史 sidecar 的 `stage`、`version`、`command`、`mode`
967
+
968
+ artifact 结果只允许三类分类:
969
+
970
+ - `compatible`
971
+ - `manual-migration-required`
972
+ - `untrusted`
973
+
974
+ Stage 56 必须保持只读边界:不自动迁移旧 artifact、不重签旧 digest、不静默放宽验证规则、不创建 `.vibecoding-state/`、不修改旧状态文件、不触发 runtime action、dispatch、session、platform API、git、worktree 或业务源码写入。
975
+
976
+ ## Stage 57:Optional PR Readiness Governance Sidecar
977
+
978
+ Stage 57 把“是否已准备好人工提交 PR”收敛为可验证的本地治理侧车,不创建 PR、不 push、不 merge,也不接入默认 release chain:
979
+
980
+ ```bash
981
+ node tools/vibe-runtime/index.mjs governance --pr-readiness --preview --json
982
+ node tools/vibe-runtime/index.mjs governance --pr-readiness --confirm --json
983
+ node tools/vibe-runtime/index.mjs governance --show <pr-readiness-file> --json
984
+ node tools/vibe-runtime/index.mjs governance --verify <pr-readiness-file> --json
985
+ node tools/vibe-runtime/index.mjs governance --list --json
986
+ ```
987
+
988
+ confirmed sidecar 只写治理域:
989
+
990
+ ```text
991
+ .vibecoding-state/governance/<timestamp>.pr-readiness-governance.json
992
+ ```
993
+
994
+ Stage 57 artifact 固定 `artifact_kind='pr-readiness-governance'`、`stage='Stage 57'`、`mode='governance-pr-readiness'`、`optional=true`、`sidecar_only=true`、`default_enabled=false`、`release_chain_required=false`。它记录本地规则和 PR template evidence、`readiness_checks`、`agent_attribution`、`existing_pr_search.status='not_performed_offline_boundary'`、`actions_not_taken.created_pr=false`、`actions_not_taken.pushed=false`、`actions_not_taken.merged=false`,以及 `allowed_followup=['manual_review','human_submit_pr']`。
995
+
996
+ Stage 57 可以写入 blocked/manual-required 状态,用于记录缺少测试证据、人工审批或联网 duplicate PR search 的事实;verify 只校验字段一致性、本地 evidence digest 和边界断言,不要求联网成功,不要求默认产物存在。
997
+
998
+ Stage 57 必须保持 `pr=false`、`push=false`、`merge=false`、`platform_api=false`、`external_network=false`、`git=false`、`worktree=false`、`runtime_action=false`、`business_source_write=false`、`source_merge=false`。它不改变 Stage 47/48 merge readiness/apply 主链,也不改变 Stage 52 release gate required suites。
999
+
1000
+ ## Stage 58:PR Review / CI Evidence Intake Governance Sidecar
1001
+
1002
+ Stage 58 把人工提交 PR 后获得的 PR URL、duplicate search、review feedback 与 CI 结果回流为本地治理侧车。它只接收本地 evidence file,不调用 GitHub、`gh`、CI API、review API 或外部网络:
1003
+
1004
+ ```bash
1005
+ node tools/vibe-runtime/index.mjs governance --pr-review-intake --from-file <local-evidence-file> --preview --json
1006
+ node tools/vibe-runtime/index.mjs governance --pr-review-intake --from-file <local-evidence-file> --from-readiness <pr-readiness-file> --confirm --json
1007
+ node tools/vibe-runtime/index.mjs governance --show <pr-review-intake-file> --json
1008
+ node tools/vibe-runtime/index.mjs governance --verify <pr-review-intake-file> --json
1009
+ node tools/vibe-runtime/index.mjs governance --list --json
1010
+ ```
1011
+
1012
+ confirmed sidecar 只写治理域:
1013
+
1014
+ ```text
1015
+ .vibecoding-state/governance/<timestamp>.pr-review-intake-governance.json
1016
+ ```
1017
+
1018
+ Stage 58 artifact 固定 `artifact_kind='pr-review-intake-governance'`、`stage='Stage 58'`、`mode='governance-pr-review-intake'`、`optional=true`、`sidecar_only=true`、`default_enabled=false`、`release_chain_required=false`。它记录 `input_evidence_file`、`input_evidence_digest`、可选 `pr_readiness_file` / `pr_readiness_digest`、`policy_catalog_digest`、`pr_evidence.existing_pr_search.status`、`review_evidence.review_status`、`ci_evidence.ci_status`、`blocked_reasons` 与 `allowed_followup`。
1019
+
1020
+ Stage 58 可以写入 `status='manual_required'` 的侧车,用于记录缺少 PR URL、`human_submitted=true`、duplicate search、review 或 CI 证据的事实;verify 只校验字段一致性、本地 evidence digest、policy digest、可选 Stage 57 digest 与边界断言,不要求联网成功,不要求默认产物存在。
1021
+
1022
+ Stage 58 必须保持 `platform_api=false`、`external_network=false`、`git=false`、`worktree=false`、`runtime_action=false`、`auto_execution=false`、`business_source_write=false`、`source_merge=false`。它不创建 PR、不 push、不 merge、不触发 CI、不自动执行 `allowed_followup`,也不改变 Stage 57 `human_submit_pr` 语义或 Stage 52 release gate required suites。
1023
+
1024
+ ## Stage 59:Capability Convergence Contract / Gap Matrix
1025
+
1026
+ Stage 59 把 external reference、ECC、Token Savior、Distill 与 Vibecoding 自身 runtime governance 的能力收敛目标冻结成只读差距报告,不实现后续能力、不写 sidecar:
1027
+
1028
+ ```bash
1029
+ node tools/vibe-runtime/index.mjs governance --convergence --report
1030
+ node tools/vibe-runtime/index.mjs governance --convergence --report --json
1031
+ ```
1032
+
1033
+ report 必须输出 `convergence_target`、`dimensions[]`、`stage_sequence[]`、`policy_catalog_digest`、`eval_catalog_digest`、`summary` 与 `boundary_assertions`。
1034
+
1035
+ Stage 59 的能力维度固定包括:
1036
+
1037
+ - `workflow-experience`:吸收 external reference 的 workflow bootstrap、trigger discipline、skill selection 与 handoff UX,后续进入 Stage 60。
1038
+ - `learning-model`:吸收 ECC continuous-learning-v2 的 project-scoped observation、candidate instinct、confidence 与 promotion gate,后续进入 Stage 61-62。
1039
+ - `deterministic-token-economy`:吸收 Token Savior 的 pure compactor、profile、metrics 与 full-output digest,后续进入 Stage 63-64。
1040
+ - `stream-distillation`:把 Distill 的 LLM streaming distillation 作为后续可选 adapter,不进入默认 deterministic 路径。
1041
+ - `runtime-governance`:保留 Vibecoding 的 sidecar-only、verify-first、policy catalog、release gate、feedback ledger、PR readiness 与 PR review intake 治理优势,后续进入 Stage 65。
1042
+
1043
+ Stage 59 必须保持只读边界:不创建 `.vibecoding-state/`、`state_directory_created=false`、不修改 skill、`skill_mutation=false`、不注册 hook、不拦截 shell、`shell_interception=false`、不调用外部网络、不调用模型、不调用平台 API、不触发 runtime action、不调用 subagent/MCP/daemon、不执行 git/worktree、不写业务源码。
1044
+
1045
+ ## Stage 60:Workflow UX Parity / Methodology Route
1046
+
1047
+ Stage 60 先补 workflow 入口体验,不复制 external reference 的强制口吻,而是把“先选 workflow,再行动”变成 Vibecoding 的 trigger discipline 与只读 runtime route:
1048
+
1049
+ ```bash
1050
+ node tools/vibe-runtime/index.mjs methodology --route --intent feature --json
1051
+ node tools/vibe-runtime/index.mjs methodology --route --intent debug --json
1052
+ node tools/vibe-runtime/index.mjs methodology --route --intent review --json
1053
+ node tools/vibe-runtime/index.mjs methodology --gate --kind tdd --confirm --json
1054
+ ```
1055
+
1056
+ `methodology --route --intent <kind>` 必须输出 `methodology_route`,包含 `stage='Stage 60'`、`registry_stage='Stage 21'`、`registry_kind='skill-route-registry-drift-guard'`、`route_registry_id`、`route_registry_digest`、`route_kind='workflow-methodology-route'`、`selected_workflow`、`first_skill`、`required_skill`、`next_gate`、`handoff_required`、`gate_kinds`、`trigger_discipline`、`catalog_digest`、`route_digest`、`writes=false`、`state_directory_created=false`。它不创建 `.vibecoding-state/`,不写 route artifact,不执行 workflow skill,不自动进入下一步,也不制造“已使用 skill”的证据。
1057
+
1058
+ Stage 21 skill route registry drift guard 固定使用 `skill_route_registry_v1`、`route_registry_id`、`required_skill`、`next_gate`、`stop_condition`、`handoff_required` marker 校验 `using-vibecoding` route 表、runtime route map、workflow readiness normalization、`docs/workflow-chaining.md` 和安装模板同步。该 registry 只做只读漂移检测,不替代人类说明,不写状态,不调用 subagent / MCP / platform API,不触碰 git。
1059
+
1060
+ Stage 60 同步 `skills/using-vibecoding/SKILL.md`、`AGENTS.md`、`CLAUDE.md` 和安装模板中的 trigger discipline:`one_percent_rule`、用户规则优先、禁止虚假 skill claim、workflow handoff 显式交接。Stage 60 继续复用 Stage 32 `methodology --gate --kind <kind> --confirm`,只写 `.vibecoding-state/methodology-gates/*.methodology-gate.json`,不调用 planner/router/scheduler/subagent。
1061
+
1062
+ Stage 60 必须保持 `platform_api=false`、`external_delivery=false`、`model_invocation=false`、`git=false`、`worktree=false`、`subagent=false`、`mcp=false`、`business_source_write=false`、`runtime_action=false`、`auto_execution=false`、`skill_execution=false`、`daemon=false`。
1063
+
1064
+ ## Stage 63:Deterministic Token Output Compactor
1065
+
1066
+ Stage 63 建立 Token Savior 风格的确定性省流层,但只处理显式传入的本地命令输出 evidence,不拦截 shell、不执行命令、不调用模型摘要:
1067
+
1068
+ ```bash
1069
+ node tools/vibe-runtime/index.mjs tokens --catalog --json
1070
+ node tools/vibe-runtime/index.mjs tokens --compact-output --command <cmd-name> --from-file <output-file> --preview --json
1071
+ node tools/vibe-runtime/index.mjs tokens --compact-output --command <cmd-name> --from-file <output-file> --confirm --json
1072
+ node tools/vibe-runtime/index.mjs tokens --verify <token-compaction-file> --json
1073
+ ```
1074
+
1075
+ `tokens --catalog` 只读输出 `token-compactor-catalog`,包含 `git status`、`git diff --stat`、`git log --oneline`、`node --check`、`vibe-runtime-check`、`vibe-release-check` 与常见 `test/lint` 通过摘要 compactors。catalog 固定 `stage='Stage 63'`、`deterministic=true`、`pure_function=true`、`shell_interception=false`、`command_execution=false`、`external_network=false` 与 `model_invocation=false`,并输出 `catalog_digest`。
1076
+
1077
+ `tokens --compact-output --preview` 必须只读,不创建 `.vibecoding-state/`。`--from-file` 必须是 root-relative forward-slash 本地输出文件,禁止绝对路径越界、`..`、`.`、空 path segment 与反斜杠。`--confirm` 只写 `.vibecoding-state/token-economy/*.token-compaction.json`。
1078
+
1079
+ Token compaction sidecar 固定 `artifact_kind='token-compaction'`、`stage='Stage 63'`、`mode='token-compaction'`、`optional=true`、`sidecar_only=true`、`default_enabled=false`、`release_chain_required=false`、`command_name`、`normalized_command`、`command_family`、`compactor_id`、`source_file`、`source_digest`、`full_output_digest`、`compacted_text`、`compacted_digest`、`dropped_categories`、`metrics.estimated_input_tokens`、`metrics.estimated_output_tokens`、`metrics.estimated_tokens_saved`、`metrics.savings_ratio` 与 `token_compaction_digest`。
1080
+
1081
+ Stage 63 verify 必须拒绝 source digest drift、compacted text drift、metrics drift、dropped categories drift、token compaction digest mismatch、unsafe source path,以及任何 `shell_interception=true` / `command_execution=true` / `output_mutation=true` / `original_output_hidden=true` / `external_network=true` / `model_invocation=true` / `platform_api=true` / `git=true` / `worktree=true` / `runtime_action=true` / `auto_execution=true` / `subagent=true` / `mcp=true` / `daemon=true` 边界扩权。Stage 63 固定 `shell_interception=false`、`command_execution=false`、`output_mutation=false`、`original_output_hidden=false`。
1082
+
1083
+ Stage 63 不隐藏原始输出,只通过 `full_output_digest` 绑定原文;不修改源码、docs、skills、AGENTS.md 或 CLAUDE.md;不自动 rewrite 用户命令。profiles、metrics 聚合与 safe rewrite preview 留给 Stage 64。
1084
+
1085
+ ## Stage 64:Token Metrics / Profiles / Safe Rewrite Preview
1086
+
1087
+ Stage 64 补齐 Token Savior 的 profile / metrics / rewrite preview 思路,但仍保持 deterministic sidecar boundary,不接管真实 shell:
1088
+
1089
+ ```bash
1090
+ node tools/vibe-runtime/index.mjs tokens --profile --name minimal --json
1091
+ node tools/vibe-runtime/index.mjs tokens --profile --name balanced --json
1092
+ node tools/vibe-runtime/index.mjs tokens --profile --name full --json
1093
+ node tools/vibe-runtime/index.mjs tokens --metrics --from-compactions <token-compaction-file...> --preview --json
1094
+ node tools/vibe-runtime/index.mjs tokens --metrics --from-compactions <token-compaction-file...> --confirm --json
1095
+ node tools/vibe-runtime/index.mjs tokens --rewrite-preview --command <cmd> --json
1096
+ node tools/vibe-runtime/index.mjs tokens --verify <token-metrics-file> --json
1097
+ ```
1098
+
1099
+ `tokens --profile --name minimal|balanced|full` 只读选择 builtin profile,输出 `profile_kind='token-profile'`、`stage='Stage 64'`、`output_budget`、`preserve`、`prefer_compactors`、`recommended_rewrites` 与 `profile_digest`。profile 不创建 `.vibecoding-state/`,不修改 runtime policy profile,也不改变执行策略。
1100
+
1101
+ `tokens --metrics --from-compactions` 只接受 `.token-compaction.json` 文件名,先验证每个 compaction sidecar,再聚合 `artifact_kind='token-metrics'`、`source_compactions[]`、`file_digest`、`token_compaction_digest`、`totals.estimated_input_tokens`、`totals.estimated_output_tokens`、`totals.estimated_tokens_saved`、`totals.savings_ratio`、`command_families[]` 与 `token_metrics_digest`。preview 不写 sidecar;confirm 只写 `.vibecoding-state/token-economy/*.token-metrics.json`;`tokens --verify <token-metrics-file>` 必须拒绝 compaction digest drift、metrics totals drift、command families drift 与 token metrics digest mismatch。
1102
+
1103
+ `tokens --rewrite-preview --command <cmd>` 只做建议,不执行、不拦截、不改写真实命令。第一批规则包括 `git status -> git status --short --branch`、`pytest -> pytest -q --tb=line`、`tsc -> tsc --pretty false`。rewrite preview 固定 `execute=false`、`shell_interception=false`、`command_mutation=false`。
1104
+
1105
+ Stage 64 固定 `optional=true`、`sidecar_only=true`、`default_enabled=false`、`release_chain_required=false`、`deterministic=true`、`pure_function=true`、`original_output_retained_by_digest=true`、`shell_interception=false`、`command_execution=false`、`output_mutation=false`、`original_output_hidden=false`、`external_network=false`、`model_invocation=false`、`platform_api=false`、`git=false`、`worktree=false`、`runtime_action=false`、`auto_execution=false`、`subagent=false`、`mcp=false`、`daemon=false`。
1106
+
1107
+ ## Stage 65:Governance Convergence Gate
1108
+
1109
+ Stage 65 把 Stage 59-64 的 workflow、learning、token 与 runtime-governance 能力统一纳入可发布收口标准,但不把这些 optional 能力变成默认 required 主链:
1110
+
1111
+ ```bash
1112
+ node tools/vibe-runtime/index.mjs release --gate --from-evals <eval-report-file...> --with-convergence --json
1113
+ node tools/vibe-runtime/index.mjs release --gate --from-evals <eval-report-file...> --with-convergence --confirm --json
1114
+ node tools/vibe-runtime/index.mjs release --verify-gate <release-gate-file> --json
1115
+ ```
1116
+
1117
+ `--with-convergence` 只在 `release --gate` 下生效,绑定当前 read-only `governance --convergence --report` 的 `convergence_digest`、`summary`、`dimensions[]`、`boundary_assertions_digest` 与 `evidence_digest`。该 evidence 固定 `evidence_kind='governance-convergence-report'`、`stage='Stage 65'`、`optional=true`、`release_chain_required=false`、`writes=false`、`state_directory_created=false`。
1118
+
1119
+ Stage 65 不改变 Stage 52 required eval suites;未传 `--with-convergence` 的 release gate 仍按 Stage 52 逻辑工作。传入后,`release --verify-gate` 必须拒绝 convergence report digest drift、convergence evidence digest drift、evidence kind/stage/schema drift,以及任何把 optional convergence evidence 提升为 required release chain 的扩权。
1120
+
1121
+ Stage 65 的 release-check smoke 必须覆盖:workflow route 不写状态、learning preview 不写且 confirm 只写 learning sidecar、instinct promotion 不改正式 skill、token compaction/metrics deterministic 且 digest drift 失败、governance convergence report 只读、release gate 可选绑定 convergence evidence 且仍不执行 PR/git/platform/model/subagent/MCP/daemon。
1122
+
1123
+ Stage 65 固定 `sidecar_only=true`、`default_enabled=false`、`release_chain_required=false`、`convergence_evidence_bound` 只能由显式 `--with-convergence` 启用,并保持 `dispatch=false`、`session_create=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`runtime_action=false`、`business_source_write=false`、`source_merge=false`、`pr=false`、`push=false`、`merge=false`、`git=false`、`worktree=false`。
1124
+
1125
+ ## Stage 67:Commit History Audit / Release Notes Closeout
1126
+
1127
+ Stage 67 不新增 runtime 命令,也不改变 Stage 52-65 的能力语义。它把已经提交到 `HEAD` 的 Stage 52-65 能力整理成发布面材料,目标是让维护者能从提交链、文件范围和验证证据理解本轮能力收敛。
1128
+
1129
+ Stage 67 的审计对象是 `add644b..HEAD`:
1130
+
1131
+ - 提交链覆盖 Stage 52 release gate、Stage 53 feedback ledger、Stage 54 policy catalog、Stage 55 installed runtime opt-in、Stage 56 compatibility report、Stage 57 PR readiness、Stage 58 PR review intake、Stage 59 convergence report、Stage 60 workflow route、Stage 61-62 learning governance、Stage 63-64 token economy 和 Stage 65 convergence-bound release gate。
1132
+ - 文件范围集中在 `tools/vibe-runtime/index.mjs`、`tools/vibe-runtime-check/index.mjs`、`tools/vibe-release-check/index.mjs`、runtime docs、release docs、安装/doctor 工具和 `using-vibecoding` 入口规则。
1133
+ - Stage 67 只允许修改发布说明和路线图类文档;不新增 sidecar 类型、不修改 runtime command parser、不改 release gate required suites。
1134
+
1135
+ Stage 67 明确记录提交信息风险:最近提交 message 前缀包含异常 Markdown fence 标记 ```` ``` ````。该问题只影响历史展示可读性,不影响当前 runtime 行为或 release-check。默认处理方式是记录风险,不 amend、不 rebase、不 force push;如果需要修复,必须单独进入 git 历史重写决策,并由用户显式确认。
1136
+
1137
+ ## Stage 68:Release Notes Evidence / Commit Hygiene Sidecar
1138
+
1139
+ Stage 68 把发布说明和 commit hygiene 风险从人工文档升级为本地可验证 sidecar。它不修改 Stage 52-65 runtime 语义,也不把 release notes 纳入默认 release gate 主链:
1140
+
1141
+ ```bash
1142
+ node tools/vibe-runtime/index.mjs release --notes --from-file <local-evidence-file> --preview --json
1143
+ node tools/vibe-runtime/index.mjs release --notes --from-file <local-evidence-file> --confirm --json
1144
+ node tools/vibe-runtime/index.mjs release --verify-notes <release-notes-file> --json
1145
+ ```
1146
+
1147
+ 输入只来自 root 内本地 evidence file,例如人工保存的 `git log --oneline`、`git diff --stat` 和验证摘要。`--preview` 不创建 `.vibecoding-state/`;`--confirm` 只写 `.vibecoding-state/release-notes/*.release-notes.json`;`--verify-notes` 只读重建并验证 evidence digest。
1148
+
1149
+ Stage 68 sidecar 固定 `artifact_kind='release-notes'`、`stage='Stage 68'`、`mode='release-notes'`,并记录 `source_digest`、`range_hint`、`commit_count`、`stage_coverage`、`normalized_notes`、`commit_hygiene_findings` 和 `release_notes_digest`。commit hygiene 规则保持 deterministic,只识别 Markdown fence 前缀、fence token、过长 subject、非 conventional subject 等文本 finding,不做主观评审。
1150
+
1151
+ Stage 68 的 release-check smoke 必须覆盖 preview no-write、confirm one sidecar、verify ok、source digest drift、unsafe source path、boundary 扩权失败。边界固定 `history_rewrite=false`、`tag=false`、`push=false`、`pr=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`release_chain_required=false`。
1152
+
1153
+ ## Stage 69:Release Notes Evidence Backfill
1154
+
1155
+ Stage 69 不新增 runtime 命令,也不改变 Stage 68 release-notes sidecar 语义。它使用 Stage 68 已实现的 `release --notes` / `release --verify-notes` 能力,对 Stage 52-68 的本地提交链、diff stat、stage coverage 和验证摘要完成一次自举式证据回填。
1156
+
1157
+ Stage 69 的 evidence 输入位于受控 sandbox,例如 `.tmp/stage69-release-notes-root/evidence/stage69-release-evidence.txt`。验证路径必须确认 preview 不创建 `.vibecoding-state/`,confirm 只写一个 `.vibecoding-state/release-notes/*.release-notes.json` sidecar,verify 能复验原 evidence digest,并能拒绝 source digest drift、unsafe source path 和 boundary expansion。
1158
+
1159
+ Stage 69 固定不提交 `.tmp` evidence、不复制 sidecar 到源码目录、不生成 release gate、不调用平台 API、不修改 git history。历史 commit subject 中的 Markdown fence 前缀只作为 deterministic hygiene finding 记录。
1160
+
1161
+ ## Stage 70:Release Candidate Closeout / Workspace Hygiene
1162
+
1163
+ Stage 70 是发布候选收口阶段,不新增 runtime 能力。它确认 Stage 52-69 已形成可交付基线:`runtime-check` 与 `release-check --quiet` 通过,最终 `git status --short; git diff --stat` 无 tracked 输出。
1164
+
1165
+ Stage 70 只处理工作区卫生、临时产物策略和人工交付说明。`.tmp`、`.vibecoding-state` 与 release-check sandbox 产物仍属于运行态验证产物,不进入提交。Stage 70 不 amend、不 rebase、不 reset、不 tag、不 push、不创建 PR,也不改变 release gate required 主链。
1166
+
1167
+ ## Stage 73:Post-Commit Baseline / Release Notes Evidence Refresh
1168
+
1169
+ Stage 73 不新增 runtime 命令,也不改变 Stage 68 release-notes sidecar 语义。它在 `d266421` 文档基线之后,用 Stage 68 已有 `release --notes` / `release --verify-notes` 能力完成一次 sandbox-only 证据刷新,确认 Stage 69/70 归档已经进入长期文档基线。
1170
+
1171
+ Stage 73 的 evidence 与 sidecar 只位于受控 sandbox,例如 `.tmp/stage73-release-notes-root/`。验证路径覆盖 preview 不创建 `.vibecoding-state/`、confirm 只写一个 `.release-notes.json` sidecar、verify 可复验原 evidence digest,并能拒绝 source digest drift、unsafe source path 和 boundary expansion。
1172
+
1173
+ Stage 73 固定不提交 `.tmp` evidence、不复制 sidecar 到源码目录、不生成 release gate、不调用平台 API、不修改 git history、不新增 command/schema/check。Stage 73 结束时 `runtime-check` 与 `release-check --quiet` 必须通过,tracked 工作区保持干净。
1174
+
1175
+ ## Stage 76:Next Capability Lane Selection
1176
+
1177
+ Stage 76 是下一轮能力路线选择阶段,不新增 runtime 命令,也不修改 Stage 52-73 已有 sidecar 语义。它只把后续能力方向整理成可比较的路线依据,避免在同一阶段同时扩展入口体验、学习模型、token 经济和 runtime governance 状态机。
1178
+
1179
+ 候选路线按本地性、确定性、可验证性、最小切片和扩权风险排序:
1180
+
1181
+ - Agent entry experience:基于现有 `using-vibecoding` 和只读 `methodology --route` 约束,把“先选择 workflow skill 再行动”的入口体验做得更明确。最小切片应保持显式触发、只读建议、无 subagent 自动派发、无平台 API。
1182
+ - Deterministic token saving:延续 Stage 63/64 的 token compaction、profile、metrics 和 rewrite-preview 边界,优先改善可复验的上下文压缩与度量,不引入模型调用或非确定性摘要。
1183
+ - ECC learning model:延续 Stage 61/62 的 observation、candidate-instinct、promotion sidecar 思路,但下一阶段只能先定义学习证据到候选规则的边界,不直接改正式 workflow skill。
1184
+ - Runtime governance convergence:继续强化 compatibility、PR readiness、review intake、convergence、release gate 的证据链,但必须避免把可选证据提升为 required release chain。
1185
+
1186
+ 推荐 Stage 77 首选 Agent entry experience。理由是它最贴近当前用户体验缺口,也能复用既有 workflow skill 与本地 route 能力;它的最小可验证切片可以是文档化入口决策、只读路线建议和明确 handoff,不需要新增 sidecar schema。Token saving 可作为 Stage 78 候选;ECC learning model 与更强 governance 收敛应拆到后续阶段,等待入口体验和 token 预算边界稳定后再推进。
1187
+
1188
+ Stage 76 固定不提交 `.tmp`、`.vibecoding-state` 或 sandbox 产物,不新增 command/schema/check,不修改 JS 源码,不调用 subagent、MCP、平台 API、外部网络、后台 daemon,也不执行 git history rewrite、tag、push、merge 或 PR 操作。
1189
+
1190
+ ## Stage 78:Agent Entry Next-Step Advice
1191
+
1192
+ Stage 78 继续收口 Agent entry experience,但只新增本地只读入口建议层,不新增 sidecar schema,也不执行 workflow skill。它把 Stage 60 `methodology --route` 的路由结果包装成用户和 agent 更容易消费的“我现在该做什么”建议:
1193
+
1194
+ ```bash
1195
+ node tools/vibe-runtime/index.mjs entry --advice --intent <kind>
1196
+ node tools/vibe-runtime/index.mjs entry --advice --intent <kind> --json
1197
+ ```
1198
+
1199
+ `entry --advice` 输出 `entry_advice`,固定包含 `stage='Stage 78'`、`advice_kind='agent-entry-next-step-advice'`、`recommended_layer`、`first_skill`、`selected_workflow`、`manual_action`、`verification_hint`、`boundary_assertions`、`route_digest`、`catalog_digest` 和 `advice_digest`。unknown intent 必须回退到 `using-vibecoding -> vibe-brainstorming`,并提示先澄清目标、范围、约束和验收。
1200
+
1201
+ Stage 78 固定 `writes=false`、`state_directory_created=false`、`entry_advice_artifact=false`、`skill_execution=false`、`dispatch_event_modified=false`、`subagent=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`runtime_action=false`、`git=false`、`worktree=false`。`--confirm`、`--write`、`--dispatch`、`--dispatch-intent`、`--run`、`--preflight`、`--once` 和 `--scan` 必须被拒绝。release-check 必须覆盖文本输出、JSON 输出、unknown intent 回退、写入参数拒绝,以及 preview 不创建 `.vibecoding-state/`。
1202
+
1203
+ Stage 78 不修改 `skills/**` 正文,不进入 Token Savior 能力,不调用 subagent、MCP、平台 API、外部网络、模型或后台 daemon,也不执行 git history rewrite、tag、push、merge 或 PR 操作。
1204
+
1205
+ ## Stage 79:Token Savior Deterministic Advice
1206
+
1207
+ Stage 79 接续 Stage 63/64 的 deterministic token economy,但只新增 `tokens --advice` 只读建议层,不新增 sidecar schema。它把 builtin compactor catalog、token profile 和 rewrite-preview 规则组合成“当前该怎样节省 token”的确定性建议:
1208
+
1209
+ ```bash
1210
+ node tools/vibe-runtime/index.mjs tokens --advice --intent status --json
1211
+ node tools/vibe-runtime/index.mjs tokens --advice --intent verification --json
1212
+ node tools/vibe-runtime/index.mjs tokens --advice --command <cmd-name> --json
1213
+ ```
1214
+
1215
+ `tokens --advice` 输出 `token_advice`,固定包含 `stage='Stage 79'`、`advice_kind='token-saving-advice'`、`intent`、`recommended_profile`、`recommended_compactors[]`、`recommended_rewrites[]`、`manual_action`、`verification_hint`、`catalog_digest`、`profile_digest`、`boundary_assertions` 和 `advice_digest`。unknown intent 回退到通用 balanced 建议;`--command` 只产生 preview-only rewrite 建议,不执行、不拦截、不修改真实命令。
1216
+
1217
+ Stage 79 固定 `writes=false`、`state_directory_created=false`、`token_advice_artifact=false`、`shell_interception=false`、`command_execution=false`、`command_mutation=false`、`output_mutation=false`、`original_output_hidden=false`、`external_network=false`、`model_invocation=false`、`platform_api=false`、`git=false`、`worktree=false`、`subagent=false`、`mcp=false`、`daemon=false`。`--confirm`、`--preview`、`--write`、`--run`、`--preflight`、`--dispatch`、`--dispatch-intent`、`--once` 和 `--scan` 必须被拒绝,release-check 需要覆盖 JSON、文本、unknown intent、command rewrite、no-state 与负向边界。
1218
+
1219
+ Stage 79 不接入外部 Token Savior 工具链,不使用 embedding、完整 codebase index、后台 daemon 或模型摘要,不自动压缩当前会话上下文,不修改 `skills/**` 正文,也不执行 git history rewrite、tag、push、merge 或 PR 操作。
1220
+
1221
+ ## Stage 80:ECC Learning Model Advice / Promotion Boundary
1222
+
1223
+ Stage 80 接续 Stage 61/62 的 learning governance,但只新增 `learning --advice` 只读建议层,不新增 sidecar schema,也不自动 promotion。它把 observation、candidate instinct 和 manual promotion gate 的边界组合成“这条学习信号下一步应该怎么处理”的确定性建议:
1224
+
1225
+ ```bash
1226
+ node tools/vibe-runtime/index.mjs learning --advice --intent correction --json
1227
+ node tools/vibe-runtime/index.mjs learning --advice --intent repeated-workflow --json
1228
+ node tools/vibe-runtime/index.mjs learning --advice --from-observations <learning-observation-file...> --json
1229
+ node tools/vibe-runtime/index.mjs learning --advice --instinct <candidate-instinct-file> --json
1230
+ ```
1231
+
1232
+ `learning --advice` 输出 `learning_advice`,固定包含 `stage='Stage 80'`、`advice_kind='learning-model-advice'`、`intent`、`input_intent`、`recommended_next_learning_step`、`recommended_command`、`promotion_boundary`、`manual_action`、`verification_hint`、`observation_digest_refs[]`、`candidate_instinct_digest`、`boundary_assertions` 和 `advice_digest`。intent 级 advice 固定 observation-first;observation 输入只建议 candidate-instinct preview;candidate instinct 输入只建议 manual promotion preview;unknown intent 回退到 observation-first advice。
1233
+
1234
+ Stage 80 固定 `writes=false`、`state_directory_created=false`、`learning_advice_artifact=false`、`automatic_promotion=false`、`writes_formal_skills=false`、`writes_agents_md=false`、`writes_claude_md=false`、`skill_mutation=false`、`prompt_mutation=false`、`hook_registration=false`、`shell_interception=false`、`command_execution=false`、`external_network=false`、`model_invocation=false`、`platform_api=false`、`git=false`、`worktree=false`、`subagent=false`、`mcp=false`、`daemon=false`。`--confirm`、`--preview`、`--write`、`--run`、`--preflight`、`--dispatch`、`--dispatch-intent`、`--once`、`--scan` 必须被拒绝;同时传入 `--from-observations` 与 `--instinct` 也必须失败。
1235
+
1236
+ Stage 80 不修改正式 `skills/**`、`AGENTS.md`、`CLAUDE.md` 或 hook 配置,不调用模型、外部网络、平台 API、subagent、MCP 或后台 daemon,不新增 release gate required 主链。真正 promotion 仍必须显式进入 `vibe-writing-skills`,再经计划、测试和 review。
1237
+
1238
+ ## Stage 81:Runtime Governance Advice / Closeout Boundary
1239
+
1240
+ Stage 81 接续 Stage 56-59/65 的 runtime governance 能力,但只新增 `governance --advice` 只读建议层,不新增 sidecar schema,也不触发 PR/git/platform/release 自动化。它把 compatibility、PR readiness、review intake、convergence 和 release convergence binding 的边界组合成“下一步应进入哪条治理收口路径”的确定性建议:
1241
+
1242
+ ```bash
1243
+ node tools/vibe-runtime/index.mjs governance --advice --intent closeout --json
1244
+ node tools/vibe-runtime/index.mjs governance --advice --intent review --json
1245
+ node tools/vibe-runtime/index.mjs governance --advice --intent release --json
1246
+ node tools/vibe-runtime/index.mjs governance --advice --intent pr-readiness --json
1247
+ node tools/vibe-runtime/index.mjs governance --advice --intent pr-review-intake --json
1248
+ node tools/vibe-runtime/index.mjs governance --advice --intent convergence --json
1249
+ node tools/vibe-runtime/index.mjs governance --advice --intent compatibility --json
1250
+ ```
1251
+
1252
+ `governance --advice` 输出 `governance_advice`,固定包含 `stage='Stage 81'`、`advice_kind='runtime-governance-advice'`、`intent`、`input_intent`、`recommended_next_governance_step`、`recommended_command`、`manual_action`、`verification_hint`、`related_capabilities[]`、`closeout_boundary`、`boundary_assertions` 和 `advice_digest`。`closeout|convergence` 回到 read-only convergence orientation;`pr-readiness` 指向 PR readiness preview;`pr-review-intake|review` 指向本地 evidence intake preview;`release` 指向显式 release gate 与可选 convergence evidence;`compatibility` 指向只读 compatibility report;unknown intent 回退到 closeout orientation。
1253
+
1254
+ Stage 81 固定 `writes=false`、`state_directory_created=false`、`governance_advice_artifact=false`、`sidecar_write=false`、`release_gate_write=false`、`pr=false`、`push=false`、`merge=false`、`tag=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`runtime_action=false`、`auto_execution=false`、`command_execution=false`、`business_source_write=false`、`source_merge=false`、`skill_mutation=false`、`hook_registration=false`、`shell_interception=false`、`git=false`、`worktree=false`、`subagent=false`、`mcp=false`、`daemon=false`。`--confirm`、`--preview`、`--write`、`--run`、`--preflight`、`--dispatch`、`--dispatch-intent`、`--once`、`--scan` 必须被拒绝;与其他 governance mode 同时使用也必须失败。
1255
+
1256
+ Stage 81 不写 `.vibecoding-state/governance/`,不自动运行 compatibility、convergence、PR readiness、review intake 或 release gate,不创建 PR、不 push、不 merge、不 tag、不调用 GitHub/GitLab/CI API。真正写治理或发布侧车仍必须由用户显式运行对应 Stage 57/58/65/68 命令。
1257
+
1258
+ ## Stage 82:Post-Commit Baseline / Release Evidence Refresh
1259
+
1260
+ Stage 82 不新增 runtime capability,也不新增 sidecar schema。它是 Stage 78-81 advice 批次完成后的提交后收口层,用来记录当前基线、刷新 release evidence 说明,并复用 Stage 68 `release --notes` / `release --verify-notes` 进行本地证据验证。
1261
+
1262
+ 当前提交基线固定为 `65d73c6 feat(runtime): 添加 Stage 81 治理建议命令`,且 Stage 82 启动时 `git status --short` 无输出。该基线说明 Stage 81 已作为独立提交落地,工作区没有待处理变更,后续 evidence refresh 可以只围绕已提交的 Stage 78-81 advice 能力链展开。
1263
+
1264
+ Stage 78-81 的 advice 能力链包括:
1265
+
1266
+ - Stage 78 `entry --advice`:回答 agent entry 的下一步 workflow 建议。
1267
+ - Stage 79 `tokens --advice`:回答 deterministic token saving 建议。
1268
+ - Stage 80 `learning --advice`:回答 ECC learning signal 与 promotion boundary 建议。
1269
+ - Stage 81 `governance --advice`:回答 runtime governance / closeout path 建议。
1270
+
1271
+ Stage 82 的 release evidence refresh 只允许复用既有 Stage 68 能力:`release --notes --from-file <local-evidence-file> --preview|--confirm` 和 `release --verify-notes <release-notes-file>`。真实 repo 收口优先使用 preview 或 sandbox root;如需 confirm,也只能在 sandbox root 中写 `.vibecoding-state/release-notes/*.release-notes.json`,避免把临时 release evidence 写入当前 repo 状态目录。
1272
+
1273
+ Stage 82 固定不做:不新增 CLI、不修改 `tools/vibe-runtime/index.mjs` 功能逻辑、不新增 runtime-check marker、不新增 release-check smoke、不写真实 repo `.vibecoding-state/`、不创建 PR、不 push、不 merge、不 tag、不改历史提交。已有异常提交标题中的 markdown fence prefix 只作为 Stage 68 commit hygiene finding 继续记录,不在 Stage 82 中 rewrite。
1274
+
1275
+ ## Stage 83:Unified Advice Hub
1276
+
1277
+ Stage 83 新增 `advice --hub` 只读聚合入口,把 Stage 78 `entry --advice`、Stage 79 `tokens --advice`、Stage 80 `learning --advice` 和 Stage 81 `governance --advice` 组合成一个 deterministic next-step 视图。它只在当前进程内复用既有 advice envelope,不执行这些子命令,也不写任何 sidecar:
1278
+
1279
+ ```bash
1280
+ node tools/vibe-runtime/index.mjs advice --hub --intent feature --json
1281
+ node tools/vibe-runtime/index.mjs advice --hub --intent closeout --json
1282
+ node tools/vibe-runtime/index.mjs advice --hub --intent review
1283
+ ```
1284
+
1285
+ `advice --hub` 输出 `advice_hub`,固定包含 `stage='Stage 83'`、`advice_kind='unified-runtime-advice-hub'`、`input_intent`、`normalized_intent`、`primary_lane`、`primary_recommendation`、`lane_recommendations.entry`、`lane_recommendations.tokens`、`lane_recommendations.learning`、`lane_recommendations.governance`、`manual_action`、`verification_hint`、`boundary_assertions`、`lane_digests` 和 `advice_digest`。`feature|bug` 优先 entry lane;`review|closeout|release` 优先 governance lane;`status|verification|token` 优先 tokens lane;`learning` 优先 learning lane;unknown intent 回退到四 lane fallback。
1286
+
1287
+ Stage 83 固定 `writes=false`、`state_directory_created=false`、`advice_hub_artifact=false`、`sidecar_write=false`、`skill_execution=false`、`command_execution=false`、`runtime_action=false`、`auto_execution=false`、`external_network=false`、`model_invocation=false`、`platform_api=false`、`git=false`、`worktree=false`、`pr=false`、`push=false`、`merge=false`、`tag=false`、`subagent=false`、`mcp=false`、`daemon=false`、`shell_interception=false`、`business_source_write=false`、`source_merge=false`。`--confirm`、`--preview`、`--write`、`--run`、`--preflight`、`--dispatch`、`--dispatch-intent`、`--once`、`--scan` 以及具体 evidence 输入都必须被拒绝。
1288
+
1289
+ Stage 83 不替代任何真实 evidence 或 sidecar 命令。真正写 workflow、learning、token、governance、release 证据仍必须由用户显式运行对应 lane 的原始命令;hub 只负责把“下一步从哪条 lane 开始”说清楚。
1290
+
1291
+ ## Stage 85:Workflow Readiness Gate
1292
+
1293
+ Stage 85 新增 `methodology --readiness` 只读判断层,用来回答“现在是否具备进入 implementation / review / completion 等 workflow 的条件”。它在当前进程内复用 Stage 60 `methodology --route`、Stage 32 `methodology --gate` preview、Stage 30 `readiness --score` summary 和 Stage 83 `advice --hub` summary,不执行 workflow skill,不写 `.vibecoding-state/`,不创建新的 sidecar schema:
1294
+
1295
+ ```bash
1296
+ node tools/vibe-runtime/index.mjs methodology --readiness --intent implementation --json
1297
+ node tools/vibe-runtime/index.mjs methodology --readiness --intent review --json
1298
+ node tools/vibe-runtime/index.mjs methodology --readiness --intent completion --json
1299
+ node tools/vibe-runtime/index.mjs methodology --readiness --intent unknown-kind --json
1300
+ node tools/vibe-runtime/index.mjs methodology --readiness --intent review
1301
+ ```
1302
+
1303
+ `methodology --readiness` 输出 `workflow_readiness`,固定包含 `stage='Stage 85'`、`readiness_kind='workflow-readiness-gate'`、`input_intent`、`normalized_intent`、`route_summary`、`required_gate_kinds`、`gate_previews`、`runtime_readiness_summary`、`advice_hub_summary`、`ready_to_start`、`blocked_reasons`、`manual_action`、`verification_hint`、`boundary_assertions` 和 `readiness_digest`。
1304
+
1305
+ Stage 85 只判断能不能进入下一段 workflow:`implementation` 至少检查 plan 和 TDD gate preview;`review` 检查 review gate preview;`completion|release` 检查 completion gate preview;`debug` 检查 debug gate preview;unknown intent 固定 `ready_to_start=false`,并要求先澄清目标、范围、约束和验收。
1306
+
1307
+ Stage 85 不替代 Stage 32 methodology gate sidecar:需要持久化流程纪律证据时仍必须显式运行 `methodology --gate --confirm`。它也不替代 Stage 30 observability readiness score:runtime artifact health 仍由 `readiness --score` 负责。它同样不替代 Stage 83 unified advice hub:Stage 83 负责四条 advice lane 的 next-step 视图,Stage 85 只引用 hub summary 作为 readiness 判断的上下文。
1308
+
1309
+ Stage 85 固定 `writes=false`、`state_directory_created=false`、`workflow_readiness_artifact=false`、`methodology_gate_write=false`、`sidecar_write=false`、`skill_execution=false`、`command_execution=false`、`runtime_action=false`、`auto_execution=false`、`external_network=false`、`model_invocation=false`、`platform_api=false`、`git=false`、`worktree=false`、`pr=false`、`push=false`、`merge=false`、`tag=false`、`subagent=false`、`mcp=false`、`daemon=false`、`shell_interception=false`、`business_source_write=false`、`source_merge=false`。`--confirm`、`--write`、`--preview`、`--run`、`--preflight`、`--dispatch`、`--dispatch-intent`、`--once`、`--scan`、具体 evidence 输入,以及与 `--catalog`、`--route`、`--gate`、`--list`、`--show`、`--verify` 混用都必须被拒绝。
1310
+
1311
+ ## Stage 86-90:Workflow UX 与自检闭环
1312
+
1313
+ Stage 86-90 把 Stage 78-85 的分散 advice/readiness 能力收敛为更低摩擦的 workflow 入口体验,同时保持本地、确定性、只读边界。新增命令默认不写 `.vibecoding-state/`,不执行 workflow skill,不调用 subagent/MCP/daemon,不调用平台 API/外部网络/模型,不执行 git/push/PR/merge/tag,也不修改业务源码。
1314
+
1315
+ ```bash
1316
+ node tools/vibe-runtime/index.mjs planner --lint --from-file <local-plan-file> --json
1317
+ node tools/vibe-runtime/index.mjs workflow --cockpit --intent implementation --from-file <local-plan-file> --json
1318
+ node tools/vibe-runtime/index.mjs completion --readiness --from-file <local-completion-evidence-file> --json
1319
+ node tools/vibe-runtime/index.mjs bootstrap --acceptance --prompt "帮我做一个 React todo list" --json
1320
+ node tools/vibe-runtime/index.mjs evals --catalog --json
1321
+ ```
1322
+
1323
+ Stage 86 `planner --lint` 输出 `plan_lint`,固定包含 `stage='Stage 86'`、`lint_kind='plan-quality-lint'`、`source_file`、`source_digest`、`checks[]`、`blocking_findings[]`、`warnings[]`、`execution_ready`、`manual_action`、`boundary_assertions` 和 `lint_digest`。它只读取 root 内本地 plan 文件,检查文件/职责、任务粒度、接口/产物、验证策略、验收、review gate、placeholder、命令证据、依赖顺序和完成边界。
1324
+
1325
+ Stage 87 `workflow --cockpit` 输出 `workflow_cockpit`,固定包含 `stage='Stage 87'`、`cockpit_kind='workflow-cockpit'`、`current_phase`、`recommended_next_skill`、`route_summary`、`readiness_summary`、`advice_summary`、`plan_lint_summary`、`token_hint`、`learning_hint`、`governance_hint`、`blocked_reasons`、`required_evidence`、`self_check_summary`、`forbidden_actions`、`next_manual_action`、`boundary_assertions` 和 `cockpit_digest`。它复用 Stage 83 advice hub、Stage 85 workflow readiness、Stage 86 plan lint、Stage 79 token advice、Stage 80 learning advice 和 Stage 81 governance advice,只输出状态机判断,不执行任何 skill 或命令。
1326
+
1327
+ `self_check_summary` 是 P48 cockpit 的只读自检闭环:`profile_check` 只提示人工读取当前 profile;`entry_check` 绑定 `workflow --start` 入口;`readiness_check` 汇总 readiness blocker;`plan_check` 汇总可选 plan lint;`completion_check` 指向 completion readiness。它只展示证据缺口、required evidence 和下一步人工动作,不运行 profile、readiness、completion、workflow skill、subagent、git 或平台 API。
1328
+
1329
+ Stage 88 `completion --readiness` 输出 `completion_readiness`,固定包含 `stage='Stage 88'`、`readiness_kind='completion-readiness'`、可选 `evidence_file/evidence_digest`、`ready_to_report_done`、`verification_evidence[]`、`unverified_items[]`、`review_feedback_status`、`git_boundary_summary`、`release_boundary_summary`、`manual_action`、`boundary_assertions` 和 `readiness_digest`。没有验证证据、存在失败/待验证项、review feedback 未处理,或涉及 git/PR/release 但缺少人工授权时固定 blocked。
1330
+
1331
+ Stage 89 在现有 `evals` 内建 catalog 中加入 `behavior_pack='workflow-ux-stage89'`,扩展 deterministic transcript/behavior/adversarial case 覆盖,包括 `fuzzy-feature-requires-brainstorming`、`unreproduced-bug-blocks-blind-fix`、`clear-small-task-requires-verification-strategy`、`plan-execution-keeps-task-acceptance`、`review-before-merge-prioritizes-blockers`、`completion-without-verification-blocked`、`subagent-without-permission-rejected` 和 `push-pr-without-confirmation-rejected`。它不新增外部依赖,不引入 LLM judge,不扩大 Stage 52 release required suite。
1332
+
1333
+ Stage 90 `bootstrap --acceptance` 输出 `bootstrap_acceptance`,固定包含 `stage='Stage 90'`、`acceptance_kind='workflow-bootstrap-acceptance'`、`prompt`、`expected_first_skill`、`expected_behavior[]`、`observed_route_summary`、`pass`、`blocked_reasons[]`、`manual_action`、`boundary_assertions` 和 `acceptance_digest`。默认 prompt “帮我做一个 React todo list” 必须 route 到 `vibe-brainstorming` 或等价澄清/规划入口,不能直接写代码、不能调用 subagent、不能创建状态目录。
1334
+
1335
+ Stage 86/87/88/90 固定 `writes=false`、`state_directory_created=false`、`sidecar_write=false`、`skill_execution=false`、`command_execution=false`、`runtime_action=false`、`auto_execution=false`、`external_network=false`、`model_invocation=false`、`platform_api=false`、`git=false`、`worktree=false`、`pr=false`、`push=false`、`merge=false`、`tag=false`、`subagent=false`、`mcp=false`、`daemon=false`、`shell_interception=false`、`business_source_write=false`、`source_merge=false`。`--confirm`、`--write`、`--preview`、`--run`、`--preflight`、`--dispatch`、`--dispatch-intent`、`--once`、`--scan` 等执行/写入/调度类 flag 必须被拒绝。
1336
+
1337
+ ## Stage 91-95:Workflow Entry Experience Hardening
1338
+
1339
+ Stage 91-95 补强 5 个体验点:入口协议硬化、可见 skill 调用回执、统一 start-here 入口、执行编排微协议、安装后入口体检与 onboarding brief。
1340
+
1341
+ ```bash
1342
+ node tools/vibe-runtime/index.mjs entry --contract --prompt "<request>" --json
1343
+ node tools/vibe-runtime/index.mjs workflow --receipt --intent review --json
1344
+ node tools/vibe-runtime/index.mjs workflow --start --prompt "<request>" --json
1345
+ node tools/vibe-runtime/index.mjs workflow --sequence --intent implementation --json
1346
+ node tools/vibe-runtime/index.mjs onboarding --brief --json
1347
+ node tools/vibe-doctor/index.mjs --workflow-entry
1348
+ ```
1349
+
1350
+ Stage 91 输出 `entry_contract`,包含 `stage='Stage 91'`、`contract_kind='workflow-entry-contract'`、`expected_first_step='using-vibecoding'`、`required_decision`、`must_not_do_first`、`contract_digest`。
1351
+
1352
+ Stage 92 输出 `workflow_receipt`,包含 `stage='Stage 92'`、`receipt_kind='visible-skill-invocation'`、`selected_skill`、`user_visible_sentence`、`false_claim_guardrails`、`receipt_digest`。
1353
+
1354
+ Stage 93 输出 `workflow_start`,包含 `stage='Stage 93'`、`start_kind='unified-workflow-start'`、`entry_contract_summary`、`receipt_summary`、`cockpit_summary`、`readiness_summary`、`start_digest`。
1355
+
1356
+ Stage 94 输出 `workflow_sequence`,包含 `stage='Stage 94'`、`sequence_kind='execution-choreography'`、`phase_order`、`phase_entry_criteria`、`phase_exit_evidence`、`handoff_points`、`stop_conditions`、`sequence_digest`。
1357
+
1358
+ Stage 95 输出 `onboarding_brief` 与 doctor `workflow_entry_health`,包含 `stage='Stage 95'`、`brief_kind='workflow-onboarding-brief'`、`recommended_start_command`、`brief_digest`。
1359
+
1360
+ 边界固定:`entry_contract_artifact=false`、`workflow_receipt_artifact=false`、`workflow_start_artifact=false`、`workflow_sequence_artifact=false`、`onboarding_brief_artifact=false`、`state_directory_created=false`、`source_write=false`、`skill_execution=false`、`command_execution=false`、`runtime_action=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`git=false`、`worktree=false`、`pr=false`、`push=false`、`merge=false`、`tag=false`、`subagent=false`、`mcp=false`。
1361
+
1362
+ ## Stage 98:Commit Title Guard
1363
+
1364
+ Stage 98 新增 `release --commit-guard`,用于在手动提交前确定性检查 commit subject,防止 markdown fence / literal backtick 前缀继续污染提交标题。它只读解析显式 `--subject` 或 root 内本地 evidence 文件,不调用 git、不写 sidecar、不改历史。
1365
+
1366
+ ```bash
1367
+ node tools/vibe-runtime/index.mjs release --commit-guard --subject "feat(runtime): add commit guard" --json
1368
+ node tools/vibe-runtime/index.mjs release --commit-guard --from-file <local-evidence-file> --json
1369
+ ```
1370
+
1371
+ `release --commit-guard` 输出 `commit_guard`,包含 `stage='Stage 98'`、`artifact_kind='commit-title-guard'`、`guard_kind='deterministic-commit-title-guard'`、`input_kind`、`normalized_subjects`、`findings`、`guard_pass`、`blocked_reasons`、`recommended_manual_action` 和 `commit_guard_digest`。
1372
+
1373
+ 阻断项包括 `markdown-fence-prefix`、`leading-markdown-fence`、`leading-backtick-token`、`markdown-fence-token`、`empty-subject`;提醒项包括 `non-conventional-subject` 与 `subject-too-long`。
1374
+
1375
+ 边界固定:`commit_guard_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`git=false`、`git_write=false`、`history_rewrite=false`、`tag=false`、`pr=false`、`push=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`runtime_action=false`、`command_execution=false`、`worktree_write=false`、`release_gate_required=false`。
1376
+
1377
+ Stage 98 不 amend、不执行 commit、不创建 release notes,不把异常历史标题自动重写;只给出提交前的本地人工决策。
1378
+
1379
+ ## Stage 99:Completion Evidence Bundle
1380
+
1381
+ Stage 99 新增 `completion --evidence-bundle`,用于把完成前验证证据、Stage 88 readiness 判断、review 状态和 git/release 边界收敛成一个本地只读 closeout envelope。它只读取可选 `--from-file` 本地 evidence 文件,不运行测试、不写 sidecar、不执行 git/release 操作。
1382
+
1383
+ ```bash
1384
+ node tools/vibe-runtime/index.mjs completion --evidence-bundle --from-file <local-evidence-file> --json
1385
+ node tools/vibe-runtime/index.mjs completion --evidence-bundle --json
1386
+ ```
1387
+
1388
+ `completion --evidence-bundle` 输出 `completion_evidence_bundle`,包含 `stage='Stage 99'`、`bundle_kind='completion-evidence-bundle'`、`readiness_summary`、`evidence_inventory`、`closeout_decision`、`required_manual_actions`、`forbidden_actions` 和 `bundle_digest`。
1389
+
1390
+ 边界固定:`completion_evidence_bundle_artifact=false`、`verification_execution=false`、`release_notes_artifact=false`、`release_gate_artifact=false`、`commit_guard_artifact=false`、`git=false`、`push=false`、`pr=false`、`merge=false`、`tag=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`runtime_action=false`、`worktree=false`、`business_source_write=false`。
1391
+
1392
+ Stage 99 不把 bundle 视为测试执行结果,不替代人工完成判断;它只把已有本地证据和 readiness 决策封装为可复验输出。
1393
+
1394
+ ## Stage 100:Runtime Capability Surface
1395
+
1396
+ Stage 100 新增 `governance --surface`,用于把 Stage 78-100 的 runtime 能力面、命令分组、完成收口链路和边界声明收敛为一个本地只读 capability surface。它只使用内置命令元数据,不扫描外部系统、不执行列出的命令、不写 `.vibecoding-state/`。
1397
+
1398
+ ```bash
1399
+ node tools/vibe-runtime/index.mjs governance --surface --json
1400
+ node tools/vibe-runtime/index.mjs governance --surface
1401
+ ```
1402
+
1403
+ `governance --surface` 输出 `runtime_surface`,包含 `stage='Stage 100'`、`surface_kind='runtime-capability-surface'`、`capability_groups`、`stage_inventory`、`closeout_chain`、`boundary_assertions` 和 `surface_digest`。
1404
+
1405
+ 边界固定:`runtime_surface_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`runtime_action=false`、`workflow_execution=false`、`verification_execution=false`、`git=false`、`git_write=false`、`push=false`、`pr=false`、`merge=false`、`tag=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`worktree=false`、`business_source_write=false`。
1406
+
1407
+ Stage 100 不替代 release gate、completion readiness 或人工收口判断;它只提供可复验的 runtime capability inventory 和 manual closeout orientation。
1408
+
1409
+ ## Stage 101:Runtime Capability Registry
1410
+
1411
+ Stage 101 新增内部注册表文件 `tools/vibe-runtime/runtime-capability-registry.mjs`,用于把 Stage 78-101 的能力分组、阶段清单、完成收口链路和边界声明收敛成 `governance --surface` 的唯一数据来源。它不新增用户命令,不把 registry 变成动态扫描器,不执行列出的能力,也不写 `.vibecoding-state/`。
1412
+
1413
+ `governance --surface` 仍是用户入口,但 `runtime_surface` 额外包含 `registry_stage='Stage 101'`、`registry_kind='runtime-capability-registry'`、`registry_version`、`registry_digest` 和 `registry_invariants`。其中 `registry_invariants.pass=true` 表示 `capability_groups`、`stage_inventory`、`closeout_chain` 和 `boundary_assertions` 通过确定性一致性检查。
1414
+
1415
+ 边界固定:`capability_registry_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`runtime_action=false`、`workflow_execution=false`、`verification_execution=false`、`git=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`worktree=false`、`business_source_write=false`。
1416
+
1417
+ Stage 101 只做 source-of-truth 收敛;不替代 runtime-check、release-check、release gate、completion readiness 或人工完成判断。
1418
+
1419
+ ## Stage 102:Runtime Capability Registry Drift Guard
1420
+
1421
+ Stage 102 新增 `governance --surface --drift-guard`,用于把 Stage 100 surface、Stage 101 registry、README、roadmap、runtime-check 和 release-check 的契约同步状态收敛成一个只读防漂移判断。它不新增 `governance --registry`,不执行 registry 中列出的任何命令,不把 registry 变成动态仓库扫描器,也不写 `.vibecoding-state/`。
1422
+
1423
+ ```bash
1424
+ node tools/vibe-runtime/index.mjs governance --surface --drift-guard --json
1425
+ node tools/vibe-runtime/index.mjs governance --surface --drift-guard
1426
+ ```
1427
+
1428
+ `governance --surface --drift-guard` 输出 `runtime_registry_drift_guard`,包含 `stage='Stage 102'`、`guard_kind='runtime-capability-registry-drift-guard'`、`registry_stage='Stage 101'`、`surface_stage='Stage 100'`、`guard_pass`、`checked`、`findings`、`doc_marker_expectations`、`manual_action` 和 `drift_guard_digest`。
1429
+
1430
+ 边界固定:`runtime_registry_drift_guard_artifact=false`、`capability_registry_artifact=false`、`runtime_surface_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`runtime_action=false`、`workflow_execution=false`、`verification_execution=false`、`git=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`worktree=false`、`business_source_write=false`。
1431
+
1432
+ Stage 102 不替代 release gate、completion readiness、runtime-check 或 release-check;它只把“registry/source/docs/check/smoke 是否同步”变成可复验的本地只读结论。
1433
+
1434
+ ## Stage 103:Runtime Automation Readiness Matrix
1435
+
1436
+ Stage 103 新增 `automation --readiness`,用于把 Stage 101 registry 中的 capability command surface 分类为 `auto_safe`、`confirm_required`、`advice_only` 和 `forbidden` 四类自动化就绪等级。它只产出 `runtime_automation_readiness`,不生成 automation plan,不执行任何 classified command,也不做 confirmed one-shot execution。
1437
+
1438
+ ```bash
1439
+ node tools/vibe-runtime/index.mjs automation --readiness --json
1440
+ node tools/vibe-runtime/index.mjs automation --readiness
1441
+ ```
1442
+
1443
+ `automation --readiness` 输出 `runtime_automation_readiness`,包含 `stage='Stage 103'`、`readiness_kind='runtime-automation-readiness-matrix'`、`registry_stage='Stage 101'`、`registry_kind='runtime-capability-registry'`、`registry_version`、`registry_digest`、`categories`、`category_counts`、`matrix_entries`、`categorized`、`transition_contract`、`boundary_assertions`、`readiness_invariants` 和 `readiness_digest`。
1444
+
1445
+ 分类固定:`auto_safe` 只允许确定性只读报告/guard/lint;`confirm_required` 只表示既有本地 sidecar/state 写入命令仍必须显式确认;`advice_only` 只表示 workflow/token/learning/governance 建议不能被当作执行批准;`forbidden` 固定覆盖 git push/PR/merge、平台 API、外部网络、模型调用、subagent/session 创建、业务源码自动修改和 one-shot execution。
1446
+
1447
+ 边界固定:`automation_readiness_artifact=false`、`automation_plan_artifact=false`、`one_shot_execution_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`runtime_action=false`、`workflow_execution=false`、`verification_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`push=false`、`pr=false`、`merge=false`、`tag=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1448
+
1449
+ Stage 103 固定路线为 `Automation Readiness -> Automation Plan -> Confirmed One-shot Execution` 的第一步;Stage 104 才能考虑 `automation --plan`,且 Stage 103 不替代 release gate、completion readiness、scheduler、daemon、execute 或人工确认。
1450
+
1451
+ ## Stage 104:Workflow Loop Contract
1452
+
1453
+ Stage 104 新增 `workflow --loop-contract`,用于把 `plan -> docs -> code -> self_test -> commit_readiness` 闭环收敛成一个本地只读合同。它读取既有 workflow start、workflow sequence、automation readiness 和 registry closeout chain 的 digest,不生成 automation plan,不执行任何命令,不写 `.vibecoding-state/`。
1454
+
1455
+ ```bash
1456
+ node tools/vibe-runtime/index.mjs workflow --loop-contract --intent implementation --json
1457
+ node tools/vibe-runtime/index.mjs workflow --loop-contract --intent implementation
1458
+ node tools/vibe-runtime/index.mjs workflow --loop-contract --prompt "实现一个运行时闭环合同" --json
1459
+ node tools/vibe-runtime/index.mjs workflow --loop-contract --intent plan --from-file <local-plan-file> --json
1460
+ ```
1461
+
1462
+ `workflow --loop-contract` 输出 `workflow_loop_contract`,包含 `stage='Stage 104'`、`contract_kind='workflow-loop-contract'`、`loop_phases`、`phase_contracts`、`source_bindings`、`closeout_chain_summary`、`automation_boundary_summary`、`allowed_followup`、`forbidden_actions`、`loop_contract_invariants` 和 `loop_contract_digest`。
1463
+
1464
+ 五段闭环固定为 `plan`、`docs`、`code`、`self_test`、`commit_readiness`。每个 `phase_contracts` 条目都包含 `entry_criteria`、`required_evidence`、`recommended_skill_or_command`、`exit_receipt` 和 `stop_conditions`。
1465
+
1466
+ 边界固定:`workflow_loop_contract_artifact=false`、`automation_plan_artifact=false`、`one_shot_execution_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`runtime_action=false`、`workflow_execution=false`、`verification_execution=false`、`test_execution=false`、`repair_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`push=false`、`pr=false`、`merge=false`、`tag=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1467
+
1468
+ Stage 104 是 `Automation Readiness Matrix -> Workflow Loop Contract -> Plan-to-Action Manifest -> Self-test Gate Profile -> Commit Readiness Envelope` 的第二步。它不把 `auto_safe` 升级成自动执行,不把 `workflow_loop_contract` 当作提交许可,也不替代用户确认。
1469
+
1470
+ ## Stage 105:Plan-to-Action Manifest
1471
+
1472
+ Stage 105 新增 `planner --action-manifest`,用于从一个本地计划文件确定性派生 `action_items`、`docs_expectations`、`code_expectations` 和 `check_expectations`。它读取 `planner --lint`、`workflow --loop-contract`、`automation --readiness` 和 runtime capability registry 的 digest,不生成 automation plan,不执行任何 action item,不运行检查,不写 `.vibecoding-state/`。
1473
+
1474
+ ```bash
1475
+ node tools/vibe-runtime/index.mjs planner --action-manifest --from-file <local-plan-file> --json
1476
+ node tools/vibe-runtime/index.mjs planner --action-manifest --from-file <local-plan-file>
1477
+ node tools/vibe-runtime/index.mjs planner --action-manifest --from-file <local-plan-file> --intent implementation --json
1478
+ ```
1479
+
1480
+ `planner --action-manifest` 输出 `plan_action_manifest`,包含 `stage='Stage 105'`、`manifest_kind='plan-to-action-manifest'`、`source_plan`、`source_bindings`、`action_items`、`docs_expectations`、`code_expectations`、`check_expectations`、`handoff_order`、`allowed_followup`、`forbidden_actions`、`manifest_invariants` 和 `plan_action_manifest_digest`。
1481
+
1482
+ 每个 `action_items` 条目都固定包含 `execution_authorized=false`。`check_expectations` 只表示后续验证需要的证据,不表示 Stage 105 会运行检查。
1483
+
1484
+ 边界固定:`plan_action_manifest_artifact=false`、`automation_plan_artifact=false`、`one_shot_execution_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`runtime_action=false`、`workflow_execution=false`、`verification_execution=false`、`test_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`push=false`、`pr=false`、`merge=false`、`tag=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1485
+
1486
+ Stage 105 是 `Automation Readiness Matrix -> Workflow Loop Contract -> Plan-to-Action Manifest -> Self-test Gate Profile -> Commit Readiness Envelope -> Confirmed One-shot Execution Plan` 的第三步。它不把 `planner --action-manifest` 输出当作执行许可,不把 `auto_safe` 分类升级成自动执行,也不替代用户确认。
1487
+
1488
+ ## Stage 106:Self-test Gate Profile
1489
+
1490
+ Stage 106 新增 `verification --self-test-profile`,用于从 Stage 105 的 `check_expectations` 确定性派生 `self_test_gate_profile`。它只把建议检查归类为 `gate_items`、`gate_categories`、`coverage`、`evidence_requirements` 和 `recommended_order`,不运行任何检查或测试。
1491
+
1492
+ ```bash
1493
+ node tools/vibe-runtime/index.mjs verification --self-test-profile --from-file <local-plan-file> --json
1494
+ node tools/vibe-runtime/index.mjs verification --self-test-profile --from-file <local-plan-file>
1495
+ ```
1496
+
1497
+ `verification --self-test-profile` 输出 `self_test_gate_profile`,包含 `stage='Stage 106'`、`profile_kind='self-test-gate-profile'`、`source_bindings`、`gate_items`、`gate_categories`、`coverage`、`evidence_requirements`、`profile_invariants` 和 `self_test_gate_profile_digest`。
1498
+
1499
+ 每个 `gate_items` 条目都固定包含 `status='planned_not_run'` 和 `execution_authorized=false`。Stage 106 不运行 `node --check`、`runtime-check`、`release-check`、`git diff --check`、测试、修复或格式化。
1500
+
1501
+ 边界固定:`self_test_gate_profile_artifact=false`、`test_result_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`test_execution=false`、`verification_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`runtime_action=false`、`workflow_execution=false`、`git=false`、`git_write=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1502
+
1503
+ Stage 106 是 `Automation Readiness Matrix -> Workflow Loop Contract -> Plan-to-Action Manifest -> Self-test Gate Profile -> Commit Readiness Envelope -> Confirmed One-shot Execution Plan` 的第四步。它只准备提交前验证画像,不把任何 recommended check 当作已执行证据。
1504
+
1505
+ ## Stage 107:Commit Readiness Envelope
1506
+
1507
+ Stage 107 新增 `release --commit-readiness`,用于从 Stage 105 的 `plan_action_manifest`、Stage 106 的 `self_test_gate_profile` 和 Stage 98 的 `commit_guard` 确定性派生 `commit_readiness`。它只声明提交前证据要求和阻断条件,不运行检查、不执行 git、不提交。
1508
+
1509
+ ```bash
1510
+ node tools/vibe-runtime/index.mjs release --commit-readiness --from-file <local-plan-file> --subject <commit-subject> --json
1511
+ node tools/vibe-runtime/index.mjs release --commit-readiness --from-file <local-plan-file> --subject <commit-subject>
1512
+ ```
1513
+
1514
+ `release --commit-readiness` 输出 `commit_readiness`,包含 `stage='Stage 107'`、`readiness_kind='commit-readiness-envelope'`、`source_bindings`、`commit_subject`、`worktree_snapshot_requirements`、`readiness_gates`、`evidence_bundle_requirements`、`readiness_order`、`readiness_state`、`readiness_invariants` 和 `commit_readiness_digest`。
1515
+
1516
+ 每个 `readiness_gates` 条目都固定包含 `execution_authorized=false` 和 `commit_execution_authorized=false`。`readiness_state.commit_ready=false`,直到用户在 Stage 107 外部补齐并复核 fresh worktree / check evidence。
1517
+
1518
+ 边界固定:`commit_readiness_artifact=false`、`commit_artifact=false`、`test_result_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`test_execution=false`、`verification_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`runtime_action=false`、`workflow_execution=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1519
+
1520
+ Stage 107 是 `Automation Readiness Matrix -> Workflow Loop Contract -> Plan-to-Action Manifest -> Self-test Gate Profile -> Commit Readiness Envelope -> Confirmed One-shot Execution Plan` 的第五步。它可以说明还缺哪些提交证据,但不会替用户执行提交、push、PR、merge、检查、测试、修复或格式化。
1521
+
1522
+ ## Stage 108:Confirmed One-shot Execution Plan
1523
+
1524
+ Stage 108 新增 `automation --one-shot-plan`,用于从一个本地 plan 文件、Stage 107 的 `commit_readiness`、Stage 103 的 `runtime_automation_readiness` 和 runtime capability registry 确定性派生 `confirmed_one_shot_plan`。`--confirm-plan` 只确认“生成已确认的一次性执行计划合同”,不等价于 `--confirm`,也不授权执行任何动作。
1525
+
1526
+ ```bash
1527
+ node tools/vibe-runtime/index.mjs automation --one-shot-plan --from-file <local-plan-file> --subject <commit-subject> --confirm-plan <phrase> --json
1528
+ node tools/vibe-runtime/index.mjs automation --one-shot-plan --from-file <local-plan-file> --subject <commit-subject> --confirm-plan <phrase>
1529
+ ```
1530
+
1531
+ `automation --one-shot-plan` 输出 `confirmed_one_shot_plan`,包含 `stage='Stage 108'`、`plan_kind='confirmed-one-shot-execution-plan'`、`source_bindings`、`confirmation_gate`、`execution_contract`、`planned_steps`、`preflight_evidence_expectations`、`execution_order`、`recovery_notes`、`readiness_state`、`plan_invariants` 和 `confirmed_one_shot_plan_digest`。
1532
+
1533
+ 每个 `planned_steps` 条目都固定包含 `status='planned_not_executed'`、`actions_executed=false` 和 `execution_authorized=false`。`execution_contract.plan_confirmed=true` 只说明计划合同已确认;`execution_contract.actions_executed=false`、`execution_contract.execution_authorized=false` 和 `readiness_state.ready_for_runtime_execution=false` 固定保持不变。
1534
+
1535
+ 边界固定:`confirmed_one_shot_plan_artifact=false`、`one_shot_execution_plan_artifact=false`、`one_shot_execution_artifact=false`、`execution_artifact=false`、`commit_readiness_artifact=false`、`commit_artifact=false`、`test_result_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`test_execution=false`、`verification_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`runtime_action=false`、`workflow_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1536
+
1537
+ Stage 108 是 `Automation Readiness Matrix -> Workflow Loop Contract -> Plan-to-Action Manifest -> Self-test Gate Profile -> Commit Readiness Envelope -> Confirmed One-shot Execution Plan` 的第六步。它只把闭环做成可见、可验、可恢复的本地合同,不运行检查、测试、修复、格式化、代码生成、git、commit、push、PR、merge、scheduler、daemon、retry、平台 API、外部网络、模型、MCP、subagent 或源码写入。
1538
+
1539
+ ## Stage 109:Close-loop Dashboard
1540
+
1541
+ Stage 109 新增 `workflow --close-loop-dashboard`,用于把 Stage 105 的 `plan_action_manifest`、Stage 106 的 `self_test_gate_profile`、Stage 107 的 `commit_readiness` 和可选 Stage 108 的 `confirmed_one_shot_plan` 状态聚合成用户可读闭环总览。它是 dashboard only, no execution。
1542
+
1543
+ ```bash
1544
+ node tools/vibe-runtime/index.mjs workflow --close-loop-dashboard --from-file <local-plan-file> --subject <commit-subject> --json
1545
+ node tools/vibe-runtime/index.mjs workflow --close-loop-dashboard --from-file <local-plan-file> --subject <commit-subject>
1546
+ node tools/vibe-runtime/index.mjs workflow --close-loop-dashboard --from-file <local-plan-file> --subject <commit-subject> --confirm-plan <phrase> --intent implementation --json
1547
+ ```
1548
+
1549
+ `workflow --close-loop-dashboard` 输出 `close_loop_dashboard`,包含 `stage='Stage 109'`、`dashboard_kind='close-loop-dashboard'`、`source_bindings`、`plan_status`、`docs_status`、`code_status`、`self_test_status`、`commit_status`、`one_shot_status`、`dashboard_invariants` 和 `close_loop_dashboard_digest`。
1550
+
1551
+ 该 dashboard 只展示期望数量、缺口、gate 状态和下一步人工动作。`self_test_status` 保持 `planned_not_run`,`commit_status.commit_ready=false`,`one_shot_status.ready_for_runtime_execution=false`,`actions_executed=false`,`execution_authorized=false`。可选 `--confirm-plan` 只纳入 Stage 108 confirmed plan contract 状态,不授权执行。
1552
+
1553
+ 边界固定:`close_loop_dashboard_artifact=false`、`plan_action_manifest_artifact=false`、`self_test_gate_profile_artifact=false`、`commit_readiness_artifact=false`、`confirmed_one_shot_plan_artifact=false`、`one_shot_execution_artifact=false`、`test_result_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`test_execution=false`、`check_execution=false`、`verification_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`runtime_action=false`、`workflow_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1554
+
1555
+ Stage 109 是证据摄入和 diff 覆盖前的总览层。它不运行检查、测试、修复、格式化、代码生成、git、commit、push、PR、merge、scheduler、daemon、retry、平台 API、外部网络、模型、MCP、subagent 或源码写入。
1556
+
1557
+ ## Stage 110:Evidence Intake Envelope
1558
+
1559
+ Stage 110 新增 `verification --evidence-intake`,用于读取一个本地 evidence JSON 文件,只验证证据结构、freshness 标记和可选 Stage 106 gate 覆盖。它不会执行 `checks[].command`。
1560
+
1561
+ ```bash
1562
+ node tools/vibe-runtime/index.mjs verification --evidence-intake --from-file <local-evidence-file> --json
1563
+ node tools/vibe-runtime/index.mjs verification --evidence-intake --from-file <local-evidence-file> --from-plan <local-plan-file> --json
1564
+ node tools/vibe-runtime/index.mjs verification --evidence-intake --from-file <local-evidence-file> --from-plan <local-plan-file>
1565
+ ```
1566
+
1567
+ 输入 evidence JSON 建议包含 `created_at` 与 `checks[]`,每个 check 包含 `command`、`exit_status`、`key_output`、`artifact`、`freshness`、`coverage` 和 `gate_id`。
1568
+
1569
+ `verification --evidence-intake` 输出 `evidence_intake`,包含 `stage='Stage 110'`、`intake_kind='evidence-intake-envelope'`、`source_evidence`、`source_bindings`、`evidence_intake`、`evidence_items`、`freshness_findings`、`gate_coverage`、`blocked_reasons`、`evidence_intake_invariants` 和 `evidence_intake_digest`。
1570
+
1571
+ 当提供 `--from-plan` 时,Stage 110 会只读复算 Stage 105/106,并用 `checks[].gate_id` 对齐派生的 `self_test_gate_profile`。不提供 `--from-plan` 时,仍会验证 evidence 结构和 freshness,但 gate coverage 不绑定 Stage 106。
1572
+
1573
+ 边界固定:`evidence_intake_artifact=false`、`evidence_artifact_write=false`、`test_result_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`runtime_action=false`、`workflow_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1574
+
1575
+ Stage 110 不运行检查、测试、修复、格式化、代码生成、git、commit、push、PR、merge、scheduler、daemon、retry、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只消费用户提供的本地 evidence 文件。
1576
+
1577
+ ## Stage 111:Diff Coverage Envelope
1578
+
1579
+ Stage 111 新增 `release --diff-coverage`,用于读取一个本地 diff 文件,并把实际改动文件与 Stage 105 `plan_action_manifest` 中的目标文件、docs expectations 和 code expectations 对齐。它不会调用 `git`,diff 必须由用户在 runtime 外部手动捕获。
1580
+
1581
+ ```bash
1582
+ node tools/vibe-runtime/index.mjs release --diff-coverage --from-file <local-diff-file> --from-plan <local-plan-file> --json
1583
+ node tools/vibe-runtime/index.mjs release --diff-coverage --from-file <local-diff-file> --from-plan <local-plan-file>
1584
+ ```
1585
+
1586
+ 输入 diff 可以是本地保存的 `git diff`、`git diff --stat` 或 `git diff --name-only` 输出。Stage 111 只解析其中的 changed files,不执行 diff 命令。
1587
+
1588
+ `release --diff-coverage` 输出 `diff_coverage`,包含 `stage='Stage 111'`、`coverage_kind='diff-coverage-envelope'`、`source_diff`、`source_bindings`、`diff_coverage`、`changed_files`、`expected_files`、`covered_expected_files`、`missing_expected_files`、`unexpected_files`、`docs_coverage`、`code_coverage`、`safety_findings`、`blocked_reasons`、`diff_coverage_invariants` 和 `diff_coverage_digest`。
1589
+
1590
+ 规则固定:绝对路径、`..`、反斜杠路径、明显二进制 diff 或过大输入会进入 findings / blocked,不自动修复。
1591
+
1592
+ 边界固定:`diff_coverage_artifact=false`、`diff_artifact_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`runtime_action=false`、`workflow_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1593
+
1594
+ Stage 111 不运行 git、检查、测试、修复、格式化、代码生成、commit、push、PR、merge、scheduler、daemon、retry、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只消费用户提供的本地 diff 文件。
1595
+
1596
+ ## Stage 112:Review Intake / Resolution Envelope
1597
+
1598
+ Stage 112 新增只读 `review` command family,把本地 review feedback 和本地修复证据纳入闭环,但不调用 reviewer、不创建 subagent、不查平台 API、不修代码。
1599
+
1600
+ ```bash
1601
+ node tools/vibe-runtime/index.mjs review --intake --from-file <local-review-file> --from-plan <local-plan-file> --json
1602
+ node tools/vibe-runtime/index.mjs review --intake --from-file <local-review-file>
1603
+ node tools/vibe-runtime/index.mjs review --resolution --from-file <local-review-intake-file> --from-evidence <local-evidence-file> --json
1604
+ node tools/vibe-runtime/index.mjs review --resolution --from-file <local-review-intake-file> --from-evidence <local-evidence-file>
1605
+ ```
1606
+
1607
+ `review --intake` 输出 `review_intake`,包含 `stage='Stage 112'`、`review_kind='review-intake-envelope'`、`source_review`、`source_bindings`、`review_items`、`severity`、`impacted_files`、`impacted_action_items`、`required_evidence`、`blocked`、`blocked_reasons`、`review_intake_invariants` 和 `review_intake_digest`。
1608
+
1609
+ `review --resolution` 输出 `review_resolution`,包含 `stage='Stage 112'`、`review_kind='review-resolution-envelope'`、`source_review_intake`、`source_evidence`、`resolution_items`、`resolved`、`accepted_risk`、`missing_evidence`、`blocked`、`blocked_reasons`、`review_resolution_invariants` 和 `review_resolution_digest`。
1610
+
1611
+ 边界固定:`review_intake_artifact=false`、`review_resolution_artifact=false`、`evidence_artifact_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`reviewer_invocation=false`、`runtime_action=false`、`workflow_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1612
+
1613
+ Stage 112 不运行 reviewer、subagent、平台 API、外部网络、模型、MCP、git、检查、测试、修复、格式化、代码生成、commit、push、PR、merge、scheduler、daemon、retry 或源码写入。它只消费用户提供的本地 review 和 repair evidence 文件。
1614
+
1615
+ ## Stage 113:TDD Trace Contract
1616
+
1617
+ Stage 113 新增只读 `verification --tdd-trace`,用于证明用户提供的本地 RED -> GREEN -> REFACTOR 证据顺序。它不会运行测试、检查或修复命令,只验证 trace JSON 的结构、顺序、阶段结果和可选 Stage 105 action item 覆盖。
1618
+
1619
+ ```bash
1620
+ node tools/vibe-runtime/index.mjs verification --tdd-trace --from-file <local-tdd-trace-file> --from-plan <local-plan-file> --json
1621
+ node tools/vibe-runtime/index.mjs verification --tdd-trace --from-file <local-tdd-trace-file>
1622
+ ```
1623
+
1624
+ 输入 trace 建议包含 `red.command`、`red.exit_status`、`red.expected_failure`、`red.key_output`、`green.command`、`green.exit_status`、`green.key_output`、`refactor.command`、`refactor.exit_status`、`refactor.key_output` 和 `covered_action_items[]`。
1625
+
1626
+ `verification --tdd-trace` 输出 `tdd_trace_contract`,包含 `stage='Stage 113'`、`trace_kind='tdd-trace-contract'`、`source_trace`、`source_bindings`、`cycle_order`、`red_verified`、`green_verified`、`refactor_verified`、`covered_action_items`、`coverage`、`blocked`、`blocked_reasons`、`tdd_trace_invariants` 和 `tdd_trace_digest`。
1627
+
1628
+ 边界固定:`tdd_trace_artifact=false`、`test_result_artifact=false`、`evidence_artifact_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`runtime_action=false`、`workflow_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1629
+
1630
+ Stage 113 不运行测试、检查、修复、格式化、代码生成、git、commit、push、PR、merge、scheduler、daemon、retry、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只消费用户提供的本地 TDD trace 文件。
1631
+
1632
+ ## Stage 114:Human-friendly Runtime Aliases
1633
+
1634
+ Stage 114 增加只读 workflow alias,用面向人的标签隐藏 Stage 细节,同时保留底层 deterministic envelope。`workflow --close-loop` 复用 Stage 109 dashboard 输出人性化闭环摘要;`workflow --next-evidence` 组合 Stage 105 和可选 Stage 110-113 本地证据信封,提示下一类应补证据。
1635
+
1636
+ ```bash
1637
+ node tools/vibe-runtime/index.mjs workflow --close-loop --from-file <local-plan-file> --subject <commit-subject> --json
1638
+ node tools/vibe-runtime/index.mjs workflow --close-loop --from-file <local-plan-file> --subject <commit-subject>
1639
+ node tools/vibe-runtime/index.mjs workflow --next-evidence --from-file <local-plan-file> --evidence-file <local-evidence-json> --diff-file <local-diff-file> --review-file <local-review-json> --tdd-file <local-tdd-trace-json> --json
1640
+ node tools/vibe-runtime/index.mjs workflow --next-evidence --from-file <local-plan-file>
1641
+ ```
1642
+
1643
+ 两个 alias 都输出 `human_friendly_alias`,包含 `stage='Stage 114'`、`alias_kind`、`source_bindings`、`labels`、`sections`、`evidence_inputs`、`evidence_gaps`、`next_evidence`、`human_friendly_alias_invariants` 和 `human_friendly_alias_digest`。文本输出优先展示 `Plan`、`Docs`、`Code`、`Self-test`、`Diff`、`Review`、`TDD`、`Commit`、`Next evidence`。
1644
+
1645
+ 边界固定:`human_friendly_alias_artifact=false`、`close_loop_alias_artifact=false`、`next_evidence_alias_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`repair_execution=false`、`formatting_execution=false`、`code_generation=false`、`runtime_action=false`、`workflow_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1646
+
1647
+ Stage 114 不运行检查、测试、review、TDD、修复、格式化、代码生成、git、commit、push、PR、merge、scheduler、daemon、retry、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只读取显式本地文件并组合既有只读 envelope。
1648
+
1649
+ ## Stage 115:external reference Gap Matrix
1650
+
1651
+ Stage 115 增加只读 `governance --external-reference-gap`,把与 `fork/<external-reference>` 的全方位比较固化为可复验本地矩阵。它读取本地 external reference 关键 skill/hook/README 与 Vibecoding runtime/registry/adapter 文档,比较入口体验、skill 触发纪律、计划质量、TDD、执行闭环、review、完成前验证、commit 收口、安装 bootstrap 和合同治理。
1652
+
1653
+ ```bash
1654
+ node tools/vibe-runtime/index.mjs governance --external-reference-gap --from-external-reference fork/<external-reference> --json
1655
+ node tools/vibe-runtime/index.mjs governance --external-reference-gap --from-external-reference fork/<external-reference>
1656
+ ```
1657
+
1658
+ `governance --external-reference-gap` 输出 `external_reference_gap_matrix`,包含 `stage='Stage 115'`、`gap_kind='external-reference-gap-matrix'`、`source_summary`、`registry_binding`、`dimensions`、`vibecoding_advantages`、`external_reference_advantages`、`priority_gaps`、`recommended_stage_sequence`、`gap_matrix_invariants` 和 `gap_matrix_digest`。
1659
+
1660
+ 边界固定:`external_reference_gap_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`skill_execution=false`、`runtime_action=false`、`workflow_execution=false`、`auto_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1661
+
1662
+ Stage 115 不运行 external reference 或 Vibecoding skill,不执行命令、检查、测试、修复、git、commit、push、PR、merge、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只读取本地比较源并输出确定性差距矩阵。
1663
+
1664
+ ## Stage 116:Progressive Entry UX Contract
1665
+
1666
+ Stage 116 增加只读 `workflow --entry-ux`,把用户第一句话转成一屏式入口合同。它吸收 external reference “开局知道该做什么”的体验优势,但不注入完整 skill、不创建 session、不声称已经执行 skill。
1667
+
1668
+ ```bash
1669
+ node tools/vibe-runtime/index.mjs workflow --entry-ux --prompt "implement the next stage" --json
1670
+ node tools/vibe-runtime/index.mjs workflow --entry-ux --prompt "review this branch" --from-gap .tmp/stage115-gap.json
1671
+ ```
1672
+
1673
+ `workflow --entry-ux` 输出 `progressive_entry_ux`,包含 `stage='Stage 116'`、`contract_kind='progressive-entry-ux-contract'`、`recommended_workflow`、`why_this_route`、`minimum_next_action`、`visible_sentence`、`bootstrap_policy`、`do_not_do_yet`、`source_bindings`、`entry_ux_invariants` 和 `contract_digest`。`bootstrap_policy.marker='injectsFullSkill=false'` 是显式 marker,用来证明入口 UX 保持轻量,不注入完整 skill。
1674
+
1675
+ 边界固定:`progressive_entry_ux_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`skill_execution=false`、`workflow_execution=false`、`runtime_action=false`、`auto_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1676
+
1677
+ Stage 116 不运行 workflow skill,不执行命令、检查、测试、修复、格式化、代码生成、git、commit、push、PR、merge、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只读取可选本地 Stage 115 gap JSON,并输出确定性的下一步入口建议。
1678
+
1679
+ ## Stage 117:Executable Plan Quality Contract
1680
+
1681
+ Stage 117 增加只读 `planner --executable-plan`,把 prose plan 变成结构化、可打分、可阻塞的计划质量合同。它检查计划是否具备 exact file paths、action items、docs/code expectations、test or verification commands、expected output markers、commit subject hints、no placeholders、stage boundaries 和 rollback / stop conditions。
1682
+
1683
+ ```bash
1684
+ node tools/vibe-runtime/index.mjs planner --executable-plan --from-file .tmp/stage117-plan.md --json
1685
+ node tools/vibe-runtime/index.mjs planner --executable-plan --from-file .tmp/stage117-plan.md
1686
+ ```
1687
+
1688
+ `planner --executable-plan` 输出 `executable_plan_contract`,包含 `stage='Stage 117'`、`contract_kind='executable-plan-quality-contract'`、`requirement_checks`、`task_readiness`、`task_quality_contract`、`failure_mode`、`missing_requirements`、`blocked_reasons`、`plan_quality_score`、`plan_quality_pass`、`extracted_expectations`、`executable_plan_invariants` 和 `executable_plan_digest`。`task_quality_contract` 要求每个 task 在进入 Stage 118 runbook 前都绑定文件、验证命令、输出标记和停止条件。失败模式固定为 `blocking_gaps_only=true`、`auto_repair=false`、`plan_mutation=false`。
1689
+
1690
+ 边界固定:`executable_plan_artifact=false`、`plan_repair_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`repair_execution=false`、`action_item_execution=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1691
+
1692
+ Stage 117 不执行命令、检查、测试、action items、修复、格式化、代码生成、git、commit、push、PR、merge、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只读取一个本地计划文件,绑定 plan lint 与 registry 证据,并输出 Stage 118 runbook 前的确定性质量判断。
1693
+
1694
+ ## Stage 118:Sequential Stage Runbook
1695
+
1696
+ Stage 118 增加只读 `automation --stage-runbook`,把本地计划文件和可选 Stage 117 executable plan JSON 转成确定性的顺序 stage 控制面 runbook。它只输出顺序、输入、验证、证据、commit subject、阻塞条件和下一 stage,不执行任何步骤。
1697
+
1698
+ ```bash
1699
+ node tools/vibe-runtime/index.mjs automation --stage-runbook --from-plan .tmp/stage118-plan.md --json
1700
+ node tools/vibe-runtime/index.mjs automation --stage-runbook --from-plan .tmp/stage118-plan.md --from-executable-plan .tmp/stage117-executable-plan.json
1701
+ ```
1702
+
1703
+ `automation --stage-runbook` 输出 `sequential_stage_runbook`,包含 `stage='Stage 118'`、`runbook_kind='sequential-stage-runbook'`、`stage_sequence`、`stage_order_gate`、`execution_order`、`files_to_change`、`validation_commands`、`evidence_required`、`commit_subject`、`stop_if`、`next_stage`、`blocked_reasons`、`ready_for_evidence_binding`、`runbook_invariants` 和 `stage_runbook_digest`。`stage_order_gate` 记录每个 stage 的输入、依赖 gate、mutex/conflict 边界、提交条件和停止条件,并固定 `auto_execution=false`、`command_execution=false`、`git_write=false`。
1704
+
1705
+ 边界固定:`stage_runbook_artifact=false`、`runbook_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`plan_mutation=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`runtime_action=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1706
+
1707
+ Stage 118 不执行 stage、命令、检查、测试、action items、修复、格式化、代码生成、git、commit、push、PR、merge、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只读取本地计划输入,并输出 Stage 119 execution evidence binder 所需的证据绑定期望。
1708
+
1709
+ ## Stage 119:Execution Evidence Binder
1710
+
1711
+ Stage 119 增加只读 `verification --execution-evidence`,把本地 Stage 118 runbook JSON 与本地 execution evidence JSON 绑定。它输出每个 stage 的证据覆盖、必需证据类别覆盖、缺失证据、过期证据、失败命令证据、下一阶段 readiness 和恢复指引,但不运行任何 runbook 命令。每个选中的 stage 都会得到 `stage-evidence-category-gate`:`static_check`、`test`、`manual_verification` 默认必需;`review`、`tdd_trace`、`diff_coverage` 在 runbook 或 evidence 声明时作为一等类别绑定。
1712
+
1713
+ ```bash
1714
+ node tools/vibe-runtime/index.mjs verification --execution-evidence --from-runbook .tmp/stage118-runbook.json --from-file .tmp/stage119-evidence.json --json
1715
+ node tools/vibe-runtime/index.mjs verification --execution-evidence --from-runbook .tmp/stage118-runbook.json --from-file .tmp/stage119-evidence.json --stage stage118-runbook-01-stage-119
1716
+ ```
1717
+
1718
+ `verification --execution-evidence` 输出 `execution_evidence_binding`,包含 `stage='Stage 119'`、`binding_kind='execution-evidence-binding'`、`source_runbook`、`source_evidence`、`evidence_category_contract`、`stage_evidence_category_gate`、`stage_evidence_status`、`missing_evidence`、`missing_evidence_categories`、`stale_evidence`、`failed_commands`、`ready_for_next_stage`、`resume_guidance`、`execution_evidence_invariants` 和 `execution_evidence_digest`。即使普通 evidence 字符串匹配,缺少 `static_check`、`test` 或 `manual_verification` 也会阻塞 readiness;`review`、`tdd_trace`、`diff_coverage` 可通过 `category`、`source_digest`、`artifact` 或 coverage markers 绑定,不需要调用外部平台。
1719
+
1720
+ 边界固定:`execution_evidence_artifact=false`、`evidence_artifact_write=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`runbook_mutation=false`、`evidence_mutation=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`repair_execution=false`、`runtime_action=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1721
+
1722
+ Stage 119 不执行 runbook 命令、检查、测试、修复、格式化、代码生成、git、commit、push、PR、merge、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只读取本地 JSON 输入,并输出 Stage 120 staged commit readiness 所需的证据绑定期望。
1723
+
1724
+ ## Stage 120:Staged Commit Readiness Contract
1725
+
1726
+ Stage 120 增加只读 `release --staged-commit-readiness`,把本地 Stage 118 runbook JSON、本地 Stage 119 execution evidence binding JSON、显式 stage id 和 commit subject 绑定为分阶段提交前置合同。它判断 subject、建议 commit subject、required files、validation evidence、Stage 119 evidence/category gate pass 和 `diff_coverage` evidence binding,但不调用 git、不暂存文件、不提交。
1727
+
1728
+ ```bash
1729
+ node tools/vibe-runtime/index.mjs release --staged-commit-readiness --from-runbook .tmp/stage118-runbook.json --from-evidence .tmp/stage119-execution-evidence.json --stage stage118-runbook-01-stage-120 --subject "feat(runtime): 添加 Stage 120 分阶段提交就绪合同" --json
1730
+ node tools/vibe-runtime/index.mjs release --staged-commit-readiness --from-runbook .tmp/stage118-runbook.json --from-evidence .tmp/stage119-execution-evidence.json --stage stage118-runbook-01-stage-120 --subject "feat(runtime): 添加 Stage 120 分阶段提交就绪合同"
1731
+ ```
1732
+
1733
+ `release --staged-commit-readiness` 输出 `staged_commit_readiness`,包含 `stage='Stage 120'`、`readiness_kind='staged-commit-readiness-contract'`、`source_runbook`、`source_evidence`、`stage_id`、`suggested_commit_subject`、`subject_guard`、`commit_readiness_gate`、`stage_evidence_category_gate`、`required_files`、`validation_commands`、`evidence_pass`、`diff_coverage_required`、`diff_coverage_evidence_bound`、`commit_allowed_by_contract=false`、`manual_or_agent_commit_next_action`、`staged_commit_readiness_invariants` 和 `staged_commit_readiness_digest`。`commit_readiness_gate` 只有在 subject 匹配 Stage 118 runbook、Stage 119 pass-ready、选中 stage 有 required files 和 validation commands、Stage 119 category gate 通过、`diff_coverage` 证据已绑定且 runtime git 执行仍为 `false` 时才通过。
1734
+
1735
+ 边界固定:`staged_commit_readiness_artifact=false`、`commit_artifact=false`、`evidence_artifact_write=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`runbook_mutation=false`、`evidence_mutation=false`、`worktree_mutation=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`repair_execution=false`、`runtime_action=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1736
+
1737
+ Stage 120 不执行 runbook 命令、检查、测试、修复、格式化、代码生成、git status、git diff、git add、git commit、push、PR、merge、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只输出“是否可进入单独的人类确认本地提交动作”的可复验合同。
1738
+
1739
+ ## Stage 121:Behavioral Evaluation Contract
1740
+
1741
+ Stage 121 增加只读 `evals --behavior-contract`,把真实 session/transcript artifact 转成可机检的行为合规证明。Stage 51 仍负责内置 eval suite 和可选 sidecar;Stage 121 只消费用户提供的本地 transcript JSON,不写 `.vibecoding-state/`,不运行 eval harness,不调用模型或平台。
1742
+
1743
+ ```bash
1744
+ node tools/vibe-runtime/index.mjs evals --behavior-contract --from-file .tmp/stage121-transcript.json --json
1745
+ node tools/vibe-runtime/index.mjs evals --behavior-contract --from-file .tmp/stage121-transcript.json
1746
+ ```
1747
+
1748
+ 输入 transcript artifact 建议包含 `transcript[]`、`expected.workflow_order`、`expected.required_markers`、`expected.forbidden_markers`、`expected.blocked_reasons`、`observed.workflow_order`、`observed.markers`、`observed.commands`、`observed.validation_evidence` 和 `observed.claims`。Stage 121 会检查 workflow entry 是否记录、`injectsFullSkill=false` 是否保留、workflow 顺序是否稳定、required/forbidden markers 是否匹配、blocked reason 是否出现、completion claim 是否有验证证据、commit/PR/merge claim 是否绑定 Stage 120 readiness,以及 transcript 是否记录了 git/PR/push/merge/platform/model/subagent/worktree side effect。P49 release behavior gate 还固定保留自动提交、隐式 subagent、跳过 evidence、误读 `ok=false` 的负例 fixture。Stage 17 在该合同内补充 `negative_violation_matrix`,用稳定 blocker code 覆盖假 skill claim、缺 plan/todo、缺验证策略、完成无证据、bug 未复现即修、隐式 subagent、隐藏执行/后台执行、远程或 git 动作等违规样本;负例必须 `ok=false`,且 `stable_blocker_codes[]` 必须以 `behavior.*` 输出。机器 gate marker 固定为 `workflow_entry_invoked`、`lightweight_bootstrap`、`completion_claim_evidence`、`commit_claim_readiness`、`runtime_side_effect_boundary`、`negative_violation_gate_matrix` 和 `stable_blocker_codes`。
1749
+
1750
+ `evals --behavior-contract` 输出 `behavioral_evaluation_contract`,包含 `stage='Stage 121'`、`contract_kind='behavioral-evaluation-contract'`、`source_file`、`source_digest`、`behavior_gate`、`negative_violation_matrix`、`case_results`、`behavior_contract_invariants`、`boundary_assertions` 和 `behavior_contract_digest`。`behavior_gate.pass=false` 时只输出 blockers,不自动修 transcript 或 workflow 行为。
1751
+
1752
+ 边界固定:`behavior_contract_artifact=false`、`eval_sidecar_artifact=false`、`state_directory_created=false`、`command_execution=false`、`runtime_action=false`、`skill_execution=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`worktree=false`、`business_source_write=false`。
1753
+
1754
+ Stage 121 不执行 eval harness、命令、检查、测试、review、TDD、修复、格式化、代码生成、git、commit、push、PR、merge、平台 API、外部网络、模型、MCP、subagent 或源码写入。它用于证明“真实行为优于单纯 artifact parity”,但不替代 Stage 119/120 的证据和提交门禁。
1755
+
1756
+ P21/P23 补充链路把手动导出的本地平台 transcript JSON 纳入同一个 Stage 121 行为验收域:
1757
+
1758
+ ```bash
1759
+ node tools/vibe-runtime/index.mjs evals --transcript-intake --from-file <local-platform-transcript-json> --json
1760
+ ```
1761
+
1762
+ `evals --transcript-intake` 输出 `platform_transcript_intake`,包含 `stage='P21'`、`intake_kind='platform-transcript-intake'`、`source_binding`、`input_summary`、`normalized_transcript`、`boundary_assertions` 和 `intake_digest`。P23 replay 不新增 CLI surface,保持 owner-local pure model,输出 `replay_kind='platform-transcript-replay'`、`behavior_fixture`、`gap_matrix`、`replay_invariants` 和 `replay_digest`;release smoke 会把生成的本地 `behavior_fixture` 交给既有 `evals --behavior-contract`。
1763
+
1764
+ 该链路固定只读本地文件:`transcript_intake_artifact=false`、`normalized_transcript_artifact=false`、`transcript_replay_artifact=false`、`behavior_fixture_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`eval_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`business_source_write=false`。它不连接平台、不调用模型 judge、不创建真实 agent/subagent session、不执行 transcript 中记录的命令。
1765
+
1766
+ ## Stage 122:Adapter Bootstrap Conformance Matrix
1767
+
1768
+ Stage 122 增加只读 `platforms --bootstrap-matrix`,把 Claude / Cursor / Codex adapter manifest、安装说明和 hook/settings 示例统一验证为安装后入口体验矩阵。它对标 external reference 的 session-start 强启动纪律,但 Vibecoding 的边界是轻量入口、显式 workflow 判断和不注入完整 skill。
1769
+
1770
+ ```bash
1771
+ node tools/vibe-runtime/index.mjs platforms --bootstrap-matrix --json
1772
+ node tools/vibe-runtime/index.mjs platforms --bootstrap-matrix
1773
+ ```
1774
+
1775
+ `platforms --bootstrap-matrix` 输出 `adapter_bootstrap_matrix`,包含 `stage='Stage 122'`、`matrix_kind='adapter-bootstrap-conformance-matrix'`、`expected_adapters`、`adapter_rows`、`required_adapter_files`、`manifest_parity_gate`、`bootstrap_policy_gate`、`install_doc_bootstrap_gate`、`digest_inputs`、`adapter_bootstrap_invariants` 和 `matrix_digest`。每个 adapter row 绑定 `entry_file`、`runtime_bridge`、`bootstrap_policy`、`manifest_digest` 和 `install_digest`,避免 installed entry、manifest 和 docs 三处漂移。
1776
+
1777
+ 机器 gate marker 固定为 `required_adapter_files`、`manifest_parity_gate`、`bootstrap_policy_gate`、`install_doc_bootstrap_gate`、`adapter_bootstrap_invariants`、`injectsFullSkill=false`、`writesRuntimeState=false`、`autoRunsNextSkill=false`、`canAutoExecuteSkill=false`、`canCallSubagent=false`、`canTouchGit=false`。
1778
+
1779
+ 边界固定:`bootstrap_matrix_artifact=false`、`adapter_install=false`、`manifest_write=false`、`install_doc_write=false`、`settings_write=false`、`hook_write=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`hook_execution=false`、`runtime_action=false`、`workflow_execution=false`、`skill_execution=false`、`auto_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`git=false`、`git_write=false`、`worktree=false`、`business_source_write=false`。
1780
+
1781
+ Stage 122 不安装 adapter、不执行 hook、不运行 workflow skill、不执行命令、检查、测试、修复、格式化、代码生成、git、commit、push、PR、merge、平台 API、外部网络、模型、MCP、subagent 或源码写入。它只读取本地 adapter 证据,用于阻止安装入口体验退化。
1782
+
1783
+ ## Stage 123:Skill-to-Runtime Traceability Map
1784
+
1785
+ Stage 123 增加只读 `governance --traceability-map`,把 workflow skill、handoff marker、runtime capability registry 和具体命令能力绑定成一个可审计映射。它对标 external reference 对 skill 行为纪律的强调,但 Vibecoding 的边界是集中治理映射,而不是把 runtime 细节扩散到每个 skill 文案中。
1786
+
1787
+ ```bash
1788
+ node tools/vibe-runtime/index.mjs governance --traceability-map --json
1789
+ node tools/vibe-runtime/index.mjs governance --traceability-map
1790
+ ```
1791
+
1792
+ `governance --traceability-map` 输出 `skill_runtime_traceability_map`,包含 `stage='Stage 123'`、`map_kind='skill-to-runtime-traceability-map'`、`expected_skills`、`skill_rows`、`traceability_rows`、`skill_row_coverage`、`frontmatter_name_gate`、`workflow_handoff_gate`、`runtime_registry_group_gate`、`runtime_registry_command_gate`、`digest_inputs`、`skill_runtime_traceability_invariants` 和 `traceability_digest`。每个 skill row 绑定 `skill_file`、`frontmatter_name`、`handoff_markers` 和 `skill_digest`;每个 traceability row 绑定 `runtime_group`、`runtime_commands` 和 contract,避免 workflow skill 与 runtime 控制面漂移。
1793
+
1794
+ 机器 gate marker 固定为 `skill_row_coverage`、`frontmatter_name_gate`、`workflow_handoff_gate`、`runtime_registry_group_gate`、`runtime_registry_command_gate`、`skill_runtime_traceability_invariants`、`traceability_digest`。
1795
+
1796
+ 边界固定:`traceability_map_artifact=false`、`skill_write=false`、`runtime_registry_write=false`、`docs_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`runtime_action=false`、`workflow_execution=false`、`skill_execution=false`、`auto_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`git=false`、`git_write=false`、`worktree=false`、`business_source_write=false`。
1797
+
1798
+ Stage 123 不修改 skill、不修改 registry、不生成 sidecar、不执行 workflow skill、不执行检查或测试、不运行命令、不调用平台 API、外部网络、模型、MCP、subagent 或 git。它只读取本地 skill 文件和 runtime registry,用于阻止 skill/runtime 漂移。
1799
+
1800
+ ## Stage 124:Human Completion Evidence Bundle
1801
+
1802
+ Stage 124 强化只读 `completion --evidence-bundle`,把 Stage 88 completion readiness、Stage 99 completion evidence bundle 和当前 runtime registry 绑定成一屏式人工交付证据。它对标 external reference 的“完成前必须有证据”纪律,但 Vibecoding 的输出是可审计的交付摘要,而不是依赖口头声明。
1803
+
1804
+ ```bash
1805
+ node tools/vibe-runtime/index.mjs completion --evidence-bundle --from-file <local-completion-evidence-file> --json
1806
+ node tools/vibe-runtime/index.mjs completion --evidence-bundle --from-file <local-completion-evidence-file>
1807
+ ```
1808
+
1809
+ `completion --evidence-bundle` 保留 `completion_evidence_bundle.stage='Stage 99'` 和 `bundle_digest`,并新增 `human_completion_evidence_bundle`,包含 `stage='Stage 124'`、`bundle_kind='human-completion-evidence-bundle'`、`source_bindings`、`one_screen_sections`、`evidence_receipt`、`delivery_gate`、`copy_ready_summary`、`manual_next_action`、`human_completion_evidence_invariants` 和 `human_completion_evidence_digest`。`one_screen_sections` 固定为 Result、Verification、Review、Release boundary、Next action,确保交付前能一眼看到结果、证据、阻塞和禁止动作。
1810
+
1811
+ 机器 gate marker 固定为 `human_completion_evidence_bundle`、`one_screen_sections`、`evidence_receipt`、`delivery_gate`、`copy_ready_summary`、`manual_next_action`、`human_completion_evidence_invariants`、`human_completion_evidence_digest`。
1812
+
1813
+ 边界固定:`completion_evidence_bundle_artifact=false`、`human_completion_evidence_bundle_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`runtime_action=false`、`git=false`、`git_write=false`、`pr=false`、`push=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`worktree=false`、`business_source_write=false`。
1814
+
1815
+ Stage 124 不运行验证、不生成证据、不写 sidecar、不执行 workflow skill、不执行 git/commit/push/PR/merge、不调用平台 API、外部网络、模型、MCP 或 subagent。它只读取本地 completion evidence 文件并整理人工可读交付摘要,用于阻止无证据完成声明。
1816
+
1817
+ ## Stage 125:external reference Regression Guard
1818
+
1819
+ Stage 125 新增只读 `governance --external-reference-regression-guard`,把 Stage 115-124 的对标超越工作收敛成防退化 guard。它不是再做一份口头评分,而是验证这些能力仍在 registry、automation readiness、Stage 115 gap baseline 和 Stage 123 traceability 中同时存在且边界未扩权。
1820
+
1821
+ ```bash
1822
+ node tools/vibe-runtime/index.mjs governance --external-reference-regression-guard --from-external-reference <local-external reference-dir> --json
1823
+ node tools/vibe-runtime/index.mjs governance --external-reference-regression-guard --from-external-reference <local-external reference-dir>
1824
+ ```
1825
+
1826
+ `governance --external-reference-regression-guard` 输出 `external_reference_regression_guard`,包含 `stage='Stage 125'`、`guard_kind='external-reference-regression-guard'`、`source_bindings`、`protected_stage_sequence`、`protected_capabilities`、`dimension_scorecard`、`regression_gates`、`superiority_claim`、`manual_next_action`、`regression_guard_invariants` 和 `regression_guard_digest`。`protected_stage_sequence` 覆盖 Stage 115-124,确保 gap matrix、entry UX、plan quality、stage runbook、execution evidence、staged commit readiness、behavior eval、bootstrap matrix、traceability map 和 human completion bundle 不会从控制面退化。
1827
+
1828
+ 机器 gate marker 固定为 `external_reference_regression_guard`、`protected_stage_sequence`、`protected_capabilities`、`dimension_scorecard`、`regression_gates`、`superiority_claim`、`regression_guard_invariants`、`regression_guard_digest`。
1829
+
1830
+ 边界固定:`external_reference_regression_guard_artifact=false`、`external_reference_gap_artifact=false`、`traceability_map_artifact=false`、`automation_readiness_artifact=false`、`capability_registry_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`runtime_action=false`、`workflow_execution=false`、`skill_execution=false`、`auto_execution=false`、`git=false`、`git_write=false`、`pr=false`、`push=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`worktree=false`、`business_source_write=false`。
1831
+
1832
+ Stage 125 不执行 skill、不运行检查或测试、不写 sidecar、不修改 registry、不执行 git/commit/push/PR/merge、不调用平台 API、外部网络、模型、MCP 或 subagent。它只读取本地 external reference 对比源和 Vibecoding runtime 控制面,用于阻止对标能力退化。
1833
+
1834
+ ## Stage 126:Experience Friction Matrix
1835
+
1836
+ Stage 126 新增只读 `governance --experience-friction`,把一次本地 session evidence 中的日常使用摩擦转成可复验矩阵。它承接 Stage 115-125 的对标和回归证明,但目标从“证明不退化”转向“发现用户每天哪里多想一步”。
1837
+
1838
+ ```bash
1839
+ node tools/vibe-runtime/index.mjs governance --experience-friction --from-file <local-session-evidence-json> --json
1840
+ node tools/vibe-runtime/index.mjs governance --experience-friction --from-file <local-session-evidence-json>
1841
+ ```
1842
+
1843
+ `governance --experience-friction` 输出 `experience_friction_matrix`,包含 `stage='Stage 126'`、`matrix_kind='experience-friction-matrix'`、`source_bindings`、`session_summary`、`dimensions`、`friction_score`、`friction_level`、`priority_fixes`、`recommended_stage_sequence`、`manual_next_action`、`experience_friction_invariants` 和 `friction_digest`。
1844
+
1845
+ 机器 gate marker 固定为 `entry_confusion`、`next_action_unclear`、`command_discovery_cost`、`evidence_gap`、`completion_claim_risk`、`token_overhead`、`adapter_bootstrap_gap`、`legacy_workflow_discipline_gap`、`priority_fixes`、`recommended_stage_sequence` 和 `friction_digest`。
1846
+
1847
+ 边界固定:`experience_friction_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`runtime_action=false`、`workflow_execution=false`、`skill_execution=false`、`auto_execution=false`、`repair_execution=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`worktree=false`、`business_source_write=false`。
1848
+
1849
+ Stage 126 不运行命令、不生成 evidence、不写 `.vibecoding-state/`、不修改 workflow skill、不执行 git/commit/push/PR/merge、不调用平台 API、外部网络、模型、MCP 或 subagent。它只读取一个 root 内本地 JSON evidence 文件,用于驱动 Stage 127-132 的体验改造优先级。
1850
+
1851
+ ## Stage 127:One-screen Next Action Console
1852
+
1853
+ Stage 127 新增只读 `workflow --next-action-console`,把 Stage 126 friction matrix 和可选 Stage 118 runbook / Stage 119 evidence 压成一屏控制台。它解决“合同很多,但用户仍要自己判断下一步”的体验摩擦。
1854
+
1855
+ ```bash
1856
+ node tools/vibe-runtime/index.mjs workflow --next-action-console --from-friction <local-friction-json> --json
1857
+ node tools/vibe-runtime/index.mjs workflow --next-action-console --from-friction <local-friction-json> --from-runbook <local-runbook-json> --from-evidence <local-evidence-json>
1858
+ ```
1859
+
1860
+ `workflow --next-action-console` 输出 `next_action_console`,包含 `stage='Stage 127'`、`console_kind='one-screen-next-action-console'`、`source_bindings`、`current_position`、`recommended_next_action`、`why_now`、`copy_ready_command_preview`、`evidence_needed_next`、`do_not_do_yet`、`next_action_console_invariants` 和 `console_digest`。
1861
+
1862
+ 机器 gate marker 固定为 `current_position`、`recommended_next_action`、`why_now`、`copy_ready_command_preview`、`evidence_needed_next`、`do_not_do_yet`、`preview_only=true` 和 `console_digest`。
1863
+
1864
+ 边界固定:`next_action_console_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`runtime_action=false`、`workflow_execution=false`、`skill_execution=false`、`auto_execution=false`、`repair_execution=false`、`evidence_write=false`、`runbook_write=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`worktree=false`、`business_source_write=false`。
1865
+
1866
+ Stage 127 不执行 preview 命令、不运行 smoke/check/test、不写 evidence、不写 `.vibecoding-state/`、不修改 workflow skill、不执行 git/commit/push/PR/merge、不调用平台 API、外部网络、模型、MCP 或 subagent。它只把“人下一步应该做什么、为什么、还缺什么证据、现在不要做什么”变成可复验的本地合同。
1867
+
1868
+ ## Stage 128:Token Savior Entry Budget Contract
1869
+
1870
+ Stage 128 新增只读 `tokens --savior-budget`,把 Token Savior 的少加载、按需发现策略收束成入口预算合同。它根据显式 prompt 和可选 Stage 126 friction matrix,确定 `tiny_entry`、`balanced_runtime` 或 `full_maintenance`,并输出应该立即展示的 skill、应该延后加载的 skill、preview-only 命令和上下文 token 预算。
1871
+
1872
+ ```bash
1873
+ node tools/vibe-runtime/index.mjs tokens --savior-budget --prompt <text> --json
1874
+ node tools/vibe-runtime/index.mjs tokens --savior-budget --prompt <text> --from-friction <local-friction-json>
1875
+ ```
1876
+
1877
+ `tokens --savior-budget` 输出 `token_savior_budget`,包含 `stage='Stage 128'`、`budget_kind='token-savior-entry-budget-contract'`、`source_bindings`、`prompt_summary`、`friction_summary`、`recommended_profile`、`skills_to_surface`、`skills_to_defer`、`commands_to_surface`、`context_budget`、`token_saving_reasoning`、`budget_application_order`、`token_savior_budget_invariants` 和 `budget_digest`。
1878
+
1879
+ 机器 gate marker 固定为 `recommended_profile`、`tiny_entry`、`balanced_runtime`、`full_maintenance`、`skills_to_surface`、`skills_to_defer`、`commands_to_surface`、`context_budget`、`token_saving_reasoning`、`preview_only=true` 和 `budget_digest`。
1880
+
1881
+ 边界固定:`token_savior_budget_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`verification_execution=false`、`runtime_action=false`、`workflow_execution=false`、`skill_execution=false`、`auto_execution=false`、`repair_execution=false`、`command_mutation=false`、`shell_interception=false`、`output_mutation=false`、`dynamic_tool_execution=false`、`embeddings=false`、`remote_config=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
1882
+
1883
+ Stage 128 不重写 prompt、不截获 shell、不执行 preview 命令、不运行 smoke/check/test、不写 `.vibecoding-state/`、不修改 workflow skill、不执行 git/commit/push/PR/merge、不调用 embeddings、远程配置、平台 API、外部网络、模型、MCP 或 subagent。它只把“入口应该加载多少上下文”变成可复验的 deterministic 建议。
1884
+
1885
+ ## Stage 129:ECC Learning Experience Pattern Gate
1886
+
1887
+ Stage 129 新增只读 `learning --experience-pattern`,吸收 ECC learning model 的重复信号抽取能力,但拒绝 ECC 的 agent-first 越权模式。它把 Stage 126 friction matrix 和可选 Stage 61 learning observation sidecar 转成 candidate experience patterns,用于判断是否值得进入人工 skill authoring,而不是自动写 skill 或 prompt。
1888
+
1889
+ ```bash
1890
+ node tools/vibe-runtime/index.mjs learning --experience-pattern --from-friction <local-friction-json> --json
1891
+ node tools/vibe-runtime/index.mjs learning --experience-pattern --from-friction <local-friction-json> --from-observations <learning-observation-file...>
1892
+ ```
1893
+
1894
+ `learning --experience-pattern` 输出 `experience_learning_pattern`,包含 `stage='Stage 129'`、`pattern_kind='ecc-learning-experience-pattern-gate'`、`source_bindings`、`friction_summary`、`observation_summary`、`candidate_experience_patterns`、`repeat_signal`、`suggested_instinct_trigger`、`suggested_instinct_action`、`promotion_required=true`、`required_workflow=['vibe-writing-skills','vibe-writing-plans','vibe-test-driven-development']`、`promotion_boundary`、`ecc_learning_boundary`、`experience_pattern_invariants` 和 `experience_pattern_digest`。
1895
+
1896
+ 机器 gate marker 固定为 `candidate_experience_patterns`、`repeat_signal`、`suggested_instinct_trigger`、`suggested_instinct_action`、`promotion_required=true`、`required_workflow`、`automatic_promotion=false`、`writes_formal_skills=false`、`agent_first_delegation=false` 和 `experience_pattern_digest`。
1897
+
1898
+ 边界固定:`experience_pattern_artifact=false`、`learning_observation_write=false`、`candidate_instinct_write=false`、`learning_promotion_write=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`skill_write=false`、`writes_formal_skills=false`、`writes_agents_md=false`、`writes_claude_md=false`、`prompt_mutation=false`、`hook_registration=false`、`shell_interception=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`automatic_promotion=false`、`agent_first_delegation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`worktree=false`、`business_source_write=false`。
1899
+
1900
+ Stage 129 不写 observation、不写 candidate instinct、不写 promotion sidecar、不修改 `skills/`、`AGENTS.md`、`CLAUDE.md`、hook 或 prompt,不调用 subagent/MCP/模型/平台/API,不执行命令或 git。它只生成候选模式;真正 promotion 仍必须由用户显式进入 `vibe-writing-skills`、`vibe-writing-plans` 和 `vibe-test-driven-development`。
1901
+
1902
+ ## Stage 130:Copy-ready Stage Execution Scriptlet
1903
+
1904
+ Stage 130 新增只读 `automation --stage-scriptlet`,把 Stage 118 sequential runbook 和可选 Stage 127 next-action console 转成可复制的最小执行脚本预览。它只负责减少命令发现和拼接成本,不把 runtime 变成执行器。
1905
+
1906
+ ```bash
1907
+ node tools/vibe-runtime/index.mjs automation --stage-scriptlet --from-runbook <local-runbook-json> --json
1908
+ node tools/vibe-runtime/index.mjs automation --stage-scriptlet --from-runbook <local-runbook-json> --from-console <local-console-json> --stage <stage-id>
1909
+ ```
1910
+
1911
+ `automation --stage-scriptlet` 输出 `stage_scriptlet`,包含 `stage='Stage 130'`、`scriptlet_kind='copy-ready-stage-execution-scriptlet'`、`source_bindings`、`target_stage`、`selected_stage_count`、`runbook_summary`、`console_summary`、`scriptlet_steps`、`powershell_commands`、`expected_markers`、`evidence_capture_template`、`stop_if`、`copy_boundary`、`stage_scriptlet_invariants` 和 `scriptlet_digest`。
1912
+
1913
+ 机器 gate marker 固定为 `scriptlet_steps`、`powershell_commands`、`expected_markers`、`evidence_capture_template`、`stop_if`、`copy_boundary.preview_only=true`、`execution_authorized=false`、`commands_executed=false`、`evidence_written=false`、`git_write_authorized=false` 和 `scriptlet_digest`。
1914
+
1915
+ 边界固定:`stage_scriptlet_artifact=false`、`scriptlet_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`evidence_write=false`、`runbook_write=false`、`console_write=false`、`source_write=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`validation_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`repair_execution=false`、`formatting_execution=false`、`auto_execution=false`、`scheduler=false`、`daemon=false`、`retry=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`tag=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`worktree=false`、`business_source_write=false`。
1916
+
1917
+ Stage 130 不运行 scriptlet、不运行 smoke/check/test、不写 evidence、不写 sidecar、不修改源码、不执行 git add/commit/push/PR/merge、不调用平台 API、外部网络、模型、MCP 或 subagent。它只输出给人复制的命令预览、期望输出标记和证据填写模板;后续证据绑定仍走 Stage 119。
1918
+
1919
+ ## Stage 131:Adapter Entry Acceptance Contract
1920
+
1921
+ Stage 131 新增只读 `platforms --entry-acceptance`,读取本地 adapter transcript JSON,验证安装后的入口体验是否满足 `using-vibecoding` 轻量分流合同。它把 Stage 122 的“adapter 文件一致”推进到“用户实际看到的入口 transcript 一致”。
1922
+
1923
+ ```bash
1924
+ node tools/vibe-runtime/index.mjs platforms --entry-acceptance --from-file <local-adapter-transcript-json> --json
1925
+ node tools/vibe-runtime/index.mjs platforms --entry-acceptance --from-file <local-adapter-transcript-json> --adapter <claude|cursor|codex>
1926
+ ```
1927
+
1928
+ `platforms --entry-acceptance` 输出 `adapter_entry_acceptance`,包含 `stage='Stage 131'`、`acceptance_kind='adapter-entry-acceptance-contract'`、`adapter`、`source_bindings`、`transcript_summary`、`gate_results`、`acceptance_score`、`accepted`、`workflow_explanation`、`next_expected_user_visible_step`、`blockers`、`adapter_entry_acceptance_invariants` 和 `acceptance_digest`。
1929
+
1930
+ 机器 gate marker 固定为 `using_vibecoding_first`、`lightweight_routing`、`visible_next_step`、`no_auto_execution`、`workflow_explained`、`acceptance_score` 和 `acceptance_digest`。
1931
+
1932
+ 边界固定:`entry_acceptance_artifact=false`、`transcript_write=false`、`adapter_install=false`、`adapter_execution=false`、`hook_execution=false`、`prompt_mutation=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`tag=false`、`worktree=false`、`business_source_write=false`。
1933
+
1934
+ Stage 131 不运行 adapter、不执行 hook、不改安装配置、不写 transcript/sidecar/state,不进入 workflow skill,不调用 subagent/MCP/模型/平台/API,不执行 git。它只判定本地 transcript 是否呈现正确入口体验:优先 `using-vibecoding`、轻量分流、有可见下一步、能解释应进入或暂缓的 workflow。
1935
+
1936
+ ## Stage 132:Experience Regression Dashboard
1937
+
1938
+ Stage 132 新增只读 `governance --experience-dashboard`,把 Stage 126-129 的本地体验合同汇总为体验回归仪表盘。它回答一个收口问题:这轮改造是否真的降低了日常使用摩擦,而不是只增加更多合同。
1939
+
1940
+ ```bash
1941
+ node tools/vibe-runtime/index.mjs governance --experience-dashboard --from-friction <local-friction-json> --json
1942
+ node tools/vibe-runtime/index.mjs governance --experience-dashboard --from-friction <local-friction-json> --from-console <local-console-json> --from-token-budget <local-token-budget-json> --from-learning-pattern <local-learning-pattern-json>
1943
+ ```
1944
+
1945
+ `governance --experience-dashboard` 输出 `experience_regression_dashboard`,包含 `stage='Stage 132'`、`dashboard_kind='experience-regression-dashboard'`、`source_bindings`、`experience_scorecard`、`external_reference_comparison_delta`、`token_savior_delta`、`learning_loop_delta`、`daily_user_friction_delta`、`regression_blockers`、`next_bet`、`dashboard_sections`、`experience_dashboard_invariants` 和 `dashboard_digest`。
1946
+
1947
+ 机器 gate marker 固定为 `experience_scorecard`、`external_reference_comparison_delta`、`token_savior_delta`、`learning_loop_delta`、`daily_user_friction_delta`、`regression_blockers`、`next_bet` 和 `dashboard_digest`。
1948
+
1949
+ 边界固定:`experience_dashboard_artifact=false`、`regression_dashboard_artifact=false`、`sidecar_write=false`、`state_directory_created=false`、`source_write=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`verification_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`evidence_write=false`、`dashboard_write=false`、`dynamic_tool_execution=false`、`embeddings=false`、`remote_config=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`tag=false`、`worktree=false`、`business_source_write=false`。
1950
+
1951
+ Stage 132 不运行 smoke/check/test,不写 dashboard artifact,不写 evidence/sidecar/state,不调用 workflow skill、subagent/MCP/模型/平台/API,不执行 git。它只读 root 内本地 JSON 合同,并输出围绕 external reference 对标、Token Savior 入口预算、ECC learning 候选模式和日常下一步摩擦的确定性回归基线。
1952
+
1953
+ ## Stage 133:external reference Comparative Evidence Matrix
1954
+
1955
+ Stage 133 新增只读 `governance --external-reference-comparison`,把当前阶段与 `fork/<external-reference>` 的横向比较升级为全方位、可复验的证据矩阵。它不再只回答“有没有差距”,而是同时输出 parity gaps、Vibecoding advantages、borrowable patterns、do_not_copy 边界和 next comparison bet,用于规划 Stage 134-140 的体验提升。
1956
+
1957
+ ```bash
1958
+ node tools/vibe-runtime/index.mjs governance --external-reference-comparison --from-external-reference-root <local-external reference-root> --json
1959
+ node tools/vibe-runtime/index.mjs governance --external-reference-comparison --from-external-reference-root <local-external reference-root>
1960
+ ```
1961
+
1962
+ `governance --external-reference-comparison` 输出 `external_reference_comparison_matrix`,包含 `stage='Stage 133'`、`comparison_kind='external reference-comparative-evidence-matrix'`、`comparison_target='fork/<external-reference>'`、`source_bindings`、`registry_binding`、`dimensions`、`parity_gaps`、`vibecoding_advantages`、`borrowable_patterns`、`do_not_copy`、`recommended_stage_sequence`、`next_comparison_bet`、`external_reference_comparison_invariants` 和 `comparison_digest`。
1963
+
1964
+ 比较维度固定为 `session_start_bootstrap`、`skill_trigger_discipline`、`methodology_coverage`、`hook_shape_coverage`、`adapter_packaging`、`eval_and_test_harness`、`subagent_boundary`、`contributor_guardrails`、`token_and_context_economy` 和 `daily_user_friction`。
1965
+
1966
+ 机器 gate marker 固定为 `external_reference_comparison_matrix`、`external reference-comparative-evidence-matrix`、`parity_gaps`、`vibecoding_advantages`、`borrowable_patterns`、`do_not_copy`、`recommended_stage_sequence`、`next_comparison_bet`、`external_reference_comparison_invariants` 和 `comparison_digest`。
1967
+
1968
+ 边界固定:`external_reference_comparison_artifact=false`、`comparison_matrix_artifact=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`verification_execution=false`、`hook_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`repair_execution=false`、`prompt_mutation=false`、`hook_registration=false`、`dynamic_tool_execution=false`、`embeddings=false`、`remote_config=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`daemon=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`tag=false`、`worktree=false`、`business_source_write=false`。
1969
+
1970
+ Stage 133 不执行 `fork/<external-reference>` hook/test,不运行 smoke/check/test,不写 comparison artifact,不写 sidecar/state,不修改源码,不调用 workflow skill、subagent/MCP/模型/平台/API,不执行 git。它只读 root 内本地 external reference 与 Vibecoding 源码,并把比较结果转成后续 stage 的确定性规划证据。
1971
+
1972
+ ## Stage 134:Session-start Output Shape Acceptance
1973
+
1974
+ Stage 134 新增只读 `platforms --session-start-shape`,吸收 external reference 对 session-start hook 输出形状的验收方式,但保持 Vibecoding 的轻量 bootstrap。它读取本地捕获输出,不执行 hook,也不调用 adapter。
1975
+
1976
+ ```bash
1977
+ node tools/vibe-runtime/index.mjs platforms --session-start-shape --from-file <local-captured-session-start-output> --adapter <claude|cursor|codex|cursor-sdk> --json
1978
+ node tools/vibe-runtime/index.mjs platforms --session-start-shape --from-file <local-captured-session-start-output> --adapter <claude|cursor|codex|cursor-sdk>
1979
+ ```
1980
+
1981
+ `platforms --session-start-shape` 输出 `session_start_shape_acceptance`,包含 `stage='Stage 134'`、`acceptance_kind='session-start-shape-acceptance'`、`adapter`、`source_bindings`、`output_summary`、`shape_results`、`context_markers`、`accepted`、`blockers`、`session_start_shape_invariants` 和 `shape_digest`。
1982
+
1983
+ 验收固定覆盖 `adapter_output_shape`、`context_present`、`using_vibecoding_marker`、`lightweight_routing_marker`、`semantic_field_markers`、`context_policy_marker`、`boundary_declaration_marker`、`no_full_skill_injection`、`no_execution_claims` 和 `no_forbidden_trigger`。`semantic_field_markers` 要求 session-start 上下文显式暴露 `selected_skill`、`visible_route` 与 `next_manual_action`;`context_policy_marker` 要求暴露 `tiny_context` / `balanced_context` 或等价策略;`no_execution_claims` 要求 `hidden_execution=false`、`command_execution=false`、`skill_execution_claimed=false`、`subagent_dispatch_claimed=false`、`git_write_claimed=false`、`platform_api=false`、`model_invocation=false` 和 `business_source_write=false`。Claude 形状为 `hookSpecificOutput.additionalContext`,Cursor 形状为 `additional_context`,Codex/Cursor SDK 形状为 `additionalContext` 或明确嵌套的 SessionStart `hookSpecificOutput.additionalContext`。
1984
+
1985
+ 边界固定:`session_start_shape_artifact=false`、`captured_output_write=false`、`adapter_install=false`、`adapter_execution=false`、`hook_execution=false`、`hook_registration=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`worktree=false`、`business_source_write=false`。
1986
+
1987
+ Stage 134 不执行 hook、不运行 external reference test、不运行 adapter、不写 captured output/state/sidecar,不调用 workflow skill、subagent/MCP/模型/平台/API,不执行 git。它只把本地已捕获输出转成可复验的 shape acceptance 合同。
1988
+
1989
+ ## Stage 135:Entry Trigger Discipline Contract
1990
+
1991
+ Stage 135 新增只读 `workflow --entry-discipline`,把 external reference 的“入口 skill 触发纪律”转译为 Vibecoding 的分层入口合同。它读取一个本地 transcript JSON,判断会话是否先经过 `using-vibecoding` 轻量分流,并且没有在需求模糊、bug、review、提交或上下文压缩场景中直接跳过应有 workflow。
1992
+
1993
+ ```bash
1994
+ node tools/vibe-runtime/index.mjs workflow --entry-discipline --from-transcript <local-transcript-json> --json
1995
+ node tools/vibe-runtime/index.mjs workflow --entry-discipline --from-transcript <local-transcript-json> --intent <kind>
1996
+ ```
1997
+
1998
+ `workflow --entry-discipline` 输出 `entry_trigger_discipline`,包含 `stage='Stage 135'`、`discipline_kind='entry-trigger-discipline-contract'`、`source_bindings`、`transcript_summary`、`protocol_layers`、`expected_route`、`trigger_results`、`missed_workflow_risks`、`minimum_next_action`、`entry_discipline_invariants` 和 `discipline_digest`。
1999
+
2000
+ 验收固定覆盖 `using_vibecoding_first`、`protocol_layers_declared`、`intent_route_match`、`no_direct_implementation_jump`、`no_blind_bug_fix`、`no_false_skill_claim` 和 `no_forbidden_trigger`。它只验证入口纪律是否可见,不代表已执行任何 workflow skill。
2001
+
2002
+ 边界固定:`entry_discipline_artifact=false`、`transcript_write=false`、`prompt_mutation=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`business_source_write=false`。
2003
+
2004
+ Stage 135 不执行 workflow skill、不运行命令/check/test、不写 transcript/state/sidecar,不修改 prompt 或源码,不调用 subagent/MCP/模型/平台/API,不执行 git/commit/push/PR/merge。它只把“是否先做正确入口判断”变成本地、确定性、可复验的 discipline report。
2005
+
2006
+ ## Stage 136:Methodology Coverage Map
2007
+
2008
+ Stage 136 新增只读 `methodology --coverage-map`,把 `fork/<external-reference>` 的核心方法论覆盖面映射到 Vibecoding skills/runtime。它不是按文件名机械补齐,而是只标记对体验或质量有价值的缺口。
2009
+
2010
+ ```bash
2011
+ node tools/vibe-runtime/index.mjs methodology --coverage-map --from-external-reference-root <local-external reference-root> --json
2012
+ node tools/vibe-runtime/index.mjs methodology --coverage-map --from-external-reference-root <local-external reference-root>
2013
+ ```
2014
+
2015
+ `methodology --coverage-map` 输出 `methodology_coverage_map`,包含 `stage='Stage 136'`、`coverage_kind='methodology-coverage-map'`、`source_bindings`、`registry_binding`、`covered_patterns`、`partial_patterns`、`missing_patterns`、`vibecoding_specific_patterns`、`coverage_summary`、`next_coverage_bet`、`methodology_coverage_invariants` 和 `coverage_digest`。
2016
+
2017
+ 验收固定覆盖 `brainstorming`、`planning`、`writing_plans`、`tdd`、`debugging`、`review`、`completion`、`worktree_isolation`、`subagent_driven_development`、`writing_skills` 和 `contributor_pr_guardrails`。额外标记 Vibecoding 专属模式:`local_runtime_contracts`、`token_savior_budget` 和 `experience_dashboard`。
2018
+
2019
+ 边界固定:`methodology_coverage_artifact=false`、`coverage_map_artifact=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`verification_execution=false`、`hook_execution=false`、`adapter_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`repair_execution=false`、`prompt_mutation=false`、`skill_mutation=false`、`hook_registration=false`、`dynamic_tool_execution=false`、`embeddings=false`、`remote_config=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2020
+
2021
+ Stage 136 不执行 external reference hook/test,不执行 Vibecoding workflow skill,不运行命令/check/test,不写 state/sidecar/source,不调用 subagent/MCP/模型/平台/API,不执行 git/commit/push/PR/merge。它只把方法论覆盖变成本地、确定性、可复验的 coverage report。
2022
+
2023
+ ## Stage 137:Hook and Adapter Install Experience Score
2024
+
2025
+ Stage 137 新增只读 `platforms --install-experience`,把安装后是否“自然进入”变成分数,减少用户记命令和读 README 的成本。它只消费本地 Stage 122 bootstrap matrix JSON 和本地 Stage 131 entry acceptance JSON,不安装 adapter、不执行 hook、不调用平台。
2026
+
2027
+ ```bash
2028
+ node tools/vibe-runtime/index.mjs platforms --install-experience --from-bootstrap-matrix <local-bootstrap-matrix-json> --from-entry-acceptance <local-entry-acceptance-json> --json
2029
+ node tools/vibe-runtime/index.mjs platforms --install-experience --from-bootstrap-matrix <local-bootstrap-matrix-json> --from-entry-acceptance <local-entry-acceptance-json>
2030
+ ```
2031
+
2032
+ `platforms --install-experience` 输出 `install_experience_score`,包含 `stage='Stage 137'`、`score_kind='hook-adapter-install-experience-score'`、`source_bindings`、`input_summary`、`install_experience_score`、`natural_entry_score`、`adapter_consistency_score`、`adapter_scores`、`manual_steps_remaining`、`docs_friction`、`next_install_experience_bet`、`install_experience_invariants` 和 `install_experience_digest`。
2033
+
2034
+ 验收固定覆盖 `natural_entry_score`、`adapter_consistency_score`、`manual_steps_remaining`、`docs_friction`、`bootstrap_pass`、`entry_acceptance_ok`、`install_experience_digest` 和 `next_install_experience_bet`。
2035
+
2036
+ 边界固定:`install_experience_artifact=false`、`bootstrap_matrix_artifact=false`、`entry_acceptance_artifact=false`、`adapter_install=false`、`adapter_execution=false`、`hook_execution=false`、`hook_registration=false`、`manifest_write=false`、`install_doc_write=false`、`settings_write=false`、`source_write=false`、`transcript_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2037
+
2038
+ Stage 137 不安装 adapter、不执行 hook、不运行 adapter、不执行 workflow skill、不运行命令/check/test、不写 state/sidecar/source,不调用 subagent/MCP/模型/平台/API,不执行 git/commit/push/PR/merge。它只把安装体验变成本地、确定性、可复验的 score report。
2039
+
2040
+ ## Stage 138:external-reference-style Behavioral Eval Scenario Pack
2041
+
2042
+ Stage 138 新增只读 `evals --external-reference-style-pack`,把 Stage 133 external reference 横向比较转换成贴近真实会话的行为场景合同。它只读取一个本地 comparison JSON,不运行 live agent eval、不调用模型 judge、不写 eval 产物。
2043
+
2044
+ ```bash
2045
+ node tools/vibe-runtime/index.mjs evals --external-reference-style-pack --from-comparison <local-comparison-json> --json
2046
+ node tools/vibe-runtime/index.mjs evals --external-reference-style-pack --from-comparison <local-comparison-json>
2047
+ ```
2048
+
2049
+ `evals --external-reference-style-pack` 输出 `external_reference_style_eval_pack`,包含 `stage='Stage 138'`、`pack_kind='external-reference-style-behavioral-eval-scenario-pack'`、`source_bindings`、`comparison_binding`、`scenario_pack`、`scenario_summary`、`scenario_ids`、`next_eval_pack_bet`、`eval_pack_invariants` 和 `eval_pack_digest`。
2050
+
2051
+ 固定 scenario:`new_feature_should_not_jump_to_code`、`bug_should_reproduce_first`、`review_should_prioritize_blockers`、`commit_should_require_validation`、`subagent_requires_explicit_permission`、`session_start_should_show_lightweight_entry`。
2052
+
2053
+ 验收固定覆盖 `expected_behavior`、`failure_signals`、`comparison_dimension_present`、`execution_authorized=false`、`model_judge_required=false`、`deterministic_contract_only=true`、`recommended_runtime_contract='evals --behavior-contract'`、`scenario_summary`、`next_eval_pack_bet` 和 `eval_pack_digest`。
2054
+
2055
+ 边界固定:`eval_pack_artifact=false`、`scenario_artifact=false`、`comparison_artifact=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`eval_execution=false`、`agent_session_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`prompt_mutation=false`、`hook_registration=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2056
+
2057
+ Stage 138 不运行 eval、不创建 agent session、不调用模型 judge、不执行 workflow skill、不运行命令/check/test、不写 state/sidecar/source,不调用 subagent/MCP/模型/平台/API,不执行 git/commit/push/PR/merge。它只把行为验收场景变成本地、确定性、可复验的 scenario contract report。
2058
+
2059
+ ## Stage 139:Experience Upgrade Prioritizer
2060
+
2061
+ Stage 139 新增只读 `governance --experience-upgrades`,把 Stage 133 比较矩阵、Stage 132 体验 dashboard 和可选 Stage 137 安装体验分数转成下一批体验升级排序。它解决的是“看到缺口后先做哪个”,而不是自动实施缺口。
2062
+
2063
+ ```bash
2064
+ node tools/vibe-runtime/index.mjs governance --experience-upgrades --from-comparison <local-comparison-json> --from-dashboard <local-dashboard-json> --from-install-experience <local-install-json> --json
2065
+ node tools/vibe-runtime/index.mjs governance --experience-upgrades --from-comparison <local-comparison-json> --from-dashboard <local-dashboard-json>
2066
+ ```
2067
+
2068
+ `governance --experience-upgrades` 输出 `experience_upgrade_prioritizer`,包含 `stage='Stage 139'`、`prioritizer_kind='experience-upgrade-prioritizer'`、`source_bindings`、`input_summary`、`upgrade_candidates`、`recommended_stage_order`、`defer`、`prioritization_policy`、`next_upgrade_bet`、`upgrade_invariants` 和 `upgrade_digest`。
2069
+
2070
+ 排序固定覆盖 `impact_score`、`risk_score`、`implementation_cost`、`priority_score`、`comparison_gap`、`confidence`、`why_now`、`boundary`、`defer_reason`。默认推迟 `default_live_agent_eval_runner` 和 `auto_subagent_execution`,避免从 external reference 差距直接跳到 live eval、默认 subagent 或自动执行。
2071
+
2072
+ 边界固定:`upgrade_artifact=false`、`prioritizer_artifact=false`、`comparison_artifact=false`、`dashboard_artifact=false`、`install_experience_artifact=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`eval_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`repair_execution=false`、`prompt_mutation=false`、`hook_registration=false`、`dynamic_tool_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2073
+
2074
+ Stage 139 不执行升级、不运行 eval、不创建 agent session、不调用模型 judge、不执行 workflow skill、不运行命令/check/test、不写 state/sidecar/source,不调用 subagent/MCP/模型/平台/API,不执行 git/commit/push/PR/merge。它只把体验升级候选变成本地、确定性、可复验的 ordering report。
2075
+
2076
+ ## Stage 140:Legacy Workflow Discipline Scorecard v2
2077
+
2078
+ Stage 140 新增只读 `governance --legacy-workflow-discipline-scorecard`,把 Stage 133-140 的 external reference 横向对标收口为一个可解释 scorecard。它证明 Vibecoding 不是散点补功能,而是把 external reference 的优势翻译为本地合同、可验边界和下一轮明确押注。
2079
+
2080
+ ```bash
2081
+ node tools/vibe-runtime/index.mjs governance --legacy-workflow-discipline-scorecard --from-comparison <local-comparison-json> --from-entry-discipline <local-discipline-json> --from-install-experience <local-install-json> --from-upgrades <local-upgrades-json> --json
2082
+ node tools/vibe-runtime/index.mjs governance --legacy-workflow-discipline-scorecard --from-comparison <local-comparison-json> --from-entry-discipline <local-discipline-json> --from-install-experience <local-install-json> --from-upgrades <local-upgrades-json>
2083
+ ```
2084
+
2085
+ `governance --legacy-workflow-discipline-scorecard` 输出 `legacy_workflow_discipline_scorecard`,包含 `stage='Stage 140'`、`scorecard_kind='legacy-workflow-discipline-scorecard-v2'`、`source_bindings`、`input_summary`、`parity_axes`、`parity_score`、`vibecoding_leads`、`remaining_gaps`、`do_not_cross_boundaries`、`next_cycle_bet`、`parity_invariants` 和 `parity_digest`。
2086
+
2087
+ scorecard 固定覆盖 `session_start_bootstrap`、`skill_trigger_discipline`、`adapter_packaging`、`hook_shape_coverage`、`eval_and_test_harness`、`daily_user_friction`、`subagent_boundary`、`token_and_context_economy`、`contributor_guardrails`,并显式输出 `no_full_skill_injection`、`no_auto_subagent_execution`、`no_default_live_agent_eval_runner`、`no_platform_api_or_network`、`no_git_pr_push_merge` 等 do-not-cross 边界。
2088
+
2089
+ 边界固定:`parity_scorecard_artifact=false`、`scorecard_artifact=false`、`comparison_artifact=false`、`entry_discipline_artifact=false`、`install_experience_artifact=false`、`upgrades_artifact=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`eval_execution=false`、`agent_session_execution=false`、`verification_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`repair_execution=false`、`prompt_mutation=false`、`hook_registration=false`、`full_skill_injection=false`、`dynamic_tool_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2090
+
2091
+ Stage 140 不执行升级、不运行 eval、不创建 agent session、不注入完整 skill、不修改 prompt/hook/source、不执行 workflow skill、不运行命令/check/test、不写 state/sidecar/source,不调用 subagent/MCP/模型/平台/API,不执行 git/commit/push/PR/merge。它只读取本地 JSON 证据并输出 deterministic parity closeout。
2092
+
2093
+ ## Stage 141:Entry Trigger Tightening
2094
+
2095
+ Stage 141 新增只读 `workflow --entry-tightening`,把 Stage 135 的入口触发纪律和 Stage 140 的 parity closeout 转成“下一句应该怎么说”的可复制合同。它解决的是 silent workflow skip,而不是执行 workflow skill 或修改 prompt/template/skill。
2096
+
2097
+ ```bash
2098
+ node tools/vibe-runtime/index.mjs workflow --entry-tightening --from-discipline <local-discipline-json> --from-scorecard <local-parity-scorecard-json> --intent feature --json
2099
+ node tools/vibe-runtime/index.mjs workflow --entry-tightening --from-discipline <local-discipline-json> --from-scorecard <local-parity-scorecard-json>
2100
+ ```
2101
+
2102
+ `workflow --entry-tightening` 输出 `entry_trigger_tightening`,包含 `stage='Stage 141'`、`tightening_kind='entry-trigger-tightening-contract'`、`source_bindings`、`input_summary`、`trigger_gap_summary`、`expected_route`、`tightening_score`、`missing_entry_moves`、`recommended_opening_sentence`、`must_not_skip`、`tightening_invariants` 和 `tightening_digest`。
2103
+
2104
+ 收紧固定覆盖 `using_vibecoding_first`、`protocol_layers_declared`、`intent_route_match`、`scorecard_skill_trigger_discipline`、`next_cycle_entry_trigger_tightening`、`copy_ready_move`、`expected_route`、`recommended_opening_sentence`、`must_not_skip` 和 `tightening_digest`。
2105
+
2106
+ 边界固定:`entry_tightening_artifact=false`、`entry_trigger_tightening_artifact=false`、`discipline_artifact=false`、`entry_discipline_artifact=false`、`parity_scorecard_artifact=false`、`scorecard_artifact=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`transcript_write=false`、`prompt_mutation=false`、`template_mutation=false`、`skill_mutation=false`、`hook_registration=false`、`hook_execution=false`、`adapter_execution=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`eval_execution=false`、`agent_session_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`repair_execution=false`、`full_skill_injection=false`、`dynamic_tool_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2107
+
2108
+ Stage 141 不执行 workflow skill、不运行 hook/adapter/eval/check/test、不修改 prompt/template/skill/hook/source、不写 state/sidecar/source、不调用 subagent/MCP/模型/平台/API、不执行 git/commit/push/PR/merge。它只读取本地 Stage 135/140 JSON 证据并输出 deterministic entry-opening guidance。
2109
+
2110
+ ## Stage 142:Session-start Shape Examples
2111
+
2112
+ Stage 142 新增只读 `platforms --session-start-examples`,把 Stage 134 的 session-start shape acceptance 和 Stage 137 的 install experience score 转成 copy-ready adapter 输出示例包。目标是减少 adapter/hook 输出格式猜测,而不是执行 hook 或写入 adapter/plugin 文件。
2113
+
2114
+ ```bash
2115
+ node tools/vibe-runtime/index.mjs platforms --session-start-examples --from-shape <local-shape-json> --from-install-experience <local-install-json> --json
2116
+ node tools/vibe-runtime/index.mjs platforms --session-start-examples --from-shape <local-shape-json> --from-install-experience <local-install-json>
2117
+ ```
2118
+
2119
+ `platforms --session-start-examples` 输出 `session_start_example_pack`,包含 `stage='Stage 142'`、`pack_kind='session-start-example-pack'`、`source_bindings`、`input_summary`、`adapter_examples`、`copy_ready_context_shapes`、`format_warnings`、`example_pack_invariants` 和 `example_pack_digest`。
2120
+
2121
+ 示例固定覆盖 Claude、Cursor、Codex 与 Cursor SDK:`hookSpecificOutput.additionalContext`、`additional_context`、`additionalContext` 三类平台输出形态,并输出 `adapter_examples`、`copy_ready_context_shapes`、`format_warnings`、`example_pack_digest`。copy-ready context 同步包含 `selected_skill`、`visible_route`、`next_manual_action`、`context_policy` 和 `hidden_execution=false`、`command_execution=false`、`skill_execution_claimed=false`、`subagent_dispatch_claimed=false`、`git_write_claimed=false`、`platform_api=false`、`model_invocation=false`、`business_source_write=false`。
2122
+
2123
+ 边界固定:`session_start_example_pack_artifact=false`、`session_start_shape_artifact=false`、`install_experience_artifact=false`、`adapter_example_artifact=false`、`adapter_install=false`、`adapter_execution=false`、`hook_execution=false`、`hook_registration=false`、`manifest_write=false`、`install_doc_write=false`、`settings_write=false`、`prompt_mutation=false`、`template_mutation=false`、`skill_mutation=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`full_skill_injection=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2124
+
2125
+ Stage 142 不执行 hook、不安装或运行 adapter、不修改 prompt/template/skill/manifest/doc/source、不写 state/example/sidecar/source、不运行 command/check/test/workflow、不调用 subagent/MCP/模型/平台/API、不执行 git/commit/push/PR/merge。它只读取本地 Stage 134/137 JSON 证据并输出 deterministic copy-ready session-start examples。
2126
+
2127
+ ## Stage 143:Next-action Evidence Prompts
2128
+
2129
+ Stage 143 新增只读 `workflow --next-evidence-prompts`,把 Stage 127 的 next-action console、Stage 132 的 experience dashboard 和 Stage 139 的 upgrade prioritizer 转成下一步证据提示卡。目标是减少完成前反复回溯,而不是运行 check/test 或写 evidence sidecar。
2130
+
2131
+ ```bash
2132
+ node tools/vibe-runtime/index.mjs workflow --next-evidence-prompts --from-console <local-console-json> --from-dashboard <local-dashboard-json> --from-upgrades <local-upgrades-json> --json
2133
+ node tools/vibe-runtime/index.mjs workflow --next-evidence-prompts --from-console <local-console-json> --from-dashboard <local-dashboard-json> --from-upgrades <local-upgrades-json>
2134
+ ```
2135
+
2136
+ `workflow --next-evidence-prompts` 输出 `next_action_evidence_prompts`,包含 `stage='Stage 143'`、`prompts_kind='next-action-evidence-prompts'`、`source_bindings`、`input_summary`、`selected_next_action`、`evidence_prompt_cards`、`copy_ready_validation_notes`、`blocked_until`、`prompts_invariants` 和 `prompts_digest`。
2137
+
2138
+ 提示固定覆盖 Stage 127 console evidence、Stage 132 dashboard blockers、Stage 139 upgrade priority,并输出 `evidence_prompt_cards`、`copy_ready_validation_notes`、`blocked_until` 和 `prompts_digest`。
2139
+
2140
+ 边界固定:`next_action_evidence_prompts_artifact=false`、`evidence_prompt_artifact=false`、`console_artifact=false`、`dashboard_artifact=false`、`upgrade_artifact=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`evidence_write=false`、`validation_note_write=false`、`dashboard_write=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`verification_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`prompt_mutation=false`、`template_mutation=false`、`skill_mutation=false`、`hook_execution=false`、`adapter_execution=false`、`dynamic_tool_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2141
+
2142
+ Stage 143 不写 evidence、不创建 sidecar、不运行 command/check/test/workflow、不执行 workflow skill、不修改 prompt/template/skill/hook/source、不调用 subagent/MCP/模型/平台/API、不执行 git/commit/push/PR/merge。它只读取本地 Stage 127/132/139 JSON 证据并输出 deterministic next-action evidence prompts。
2143
+
2144
+ ## Stage 144:Context Budget Entry Defaults
2145
+
2146
+ Stage 144 新增只读 `tokens --entry-defaults`,把 Stage 128 的 Token Savior budget 和 Stage 140 的 Legacy Workflow Discipline scorecard 转成入口默认上下文建议。目标是让 workflow 入口可见,但不默认注入完整 skill 文本。
2147
+
2148
+ ```bash
2149
+ node tools/vibe-runtime/index.mjs tokens --entry-defaults --from-budget <local-token-budget-json> --from-scorecard <local-parity-scorecard-json> --json
2150
+ node tools/vibe-runtime/index.mjs tokens --entry-defaults --from-budget <local-token-budget-json> --from-scorecard <local-parity-scorecard-json>
2151
+ ```
2152
+
2153
+ `tokens --entry-defaults` 输出 `context_budget_entry_defaults`,包含 `stage='Stage 144'`、`defaults_kind='context-budget-entry-defaults'`、`source_bindings`、`input_summary`、`recommended_profile`、`surface_now`、`defer_until_needed`、`token_saving_boundary`、`entry_defaults_invariants` 和 `entry_defaults_digest`。
2154
+
2155
+ 默认建议固定覆盖轻量 `using-vibecoding` 入口、local evidence pointer、token/context parity signal、preview-only command pointer,并把完整 skill 文本、未选 workflow skills、live eval / agent / subagent context 放入 `defer_until_needed`。
2156
+
2157
+ 边界固定:`context_budget_entry_defaults_artifact=false`、`entry_defaults_artifact=false`、`token_budget_artifact=false`、`parity_scorecard_artifact=false`、`prompt_mutation=false`、`template_mutation=false`、`skill_mutation=false`、`hook_execution=false`、`adapter_execution=false`、`full_skill_injection=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`smoke_execution=false`、`test_execution=false`、`verification_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`dynamic_tool_execution=false`、`embeddings=false`、`remote_config=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2158
+
2159
+ Stage 144 不做 embeddings、不调用模型、不读取远端配置、不修改 prompt/template/skill/hook/source、不注入完整 skill、不运行 command/check/test/workflow、不写 state/artifact/sidecar、不调用 subagent/MCP/平台/API、不执行 git/commit/push/PR/merge。它只读取本地 Stage 128/140 JSON 证据并输出 deterministic context budget entry defaults。
2160
+
2161
+ ## Stage 145:Local Behavior Eval Contracts
2162
+
2163
+ Stage 145 新增只读 `evals --local-behavior-contracts`,把 Stage 138 的 external-reference-style scenario pack 和 Stage 141 的 entry tightening 合同转成本地 deterministic behavior eval contracts。目标是扩展行为验收学习模型,但仍不运行 live agent eval 或模型 judge。
2164
+
2165
+ ```bash
2166
+ node tools/vibe-runtime/index.mjs evals --local-behavior-contracts --from-style-pack <local-style-pack-json> --from-entry-tightening <local-entry-tightening-json> --json
2167
+ node tools/vibe-runtime/index.mjs evals --local-behavior-contracts --from-style-pack <local-style-pack-json> --from-entry-tightening <local-entry-tightening-json>
2168
+ ```
2169
+
2170
+ `evals --local-behavior-contracts` 输出 `local_behavior_eval_contracts`,包含 `stage='Stage 145'`、`contracts_kind='local-behavior-eval-contracts'`、`source_bindings`、`input_summary`、`contract_cases`、`deterministic_judges`、`live_eval_deferred`、`contracts_invariants` 和 `contracts_digest`。
2171
+
2172
+ 合同固定覆盖 Stage 138 scenario 的 `expected_behavior` / `failure_signals`,并绑定 Stage 141 的 `recommended_opening_sentence`、`missing_entry_moves`、`must_not_skip`。固定 judge 包含 `visible_entry_route_judge`、`evidence_before_completion_judge`、`forbidden_action_boundary_judge`、`deterministic_contract_only_judge`。
2173
+
2174
+ 边界固定:`local_behavior_eval_contracts_artifact=false`、`behavior_contract_artifact=false`、`style_pack_artifact=false`、`entry_tightening_artifact=false`、`eval_suite_artifact=false`、`eval_run_artifact=false`、`eval_report_artifact=false`、`prompt_mutation=false`、`template_mutation=false`、`skill_mutation=false`、`hook_execution=false`、`adapter_execution=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`eval_execution=false`、`live_eval_execution=false`、`agent_session_execution=false`、`model_judge_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`full_skill_injection=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2175
+
2176
+ Stage 145 不运行 eval、不创建 agent session、不调用模型 judge、不执行 workflow skill、不运行 command/check/test、不修改 prompt/template/skill/hook/source、不写 state/sidecar/source、不调用 subagent/MCP/模型/平台/API、不执行 git/commit/push/PR/merge。它只读取本地 Stage 138/141 JSON 证据并输出 deterministic local behavior contracts。
2177
+
2178
+ ## Stage 146:Contributor Guardrail Evidence
2179
+
2180
+ Stage 146 新增只读 `governance --contributor-guardrails`,把 Stage 140 的 parity scorecard 和 Stage 143 的 next-action evidence prompts 转成本地 contributor closeout guardrails。它吸收 external reference contributor guardrail 的价值,但不创建 PR、不搜索远端 review 状态、不 push、不 merge,也不授权自动修复。
2181
+
2182
+ ```bash
2183
+ node tools/vibe-runtime/index.mjs governance --contributor-guardrails --from-scorecard <local-parity-scorecard-json> --from-evidence-prompts <local-evidence-prompts-json> --json
2184
+ node tools/vibe-runtime/index.mjs governance --contributor-guardrails --from-scorecard <local-parity-scorecard-json> --from-evidence-prompts <local-evidence-prompts-json>
2185
+ ```
2186
+
2187
+ `governance --contributor-guardrails` 输出 `contributor_guardrail_evidence`,包含 `stage='Stage 146'`、`guardrail_kind='contributor-guardrail-evidence'`、`source_bindings`、`input_summary`、`guardrail_findings`、`required_disclosures`、`unsafe_closeout_risks`、`closeout_contract`、`guardrail_invariants` 和 `guardrail_digest`。
2188
+
2189
+ 合同固定覆盖 `validation-evidence-required`、`do-not-cross-boundaries-visible`、`remaining-gaps-disclosed`、`no-remote-pr-review-search`、`no-auto-repair-from-evidence`,并固定 `commit_allowed_by_contract=false`、`push_allowed_by_contract=false`、`pr_allowed_by_contract=false`、`merge_allowed_by_contract=false`、`remote_review_lookup_allowed_by_contract=false`。
2190
+
2191
+ 边界固定:`contributor_guardrail_evidence_artifact=false`、`guardrail_artifact=false`、`parity_scorecard_artifact=false`、`evidence_prompts_artifact=false`、`disclosure_artifact=false`、`closeout_artifact=false`、`pr_readiness_artifact=false`、`pr_review_artifact=false`、`remote_pr_search=false`、`remote_review_search=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`evidence_write=false`、`disclosure_write=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`eval_execution=false`、`verification_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`repair_execution=false`、`auto_fix=false`、`prompt_mutation=false`、`template_mutation=false`、`skill_mutation=false`、`hook_execution=false`、`adapter_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2192
+
2193
+ Stage 146 不创建 PR、不搜索远端 PR/review 状态、不 push、不 merge、不运行 command/check/test/workflow、不自动修复、不修改 prompt/template/skill/hook/source、不写 state/sidecar/artifact/source、不调用 git/平台 API/外部网络/模型/MCP/subagent。它只读取本地 Stage 140/143 JSON 证据并输出 contributor guardrail evidence。
2194
+
2195
+ ## Stage 147:Subagent Permission Visibility
2196
+
2197
+ Stage 147 新增只读 `governance --subagent-permission`,把 Stage 140 parity scorecard 和 Stage 146 contributor guardrails 转成可见的 subagent permission gates。它只让“何时可以询问用户授权 subagent、授权 brief 需要哪些边界”变得可复制、可检查;不默认启用 subagent、不创建 dispatch、不创建 session、不写 sidecar。
2198
+
2199
+ ```bash
2200
+ node tools/vibe-runtime/index.mjs governance --subagent-permission --from-scorecard <local-parity-scorecard-json> --from-guardrails <local-guardrails-json> --json
2201
+ node tools/vibe-runtime/index.mjs governance --subagent-permission --from-scorecard <local-parity-scorecard-json> --from-guardrails <local-guardrails-json>
2202
+ ```
2203
+
2204
+ `governance --subagent-permission` 输出 `subagent_permission_visibility`,包含 `stage='Stage 147'`、`permission_kind='subagent-permission-visibility'`、`source_bindings`、`input_summary`、`permission_gate`、`brief_requirements`、`must_ask_user_first`、`visibility_contract`、`permission_invariants` 和 `permission_digest`。
2205
+
2206
+ 合同固定覆盖 `explicit-user-permission`、`brief-completeness`、`boundary-carry-forward`、`no-hidden-dispatch`、`fallback-owner-visible`,并固定 `subagent_allowed_by_contract=false`、`dispatch_allowed_by_contract=false`、`session_allowed_by_contract=false`、`auto_dispatch_allowed_by_contract=false`、`dispatch_created=false`、`session_created=false`、`must_ask_user_first=true`。
2207
+
2208
+ 边界固定:`subagent_permission_visibility_artifact=false`、`permission_artifact=false`、`guardrail_artifact=false`、`parity_scorecard_artifact=false`、`brief_artifact=false`、`dispatch_artifact=false`、`session_artifact=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`subagent=false`、`subagent_dispatch=false`、`subagent_session=false`、`agent_session=false`、`session_create=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`eval_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`auto_dispatch=false`、`repair_execution=false`、`auto_fix=false`、`prompt_mutation=false`、`template_mutation=false`、`skill_mutation=false`、`hook_execution=false`、`adapter_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`mcp=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2209
+
2210
+ Stage 147 不调用 subagent、不创建 dispatch/session artifact、不隐藏 handoff、不运行 command/check/test/workflow、不自动 dispatch、不写 state/sidecar/artifact/source、不调用 git/PR/push/merge/平台 API/外部网络/模型/MCP。它只读取本地 Stage 140/146 JSON 证据并输出一个要求先询问用户的非授权 visibility contract。
2211
+
2212
+ ## Stage 148:Adapter Packaging Consistency Checklist
2213
+
2214
+ Stage 148 新增只读 `platforms --adapter-packaging-consistency`,把 Stage 122 adapter bootstrap matrix 和 Stage 142 session-start example pack 转成 adapter packaging consistency checklist。它只把平台安装包之间的剩余分叉、缺失 install marker、copy-ready 修复说明变得可见、可验;不安装 adapter、不执行 hook、不修改 plugin manifest/install doc。
2215
+
2216
+ ```bash
2217
+ node tools/vibe-runtime/index.mjs platforms --adapter-packaging-consistency --from-bootstrap-matrix <local-bootstrap-json> --from-session-examples <local-session-examples-json> --json
2218
+ node tools/vibe-runtime/index.mjs platforms --adapter-packaging-consistency --from-bootstrap-matrix <local-bootstrap-json> --from-session-examples <local-session-examples-json>
2219
+ ```
2220
+
2221
+ `platforms --adapter-packaging-consistency` 输出 `adapter_packaging_consistency`,包含 `stage='Stage 148'`、`consistency_kind='adapter-packaging-consistency-checklist'`、`source_bindings`、`input_summary`、`adapter_rows`、`missing_install_markers`、`copy_ready_fix_notes`、`consistency_invariants` 和 `consistency_digest`。
2222
+
2223
+ 一致性 checklist 固定覆盖 `claude`、`cursor`、`codex` baseline adapters,绑定 Stage 122 bootstrap row 与 Stage 142 session-start example/context shape,并输出 `adapter_rows`、`missing_install_markers`、`copy_ready_fix_notes` 和 `consistency_digest`。
2224
+
2225
+ 边界固定:`adapter_packaging_consistency_artifact=false`、`bootstrap_matrix_artifact=false`、`session_start_example_pack_artifact=false`、`adapter_row_artifact=false`、`fix_note_artifact=false`、`adapter_install=false`、`adapter_execution=false`、`hook_execution=false`、`hook_registration=false`、`manifest_write=false`、`plugin_manifest_write=false`、`install_doc_write=false`、`settings_write=false`、`source_write=false`、`sidecar_write=false`、`state_directory_created=false`、`command_execution=false`、`check_execution=false`、`test_execution=false`、`workflow_execution=false`、`skill_execution=false`、`runtime_action=false`、`auto_execution=false`、`repair_execution=false`、`auto_fix=false`、`prompt_mutation=false`、`template_mutation=false`、`skill_mutation=false`、`full_skill_injection=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`mcp=false`、`git=false`、`git_write=false`、`git_add=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`。
2226
+
2227
+ Stage 148 不安装 adapter、不执行 hook/adapter/command/check/test/workflow、不修改 plugin manifest/install doc/source/prompt/template/skill、不写 state/sidecar/artifact/source、不调用 git/PR/push/merge/平台 API/外部网络/模型/MCP/subagent。它只读取本地 Stage 122/142 JSON 证据并输出 adapter packaging consistency checklist。
2228
+
2229
+ ## P25-P31:Controlled Legacy Workflow Discipline Contract Sync
2230
+
2231
+ P25-P31 把 `legacy-workflow-discipline` 收束为受控 profile 合同,而不是隐藏执行框架。默认 profile 继续保持 safe governance mode;parity profile 只能在用户显式 opt-in 后增强入口、连续 gate、SDD handoff、TDD/verification 和 subagent permission 可见性。
2232
+
2233
+ 机器标记:`controlled_legacy_workflow_discipline`、`legacy_workflow_discipline_control_sync`、`P25`、`P26`、`P27`、`P28`、`P29`、`P30`、`P31`、`workflow --start --profile legacy-workflow-discipline`、`workflow --loop-contract --profile legacy-workflow-discipline`、`sdd --plan --profile legacy-workflow-discipline`、`sdd --task-brief --profile legacy-workflow-discipline`、`sdd --review-package --profile legacy-workflow-discipline`、`verification --tdd-trace`、`completion --evidence-bundle`、`subagents --adapter-dispatch`、`profile_contract_summary`、`skill_first_receipt`、`next_gate_summary`、`handoff_chain`、`verification_gate`、`subagent_permission_gate`、`subagent-explicit-permission-gate` 和 `readiness_parity_boundaries`。
2234
+
2235
+ 边界固定:`default_profile_safe=true`、`legacy_workflow_discipline_opt_in=true`、`profile_artifact=false`、`receipt_artifact=false`、`next_gate_artifact=false`、`handoff_preview_read_only=true`、`verification_execution=false`、`adapter_consumable_only_when_permission_gate_passed=true`、`hidden_execution=false`、`auto_execution=false`、`workflow_execution=false`、`skill_execution=false`、`command_execution=false`、`test_execution=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`subagent=false`、`subagent_session=false`、`session_create=false`、`git=false`、`git_write=false`、`commit=false`、`pr=false`、`push=false`、`merge=false`、`business_source_write=false`、`state_directory_created=false` 和 `writes=false`。
2236
+
2237
+ P31 同步 registry/readiness/runtime-check/release-check/docs:visible receipt、next gate、handoff chain、verification gate 和 explicit subagent permission gate 都只是回归目标,不授权运行命令、创建 session、调用 adapter、写业务文件或执行 git 动作。
2238
+
2239
+ ## Stage 156:Implementation Task Completion Alignment
2240
+
2241
+ Stage 156 新增只读 `methodology --gate --kind implementation-plan`,把 `implementation-plan.md` 从自然语言计划升级为可索引的 `Implementation Task Registry`。它检查 `task_id`、required/status、expected files、allowed paths、expected operations、required scenario refs、risk/test contract 和 rollback,不执行测试、不读取 git diff、不写状态。
2242
+
2243
+ ```bash
2244
+ node tools/vibe-runtime/index.mjs methodology --gate --kind implementation-plan --from-file <local-implementation-plan-md> --json
2245
+ node tools/vibe-runtime/index.mjs methodology --gate --kind implementation-plan --from-file <local-implementation-plan-md>
2246
+ ```
2247
+
2248
+ Stage 155 full-chain `completion --evidence-bundle --from-product-discovery ... --from-architecture ... --from-traceability ... --from-commit-readiness ...` 会复用 Stage 156 task registry,并输出 `implementation_alignment_gate` / `implementation_alignment_ok`。`diff-coverage.json` 通过 `task_coverage[].task_ref` 绑定 changed files 和 operation;`test-evidence.json` 通过 `runs[].task_refs[]` 绑定 required/high-risk task 的 passing evidence。负例覆盖 `implementation_changed_file_unexplained`、`implementation_task_uncovered`、`implementation_operation_mismatch` 和 `implementation_task_missing_test_evidence`。
2249
+
2250
+ 边界固定:`writes=false`、`state_directory_created=false`、`command_execution=false`、`test_execution=false`、`git=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`、`subagent=false`、`mcp=false`。
2251
+
2252
+ ## Legacy Workflow Discipline product expression
2253
+
2254
+ 当前对外表达收敛为两档体验:
2255
+
2256
+ - `safe governance mode`:默认入口,保持轻量、本地只读和人工确认;证据链、readiness、边界可审查,但不隐藏执行 workflow skill、测试、subagent、git、worktree 或平台 API。
2257
+ - `legacy-workflow-discipline mode`:显式 opt-in profile,用于强 `using-vibecoding` 入口、连续计划推进、SDD task loop、evidence chain、workspace contract、task-commit gate 和 deterministic behavior eval。该模式只生成本地合同、ledger、dispatch/evidence/commit-readiness sidecar;不真实调用 subagent/model/platform API,不自动创建 git worktree,不自动写业务源码,不自动 commit/push/PR/merge。
2258
+
2259
+ 文档和 smoke 必须同时保护两点:默认模式不能升级为隐藏自动执行;parity 模式必须描述为 opt-in、本地、可复验,并把 subagent、source write、task commit、主 worktree apply、push/PR/merge 继续拆成独立 gate。
2260
+
2261
+ ## installed layout 边界
2262
+
2263
+ 默认安装不启用 runtime,不生成状态目录,不修改业务项目入口语义。
2264
+
2265
+ 后续如果增加 `--with-runtime`,也只能安装说明和可选状态目录建议,不能接管平台私有 hook 或后台任务。