@rpamis/comet 0.4.0-rc.1 → 0.4.0-rc.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (423) hide show
  1. package/README.md +4 -651
  2. package/assets/manifest.json +1 -1
  3. package/assets/skills/comet/scripts/comet-archive.mjs +80 -80
  4. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +1 -1
  5. package/assets/skills/comet/scripts/comet-guard.mjs +102 -102
  6. package/assets/skills/comet/scripts/comet-handoff.mjs +82 -82
  7. package/assets/skills/comet/scripts/comet-hook-guard.mjs +69 -70
  8. package/assets/skills/comet/scripts/comet-hook-router.mjs +120 -121
  9. package/assets/skills/comet/scripts/comet-intent.mjs +6 -6
  10. package/assets/skills/comet/scripts/comet-resume-probe.mjs +48 -48
  11. package/assets/skills/comet/scripts/comet-runtime.mjs +174 -175
  12. package/assets/skills/comet/scripts/comet-state.mjs +105 -105
  13. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +17 -17
  14. package/assets/skills/comet-native/SKILL.md +6 -5
  15. package/assets/skills/comet-native/reference/commands.md +7 -6
  16. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +124 -118
  17. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +131 -125
  18. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +97 -90
  19. package/assets/skills/comet-native/scripts/comet-native-init.mjs +121 -115
  20. package/assets/skills/comet-native/scripts/comet-native-new.mjs +113 -107
  21. package/assets/skills/comet-native/scripts/comet-native-next.mjs +134 -128
  22. package/assets/skills/comet-native/scripts/comet-native-root.mjs +101 -95
  23. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +166 -159
  24. package/assets/skills/comet-native/scripts/comet-native-select.mjs +114 -108
  25. package/assets/skills/comet-native/scripts/comet-native-show.mjs +98 -92
  26. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +107 -101
  27. package/assets/skills/comet-native/scripts/comet-native-status.mjs +111 -105
  28. package/assets/skills-zh/comet-native/SKILL.md +6 -5
  29. package/assets/skills-zh/comet-native/reference/commands.md +7 -6
  30. package/dist/app/commands/bundle.d.ts.map +1 -1
  31. package/dist/app/commands/bundle.js.map +1 -1
  32. package/dist/app/commands/dashboard.d.ts +1 -1
  33. package/dist/app/commands/dashboard.js +1 -1
  34. package/dist/app/commands/doctor.d.ts.map +1 -1
  35. package/dist/app/commands/doctor.js +1 -1
  36. package/dist/app/commands/doctor.js.map +1 -1
  37. package/dist/app/commands/init.js +2 -2
  38. package/dist/app/commands/init.js.map +1 -1
  39. package/dist/app/commands/platform-select-prompt.d.ts.map +1 -1
  40. package/dist/app/commands/platform-select-prompt.js +1 -0
  41. package/dist/app/commands/platform-select-prompt.js.map +1 -1
  42. package/dist/app/commands/status.d.ts.map +1 -1
  43. package/dist/app/commands/status.js +49 -9
  44. package/dist/app/commands/status.js.map +1 -1
  45. package/dist/app/commands/update.d.ts.map +1 -1
  46. package/dist/app/commands/update.js +13 -49
  47. package/dist/app/commands/update.js.map +1 -1
  48. package/dist/domains/agent-learning/policy-compiler.d.ts.map +1 -1
  49. package/dist/domains/agent-learning/policy-compiler.js.map +1 -1
  50. package/dist/domains/agent-learning/types.d.ts.map +1 -1
  51. package/dist/domains/agent-learning/types.js.map +1 -1
  52. package/dist/domains/bundle/authoring.d.ts.map +1 -1
  53. package/dist/domains/bundle/authoring.js.map +1 -1
  54. package/dist/domains/bundle/next-action.d.ts.map +1 -1
  55. package/dist/domains/bundle/next-action.js.map +1 -1
  56. package/dist/domains/bundle/readiness-user-summary.d.ts.map +1 -1
  57. package/dist/domains/bundle/readiness-user-summary.js.map +1 -1
  58. package/dist/domains/bundle/types.d.ts.map +1 -1
  59. package/dist/domains/comet-classic/classic-archive.d.ts.map +1 -1
  60. package/dist/domains/comet-classic/classic-archive.js +15 -0
  61. package/dist/domains/comet-classic/classic-archive.js.map +1 -1
  62. package/dist/domains/comet-classic/classic-cli.d.ts +8 -0
  63. package/dist/domains/comet-classic/classic-cli.d.ts.map +1 -1
  64. package/dist/domains/comet-classic/classic-cli.js +10 -0
  65. package/dist/domains/comet-classic/classic-cli.js.map +1 -1
  66. package/dist/domains/comet-classic/classic-guard.d.ts.map +1 -1
  67. package/dist/domains/comet-classic/classic-guard.js +20 -0
  68. package/dist/domains/comet-classic/classic-guard.js.map +1 -1
  69. package/dist/domains/comet-classic/classic-handoff.d.ts.map +1 -1
  70. package/dist/domains/comet-classic/classic-handoff.js +13 -0
  71. package/dist/domains/comet-classic/classic-handoff.js.map +1 -1
  72. package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
  73. package/dist/domains/comet-classic/classic-hook-guard.js +14 -15
  74. package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
  75. package/dist/domains/comet-classic/classic-layout-initialization.d.ts.map +1 -1
  76. package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -1
  77. package/dist/domains/comet-classic/classic-output-language.d.ts +73 -0
  78. package/dist/domains/comet-classic/classic-output-language.d.ts.map +1 -0
  79. package/dist/domains/comet-classic/classic-output-language.js +175 -0
  80. package/dist/domains/comet-classic/classic-output-language.js.map +1 -0
  81. package/dist/domains/comet-classic/classic-script-entry.d.ts.map +1 -1
  82. package/dist/domains/comet-classic/classic-script-entry.js +10 -0
  83. package/dist/domains/comet-classic/classic-script-entry.js.map +1 -1
  84. package/dist/domains/comet-classic/classic-state-command.d.ts.map +1 -1
  85. package/dist/domains/comet-classic/classic-state-command.js +43 -4
  86. package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
  87. package/dist/domains/comet-entry/current-selection.d.ts.map +1 -1
  88. package/dist/domains/comet-entry/current-selection.js.map +1 -1
  89. package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
  90. package/dist/domains/comet-entry/init-workflow.js.map +1 -1
  91. package/dist/domains/comet-entry/project-status.d.ts.map +1 -1
  92. package/dist/domains/comet-entry/project-status.js +15 -3
  93. package/dist/domains/comet-entry/project-status.js.map +1 -1
  94. package/dist/domains/comet-entry/types.d.ts +5 -1
  95. package/dist/domains/comet-entry/types.d.ts.map +1 -1
  96. package/dist/domains/comet-memory/personal-memory.d.ts.map +1 -1
  97. package/dist/domains/comet-memory/personal-memory.js.map +1 -1
  98. package/dist/domains/comet-memory/types.d.ts.map +1 -1
  99. package/dist/domains/comet-memory/types.js.map +1 -1
  100. package/dist/domains/comet-native/native-atomic-file.d.ts +1 -0
  101. package/dist/domains/comet-native/native-atomic-file.d.ts.map +1 -1
  102. package/dist/domains/comet-native/native-atomic-file.js +19 -0
  103. package/dist/domains/comet-native/native-atomic-file.js.map +1 -1
  104. package/dist/domains/comet-native/native-children.d.ts +17 -0
  105. package/dist/domains/comet-native/native-children.d.ts.map +1 -1
  106. package/dist/domains/comet-native/native-children.js +86 -9
  107. package/dist/domains/comet-native/native-children.js.map +1 -1
  108. package/dist/domains/comet-native/native-cli-help.d.ts.map +1 -1
  109. package/dist/domains/comet-native/native-cli-help.js +3 -2
  110. package/dist/domains/comet-native/native-cli-help.js.map +1 -1
  111. package/dist/domains/comet-native/native-cli-shared.d.ts +7 -1
  112. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -1
  113. package/dist/domains/comet-native/native-cli-shared.js +51 -4
  114. package/dist/domains/comet-native/native-cli-shared.js.map +1 -1
  115. package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
  116. package/dist/domains/comet-native/native-cli.js +4 -2
  117. package/dist/domains/comet-native/native-cli.js.map +1 -1
  118. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  119. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  120. package/dist/domains/comet-native/native-lock.d.ts.map +1 -1
  121. package/dist/domains/comet-native/native-lock.js +10 -1
  122. package/dist/domains/comet-native/native-lock.js.map +1 -1
  123. package/dist/domains/comet-native/native-loop-runtime.d.ts +4 -1
  124. package/dist/domains/comet-native/native-loop-runtime.d.ts.map +1 -1
  125. package/dist/domains/comet-native/native-loop-runtime.js +39 -6
  126. package/dist/domains/comet-native/native-loop-runtime.js.map +1 -1
  127. package/dist/domains/comet-native/native-next-command.d.ts.map +1 -1
  128. package/dist/domains/comet-native/native-next-command.js +36 -2
  129. package/dist/domains/comet-native/native-next-command.js.map +1 -1
  130. package/dist/domains/comet-native/native-output-language.d.ts +69 -0
  131. package/dist/domains/comet-native/native-output-language.d.ts.map +1 -0
  132. package/dist/domains/comet-native/native-output-language.js +369 -0
  133. package/dist/domains/comet-native/native-output-language.js.map +1 -0
  134. package/dist/domains/comet-native/native-portable-archive.d.ts.map +1 -1
  135. package/dist/domains/comet-native/native-portable-archive.js +17 -1
  136. package/dist/domains/comet-native/native-portable-archive.js.map +1 -1
  137. package/dist/domains/comet-native/native-portable-continuation.d.ts.map +1 -1
  138. package/dist/domains/comet-native/native-portable-continuation.js +70 -27
  139. package/dist/domains/comet-native/native-portable-continuation.js.map +1 -1
  140. package/dist/domains/comet-native/native-portable-migration.d.ts.map +1 -1
  141. package/dist/domains/comet-native/native-portable-migration.js.map +1 -1
  142. package/dist/domains/comet-native/native-portable-recovery.d.ts +1 -0
  143. package/dist/domains/comet-native/native-portable-recovery.d.ts.map +1 -1
  144. package/dist/domains/comet-native/native-portable-recovery.js +2 -2
  145. package/dist/domains/comet-native/native-portable-recovery.js.map +1 -1
  146. package/dist/domains/comet-native/native-portable-runtime.d.ts +22 -0
  147. package/dist/domains/comet-native/native-portable-runtime.d.ts.map +1 -1
  148. package/dist/domains/comet-native/native-portable-runtime.js +114 -4
  149. package/dist/domains/comet-native/native-portable-runtime.js.map +1 -1
  150. package/dist/domains/comet-native/native-portable-state.d.ts.map +1 -1
  151. package/dist/domains/comet-native/native-portable-state.js +5 -0
  152. package/dist/domains/comet-native/native-portable-state.js.map +1 -1
  153. package/dist/domains/comet-native/native-portable-types.d.ts +3 -0
  154. package/dist/domains/comet-native/native-portable-types.d.ts.map +1 -1
  155. package/dist/domains/comet-native/native-portable-types.js.map +1 -1
  156. package/dist/domains/comet-native/native-runner-input.d.ts +30 -28
  157. package/dist/domains/comet-native/native-runner-input.d.ts.map +1 -1
  158. package/dist/domains/comet-native/native-runner-input.js +19 -27
  159. package/dist/domains/comet-native/native-runner-input.js.map +1 -1
  160. package/dist/domains/comet-native/native-schema-migration.d.ts.map +1 -1
  161. package/dist/domains/comet-native/native-schema-migration.js.map +1 -1
  162. package/dist/domains/comet-native/native-script-entry.d.ts +5 -4
  163. package/dist/domains/comet-native/native-script-entry.d.ts.map +1 -1
  164. package/dist/domains/comet-native/native-script-entry.js +8 -16
  165. package/dist/domains/comet-native/native-script-entry.js.map +1 -1
  166. package/dist/domains/comet-native/native-status-discovery.d.ts +31 -1
  167. package/dist/domains/comet-native/native-status-discovery.d.ts.map +1 -1
  168. package/dist/domains/comet-native/native-status-discovery.js +46 -8
  169. package/dist/domains/comet-native/native-status-discovery.js.map +1 -1
  170. package/dist/domains/comet-native/native-supervisor.d.ts +11 -1
  171. package/dist/domains/comet-native/native-supervisor.d.ts.map +1 -1
  172. package/dist/domains/comet-native/native-supervisor.js +61 -0
  173. package/dist/domains/comet-native/native-supervisor.js.map +1 -1
  174. package/dist/domains/comet-native/native-types.d.ts.map +1 -1
  175. package/dist/domains/comet-native/native-verification-receipt.d.ts.map +1 -1
  176. package/dist/domains/comet-native/native-verification-receipt.js.map +1 -1
  177. package/dist/domains/comet-native/native-workspace.d.ts.map +1 -1
  178. package/dist/domains/comet-native/native-workspace.js.map +1 -1
  179. package/dist/domains/comet-plugin/integration.d.ts +2 -0
  180. package/dist/domains/comet-plugin/integration.d.ts.map +1 -1
  181. package/dist/domains/comet-plugin/integration.js +10 -6
  182. package/dist/domains/comet-plugin/integration.js.map +1 -1
  183. package/dist/domains/dashboard/collector.js +1 -1
  184. package/dist/domains/dashboard/default-plugin-host.d.ts +3 -0
  185. package/dist/domains/dashboard/default-plugin-host.d.ts.map +1 -1
  186. package/dist/domains/dashboard/default-plugin-host.js +38 -4
  187. package/dist/domains/dashboard/default-plugin-host.js.map +1 -1
  188. package/dist/domains/dashboard/native-adapter.d.ts.map +1 -1
  189. package/dist/domains/dashboard/native-adapter.js.map +1 -1
  190. package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
  191. package/dist/domains/dashboard/native-collector.js +2 -0
  192. package/dist/domains/dashboard/native-collector.js.map +1 -1
  193. package/dist/domains/dashboard/web/assets/abnfDiagram-VCTEODGH-UcCx24DV.js +1 -0
  194. package/dist/domains/dashboard/web/assets/arc-n8qsRq7W.js +1 -0
  195. package/dist/domains/dashboard/web/assets/architecture-7GRP2DOG-B5p4GzJf.js +1 -0
  196. package/dist/domains/dashboard/web/assets/architectureDiagram-5GKGNRK7-D4pJ8CU0.js +36 -0
  197. package/dist/domains/dashboard/web/assets/array-BifhSqXX.js +1 -0
  198. package/dist/domains/dashboard/web/assets/blockDiagram-I7D4REHJ-C7n-qrSQ.js +129 -0
  199. package/dist/domains/dashboard/web/assets/browser-CgwPGwaV.js +107 -0
  200. package/dist/domains/dashboard/web/assets/c4Diagram-7LVT6UL2-cMVrWYOm.js +38 -0
  201. package/dist/domains/dashboard/web/assets/channel-BZeSeXVb.js +1 -0
  202. package/dist/domains/dashboard/web/assets/chunk-2Q5K7J3B-C1jixKkw.js +1 -0
  203. package/dist/domains/dashboard/web/assets/chunk-4HAMMTFA-CE5QrCQd.js +62 -0
  204. package/dist/domains/dashboard/web/assets/{chunk-5VM5RSS4-CopXcnFA.js → chunk-5VM5RSS4-ZNzvKenW.js} +2 -2
  205. package/dist/domains/dashboard/web/assets/chunk-75Z2AOVW-BtZqN-pM.js +2 -0
  206. package/dist/domains/dashboard/web/assets/chunk-DU6HZSFF-CChv0huc.js +125 -0
  207. package/dist/domains/dashboard/web/assets/chunk-F27PBJKO-CDT1ttJ8.js +1 -0
  208. package/dist/domains/dashboard/web/assets/chunk-FOHPRMQF-DHwB1DNv.js +161 -0
  209. package/dist/domains/dashboard/web/assets/chunk-GMAD6QVW-y5m6LMR7.js +72 -0
  210. package/dist/domains/dashboard/web/assets/chunk-GVQU2GXP-DkhKkaHd.js +1 -0
  211. package/dist/domains/dashboard/web/assets/chunk-IMKFNOWR-BaDSh7Jp.js +231 -0
  212. package/dist/domains/dashboard/web/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
  213. package/dist/domains/dashboard/web/assets/chunk-L3NEJ4N5-B4ztH2fV.js +1 -0
  214. package/dist/domains/dashboard/web/assets/chunk-OSK3NFVY-BhX6NVzA.js +10 -0
  215. package/dist/domains/dashboard/web/assets/chunk-P2QGCYS3-BCNdGJkX.js +1 -0
  216. package/dist/domains/dashboard/web/assets/chunk-POPQ4Y6H-DwYVuiXw.js +1 -0
  217. package/dist/domains/dashboard/web/assets/chunk-PWAF6VOD-Cyg0IO0R.js +1 -0
  218. package/dist/domains/dashboard/web/assets/chunk-SHT3W25Y-BZ6skx8I.js +168 -0
  219. package/dist/domains/dashboard/web/assets/chunk-SVP7TREG-CLIGmSO0.js +88 -0
  220. package/dist/domains/dashboard/web/assets/chunk-TICWLB2K-BAQBbsn9.js +206 -0
  221. package/dist/domains/dashboard/web/assets/chunk-XXDRQBXY-D07UbEpV.js +1 -0
  222. package/dist/domains/dashboard/web/assets/chunk-Y2CYZVJY-DsF7k-Jl.js +1 -0
  223. package/dist/domains/dashboard/web/assets/classDiagram-ZZMXUADV-2fcinal6.js +1 -0
  224. package/dist/domains/dashboard/web/assets/classDiagram-v2-VYDZK3BY-2fcinal6.js +1 -0
  225. package/dist/domains/dashboard/web/assets/cose-bilkent-JH36ORCC-wIi0mUih.js +1 -0
  226. package/dist/domains/dashboard/web/assets/cynefin-OW5HDTMX-DBdxyuTN.js +1 -0
  227. package/dist/domains/dashboard/web/assets/cynefinDiagram-5FMLGOSQ-DzO3jXxV.js +62 -0
  228. package/dist/domains/dashboard/web/assets/cytoscape.esm-CGd-uY3x.js +321 -0
  229. package/dist/domains/dashboard/web/assets/dagre-GXQ25YYZ-CE7H_hZS.js +4 -0
  230. package/dist/domains/dashboard/web/assets/dagre-PrKaheQc.js +1 -0
  231. package/dist/domains/dashboard/web/assets/defaultLocale-BFoDCU3G.js +1 -0
  232. package/dist/domains/dashboard/web/assets/demo-DrJ2uuUL.js +456 -0
  233. package/dist/domains/dashboard/web/assets/diagram-S7CK7UJ4-jUGQk5n-.js +30 -0
  234. package/dist/domains/dashboard/web/assets/diagram-UQ7AKVKN-DaH_zW8T.js +41 -0
  235. package/dist/domains/dashboard/web/assets/diagram-VSXAHHWV-DmG80db0.js +3 -0
  236. package/dist/domains/dashboard/web/assets/diagram-VX7I27RA-ltQ6niKn.js +24 -0
  237. package/dist/domains/dashboard/web/assets/diagram-Z3DM3KII-x92ex4lK.js +24 -0
  238. package/dist/domains/dashboard/web/assets/dist-Cf0h0n6i.js +1 -0
  239. package/dist/domains/dashboard/web/assets/ebnfDiagram-PWID7BFC-CI2u976k.js +1 -0
  240. package/dist/domains/dashboard/web/assets/erDiagram-RLTQ6QDP-DKs90SRd.js +99 -0
  241. package/dist/domains/dashboard/web/assets/es-D7xGlyQk.js +10 -0
  242. package/dist/domains/dashboard/web/assets/eventmodeling-NTZA5JFV-uARcGZPD.js +1 -0
  243. package/dist/domains/dashboard/web/assets/flowDiagram-HODETNUW-DXL1E4Bl.js +1 -0
  244. package/dist/domains/dashboard/web/assets/ganttDiagram-EL5Y4UJY-D3z6G60S.js +292 -0
  245. package/dist/domains/dashboard/web/assets/gitGraph-4MIJSDKK-vT1UnORT.js +1 -0
  246. package/dist/domains/dashboard/web/assets/gitGraphDiagram-WWUBYQGX-BJmJ96jv.js +106 -0
  247. package/dist/domains/dashboard/web/assets/graphlib-DS17s2tU.js +1 -0
  248. package/dist/domains/dashboard/web/assets/index-BG3MF8re.js +261 -0
  249. package/dist/domains/dashboard/web/assets/index-C2Hlo7VZ.css +1 -0
  250. package/dist/domains/dashboard/web/assets/info-A6RAGUB7-DFeLqqen.js +1 -0
  251. package/dist/domains/dashboard/web/assets/infoDiagram-27XIBGKW-DxuY43XD.js +2 -0
  252. package/dist/domains/dashboard/web/assets/init-C-OQMol4.js +1 -0
  253. package/dist/domains/dashboard/web/assets/ishikawaDiagram-5VMMS53U-DxillfWQ.js +70 -0
  254. package/dist/domains/dashboard/web/assets/journeyDiagram-3NMN7TZE-BPngQ3ag.js +139 -0
  255. package/dist/domains/dashboard/web/assets/kanban-definition-UXKFOSKX-DHMLEGD4.js +89 -0
  256. package/dist/domains/dashboard/web/assets/katex-CXMH3UgJ.js +257 -0
  257. package/dist/domains/dashboard/web/assets/line-D31peBjo.js +1 -0
  258. package/dist/domains/dashboard/web/assets/linear-B7X50T2m.js +1 -0
  259. package/dist/domains/dashboard/web/assets/marked.esm-BtJme7Pf.js +65 -0
  260. package/dist/domains/dashboard/web/assets/mermaid-parser.core-CX3Pzygh.js +7 -0
  261. package/dist/domains/dashboard/web/assets/mermaid.core-DlMjBFb6.js +44 -0
  262. package/dist/domains/dashboard/web/assets/mindmap-definition-YA3MSWOX-BKuSGF75.js +96 -0
  263. package/dist/domains/dashboard/web/assets/ordinal-BDEzSJ7C.js +1 -0
  264. package/dist/domains/dashboard/web/assets/packet-AYTQ26CC-B1T8Bds9.js +1 -0
  265. package/dist/domains/dashboard/web/assets/path-fybaL0A-.js +1 -0
  266. package/dist/domains/dashboard/web/assets/pegDiagram-XKGWAZYB-BYgTNxLw.js +1 -0
  267. package/dist/domains/dashboard/web/assets/pie-WAS4IAKB-fqAjmoQw.js +1 -0
  268. package/dist/domains/dashboard/web/assets/pieDiagram-E7YTZNPT-BAO0Ufky.js +39 -0
  269. package/dist/domains/dashboard/web/assets/purify.es-ChwZkWde.js +3 -0
  270. package/dist/domains/dashboard/web/assets/quadrantDiagram-AXDQQJYC-SA_1-7DT.js +7 -0
  271. package/dist/domains/dashboard/web/assets/radar-RG4KPBEZ-Bl_UfUle.js +1 -0
  272. package/dist/domains/dashboard/web/assets/railroad-74A4TZTK-yj6dkiSy.js +1 -0
  273. package/dist/domains/dashboard/web/assets/railroad-abnf-HS5TGJTU-CvouMciM.js +1 -0
  274. package/dist/domains/dashboard/web/assets/railroad-ebnf-LZEXJU2U-CkYQEX72.js +1 -0
  275. package/dist/domains/dashboard/web/assets/railroad-peg-WCYAUIDC-B0uYr48F.js +1 -0
  276. package/dist/domains/dashboard/web/assets/railroadDiagram-O6MQD6OU-DqV18Y46.js +1 -0
  277. package/dist/domains/dashboard/web/assets/requirementDiagram-BXWQKSXE-Ca2K5LuT.js +84 -0
  278. package/dist/domains/dashboard/web/assets/rough.esm-Dy-Kn_BL.js +1 -0
  279. package/dist/domains/dashboard/web/assets/sankeyDiagram-P5KCCOFB-D9MKl-Nr.js +40 -0
  280. package/dist/domains/dashboard/web/assets/sequenceDiagram-WJ2MYXX4-CXfvIzRx.js +162 -0
  281. package/dist/domains/dashboard/web/assets/sizeCapture-INFHLROL-B0uUizjq.js +1 -0
  282. package/dist/domains/dashboard/web/assets/src-CquUPIQx.js +1 -0
  283. package/dist/domains/dashboard/web/assets/stateDiagram-D77RDMKH-B7iaZHW7.js +1 -0
  284. package/dist/domains/dashboard/web/assets/stateDiagram-v2-MP3YSRHH-B6KoHQVe.js +1 -0
  285. package/dist/domains/dashboard/web/assets/swimlanes-42K2YHIH-OK-62yZl.js +1 -0
  286. package/dist/domains/dashboard/web/assets/swimlanesDiagram-VR7AAH4N-CjdOls9K.js +8 -0
  287. package/dist/domains/dashboard/web/assets/timeline-definition-24CTP7MA-D0l01B1h.js +120 -0
  288. package/dist/domains/dashboard/web/assets/treeView-Q6P3EWNA-Bg5u_o3A.js +1 -0
  289. package/dist/domains/dashboard/web/assets/treemap-WGGIJYW6-x89ccozk.js +1 -0
  290. package/dist/domains/dashboard/web/assets/vennDiagram-4TSXK5OY-DV19Cqhv.js +34 -0
  291. package/dist/domains/dashboard/web/assets/wardley-WFR3VGLG-BWoeoVk5.js +1 -0
  292. package/dist/domains/dashboard/web/assets/wardleyDiagram-VM6X3IG4-D4fCpoIP.js +78 -0
  293. package/dist/domains/dashboard/web/assets/xychartDiagram-S5SC5T6Z-DALnOMLb.js +7 -0
  294. package/dist/domains/dashboard/web/index.html +2 -2
  295. package/dist/domains/factory/artifacts.d.ts.map +1 -1
  296. package/dist/domains/factory/artifacts.js.map +1 -1
  297. package/dist/domains/factory/types.d.ts.map +1 -1
  298. package/dist/domains/integrations/codegraph.d.ts.map +1 -1
  299. package/dist/domains/integrations/codegraph.js.map +1 -1
  300. package/dist/domains/project-knowledge/local-store.d.ts +21 -0
  301. package/dist/domains/project-knowledge/local-store.d.ts.map +1 -1
  302. package/dist/domains/project-knowledge/local-store.js +97 -0
  303. package/dist/domains/project-knowledge/local-store.js.map +1 -1
  304. package/dist/domains/project-knowledge/types.d.ts.map +1 -1
  305. package/dist/domains/skill/platform-inspect.d.ts +1 -1
  306. package/dist/domains/skill/platform-inspect.d.ts.map +1 -1
  307. package/dist/domains/skill/platform-inspect.js +50 -10
  308. package/dist/domains/skill/platform-inspect.js.map +1 -1
  309. package/dist/domains/skill/platform-install.d.ts +10 -5
  310. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  311. package/dist/domains/skill/platform-install.js +107 -17
  312. package/dist/domains/skill/platform-install.js.map +1 -1
  313. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  314. package/dist/domains/skill/uninstall.js +38 -61
  315. package/dist/domains/skill/uninstall.js.map +1 -1
  316. package/dist/domains/workflow-contract/contained-atomic-write.d.ts +1 -0
  317. package/dist/domains/workflow-contract/contained-atomic-write.d.ts.map +1 -1
  318. package/dist/domains/workflow-contract/contained-atomic-write.js +19 -0
  319. package/dist/domains/workflow-contract/contained-atomic-write.js.map +1 -1
  320. package/dist/domains/workflow-contract/global-config.d.ts +8 -0
  321. package/dist/domains/workflow-contract/global-config.d.ts.map +1 -1
  322. package/dist/domains/workflow-contract/global-config.js +25 -0
  323. package/dist/domains/workflow-contract/global-config.js.map +1 -1
  324. package/dist/domains/workflow-contract/index.d.ts +1 -1
  325. package/dist/domains/workflow-contract/index.d.ts.map +1 -1
  326. package/dist/domains/workflow-contract/index.js +1 -1
  327. package/dist/domains/workflow-contract/index.js.map +1 -1
  328. package/dist/domains/workflow-contract/output-envelope.d.ts +59 -0
  329. package/dist/domains/workflow-contract/output-envelope.d.ts.map +1 -0
  330. package/dist/domains/workflow-contract/output-envelope.js +108 -0
  331. package/dist/domains/workflow-contract/output-envelope.js.map +1 -0
  332. package/dist/domains/workflow-contract/project-config.d.ts +1 -1
  333. package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
  334. package/dist/domains/workflow-contract/project-config.js +1 -0
  335. package/dist/domains/workflow-contract/project-config.js.map +1 -1
  336. package/dist/domains/workflow-contract/types.d.ts.map +1 -1
  337. package/dist/platform/install/platforms.d.ts +4 -0
  338. package/dist/platform/install/platforms.d.ts.map +1 -1
  339. package/dist/platform/install/platforms.js +15 -3
  340. package/dist/platform/install/platforms.js.map +1 -1
  341. package/dist/platform/paths/project-knowledge-storage.d.ts +1 -1
  342. package/dist/platform/paths/project-knowledge-storage.d.ts.map +1 -1
  343. package/dist/platform/paths/project-knowledge-storage.js +9 -4
  344. package/dist/platform/paths/project-knowledge-storage.js.map +1 -1
  345. package/dist/platform/version/version.d.ts +8 -0
  346. package/dist/platform/version/version.d.ts.map +1 -1
  347. package/dist/platform/version/version.js +58 -8
  348. package/dist/platform/version/version.js.map +1 -1
  349. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet-package.json +13 -13
  350. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/instruction.md +2 -0
  351. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/task.toml +1 -0
  352. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/validation/test_native_wave_d_stagnation_stop.py +37 -0
  353. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/current-comet-package.json +13 -13
  354. package/package.json +24 -24
  355. package/dist/domains/dashboard/web/assets/abnfDiagram-N423BO3Z-BkUJc7LK.js +0 -1
  356. package/dist/domains/dashboard/web/assets/arc-DY4Y9tSO.js +0 -1
  357. package/dist/domains/dashboard/web/assets/architectureDiagram-T3A2C74G-7wC9YZS-.js +0 -36
  358. package/dist/domains/dashboard/web/assets/blockDiagram-VBNYF7ZC-Biqe-SaL.js +0 -132
  359. package/dist/domains/dashboard/web/assets/c4Diagram-5PPSVZJV-CccUFD1S.js +0 -10
  360. package/dist/domains/dashboard/web/assets/channel-DnRvSkOm.js +0 -1
  361. package/dist/domains/dashboard/web/assets/chunk-2GRJ4B5K-BUL4dDxo.js +0 -1
  362. package/dist/domains/dashboard/web/assets/chunk-2Q5K7J3B-BnKtDH9O.js +0 -1
  363. package/dist/domains/dashboard/web/assets/chunk-5RXB4S5H-C9pHQ1n3.js +0 -231
  364. package/dist/domains/dashboard/web/assets/chunk-6Q2QTUOP-CxrbngCi.js +0 -88
  365. package/dist/domains/dashboard/web/assets/chunk-GF5L2VYU-01mzgCUh.js +0 -206
  366. package/dist/domains/dashboard/web/assets/chunk-JWPE2WC7-wTiZVDvw.js +0 -1
  367. package/dist/domains/dashboard/web/assets/chunk-KBJHAD2P-Bxdv5bl-.js +0 -1
  368. package/dist/domains/dashboard/web/assets/chunk-RYQCIY6F-B5vF9l9A.js +0 -1
  369. package/dist/domains/dashboard/web/assets/chunk-XXDRQBXY-Dra3NnDp.js +0 -1
  370. package/dist/domains/dashboard/web/assets/classDiagram-JCYQIIEL-D3E-rgaQ.js +0 -1
  371. package/dist/domains/dashboard/web/assets/classDiagram-v2-OCEON4UE-D3E-rgaQ.js +0 -1
  372. package/dist/domains/dashboard/web/assets/cose-bilkent-JH36ORCC-DC96ge-n.js +0 -1
  373. package/dist/domains/dashboard/web/assets/cynefin-VYW2F7L2-Tt_NiopT.js +0 -166
  374. package/dist/domains/dashboard/web/assets/cynefinDiagram-MW4NZA55-BQ5__1hv.js +0 -62
  375. package/dist/domains/dashboard/web/assets/cytoscape.esm-D3_iZ_3b.js +0 -321
  376. package/dist/domains/dashboard/web/assets/dagre-VZM6K2ZE-Cr2zq3ro.js +0 -4
  377. package/dist/domains/dashboard/web/assets/defaultLocale-DX6XiGOO.js +0 -1
  378. package/dist/domains/dashboard/web/assets/demo-lxXhgJ9-.js +0 -456
  379. package/dist/domains/dashboard/web/assets/diagram-7IWD3JNH-BRpYDwPl.js +0 -30
  380. package/dist/domains/dashboard/web/assets/diagram-B4RE2ZJO-D7u-VBxW.js +0 -3
  381. package/dist/domains/dashboard/web/assets/diagram-LBJQPF4R-CHYuv2JD.js +0 -24
  382. package/dist/domains/dashboard/web/assets/diagram-Q27KOJAE-CV3ZE8Q3.js +0 -24
  383. package/dist/domains/dashboard/web/assets/diagram-UB23O5K3-co_OsTiQ.js +0 -41
  384. package/dist/domains/dashboard/web/assets/ebnfDiagram-BXEA7PRR-CETcWswS.js +0 -1
  385. package/dist/domains/dashboard/web/assets/erDiagram-JOGREHBK-edkItb7Z.js +0 -85
  386. package/dist/domains/dashboard/web/assets/flowDiagram-UKHOOZJN-D_oFJtSf.js +0 -156
  387. package/dist/domains/dashboard/web/assets/ganttDiagram-PKOTCBZU-CFjLVoA1.js +0 -292
  388. package/dist/domains/dashboard/web/assets/gitGraphDiagram-DS77QQ5N-BfD0tiKH.js +0 -106
  389. package/dist/domains/dashboard/web/assets/graph-DOmOIIwC.js +0 -1
  390. package/dist/domains/dashboard/web/assets/index-BzyqCfMb.css +0 -1
  391. package/dist/domains/dashboard/web/assets/index-CCKHH_A9.js +0 -10
  392. package/dist/domains/dashboard/web/assets/index-D8dxsTJY.js +0 -271
  393. package/dist/domains/dashboard/web/assets/index-DlSYK56b.js +0 -139
  394. package/dist/domains/dashboard/web/assets/infoDiagram-6WML65LV-Cx6xa9DS.js +0 -2
  395. package/dist/domains/dashboard/web/assets/init-Gi6I4Gst.js +0 -1
  396. package/dist/domains/dashboard/web/assets/ishikawaDiagram-WSZJBQD7-BjNLyyv_.js +0 -70
  397. package/dist/domains/dashboard/web/assets/journeyDiagram-NVQOT4AX-D2n9vrhx.js +0 -139
  398. package/dist/domains/dashboard/web/assets/kanban-definition-27J2QSJJ-kJL7v018.js +0 -89
  399. package/dist/domains/dashboard/web/assets/katex-HP8lGamR.js +0 -257
  400. package/dist/domains/dashboard/web/assets/layout-D-LzfAck.js +0 -1
  401. package/dist/domains/dashboard/web/assets/linear-CeHtd5-l.js +0 -1
  402. package/dist/domains/dashboard/web/assets/map-DxJ2ADlA.js +0 -1
  403. package/dist/domains/dashboard/web/assets/marked.esm-DECB3bxB.js +0 -64
  404. package/dist/domains/dashboard/web/assets/mermaid.core-B0EPSHs2.js +0 -306
  405. package/dist/domains/dashboard/web/assets/mindmap-definition-FAOFIHXS-bQQWINF4.js +0 -96
  406. package/dist/domains/dashboard/web/assets/ordinal-Cboi1Yqb.js +0 -1
  407. package/dist/domains/dashboard/web/assets/pegDiagram-VL7TDLO6-LxLY1W7W.js +0 -1
  408. package/dist/domains/dashboard/web/assets/pieDiagram-7S7Q4E2Y-BMDQqvuT.js +0 -39
  409. package/dist/domains/dashboard/web/assets/purify.es-Cz4mVeUR.js +0 -3
  410. package/dist/domains/dashboard/web/assets/quadrantDiagram-CIZ2JOQS-XWYjcuZN.js +0 -7
  411. package/dist/domains/dashboard/web/assets/railroadDiagram-AXF67PYL-p-OlQTa7.js +0 -1
  412. package/dist/domains/dashboard/web/assets/requirementDiagram-LRYGKXZP-BL4N8Vsl.js +0 -84
  413. package/dist/domains/dashboard/web/assets/sankeyDiagram-W5VNT64P-Btu-o6LN.js +0 -40
  414. package/dist/domains/dashboard/web/assets/sequenceDiagram-SI44F4Z6-9HpdQQ47.js +0 -162
  415. package/dist/domains/dashboard/web/assets/sizeCapture-X5ZJPWSS-5AnBiBHD.js +0 -1
  416. package/dist/domains/dashboard/web/assets/stateDiagram-OKZ733FA-Dv8IDsai.js +0 -1
  417. package/dist/domains/dashboard/web/assets/stateDiagram-v2-UEYNNEHI-DxOMyFOm.js +0 -1
  418. package/dist/domains/dashboard/web/assets/swimlanes-SLNWSIFB-BfJcN7dK.js +0 -2
  419. package/dist/domains/dashboard/web/assets/swimlanesDiagram-ULZ7WXOC-BnHRSbDk.js +0 -8
  420. package/dist/domains/dashboard/web/assets/timeline-definition-Z64GVDOM-DEOuEHi5.js +0 -120
  421. package/dist/domains/dashboard/web/assets/vennDiagram-T6HMQDX7-BqsGpwgo.js +0 -34
  422. package/dist/domains/dashboard/web/assets/wardleyDiagram-T6FBY63Y-CXlOp9so.js +0 -78
  423. package/dist/domains/dashboard/web/assets/xychartDiagram-ELKLHX3M-DyqqtC9X.js +0 -7
package/README.md CHANGED
@@ -155,21 +155,12 @@ npm install -g @rpamis/comet
155
155
 
156
156
  ## Quick Start
157
157
 
158
- A single global initialization makes `/comet` available through the selected hosts in every project:
159
-
160
- ```bash
161
- comet init --scope global
162
- cd your-project
163
- # Invoke /comet in the host
164
- ```
165
-
166
- The first `/comet` invocation in an unconfigured project snapshots the defaults from `~/.comet/config.yaml` into the project's `.comet/config.yaml` and creates artifacts only inside that project. Later global-default changes do not rewrite activated projects. Hooks then recognize the project config and `.comet/current-change.json`; Hook events, `comet status`, and ordinary read-only resolution never initialize a project by themselves.
167
-
168
- Run project initialization only when you want project-local copies of Skills, Rules, and Hooks, or explicit project overrides:
158
+ Initialize Comet in the project where you want to use it:
169
159
 
170
160
  ```bash
171
161
  cd your-project
172
162
  comet init
163
+ # Invoke /comet in the host
173
164
  ```
174
165
 
175
166
  Interactive setup explains and offers Native, Classic, or both. Native is for strong models that can implement and verify autonomously; Classic is for tasks that need full Spec/TDD phase constraints; Both installs two independent entries while keeping `/comet` on Native by default. Non-interactive new projects default to Native, and project configuration is unified at `.comet/config.yaml`:
@@ -261,249 +252,9 @@ Comet Eval's automated dual-agent architecture can integrate online with LangSmi
261
252
  </p>
262
253
  <p align="center">Trace custom Rubric metrics with Pytest in LangSmith</p>
263
254
 
264
- ## Commands
265
-
266
- <details>
267
- <summary><code>comet init [path]</code> — Initialize Comet workflow</summary>
268
-
269
- Initializes Comet for selected AI coding platforms. Interactive setup selects Native, Classic, or both; new non-interactive projects default to self-contained Native, while projects with existing Classic state remain Classic. Pass `--platform` to initialize only that platform; unknown but valid platform ids are treated as project-scoped custom platforms installed under `.<platform>/` with the selected workflow's skills, scripts, rules, and hooks. The workflows keep independent entries, state, artifacts, and Guards. Each platform installs one `comet-workflow-guard` Rule, and platforms with Hook support install only `comet-hook-router.mjs`. The Router uses `.comet/current-change.json` to send each write to exactly one current Native or Classic Guard. Only Classic installs OpenSpec and Superpowers; Native depends on no external Skill.
270
-
271
- | Option | Description |
272
- | ------------------- | ------------------------------------------------------------------------------ |
273
- | `--yes` | Non-interactive mode, auto-select detected platforms (or all if none detected) |
274
- | `--scope <scope>` | Install scope: `project` or `global` |
275
- | `--language <lang>` | Skill language: `en` or `zh` (skips interactive language prompt) |
276
- | `--platform <platform>` | Initialize only this platform; project scope accepts custom platform ids |
277
- | `--workflow <mode>` | Workflows to initialize: `native`, `classic`, or `both` |
278
- | `--root <path>` | Project-relative Native artifact root; global scope stores it as a project default |
279
- | `--codegraph <action>` | Non-interactive project index action: explicitly choose `init` or `skip` |
280
- | `--skip-existing` | Skip already installed components |
281
- | `--overwrite` | Overwrite already installed components |
282
- | `--json` | Output structured JSON |
283
-
284
- When multiple existing components are found on the same platform, interactive init offers one bulk choice: overwrite
285
- all, skip all, or choose per component.
286
-
287
- </details>
288
-
289
- <details>
290
- <summary><code>comet status [path]</code> — Show active changes and next workflow command</summary>
291
-
292
- Displays the configured default entry point and separate Native, Classic, and unmanaged OpenSpec sections. Native entries include phase, approval, verification, selection, and next-step data; Classic entries retain workflow, phase, runtime mode, current step, evidence, and recovery diagnostics.
293
-
294
- | Option | Description |
295
- | -------- | ------------------------------------------------------------------------- |
296
- | `--json` | Output active changes with `nextCommand`, `currentStep`, and runtime data |
297
-
298
- </details>
299
-
300
- <details>
301
- <summary><code>comet resume-probe [path]</code> — Decide whether an active Comet workflow should resume</summary>
302
-
303
- Read-only probe that resolves the configured default workflow and inspects only that side. It returns `auto_resume`, `ask_user`, `out_of_scope`, or `none`, and routes Native to `/comet-native` or Classic to `/comet-classic`. A malformed root configuration stops recovery instead of falling back or scanning the other workflow. `comet init/update` still merges a `<comet-ambient-resume>` managed block into `AGENTS.md` and `CLAUDE.md` while preserving user-authored rules.
304
-
305
- </details>
306
-
307
- <details>
308
- <summary><code>comet dashboard [path]</code> — Launch local read-only dashboard server</summary>
309
-
310
- Starts a local HTTP server that displays a visual dashboard with active changes, phase status, task progress, and archive history. Auto-opens in your browser by default.
311
-
312
- <p align="center">
313
- <img src="https://github.com/rpamis/comet/blob/master/img/dashboard-light.png" alt="Comet Dashboard Light" width="800">
314
- </p>
315
- <p align="center">
316
- <img src="https://github.com/rpamis/comet/blob/master/img/dashboard-dark.png" alt="Comet Dashboard Dark" width="800">
317
- </p>
318
- <p align="center">Active change overview with phase indicators, task progress, and archive history</p>
319
-
320
- | Option | Description |
321
- | ----------- | --------------------------------------------------------------------------- |
322
- | `--port` | Server port (default: auto-selects available port) |
323
- | `--no-open` | Don't auto-open the dashboard in browser |
324
- | `--json` | Collect single snapshot and print JSON to stdout (for scripting/inspection) |
325
-
326
- </details>
327
-
328
- <details>
329
- <summary><code>comet doctor [path]</code> — Diagnose Comet installation health</summary>
330
-
331
- Checks project/global installation health, working directories, installed skills, scripts, CodeGraph indexes, and active change
332
- diagnostics. `comet doctor` reports diagnostic status for malformed `.comet.yaml` files, current step / runtime mode
333
- for valid changes, and runtime evidence gaps that block safe resume. In a Git secondary worktree, it separately reports
334
- the current worktree, primary worktree, and global fallback installation state. Ignored assets in the primary worktree
335
- are inspected only for classification and are never executed across worktrees.
336
- CodeGraph diagnostics separately report whether the CLI is installed, whether the current project index is current, whether
337
- MCP is registered with a supported Agent, and whether each Agent has effective capability; a healthy project index does not
338
- mean that an Agent has CodeGraph MCP registration.
339
-
340
- | Option | Description |
341
- | ----------------- | --------------------------------------------------------------------------------------------- |
342
- | `--json` | Output structured diagnostics, including CodeGraph state and the effective runtime source |
343
- | `--scope <scope>` | Diagnose `auto`, `project`, or `global` scope (default: `auto`) |
344
- | `--repair` | Repair deterministic managed-install and state problems |
345
- | `--yes` | Use with `--repair` to authorize potentially expensive CodeGraph initialization, rebuild, or sync |
346
-
347
- </details>
348
-
349
- <details>
350
- <summary><code>comet update [path]</code> — Update Comet package and skills</summary>
351
-
352
- Refreshes installed Comet skills in detected project/global targets. Pass `--platform` to refresh only that platform, including project-scoped custom platforms. A current-project refresh does not mutate any npm installation, whether global or project-local, by default; pass `--self-update` explicitly when the CLI should be upgraded too. Explicit `--scope global` deterministically uses the current-project asset scope, never opens the all-projects selector, and still does not update the npm package implicitly. Self-update compares full semver values, including prereleases, refuses downgrades, and validates the candidate package's version, Workflow command, and Native command in isolation before installation. A failed install attempts to restore the exact installed version.
353
-
354
- | Option | Description |
355
- | -------------------- | ------------------------------------------------ |
356
- | `--json` | Output npm and skill update results as JSON |
357
- | `--language <lang>` | Override detected skill language (`en`, `zh`) |
358
- | `--platform <platform>` | Refresh only this platform; project scope accepts custom platform ids |
359
- | `--scope <scope>` | Update only the `global` or `project` install scope |
360
- | `--current-project` | Refresh only the current project |
361
- | `--all-projects` | Refresh all registered project installations |
362
- | `--self-update` | Explicitly update the Comet npm package first |
363
- | `--skip-self-update` | Explicitly skip Comet npm package self-update |
364
-
365
- </details>
366
-
367
- <details>
368
- <summary><code>comet uninstall [path]</code> — Remove Comet skills, rules, and hooks</summary>
369
-
370
- Safely removes Comet-distributed skills, rules, and hooks from all detected platforms. Preserves user-defined hooks and non-Comet configuration.
371
-
372
- | Option | Description |
373
- | ----------------- | ------------------------------------------ |
374
- | `--force` | Skip confirmation prompt |
375
- | `--scope <scope>` | Uninstall only `global` or `project` scope |
376
- | `--json` | Output removal results as JSON |
377
-
378
- ```bash
379
- comet uninstall # Interactive — shows targets, asks for confirmation
380
- comet uninstall --force # Non-interactive — removes everything immediately
381
- comet uninstall --scope project # Only remove project-level installations
382
- ```
383
-
384
- </details>
385
-
386
- <details>
387
- <summary><code>comet eval [target]</code> — Evaluate Skills through the shared eval harness</summary>
388
-
389
- `comet eval` answers a simple question: does this Skill actually work reliably on standard tasks?
390
-
391
- The primary path is evaluating a local Skill that you already own. You do not need to run
392
- `/comet-any` first or create `comet/eval.yaml`:
393
-
394
- ```bash
395
- comet eval ./my-skill --collect
396
- comet eval ./my-skill --html
397
- comet eval ./my-skill --quick --html
398
- ```
399
-
400
- `--collect` performs static discovery and configuration checks without starting an Agent, Docker, plugins,
401
- credential checks, or network requests. A normal run generates and caches 2–4 tasks when the Skill has no
402
- `comet/eval.yaml`; `--quick` uses the fixed `generic-skill-smoke` task. The report path is printed by the command
403
- and is written under `.comet/eval/runs/<experiment-id>/` in the Skill or the project passed with `--project`.
404
-
405
- If the Skill contains `comet/eval.yaml`, passing its directory discovers it automatically. You can also pass a
406
- manifest or `SKILL.md` directly:
407
-
408
- ```bash
409
- comet eval ./my-skill/comet/eval.yaml --collect
410
- comet eval ./my-skill/SKILL.md --html
411
- ```
412
-
413
- Configure the main Agent, model, and API URL directly. LLM-as-Judge has an independent Agent, model, API URL, and
414
- credential boundary:
415
-
416
- ```yaml
417
- execution:
418
- agent: codex
419
- model: subject-model
420
- baseUrl: https://subject.example/v1
421
- judge:
422
- agent: claude-code
423
- model: judge-model
424
- baseUrl: https://judge.example/v1
425
- ```
426
-
427
- `/comet-any` may still produce a compatible manifest, but it is an optional Skill producer, never a prerequisite
428
- for `comet eval`.
429
-
430
- ### Reading Local Eval
431
-
432
- Local eval is the normal path for day-to-day development and pre-release checks. In the HTML report, look first at:
433
-
434
- - whether pass/fail and rubric scores match expectations
435
- - whether failures are attributed to the Skill, workflow, task, model, or environment/harness
436
- - whether expected artifacts are missing
437
- - whether token use, cost, or duration look unusual
438
- - whether the result is clean enough, or a specific task/treatment should be rerun
439
-
440
- If the report says `Insufficient clean data` or `Inconclusive due to data quality`, check auth, rate limits,
441
- Docker/container setup, network, and other environment issues before treating the run as a Skill-quality verdict.
442
-
443
- ### LangSmith Eval
444
-
445
- Use the LangSmith suite when you want to sync eval results to LangSmith, or when your team wants to inspect runs, rubric
446
- feedback, costs, and Claude Code trajectories together. It reuses the same tasks, treatments, rubric, and
447
- `comet/eval.yaml`; the difference is that results are uploaded to LangSmith.
448
-
449
- Prepare dependencies and environment variables once:
450
-
451
- ```bash
452
- cd eval
453
- uv sync --extra langsmith
454
- ```
455
-
456
- ```bash
457
- LANGSMITH_API_KEY=lsv2_pt_...
458
- LANGSMITH_PROJECT=comet-skill-eval
459
- LANGSMITH_TRACING=true
460
- ```
461
-
462
- Then select the LangSmith suite through the same `comet eval` entry point:
463
-
464
- ```bash
465
- comet eval ./my-skill --suite langsmith --html
466
- ```
467
-
468
- `--suite` defaults to `local`. With `langsmith`, the CLI starts the LangSmith runner, prints `Suite: langsmith` in its
469
- launch details, and writes reports under the project's `.comet/eval/runs/`. In PowerShell, set
470
- `$env:LANGSMITH_API_KEY`, `$env:LANGSMITH_PROJECT`, and `$env:LANGSMITH_TRACING`, or place them in `eval/.env`. See
471
- [eval/langsmith/README.md](eval/langsmith/README.md) for plugin cache and trajectory tracing details.
472
-
473
- ### Which Path To Use
474
-
475
- - Local Skill: run `comet eval ./my-skill --collect`, then `comet eval ./my-skill --html`
476
- - Low-cost smoke: `comet eval ./my-skill --quick --html`
477
- - `/comet-any` output: pass its directory for automatic manifest discovery, or pass `comet/eval.yaml` directly
478
- - Team tracing and side-by-side comparison: `comet eval ./my-skill --suite langsmith --html`
479
-
480
- For full task, treatment, report, and troubleshooting details, see the [Eval usage guide](docs/operations/EVAL-USAGE.md).
481
-
482
- </details>
483
-
484
- <details>
485
- <summary><code>/comet-any</code> / <code>comet creator</code> / <code>comet publish</code> — Create, evaluate, and publish Skills</summary>
486
-
487
- `/comet-any` is an optional Skill creation and composition path: Create or optimize a reusable Skill → validate it with `comet eval` → review and
488
- distribute it, until it becomes a stable composed Skill. For resume and release, use `comet creator`,
489
- `comet creator status` / `comet creator next`, `comet publish`, and `comet publish distribute --preview`. The README
490
- does not expand the backend command list; see the [Skill creation guide](docs/operations/SKILL-CREATION.md) for Advanced Bundle backend and Advanced Engine Run details, including `comet skill run` / `comet skill continue`.
491
-
492
- </details>
493
-
494
- <details>
495
- <summary><code>comet --help</code> / <code>comet --version</code> — Basic information</summary>
496
-
497
- | Command | Description |
498
- | ----------------- | ------------ |
499
- | `comet --help` | Show help |
500
- | `comet --version` | Show version |
501
-
502
- </details>
503
-
504
255
  ## Supported Platforms
505
256
 
506
- `comet init` supports 35 AI coding platforms:
257
+ `comet init` supports 37 AI coding platforms:
507
258
 
508
259
  <details>
509
260
  <summary>View full platform list</summary>
@@ -512,7 +263,7 @@ does not expand the backend command list; see the [Skill creation guide](docs/op
512
263
  | ------------------ | ------------- | ------------- | ------------ |
513
264
  | Claude Code | `.claude/` | Cursor | `.cursor/` |
514
265
  | Codex | `.codex/` | OpenCode | `.opencode/` |
515
- | Windsurf | `.windsurf/` | Cline | `.cline/` |
266
+ | Devin Desktop (formerly Windsurf) | `.devin/` | Cline | `.cline/` |
516
267
  | RooCode | `.roo/` | Continue | `.continue/` |
517
268
  | GitHub Copilot | `.github/` | Gemini CLI | `.gemini/` |
518
269
  | Amazon Q Developer | `.amazonq/` | Qwen Code | `.qwen/` |
@@ -531,404 +282,6 @@ does not expand the backend command list; see the [Skill creation guide](docs/op
531
282
 
532
283
  </details>
533
284
 
534
- ## Skills
535
-
536
- `comet init` installs skills for the selected workflow. Native depends only on Comet-owned skills; Classic additionally installs OpenSpec and Superpowers.
537
-
538
- ### Comet Skills
539
-
540
- <details>
541
- <summary>View Comet skills</summary>
542
-
543
- | Skill | Description |
544
- | ---------------- | -------------------------------------------------------------------------------------------- |
545
- | `/comet` | Shared entry — routes to the configured Native or Classic workflow from `.comet/config.yaml` |
546
- | `/comet-native` | Permanent Native entry — self-contained, recoverable Shape, Build, Verify, and Archive |
547
- | `/comet-classic` | Permanent Classic entry — the five-phase OpenSpec + Superpowers workflow |
548
- | `/comet-review` | Read-only manual review of the current Native or Classic change without advancing its phase |
549
- | `/comet-open` | Classic phase 1: Open a change (proposal, design, task breakdown) |
550
- | `/comet-design` | Classic phase 2: Deep design (brainstorming, Design Doc) |
551
- | `/comet-build` | Classic phase 3: Plan and build (implementation plan, code commits) |
552
- | `/comet-verify` | Classic phase 4: Verify and finish (testing, verification report) |
553
- | `/comet-archive` | Classic phase 5: Archive (delta spec sync, status annotation) |
554
- | `/comet-hotfix` | Classic preset: Quick bug fix |
555
- | `/comet-tweak` | Classic preset: OpenSpec-chained medium change |
556
- | `/comet-any` | Comet Skill Creator — Create or optimize a reusable Skill |
557
-
558
- </details>
559
-
560
- ### Guard & Automation Scripts
561
-
562
- <details>
563
- <summary>View script list</summary>
564
-
565
- | Script | Purpose |
566
- | ------------------------- | ---------------------------------------------------------------------------------------------------------- |
567
- | `comet-env.mjs` | Script discovery helper — prints the bundled scripts directory so skills can resolve sibling command paths |
568
- | `comet-guard.mjs` | Phase transition guard — validates exit conditions, `--apply` auto-updates `.comet.yaml` |
569
- | `comet-handoff.mjs` | Design handoff — generates deterministic context packages from OpenSpec artifacts with SHA256 tracing |
570
- | `comet-archive.mjs` | One-command archive — validates state, syncs specs, moves to archive, updates status |
571
- | `comet-yaml-validate.mjs` | Schema validator — validates `.comet.yaml` structure and field values |
572
- | `comet-state.mjs` | Unified state management — init/set/get/check/scale, agents' exclusive YAML interface |
573
- | `comet-hook-router.mjs` | The platform's only Hook entry — routes by current ownership to one workflow Guard |
574
- | `comet-hook-guard.mjs` | Classic Guard launcher — calls Classic runtime when selected by the Router |
575
- | `comet-native-runtime.mjs` | Native state, checks, archive, and recovery runtime |
576
- | `comet-native-hook-guard.mjs` | Native Guard launcher — calls Native runtime when selected by the Router |
577
-
578
- Both Native and Classic runtimes are generated from TypeScript and run through `node` on every platform. Native does
579
- not depend on OpenSpec, Superpowers, Bash, Git Bash, or WSL.
580
-
581
- </details>
582
-
583
- ## Workflow
584
-
585
- ### Native Workflow
586
-
587
- `/comet-native` uses Shape → Build → Verify → Archive. Shape owns clarification, the brief, complete target specs, and
588
- user approval; the agent chooses its own planning and implementation methods. User-readable state, specifications, and
589
- verification material live under `docs/comet/` by default; machine Runtime, locks, transactions, and recovery data live
590
- under the project-local `.comet/runtime/native/`.
591
-
592
- <details>
593
- <summary>View the Native phase flow</summary>
594
-
595
- ```text
596
- /comet-native (or /comet when default_workflow: native)
597
- Shape ──confirm requirements──> Build ──Builder handoff──> Verify ──pass──> Archive
598
- ^ │
599
- └────────── fail ──────────────┘
600
- ```
601
-
602
- | Phase | Main work | Required result |
603
- | ------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
604
- | Shape | Inspect the environment, clarify in rounds, and write the brief plus complete target specs | No blocking questions; the user confirms the current outcome |
605
- | Build | The agent plans, implements, self-tests, and submits a concise Builder handoff | Every acceptance item is addressed; ordinary source writes occur in Build |
606
- | Verify | Runtime runs necessary checks and dispatches a fresh read-only Verifier | Pass advances to Archive; failure returns to Build with specific gaps |
607
- | Archive | Sync complete target specs and move the change without rerunning Build or Verify checks | The recoverable archive transaction commits |
608
-
609
- Shape supports `clarification_mode: sequential` and `clarification_mode: batch`. Sequential asks one upstream question per round; Batch asks every currently answerable question whose prerequisites are settled and is the default for new projects. In both modes, the agent investigates discoverable facts and writes user decisions back into the brief and complete target specs.
610
-
611
- </details>
612
-
613
- <details>
614
- <summary>View Native state and artifacts</summary>
615
-
616
- | File or directory | Purpose |
617
- | ----------------------------------------------- | ------------------------------------------------------------------------------- |
618
- | `.comet/config.yaml` | Select workflows, artifact root, language, clarification mode, and project-local Hook write allow paths |
619
- | `.comet/current-change.json` | Shared Native/Classic ownership; each write routes to one workflow |
620
- | `docs/comet/changes/<name>/comet-state.yaml` | Portable phase, Loop, acceptance results, blockers, and next action |
621
- | `docs/comet/changes/<name>/brief.md` | Outcome, scope, non-goals, examples, constraints, decisions, and open questions |
622
- | `docs/comet/changes/<name>/specs/` | Complete target behavior for each capability after archive |
623
- | `docs/comet/changes/<name>/verification.md` | Human-readable Runtime checks, acceptance results, risks, and conclusion |
624
- | `.comet/runtime/native/changes/<name>/` | Local `state.json` execution overlay and on-demand logs; rebuildable from portable state |
625
- | `.comet/runtime/native/locks/` / `transactions/` | Project-local locks and recoverable transactions |
626
- | `docs/comet/specs/` / `archive/` | Applied specs, archived changes, and user-readable verification material |
627
-
628
- Native can keep multiple active changes at the same time. `comet status` lists the candidates, while `.comet/current-change.json` selects ownership for the current request; it does not limit the project to one change. Missing, stale, or ambiguous selection stops resume and writes for an explicit choice instead of guessing another change or switching to Classic.
629
-
630
- Runtime owns `comet-state.yaml` and machine state under `.comet/runtime/native/`. Requirement edits return the change to Shape; implementation edits return it to Build before a fresh Verifier reviews the candidate. Do not hand-edit state to skip a phase.
631
-
632
- Repositories that require their own PR template or validation script can opt into a Native repository-command provider in `.comet/config.yaml`:
633
-
634
- ```yaml
635
- native:
636
- finish:
637
- pull_request:
638
- provider: repository-command
639
- command: [pwsh, -NoProfile, -File, scripts/comet-create-pr.ps1]
640
- timeout_ms: 120000
641
- ```
642
-
643
- After a `pull-request` Archive finish is selected, Comet still owns commit, push, existing-PR observation, base/head/head-SHA verification, idempotent recovery, and safe cleanup. The repository command owns only title/body/template policy and repository-specific remote validation. Its executable must be either a bare name resolved through PATH or a project-relative path. It runs from the project root, receives `comet.native.pull-request-finish-input.v1` JSON on stdin, and must return `comet.native.pull-request-finish-result.v1` JSON on stdout. GitHub CLI (`gh`) must still be installed and authenticated because Comet independently verifies remote state with `gh pr list` and `gh pr view`. Projects without this configuration keep the compatible `gh pr create --fill` behavior.
644
-
645
- </details>
646
-
647
- <details>
648
- <summary>View Native reliability and recovery</summary>
649
-
650
- 1. **Clarification blocking** — Shape persists unresolved implementation decisions as blocking questions. Batch mode also requires explicit shared-understanding confirmation before Build.
651
- 2. **Builders cannot self-verify** — Build submits an implementation handoff. Runtime runs necessary checks and gives the brief, target specs, acceptance items, and results to a fresh read-only Verifier.
652
- 3. **Complete acceptance review** — The Verifier must return passed, failed, or blocked with a reason for every item. Missing, duplicate, and unknown items cannot pass.
653
- 4. **Bounded repair Loop** — Failure returns to Build. Repeated execution errors or no-progress results stop and return control to the user instead of looping indefinitely.
654
- 5. **Lightweight recovery** — `comet-state.yaml` keeps the stable phase, Loop, and next action. Interrupted local work reruns only necessary checks, not Shape, Build, or an already completed matching check.
655
- 6. **Protected state and transactions** — Runtime uses atomic state writes and short locks. Archive uses a recoverable transaction and does not rerun verification on the normal path.
656
- 7. **Unified guards without merged workflows** — Each platform installs one Rule and one Hook Router. The Router invokes Native Guard from current ownership; Native permits ordinary implementation writes only in Build and keeps its phases, schema, directories, and Guard independent from Classic.
657
-
658
- </details>
659
-
660
- ### Classic Five-Phase Workflow
661
-
662
- <details>
663
- <summary>View the Classic five-phase flow</summary>
664
-
665
- ```
666
- /comet-classic (or /comet when default_workflow: classic)
667
- ↓
668
- /comet-open --> /comet-design --> /comet-build --> /comet-verify --> /comet-archive
669
- (OpenSpec) (Superpowers) (Superpowers) (Both) (OpenSpec)
670
-
671
- /comet-hotfix (preset path, skips brainstorming)
672
- open --> build --> verify --> archive
673
-
674
- /comet-tweak (lightweight preset, chains OpenSpec)
675
- open --> build --> verify --> archive
676
- ```
677
-
678
- #### Five Phases
679
-
680
- | Phase | Command | Owner | Artifacts |
681
- | ------------------ | ---------------- | ----------- | ------------------------------------ |
682
- | 1. Open | `/comet-open` | OpenSpec | proposal.md, design.md, tasks.md |
683
- | 2. Deep Design | `/comet-design` | Superpowers | Design Doc, delta spec |
684
- | 3. Plan & Build | `/comet-build` | Superpowers | Implementation plan, code commits |
685
- | 4. Verify & Finish | `/comet-verify` | Both | Verification report, branch handling |
686
- | 5. Archive | `/comet-archive` | OpenSpec | delta→main spec sync, archive |
687
-
688
- </details>
689
-
690
- ### Classic State Management
691
-
692
- Classic uses a decoupled state architecture with separate files:
693
-
694
- <details>
695
- <summary>View Classic state management</summary>
696
-
697
- | File | Owner | Purpose |
698
- | ----------------------------------------- | -------- | --------------------------------------------------- |
699
- | `.openspec.yaml` | OpenSpec | Spec lifecycle, change metadata |
700
- | `<classic-change-dir>/.comet.yaml` | Comet | Workflow phase, execution mode, verification status |
701
- | `.comet/run-state.json` | Engine | Run identity and execution state (machine-owned) |
702
- | `.comet/state-events.jsonl` | Comet | Append-only state transition audit log |
703
-
704
- Each change-level `.comet.yaml` stores Classic workflow state and only keeps `run_id` as the link to the Engine Run.
705
- `<classic-change-dir>` is resolved from the project's `classic.artifact_layout`; use `comet classic root show` to inspect the current OpenSpec root.
706
- Machine-owned Engine state lives in the change's `.comet/run-state.json` with camelCase fields such as `currentStep`,
707
- `status`, and `iteration`. Legacy Run fields left in YAML are migrated after compatibility reads, and `skill` is no
708
- longer a valid current `.comet.yaml` field. Project defaults live in `.comet/config.yaml`.
709
-
710
- Phase progression is handled consistently by the TypeScript transition table, `comet-state transition`,
711
- `comet-guard --apply`, and archive commands. Each successful progression appends an audit event to
712
- `.comet/state-events.jsonl` with the source, before/after state, and actual field changes.
713
-
714
- This keeps Skill text focused on guiding the agent while scripts own state writes, phase checks, auditability, and
715
- breakpoint recovery. Agents can use Comet commands to know which phase the current Spec is in.
716
-
717
- </details>
718
-
719
- <details>
720
- <summary>View key Classic change .comet.yaml fields</summary>
721
-
722
- **Key Fields in change `.comet.yaml`:**
723
-
724
- ```yaml
725
- workflow: full # Workflow type: full | tweak | hotfix
726
- phase: build # Current phase: open | design | build | verify | archive
727
- context_compression: off # Context compression: off | beta
728
- auto_transition: true # Auto-invoke the next Skill after phase completion
729
- base_ref: <git-sha-or-null> # Baseline commit captured at init; may be null
730
- created_at: YYYY-MM-DD # Creation date written by comet-state.mjs init
731
- run_id: <uuid> # Links to .comet/run-state.json only; Run details stay out of YAML
732
- review_mode: standard # Automatic review strength: off | standard | thorough
733
- build_mode: subagent-driven-development # Build mode: subagent-driven-development | executing-plans | direct
734
- build_pause: null # `build_pause` records an internal build-phase pause point: null none, `plan-ready` means the plan has been generated
735
- subagent_dispatch: null # Dispatch confirmation; confirm before verify
736
- tdd_mode: null # Full-workflow build choice: tdd | direct
737
- isolation: branch # Isolation mode: current | branch | worktree
738
- bound_branch: null # Git branch bound by current/branch/worktree isolation; branch drift blocks progress
739
- verify_mode: null # Verification mode: light | full
740
- design_doc: docs/superpowers/specs/<design-doc>.md # Design doc path
741
- plan: docs/superpowers/plans/YYYY-MM-DD-feature.md # Implementation plan path
742
- verify_result: pending # Verification result: pending | pass | fail
743
- verification_report: null # Verification report path; must exist before verify-pass
744
- branch_status: pending # Branch handling status: pending | handled
745
- verified_at: null # Verification timestamp; null before verification passes
746
- archived: false # Archived changes are blocked from further mutation
747
- direct_override: null # Must be true when a full workflow chooses direct build
748
- handoff_context: null # Design handoff context path written by comet-handoff.mjs
749
- handoff_hash: null # SHA256 for handoff_context; 64 hex chars when present
750
- classic_profile: full # Machine-maintained Classic profile
751
- classic_migration: 1 # Machine-maintained migration version
752
- ```
753
-
754
- Current change `.comet.yaml` no longer contains `skill`; legacy Run fields in YAML are migrated to `.comet/run-state.json`.
755
-
756
- </details>
757
-
758
- ### Classic Reliability and Shared Guards
759
-
760
- The first six items below describe Classic phase automation; the final item covers the Router/Rule boundary shared by
761
- Native and Classic:
762
-
763
- <details>
764
- <summary>View Classic reliability and shared guards</summary>
765
-
766
- 1. **Entry Verification** — Each phase validates preconditions before execution
767
- - Checks file existence, state consistency, and phase transitions
768
- - Outputs `[HARD STOP]` with actionable suggestions if validation fails
769
-
770
- 2. **Automated State Transitions** — `comet-guard.mjs --apply` updates `.comet.yaml` automatically
771
- - All phase transitions (open → design/build → verify → archive) use `guard --apply`
772
- - No manual state editing required — eliminates write-verification errors
773
- - `comet-state.mjs` is the agents' exclusive interface for state operations
774
- - Guard and archive scripts use `comet-state.mjs` internally for state management
775
-
776
- 3. **Schema Validation** — `comet-yaml-validate.mjs` ensures data integrity
777
- - Validates required and optional fields
778
- - Validates enum values, including `direct_override`
779
- - Validates `design_doc`, `plan`, and `handoff_context` paths exist, plus `handoff_hash` format
780
- - Detects unknown/typos fields
781
-
782
- 4. **Build Decision Enforcement** — Guard and state transitions both block skipped build choices
783
- - `isolation` must be `current`, `branch`, or `worktree`
784
- - `isolation: current`, `branch`, and `worktree` bind the current Git branch, and later entry checks block accidental branch drift
785
- - `build_mode` must be selected before leaving build
786
- - `build_pause: plan-ready` is a recoverable pause after plan generation, not a `build_mode`
787
- - Full workflow `build_mode: direct` requires `direct_override: true`
788
-
789
- 5. **Verification Evidence** — Guard enforces proof before phase advance
790
- - `verify-pass` transition requires `verification_report` pointing to an existing report file
791
- - `branch_status` must be `handled` before verify can pass
792
- - Guard checks `verification_report exists` and `branch_status=handled` as hard prerequisites
793
- - Prevents false phase advances when verification or branch handling was skipped
794
-
795
- 6. **Archive Automation** — `comet-archive.mjs` handles the full archive flow in one command
796
- - Validates entry state, merges delta specs into main specs through OpenSpec
797
- - Annotates design doc and plan frontmatter
798
- - Moves change to archive directory and updates `archived: true`
799
- - Supports `--dry-run` for preview
800
-
801
- 7. **Anti-drift Phase Guards** — Phase awareness for long-context sessions
802
- - Rule layer: each platform installs one `comet-workflow-guard`, resolves enabled, default, and current ownership
803
- from `.comet/current-change.json`, and applies only one phase model
804
- - Hook layer: platforms with Hook support install only `comet-hook-router.mjs`; one write reaches at most one Guard,
805
- and ambiguous or stale selection fails closed
806
- - Guard layer: Native and Classic keep independent phases and allowed paths. Native permits ordinary implementation
807
- writes only in Build; Classic permits them in Build and Verify
808
-
809
- </details>
810
-
811
- ## Project Structure
812
-
813
- <details>
814
- <summary>Native project structure (default <code>docs/comet/</code>)</summary>
815
-
816
- ```text
817
- your-project/
818
- ├── .comet/
819
- │ ├── config.yaml # Shared config and Native artifact_root
820
- │ ├── current-change.json # Optional current ownership shared by Native and Classic
821
- │ └── runtime/native/ # Git-ignored Native machine Runtime
822
- │ ├── changes/<name>/ # Local state.json and on-demand logs
823
- │ ├── locks/ # Project-local locks
824
- │ └── transactions/ # Recoverable transactions
825
- ├── .claude/skills/ # Claude Code shown as the platform example
826
- │ ├── comet/SKILL.md # Configuration-driven shared entry
827
- │ └── comet-native/
828
- │ ├── SKILL.md # Permanent Native entry
829
- │ ├── reference/ # Artifact, command, and recovery contracts
830
- │ └── scripts/ # Native runtime and Guard launcher
831
- └── docs/comet/ # native.artifact_root: docs
832
- ├── specs/<capability>/spec.md # Archived canonical specs
833
- ├── changes/<name>/
834
- │ ├── comet-state.yaml # Native change state
835
- │ ├── brief.md # Outcome, scope, decisions, and acceptance
836
- │ ├── specs/<capability>/spec.md # Complete target specification
837
- │ ├── verification.md # Verification report
838
- └── archive/YYYY-MM-DD-<name>/ # Archived changes
839
- ```
840
-
841
- </details>
842
-
843
- <details>
844
- <summary>Classic project structure</summary>
845
-
846
- ```
847
- your-project/
848
- ├── .comet/
849
- │ └── config.yaml # Shared project config (workflows, Ambient Resume, language, Classic defaults)
850
- ├── .claude/skills/ # Platform skills dir (Comet + OpenSpec + Superpowers)
851
- │ ├── comet/SKILL.md
852
- │ │ └── scripts/
853
- │ │ ├── comet-guard.mjs # Phase transition guard (--apply auto-updates state)
854
- │ │ ├── comet-env.mjs # Script discovery helper
855
- │ │ ├── comet-handoff.mjs # Design handoff (OpenSpec → Superpowers context tracing)
856
- │ │ ├── comet-archive.mjs # One-command archive automation
857
- │ │ ├── comet-yaml-validate.mjs # Schema validator
858
- │ │ ├── comet-hook-router.mjs # The platform's only Hook entry (routes the current workflow Guard)
859
- │ │ ├── comet-hook-guard.mjs # Classic Guard (not installed as a separate platform Hook)
860
- │ │ └── comet-state.mjs # Unified state management (init/set/get/check/scale)
861
- │ ├── comet-*/SKILL.md
862
- │ ├── openspec-*/SKILL.md
863
- │ └── brainstorming/SKILL.md
864
- └── docs/
865
- ├── openspec/ # OpenSpec — WHAT (classic.artifact_layout: docs)
866
- │ ├── config.yaml
867
- │ ├── specs/<capability>/spec.md # Main specs after archive
868
- │ └── changes/
869
- │ ├── archive/YYYY-MM-DD-<name>/ # Archived changes
870
- │ └── <name>/
871
- │ ├── .openspec.yaml # OpenSpec state
872
- │ ├── .comet.yaml # Comet workflow state (Classic fields + run_id link)
873
- │ ├── .comet/
874
- │ │ ├── run-state.json # Engine Run state (machine-owned, auto-migrated)
875
- │ │ └── state-events.jsonl # State transition audit log (append-only)
876
- │ ├── proposal.md
877
- │ ├── design.md
878
- │ ├── specs/<capability>/spec.md
879
- │ └── tasks.md
880
- └── superpowers/ # Superpowers — HOW
881
- ├── specs/ # Design documents
882
- ├── plans/ # Implementation plans
883
- └── reports/ # Verification reports
884
- ```
885
-
886
- New Classic and dual-workflow projects default to `classic.artifact_layout: docs`. Projects that retain the legacy layout keep the OpenSpec root at repository-level `openspec/`, while Superpowers artifacts remain under `docs/superpowers/`. Use `comet classic root show` to inspect the current layout. To migrate, run `comet classic root move docs --dry-run` first and then apply the returned plan with `--apply`; do not edit the configuration field by itself.
887
-
888
- </details>
889
-
890
- <details>
891
- <summary>Classic Context Compression (Beta)</summary>
892
-
893
- Comet supports context compression at the Design → Build handoff. When enabled, `comet-handoff.mjs` generates a compact
894
- context package that reduces Build-phase input tokens by **25–30%** without affecting implementation correctness.
895
-
896
- | Mode | Behavior | Token Savings |
897
- | ------ | ---------------------------------------- | ------------- |
898
- | `off` | Full Spec excerpts in handoff context | Baseline |
899
- | `beta` | Design Doc + SHA256 hash references only | ~25–30% |
900
-
901
- Key findings from benchmark testing:
902
-
903
- - **Test pass rate**: 100% across all tiers (compression does not affect correctness)
904
- - **Spec coverage**: 100% (off) vs 95% (beta) — minor edge-case detail loss
905
- - **Scaling**: Larger tasks yield higher absolute savings (up to 15,000 tokens for large-tier tasks)
906
-
907
- Enable `context_compression: beta` under the `classic:` block in `.comet/config.yaml`.
908
-
909
- See [CONTEXT-COMPRESSION.md](docs/CONTEXT-COMPRESSION.md) for the full benchmark report, compression principles, and
910
- reproduction steps.
911
-
912
- </details>
913
-
914
- <details>
915
- <summary>Classic Auto Transition</summary>
916
-
917
- `auto_transition` controls whether Comet automatically invokes the next skill after a phase completes, or pauses for
918
- manual handoff. Phase advancement itself always happens — this setting only affects skill invocation.
919
-
920
- | Value | Behavior |
921
- | ------- | ------------------------------------------------------------- |
922
- | `true` | Auto-invoke the next skill after each phase (default) |
923
- | `false` | Pause after each phase; user manually triggers the next skill |
924
-
925
- Three-layer configuration with precedence: `COMET_AUTO_TRANSITION` env var > `classic.auto_transition` in
926
- `.comet/config.yaml` (project) > change `.comet.yaml`.
927
-
928
- See [AUTO-TRANSITION.md](docs/AUTO-TRANSITION.md) for configuration details, workflow mapping, and FAQ.
929
-
930
- </details>
931
-
932
285
  ## Development
933
286
 
934
287
  See [CONTRIBUTING.md](CONTRIBUTING.md) | [中文版](CONTRIBUTING-zh.md) for development setup, commit