@rpamis/comet 0.4.0-beta.14 → 0.4.0-beta.16

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 (332) hide show
  1. package/README.md +13 -1
  2. package/assets/manifest.json +1 -1
  3. package/assets/skills/comet/SKILL.md +6 -5
  4. package/assets/skills/comet/reference/subagent-dispatch.md +2 -4
  5. package/assets/skills/comet/rules/comet-phase-guard.en.md +4 -3
  6. package/assets/skills/comet/rules/comet-phase-guard.md +4 -3
  7. package/assets/skills/comet/rules/comet-workflow-guard.en.md +1 -1
  8. package/assets/skills/comet/rules/comet-workflow-guard.md +1 -1
  9. package/assets/skills/comet/scripts/comet-archive.mjs +88 -88
  10. package/assets/skills/comet/scripts/comet-guard.mjs +126 -126
  11. package/assets/skills/comet/scripts/comet-handoff.mjs +88 -88
  12. package/assets/skills/comet/scripts/comet-hook-guard.mjs +91 -89
  13. package/assets/skills/comet/scripts/comet-hook-router.mjs +124 -116
  14. package/assets/skills/comet/scripts/comet-resume-probe.mjs +72 -72
  15. package/assets/skills/comet/scripts/comet-runtime.mjs +188 -185
  16. package/assets/skills/comet/scripts/comet-state.mjs +108 -107
  17. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +97 -97
  18. package/assets/skills/comet-any/SKILL.md +1 -1
  19. package/assets/skills/comet-any/reference/authoring-subagents.md +3 -11
  20. package/assets/skills/comet-any/reference/subagents/pause-points-author.md +1 -4
  21. package/assets/skills/comet-any/reference/subagents/reference-author.md +1 -4
  22. package/assets/skills/comet-any/reference/subagents/script-author.md +1 -4
  23. package/assets/skills/comet-any/reference/subagents/skill-core-author.md +1 -4
  24. package/assets/skills/comet-any/reference/subagents/skill-reviewer.md +1 -4
  25. package/assets/skills/comet-any/reference/subagents/workflow-entry-author.md +1 -4
  26. package/assets/skills/comet-build/SKILL.md +2 -2
  27. package/assets/skills/comet-native/SKILL.md +85 -11
  28. package/assets/skills/comet-native/reference/artifacts.md +3 -1
  29. package/assets/skills/comet-native/reference/commands.md +15 -6
  30. package/assets/skills/comet-native/reference/recovery.md +12 -1
  31. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +124 -118
  32. package/assets/skills/comet-native/scripts/comet-native-check.mjs +116 -110
  33. package/assets/skills/comet-native/scripts/comet-native-checkpoint.mjs +110 -110
  34. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +121 -121
  35. package/assets/skills/comet-native/scripts/comet-native-evidence.mjs +83 -83
  36. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +88 -82
  37. package/assets/skills/comet-native/scripts/comet-native-init.mjs +85 -85
  38. package/assets/skills/comet-native/scripts/comet-native-new.mjs +114 -114
  39. package/assets/skills/comet-native/scripts/comet-native-next.mjs +122 -122
  40. package/assets/skills/comet-native/scripts/comet-native-receipt.mjs +124 -116
  41. package/assets/skills/comet-native/scripts/comet-native-root.mjs +110 -110
  42. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +154 -152
  43. package/assets/skills/comet-native/scripts/comet-native-select.mjs +110 -110
  44. package/assets/skills/comet-native/scripts/comet-native-show.mjs +80 -80
  45. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +112 -112
  46. package/assets/skills/comet-native/scripts/comet-native-status.mjs +107 -107
  47. package/assets/skills-zh/comet/SKILL.md +3 -3
  48. package/assets/skills-zh/comet/reference/subagent-dispatch.md +2 -4
  49. package/assets/skills-zh/comet-any/SKILL.md +1 -1
  50. package/assets/skills-zh/comet-any/reference/authoring-subagents.md +3 -14
  51. package/assets/skills-zh/comet-any/reference/subagents/pause-points-author.md +1 -4
  52. package/assets/skills-zh/comet-any/reference/subagents/reference-author.md +1 -4
  53. package/assets/skills-zh/comet-any/reference/subagents/script-author.md +1 -4
  54. package/assets/skills-zh/comet-any/reference/subagents/skill-core-author.md +1 -4
  55. package/assets/skills-zh/comet-any/reference/subagents/skill-reviewer.md +1 -4
  56. package/assets/skills-zh/comet-any/reference/subagents/workflow-entry-author.md +1 -4
  57. package/assets/skills-zh/comet-build/SKILL.md +2 -2
  58. package/assets/skills-zh/comet-native/SKILL.md +86 -12
  59. package/assets/skills-zh/comet-native/reference/artifacts.md +3 -1
  60. package/assets/skills-zh/comet-native/reference/commands.md +17 -8
  61. package/assets/skills-zh/comet-native/reference/recovery.md +14 -3
  62. package/bin/fast-runtime-router.js +1 -0
  63. package/dist/app/cli/index.js +1 -0
  64. package/dist/app/cli/index.js.map +1 -1
  65. package/dist/app/commands/doctor.d.ts.map +1 -1
  66. package/dist/app/commands/doctor.js +146 -39
  67. package/dist/app/commands/doctor.js.map +1 -1
  68. package/dist/app/commands/init.d.ts.map +1 -1
  69. package/dist/app/commands/init.js +43 -12
  70. package/dist/app/commands/init.js.map +1 -1
  71. package/dist/app/commands/update.d.ts.map +1 -1
  72. package/dist/app/commands/update.js +42 -9
  73. package/dist/app/commands/update.js.map +1 -1
  74. package/dist/app/commands/workflow.d.ts +1 -0
  75. package/dist/app/commands/workflow.d.ts.map +1 -1
  76. package/dist/app/commands/workflow.js +9 -2
  77. package/dist/app/commands/workflow.js.map +1 -1
  78. package/dist/domains/comet-classic/classic-evidence.d.ts.map +1 -1
  79. package/dist/domains/comet-classic/classic-evidence.js +45 -9
  80. package/dist/domains/comet-classic/classic-evidence.js.map +1 -1
  81. package/dist/domains/comet-classic/classic-hook-guard.d.ts +5 -1
  82. package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
  83. package/dist/domains/comet-classic/classic-hook-guard.js +104 -20
  84. package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
  85. package/dist/domains/comet-classic/classic-layout-initialization.d.ts +4 -3
  86. package/dist/domains/comet-classic/classic-layout-initialization.d.ts.map +1 -1
  87. package/dist/domains/comet-classic/classic-layout-initialization.js +13 -9
  88. package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -1
  89. package/dist/domains/comet-classic/classic-layout.d.ts +2 -11
  90. package/dist/domains/comet-classic/classic-layout.d.ts.map +1 -1
  91. package/dist/domains/comet-classic/classic-layout.js +22 -28
  92. package/dist/domains/comet-classic/classic-layout.js.map +1 -1
  93. package/dist/domains/comet-classic/classic-plan-readiness.d.ts +12 -0
  94. package/dist/domains/comet-classic/classic-plan-readiness.d.ts.map +1 -0
  95. package/dist/domains/comet-classic/classic-plan-readiness.js +26 -0
  96. package/dist/domains/comet-classic/classic-plan-readiness.js.map +1 -0
  97. package/dist/domains/comet-classic/classic-project-config.d.ts +1 -0
  98. package/dist/domains/comet-classic/classic-project-config.d.ts.map +1 -1
  99. package/dist/domains/comet-classic/classic-project-config.js +13 -7
  100. package/dist/domains/comet-classic/classic-project-config.js.map +1 -1
  101. package/dist/domains/comet-classic/classic-root-command.d.ts.map +1 -1
  102. package/dist/domains/comet-classic/classic-root-command.js +6 -1
  103. package/dist/domains/comet-classic/classic-root-command.js.map +1 -1
  104. package/dist/domains/comet-classic/classic-state-command.d.ts.map +1 -1
  105. package/dist/domains/comet-classic/classic-state-command.js +58 -7
  106. package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
  107. package/dist/domains/comet-entry/hook-adapter.d.ts.map +1 -1
  108. package/dist/domains/comet-entry/hook-adapter.js +19 -2
  109. package/dist/domains/comet-entry/hook-adapter.js.map +1 -1
  110. package/dist/domains/comet-entry/hook-project-root.d.ts +3 -0
  111. package/dist/domains/comet-entry/hook-project-root.d.ts.map +1 -0
  112. package/dist/domains/comet-entry/hook-project-root.js +62 -0
  113. package/dist/domains/comet-entry/hook-project-root.js.map +1 -0
  114. package/dist/domains/comet-entry/hook-router-entry.d.ts +2 -1
  115. package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
  116. package/dist/domains/comet-entry/hook-router-entry.js +6 -4
  117. package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
  118. package/dist/domains/comet-entry/hook-router.d.ts +2 -0
  119. package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
  120. package/dist/domains/comet-entry/hook-router.js +45 -9
  121. package/dist/domains/comet-entry/hook-router.js.map +1 -1
  122. package/dist/domains/comet-entry/hook-types.d.ts +1 -0
  123. package/dist/domains/comet-entry/hook-types.d.ts.map +1 -1
  124. package/dist/domains/comet-entry/project-activation.d.ts +12 -0
  125. package/dist/domains/comet-entry/project-activation.d.ts.map +1 -0
  126. package/dist/domains/comet-entry/project-activation.js +109 -0
  127. package/dist/domains/comet-entry/project-activation.js.map +1 -0
  128. package/dist/domains/comet-entry/resume-probe.d.ts.map +1 -1
  129. package/dist/domains/comet-entry/resume-probe.js +47 -26
  130. package/dist/domains/comet-entry/resume-probe.js.map +1 -1
  131. package/dist/domains/comet-entry/types.d.ts +1 -1
  132. package/dist/domains/comet-entry/types.d.ts.map +1 -1
  133. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -1
  134. package/dist/domains/comet-native/native-archive-command.js +43 -1
  135. package/dist/domains/comet-native/native-archive-command.js.map +1 -1
  136. package/dist/domains/comet-native/native-archive-inspection.d.ts.map +1 -1
  137. package/dist/domains/comet-native/native-archive-inspection.js +11 -0
  138. package/dist/domains/comet-native/native-archive-inspection.js.map +1 -1
  139. package/dist/domains/comet-native/native-archive-preflight.d.ts +10 -0
  140. package/dist/domains/comet-native/native-archive-preflight.d.ts.map +1 -1
  141. package/dist/domains/comet-native/native-archive-preflight.js +44 -0
  142. package/dist/domains/comet-native/native-archive-preflight.js.map +1 -1
  143. package/dist/domains/comet-native/native-change.d.ts +18 -1
  144. package/dist/domains/comet-native/native-change.d.ts.map +1 -1
  145. package/dist/domains/comet-native/native-change.js +72 -3
  146. package/dist/domains/comet-native/native-change.js.map +1 -1
  147. package/dist/domains/comet-native/native-check.d.ts.map +1 -1
  148. package/dist/domains/comet-native/native-check.js +13 -1
  149. package/dist/domains/comet-native/native-check.js.map +1 -1
  150. package/dist/domains/comet-native/native-cli-shared.d.ts +2 -2
  151. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -1
  152. package/dist/domains/comet-native/native-cli-shared.js +24 -3
  153. package/dist/domains/comet-native/native-cli-shared.js.map +1 -1
  154. package/dist/domains/comet-native/native-conflict-inspection.d.ts +3 -1
  155. package/dist/domains/comet-native/native-conflict-inspection.d.ts.map +1 -1
  156. package/dist/domains/comet-native/native-conflict-inspection.js +20 -10
  157. package/dist/domains/comet-native/native-conflict-inspection.js.map +1 -1
  158. package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
  159. package/dist/domains/comet-native/native-continuation.js +16 -0
  160. package/dist/domains/comet-native/native-continuation.js.map +1 -1
  161. package/dist/domains/comet-native/native-diagnostics.d.ts +2 -0
  162. package/dist/domains/comet-native/native-diagnostics.d.ts.map +1 -1
  163. package/dist/domains/comet-native/native-diagnostics.js +43 -32
  164. package/dist/domains/comet-native/native-diagnostics.js.map +1 -1
  165. package/dist/domains/comet-native/native-evidence-storage.d.ts +6 -0
  166. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  167. package/dist/domains/comet-native/native-evidence-storage.js +24 -0
  168. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  169. package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
  170. package/dist/domains/comet-native/native-findings.js +36 -0
  171. package/dist/domains/comet-native/native-findings.js.map +1 -1
  172. package/dist/domains/comet-native/native-hook-guard.js +2 -2
  173. package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
  174. package/dist/domains/comet-native/native-new-command.d.ts.map +1 -1
  175. package/dist/domains/comet-native/native-new-command.js +22 -7
  176. package/dist/domains/comet-native/native-new-command.js.map +1 -1
  177. package/dist/domains/comet-native/native-receipt-command.d.ts.map +1 -1
  178. package/dist/domains/comet-native/native-receipt-command.js +14 -1
  179. package/dist/domains/comet-native/native-receipt-command.js.map +1 -1
  180. package/dist/domains/comet-native/native-receipt-errors.d.ts +23 -0
  181. package/dist/domains/comet-native/native-receipt-errors.d.ts.map +1 -0
  182. package/dist/domains/comet-native/native-receipt-errors.js +9 -0
  183. package/dist/domains/comet-native/native-receipt-errors.js.map +1 -0
  184. package/dist/domains/comet-native/native-receipt-refresh.d.ts +3 -0
  185. package/dist/domains/comet-native/native-receipt-refresh.d.ts.map +1 -1
  186. package/dist/domains/comet-native/native-receipt-refresh.js +13 -2
  187. package/dist/domains/comet-native/native-receipt-refresh.js.map +1 -1
  188. package/dist/domains/comet-native/native-root-move.d.ts.map +1 -1
  189. package/dist/domains/comet-native/native-root-move.js +54 -1
  190. package/dist/domains/comet-native/native-root-move.js.map +1 -1
  191. package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
  192. package/dist/domains/comet-native/native-snapshot.js +71 -14
  193. package/dist/domains/comet-native/native-snapshot.js.map +1 -1
  194. package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
  195. package/dist/domains/comet-native/native-transitions.js +74 -42
  196. package/dist/domains/comet-native/native-transitions.js.map +1 -1
  197. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +37 -4
  198. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
  199. package/dist/domains/comet-native/native-verification-receipt-runtime.js +192 -4
  200. package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
  201. package/dist/domains/comet-native/native-verification-runtime.d.ts +27 -1
  202. package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
  203. package/dist/domains/comet-native/native-verification-runtime.js +29 -6
  204. package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
  205. package/dist/domains/comet-native/native-workspace.d.ts +39 -3
  206. package/dist/domains/comet-native/native-workspace.d.ts.map +1 -1
  207. package/dist/domains/comet-native/native-workspace.js +200 -8
  208. package/dist/domains/comet-native/native-workspace.js.map +1 -1
  209. package/dist/domains/dashboard/collector.d.ts +26 -1
  210. package/dist/domains/dashboard/collector.d.ts.map +1 -1
  211. package/dist/domains/dashboard/collector.js +381 -1
  212. package/dist/domains/dashboard/collector.js.map +1 -1
  213. package/dist/domains/dashboard/native-adapter.d.ts +15 -0
  214. package/dist/domains/dashboard/native-adapter.d.ts.map +1 -1
  215. package/dist/domains/dashboard/native-adapter.js +1 -1
  216. package/dist/domains/dashboard/native-adapter.js.map +1 -1
  217. package/dist/domains/dashboard/native-collector.d.ts +26 -1
  218. package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
  219. package/dist/domains/dashboard/native-collector.js +284 -5
  220. package/dist/domains/dashboard/native-collector.js.map +1 -1
  221. package/dist/domains/dashboard/server.d.ts.map +1 -1
  222. package/dist/domains/dashboard/server.js +92 -3
  223. package/dist/domains/dashboard/server.js.map +1 -1
  224. package/dist/domains/dashboard/types.d.ts +41 -1
  225. package/dist/domains/dashboard/types.d.ts.map +1 -1
  226. package/dist/domains/dashboard/verify-parser.d.ts +1 -0
  227. package/dist/domains/dashboard/verify-parser.d.ts.map +1 -1
  228. package/dist/domains/dashboard/verify-parser.js +8 -4
  229. package/dist/domains/dashboard/verify-parser.js.map +1 -1
  230. package/dist/domains/dashboard/web/assets/{arc-mNt_SS1l.js → arc-ClrSujVb.js} +1 -1
  231. package/dist/domains/dashboard/web/assets/{architectureDiagram-3BPJPVTR-Bc5akVD6.js → architectureDiagram-3BPJPVTR-B4A_t84A.js} +1 -1
  232. package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-C43zhVBe.js → blockDiagram-GPEHLZMM-D72u2953.js} +1 -1
  233. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-dToETarK.js → c4Diagram-AAUBKEIU-Ca5zba3N.js} +1 -1
  234. package/dist/domains/dashboard/web/assets/channel-B_u-_i2t.js +1 -0
  235. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-C0oO137R.js → chunk-2J33WTMH-CCVPBm0J.js} +1 -1
  236. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-CGms1fgI.js → chunk-4BX2VUAB-JYluRsP-.js} +1 -1
  237. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-Bugl8v6f.js → chunk-55IACEB6-DfYm7pN7.js} +1 -1
  238. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-8ATNMlBG.js → chunk-727SXJPM-CwghIMO9.js} +1 -1
  239. package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-BNYjSSqU.js → chunk-AQP2D5EJ-BA_zgMXZ.js} +1 -1
  240. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-_nJAqSbe.js → chunk-FMBD7UC4-BAJLB5V6.js} +1 -1
  241. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-lyxYm5NX.js → chunk-ND2GUHAM-Bj6HWRwi.js} +1 -1
  242. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-PUMVeWpd.js → chunk-QZHKN3VN-B1kXfg5N.js} +1 -1
  243. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BpA7BPgX.js +1 -0
  244. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BpA7BPgX.js +1 -0
  245. package/dist/domains/dashboard/web/assets/{cose-bilkent-S5V4N54A-DzMqjexn.js → cose-bilkent-S5V4N54A-BBrkuiAU.js} +1 -1
  246. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-B67ET0eq.js → cynefin-VYW2F7L2-DlFhgQHt.js} +1 -1
  247. package/dist/domains/dashboard/web/assets/{dagre-BM42HDAG-CQPMvRLK.js → dagre-BM42HDAG-B0Bk5oiP.js} +1 -1
  248. package/dist/domains/dashboard/web/assets/{demo-BuVau32v.js → demo-DZYPLZpF.js} +2 -2
  249. package/dist/domains/dashboard/web/assets/{diagram-2AECGRRQ-BRpLrFHM.js → diagram-2AECGRRQ-tvTUiBA2.js} +1 -1
  250. package/dist/domains/dashboard/web/assets/{diagram-5GNKFQAL-CPGWuGrE.js → diagram-5GNKFQAL-BZfcK29q.js} +1 -1
  251. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-D2wpX2iO.js → diagram-KO2AKTUF-BQahyP-C.js} +1 -1
  252. package/dist/domains/dashboard/web/assets/{diagram-LMA3HP47-D54mAbDu.js → diagram-LMA3HP47-D5bJnW2C.js} +1 -1
  253. package/dist/domains/dashboard/web/assets/{diagram-OG6HWLK6-ZGQDpSs_.js → diagram-OG6HWLK6-DTwWdzWJ.js} +1 -1
  254. package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-C3qDo7sd.js → erDiagram-TEJ5UH35-BbvrdCp9.js} +1 -1
  255. package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-B7hStPd9.js → flowDiagram-I6XJVG4X-DgbR7Tcc.js} +1 -1
  256. package/dist/domains/dashboard/web/assets/{ganttDiagram-6RSMTGT7-IqcLFbTK.js → ganttDiagram-6RSMTGT7-wWMOA7F4.js} +1 -1
  257. package/dist/domains/dashboard/web/assets/{gitGraphDiagram-PVQCEYII-YrMZpzUu.js → gitGraphDiagram-PVQCEYII-DCxvMAUJ.js} +1 -1
  258. package/dist/domains/dashboard/web/assets/index-Bk1o-4VO.css +1 -0
  259. package/dist/domains/dashboard/web/assets/{index-icxk8_BP.js → index-Blit0P5Z.js} +1 -1
  260. package/dist/domains/dashboard/web/assets/index-g8vyW0R_.js +257 -0
  261. package/dist/domains/dashboard/web/assets/{infoDiagram-5YYISTIA-CcIgGK_7.js → infoDiagram-5YYISTIA-9qXEkzDe.js} +1 -1
  262. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-1x3rNjGP.js → ishikawaDiagram-YF4QCWOH-Dkf5othW.js} +1 -1
  263. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-B2XiqMNP.js → journeyDiagram-JHISSGLW-C2_IkO4s.js} +1 -1
  264. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-x46cGuo3.js → kanban-definition-UN3LZRKU-BxWgu4DL.js} +1 -1
  265. package/dist/domains/dashboard/web/assets/{linear-DFLqGZWl.js → linear-Dkr6p-Ro.js} +1 -1
  266. package/dist/domains/dashboard/web/assets/{mermaid.core-g3J6BACc.js → mermaid.core-DZUcsoG4.js} +4 -4
  267. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CTdeKmcX.js → mindmap-definition-RKZ34NQL-C9xyxGfa.js} +1 -1
  268. package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-C_obwjIf.js → pieDiagram-4H26LBE5-Dn67tdOF.js} +1 -1
  269. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-B6Gnfz9M.js → quadrantDiagram-W4KKPZXB-Cy6iOcxc.js} +1 -1
  270. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-nX4PObnB.js → requirementDiagram-4Y6WPE33-B_gZONhx.js} +1 -1
  271. package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-QjDwwHgl.js → sankeyDiagram-5OEKKPKP-C3u-4dOk.js} +1 -1
  272. package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK-BEEe0j6B.js → sequenceDiagram-3UESZ5HK-Xd3ByTVF.js} +1 -1
  273. package/dist/domains/dashboard/web/assets/{stateDiagram-AJRCARHV-CXfAaBgM.js → stateDiagram-AJRCARHV-CJGHL7Up.js} +1 -1
  274. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-rKvBgr6I.js +1 -0
  275. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-BOzX2EnD.js → timeline-definition-PNZ67QCA-DvONX2YQ.js} +1 -1
  276. package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-C40vhXRq.js → vennDiagram-CIIHVFJN-B-L4qWy4.js} +1 -1
  277. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-B1rm89JH.js → wardleyDiagram-YWT4CUSO-cf39WX2o.js} +1 -1
  278. package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-BlMr59qK.js → xychartDiagram-2RQKCTM6-Dk1vcm3u.js} +1 -1
  279. package/dist/domains/dashboard/web/index.html +2 -2
  280. package/dist/domains/factory/package.d.ts.map +1 -1
  281. package/dist/domains/factory/package.js +7 -22
  282. package/dist/domains/factory/package.js.map +1 -1
  283. package/dist/domains/skill/hook-lifecycle.d.ts +9 -0
  284. package/dist/domains/skill/hook-lifecycle.d.ts.map +1 -0
  285. package/dist/domains/skill/hook-lifecycle.js +48 -0
  286. package/dist/domains/skill/hook-lifecycle.js.map +1 -0
  287. package/dist/domains/skill/platform-inspect.d.ts +2 -0
  288. package/dist/domains/skill/platform-inspect.d.ts.map +1 -1
  289. package/dist/domains/skill/platform-inspect.js +170 -32
  290. package/dist/domains/skill/platform-inspect.js.map +1 -1
  291. package/dist/domains/skill/platform-install.d.ts +21 -1
  292. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  293. package/dist/domains/skill/platform-install.js +142 -31
  294. package/dist/domains/skill/platform-install.js.map +1 -1
  295. package/dist/domains/skill/project-hook-projection.d.ts +14 -0
  296. package/dist/domains/skill/project-hook-projection.d.ts.map +1 -0
  297. package/dist/domains/skill/project-hook-projection.js +41 -0
  298. package/dist/domains/skill/project-hook-projection.js.map +1 -0
  299. package/dist/domains/skill/project-instructions.d.ts +3 -0
  300. package/dist/domains/skill/project-instructions.d.ts.map +1 -1
  301. package/dist/domains/skill/project-instructions.js +8 -0
  302. package/dist/domains/skill/project-instructions.js.map +1 -1
  303. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  304. package/dist/domains/skill/uninstall.js +50 -11
  305. package/dist/domains/skill/uninstall.js.map +1 -1
  306. package/dist/domains/workflow-contract/global-config.d.ts +10 -0
  307. package/dist/domains/workflow-contract/global-config.d.ts.map +1 -0
  308. package/dist/domains/workflow-contract/global-config.js +117 -0
  309. package/dist/domains/workflow-contract/global-config.js.map +1 -0
  310. package/dist/domains/workflow-contract/hook-target-scope.d.ts +6 -0
  311. package/dist/domains/workflow-contract/hook-target-scope.d.ts.map +1 -0
  312. package/dist/domains/workflow-contract/hook-target-scope.js +51 -0
  313. package/dist/domains/workflow-contract/hook-target-scope.js.map +1 -0
  314. package/dist/domains/workflow-contract/index.d.ts +1 -0
  315. package/dist/domains/workflow-contract/index.d.ts.map +1 -1
  316. package/dist/domains/workflow-contract/index.js +1 -0
  317. package/dist/domains/workflow-contract/index.js.map +1 -1
  318. package/dist/domains/workflow-contract/types.d.ts +3 -0
  319. package/dist/domains/workflow-contract/types.d.ts.map +1 -1
  320. package/dist/platform/paths/git-worktree.d.ts +4 -1
  321. package/dist/platform/paths/git-worktree.d.ts.map +1 -1
  322. package/dist/platform/paths/git-worktree.js +34 -1
  323. package/dist/platform/paths/git-worktree.js.map +1 -1
  324. package/eval/local/tests/scaffold/test_utils.py +74 -0
  325. package/eval/scaffold/shell/docker.sh +5 -0
  326. package/package.json +7 -5
  327. package/dist/domains/dashboard/web/assets/channel-b2wWDG4F.js +0 -1
  328. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-B9SWZywo.js +0 -1
  329. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-B9SWZywo.js +0 -1
  330. package/dist/domains/dashboard/web/assets/index-DhtBssCt.js +0 -257
  331. package/dist/domains/dashboard/web/assets/index-pr3axVDI.css +0 -1
  332. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-CD3nS4cC.js +0 -1
@@ -48,7 +48,7 @@ Every path compiles to one Workflow Contract:
48
48
  4. Show confirmation: list each Node, bound Skill, Required Skill Call, Output Schema, executable disclosure, and readiness impact. The confirmation must show enforcement for each new binding or schema: `guarded`, `handoff-guarded`, `evidence-only`, or `advisory`.
49
49
  5. Wait for confirmation: do not write a Bundle draft before confirmation; pause for missing or ambiguous Skills.
50
50
  6. Initialize backend state: after confirmation, call `comet creator init <name> --file <plan.json> --confirmed-proposal --json`.
51
- 7. Run the authoring pipeline and generate the Bundle: run `comet creator authoring-plan <name> --depth quick|full --json` for the lane DAG. Dispatch lanes by the DAG — wave1 (`script`, `reference`, `pause-points`) in parallel where the platform supports subagents (otherwise inline, in dependency order), wave2 (`workflow-entry`, `skill-core`) after the script contract, and `skill-review` as the barrier. Record each lane via `comet creator authoring-record <name> --lane <id> --file <out.json> --json` (schema-validated; BLOCKED/NEEDS_CONTEXT is rejected). Then run `comet creator generate <name> --json`; it merges recorded content-leaf drafts (entry/node SKILL.md, decision-points, recovery) into the package while the deterministic backbone (protocol/scripts/manifest) stays templated, and renders real review evidence. Outputs entry Skill, Node Skills, `reference/workflow-protocol.json`, the six scripts, rules, hooks, and `comet/eval.yaml`.
51
+ 7. Run the authoring pipeline and generate the Bundle: run `comet creator authoring-plan <name> --depth quick|full --json` for the lane DAG. Dispatch lanes by the DAG — dispatch wave1 (`script`, `reference`, `pause-points`) in parallel, dispatch wave2 (`workflow-entry`, `skill-core`) in parallel after the script contract, and run `skill-review` as the barrier. Record each lane via `comet creator authoring-record <name> --lane <id> --file <out.json> --json` (schema-validated; BLOCKED/NEEDS_CONTEXT is rejected). Then run `comet creator generate <name> --json`; it merges recorded content-leaf drafts (entry/node SKILL.md, decision-points, recovery) into the package while the deterministic backbone (protocol/scripts/manifest) stays templated, and renders real review evidence. Outputs entry Skill, Node Skills, `reference/workflow-protocol.json`, the six scripts, rules, hooks, and `comet/eval.yaml`.
52
52
  8. Validate: show quick/full eval workload and run or record current draft hash eval evidence; failed eval, skipped eval, or stale-hash evidence cannot become ready.
53
53
  9. Review readiness: read `comet publish review <name> --platform <reference-platform> --json` and show `Readiness:`, `Blockers:`, `Warnings:`, and `Evidence:`.
54
54
  10. Publish and install preview: publish only after human approval; installation must start with preview and show `No files were written`.
@@ -2,14 +2,10 @@
2
2
 
3
3
  ## Core Principles
4
4
 
5
- `/comet-any` authoring outputs should be drafted by platform-native subagents, then assembled and recorded by the main session through the backend CLI. Claude Code, Codex, Gemini, Copilot, and other platforms expose subagents differently; this reference defines responsibilities, inputs, and outputs, not a provider-specific dispatch API.
6
-
7
- `reference/subagents/*.md` are portable lane briefs; Claude Code custom agents must be generated separately as platform agent resources with `name`, `description`, `tools`, and `model` frontmatter. Do not install these portable lane briefs directly as platform-native custom agent resources.
5
+ `/comet-any` authoring outputs are drafted by six responsibility-specific subagents, then assembled and recorded by the main session through the backend CLI. The main session dispatches a fresh subagent for every lane in the authoring DAG and supplies the matching `reference/subagents/*.md` file as that role's brief.
8
6
 
9
7
  Read this overview first, then give only the matching role brief to each subagent. Do not merge the six role briefs into one large prompt. The main session keeps global context, aggregates outputs, and calls `comet bundle` and `comet publish`; subagents only produce reviewable drafts.
10
8
 
11
- When the platform supports subagents, dispatch is required. If no platform subagent capability exists, the main session may execute the same briefs inline, but must mark that path as fallback in the user-facing summary and `reference/authoring-lanes.json`.
12
-
13
9
  All subagents only return Markdown outputs and structured review findings. They must not write Bundle state directly, execute candidate Skill scripts, or run publish, install, or distribution commands. CLI state remains owned by the main session.
14
10
 
15
11
  ## Role Briefs
@@ -38,15 +34,13 @@ Subagent outputs first become reviewable drafts, then flow into `reference/autho
38
34
 
39
35
  The Role Briefs order above is a linearization of the authoring DAG, not a mandate to run strictly sequential. The authoritative DAG lives in `reference/authoring-protocol.json` and `comet creator authoring-plan <name> --depth quick|full --json`:
40
36
 
41
- - **wave1** (`script`, `reference`, `pause-points`): no dependencies on each other. On platforms that expose subagents, dispatch these three concurrently. Each gets only its own role brief, common input, and the protocol/resolved-skills paths (file handoff, no shared history).
37
+ - **wave1** (`script`, `reference`, `pause-points`): no dependencies on each other. Dispatch these three concurrently. Each gets only its own role brief, common input, and the protocol/resolved-skills paths (file handoff, no shared history).
42
38
  - **wave2** (`workflow-entry`, `skill-core`): depend on the script contract (`NEXT:`/`SKILL:` outputs). Start only after the script lane is DONE. The two may run concurrently with each other.
43
39
  - **barrier** (`skill-review`): the single synchronization point. Run only after wave1 and wave2 are all DONE; the reviewer must read every artifact and claim.
44
40
 
45
- Regardless of platform:
41
+ Dispatch rules:
46
42
 
47
43
  - Sequencing follows DAG dependencies; only the barrier truly waits for all prior lanes.
48
- - On platforms without subagent capability, the main session runs the same lanes inline in dependency order — semantics are identical, only latency changes. Record `dispatchMode: "subagent"` or `"inline"` per lane in `reference/authoring-lanes.json`.
49
- - Claude Code may delegate a wave's fan-out to its `Workflow` tool as an optional accelerator; this is an implementation choice, not part of the contract. The contract is the protocol + schemas + DAG, which every platform can interpret.
50
44
  - Every lane output is validated and recorded via `comet creator authoring-record <name> --lane <id> --file <out.json> --json` before the next dependent wave begins.
51
45
 
52
46
  ## Common Inputs
@@ -92,11 +86,9 @@ Each subagent returns:
92
86
  ## Dispatch Notes
93
87
 
94
88
  - Create a fresh subagent for every dispatch; do not inherit main-session history. The main session provides only the role brief, input paths, and necessary background for that role.
95
- - Explicitly specify a model. If the platform does not support model selection, record `platform-default` in `reference/authoring-lanes.json`.
96
89
  - Use file handoff: provide paths instead of pasting large bodies of text. Common input, resolved Skill summaries, draft artifacts, and reports should move by path.
97
90
  - Each subagent receives only its role brief, common input, and necessary artifacts, not every other role's full brief.
98
91
  - The Skill review subagent must run after the other five author roles and must read all artifacts and claims.
99
92
  - The main session may ask a role to rework its output, but the rework still returns to `reference/authoring-lanes.json` and `reference/skill-review.md`.
100
93
  - Subagents cannot call `comet bundle`, `comet publish`, or `comet skill`, and cannot execute candidate Skill scripts.
101
94
  - If a status is `BLOCKED` or `NEEDS_CONTEXT`, the main session must add context, split the task, switch to a stronger model, or ask the user; it must not continue assembly.
102
- - Without platform subagent capability, inline fallback must preserve the same lane, claim, and finding structure.
@@ -1,7 +1,5 @@
1
1
  # Pause Point Author Subagent
2
2
 
3
- This file is a portable lane brief, not a platform-native custom agent. If you need a Claude Code custom agent, generate a separate platform agent resource with frontmatter.
4
-
5
3
  ## Responsibilities
6
4
 
7
5
  Design only the places where the user genuinely must choose, plus cross-device recovery. First distinguish four categories: user decision, automatic handling, stop condition, and manual handoff. Create a user pause only when two or more valid options change scope, behavior, accepted risk, or an irreversible outcome. Execute a sole safe action directly, report a missing dependency or corrupt state as a stop condition, and return control for a manual handoff. Genuine user decisions cannot be bypassed by defaults, historical preferences, or automatic advancement.
@@ -24,11 +22,10 @@ Use file handoff: the main session provides paths instead of pasting large bodie
24
22
 
25
23
  ## Dispatch Template
26
24
 
27
- Use the current platform's subagent mechanism. The shape should include:
25
+ Dispatch a fresh subagent for this role with:
28
26
 
29
27
  ```text
30
28
  description: "Design user pause points and recovery for <bundle-name>"
31
- model: <must explicitly specify model>
32
29
  prompt:
33
30
  You are the pause point author subagent.
34
31
  First read this brief, the common input path, workflow protocol path, Skill draft path, and report file path.
@@ -1,7 +1,5 @@
1
1
  # Reference Author Subagent
2
2
 
3
- This file is a portable lane brief, not a platform-native custom agent. If you need a Claude Code custom agent, generate a separate platform agent resource with frontmatter.
4
-
5
3
  ## Responsibilities
6
4
 
7
5
  Write and organize the generated Skill's reference layer so audit, recovery, review, and future maintenance have real evidence. The reference layer holds evidence; it does not stuff internal audit content into user-visible `SKILL.md`.
@@ -26,11 +24,10 @@ Use file handoff: the main session provides paths instead of pasting large bodie
26
24
 
27
25
  ## Dispatch Template
28
26
 
29
- Use the current platform's subagent mechanism. The shape should include:
27
+ Dispatch a fresh subagent for this role with:
30
28
 
31
29
  ```text
32
30
  description: "Organize reference evidence for <bundle-name>"
33
- model: <must explicitly specify model>
34
31
  prompt:
35
32
  You are the reference author subagent.
36
33
  First read this brief, the common input path, resolved skills path, workflow protocol path, and report file path.
@@ -1,7 +1,5 @@
1
1
  # Script Author Subagent
2
2
 
3
- This file is a portable lane brief, not a platform-native custom agent. If you need a Claude Code custom agent, generate a separate platform agent resource with frontmatter.
4
-
5
3
  ## Responsibilities
6
4
 
7
5
  Design the generated Skill's script contract instead of copying Comet Classic scripts. Scripts must use the current workflow protocol, user-selected Node labels, and real composed Skill outputs to define automatic advancement, exit checks, recovery, and evidence recording.
@@ -28,11 +26,10 @@ Use file handoff: the main session provides paths instead of pasting large bodie
28
26
 
29
27
  ## Dispatch Template
30
28
 
31
- Use the current platform's subagent mechanism. The shape should include:
29
+ Dispatch a fresh subagent for this role with:
32
30
 
33
31
  ```text
34
32
  description: "Write the script contract for <bundle-name>"
35
- model: <must explicitly specify model>
36
33
  prompt:
37
34
  You are the script author subagent.
38
35
  First read this brief, the common input path, workflow protocol path, resolved skills path, and report file path.
@@ -1,7 +1,5 @@
1
1
  # Skill Core Author Subagent
2
2
 
3
- This file is a portable lane brief, not a platform-native custom agent. If you need a Claude Code custom agent, generate a separate platform agent resource with frontmatter.
4
-
5
3
  ## Responsibilities
6
4
 
7
5
  Write the user-visible core content for internal Node Skills. The entry Skill is owned separately by the workflow entry author. The goal is a Comet-like multi-Node workflow, not a simple chain of source Skills or a copied source Skill body.
@@ -69,11 +67,10 @@ Use file handoff: the main session provides paths instead of pasting large bodie
69
67
 
70
68
  ## Dispatch Template
71
69
 
72
- Use the current platform's subagent mechanism. The shape should include:
70
+ Dispatch a fresh subagent for this role with:
73
71
 
74
72
  ```text
75
73
  description: "Write Skill core content for <bundle-name>"
76
- model: <must explicitly specify model>
77
74
  prompt:
78
75
  You are the Skill core author subagent.
79
76
  First read this brief, the common input path, script contract path, reference evidence path, and report file path.
@@ -1,7 +1,5 @@
1
1
  # Skill Review Subagent
2
2
 
3
- This file is a portable lane brief, not a platform-native custom agent. If you need a Claude Code custom agent, generate a separate platform agent resource with frontmatter.
4
-
5
3
  ## Responsibilities
6
4
 
7
5
  Review the other subagents' artifacts and claims, then decide whether the candidate Skill is usable like Comet. The review must give a clear conclusion: `Review passed` or blocking findings.
@@ -19,11 +17,10 @@ Use file handoff: the main session provides paths instead of pasting large bodie
19
17
 
20
18
  ## Dispatch Template
21
19
 
22
- Use the current platform's subagent mechanism. The shape should include:
20
+ Dispatch a fresh subagent for this role with:
23
21
 
24
22
  ```text
25
23
  description: "Review the Comet-like Skill outputs for <bundle-name>"
26
- model: <must explicitly specify model>
27
24
  prompt:
28
25
  You are the Skill review subagent.
29
26
  First read this brief, the common input path, five author report paths, artifact paths, claim list, and report file path.
@@ -1,7 +1,5 @@
1
1
  # Workflow Entry Author Subagent
2
2
 
3
- This file is a portable lane brief, not a platform-native custom agent. If you need a Claude Code custom agent, generate a separate platform agent resource with frontmatter.
4
-
5
3
  ## Responsibilities
6
4
 
7
5
  Write the generated Skill's entry `SKILL.md`. The entry owns the entry point, recovery, main router explanation, and user pause points; it must not turn the Node route table into an execution checklist that immediately triggers multiple Skills.
@@ -41,11 +39,10 @@ Use file handoff: the main session provides paths instead of pasting large bodie
41
39
 
42
40
  ## Dispatch Template
43
41
 
44
- Use the current platform's subagent mechanism. The shape should include:
42
+ Dispatch a fresh subagent for this role with:
45
43
 
46
44
  ```text
47
45
  description: "Write the workflow entry for <bundle-name>"
48
- model: <must explicitly specify model>
49
46
  prompt:
50
47
  You are the workflow entry author subagent.
51
48
  First read this brief, the common input path, script contract path, workflow protocol path, and report file path.
@@ -79,7 +79,7 @@ comet state set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md
79
79
 
80
80
  No manual phase update needed — guard auto-transitions when exit conditions are met.
81
81
 
82
- When presenting the joint decision, provide every workspace-isolation and execution choice supported by this workflow. Do not preflight, infer, or filter whether another Skill, branch, worktree, subagent dispatch, or model selection can be used. After the user chooses, run the corresponding action; if it fails, stop and report the original error. If a field has only one workflow-valid value, explain why and apply it without manufacturing another pause.
82
+ When presenting the joint decision, provide every workspace-isolation and execution choice supported by this workflow. After the user chooses, run the corresponding action; if it fails, stop and report the original error. If a field has only one workflow-valid value, explain why and apply it without manufacturing another pause.
83
83
 
84
84
  After recording the plan, provide exactly **one joint decision point** that collects whether to continue now, workspace isolation, execution method, TDD mode, and code review mode. The branch name must be confirmed in the same Step 2 joint decision when `branch` is selected. Do not ask continue/pause first and then create another configuration or naming blocker.
85
85
 
@@ -134,7 +134,7 @@ The plan is on the current branch. These settings are all part of the single Ste
134
134
  | Option | Skill | Applicable Scenario |
135
135
  |------|------|-------------------|
136
136
  | A | Superpowers `subagent-driven-development` | Independent tasks, high complexity; each task runs in an isolated implementer subagent with review driven by `review_mode` |
137
- | B | Superpowers `executing-plans` | Simple tasks, no subagent environment, lightweight and fast |
137
+ | B | Superpowers `executing-plans` | The main session executes the plan sequentially; suitable for fewer or tightly coupled tasks |
138
138
 
139
139
  **Execution method recommendation rules**:
140
140
  - Task count ≥ 3 → Recommend A
@@ -29,26 +29,73 @@ Common commands:
29
29
  comet native status [--json]
30
30
  comet native show <change-name>
31
31
  comet native select <change-name>
32
- comet native new <change-name> [--language en|zh-CN]
32
+ comet native new <change-name> [--language en|zh-CN] [--isolation current|branch|worktree]
33
33
  comet native next <change-name> --summary <text> [--confirmed]
34
34
  comet native archive <change-name> --dry-run
35
35
  ```
36
36
 
37
37
  ## Start or resume
38
38
 
39
- 1. Run `comet native status` to identify the current change and phase.
40
- 2. Run `comet native show <change-name>` for the target. In Verify, Archive, or Build after a failure, also run the status command with `--details`.
41
- 3. When more acceptance items are needed, follow `acceptancePage.nextCursor`. If findings are truncated, handle the returned findings and then read details again.
42
- 4. After confirming the target, run `comet native select <change-name>`.
39
+ 1. In a Git project, first read the current branch and `git worktree list --porcelain`. Run read-only `comet native status --project-root <path> --json` for every safely accessible working directory. This is default discovery; do not wait for the user to say “parallel.”
40
+ 2. Run `comet native status` in the current working directory and combine it with the other working-directory results to identify the target change, its owning working directory, and phase. If a matching active change exists, resume in that working directory instead of creating another one.
41
+ 3. Run `comet native show <change-name>` for the target. In Verify, Archive, or Build after a failure, also run the status command with `--details`.
42
+ 4. When more acceptance items are needed, follow `acceptancePage.nextCursor`. If findings are truncated, handle the returned findings and then read details again.
43
+ 5. Enter the target's actual working directory and run `comet native select <change-name>`. Do not require the user to run `cd` manually.
43
44
 
44
- If multiple reasonable candidates remain, ask the user to select one. Create a change only after confirming that no matching active change exists:
45
+ If multiple reasonable candidates remain, ask the user to select one. Create a change only after confirming that no matching active change exists in any discovered working directory, then follow the workspace protocol below.
46
+
47
+ Use only the Native artifact root selected by project configuration.
48
+
49
+ ## Workspace protocol for a new change
50
+
51
+ The parallelism unit is a change: separate changes may progress concurrently in separate working directories. One change is writable only from its bound working directory and current execution context; Native does not create a long-lived session lease.
52
+
53
+ Before creation, inspect the current branch, uncommitted changes, active Native changes in the current directory, and registered Git worktrees. Keep three workspace modes:
54
+
55
+ - `current`: keep the current branch and directory;
56
+ - `branch`: create and switch to a change branch in the current directory;
57
+ - `worktree`: create a separate change branch and Git working directory, then continue there.
58
+
59
+ Selection rules:
60
+
61
+ - When the current directory is clean and no discovered working directory has another active change, default directly to `current`; do not ask whether the user wants “parallel” work.
62
+ - When uncommitted changes or other facts make isolation materially affect the user's directory, present one joint `current / branch / worktree` choice with the recommendation, branch, and working-directory path. Do not split it into a separate “parallel?” question.
63
+ - When another active Native change owns the current directory, disclose that `current` and `branch` are unavailable because of baseline-drift risk, then use the only safe `worktree` mode. Active changes already in other worktrees do not disable `current` or `branch` here.
64
+ - In the same choice, the user may override the default branch `comet/<change-name>` and directory `.worktrees/<change-name>`. On a path or branch collision, stop; do not add a random suffix or take over a directory that is not already legally bound to this change.
65
+
66
+ Prepare `branch` or `worktree` before running `new` and before the baseline is captured. The target branch defaults to the starting branch at the moment the branch or worktree is created:
45
67
 
46
68
  ```text
47
- comet native new <change-name> \
48
- --language en
69
+ # current
70
+ comet native new <change-name> --language en --isolation current
71
+
72
+ # branch: create and switch branches first
73
+ comet native new <change-name> --language en \
74
+ --isolation branch --change-branch comet/<change-name> --target-branch <starting-branch>
75
+
76
+ # worktree: create and enter .worktrees/<change-name> first
77
+ comet native new <change-name> --language en \
78
+ --isolation worktree --change-branch comet/<change-name> --target-branch <starting-branch>
49
79
  ```
50
80
 
51
- Use only the Native artifact root selected by project configuration.
81
+ Before creating a worktree, add `.worktrees/` to the repository-local Git exclude in the Git common directory's `info/exclude`; do not modify tracked `.gitignore` for this. The Agent continues automatically in the new working directory instead of handing navigation to the user.
82
+
83
+ Create the worktree from the resolved commit of a verified local target branch. If the source directory has uncommitted content, attribute it first: leave work proven unrelated to the new change in place; if content may belong to the new change and cannot enter through that commit, wait for the user to decide how to preserve it rather than silently committing, copying, or omitting it. The target directory must receive consistent configuration from the target branch or establish legal configuration through public `comet native init`, then verify artifact-root, language, clarification, archive, verify, and snapshot semantics. Stop when consistency cannot be proven. Never copy the source `.comet/current-change.json`.
84
+
85
+ After the target configuration is ready and before running `new`, the Agent must run these commands in the new working directory:
86
+
87
+ ```bash
88
+ comet doctor --repair --scope project
89
+ comet doctor --scope project --json
90
+ ```
91
+
92
+ Continue only when Doctor confirms that the Hook runtime is current, the platform has exactly one Router rooted in the target project, and no legacy or duplicate Comet Hook remains. The Agent runs these commands in the new working directory without asking the user to enter it manually, and never copies `.comet/current-change.json` from the source directory. If the target branch did not provide project configuration, first use the public `comet native init` command to establish the source project's verified semantics, then run the Doctor sequence above.
93
+
94
+ If worktree creation completes only some steps, stop immediately and report the original error, target branch and path, every branch/worktree/exclude/config/change resource known to have been created, and the recoverable next action. Clean up only resources proven to be newly created by this operation and safe to remove. Preserve the scene when ownership is uncertain; never remove an existing or possibly user-owned worktree, branch, or file.
95
+
96
+ Runtime rechecks for a newly active change inside the same mutation lock used by `new`. If a system-default `current` loses this race and returns `workspace-isolation-required`, automatically prepare the default worktree and retry there. If an explicit user choice becomes invalid before execution, stop and reconfirm rather than silently changing modes.
97
+
98
+ Existing active changes without a workspace v3 binding remain compatible: do not generate worktrees, move files, or refresh their baselines automatically. Continue selecting only one change at a time in a shared legacy directory. Only real baseline or scope drift fails closed and requires the user to decide whether to recover, recreate, or abandon the change.
52
99
 
53
100
  ## On-demand loading
54
101
 
@@ -110,16 +157,34 @@ Use acceptance IDs and receipts returned by the Runtime. Read the artifact and c
110
157
 
111
158
  Submit `pass` only when the Runtime accepts the complete, fresh acceptance matrix and required checks. Reverify after relevant implementation, specification, report, or evidence changes.
112
159
 
160
+ When submitting Verify, pass only `--result` and `--report`; `next` does not accept `--receipt` or caller-supplied required-check arguments. The Runtime validates the report format, complete acceptance matrix, and acceptance receipts before it runs or reuses the built-in required check for the current scope. If the report is invalid, fix it before retrying instead of submitting the same `next` command repeatedly.
161
+
113
162
  `fail` returns to Build. Fix the failed or missing acceptance items and failed checks reported by the Runtime before verifying again; another `next` call is not itself a repair. For `repair-stagnation-stop`, follow the recovery reference to form a new hypothesis and use the Runtime-provided override. Wait for the user only when the continuation requires `repair-continuation-decision`.
114
163
 
115
164
  An intermediate Verify failure never runs Archive or triggers archive confirmation. Continue Build → Verify until pass, a Runtime block, or a required user decision.
116
165
 
117
166
  ## Archive
118
167
 
119
- Preview only after the final Verify pass:
168
+ Prepare Archive only after the final Verify pass. First read the change's workspace binding; treat legacy workspace metadata as `current` for compatibility.
169
+
170
+ `current` continues to use `native.archive_confirmation` without a separate branch-finishing question. Before Archive, `branch` or `worktree` requires one joint choice:
171
+
172
+ 1. archive and merge locally into the bound target branch;
173
+ 2. archive and push the change branch;
174
+ 3. archive, push, and open a PR;
175
+ 4. archive and keep the current branch/working directory;
176
+ 5. do not archive yet.
177
+
178
+ Show the exact change branch, target branch, and working directory. Recommend one option based on whether the target branch is locally available and its working directory is clean. Execute external Git actions only after the user chooses; preserve the scene and stop on “do not archive.”
179
+
180
+ Then preview:
120
181
 
121
182
  ```text
183
+ # current
122
184
  comet native archive <change-name> --dry-run
185
+
186
+ # branch / worktree: persist the joint choice in formal workspace metadata
187
+ comet native archive <change-name> --dry-run --finish merge|push|pull-request|keep
123
188
  ```
124
189
 
125
190
  After a successful preview:
@@ -129,6 +194,15 @@ After a successful preview:
129
194
 
130
195
  Do not reuse an old preflight. If facts drift or a canonical conflict or unfinished transaction appears, follow the continuation and the recovery reference.
131
196
 
197
+ The returned `workspaceFinish` must match the user's choice. Later sessions recover that decision from formal workspace metadata without another routine prompt. After Archive succeeds, stage and commit only confirmed implementation, specification, and Archive paths owned by this change; exclude unrelated user work. The preceding joint choice authorizes this one exact stage/commit and the selected finishing action:
198
+
199
+ - Local merge: merge the change branch in the bound target branch's working directory and run post-merge validation proportional to the change risk. On success, remove the clean change worktree and the merged local branch. Preserve both on any failure.
200
+ - Push: push the change branch. On success, a clean change worktree may be removed, but retain the local and remote branches.
201
+ - Push and PR: after pushing, create the PR with the workspace's persisted `targetBranch` as its base instead of inferring the repository default branch, then apply the push cleanup. Native does not continuously monitor the PR.
202
+ - Keep: retain the branch and working directory after committing; do not merge or push.
203
+
204
+ Archive multiple changes independently. Only local merges that update the same target ref must be serialized. Resolve a conflict automatically only when the resolution mechanically preserves both confirmed contracts, then revalidate. Abort any semantic conflict and ask whether to create a separate integration change; never silently overwrite either side.
205
+
132
206
  ## Continuation and stop points
133
207
 
134
208
  Shape, Build, and Verify transitions return `next: auto | manual` together with `continuation.disposition: continue | await-user | blocked | done`, required inputs, and the next action. Archive does not advance through `next`; a successful archive returns `done`. After every transition, act on that Runtime continuation:
@@ -140,6 +214,6 @@ Shape, Build, and Verify transitions return `next: auto | manual` together with
140
214
 
141
215
  `next: auto` means only that the current transition succeeded; later work has not run automatically. If the caller explicitly requests a stop after a transition, update the formal artifacts, run the one allowed transition, make no tool calls after the transition succeeds, then output the agreed marker and end the turn, even when the continuation is `continue`.
142
216
 
143
- `workspace-root-changed` and `workspace-inspection-unavailable` are read-only advisories and do not block progression or Archive by themselves. Unknown workspace-integrity findings, confirmed conflicts, stale evidence, and repair stops must be resolved; when the Runtime requires workspace identity repair, run read-only doctor and then follow its explicit `doctor --repair` report.
217
+ For legacy metadata, `workspace-root-changed` and `workspace-inspection-unavailable` are read-only advisories and do not block progression or Archive by themselves. `workspace-binding-root-changed`, `workspace-branch-changed`, `workspace-kind-changed`, and `workspace-vcs-unavailable` mean a new binding is invalid; return to the bound working directory and branch or stop for recovery. Other unknown workspace-integrity findings, confirmed conflicts, stale evidence, and repair stops must also be resolved. When the Runtime requires workspace identity repair, run read-only doctor and then follow its explicit `doctor --repair` report.
144
218
 
145
219
  Never place tokens, passwords, private keys, connection strings, or other credentials in summaries, reasons, reports, or artifacts.
@@ -13,7 +13,9 @@ The Agent primarily edits:
13
13
  verification.md
14
14
  ```
15
15
 
16
- Project configuration, current selection, and change state are read inputs. Do not manually change Runtime-managed phase, confirmation, specification operations, scope, evidence, checkpoints, locks, or transaction fields.
16
+ Project configuration, the current change, change state, and `runtime/workspace.json` are read inputs. Do not manually change Runtime-managed phase, confirmation, specification operations, workspace bindings, scope, evidence, checkpoints, locks, or transaction fields.
17
+
18
+ For a new change, `comet.native.workspace.v3` records `isolation`, `changeBranch`, `targetBranch`, the finishing choice persisted by `--finish` before Archive, and physical directory identity. It supports cross-session recovery and write protection; it is not a session lease. Legacy v1/v2 metadata remains compatible and must not be manually migrated merely to enable isolation.
17
19
 
18
20
  The Native artifact root is selected only by `.comet/config.yaml`. Do not scan another workflow's directories or create a second state root.
19
21
 
@@ -61,10 +61,17 @@ After selecting, reread `status <change-name>`, confirm the phase, and then load
61
61
  ### Create a new change
62
62
 
63
63
  ```text
64
- comet native new <change-name> [--language en|zh-CN]
64
+ comet native new <change-name> [--language en|zh-CN] \
65
+ [--isolation current|branch|worktree] \
66
+ [--change-branch <branch>] \
67
+ [--target-branch <branch>]
65
68
  ```
66
69
 
67
- Run `new` only after confirming that no matching active change exists. When configuration is absent, it creates the default Native configuration and `docs/comet/`; it then creates a Shape change, makes it the current selection, and returns a continuation.
70
+ Run `new` only after scanning registered working directories and confirming that no matching active change exists. When configuration is absent, it creates the default Native configuration and `docs/comet/`; it then creates a Shape change, makes it current, and returns a continuation plus the workspace binding.
71
+
72
+ `--isolation` defaults to `current`. For `branch` and `worktree`, the Agent first creates and enters the actual branch or worktree and passes the starting `--target-branch`; Runtime checks `--change-branch` against the current branch. `worktree` creation is accepted only in a linked Git worktree. A new change records its workspace mode, change branch, target branch, and physical working-directory identity; subsequent writes must remain aligned.
73
+
74
+ Exit code `73` with `error.code: workspace-isolation-required` means another active change appeared in the same working directory under the `new` mutation lock. Retry automatically in a new worktree only when the original mode was the system-default `current`. Reconfirm if an explicit user choice became invalid.
68
75
 
69
76
  Immediately run `show <change-name>` and `status <change-name>`, then enter Shape clarification and shared-understanding confirmation. Do not create a new change to bypass a blocker, conflict, or recovery problem in an existing change.
70
77
 
@@ -98,6 +105,8 @@ A checkpoint stores only recovery context and real artifact references. It does
98
105
 
99
106
  `evidence format` reads acceptance entries from stdin or `--entries` and emits the canonical machine block for `verification.md`.
100
107
 
108
+ When submitting `pass`, the Runtime validates the report format, complete acceptance matrix, and acceptance receipts before it runs or reuses the built-in required check for the current scope. Fix `verification.md` from the reported error before retrying; do not repeatedly submit the same `next` command. `next` does not accept `--receipt`, and callers do not provide the required-check receipt.
109
+
101
110
  ## Acceptance receipts
102
111
 
103
112
  Automated validation:
@@ -113,7 +122,7 @@ Manual observation:
113
122
 
114
123
  ```text
115
124
  comet native receipt manual <change-name> \
116
- --acceptance <id> \
125
+ --acceptance <id>... \
117
126
  --step <text> \
118
127
  --observation <text>
119
128
  ```
@@ -144,16 +153,16 @@ comet native next <change-name> --summary <text> \
144
153
  [--report <change-relative-path>] \
145
154
  [--override-repair <sha256> --override-summary <text>]
146
155
 
147
- comet native archive <change-name> --dry-run
156
+ comet native archive <change-name> --dry-run [--finish merge|push|pull-request|keep]
148
157
  comet native archive <change-name> --expect-preflight <sha256> [--confirmed]
149
158
  ```
150
159
 
151
160
  - Shape: pass `--confirmed` only after the user confirms the final shared understanding.
152
161
  - Build: provide a real `--artifact`; use `--no-code-reason` only when no project file changed. If changed requirements introduce a new user decision, stay in Build and repeat clarification and confirmation first. After confirmation, update the formal artifacts, then run the transition command returned by the Runtime with `--confirmed`.
153
162
  - Partial scope: explain the exact gaps and risks returned by the Runtime. Changes beyond the returned detail budget are summarized by a `scope-detail-overflow` count and content hash; use the matching scope hash, reason, and `--confirmed` only after the user accepts them.
154
- - Verify: provide `--result` and a complete report. For the standard report path, submit `comet native next <change-name> --summary <summary> --result pass|fail --report verification.md`. On pass, the Runtime runs the built-in required check automatically. Acceptance entries in the report reference automated/manual receipts directly. Executed failures reference their failed receipts, while checks that were not run include a `skipped_reason`. The Runtime derives failed acceptance and check identifiers from the report and receipts.
163
+ - Verify: provide `--result` and a complete report. For the standard report path, submit `comet native next <change-name> --summary <summary> --result pass|fail --report verification.md`. The Runtime validates the report format, complete acceptance matrix, and acceptance receipts before it runs or reuses the built-in required check for the current scope on pass; do not pass `--receipt`. Acceptance entries in the report reference automated/manual receipts directly. Executed failures reference their failed receipts, while checks that were not run include a `skipped_reason`. The Runtime derives failed acceptance and check identifiers from the report and receipts.
155
164
  - Repair override: use only the signature returned by status and only for one explicit new repair hypothesis.
156
- - Archive: dry-run first, then use the exact preflight hash returned by that preview. `required` mode also requires explicit user confirmation.
165
+ - Archive: use a plain dry-run for current isolation. For branch/worktree, after the user makes the joint finishing choice, pass `--finish` to persist it and generate a new preflight. Then use the exact preflight hash returned by that preview. `required` mode also requires explicit user confirmation. Never combine `--finish` with `--expect-preflight`.
157
166
 
158
167
  ## Diagnostics and recovery
159
168
 
@@ -14,7 +14,18 @@ Act only on facts returned by doctor or the continuation. Do not edit state, has
14
14
 
15
15
  ## Workspace advisories
16
16
 
17
- `workspace-root-changed` and `workspace-inspection-unavailable` explain where the current root facts came from; they do not independently block progression or Archive. Do not treat every `workspace-*` finding as advisory: unknown workspace-integrity findings remain errors. When the Runtime requires workspace identity repair, run read-only doctor first and follow its report with explicit `doctor --repair`.
17
+ First use `git worktree list --porcelain` and `comet native status --project-root <path> --json` in each safely accessible directory to find the change's actual working directory. Do not copy an active change directory, recreate the same change in another worktree, or take ownership by editing `workspace.json`.
18
+
19
+ For legacy metadata, `workspace-root-changed` and `workspace-inspection-unavailable` explain where current root facts came from and do not independently block progression or Archive. These new binding errors do block writes:
20
+
21
+ - `workspace-binding-root-changed`: the physical working directory differs from the one that created the change;
22
+ - `workspace-branch-changed`: the current branch differs from the bound change branch;
23
+ - `workspace-kind-changed`: the change is worktree-bound but the directory is no longer a linked worktree;
24
+ - `workspace-vcs-unavailable`: the bound Git working directory is unavailable.
25
+
26
+ Resume and `select` from the registered original working directory. If the directory or branch is genuinely lost, preserve artifacts and run read-only doctor. When Runtime cannot prove a repair, stop and ask the user whether to restore the directory, reconstruct from a trusted backup, or abandon the change. Do not treat every `workspace-*` finding as advisory or refresh the baseline automatically.
27
+
28
+ `workspace-isolation-required` is a creation race. A system-default `current` may automatically retry after preparing a separate worktree; reconfirm when an explicit user choice became invalid.
18
29
 
19
30
  ## Unfinished phase transition
20
31