@rpamis/comet 0.4.0-beta.17 → 0.4.0-beta.18
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.
- package/README.md +49 -24
- package/assets/manifest.json +2 -1
- package/assets/skills/comet/scripts/comet-archive.mjs +128 -128
- package/assets/skills/comet/scripts/comet-entry-runtime.mjs +78 -78
- package/assets/skills/comet/scripts/comet-guard.mjs +144 -144
- package/assets/skills/comet/scripts/comet-handoff.mjs +109 -109
- package/assets/skills/comet/scripts/comet-hook-guard.mjs +130 -130
- package/assets/skills/comet/scripts/comet-hook-router.mjs +115 -115
- package/assets/skills/comet/scripts/comet-resume-probe.mjs +85 -85
- package/assets/skills/comet/scripts/comet-runtime.mjs +188 -187
- package/assets/skills/comet/scripts/comet-state.mjs +117 -117
- package/assets/skills/comet/scripts/comet-yaml-validate.mjs +71 -71
- package/assets/skills/comet-build/SKILL.md +15 -56
- package/assets/skills/comet-classic/SKILL.md +14 -8
- package/assets/skills/comet-classic/reference/comet-yaml-fields.md +1 -1
- package/assets/skills/comet-classic/reference/scripts.md +3 -1
- package/assets/skills/comet-classic/reference/workspace.md +23 -0
- package/assets/skills/comet-native/SKILL.md +13 -10
- package/assets/skills/comet-native/reference/artifacts.md +3 -2
- package/assets/skills/comet-native/reference/commands.md +1 -1
- package/assets/skills/comet-native/reference/recovery.md +1 -1
- package/assets/skills/comet-native/reference/workspace.md +4 -4
- package/assets/skills/comet-native/scripts/comet-native-archive.mjs +97 -97
- package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +146 -146
- package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +100 -100
- package/assets/skills/comet-native/scripts/comet-native-init.mjs +85 -85
- package/assets/skills/comet-native/scripts/comet-native-new.mjs +115 -115
- package/assets/skills/comet-native/scripts/comet-native-next.mjs +118 -118
- package/assets/skills/comet-native/scripts/comet-native-root.mjs +107 -107
- package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +154 -154
- package/assets/skills/comet-native/scripts/comet-native-select.mjs +133 -133
- package/assets/skills/comet-native/scripts/comet-native-show.mjs +109 -109
- package/assets/skills/comet-native/scripts/comet-native-spec.mjs +87 -87
- package/assets/skills/comet-native/scripts/comet-native-status.mjs +109 -109
- package/assets/skills/comet-open/SKILL.md +24 -5
- package/assets/skills-zh/comet-build/SKILL.md +15 -56
- package/assets/skills-zh/comet-classic/SKILL.md +14 -8
- package/assets/skills-zh/comet-classic/reference/comet-yaml-fields.md +1 -1
- package/assets/skills-zh/comet-classic/reference/scripts.md +3 -1
- package/assets/skills-zh/comet-classic/reference/workspace.md +23 -0
- package/assets/skills-zh/comet-native/SKILL.md +13 -10
- package/assets/skills-zh/comet-native/reference/artifacts.md +3 -2
- package/assets/skills-zh/comet-native/reference/commands.md +1 -1
- package/assets/skills-zh/comet-native/reference/recovery.md +1 -1
- package/assets/skills-zh/comet-native/reference/workspace.md +4 -4
- package/assets/skills-zh/comet-open/SKILL.md +24 -5
- package/dist/app/cli/index.js +20 -1
- package/dist/app/cli/index.js.map +1 -1
- package/dist/app/commands/classic.d.ts.map +1 -1
- package/dist/app/commands/classic.js +2 -0
- package/dist/app/commands/classic.js.map +1 -1
- package/dist/app/commands/eval.d.ts +9 -2
- package/dist/app/commands/eval.d.ts.map +1 -1
- package/dist/app/commands/eval.js +293 -48
- package/dist/app/commands/eval.js.map +1 -1
- package/dist/app/commands/init.d.ts.map +1 -1
- package/dist/app/commands/init.js +2 -1
- package/dist/app/commands/init.js.map +1 -1
- package/dist/app/commands/update.d.ts.map +1 -1
- package/dist/app/commands/update.js +4 -1
- package/dist/app/commands/update.js.map +1 -1
- package/dist/domains/comet-classic/classic-cli.d.ts +1 -1
- package/dist/domains/comet-classic/classic-cli.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-cli.js +3 -0
- package/dist/domains/comet-classic/classic-cli.js.map +1 -1
- package/dist/domains/comet-classic/classic-current-change.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-current-change.js +29 -3
- package/dist/domains/comet-classic/classic-current-change.js.map +1 -1
- package/dist/domains/comet-classic/classic-guard.js +2 -2
- package/dist/domains/comet-classic/classic-guard.js.map +1 -1
- package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-hook-guard.js +14 -1
- package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
- package/dist/domains/comet-classic/classic-state-command.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-state-command.js +31 -8
- package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
- package/dist/domains/comet-classic/classic-workspace-command.d.ts +3 -0
- package/dist/domains/comet-classic/classic-workspace-command.d.ts.map +1 -0
- package/dist/domains/comet-classic/classic-workspace-command.js +45 -0
- package/dist/domains/comet-classic/classic-workspace-command.js.map +1 -0
- package/dist/domains/comet-classic/classic-workspace.d.ts +38 -0
- package/dist/domains/comet-classic/classic-workspace.d.ts.map +1 -0
- package/dist/domains/comet-classic/classic-workspace.js +315 -0
- package/dist/domains/comet-classic/classic-workspace.js.map +1 -0
- package/dist/domains/comet-entry/hook-adapter.d.ts.map +1 -1
- package/dist/domains/comet-entry/hook-adapter.js +1 -0
- package/dist/domains/comet-entry/hook-adapter.js.map +1 -1
- package/dist/domains/comet-entry/hook-router-entry.d.ts +2 -0
- package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
- package/dist/domains/comet-entry/hook-router-entry.js +21 -1
- package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
- package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
- package/dist/domains/comet-entry/init-workflow.js +13 -5
- package/dist/domains/comet-entry/init-workflow.js.map +1 -1
- package/dist/domains/comet-native/index.d.ts +1 -0
- package/dist/domains/comet-native/index.d.ts.map +1 -1
- package/dist/domains/comet-native/index.js +1 -0
- package/dist/domains/comet-native/index.js.map +1 -1
- package/dist/domains/comet-native/native-children.d.ts +49 -0
- package/dist/domains/comet-native/native-children.d.ts.map +1 -0
- package/dist/domains/comet-native/native-children.js +388 -0
- package/dist/domains/comet-native/native-children.js.map +1 -0
- package/dist/domains/comet-native/native-cli-help.d.ts.map +1 -1
- package/dist/domains/comet-native/native-cli-help.js +3 -3
- package/dist/domains/comet-native/native-cli-help.js.map +1 -1
- package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -1
- package/dist/domains/comet-native/native-doctor-command.js +10 -5
- package/dist/domains/comet-native/native-doctor-command.js.map +1 -1
- package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
- package/dist/domains/comet-native/native-hook-guard.js +41 -2
- package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
- package/dist/domains/comet-native/native-next-command.d.ts.map +1 -1
- package/dist/domains/comet-native/native-next-command.js +85 -5
- package/dist/domains/comet-native/native-next-command.js.map +1 -1
- package/dist/domains/comet-native/native-portable-continuation.d.ts +3 -2
- package/dist/domains/comet-native/native-portable-continuation.d.ts.map +1 -1
- package/dist/domains/comet-native/native-portable-continuation.js +63 -1
- package/dist/domains/comet-native/native-portable-continuation.js.map +1 -1
- package/dist/domains/comet-native/native-portable-runtime.d.ts +5 -0
- package/dist/domains/comet-native/native-portable-runtime.d.ts.map +1 -1
- package/dist/domains/comet-native/native-portable-runtime.js +110 -4
- package/dist/domains/comet-native/native-portable-runtime.js.map +1 -1
- package/dist/domains/comet-native/native-portable-state.d.ts.map +1 -1
- package/dist/domains/comet-native/native-portable-state.js +13 -0
- package/dist/domains/comet-native/native-portable-state.js.map +1 -1
- package/dist/domains/comet-native/native-portable-status.d.ts +3 -0
- package/dist/domains/comet-native/native-portable-status.d.ts.map +1 -1
- package/dist/domains/comet-native/native-portable-status.js +9 -1
- package/dist/domains/comet-native/native-portable-status.js.map +1 -1
- package/dist/domains/comet-native/native-portable-types.d.ts +1 -0
- package/dist/domains/comet-native/native-portable-types.d.ts.map +1 -1
- package/dist/domains/comet-native/native-portable-types.js.map +1 -1
- package/dist/domains/comet-native/native-show-command.d.ts.map +1 -1
- package/dist/domains/comet-native/native-show-command.js +2 -1
- package/dist/domains/comet-native/native-show-command.js.map +1 -1
- package/dist/domains/comet-native/native-workspace-preparation.d.ts.map +1 -1
- package/dist/domains/comet-native/native-workspace-preparation.js +192 -133
- package/dist/domains/comet-native/native-workspace-preparation.js.map +1 -1
- package/dist/domains/dashboard/collector.d.ts +1 -1
- package/dist/domains/dashboard/collector.d.ts.map +1 -1
- package/dist/domains/dashboard/collector.js +102 -87
- package/dist/domains/dashboard/collector.js.map +1 -1
- package/dist/domains/dashboard/native-adapter.d.ts +20 -0
- package/dist/domains/dashboard/native-adapter.d.ts.map +1 -1
- package/dist/domains/dashboard/native-adapter.js +11 -0
- package/dist/domains/dashboard/native-adapter.js.map +1 -1
- package/dist/domains/dashboard/native-collector.d.ts +1 -0
- package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
- package/dist/domains/dashboard/native-collector.js +304 -55
- package/dist/domains/dashboard/native-collector.js.map +1 -1
- package/dist/domains/dashboard/native-legacy-adapter.d.ts +12 -5
- package/dist/domains/dashboard/native-legacy-adapter.d.ts.map +1 -1
- package/dist/domains/dashboard/native-legacy-adapter.js +12 -0
- package/dist/domains/dashboard/native-legacy-adapter.js.map +1 -1
- package/dist/domains/dashboard/server.d.ts.map +1 -1
- package/dist/domains/dashboard/server.js +5 -3
- package/dist/domains/dashboard/server.js.map +1 -1
- package/dist/domains/dashboard/types.d.ts +5 -0
- package/dist/domains/dashboard/types.d.ts.map +1 -1
- package/dist/domains/dashboard/web/assets/abnfDiagram-N423BO3Z-B5cFR6hS.js +1 -0
- package/dist/domains/dashboard/web/assets/arc-CVQDtMsu.js +1 -0
- package/dist/domains/dashboard/web/assets/architectureDiagram-T3A2C74G-C0v0kULK.js +36 -0
- package/dist/domains/dashboard/web/assets/blockDiagram-VBNYF7ZC-DpHLuxu4.js +132 -0
- package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-BL17BIb8.js → c4Diagram-5PPSVZJV-BHnFxUs1.js} +1 -1
- package/dist/domains/dashboard/web/assets/channel-eM0x3m1G.js +1 -0
- package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-XWLMOyd4.js → chunk-2GRJ4B5K-CGC9gh5n.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-4drjXzHQ.js → chunk-2Q5K7J3B-l4puLU_O.js} +1 -1
- package/dist/domains/dashboard/web/assets/chunk-5RXB4S5H-ls9jQHZc.js +231 -0
- package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-CQXqBSqQ.js → chunk-5VM5RSS4-BVavmTEq.js} +1 -1
- package/dist/domains/dashboard/web/assets/chunk-6Q2QTUOP-Dungt2g9.js +88 -0
- package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-pMreYMW7.js → chunk-GF5L2VYU-BidXO_ZP.js} +5 -5
- package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-vQyyh3eG.js → chunk-JWPE2WC7-57L5Up5X.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-B_DDS2IK.js → chunk-KBJHAD2P-C5u5vbwr.js} +1 -1
- package/dist/domains/dashboard/web/assets/chunk-RYQCIY6F-CvLz21I2.js +1 -0
- package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-Cug8J1Qa.js → chunk-XXDRQBXY-D5nJpckG.js} +1 -1
- package/dist/domains/dashboard/web/assets/classDiagram-JCYQIIEL-CEFhao2K.js +1 -0
- package/dist/domains/dashboard/web/assets/classDiagram-v2-OCEON4UE-CEFhao2K.js +1 -0
- package/dist/domains/dashboard/web/assets/{cose-bilkent-S5V4N54A-IQKP-hgj.js → cose-bilkent-JH36ORCC-Dp0JAGyE.js} +1 -1
- package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-CvvRO4J2.js → cynefin-VYW2F7L2-EjC54l1g.js} +2 -2
- package/dist/domains/dashboard/web/assets/cynefinDiagram-MW4NZA55-CpYrW3w3.js +62 -0
- package/dist/domains/dashboard/web/assets/dagre-VZM6K2ZE-h5K39rCk.js +4 -0
- package/dist/domains/dashboard/web/assets/{demo-CeIDHUFJ.js → demo-BfLsKrIL.js} +26 -5
- package/dist/domains/dashboard/web/assets/diagram-7IWD3JNH-CKQj9O4H.js +30 -0
- package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-CN_LYqvT.js → diagram-B4RE2ZJO-DXRIYcnW.js} +3 -3
- package/dist/domains/dashboard/web/assets/diagram-LBJQPF4R-wWutQYmv.js +24 -0
- package/dist/domains/dashboard/web/assets/diagram-Q27KOJAE-EgXLJQYi.js +24 -0
- package/dist/domains/dashboard/web/assets/diagram-UB23O5K3-CsQRXDQZ.js +41 -0
- package/dist/domains/dashboard/web/assets/ebnfDiagram-BXEA7PRR-gm328Eho.js +1 -0
- package/dist/domains/dashboard/web/assets/erDiagram-JOGREHBK-BbbMVUx_.js +85 -0
- package/dist/domains/dashboard/web/assets/flowDiagram-UKHOOZJN-1Y7scCns.js +156 -0
- package/dist/domains/dashboard/web/assets/ganttDiagram-PKOTCBZU-BAoBqczv.js +292 -0
- package/dist/domains/dashboard/web/assets/{gitGraphDiagram-PVQCEYII-CaWEk3PM.js → gitGraphDiagram-DS77QQ5N-CMUAyEzl.js} +3 -3
- package/dist/domains/dashboard/web/assets/{graph--OzhPTMs.js → graph-DOmOIIwC.js} +1 -1
- package/dist/domains/dashboard/web/assets/{index-BNyOfAhu.js → index-CCApJ0Yr.js} +1 -1
- package/dist/domains/dashboard/web/assets/index-DWdm_XBi.js +257 -0
- package/dist/domains/dashboard/web/assets/{index-BFwKBVTJ.css → index-DhhbseFJ.css} +1 -1
- package/dist/domains/dashboard/web/assets/{infoDiagram-5YYISTIA-BK07mNG0.js → infoDiagram-6WML65LV-BaCdtYYC.js} +1 -1
- package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-mWnmaWfZ.js → ishikawaDiagram-WSZJBQD7-DQQlNnjU.js} +4 -4
- package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-BPy-P7xx.js → journeyDiagram-NVQOT4AX-DW9wUMqn.js} +1 -1
- package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-3Jq9c_lo.js → kanban-definition-27J2QSJJ-C_ITaZ0q.js} +7 -7
- package/dist/domains/dashboard/web/assets/layout-D-LzfAck.js +1 -0
- package/dist/domains/dashboard/web/assets/{linear-kQyEW-4G.js → linear-DXOo6ZRT.js} +1 -1
- package/dist/domains/dashboard/web/assets/map-DxJ2ADlA.js +1 -0
- package/dist/domains/dashboard/web/assets/mermaid.core-ol-0NI97.js +306 -0
- package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CyyurUpv.js → mindmap-definition-FAOFIHXS-CHF_HOLV.js} +1 -1
- package/dist/domains/dashboard/web/assets/pegDiagram-VL7TDLO6-wQEvkNF8.js +1 -0
- package/dist/domains/dashboard/web/assets/pieDiagram-7S7Q4E2Y-C3H3kiIP.js +39 -0
- package/dist/domains/dashboard/web/assets/purify.es-Cz4mVeUR.js +3 -0
- package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CpayUMjH.js → quadrantDiagram-CIZ2JOQS-S0FdVzJb.js} +4 -4
- package/dist/domains/dashboard/web/assets/railroadDiagram-AXF67PYL-DCDXDaVg.js +1 -0
- package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-Bi8YpfnA.js → requirementDiagram-LRYGKXZP-BW8J4gO_.js} +1 -1
- package/dist/domains/dashboard/web/assets/sankeyDiagram-W5VNT64P-DQQBmLoy.js +40 -0
- package/dist/domains/dashboard/web/assets/sequenceDiagram-SI44F4Z6-2tDcli0Y.js +162 -0
- package/dist/domains/dashboard/web/assets/sizeCapture-X5ZJPWSS-4sEZLBKb.js +1 -0
- package/dist/domains/dashboard/web/assets/stateDiagram-OKZ733FA-OgPb8pyR.js +1 -0
- package/dist/domains/dashboard/web/assets/stateDiagram-v2-UEYNNEHI-CiDNPr4P.js +1 -0
- package/dist/domains/dashboard/web/assets/swimlanes-SLNWSIFB-DR7lwtxd.js +2 -0
- package/dist/domains/dashboard/web/assets/swimlanesDiagram-ULZ7WXOC-DggHFP9q.js +8 -0
- package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-aHrrtV-b.js → timeline-definition-Z64GVDOM-DNIJVlQV.js} +4 -4
- package/dist/domains/dashboard/web/assets/vennDiagram-T6HMQDX7-CClhw4QZ.js +34 -0
- package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-RVQbcySh.js → wardleyDiagram-T6FBY63Y-DzR3aFPS.js} +3 -3
- package/dist/domains/dashboard/web/assets/xychartDiagram-ELKLHX3M-DZhq0ZRj.js +7 -0
- package/dist/domains/dashboard/web/index.html +2 -2
- package/dist/domains/dashboard/workspace.d.ts +24 -0
- package/dist/domains/dashboard/workspace.d.ts.map +1 -0
- package/dist/domains/dashboard/workspace.js +87 -0
- package/dist/domains/dashboard/workspace.js.map +1 -0
- package/dist/domains/eval/index.d.ts +3 -0
- package/dist/domains/eval/index.d.ts.map +1 -1
- package/dist/domains/eval/index.js +3 -0
- package/dist/domains/eval/index.js.map +1 -1
- package/dist/domains/eval/standalone-context.d.ts +19 -0
- package/dist/domains/eval/standalone-context.d.ts.map +1 -0
- package/dist/domains/eval/standalone-context.js +107 -0
- package/dist/domains/eval/standalone-context.js.map +1 -0
- package/dist/domains/eval/standalone-static-collect.d.ts +22 -0
- package/dist/domains/eval/standalone-static-collect.d.ts.map +1 -0
- package/dist/domains/eval/standalone-static-collect.js +779 -0
- package/dist/domains/eval/standalone-static-collect.js.map +1 -0
- package/dist/domains/eval/user-environment.d.ts +6 -0
- package/dist/domains/eval/user-environment.d.ts.map +1 -0
- package/dist/domains/eval/user-environment.js +73 -0
- package/dist/domains/eval/user-environment.js.map +1 -0
- package/dist/domains/integrations/openspec.d.ts +1 -1
- package/dist/domains/integrations/openspec.d.ts.map +1 -1
- package/dist/domains/integrations/openspec.js +110 -26
- package/dist/domains/integrations/openspec.js.map +1 -1
- package/dist/domains/integrations/superpowers.d.ts +5 -1
- package/dist/domains/integrations/superpowers.d.ts.map +1 -1
- package/dist/domains/integrations/superpowers.js +21 -2
- package/dist/domains/integrations/superpowers.js.map +1 -1
- package/dist/domains/skill/platform-install.d.ts +1 -1
- package/dist/domains/skill/platform-install.js +1 -1
- package/dist/domains/skill/project-instructions.d.ts.map +1 -1
- package/dist/domains/skill/project-instructions.js +5 -3
- package/dist/domains/skill/project-instructions.js.map +1 -1
- package/dist/domains/workflow-contract/hook-write-policy.d.ts +9 -0
- package/dist/domains/workflow-contract/hook-write-policy.d.ts.map +1 -0
- package/dist/domains/workflow-contract/hook-write-policy.js +52 -0
- package/dist/domains/workflow-contract/hook-write-policy.js.map +1 -0
- package/dist/domains/workflow-contract/index.d.ts +2 -0
- package/dist/domains/workflow-contract/index.d.ts.map +1 -1
- package/dist/domains/workflow-contract/index.js +1 -0
- package/dist/domains/workflow-contract/index.js.map +1 -1
- package/dist/domains/workflow-contract/project-config.d.ts +2 -2
- package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
- package/dist/domains/workflow-contract/project-config.js +42 -2
- package/dist/domains/workflow-contract/project-config.js.map +1 -1
- package/dist/domains/workflow-contract/protected-project-path.d.ts +13 -0
- package/dist/domains/workflow-contract/protected-project-path.d.ts.map +1 -1
- package/dist/domains/workflow-contract/protected-project-path.js +83 -0
- package/dist/domains/workflow-contract/protected-project-path.js.map +1 -1
- package/dist/domains/workflow-contract/types.d.ts +4 -0
- package/dist/domains/workflow-contract/types.d.ts.map +1 -1
- package/dist/platform/install/platforms.d.ts.map +1 -1
- package/dist/platform/install/platforms.js +13 -2
- package/dist/platform/install/platforms.js.map +1 -1
- package/dist/platform/paths/git-worktree.d.ts +7 -1
- package/dist/platform/paths/git-worktree.d.ts.map +1 -1
- package/dist/platform/paths/git-worktree.js +28 -7
- package/dist/platform/paths/git-worktree.js.map +1 -1
- package/eval/.env.example +115 -0
- package/eval/README.md +237 -14
- package/eval/langfuse/.env.example +9 -0
- package/eval/langfuse/tests/conftest.py +146 -0
- package/eval/langfuse/tests/tasks/test_tasks.py +109 -0
- package/eval/langfuse/tests/test_adapter.py +272 -0
- package/eval/langsmith/.env.example +16 -0
- package/eval/langsmith/tests/conftest.py +10 -1
- package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet-package.json +4 -2
- package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/current-comet-package.json +2 -2
- package/eval/local/tests/conftest.py +701 -80
- package/eval/local/tests/scaffold/fixtures/custom-agent/adapter.yaml +19 -0
- package/eval/local/tests/scaffold/test_agents.py +76 -0
- package/eval/local/tests/scaffold/test_aligned_comparison.py +70 -0
- package/eval/local/tests/scaffold/test_auto_tasks.py +350 -0
- package/eval/local/tests/scaffold/test_conftest_helpers.py +267 -18
- package/eval/local/tests/scaffold/test_custom_agents.py +174 -0
- package/eval/local/tests/scaffold/test_eval_context.py +217 -0
- package/eval/local/tests/scaffold/test_execution.py +364 -0
- package/eval/local/tests/scaffold/test_inline_tasks.py +56 -0
- package/eval/local/tests/scaffold/test_langfuse_trajectory.py +263 -0
- package/eval/local/tests/scaffold/test_langsmith_conftest.py +63 -0
- package/eval/local/tests/scaffold/test_logging.py +162 -0
- package/eval/local/tests/scaffold/test_manifest_tasks.py +76 -0
- package/eval/local/tests/scaffold/test_manifests.py +396 -0
- package/eval/local/tests/scaffold/test_native_aligned_eval.py +17 -0
- package/eval/local/tests/scaffold/test_profiles.py +64 -6
- package/eval/local/tests/scaffold/test_task_resolution.py +212 -0
- package/eval/local/tests/scaffold/test_utils.py +480 -4
- package/eval/local/tests/tasks/test_tasks.py +216 -14
- package/eval/pyproject.toml +5 -0
- package/eval/scaffold/__init__.py +6 -0
- package/eval/scaffold/docker/agent-overlay.Dockerfile +41 -0
- package/eval/scaffold/python/__init__.py +128 -20
- package/eval/scaffold/python/agents.py +239 -0
- package/eval/scaffold/python/aligned_comparison.py +156 -27
- package/eval/scaffold/python/auto_tasks.py +700 -0
- package/eval/scaffold/python/custom_agents.py +172 -0
- package/eval/scaffold/python/eval_context.py +236 -0
- package/eval/scaffold/python/eval_schema.py +135 -0
- package/eval/scaffold/python/execution.py +544 -0
- package/eval/scaffold/python/generated_task_cache.py +230 -0
- package/eval/scaffold/python/generic_llm_judge.py +41 -14
- package/eval/scaffold/python/inline_tasks.py +118 -0
- package/eval/scaffold/python/judge_config.py +158 -37
- package/eval/scaffold/python/langfuse_adapter.py +1023 -0
- package/eval/scaffold/python/llm_judge.py +68 -11
- package/eval/scaffold/python/logging.py +157 -17
- package/eval/scaffold/python/manifest_tasks.py +69 -0
- package/eval/scaffold/python/manifests.py +443 -22
- package/eval/scaffold/python/paths.py +11 -1
- package/eval/scaffold/python/task_resolution.py +176 -0
- package/eval/scaffold/python/tasks.py +17 -4
- package/eval/scaffold/python/utils.py +167 -11
- package/eval/scaffold/python/validation/core.py +48 -2
- package/eval/scaffold/python/validation/generic_rubric.py +9 -0
- package/eval/scaffold/python/validation/native_workflow.py +6 -1
- package/eval/scaffold/python/validation/rubric.py +16 -1
- package/eval/scaffold/shell/agent-runtime-config.sh +88 -0
- package/eval/scaffold/shell/docker.sh +534 -33
- package/eval/scaffold/shell/run-agent-runtime.sh +49 -0
- package/eval/scaffold/shell/run-claude-loop.sh +153 -14
- package/eval/schemas/comet.eval/v1alpha1.schema.json +244 -0
- package/package.json +8 -3
- package/dist/domains/dashboard/web/assets/arc-CkuYweSh.js +0 -1
- package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR--tTGrKam.js +0 -36
- package/dist/domains/dashboard/web/assets/blockDiagram-GPEHLZMM-DLKYOixs.js +0 -132
- package/dist/domains/dashboard/web/assets/channel-Cg__FSMr.js +0 -1
- package/dist/domains/dashboard/web/assets/chunk-AQP2D5EJ-BUkV_rb7.js +0 -231
- package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-CsC-pvu9.js +0 -1
- package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-CsC-pvu9.js +0 -1
- package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-DeOQo7bP.js +0 -4
- package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-IQd_jQwB.js +0 -43
- package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-Dllkdt0m.js +0 -10
- package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-DK36WkNN.js +0 -24
- package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-iqUnMYEh.js +0 -24
- package/dist/domains/dashboard/web/assets/erDiagram-TEJ5UH35-Bc64lzy8.js +0 -85
- package/dist/domains/dashboard/web/assets/flowDiagram-I6XJVG4X-UfOqef9j.js +0 -162
- package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-D-u6Aauc.js +0 -292
- package/dist/domains/dashboard/web/assets/index-COZ_03uK.js +0 -257
- package/dist/domains/dashboard/web/assets/layout-SsrduOYp.js +0 -1
- package/dist/domains/dashboard/web/assets/mermaid.core-COBBjtVH.js +0 -301
- package/dist/domains/dashboard/web/assets/pieDiagram-4H26LBE5-CJro_XKk.js +0 -30
- package/dist/domains/dashboard/web/assets/purify.es-VaSPOPhr.js +0 -3
- package/dist/domains/dashboard/web/assets/sankeyDiagram-5OEKKPKP-Wx60WwHe.js +0 -40
- package/dist/domains/dashboard/web/assets/sequenceDiagram-3UESZ5HK-BiMsRFbc.js +0 -162
- package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-BrURMY0R.js +0 -1
- package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-BpEE-yEg.js +0 -1
- package/dist/domains/dashboard/web/assets/vennDiagram-CIIHVFJN-DGB16bvR.js +0 -34
- package/dist/domains/dashboard/web/assets/xychartDiagram-2RQKCTM6-DMzzwDVX.js +0 -7
|
@@ -22,17 +22,36 @@ Every prompt and artifact request passed to OpenSpec must include the resolved C
|
|
|
22
22
|
|
|
23
23
|
When resuming an existing change, inspect `<classic-change-dir>/.comet.yaml` first:
|
|
24
24
|
|
|
25
|
-
- If it exists and parses,
|
|
26
|
-
- If it is missing but the change directory is valid, run `comet state init <change-name> full`,
|
|
25
|
+
- If it exists and parses, first run `comet classic workspace resolve <change-name> --json`, enter the returned `projectRoot`, then select the change
|
|
26
|
+
- If it is missing but the change directory is valid, first prepare the workspace with the selected isolation mode, then run `comet state init <change-name> full --isolation <selected-isolation>` from the returned `projectRoot`, and select the change
|
|
27
27
|
- If it is malformed, stop and report the parse error; repair it manually from version control, a backup, or verifiable artifacts before continuing, and never overwrite a damaged file with `state set`
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
|
+
comet classic workspace resolve <change-name> --json
|
|
31
|
+
# enter the returned projectRoot
|
|
30
32
|
comet state select <change-name>
|
|
31
33
|
```
|
|
32
34
|
|
|
33
35
|
When creating a new change, initialize `.comet.yaml` first, then immediately run the same command; never fabricate a selection before state exists.
|
|
34
36
|
|
|
35
|
-
### 0b.
|
|
37
|
+
### 0b. Workspace Decision and Preparation Before Open
|
|
38
|
+
|
|
39
|
+
Read `comet-classic/reference/workspace.md` when creating a Classic change. The workspace decision must be completed before creating OpenSpec artifacts or `.comet.yaml`; it must not be deferred to Build:
|
|
40
|
+
|
|
41
|
+
- When parallel intent is explicit, use `worktree` directly so the independent workspace is ready before OpenSpec and state creation
|
|
42
|
+
- When isolation is not specified, follow the reference: show the valid `current`, `branch`, and `worktree` choices when a decision is needed, and make the recommendation explanatory only
|
|
43
|
+
- A user-selected `current` or `branch` remains a serial choice; do not describe it as safe for simultaneous sessions
|
|
44
|
+
|
|
45
|
+
Prepare a new change before running OpenSpec `new`:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
comet classic workspace prepare <name> --isolation <current|branch|worktree> --json
|
|
49
|
+
# enter the returned projectRoot; all later OpenSpec, state, and artifact writes run there
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
The preparation command reuses a registered Worktree whose branch matches the change. If the branch still exists but its registered Worktree was removed, it recreates the Worktree. Ask for an explicit rebind only when the branch was renamed, taken over, or ownership is ambiguous.
|
|
53
|
+
|
|
54
|
+
### 0c. OpenSpec Compatibility Check
|
|
36
55
|
|
|
37
56
|
Before any OpenSpec status or instructions command, run:
|
|
38
57
|
|
|
@@ -145,7 +164,7 @@ Use the Step 1b resolved brief directly to populate artifact content. Fall back
|
|
|
145
164
|
Immediately after creating the change skeleton, initialize recoverable state instead of waiting until every artifact is generated:
|
|
146
165
|
|
|
147
166
|
```bash
|
|
148
|
-
comet state init <name> full
|
|
167
|
+
comet state init <name> full --isolation <selected-isolation>
|
|
149
168
|
comet state select <name>
|
|
150
169
|
comet state check <name> open
|
|
151
170
|
```
|
|
@@ -206,7 +225,7 @@ Proceed to Step 4 after verification passes. The script outputs specific failure
|
|
|
206
225
|
|
|
207
226
|
**Idempotent recovery algorithm**: all open phase operations can be safely re-executed. On recovery, process the status in this order:
|
|
208
227
|
|
|
209
|
-
1. If state is missing, run `comet state init <name> full`; if malformed, stop and repair it instead of overwriting it. Then select the change and run `comet state check <name> open`.
|
|
228
|
+
1. If state is missing, first prepare the workspace with the selected isolation mode, then run `comet state init <name> full --isolation <selected-isolation>` from the returned `projectRoot`; if malformed, stop and repair it instead of overwriting it. Then select the change and run `comet state check <name> open`.
|
|
210
229
|
2. Run status and revalidate `changeRoot`, core ids, `applyRequires`, `artifacts`, and `missingDeps`.
|
|
211
230
|
3. `done`: keep the artifact unchanged and do not regenerate it.
|
|
212
231
|
4. `ready`: fetch its instructions, write the returned output, and immediately rerun status.
|
|
@@ -80,16 +80,16 @@ comet state set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md
|
|
|
80
80
|
|
|
81
81
|
无需手动更新 phase,阶段守卫(guard `--apply`)会在退出条件满足后推进 `phase` 字段。
|
|
82
82
|
|
|
83
|
-
|
|
83
|
+
展示联合决策时,只提供本工作流支持的执行方式、TDD 模式和代码审查模式。工作区已经在 Open 阶段准备并绑定;若当前 change 没有有效 isolation,返回 `/comet-open` 修复,不在 Build 创建或切换工作区。
|
|
84
84
|
|
|
85
|
-
|
|
85
|
+
计划写入后只提供**一个联合决策点**,一次收集:是否现在继续、执行方式、TDD 模式和代码审查模式。不得先询问“继续/暂停”,继续后又创建第二个配置阻塞点。
|
|
86
86
|
|
|
87
87
|
| 选项 | 行为 | 说明 |
|
|
88
88
|
|------|------|------|
|
|
89
|
-
| A | 继续执行并提交配置 | 在同一次回复中选择 Step 3
|
|
89
|
+
| A | 继续执行并提交配置 | 在同一次回复中选择 Step 3 的执行、TDD 和审查配置 |
|
|
90
90
|
| B | 暂停切换模型 | 记录 `build_pause: plan-ready`,本次 `/comet-build` 停止,用户稍后可从 `/comet-classic` 或 `/comet-build` 恢复 |
|
|
91
91
|
|
|
92
|
-
这是用户决策点。**必须按 `comet-classic/reference/decision-point.md` 的协议一次性展示计划摘要、暂停选项和 Step 3
|
|
92
|
+
这是用户决策点。**必须按 `comet-classic/reference/decision-point.md` 的协议一次性展示计划摘要、暂停选项和 Step 3 全部可执行配置**。不得自动选择,也不得把暂停写入 `build_mode`。
|
|
93
93
|
|
|
94
94
|
用户选择继续并给出完整配置时:
|
|
95
95
|
|
|
@@ -113,22 +113,15 @@ comet state set <name> build_pause plan-ready
|
|
|
113
113
|
comet state set <name> build_pause null
|
|
114
114
|
```
|
|
115
115
|
|
|
116
|
-
|
|
116
|
+
然后应用本步骤中的执行方式、TDD 模式和代码审查模式。
|
|
117
117
|
|
|
118
|
-
|
|
118
|
+
计划已写入 Open 阶段准备好的工作区。先确认已有绑定:
|
|
119
119
|
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|------|------|------|
|
|
124
|
-
| A | 当前分支直接工作 | 不创建新分支,如实绑定当前 Git 分支 |
|
|
125
|
-
| B | 创建分支 | 在当前仓库创建新分支,简单快速 |
|
|
126
|
-
| C | 创建 Worktree | 隔离工作区,完全独立,适合并行开发 |
|
|
120
|
+
```bash
|
|
121
|
+
comet state get <name> isolation
|
|
122
|
+
```
|
|
127
123
|
|
|
128
|
-
|
|
129
|
-
- 用户明确希望沿用当前分支,或当前分支本身就是该 change 的目标分支 → 推荐 A
|
|
130
|
-
- 变更涉及 ≤ 3 个文件且当前分支干净 → 推荐 B
|
|
131
|
-
- 需要并行开发、当前分支有未提交工作 → 推荐 C
|
|
124
|
+
如果结果为空,停止 Build 并返回 `/comet-open` 执行 workspace resolve/prepare;不得在本步骤首次选择或创建 current、branch、worktree。
|
|
132
125
|
|
|
133
126
|
**执行方式**:
|
|
134
127
|
|
|
@@ -142,13 +135,9 @@ comet state set <name> build_pause null
|
|
|
142
135
|
- 任务数 ≤ 2 且无跨模块依赖 → 推荐 B
|
|
143
136
|
- 来自 hotfix 路径 → 推荐 B
|
|
144
137
|
|
|
145
|
-
|
|
138
|
+
执行方式、TDD 和审查表格是 Step 2 联合决策的一部分,不再单独暂停。不得用推荐规则替代用户确认。
|
|
146
139
|
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
```bash
|
|
150
|
-
comet state set <name> isolation <current|branch|worktree>
|
|
151
|
-
```
|
|
140
|
+
用户选择后,只更新执行方式、TDD 模式和代码审查模式相关字段;保留 Open 阶段已绑定的 `isolation` 和 `bound_branch`。
|
|
152
141
|
|
|
153
142
|
- 若用户选择 `executing-plans`:运行 `comet state set <name> subagent_dispatch null`,再运行 `comet state set <name> build_mode executing-plans`
|
|
154
143
|
- 若用户选择 `subagent-driven-development`:先运行 `comet state set <name> subagent_dispatch confirmed` 记录已选择子代理执行,再运行 `comet state set <name> build_mode subagent-driven-development`
|
|
@@ -172,7 +161,7 @@ comet state set <name> isolation <current|branch|worktree>
|
|
|
172
161
|
|
|
173
162
|
运行 `comet state set <name> review_mode <off|standard|thorough>`
|
|
174
163
|
|
|
175
|
-
`isolation` 是脚本级硬约束。full workflow
|
|
164
|
+
`isolation` 是脚本级硬约束。full workflow 必须在 Open 阶段写入 `current`、`branch` 或 `worktree`,并在进入 Build 前完成对应 workspace 准备和 `bound_branch` 绑定;若缺失,Build 只能停止并返回 Open 修复。
|
|
176
165
|
|
|
177
166
|
`subagent_dispatch` 是脚本级硬约束,用于记录用户已选择子代理执行。`build_mode: subagent-driven-development` 离开 build 阶段前必须同时满足 `subagent_dispatch: confirmed`,否则 `comet guard build --apply` 和 `comet state transition build-complete` 都会失败;它不是能力检查。
|
|
178
167
|
|
|
@@ -189,39 +178,9 @@ comet state set <name> build_mode direct
|
|
|
189
178
|
|
|
190
179
|
没有 `direct_override: true` 时,full workflow 的 `build_mode=direct` 会被 guard 和状态转换同时拦截。
|
|
191
180
|
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
- **current**:不创建新分支或 worktree,直接在当前 Git 分支执行。立即运行 `comet state set <name> isolation current`;该命令会把当前分支写入 `bound_branch`。如果当前是 detached HEAD,必须停止并让用户先切回真实分支,因为没有可审计的绑定分支。
|
|
195
|
-
|
|
196
|
-
- **branch**:使用 Step 2 已确认的分支名,不得再次暂停。若旧状态恢复时缺少该次联合决策中的分支名,重新进入 Step 2 的同一个联合决策;不得创建第二个独立分支命名决策点。
|
|
197
|
-
|
|
198
|
-
分支命名规范:
|
|
199
|
-
- 读取 `.comet.yaml` 的 `workflow` 字段确定前缀
|
|
200
|
-
- `workflow: full` → 推荐 `feature/YYYYMMDD/<change-name>`
|
|
201
|
-
- `workflow: hotfix` → 推荐 `hotfix/YYYYMMDD/<change-name>`
|
|
202
|
-
- `workflow: tweak` → 推荐 `tweak/YYYYMMDD/<change-name>`
|
|
203
|
-
- 日期取当前运行环境日期并格式化为 `YYYYMMDD`,不得依赖某一种 shell 的日期命令
|
|
204
|
-
|
|
205
|
-
示例:如果 change 名称为 `fix-login-bug`,今天是 2026-06-09,则推荐 `feature/20260609/fix-login-bug`
|
|
206
|
-
|
|
207
|
-
分支名由 Step 2 确认后,立即执行 `git checkout -b <branch-name>`,然后运行 `comet state set <name> isolation branch`,把新分支写入 `bound_branch`。后续工作在新分支上进行。
|
|
208
|
-
|
|
209
|
-
- **worktree**:**立即执行:** 使用 Skill 工具加载 Superpowers `using-git-worktrees` 技能创建隔离工作区。禁止用普通 shell 命令或原生工具绕过该技能;若加载时因不可用而失败,停止并报告该错误。
|
|
210
|
-
|
|
211
|
-
创建隔离后,确认计划文件可访问(分支方式天然可访问;worktree 方式需确认计划已提交)。若 worktree 模式下计划文件尚未提交,先提交计划文件再创建 worktree:
|
|
212
|
-
|
|
213
|
-
```bash
|
|
214
|
-
git add docs/superpowers/plans/YYYY-MM-DD-feature.md
|
|
215
|
-
git commit -m "chore: add implementation plan"
|
|
216
|
-
```
|
|
217
|
-
|
|
218
|
-
进入最终执行分支或 worktree 后,必须在该实际工作区重新绑定当前 change。branch 模式已在切换后通过 `isolation branch` 绑定;worktree 模式必须在新工作区运行 `comet state set <name> isolation worktree`,把 worktree 的当前分支写入 `bound_branch`。新 worktree 不会继承原工作区的本地选择文件,因此还必须选择当前 change:
|
|
219
|
-
|
|
220
|
-
```bash
|
|
221
|
-
comet state select <change-name>
|
|
222
|
-
```
|
|
181
|
+
**执行位置**:
|
|
223
182
|
|
|
224
|
-
|
|
183
|
+
Open 阶段已经根据 `isolation` 准备好当前目录、分支或 Worktree,并返回了实际 `projectRoot`。恢复时先运行 `comet classic workspace resolve <name> --json`,进入返回目录,再运行 `comet state select <change-name>`;不得在 Build 再创建 Worktree、切换分支、提交计划以跨 Worktree 传递,或重新绑定 isolation。
|
|
225
184
|
|
|
226
185
|
**执行计划**:必须按 `build_mode` 的真实运行位置处理。
|
|
227
186
|
|
|
@@ -45,9 +45,13 @@ agent 做决策只需读本节,参考附录按需查阅。
|
|
|
45
45
|
当 runtime route、Ambient Resume 或用户选择已经解析出明确 change 后,进入对应阶段 Skill 前必须先绑定当前执行上下文:
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
|
+
comet classic workspace resolve <change-name> --json
|
|
49
|
+
# 进入返回的 projectRoot;state select 会在该工作区写入选择
|
|
48
50
|
comet state select <change-name>
|
|
49
51
|
```
|
|
50
52
|
|
|
53
|
+
新 change 的 workspace 决策在 `/comet-open` 完成,并遵循 `comet-classic/reference/workspace.md`:用户明确表达并行、同时处理或多个会话时,在绑定前准备 Worktree;未指定隔离方式时,需要决策就把 `current`、`branch`、`worktree` 作为单选项展示,推荐只作说明。准备和恢复都会扫描已登记 Worktree,优先复用分支匹配的工作区;当分支已重命名、被用户接管或无法确认归属时请求 rebind。
|
|
54
|
+
|
|
51
55
|
多个 active change 且用户尚未明确选择时,不得提前绑定;继续按 `ask_user` 决策点等待选择。
|
|
52
56
|
|
|
53
57
|
### Comet Ambient Resume
|
|
@@ -131,7 +135,8 @@ comet resume-probe . --stdin --json
|
|
|
131
135
|
- 若 `build_pause: plan-ready` 但 `isolation`、`build_mode`、`tdd_mode` 和 `review_mode` 都已经设置,则视为 stale pause:先输出 `[COMET] 检测到 stale pause(build_pause=plan-ready 但 isolation/build_mode/tdd_mode/review_mode 已设置),自动清除并继续`,再运行 `comet state set <name> build_pause null`,然后读取 tasks.md 的下一个未勾选任务并按 `build_mode` 恢复执行
|
|
132
136
|
- 若 `build_pause: plan-ready` 且 plan 文件存在,但 `isolation`、`build_mode`、`tdd_mode` 或 `review_mode` 尚未设置,回到 `/comet-build` 的 plan-ready 恢复点,提示用户继续补齐/确认工作区隔离、执行方式、TDD 模式和代码审查模式,不重新生成 plan
|
|
133
137
|
- 若 `build_pause: plan-ready` 但 plan 文件缺失,回到 `/comet-build` 处理状态损坏或重新生成 plan
|
|
134
|
-
-
|
|
138
|
+
- 若旧 change 的 `isolation` 未设置,先回到 `/comet-open` 执行 workspace resolve/prepare;不得在 Build 首次决定工作区
|
|
139
|
+
- 若 `build_mode`、`tdd_mode` 或 `review_mode` 未设置,回到 `/comet-build` 对应步骤补充后再执行
|
|
135
140
|
- 若均已设置,读取 tasks.md 的下一个未勾选任务,并按 `build_mode` 恢复执行:
|
|
136
141
|
- 若 `build_mode: subagent-driven-development`,不得在主窗口直接执行任务;必须回到 `/comet-build` 的后台 subagent 调度规则,由主窗口只做协调
|
|
137
142
|
- 其他执行方式按 `/comet-build` 的对应规则继续
|
|
@@ -194,13 +199,14 @@ hotfix/tweak 的范围判定采用三层分工,避免「用纯文件数当硬
|
|
|
194
199
|
1. workflow 目标选择:多个 active changes、继续现有 change/创建新 change、或批量拆分完成后选择先启动哪一个
|
|
195
200
|
2. open 阶段 proposal/design/tasks 最终审视确认(同时确认 change 名称与范围;清晰请求不做前置摘要/命名确认)
|
|
196
201
|
3. brainstorming 确认设计方案
|
|
197
|
-
4.
|
|
198
|
-
5.
|
|
199
|
-
6.
|
|
200
|
-
7.
|
|
201
|
-
8.
|
|
202
|
-
9.
|
|
203
|
-
10.
|
|
202
|
+
4. open 阶段工作区决策:明确并行自动使用 Worktree;未指定隔离方式且需要决策时,将合法的 `current`、`branch`、`worktree` 作为单选项展示
|
|
203
|
+
5. build 阶段一次性联合选择 plan-ready 暂停、执行方式、TDD 模式和代码审查模式
|
|
204
|
+
6. verify 阶段接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移,或第 4 次失败后选择继续修复/停止;前 3 次明确可修复失败自动闭环
|
|
205
|
+
7. archive 阶段执行归档脚本前的最终确认
|
|
206
|
+
8. 归档改动精确提交后选择 finishing-branch 分支处理方式
|
|
207
|
+
9. 遇到升级判定信号(hotfix/tweak → 用户二选一:继续预设流程 / 升级完整流程)
|
|
208
|
+
10. build 阶段范围扩张需重新设计或拆分新 change
|
|
209
|
+
11. open 阶段大型 PRD 是否拆分为多个 changes
|
|
204
210
|
|
|
205
211
|
agent 不应跳过这些决策点;其他明确无歧义的阶段衔接必须自动继续推进,不得中途退出。到达决策点时,**禁止跳过用户确认或自动选择——必须提出明确选项并获取用户选择后才能继续**。
|
|
206
212
|
|
|
@@ -47,7 +47,7 @@ archived: false
|
|
|
47
47
|
| `subagent_dispatch` | `null` 或 `confirmed`。`confirmed` 记录用户已选择 `subagent-driven-development`;该模式只有带此记录时才能离开 build 阶段 |
|
|
48
48
|
| `tdd_mode` | `tdd` 或 `direct`。full workflow 离开 build 阶段前必须已选择。`tdd` 强制每个任务先写失败测试再实现;`direct` 不强制逐任务 TDD,但仍需相关测试与 bug 回归证据。hotfix/tweak 默认 `direct` |
|
|
49
49
|
| `review_mode` | `off`、`standard` 或 `thorough`。full workflow 离开 build 阶段前必须已选择;hotfix/tweak 默认 `off` |
|
|
50
|
-
| `isolation` | `current`、`branch` 或 `worktree`。full
|
|
50
|
+
| `isolation` | `current`、`branch` 或 `worktree`。full change 在 Open 阶段创建产物前决定工作区;hotfix/tweak 在入口决策点后也可如实使用三种模式,不得在未创建分支时虚构为 `branch` |
|
|
51
51
|
| `bound_branch` | 工作区分支绑定记录,可为空。`isolation: current` / `branch` / `worktree` 首次设置或入口检查时记录命令执行目录所在的当前 Git 分支(worktree 模式请在对应工作区内执行 set/check/guard,否则会绑定/比对错误的分支);在不同工作区模式之间切换 `isolation` 会重新绑定到当前分支,重复设置同一模式保持原绑定。后续 `comet state select` / `comet state check` 必须确认绑定分支与当前分支一致;漂移时 `select` 直接拒绝、检查进入 `BLOCKED`,按决策点协议让用户选择切回绑定分支或明确确认后运行 `comet state rebind <change-name>`。清空 `isolation` 时会清空该字段 |
|
|
52
52
|
| `verify_mode` | `light` 或 `full`,可为空 |
|
|
53
53
|
| `auto_transition` | `true` 或 `false`。只控制阶段守卫推进 phase 后是否自动调用下一个 skill;`false` 时由 `comet-state next` 输出 `manual`,暂停下一 skill 调用,但不阻止 phase 字段更新 |
|
|
@@ -13,6 +13,8 @@
|
|
|
13
13
|
日常工作流统一调用公开 CLI:
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
|
+
comet classic workspace prepare <change-name> --isolation <current|branch|worktree> --json
|
|
17
|
+
comet classic workspace resolve <change-name> --json
|
|
16
18
|
comet state select <change-name>
|
|
17
19
|
comet state current
|
|
18
20
|
comet state clear-selection
|
|
@@ -24,7 +26,7 @@ comet resume-probe . --stdin --json
|
|
|
24
26
|
comet classic intent route --stdin
|
|
25
27
|
```
|
|
26
28
|
|
|
27
|
-
|
|
29
|
+
在 Open 阶段先运行 workspace prepare;恢复时运行 workspace resolve,它会扫描已登记 Worktree 并返回应进入的 `projectRoot`。进入明确的 change 后再运行 `comet state select <change-name>`。普通源码写入只受该选择管辖;尚未选择时 hook 会阻塞并要求选择。切换 branch/worktree 或选择失效后必须重新运行 resolve 和 select。
|
|
28
30
|
|
|
29
31
|
guard 的 `--apply` 在检查通过后推进状态。需要直接表达状态事件时使用 `comet state transition`;阶段推进后使用 `comet state next` 解析是否自动调用下一 Skill。
|
|
30
32
|
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Classic 工作区选择参考
|
|
2
|
+
|
|
3
|
+
只在创建 change 时读取。已有 change 应使用已持久化的工作区绑定,并路由到返回的 `projectRoot`。
|
|
4
|
+
|
|
5
|
+
用户明确表达并行、同时处理或多个会话时,直接使用 `worktree`,不再询问三种方式。未指定隔离方式且没有明确并行意图时,出现以下任一情况才询问用户:
|
|
6
|
+
|
|
7
|
+
- 当前目录有未提交工作;
|
|
8
|
+
- 已有其他 active Classic change;
|
|
9
|
+
- 用户要求并行开发或隔离工作,但没有指定方式。
|
|
10
|
+
|
|
11
|
+
没有这些情况时使用 Runtime 默认的 `current`。
|
|
12
|
+
|
|
13
|
+
需要询问时,把隔离方式作为一个单选决策点:
|
|
14
|
+
|
|
15
|
+
| 选项 | 方式 | 实际影响 |
|
|
16
|
+
| --- | --- | --- |
|
|
17
|
+
| A | 当前目录(`current`) | 沿用当前分支和目录,不创建新的 Git 分支或工作目录 |
|
|
18
|
+
| B | 新分支(`branch`) | 在当前目录切换到新的 change 分支;要求当前工作区干净 |
|
|
19
|
+
| C | 新 worktree(`worktree`) | 创建或复用独立分支和工作目录,适合并行 change 或当前目录已有未提交工作 |
|
|
20
|
+
|
|
21
|
+
展示与当前状态和用户要求一致的全部合法选项,不因预判后续命令可能失败而额外筛选。用户明确要沿用当前分支时推荐 A;需要独立分支且无需并行工作时推荐 B;需要并行开发、当前目录已有工作,或已有 active Classic change 时推荐 C。
|
|
22
|
+
|
|
23
|
+
推荐只作说明,等待用户选择后再创建。已有 change 分支如果已经登记在 Worktree 中,Runtime 会复用它;如果分支仍存在但登记的 Worktree 已被移除,Runtime 会重建它。只有分支已重命名、被用户接管或归属无法确认时,才按恢复协议请求 rebind。提问方式遵循[澄清参考](decision-point.md):优先使用结构化单选工具;工具不可用时使用编号文本并暂停等待。只有一个合法选项时,说明原因并直接采用。
|
|
@@ -6,30 +6,26 @@ description: "Comet Native 工作流。当用户明确调用 /comet-native、要
|
|
|
6
6
|
# Comet Native
|
|
7
7
|
|
|
8
8
|
Native 把需求、完整目标规格、当前进度和验收结论保存在项目中。每完成一个阶段都回到 Runtime 读取下一步,当前只处理 Runtime 指定的阶段。
|
|
9
|
-
|
|
10
9
|
## 硬性边界
|
|
11
10
|
|
|
12
11
|
- 磁盘中的 `.comet/config.yaml`、当前 change、`comet-state.yaml` 和正式 Markdown 是工作依据,聊天记忆只作辅助。
|
|
13
|
-
- Runtime 管理工作流状态、本机任务、日志、锁和事务;所有阶段推进都通过 PATH 中公开的 `comet native`
|
|
12
|
+
- Runtime 管理工作流状态、本机任务、日志、锁和事务;所有阶段推进都通过 PATH 中公开的 `comet native` 命令完成,用户不手工执行这些命令。
|
|
14
13
|
- 命令不可用时报告 Comet 安装不完整并停止。参数和输出以 `comet native <command> --help` 为准。
|
|
15
14
|
- Builder 提交候选,新的只读 Verifier subagent 或独立 Agent 任务作出验收判断。
|
|
16
15
|
- Native 主流程由本 Skill 和 Runtime 完成,不依赖任何外部 Skill。
|
|
17
|
-
|
|
18
16
|
## 开始或恢复
|
|
19
17
|
|
|
20
18
|
1. 已知 change 名称时,直接运行 `comet native status <change-name> --details --json`;名称未知时才运行 `comet native status --json`,确定目标后再查询该 change 的详细状态。
|
|
21
19
|
2. 当前阶段需要完整验收列表时才执行 `nextPageArgs` 中的分页命令;需要编辑或核对正式正文时才运行 `show` 或读取对应 brief/Spec。
|
|
22
|
-
3. active change 已存在时,进入返回的 `workspace.projectRoot` 并 `select
|
|
20
|
+
3. active change 已存在时,进入返回的 `workspace.projectRoot` 并 `select`。Runtime 会扫描已登记 Worktree,优先返回绑定分支匹配的工作区;只有多个同样匹配的候选才让用户选择。
|
|
23
21
|
4. 没有对应 active change 时才创建,并使用配置指定的产物目录。
|
|
24
|
-
|
|
25
22
|
### 创建 change
|
|
26
23
|
|
|
27
|
-
先确定小写 kebab-case 名称,再按[工作区选择参考](reference/workspace.md)决定使用当前目录、创建分支还是创建 worktree
|
|
24
|
+
先确定小写 kebab-case 名称,再按[工作区选择参考](reference/workspace.md)决定使用当前目录、创建分支还是创建 worktree。用户明确说并行、同时处理或多个会话时自动选择 `worktree`,不再询问三种方式。
|
|
28
25
|
|
|
29
|
-
CLI
|
|
26
|
+
CLI 会在创建 change 前完成分支或 worktree 绑定、复用已登记的 change 分支、在分支仍存在但登记 Worktree 已移除时重建 Worktree、维护仓库本地排除规则、核对配置并创建可跨设备恢复的状态。随后进入命令返回的 `preparation.projectRoot`;后续命令不得继续在原目录执行。
|
|
30
27
|
|
|
31
28
|
如果准备没有完成,保留已经创建的资源,展示 `preparation` 中的失败原因,并按 Runtime 或用户给出的恢复方向继续。
|
|
32
|
-
|
|
33
29
|
## 按需读取
|
|
34
30
|
|
|
35
31
|
确认 phase 后只读取需要的一份 reference:
|
|
@@ -38,13 +34,16 @@ CLI 会完成分支或 worktree 绑定、维护仓库本地排除规则、核对
|
|
|
38
34
|
- 实际编辑 brief/完整目标规格,或查看验收报告时读取[产物参考](reference/artifacts.md);
|
|
39
35
|
- 正常推进时,直接执行 Runtime 在 `continuation` 中给出的命令。只有返回字段含义不清、命令输入被拒绝、无法启动 Verifier、Verifier 执行报错,或 Verifier 要求用户补充信息时,才读取[命令参考](reference/commands.md);
|
|
40
36
|
- 只有任务因进程中断、换设备后本机状态缺失、连续多轮没有进展、并发冲突、旧版本迁移失败或状态损坏而无法继续时,才读取[恢复参考](reference/recovery.md)。
|
|
41
|
-
|
|
42
37
|
## Shape
|
|
43
38
|
|
|
44
39
|
先调查能够从仓库、工具和运行环境确定的事实;彼此独立的事实可以交给 subagent 调查。按 `native.clarification_mode` 和澄清参考维护决策树,只把会改变用户可见结果、又无法可靠推断的决定交给用户。
|
|
45
40
|
|
|
46
|
-
确认后的用户可见决定和重要约束立即同步到 Decisions、brief
|
|
41
|
+
确认后的用户可见决定和重要约束立即同步到 Decisions、brief 和完整目标规格;普通实现选择保留在实现和测试中,只有影响用户可见行为时才进入正式需求。验收项必须具体、可观察且互不重复。大型需求需要拆分时,在 Supervisor Change 根目录维护 `children.yaml`,用 `depends_on` 表达真实先后关系,并用 `covers` 覆盖 Supervisor Change 验收项;数组顺序只用于稳定展示和同等就绪时的优先级。
|
|
47
42
|
|
|
43
|
+
大型需求在最终 Shape 确认前执行一次拆分检测:只有至少两个结果可独立实现和验证、验收项能完整映射且有真实依赖/并行价值时建议 Supervisor Change 模式;目标紧耦合、反复修改同一核心区域、协调成本更高或用户要求单 change 时保持单一 Native change;需求文字长、任务条目多本身不能触发拆分。
|
|
44
|
+
建议拆分时,Skill 将 `children.yaml` 草案、执行波次和验收覆盖摘要放入一次 Shape 确认;用户可确认、调整或保持单 change。确认前不得创建子 change、worktree 或派发 Agent。
|
|
45
|
+
确认后,Skill 从 Runtime 的 `readyChildren` 自动派发当前可执行子 change;支持并行时同时推进,不支持并行时按顺序执行。子 change 范围严格继承父确认,出现新的用户可见决定时回到父 Shape。
|
|
46
|
+
恢复 `/comet-native` 时根据 Runtime 状态继续,不重复创建已有 child 或 worktree。
|
|
48
47
|
未解决问题保持 `[blocking]`;有阻塞项时不修改项目实现。完成标准:所有会影响用户可见结果的选择和未明说的假设均已处理,没有 `[blocking]`,用户明确确认目标、范围、关键决定、验收项和非目标,并且 Runtime 已进入 Build。只有用户明确确认后才使用后续指令中含 `--confirmed` 的命令推进。
|
|
49
48
|
|
|
50
49
|
## Build ↔ Verify Loop
|
|
@@ -57,6 +56,10 @@ Build 和 Verify 组成一个有界验收循环(Loop):Builder 提交候选
|
|
|
57
56
|
|
|
58
57
|
首次实现时读取当前 brief、完整目标规格和全部验收项。如果 Verify 未通过并返回 Build,先处理 Verifier 指出的未通过项、无法继续验证的问题和失败检查;再次提交前重新核对完整规格与全部验收项,避免只修报错点而遗漏其他要求。
|
|
59
58
|
|
|
59
|
+
确认一次 Supervisor Change Shape 即授权严格派生的子 change,不要求用户重复确认相同范围。Skill 只执行 Runtime continuation 返回的动作,并在每个 child 完成后重新读取 `readyChildren`,继续下一波;Supervisor Change 最后仍由 Verify 验证完整验收项。
|
|
60
|
+
|
|
61
|
+
状态包含 `children` 时,当前 change 是 Supervisor Change:不要运行 Supervisor Change Builder,只推进 `readyChildren`。每个 child 都是普通 Native change,必须在独立 worktree 中创建,以 Supervisor Change 的 `workspace.changeBranch` 为目标分支;没有依赖的 child 可以并行 Build/Verify,但 Archive 必须逐个使用 `finish=merge` 合入 Supervisor Change 分支。先提交 Supervisor Change 契约基线以保持集成工作区干净;只有 child 的 Archive 已合入 Supervisor Change 分支才算 `done`,随后才从更新后的 Supervisor Change HEAD 创建依赖它的 child。全部 child 为 `done` 后,执行 Supervisor Change continuation 进入 Verify,由新的 Verifier 在最终集成分支上检查 Supervisor Change 的完整验收项。Supervisor Change Verify 未通过时不要重开已归档 child;按 `repair-child` 提示在 `children.yaml` 中追加覆盖失败验收项的唯一 repair child,重新确认 Supervisor Change Shape 后继续。
|
|
62
|
+
|
|
60
63
|
需求变化时先判断归属:
|
|
61
64
|
|
|
62
65
|
- 当前需求只是实现有遗漏:从 Verify 或 Archive 使用 `--return-to-build` 回到 Build;
|
|
@@ -10,11 +10,12 @@
|
|
|
10
10
|
<artifact-root>/comet/changes/<change-name>/
|
|
11
11
|
comet-state.yaml
|
|
12
12
|
brief.md
|
|
13
|
+
children.yaml
|
|
13
14
|
specs/<capability>/spec.md
|
|
14
15
|
verification.md
|
|
15
16
|
```
|
|
16
17
|
|
|
17
|
-
Agent 只编辑 brief
|
|
18
|
+
Agent 只编辑 brief、完整目标规格和 Supervisor Change 的 `children.yaml`。`comet-state.yaml` 与 `verification.md` 由 Runtime 管理;Runtime 第一次接受 Verifier 结果后生成报告。
|
|
18
19
|
|
|
19
20
|
本机 Runtime 固定保存在被 Git 忽略的 `.comet/runtime/native/`。每个 active change 的本机状态和日志位于 `changes/<change-name>/state.json` 与 `logs/`;项目级锁和短期事务也放在这个 Runtime 目录中。这些机器文件始终交给 Runtime 创建、迁移和修复。
|
|
20
21
|
|
|
@@ -51,7 +52,7 @@ Open questions 中只有真实未解决的用户问题使用:
|
|
|
51
52
|
|
|
52
53
|
每个决定确认后立即写入 Decisions 和完整目标规格,再移除对应阻塞项。正式产物只记录结论和理由,不记录模型的隐藏推理过程。
|
|
53
54
|
|
|
54
|
-
验收标准必须具体、可观察且互不重复。使用简单顺序 ID,例如 `A1`、`A2`、`A3`;ID 只用于结果映射,不从内容计算,也不代表文件身份。Runtime 在 Shape 确认时保存完整验收文字及其来源。
|
|
55
|
+
验收标准必须具体、可观察且互不重复。使用简单顺序 ID,例如 `A1`、`A2`、`A3`;ID 只用于结果映射,不从内容计算,也不代表文件身份。Runtime 在 Shape 确认时保存完整验收文字及其来源。Supervisor Change 的 `children.yaml` 使用 `comet.native.children.v1`,每个 child 只包含 `name`、`depends_on` 和 `covers`。名称必须唯一,依赖必须存在且无环,全部 Supervisor Change 验收 ID 都必须被覆盖。Runtime 将其与 Supervisor Change 验收项一起确认;修改后 Supervisor Change 返回 Shape。
|
|
55
56
|
|
|
56
57
|
## 完整目标规格
|
|
57
58
|
|
|
@@ -17,7 +17,7 @@ comet native <group> <command> --help
|
|
|
17
17
|
- `inputOptions`:这次命令需要填写的字段和 JSON 模板;
|
|
18
18
|
- `workspace` / `preparation`:实际工作目录和 change 创建结果;
|
|
19
19
|
- `stateVersion` / `loop`:当前状态版本和验收循环进度;
|
|
20
|
-
- `acceptance` / `nextPageArgs
|
|
20
|
+
- `acceptance` / `children` / `readyChildren` / `nextPageArgs`:验收摘要、Supervisor Change 的子项投影、当前可启动子项和下一页查询命令;
|
|
21
21
|
- `verifierDispatch`:启动独立 Verifier 所需的输入;
|
|
22
22
|
- `workspaceFinishResult` / `recoveryArgs`:归档后的工作区收尾结果和恢复命令。
|
|
23
23
|
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
`comet-state.yaml` 记录最后一个可以安全恢复的工作流状态。本机 `state.json` 只说明这台机器正在执行什么;如果它缺失、版本落后或属于旧任务,Runtime 会根据 YAML、brief 和目标 Spec 重建。本机状态不能覆盖版本更新的 YAML。
|
|
20
20
|
|
|
21
21
|
- Shape:保持 Shape,继续澄清或确认。
|
|
22
|
-
- Build:如果 Runtime 显示 `repairing`,表示 Verify 未通过后已返回 Build
|
|
22
|
+
- Build:如果 Runtime 显示 `repairing`,表示 Verify 未通过后已返回 Build。普通 change 保持当前验收轮次并继续修改;Supervisor Change 按 `repair-child` 追加覆盖失败验收项、尚未完成的 child,不重开已经归档的 child。
|
|
23
23
|
- Verify(`verify-ready`):重新运行当前候选的必要检查,并启动新的 Verifier;旧设备上的通过结果不再沿用。
|
|
24
24
|
- Archive(`archive-ready`):先安全返回 Verify,把验收结果重置为待检查(`pending`),再验收已经同步到新设备的实现。
|
|
25
25
|
- 等待用户或阻塞(`await-user` / `blocked`):恢复原来的阻塞原因、负责处理的人和允许动作,等待对应条件满足后再继续。
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Native 工作区选择参考
|
|
2
2
|
|
|
3
|
-
只在创建 change
|
|
3
|
+
只在创建 change 时读取。Supervisor Change 的 `readyChildren` 固定使用独立 `worktree`,并以 Supervisor Change 的 `workspace.changeBranch` 为目标分支;其他 change 在用户已经指定 `current`、`branch` 或 `worktree` 时直接采用。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
明确表达并行、同时处理或多个会话时,直接使用 `worktree`,不再询问三种方式。未指定隔离方式且没有明确并行意图时,出现以下任一情况才询问用户:
|
|
6
6
|
|
|
7
7
|
- 当前目录有未提交工作;
|
|
8
8
|
- 已有其他 active Native change;
|
|
@@ -16,8 +16,8 @@
|
|
|
16
16
|
| --- | --- | --- |
|
|
17
17
|
| A | 当前目录(`current`) | 沿用当前分支和目录,不创建新的 Git 分支或工作目录 |
|
|
18
18
|
| B | 新分支(`branch`) | 在当前目录切换到新的 change 分支;要求当前工作区干净 |
|
|
19
|
-
| C | 新 worktree(`worktree`) |
|
|
19
|
+
| C | 新 worktree(`worktree`) | 创建或复用独立分支和工作目录,适合并行 change 或当前目录已有未提交工作 |
|
|
20
20
|
|
|
21
21
|
展示与当前状态和用户要求一致的全部合法选项,不因预判后续命令可能失败而额外筛选。用户明确要沿用当前分支时推荐 A;需要独立分支且无需并行工作时推荐 B;需要并行开发、当前目录已有工作,或已有 active Native change 时推荐 C。
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
推荐只作说明,等待用户选择后再创建。已存在的 change 分支如果已经登记在 Worktree 中,Runtime 会复用它;如果分支仍存在但登记 Worktree 已被移除,Runtime 会重建它。只有分支已重命名、被用户接管或归属无法确认时,才按恢复协议请求 rebind。提问方式遵循[澄清参考](clarification.md):优先使用结构化单选工具;工具不可用时使用编号文本并暂停等待。只有一个合法选项时,说明原因并直接采用。
|
|
@@ -22,17 +22,36 @@ disable-model-invocation: true
|
|
|
22
22
|
|
|
23
23
|
恢复已有 change 时先检查 `<classic-change-dir>/.comet.yaml`:
|
|
24
24
|
|
|
25
|
-
-
|
|
26
|
-
- 状态文件缺失但 change
|
|
25
|
+
- 状态文件存在且可解析:先运行 `comet classic workspace resolve <change-name> --json`,进入返回的 `projectRoot` 后再选择 change
|
|
26
|
+
- 状态文件缺失但 change 目录有效:先使用所选隔离方式准备工作区,再进入返回的 `projectRoot` 运行 `comet state init <change-name> full --isolation <selected-isolation>`,最后选择 change
|
|
27
27
|
- 状态文件格式异常:停止并报告解析错误;从版本控制、备份或可验证产物人工修复后再继续,不得用 `state set` 覆盖损坏文件
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
|
+
comet classic workspace resolve <change-name> --json
|
|
31
|
+
# 进入返回的 projectRoot
|
|
30
32
|
comet state select <change-name>
|
|
31
33
|
```
|
|
32
34
|
|
|
33
35
|
创建新 change 时,必须先完成 `.comet.yaml` 初始化,再立即运行同一命令;状态文件不存在前不得伪造选择。
|
|
34
36
|
|
|
35
|
-
### 0b.
|
|
37
|
+
### 0b. Open 前工作区决策与准备
|
|
38
|
+
|
|
39
|
+
创建 Classic change 时读取 `comet-classic/reference/workspace.md`。工作区决策必须在创建 OpenSpec artifacts 和 `.comet.yaml` 之前完成,不能推迟到 Build:
|
|
40
|
+
|
|
41
|
+
- 用户明确表达并行意图时直接使用 `worktree`,确保在创建 OpenSpec 和 state 前准备好独立工作区
|
|
42
|
+
- 未指定隔离方式时按参考文档处理:需要决策时展示合法的 `current`、`branch`、`worktree` 选项,推荐只作说明
|
|
43
|
+
- 用户选择的 `current` 或 `branch` 仍表示串行方式,不得把它描述为适合同时会话
|
|
44
|
+
|
|
45
|
+
新 change 在运行 OpenSpec `new` 前准备工作区:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
comet classic workspace prepare <name> --isolation <current|branch|worktree> --json
|
|
49
|
+
# 进入返回的 projectRoot;后续 OpenSpec、state 和产物写入都必须在该目录执行
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
准备命令会复用已登记且分支匹配的 Worktree;分支仍存在但登记的 Worktree 已被移除时会重建。只有分支已重命名、被用户接管或无法确认归属时,才暂停请求显式 rebind。
|
|
53
|
+
|
|
54
|
+
### 0c. OpenSpec 兼容性检查
|
|
36
55
|
|
|
37
56
|
在任何 OpenSpec 状态或指令命令前运行:
|
|
38
57
|
|
|
@@ -145,7 +164,7 @@ resolved brief 或 change 名称仍不明确时不得运行 `comet classic opens
|
|
|
145
164
|
change 骨架创建后立即初始化可恢复状态,不能等 artifacts 全部生成后再写 `.comet.yaml`:
|
|
146
165
|
|
|
147
166
|
```bash
|
|
148
|
-
comet state init <name> full
|
|
167
|
+
comet state init <name> full --isolation <selected-isolation>
|
|
149
168
|
comet state select <name>
|
|
150
169
|
comet state check <name> open
|
|
151
170
|
```
|
|
@@ -206,7 +225,7 @@ comet state check <name> open
|
|
|
206
225
|
|
|
207
226
|
**幂等恢复算法**:open 阶段所有操作可安全重复执行。恢复时按以下顺序处理:
|
|
208
227
|
|
|
209
|
-
1.
|
|
228
|
+
1. 状态文件缺失时先使用所选隔离方式准备工作区,再进入返回的 `projectRoot` 运行 `comet state init <name> full --isolation <selected-isolation>`;格式异常时停止并修复,不得覆盖。随后选择 change 并运行 `comet state check <name> open`。
|
|
210
229
|
2. 运行 `comet classic openspec -- status --change "<name>" --json`,重新验证 `changeRoot`、核心 ID、`applyRequires`、`artifacts` 和 `missingDeps`。
|
|
211
230
|
3. `done`:该 artifact 已完成,保持原文件不变,不重复生成。
|
|
212
231
|
4. `ready`:依赖已经满足,可以生成。先运行 `comet classic openspec -- instructions <artifact-id> --change "<name>" --json`,按返回内容写入;写完后立刻重新运行 status。
|
package/dist/app/cli/index.js
CHANGED
|
@@ -153,7 +153,15 @@ program
|
|
|
153
153
|
.option('--manifest <path>', 'Path to comet/eval.yaml')
|
|
154
154
|
.option('--skill-path <path>', 'Local Skill directory or SKILL.md')
|
|
155
155
|
.option('--skill-name <name>', 'Skill name used with --skill-path')
|
|
156
|
-
.
|
|
156
|
+
.option('--agent <agent>', 'Evaluation agent (built-in or explicitly installed custom adapter)')
|
|
157
|
+
.option('--model <model>', 'Main evaluation model override')
|
|
158
|
+
.option('--base-url <url>', 'Main evaluation API base URL override')
|
|
159
|
+
.option('--judge-agent <agent>', 'Independent Judge agent (built-in or installed custom adapter)')
|
|
160
|
+
.option('--judge-model <model>', 'Independent Judge model (required when enabled)')
|
|
161
|
+
.option('--judge-base-url <url>', 'Independent Judge API base URL override')
|
|
162
|
+
.addOption(new Option('--suite <suite>', 'Eval suite')
|
|
163
|
+
.choices(['local', 'langsmith', 'langfuse'])
|
|
164
|
+
.default('local'))
|
|
157
165
|
.option('--profile <name>', 'Eval profile override')
|
|
158
166
|
.option('--task <task>', 'Explicit eval task override')
|
|
159
167
|
.option('--report-config <path>', 'JSON/YAML report output config')
|
|
@@ -543,8 +551,19 @@ bundle
|
|
|
543
551
|
function errorMessage(error) {
|
|
544
552
|
return error instanceof Error ? error.message : String(error);
|
|
545
553
|
}
|
|
554
|
+
function classicGroupArgs(argv) {
|
|
555
|
+
const args = argv.slice(2);
|
|
556
|
+
const classicIndex = args[0] === '--' ? 1 : 0;
|
|
557
|
+
return args[classicIndex] === 'classic' ? args.slice(classicIndex + 1) : null;
|
|
558
|
+
}
|
|
546
559
|
async function runCli() {
|
|
547
560
|
try {
|
|
561
|
+
const classicArgs = classicGroupArgs(process.argv);
|
|
562
|
+
if (classicArgs) {
|
|
563
|
+
const { runClassicGroupFacade } = await import('../commands/classic.js');
|
|
564
|
+
process.exitCode = await runClassicGroupFacade(classicArgs);
|
|
565
|
+
return;
|
|
566
|
+
}
|
|
548
567
|
await program.parseAsync();
|
|
549
568
|
}
|
|
550
569
|
catch (error) {
|