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