@rpamis/comet 0.4.0-beta.11 → 0.4.0-beta.13
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 +1 -1
- package/assets/manifest.json +15 -1
- package/assets/skills/comet/SKILL.md +10 -12
- package/assets/skills/comet/reference/classic-layout.md +2 -2
- package/assets/skills/comet/reference/comet-yaml-fields.md +1 -1
- package/assets/skills/comet/reference/context-recovery.md +3 -3
- package/assets/skills/comet/reference/decision-point.md +4 -5
- package/assets/skills/comet/reference/scripts.md +17 -47
- package/assets/skills/comet/reference/subagent-dispatch.md +8 -8
- package/assets/skills/comet/rules/comet-phase-guard.en.md +2 -2
- package/assets/skills/comet/rules/comet-phase-guard.md +2 -2
- package/assets/skills/comet/rules/comet-workflow-guard.en.md +4 -3
- package/assets/skills/comet/rules/comet-workflow-guard.md +4 -3
- package/assets/skills/comet/scripts/comet-archive.mjs +165 -2
- package/assets/skills/comet/scripts/comet-entry-runtime.mjs +146 -8071
- package/assets/skills/comet/scripts/comet-guard.mjs +207 -2
- package/assets/skills/comet/scripts/comet-handoff.mjs +165 -2
- package/assets/skills/comet/scripts/comet-hook-guard.mjs +151 -2
- package/assets/skills/comet/scripts/comet-hook-router.mjs +155 -12083
- package/assets/skills/comet/scripts/comet-intent.mjs +10 -2
- package/assets/skills/comet/scripts/comet-resume-probe.mjs +148 -2
- package/assets/skills/comet/scripts/comet-runtime.mjs +286 -19192
- package/assets/skills/comet/scripts/comet-state.mjs +164 -2
- package/assets/skills/comet/scripts/comet-yaml-validate.mjs +149 -2
- package/assets/skills/comet-archive/SKILL.md +1 -1
- package/assets/skills/comet-build/SKILL.md +13 -14
- package/assets/skills/comet-classic/SKILL.md +9 -9
- package/assets/skills/comet-design/SKILL.md +4 -4
- package/assets/skills/comet-hotfix/SKILL.md +2 -2
- package/assets/skills/comet-native/SKILL.md +35 -22
- package/assets/skills/comet-native/reference/artifacts.md +0 -7
- package/assets/skills/comet-native/reference/clarification.md +1 -1
- package/assets/skills/comet-native/reference/commands.md +69 -57
- package/assets/skills/comet-native/reference/recovery.md +11 -1
- package/assets/skills/comet-native/scripts/comet-native-archive.mjs +178 -0
- package/assets/skills/comet-native/scripts/comet-native-check.mjs +173 -0
- package/assets/skills/comet-native/scripts/comet-native-checkpoint.mjs +179 -0
- package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +207 -0
- package/assets/skills/comet-native/scripts/comet-native-evidence.mjs +151 -0
- package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +150 -2
- package/assets/skills/comet-native/scripts/comet-native-init.mjs +171 -0
- package/assets/skills/comet-native/scripts/comet-native-new.mjs +200 -0
- package/assets/skills/comet-native/scripts/comet-native-next.mjs +182 -0
- package/assets/skills/comet-native/scripts/comet-native-receipt.mjs +179 -0
- package/assets/skills/comet-native/scripts/comet-native-root.mjs +185 -0
- package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +229 -34143
- package/assets/skills/comet-native/scripts/comet-native-select.mjs +178 -0
- package/assets/skills/comet-native/scripts/comet-native-show.mjs +151 -0
- package/assets/skills/comet-native/scripts/comet-native-spec.mjs +181 -0
- package/assets/skills/comet-native/scripts/comet-native-status.mjs +175 -0
- package/assets/skills/comet-tweak/SKILL.md +2 -2
- package/assets/skills/comet-verify/SKILL.md +3 -3
- package/assets/skills-zh/comet/SKILL.md +10 -12
- package/assets/skills-zh/comet/reference/classic-layout.md +2 -2
- package/assets/skills-zh/comet/reference/comet-yaml-fields.md +1 -1
- package/assets/skills-zh/comet/reference/context-recovery.md +3 -3
- package/assets/skills-zh/comet/reference/decision-point.md +4 -5
- package/assets/skills-zh/comet/reference/scripts.md +9 -39
- package/assets/skills-zh/comet/reference/subagent-dispatch.md +8 -8
- package/assets/skills-zh/comet-archive/SKILL.md +1 -1
- package/assets/skills-zh/comet-build/SKILL.md +13 -14
- package/assets/skills-zh/comet-classic/SKILL.md +7 -7
- package/assets/skills-zh/comet-design/SKILL.md +5 -5
- package/assets/skills-zh/comet-hotfix/SKILL.md +2 -2
- package/assets/skills-zh/comet-native/SKILL.md +35 -22
- package/assets/skills-zh/comet-native/reference/artifacts.md +0 -7
- package/assets/skills-zh/comet-native/reference/clarification.md +1 -1
- package/assets/skills-zh/comet-native/reference/commands.md +69 -57
- package/assets/skills-zh/comet-native/reference/recovery.md +11 -1
- package/assets/skills-zh/comet-tweak/SKILL.md +2 -2
- package/assets/skills-zh/comet-verify/SKILL.md +3 -3
- package/bin/comet.js +5 -1
- package/bin/fast-runtime-router.js +82 -0
- package/dist/app/cli/index.js +57 -18
- package/dist/app/cli/index.js.map +1 -1
- package/dist/app/commands/classic.js +2 -2
- package/dist/app/commands/classic.js.map +1 -1
- package/dist/app/commands/dashboard.d.ts.map +1 -1
- package/dist/app/commands/dashboard.js +2 -1
- package/dist/app/commands/dashboard.js.map +1 -1
- package/dist/app/commands/doctor.d.ts.map +1 -1
- package/dist/app/commands/doctor.js +9 -3
- 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 +10 -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 +9 -5
- package/dist/app/commands/init.js.map +1 -1
- package/dist/app/commands/uninstall.d.ts.map +1 -1
- package/dist/app/commands/uninstall.js +150 -8
- package/dist/app/commands/uninstall.js.map +1 -1
- package/dist/app/commands/update.d.ts +1 -0
- package/dist/app/commands/update.d.ts.map +1 -1
- package/dist/app/commands/update.js +166 -24
- package/dist/app/commands/update.js.map +1 -1
- package/dist/config/repository-layout.json +33 -6
- package/dist/domains/comet-classic/classic-archive-entry.js +1 -1
- package/dist/domains/comet-classic/classic-archive-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-branch-binding.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-branch-binding.js +8 -2
- package/dist/domains/comet-classic/classic-branch-binding.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 +6 -1
- package/dist/domains/comet-classic/classic-current-change.js.map +1 -1
- package/dist/domains/comet-classic/classic-guard-entry.js +1 -1
- package/dist/domains/comet-classic/classic-guard-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-guard.js +1 -1
- package/dist/domains/comet-classic/classic-guard.js.map +1 -1
- package/dist/domains/comet-classic/classic-handoff-entry.js +1 -1
- package/dist/domains/comet-classic/classic-handoff-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-hook-guard-entry.js +1 -1
- package/dist/domains/comet-classic/classic-hook-guard-entry.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 +7 -4
- package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
- package/dist/domains/comet-classic/classic-intent-entry.js +1 -1
- package/dist/domains/comet-classic/classic-intent-entry.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 +18 -11
- package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -1
- package/dist/domains/comet-classic/classic-layout.d.ts +7 -4
- package/dist/domains/comet-classic/classic-layout.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-layout.js +9 -9
- package/dist/domains/comet-classic/classic-layout.js.map +1 -1
- package/dist/domains/comet-classic/classic-resume-probe-entry.js +1 -1
- package/dist/domains/comet-classic/classic-resume-probe-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-root-command.d.ts +4 -1
- package/dist/domains/comet-classic/classic-root-command.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-root-command.js +159 -49
- package/dist/domains/comet-classic/classic-root-command.js.map +1 -1
- package/dist/domains/comet-classic/classic-root-move.d.ts +0 -1
- package/dist/domains/comet-classic/classic-root-move.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-root-move.js +24 -121
- package/dist/domains/comet-classic/classic-root-move.js.map +1 -1
- package/dist/domains/comet-classic/classic-script-entry.d.ts +2 -2
- package/dist/domains/comet-classic/classic-script-entry.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-script-entry.js +4 -3
- package/dist/domains/comet-classic/classic-script-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-state-command.js +6 -6
- package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
- package/dist/domains/comet-classic/classic-state-entry.js +1 -1
- package/dist/domains/comet-classic/classic-state-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-validate-entry.js +1 -1
- package/dist/domains/comet-classic/classic-validate-entry.js.map +1 -1
- package/dist/domains/comet-entry/current-selection-repair.js +1 -1
- package/dist/domains/comet-entry/current-selection-repair.js.map +1 -1
- package/dist/domains/comet-entry/entry-reads.d.ts +17 -0
- package/dist/domains/comet-entry/entry-reads.d.ts.map +1 -0
- package/dist/domains/comet-entry/entry-reads.js +20 -0
- package/dist/domains/comet-entry/entry-reads.js.map +1 -0
- package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
- package/dist/domains/comet-entry/hook-router-entry.js +3 -1
- package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
- package/dist/domains/comet-entry/hook-router.d.ts +12 -2
- package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
- package/dist/domains/comet-entry/hook-router.js +48 -17
- package/dist/domains/comet-entry/hook-router.js.map +1 -1
- package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
- package/dist/domains/comet-entry/init-workflow.js +7 -8
- package/dist/domains/comet-entry/init-workflow.js.map +1 -1
- package/dist/domains/comet-entry/resolve-entry.d.ts.map +1 -1
- package/dist/domains/comet-entry/resolve-entry.js +3 -4
- package/dist/domains/comet-entry/resolve-entry.js.map +1 -1
- package/dist/domains/comet-entry/resume-probe.d.ts.map +1 -1
- package/dist/domains/comet-entry/resume-probe.js +16 -5
- package/dist/domains/comet-entry/resume-probe.js.map +1 -1
- package/dist/domains/comet-native/native-acceptance.d.ts +1 -2
- package/dist/domains/comet-native/native-acceptance.d.ts.map +1 -1
- package/dist/domains/comet-native/native-acceptance.js +5 -29
- package/dist/domains/comet-native/native-acceptance.js.map +1 -1
- package/dist/domains/comet-native/native-archive-command.d.ts +3 -0
- package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-archive-command.js +49 -0
- package/dist/domains/comet-native/native-archive-command.js.map +1 -0
- package/dist/domains/comet-native/native-archive-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-archive-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-archive-entry.js +4 -0
- package/dist/domains/comet-native/native-archive-entry.js.map +1 -0
- package/dist/domains/comet-native/native-check-command.d.ts +3 -0
- package/dist/domains/comet-native/native-check-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-check-command.js +30 -0
- package/dist/domains/comet-native/native-check-command.js.map +1 -0
- package/dist/domains/comet-native/native-check-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-check-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-check-entry.js +4 -0
- package/dist/domains/comet-native/native-check-entry.js.map +1 -0
- package/dist/domains/comet-native/native-checkpoint-command.d.ts +3 -0
- package/dist/domains/comet-native/native-checkpoint-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-checkpoint-command.js +39 -0
- package/dist/domains/comet-native/native-checkpoint-command.js.map +1 -0
- package/dist/domains/comet-native/native-checkpoint-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-checkpoint-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-checkpoint-entry.js +4 -0
- package/dist/domains/comet-native/native-checkpoint-entry.js.map +1 -0
- package/dist/domains/comet-native/native-cli-shared.d.ts +40 -0
- package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -0
- package/dist/domains/comet-native/native-cli-shared.js +272 -0
- package/dist/domains/comet-native/native-cli-shared.js.map +1 -0
- package/dist/domains/comet-native/native-cli.d.ts +2 -5
- package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
- package/dist/domains/comet-native/native-cli.js +37 -1228
- package/dist/domains/comet-native/native-cli.js.map +1 -1
- package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
- package/dist/domains/comet-native/native-continuation.js +34 -5
- package/dist/domains/comet-native/native-continuation.js.map +1 -1
- package/dist/domains/comet-native/native-doctor-command.d.ts +3 -0
- package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-doctor-command.js +29 -0
- package/dist/domains/comet-native/native-doctor-command.js.map +1 -0
- package/dist/domains/comet-native/native-doctor-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-doctor-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-doctor-entry.js +4 -0
- package/dist/domains/comet-native/native-doctor-entry.js.map +1 -0
- package/dist/domains/comet-native/native-evidence-command.d.ts +3 -0
- package/dist/domains/comet-native/native-evidence-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-evidence-command.js +35 -0
- package/dist/domains/comet-native/native-evidence-command.js.map +1 -0
- package/dist/domains/comet-native/native-evidence-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-evidence-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-evidence-entry.js +4 -0
- package/dist/domains/comet-native/native-evidence-entry.js.map +1 -0
- package/dist/domains/comet-native/native-evidence-retention.d.ts.map +1 -1
- package/dist/domains/comet-native/native-evidence-retention.js +5 -21
- package/dist/domains/comet-native/native-evidence-retention.js.map +1 -1
- package/dist/domains/comet-native/native-evidence-storage.d.ts +19 -14
- package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
- package/dist/domains/comet-native/native-evidence-storage.js +91 -46
- 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 +24 -4
- package/dist/domains/comet-native/native-findings.js.map +1 -1
- package/dist/domains/comet-native/native-hook-guard-command.d.ts +3 -0
- package/dist/domains/comet-native/native-hook-guard-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-hook-guard-command.js +32 -0
- package/dist/domains/comet-native/native-hook-guard-command.js.map +1 -0
- package/dist/domains/comet-native/native-hook-guard-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-hook-guard-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-hook-guard-entry.js +4 -0
- package/dist/domains/comet-native/native-hook-guard-entry.js.map +1 -0
- package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
- package/dist/domains/comet-native/native-hook-guard.js +7 -1
- package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
- package/dist/domains/comet-native/native-init-command.d.ts +3 -0
- package/dist/domains/comet-native/native-init-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-init-command.js +29 -0
- package/dist/domains/comet-native/native-init-command.js.map +1 -0
- package/dist/domains/comet-native/native-init-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-init-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-init-entry.js +4 -0
- package/dist/domains/comet-native/native-init-entry.js.map +1 -0
- package/dist/domains/comet-native/native-new-command.d.ts +3 -0
- package/dist/domains/comet-native/native-new-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-new-command.js +35 -0
- package/dist/domains/comet-native/native-new-command.js.map +1 -0
- package/dist/domains/comet-native/native-new-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-new-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-new-entry.js +4 -0
- package/dist/domains/comet-native/native-new-entry.js.map +1 -0
- package/dist/domains/comet-native/native-next-command.d.ts +3 -0
- package/dist/domains/comet-native/native-next-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-next-command.js +82 -0
- package/dist/domains/comet-native/native-next-command.js.map +1 -0
- package/dist/domains/comet-native/native-next-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-next-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-next-entry.js +4 -0
- package/dist/domains/comet-native/native-next-entry.js.map +1 -0
- package/dist/domains/comet-native/native-receipt-command.d.ts +3 -0
- package/dist/domains/comet-native/native-receipt-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-receipt-command.js +107 -0
- package/dist/domains/comet-native/native-receipt-command.js.map +1 -0
- package/dist/domains/comet-native/native-receipt-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-receipt-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-receipt-entry.js +4 -0
- package/dist/domains/comet-native/native-receipt-entry.js.map +1 -0
- package/dist/domains/comet-native/native-receipt-refresh.d.ts +86 -0
- package/dist/domains/comet-native/native-receipt-refresh.d.ts.map +1 -0
- package/dist/domains/comet-native/native-receipt-refresh.js +232 -0
- package/dist/domains/comet-native/native-receipt-refresh.js.map +1 -0
- package/dist/domains/comet-native/native-repair-integration.d.ts +1 -3
- package/dist/domains/comet-native/native-repair-integration.d.ts.map +1 -1
- package/dist/domains/comet-native/native-repair-integration.js +12 -15
- package/dist/domains/comet-native/native-repair-integration.js.map +1 -1
- package/dist/domains/comet-native/native-repair-runtime.d.ts +0 -1
- package/dist/domains/comet-native/native-repair-runtime.d.ts.map +1 -1
- package/dist/domains/comet-native/native-repair-runtime.js +3 -10
- package/dist/domains/comet-native/native-repair-runtime.js.map +1 -1
- package/dist/domains/comet-native/native-repair-stagnation.d.ts +1 -9
- package/dist/domains/comet-native/native-repair-stagnation.d.ts.map +1 -1
- package/dist/domains/comet-native/native-repair-stagnation.js +4 -14
- package/dist/domains/comet-native/native-repair-stagnation.js.map +1 -1
- package/dist/domains/comet-native/native-root-command.d.ts +3 -0
- package/dist/domains/comet-native/native-root-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-root-command.js +29 -0
- package/dist/domains/comet-native/native-root-command.js.map +1 -0
- package/dist/domains/comet-native/native-root-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-root-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-root-entry.js +4 -0
- package/dist/domains/comet-native/native-root-entry.js.map +1 -0
- package/dist/domains/comet-native/native-script-entry.d.ts +12 -0
- package/dist/domains/comet-native/native-script-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-script-entry.js +44 -0
- package/dist/domains/comet-native/native-script-entry.js.map +1 -0
- package/dist/domains/comet-native/native-select-command.d.ts +3 -0
- package/dist/domains/comet-native/native-select-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-select-command.js +15 -0
- package/dist/domains/comet-native/native-select-command.js.map +1 -0
- package/dist/domains/comet-native/native-select-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-select-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-select-entry.js +4 -0
- package/dist/domains/comet-native/native-select-entry.js.map +1 -0
- package/dist/domains/comet-native/native-show-command.d.ts +3 -0
- package/dist/domains/comet-native/native-show-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-show-command.js +41 -0
- package/dist/domains/comet-native/native-show-command.js.map +1 -0
- package/dist/domains/comet-native/native-show-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-show-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-show-entry.js +4 -0
- package/dist/domains/comet-native/native-show-entry.js.map +1 -0
- package/dist/domains/comet-native/native-snapshot.d.ts +9 -0
- package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
- package/dist/domains/comet-native/native-snapshot.js +141 -45
- package/dist/domains/comet-native/native-snapshot.js.map +1 -1
- package/dist/domains/comet-native/native-spec-command.d.ts +3 -0
- package/dist/domains/comet-native/native-spec-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-spec-command.js +34 -0
- package/dist/domains/comet-native/native-spec-command.js.map +1 -0
- package/dist/domains/comet-native/native-spec-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-spec-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-spec-entry.js +4 -0
- package/dist/domains/comet-native/native-spec-entry.js.map +1 -0
- package/dist/domains/comet-native/native-status-command.d.ts +3 -0
- package/dist/domains/comet-native/native-status-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-status-command.js +36 -0
- package/dist/domains/comet-native/native-status-command.js.map +1 -0
- package/dist/domains/comet-native/native-status-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-status-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-status-entry.js +4 -0
- package/dist/domains/comet-native/native-status-entry.js.map +1 -0
- package/dist/domains/comet-native/native-transition-evidence.d.ts.map +1 -1
- package/dist/domains/comet-native/native-transition-evidence.js +0 -10
- package/dist/domains/comet-native/native-transition-evidence.js.map +1 -1
- package/dist/domains/comet-native/native-transitions.d.ts +4 -0
- package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
- package/dist/domains/comet-native/native-transitions.js +31 -35
- package/dist/domains/comet-native/native-transitions.js.map +1 -1
- package/dist/domains/comet-native/native-types.d.ts +8 -6
- package/dist/domains/comet-native/native-types.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-evidence.d.ts +2 -48
- package/dist/domains/comet-native/native-verification-evidence.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-evidence.js +13 -301
- package/dist/domains/comet-native/native-verification-evidence.js.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +16 -138
- package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt-runtime.js +132 -770
- package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt.d.ts +3 -89
- package/dist/domains/comet-native/native-verification-receipt.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt.js +19 -350
- package/dist/domains/comet-native/native-verification-receipt.js.map +1 -1
- package/dist/domains/comet-native/native-verification-runtime.d.ts +28 -4
- package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-runtime.js +101 -218
- package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
- package/dist/domains/dashboard/collector.d.ts.map +1 -1
- package/dist/domains/dashboard/collector.js +53 -41
- package/dist/domains/dashboard/collector.js.map +1 -1
- package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
- package/dist/domains/dashboard/native-collector.js +13 -3
- package/dist/domains/dashboard/native-collector.js.map +1 -1
- package/dist/domains/dashboard/project-directory.d.ts +20 -0
- package/dist/domains/dashboard/project-directory.d.ts.map +1 -0
- package/dist/domains/dashboard/project-directory.js +87 -0
- package/dist/domains/dashboard/project-directory.js.map +1 -0
- package/dist/domains/dashboard/project-root.d.ts +8 -0
- package/dist/domains/dashboard/project-root.d.ts.map +1 -0
- package/dist/domains/dashboard/project-root.js +68 -0
- package/dist/domains/dashboard/project-root.js.map +1 -0
- package/dist/domains/dashboard/server.d.ts +1 -0
- package/dist/domains/dashboard/server.d.ts.map +1 -1
- package/dist/domains/dashboard/server.js +50 -10
- package/dist/domains/dashboard/server.js.map +1 -1
- package/dist/domains/dashboard/web/assets/{arc-BXWNV2Qv.js → arc-mNt_SS1l.js} +1 -1
- package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-Bc5akVD6.js +36 -0
- package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-P2PGImSM.js → blockDiagram-GPEHLZMM-C43zhVBe.js} +2 -2
- package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-fTj6Xhs1.js → c4Diagram-AAUBKEIU-dToETarK.js} +2 -2
- package/dist/domains/dashboard/web/assets/channel-b2wWDG4F.js +1 -0
- package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-BjFDZ5yo.js → chunk-2J33WTMH-C0oO137R.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-BAUkbZdT.js → chunk-4BX2VUAB-CGms1fgI.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-DBmuiYme.js → chunk-55IACEB6-Bugl8v6f.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-Do9ufCgY.js → chunk-727SXJPM-8ATNMlBG.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-qRQWlB5d.js → chunk-AQP2D5EJ-BNYjSSqU.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-BzDzeJ4_.js → chunk-FMBD7UC4-_nJAqSbe.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-OQcAmIvL.js → chunk-ND2GUHAM-lyxYm5NX.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-BiRfH4d2.js → chunk-QZHKN3VN-PUMVeWpd.js} +1 -1
- package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-B9SWZywo.js +1 -0
- package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-B9SWZywo.js +1 -0
- package/dist/domains/dashboard/web/assets/cose-bilkent-S5V4N54A-DzMqjexn.js +1 -0
- package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-B3F-qRTJ.js → cynefin-VYW2F7L2-B67ET0eq.js} +1 -1
- package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-CQPMvRLK.js +4 -0
- package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-BRpLrFHM.js +43 -0
- package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-CPGWuGrE.js +10 -0
- package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-DrPGimEt.js → diagram-KO2AKTUF-D2wpX2iO.js} +2 -2
- package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-D54mAbDu.js +24 -0
- package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-ZGQDpSs_.js +24 -0
- package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-CoB0mzhk.js → erDiagram-TEJ5UH35-C3qDo7sd.js} +2 -2
- package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-lT53XfSE.js → flowDiagram-I6XJVG4X-B7hStPd9.js} +2 -2
- package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-IqcLFbTK.js +292 -0
- package/dist/domains/dashboard/web/assets/gitGraphDiagram-PVQCEYII-YrMZpzUu.js +106 -0
- package/dist/domains/dashboard/web/assets/index-DhtBssCt.js +257 -0
- package/dist/domains/dashboard/web/assets/{index-QO0z6F4w.js → index-icxk8_BP.js} +1 -1
- package/dist/domains/dashboard/web/assets/index-pr3axVDI.css +1 -0
- package/dist/domains/dashboard/web/assets/infoDiagram-5YYISTIA-CcIgGK_7.js +2 -0
- package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-Dkspu33d.js → ishikawaDiagram-YF4QCWOH-1x3rNjGP.js} +2 -2
- package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-C-EM1sZl.js → journeyDiagram-JHISSGLW-B2XiqMNP.js} +2 -2
- package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-BTbB0IO2.js → kanban-definition-UN3LZRKU-x46cGuo3.js} +2 -2
- package/dist/domains/dashboard/web/assets/{linear-Cp0UrqDr.js → linear-DFLqGZWl.js} +1 -1
- package/dist/domains/dashboard/web/assets/{mermaid.core-CucmqsLW.js → mermaid.core-g3J6BACc.js} +69 -69
- package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CjEshF1X.js → mindmap-definition-RKZ34NQL-CTdeKmcX.js} +2 -2
- package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-DrwFnX1b.js → pieDiagram-4H26LBE5-C_obwjIf.js} +2 -2
- package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CjG6pBR2.js → quadrantDiagram-W4KKPZXB-B6Gnfz9M.js} +4 -4
- package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-BpUQVqCV.js → requirementDiagram-4Y6WPE33-nX4PObnB.js} +2 -2
- package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-BeGkEvzR.js → sankeyDiagram-5OEKKPKP-QjDwwHgl.js} +2 -2
- package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK-sSTU3MCO.js → sequenceDiagram-3UESZ5HK-BEEe0j6B.js} +2 -2
- package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-CXfAaBgM.js +1 -0
- package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-CD3nS4cC.js +1 -0
- package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-DCN7NjEs.js → timeline-definition-PNZ67QCA-BOzX2EnD.js} +2 -2
- package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-DZAN1_rr.js → vennDiagram-CIIHVFJN-C40vhXRq.js} +2 -2
- package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-FfkJfr4C.js → wardleyDiagram-YWT4CUSO-B1rm89JH.js} +2 -2
- package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-CD8B-EmR.js → xychartDiagram-2RQKCTM6-BlMr59qK.js} +2 -2
- package/dist/domains/dashboard/web/index.html +2 -2
- package/dist/domains/integrations/openspec.d.ts +1 -0
- package/dist/domains/integrations/openspec.d.ts.map +1 -1
- package/dist/domains/integrations/openspec.js +6 -0
- package/dist/domains/integrations/openspec.js.map +1 -1
- package/dist/domains/skill/platform-install.d.ts.map +1 -1
- package/dist/domains/skill/platform-install.js +4 -6
- package/dist/domains/skill/platform-install.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 +128 -19
- package/dist/domains/skill/uninstall.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 +45 -1
- package/dist/domains/workflow-contract/project-config.js.map +1 -1
- package/dist/platform/install/detect.d.ts +1 -0
- package/dist/platform/install/detect.d.ts.map +1 -1
- package/dist/platform/install/detect.js +2 -0
- package/dist/platform/install/detect.js.map +1 -1
- package/dist/platform/process/hook-read-cache.d.ts +45 -0
- package/dist/platform/process/hook-read-cache.d.ts.map +1 -0
- package/dist/platform/process/hook-read-cache.js +102 -0
- package/dist/platform/process/hook-read-cache.js.map +1 -0
- package/dist/platform/version/version.d.ts.map +1 -1
- package/dist/platform/version/version.js +9 -2
- package/dist/platform/version/version.js.map +1 -1
- package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet-package.json +2 -0
- package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/current-comet-package.json +2 -0
- package/eval/local/tasks/comet-native-workflow/instruction.md +5 -17
- package/eval/local/tasks/comet-native-workflow/task.toml +4 -2
- package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +227 -300
- package/eval/local/tests/conftest.py +0 -193
- package/eval/local/tests/scaffold/test_native_wave_evaluations.py +107 -180
- package/eval/local/tests/scaffold/test_tasks.py +6 -9
- package/eval/local/tests/scaffold/test_utils.py +4 -7
- package/eval/scaffold/shell/docker.sh +2 -95
- package/package.json +7 -3
- package/dist/domains/comet-native/native-controller-trust.d.ts +0 -21
- package/dist/domains/comet-native/native-controller-trust.d.ts.map +0 -1
- package/dist/domains/comet-native/native-controller-trust.js +0 -140
- package/dist/domains/comet-native/native-controller-trust.js.map +0 -1
- package/dist/domains/comet-native/native-independent-review.d.ts +0 -28
- package/dist/domains/comet-native/native-independent-review.d.ts.map +0 -1
- package/dist/domains/comet-native/native-independent-review.js +0 -134
- package/dist/domains/comet-native/native-independent-review.js.map +0 -1
- package/dist/domains/comet-native/native-review-contract.d.ts +0 -6
- package/dist/domains/comet-native/native-review-contract.d.ts.map +0 -1
- package/dist/domains/comet-native/native-review-contract.js +0 -6
- package/dist/domains/comet-native/native-review-contract.js.map +0 -1
- package/dist/domains/comet-native/native-review-identity.d.ts +0 -50
- package/dist/domains/comet-native/native-review-identity.d.ts.map +0 -1
- package/dist/domains/comet-native/native-review-identity.js +0 -209
- package/dist/domains/comet-native/native-review-identity.js.map +0 -1
- package/dist/domains/comet-native/native-review-signer.d.ts +0 -24
- package/dist/domains/comet-native/native-review-signer.d.ts.map +0 -1
- package/dist/domains/comet-native/native-review-signer.js +0 -125
- package/dist/domains/comet-native/native-review-signer.js.map +0 -1
- package/dist/domains/comet-native/native-review-trust.d.ts +0 -35
- package/dist/domains/comet-native/native-review-trust.d.ts.map +0 -1
- package/dist/domains/comet-native/native-review-trust.js +0 -176
- package/dist/domains/comet-native/native-review-trust.js.map +0 -1
- package/dist/domains/dashboard/web/assets/_commonjsHelpers-CqkleIqs.js +0 -1
- package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-CjVHPivo.js +0 -36
- package/dist/domains/dashboard/web/assets/channel--JtnhJr8.js +0 -1
- package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BRGmx8Iz.js +0 -1
- package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BRGmx8Iz.js +0 -1
- package/dist/domains/dashboard/web/assets/cose-bilkent-S5V4N54A-CZk37fGn.js +0 -1
- package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-D5BQ0eqN.js +0 -4
- package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-33mXstha.js +0 -43
- package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-BWHCMFvD.js +0 -10
- package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-BBlsg7jG.js +0 -24
- package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-CsaFSpHi.js +0 -24
- package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-D1SQ56fl.js +0 -292
- package/dist/domains/dashboard/web/assets/gitGraphDiagram-PVQCEYII-D4oDMS5x.js +0 -106
- package/dist/domains/dashboard/web/assets/index-D-AGxvI4.css +0 -1
- package/dist/domains/dashboard/web/assets/index-Msce_H_q.js +0 -24
- package/dist/domains/dashboard/web/assets/infoDiagram-5YYISTIA-BeICn98s.js +0 -2
- package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-CcFBc6qh.js +0 -1
- package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-D5zZYi4x.js +0 -1
- package/eval/local/tasks/comet-native-workflow/environment/.include-trusted-native-review-fixture +0 -1
- package/eval/scaffold/shell/native-review-signer-daemon.mjs +0 -144
- package/eval/scaffold/shell/native-review-verifier-daemon.mjs +0 -178
|
@@ -63,7 +63,7 @@ git rev-parse HEAD
|
|
|
63
63
|
|
|
64
64
|
Write the plan to file, then return the file path.
|
|
65
65
|
|
|
66
|
-
**Execute subagent**:
|
|
66
|
+
**Execute subagent**: Dispatch the above task to a subagent.
|
|
67
67
|
|
|
68
68
|
After the subagent completes:
|
|
69
69
|
- If a valid file path is returned and the file exists, record it as the plan
|
|
@@ -79,9 +79,9 @@ 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
|
-
|
|
82
|
+
When presenting the joint decision, provide every workspace-isolation and execution choice supported by this workflow. Do not preflight, infer, or filter whether another Skill, branch, worktree, subagent dispatch, or model selection can be used. After the user chooses, run the corresponding action; if it fails, stop and report the original error. If a field has only one workflow-valid value, explain why and apply it without manufacturing another pause.
|
|
83
83
|
|
|
84
|
-
After recording the plan, provide exactly **one joint decision point** that collects whether to continue now,
|
|
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
|
|
|
86
86
|
| Option | Behavior | Description |
|
|
87
87
|
|--------|----------|-------------|
|
|
@@ -141,7 +141,7 @@ The plan is on the current branch. These settings are all part of the single Ste
|
|
|
141
141
|
- Task count ≤ 2 and no cross-module dependencies → Recommend B
|
|
142
142
|
- From hotfix path → Recommend B
|
|
143
143
|
|
|
144
|
-
These tables are part of the Step 2 joint decision and do not create another pause.
|
|
144
|
+
These tables are part of the Step 2 joint decision and do not create another pause. Always show the isolation and execution options supported by this workflow; do not remove an option by predicting that an action will fail. When multiple valid options remain, do not choose `current`, `branch`, or `worktree`, execution method, TDD mode, or review mode from recommendations. Recommendations explain a preference; they never replace user confirmation.
|
|
145
145
|
|
|
146
146
|
After user selection, update `isolation`, execution method, TDD mode, and code review mode fields:
|
|
147
147
|
|
|
@@ -150,8 +150,7 @@ comet state set <name> isolation <current|branch|worktree>
|
|
|
150
150
|
```
|
|
151
151
|
|
|
152
152
|
- If the user chooses `executing-plans`: run `comet state set <name> subagent_dispatch null`, then run `comet state set <name> build_mode executing-plans`
|
|
153
|
-
- If the user chooses `subagent-driven-development`:
|
|
154
|
-
- If real background dispatch capability cannot be confirmed, do not show or write `build_mode: subagent-driven-development`. If recovered state already records that mode but capability is unavailable, return to the same Step 2 joint decision with only executable modes; do not create a separate "switch to executing-plans" pause
|
|
153
|
+
- If the user chooses `subagent-driven-development`: run `comet state set <name> subagent_dispatch confirmed` to record the selected subagent execution, then run `comet state set <name> build_mode subagent-driven-development`
|
|
155
154
|
|
|
156
155
|
**TDD Mode**:
|
|
157
156
|
|
|
@@ -174,7 +173,7 @@ Run `comet state set <name> review_mode <off|standard|thorough>`
|
|
|
174
173
|
|
|
175
174
|
`isolation` is a script-enforced hard constraint. Full workflow init may temporarily leave it as `null`, but only before this step. If it remains `null`, both the `build → verify` guard and `comet state transition build-complete` will fail. Full workflow allows `current`, `branch`, or `worktree`, but `current` must be written only after the user explicitly selects it in Step 2; never make it a silent default.
|
|
176
175
|
|
|
177
|
-
`subagent_dispatch` is a script-enforced hard constraint. `build_mode: subagent-driven-development` requires `subagent_dispatch: confirmed` before leaving the build phase, otherwise both `comet guard build --apply` and `comet state transition build-complete` will fail.
|
|
176
|
+
`subagent_dispatch` is a script-enforced hard constraint that records the user's selected subagent execution. `build_mode: subagent-driven-development` requires `subagent_dispatch: confirmed` before leaving the build phase, otherwise both `comet guard build --apply` and `comet state transition build-complete` will fail; it is not a capability check.
|
|
178
177
|
|
|
179
178
|
`tdd_mode` is a script-enforced hard constraint. Full workflow must have `tdd_mode` selected as `tdd` or `direct` before leaving the build phase, otherwise both `comet guard build --apply` and `comet state transition build-complete` will fail.
|
|
180
179
|
|
|
@@ -206,7 +205,7 @@ Without `direct_override: true`, `build_mode=direct` in full workflow is blocked
|
|
|
206
205
|
|
|
207
206
|
Immediately after Step 2 confirms the branch name, run `git checkout -b <branch-name>`, then run `comet state set <name> isolation branch` to write the new branch to `bound_branch`. Continue on the new branch.
|
|
208
207
|
|
|
209
|
-
- **worktree**:
|
|
208
|
+
- **worktree**: **Immediately execute:** Use the Skill tool to load the Superpowers `using-git-worktrees` skill to create an isolated workspace. Do not bypass this skill with plain shell commands or native tools. If loading it fails because it is unavailable, stop and report that error.
|
|
210
209
|
|
|
211
210
|
After creating isolation, confirm plan file is accessible (naturally accessible with branch method; for worktree method, confirm plan has been committed). If the plan file has not been committed under worktree mode, commit it first before creating the worktree:
|
|
212
211
|
|
|
@@ -225,9 +224,9 @@ Do not begin source writes until this binding succeeds.
|
|
|
225
224
|
|
|
226
225
|
**Execute plan**: Must handle execution according to the actual runtime of `build_mode`.
|
|
227
226
|
|
|
228
|
-
- `build_mode: executing-plans`: **Immediately execute:** Use the Skill tool to load the Superpowers `executing-plans` skill. Skipping this step is prohibited. If
|
|
229
|
-
- `build_mode: subagent-driven-development`: The main session only coordinates and must not write implementation code directly. **Immediately execute:** Use the Skill tool to load the Superpowers `subagent-driven-development` skill. After the skill loads, read `comet/reference/subagent-dispatch.md` for Comet-specific extensions (
|
|
230
|
-
- If
|
|
227
|
+
- `build_mode: executing-plans`: **Immediately execute:** Use the Skill tool to load the Superpowers `executing-plans` skill. Skipping this step is prohibited. If loading fails, stop and report the error; do not substitute with normal conversation. After the skill loads, ARGUMENTS must include the same Language constraint as Step 1: `Language: Use the configured Comet artifact language from comet state get <name> language`. Execute according to plan.
|
|
228
|
+
- `build_mode: subagent-driven-development`: The main session only coordinates and must not write implementation code directly. **Immediately execute:** Use the Skill tool to load the Superpowers `subagent-driven-development` skill. After the skill loads, read `comet/reference/subagent-dispatch.md` for Comet-specific extensions (subagent dispatch, task isolation, checkoff verification, TDD constraints, continuous execution, context recovery) and apply them alongside the skill's workflow. If they conflict, the more specific Comet extensions take precedence.
|
|
229
|
+
- If subagent dispatch fails, follow `comet/reference/subagent-dispatch.md` to record the current task as `BLOCKED` with the failure reason; the main session must not take over implementation.
|
|
231
230
|
|
|
232
231
|
**TDD Mode Execution Constraints**:
|
|
233
232
|
|
|
@@ -247,7 +246,7 @@ Under `executing-plans`, the main session executes tasks directly (no isolated i
|
|
|
247
246
|
|
|
248
247
|
Requirements (apply to `standard` and `thorough`):
|
|
249
248
|
- the `requesting-code-review` skill must be loaded before `comet guard <change-name> build --apply`
|
|
250
|
-
- if `requesting-code-review`
|
|
249
|
+
- if loading `requesting-code-review` fails under `standard` or `thorough`, stop and ask the user to resolve the error and retry, or explicitly switch to `review_mode: off` with a recorded reason; never skip the gate or continue guard before that explicit switch
|
|
251
250
|
- CRITICAL review findings (security vulnerabilities, data loss risk, build/test failures) must be fixed first and must not be carried into verify
|
|
252
251
|
- if non-CRITICAL review findings are accepted, record the acceptance reason and impact scope in tasks.md, the commit body, a verification report draft, or another durable artifact
|
|
253
252
|
|
|
@@ -264,8 +263,8 @@ When the initial spec is found incomplete during implementation, handle by scale
|
|
|
264
263
|
| Scale | Trigger Conditions | Approach |
|
|
265
264
|
|------|-------------------|----------|
|
|
266
265
|
| Small | Missing acceptance scenarios, edge cases | Directly edit delta spec + design.md, append tasks.md tasks |
|
|
267
|
-
| Medium | Interface changes, new components, data flow changes | **
|
|
268
|
-
| Large | Brand-new capability requirements | **
|
|
266
|
+
| Medium | Interface changes, new components, data flow changes | **Pause, present the choice, and wait for the user to explicitly confirm**, then must use Skill tool to load the Superpowers `brainstorming` skill to update Design Doc + delta spec |
|
|
267
|
+
| Large | Brand-new capability requirements | **Pause, present the split choice, and wait for the user to explicitly confirm**; after user confirms, create independent change through `/comet-open` |
|
|
269
268
|
|
|
270
269
|
**50% Threshold Determination**: Using initial task count in tasks.md as baseline, if new tasks exceed half of that total, it's considered outside original plan scope, **must follow the `comet/reference/decision-point.md` protocol to pause and wait for the user to decide whether to split into a new change**.
|
|
271
270
|
|
|
@@ -30,10 +30,10 @@ Use the configured Comet artifact language as the output language for every Open
|
|
|
30
30
|
|
|
31
31
|
**Step 0: Active Change Discovery and Intent Resolution**
|
|
32
32
|
|
|
33
|
-
1. First
|
|
33
|
+
1. First follow `comet/reference/scripts.md` and run the public `comet` CLI command directly.
|
|
34
34
|
2. Run `comet classic openspec -- list --json` to collect active changes.
|
|
35
35
|
3. Fill a `CometIntentFrame` from the user request, active change list, and necessary repository state.
|
|
36
|
-
4. Prefer `
|
|
36
|
+
4. Prefer `comet classic intent route --stdin` to pass the frame JSON and get the runtime-normalized route. `CometIntentFrame + runtime scorer` is the source of truth; this prose is only for intent recognition slot extraction.
|
|
37
37
|
5. Handle the runtime route:
|
|
38
38
|
- `hotfix` → invoke `/comet-hotfix`
|
|
39
39
|
- `tweak` → invoke `/comet-tweak`
|
|
@@ -55,7 +55,7 @@ When multiple active changes exist and the user has not selected one, do not bin
|
|
|
55
55
|
When the user did not explicitly invoke `/comet-classic`, but this repository may already have an active Comet change, run the read-only probe before starting work that may need code changes or investigation:
|
|
56
56
|
|
|
57
57
|
```bash
|
|
58
|
-
|
|
58
|
+
comet resume-probe . --stdin --json
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
The probe only reads repository state. Follow the returned action:
|
|
@@ -184,7 +184,7 @@ A single `/comet-classic` invocation starts from the detected phase and advances
|
|
|
184
184
|
|
|
185
185
|
Flow chain: open → design → build → verify → archive
|
|
186
186
|
|
|
187
|
-
**Continuous execution requirement**: starting from the detected phase, the agent automatically continues through all later phases. But **auto-advancing only applies at transition points without user decisions**. When encountering user decision points,
|
|
187
|
+
**Continuous execution requirement**: starting from the detected phase, the agent automatically continues through all later phases. But **auto-advancing only applies at transition points without user decisions**. When encountering user decision points, pause, present clear options, and wait for the user's explicit response. Must not use recommendation rules, defaults, or historical preferences to substitute for user confirmation, and must not just output a text prompt and then continue executing.
|
|
188
188
|
|
|
189
189
|
**Distinguish phase advancement vs automatic handoff**: each sub-skill runs phase guard `--apply` before exit to advance the `.comet.yaml` `phase` field. This step **always happens** and is not controlled by `auto_transition`. After that, the sub-skill runs `comet state next <name>` to resolve the next action: when `auto_transition` is not `false`, output is `NEXT: auto` (auto-invoke next skill); when `auto_transition` is `false`, output is `NEXT: manual` (do not invoke next skill; return control with `HINT`). `NEXT: manual` is not a user decision point and must not ask whether to continue. Therefore `auto_transition` **only controls next skill invocation, not phase advancement**. Regardless of `auto_transition`, genuine user decision points below remain blocking.
|
|
190
190
|
|
|
@@ -194,7 +194,7 @@ Nodes requiring user participation (pause only at these nodes):
|
|
|
194
194
|
1. Workflow target selection: multiple active changes, continue an existing change versus create a new one, or choose which completed batch item starts first
|
|
195
195
|
2. Open-phase final proposal/design/tasks review, including the change name and scope; clear requests have no pre-artifact summary/name confirmation
|
|
196
196
|
3. Confirm the design approach during brainstorming
|
|
197
|
-
4. One joint build decision: plan-ready pause or all
|
|
197
|
+
4. One joint build decision: plan-ready pause or all workflow settings (workspace isolation + execution method + TDD mode + code review mode, plus branch name when branch is selected)
|
|
198
198
|
5. Verify-phase acceptance of WARNING/SUGGESTION deviations, Spec drift handling, or continue/stop after the 4th failure; the first 3 clearly repairable failures close automatically
|
|
199
199
|
6. Archive phase final confirmation before running the archive script
|
|
200
200
|
7. Choose finishing-branch handling after exact archive changes are committed
|
|
@@ -202,13 +202,13 @@ Nodes requiring user participation (pause only at these nodes):
|
|
|
202
202
|
9. Build phase scope expansion requiring redesign or new change split
|
|
203
203
|
10. Open phase large PRD split confirmation
|
|
204
204
|
|
|
205
|
-
Agents should not skip these decision points; other unambiguous phase transitions must proceed automatically, must not exit midway. At decision points, **must not skip user confirmation or choose automatically —
|
|
205
|
+
Agents should not skip these decision points; other unambiguous phase transitions must proceed automatically, must not exit midway. At decision points, **must not skip user confirmation or choose automatically — ask clear options and wait for the user's explicit choice before continuing**.
|
|
206
206
|
|
|
207
207
|
**Red Flags** — when these thoughts appear, STOP and check:
|
|
208
208
|
|
|
209
209
|
| Agent Thought | Actual Risk |
|
|
210
210
|
|--------------|-------------|
|
|
211
|
-
| "The user would probably agree with this approach" | Cannot decide for the user —
|
|
211
|
+
| "The user would probably agree with this approach" | Cannot decide for the user — present the choice and wait for the reply |
|
|
212
212
|
| "This is a small change, confirmation isn't needed" | Decision points have no size exception — blocking points must wait |
|
|
213
213
|
| "The user chose A last time, so A again" | Historical preference cannot substitute for current confirmation |
|
|
214
214
|
| "I explained the plan and the user didn't object" | No objection ≠ consent — must use tool to get explicit choice |
|
|
@@ -283,9 +283,9 @@ See `comet/reference/decision-point.md` for the complete user decision point pro
|
|
|
283
283
|
|
|
284
284
|
See `comet/reference/debug-gate.md` for the complete debug gate protocol.
|
|
285
285
|
|
|
286
|
-
###
|
|
286
|
+
### Public CLI
|
|
287
287
|
|
|
288
|
-
|
|
288
|
+
Follow `comet/reference/scripts.md` once per session and use only the public `comet` CLI. Do not search for or invoke internal bundles. Key entry points:
|
|
289
289
|
|
|
290
290
|
```bash
|
|
291
291
|
comet guard <change-name> <phase> --apply # phase guard + state update
|
|
@@ -148,7 +148,7 @@ Only after the user explicitly confirms, proceed to Step 2. If the user requests
|
|
|
148
148
|
|
|
149
149
|
After the user confirms the design proposal, before creating the Design Doc, create or update the incrementally maintained checkpoint file and finalize it as the confirmed design summary:
|
|
150
150
|
|
|
151
|
-
Use the
|
|
151
|
+
Use the file tool to ensure `<classic-change-dir>/.comet/handoff/` exists; do not rely on a POSIX-only directory command.
|
|
152
152
|
|
|
153
153
|
`<classic-change-dir>/.comet/handoff/brainstorm-summary.md` structure:
|
|
154
154
|
|
|
@@ -224,9 +224,9 @@ If there are no delta spec changes, skip the handoff regeneration step. The stat
|
|
|
224
224
|
|
|
225
225
|
Consider active compaction only **after the Design Doc and state evidence are persisted** and before Build. First confirm `design_doc`, the latest handoff, `handoff_hash`, and the design guard are durable so recovery never depends on an unwritten design judgment.
|
|
226
226
|
|
|
227
|
-
-
|
|
228
|
-
- If
|
|
229
|
-
- Never fake
|
|
227
|
+
- When a programmatically callable compaction mechanism is present and the context window is under pressure, invoke it once and include the change, next step, Design Doc, and handoff files in the resume prompt
|
|
228
|
+
- If compaction requires user action, give one non-blocking suggestion and continue; it **must not block** and must not create another confirmation point
|
|
229
|
+
- Never fake compaction with a shell command or an agent summary
|
|
230
230
|
|
|
231
231
|
## Exit Conditions
|
|
232
232
|
|
|
@@ -26,7 +26,7 @@ Streamlined OpenSpec artifacts must use the configured Comet artifact language.
|
|
|
26
26
|
|
|
27
27
|
Execution chain: open → build → root cause check → verify → archive. Hotfix provides default decisions for each phase: streamlined open, direct build, root cause confirmation, scale-based verification, and final archive confirmation after verification passes.
|
|
28
28
|
|
|
29
|
-
Before starting,
|
|
29
|
+
Before starting, use `comet/reference/scripts.md` to run the public Comet CLI command. When resuming from any entry point, first use `comet/reference/context-recovery.md` to check phase/workflow.
|
|
30
30
|
|
|
31
31
|
When resuming an existing hotfix change, the first state operation must be `comet state select <change-name>`. For a new change, run the command immediately after `.comet.yaml` initialization and before source writes.
|
|
32
32
|
|
|
@@ -161,7 +161,7 @@ Exception: when `.comet.yaml` has `auto_transition: false`, end the current invo
|
|
|
161
161
|
|
|
162
162
|
The following genuine user decisions still pause:
|
|
163
163
|
|
|
164
|
-
1. Encountering an upgrade-assessment signal (see "Upgrade Assessment" section). **
|
|
164
|
+
1. Encountering an upgrade-assessment signal (see "Upgrade Assessment" section). **Pause, present the choices, and wait for the user to explicitly choose**: continue the hotfix flow, or upgrade to the full `/comet-classic` workflow
|
|
165
165
|
2. Verify-phase acceptance of WARNING/SUGGESTION deviations, Spec drift handling, or strategy after the automatic repair limit; the first 3 clearly repairable failures close automatically
|
|
166
166
|
3. Final archive confirmation and the branch-handling decision after the archive commit
|
|
167
167
|
|
|
@@ -7,15 +7,6 @@ description: Use when the user explicitly invokes /comet-native, asks to start o
|
|
|
7
7
|
|
|
8
8
|
Native stores requirements, complete target specifications, state, and evidence. You understand, implement, and verify; the Runtime owns state, boundaries, and recovery.
|
|
9
9
|
|
|
10
|
-
## Progressive loading
|
|
11
|
-
|
|
12
|
-
Start with this file only. Read one reference when the corresponding task appears:
|
|
13
|
-
|
|
14
|
-
- If Shape contains unresolved user-visible behavior, read the [clarification reference](reference/clarification.md).
|
|
15
|
-
- If you need advanced options, receipts, partial scope, or an external-role handoff command, read the [command reference](reference/commands.md).
|
|
16
|
-
- If you need to edit the brief, specifications, or verification report, read the [artifact reference](reference/artifacts.md).
|
|
17
|
-
- If interruption, stale evidence, a repair stop, conflict, lock, or migration occurs, read the [recovery reference](reference/recovery.md).
|
|
18
|
-
|
|
19
10
|
## Core rules
|
|
20
11
|
|
|
21
12
|
Read these values from `.comet/config.yaml`:
|
|
@@ -28,15 +19,27 @@ Config, selection, change state, and formal artifacts on disk take precedence ov
|
|
|
28
19
|
|
|
29
20
|
The Native main workflow does not depend on any external Skill.
|
|
30
21
|
|
|
31
|
-
|
|
22
|
+
## CLI bootstrap
|
|
23
|
+
|
|
24
|
+
The Native Skill uses only the public `comet native <cmd>` CLI on PATH. Packaged command bundles are internal installation and Runtime assets; the Skill does not search for or invoke them directly. If a command returns `command not found`, `executable not found`, or `ENOENT`, stop and explain that the Comet CLI installation is incomplete. Do not search for Skill files, enumerate platform directories, or invoke an internal bundle directly.
|
|
25
|
+
|
|
26
|
+
Common commands:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
comet native status [--json]
|
|
30
|
+
comet native show <change-name>
|
|
31
|
+
comet native select <change-name>
|
|
32
|
+
comet native new <change-name> [--language en|zh-CN]
|
|
33
|
+
comet native next <change-name> --summary <text> [--confirmed]
|
|
34
|
+
comet native archive <change-name> --dry-run
|
|
35
|
+
```
|
|
32
36
|
|
|
33
37
|
## Start or resume
|
|
34
38
|
|
|
35
39
|
1. Run `comet native status` to identify the current change and phase.
|
|
36
|
-
2. Run `comet native show <change-name>` for the target. In Verify, Archive, or Build after a failure, also run
|
|
40
|
+
2. Run `comet native show <change-name>` for the target. In Verify, Archive, or Build after a failure, also run the status command with `--details`.
|
|
37
41
|
3. When more acceptance items are needed, follow `acceptancePage.nextCursor`. If findings are truncated, handle the returned findings and then read details again.
|
|
38
42
|
4. After confirming the target, run `comet native select <change-name>`.
|
|
39
|
-
5. Read only the formal artifacts, implementation, tests, and project rules needed by the current phase.
|
|
40
43
|
|
|
41
44
|
If multiple reasonable candidates remain, ask the user to select one. Create a change only after confirming that no matching active change exists:
|
|
42
45
|
|
|
@@ -47,11 +50,20 @@ comet native new <change-name> \
|
|
|
47
50
|
|
|
48
51
|
Use only the Native artifact root selected by project configuration.
|
|
49
52
|
|
|
53
|
+
## On-demand loading
|
|
54
|
+
|
|
55
|
+
After confirming the current change and phase, read one corresponding reference on demand:
|
|
56
|
+
|
|
57
|
+
- When entering Shape, you must first read and execute the [clarification reference](reference/clarification.md). Do not skip it because “the requirements look clear.” Do not modify project implementation or advance to Build until shared understanding is confirmed.
|
|
58
|
+
- If you need advanced options, receipts, or partial-scope commands, read the [command reference](reference/commands.md).
|
|
59
|
+
- If you need to edit the brief, specifications, or verification report, read the [artifact reference](reference/artifacts.md).
|
|
60
|
+
- If interruption, stale evidence, a repair stop, conflict, lock, or migration occurs, read the [recovery reference](reference/recovery.md).
|
|
61
|
+
|
|
50
62
|
## Shape
|
|
51
63
|
|
|
52
64
|
First investigate facts available from the repository, tools, and runtime environment. Ask the user only when different choices would materially change user-visible results and the existing requirements do not resolve the choice reliably. You own implementation choices.
|
|
53
65
|
|
|
54
|
-
|
|
66
|
+
Follow the clarification reference according to `clarification_mode`. Even when the initial assessment finds no unresolved behavior, complete its information classification and silent-assumption check. After every user answer, immediately update Decisions, the brief, and the complete target specifications in the same change. Keep unresolved items `[blocking]`; do not modify project implementation or advance while a blocker remains.
|
|
55
67
|
|
|
56
68
|
After all user decisions are resolved, check again for silent assumptions. Give the user a shared-understanding summary covering the goal, scope, key decisions, acceptance criteria, and non-goals. Only after explicit confirmation may you remove the final blocker and advance:
|
|
57
69
|
|
|
@@ -65,14 +77,15 @@ If the brief or specifications change confirmed behavior, obtain confirmation ag
|
|
|
65
77
|
|
|
66
78
|
Implement the simplest reliable solution that satisfies the brief and complete target specifications. Work may proceed in batches. Long tasks may use a checkpoint for recovery context, but a checkpoint is not completion evidence.
|
|
67
79
|
|
|
68
|
-
When requirements change, update the formal artifacts first. If a new user decision appears,
|
|
80
|
+
When requirements change, update the formal artifacts first. If a new user decision appears, stay in Build but repeat the Shape clarification and confirmation boundary: save a `[blocking]` item, pause implementation, and ask the user. After confirmation, update Decisions, the brief, and the complete target specifications, then remove the blocker. When leaving Build, run the command returned by the Runtime and pass `--confirmed`.
|
|
69
81
|
|
|
70
82
|
After the candidate implementation is complete, review it against the complete specifications and every acceptance item for omissions, then advance with real project artifacts:
|
|
71
83
|
|
|
72
84
|
```text
|
|
73
85
|
comet native next <change-name> \
|
|
74
86
|
--summary <summary> \
|
|
75
|
-
--artifact <project-path>
|
|
87
|
+
--artifact <project-path> \
|
|
88
|
+
[--confirmed]
|
|
76
89
|
```
|
|
77
90
|
|
|
78
91
|
If no code changed or the Runtime cannot prove complete scope, read the command reference. Never describe unknown or incomplete scope as complete.
|
|
@@ -81,23 +94,23 @@ If no code changed or the Runtime cannot prove complete scope, read the command
|
|
|
81
94
|
|
|
82
95
|
After entering Build, converge through this loop:
|
|
83
96
|
|
|
84
|
-
1. Run `status <change-name> --details` and read the currently required acceptance pages. After a Verify failure, prioritize failed or missing acceptance items and failed checks.
|
|
97
|
+
1. Run `comet native status <change-name> --details` and read the currently required acceptance pages. After a Verify failure, prioritize failed or missing acceptance items and failed checks.
|
|
85
98
|
2. Complete one related batch of real repairs. You may write a checkpoint before interruption, but a checkpoint is not completion evidence.
|
|
86
99
|
3. When a candidate implementation exists, reread the brief, complete specifications, and every acceptance item, then perform one complete review.
|
|
87
100
|
4. Run real validation and submit the Verify result.
|
|
88
101
|
5. `fail` returns to Build and repeats from step 1 without running Archive; only `pass` enters Archive.
|
|
89
102
|
|
|
90
|
-
|
|
103
|
+
`blocked` pauses the normal Build → Verify loop and enters a recovery branch. After handling the findings, resume from step 1 according to the new continuation. End the current work only at `done`, `await-user`, or an explicit caller stop point. One Agent turn, one checkpoint, one `blocked` result, or the Agent saying “complete” is not a terminal state. The Agent finds and repairs gaps; the Runtime decides whether completion has been proven.
|
|
91
104
|
|
|
92
105
|
## Verify
|
|
93
106
|
|
|
94
107
|
Run real validation based on the acceptance items, complete target specifications, and change risk. Record actual results in `verification.md` and the acceptance evidence. A check that did not run or failed cannot be reported as passed.
|
|
95
108
|
|
|
96
|
-
Use acceptance IDs and receipts returned by the Runtime. Read the artifact and command references when you need to generate the evidence block
|
|
109
|
+
Use acceptance IDs and receipts returned by the Runtime. Read the artifact and command references when you need to generate the evidence block or record an automated or manual receipt.
|
|
97
110
|
|
|
98
|
-
Submit `pass` only when the Runtime accepts the complete, fresh acceptance matrix
|
|
111
|
+
Submit `pass` only when the Runtime accepts the complete, fresh acceptance matrix and required checks. Reverify after relevant implementation, specification, report, or evidence changes.
|
|
99
112
|
|
|
100
|
-
`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.
|
|
113
|
+
`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`.
|
|
101
114
|
|
|
102
115
|
An intermediate Verify failure never runs Archive or triggers archive confirmation. Continue Build → Verify until pass, a Runtime block, or a required user decision.
|
|
103
116
|
|
|
@@ -121,8 +134,8 @@ Do not reuse an old preflight. If facts drift or a canonical conflict or unfinis
|
|
|
121
134
|
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:
|
|
122
135
|
|
|
123
136
|
- `continue`: reread the phase and currently required artifacts, then continue;
|
|
124
|
-
- `await-user`: wait for input that genuinely
|
|
125
|
-
- `blocked`: handle the findings and read the recovery reference when needed;
|
|
137
|
+
- `await-user`: wait for a decision or missing input that genuinely requires the user;
|
|
138
|
+
- `blocked`: pause the normal loop, handle the findings, and read the recovery reference when needed; then resume according to the new continuation rather than ending the task because it was `blocked`;
|
|
126
139
|
- `done`: the change is complete.
|
|
127
140
|
|
|
128
141
|
`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`.
|
|
@@ -124,18 +124,11 @@ Place the command output unchanged under `# Acceptance evidence`. The basic inpu
|
|
|
124
124
|
"status": "failed",
|
|
125
125
|
"evidence_refs": [],
|
|
126
126
|
"skipped_reason": "actual failure or incomplete reason"
|
|
127
|
-
},
|
|
128
|
-
{
|
|
129
|
-
"acceptance_id": "acceptance-<sha256>",
|
|
130
|
-
"status": "waived",
|
|
131
|
-
"evidence_refs": [],
|
|
132
|
-
"waiver_ref": "runtime/evidence/waivers/<sha256>.json"
|
|
133
127
|
}
|
|
134
128
|
]
|
|
135
129
|
```
|
|
136
130
|
|
|
137
131
|
- `passed` references a currently valid typed receipt.
|
|
138
132
|
- `failed` states the actual failure or skipped reason.
|
|
139
|
-
- `waived` references the waiver returned by an external signer.
|
|
140
133
|
|
|
141
134
|
Do not hand-format the machine block, reuse an evidence ref from another change, or report failed, skipped, or blocked results as passed.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Native Clarification Reference
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
You must read this file after entering Shape. Do not modify project implementation or advance to Build until problem classification, the silent-assumption check, and shared-understanding confirmation are complete.
|
|
4
4
|
|
|
5
5
|
## Whether to ask
|
|
6
6
|
|
|
@@ -1,35 +1,83 @@
|
|
|
1
1
|
# Native Command Reference
|
|
2
2
|
|
|
3
|
-
Read this file only when you need options not listed by the main Skill, receipts, partial scope,
|
|
3
|
+
Read this file only when you need options not listed by the main Skill, receipts, partial scope, or recovery commands.
|
|
4
4
|
|
|
5
5
|
## Project and change
|
|
6
6
|
|
|
7
|
+
Determine the current intent first; do not execute this section from top to bottom. Use read-only commands to establish facts, and run a write command only when its stated condition is met. After any write command, immediately reread `status <change-name>` and use the returned phase and continuation to decide what comes next.
|
|
8
|
+
|
|
9
|
+
### Enable Native for the first time
|
|
10
|
+
|
|
7
11
|
```text
|
|
8
12
|
comet native init [--root <artifact-root>] [--language en|zh-CN]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Use this only when the project has not enabled Native yet or when Native directories and language configuration need to be completed. It creates the required directories and writes `.comet/config.yaml`. Existing configuration keeps its current artifact root but may update the language. `init` does not migrate an existing artifact root; the command fails when an explicit `--root` conflicts with existing configuration.
|
|
16
|
+
|
|
17
|
+
Afterward, run `root show` to confirm the effective location. Do not use `init` as a resume command when a change already exists.
|
|
18
|
+
|
|
19
|
+
### Inspect or migrate the artifact root
|
|
20
|
+
|
|
21
|
+
```text
|
|
9
22
|
comet native root show
|
|
10
23
|
comet native root move <artifact-root>
|
|
24
|
+
```
|
|
11
25
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
26
|
+
`artifact-root` is project-relative.
|
|
27
|
+
|
|
28
|
+
- `root show` is read-only. It returns the project root, configured artifact root, effective Native directory, language, and any unfinished migration.
|
|
29
|
+
- `root move` is a transactional write operation. Run it only when the user explicitly wants to migrate the entire Native artifact root; it moves Native data and updates configuration. Do not simulate migration by editing configuration directly.
|
|
30
|
+
|
|
31
|
+
An unfinished migration blocks other Native writes. Run read-only `doctor` first, then follow its report and use `doctor --repair` to recover.
|
|
32
|
+
|
|
33
|
+
### Discover and read changes (read-only)
|
|
34
|
+
|
|
35
|
+
```text
|
|
15
36
|
comet native status [--cursor <token>]
|
|
16
37
|
comet native status <change-name> [--details [--acceptance-cursor <token>]]
|
|
38
|
+
comet native show <change-name>
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
`status` without a change name returns paginated candidates. When multiple reasonable candidates remain, show the candidates and their phases to the user and ask them to choose. Do not guess.
|
|
42
|
+
|
|
43
|
+
- `status <change-name>` returns the phase, revision, check summary, next command, and continuation. Add `--details` when findings, checkpoint details, or acceptance items are needed.
|
|
44
|
+
- `show` returns state, the brief, and proposed specs. Use it only after identifying the target change to read requirements and specifications; it does not replace the phase and continuation check.
|
|
45
|
+
- When `findingsTruncated` is true, handle the returned findings and read details again.
|
|
46
|
+
- When `acceptancePage.nextCursor` is non-null, continue with `--acceptance-cursor`.
|
|
47
|
+
- When a change collection has a non-null `nextCursor`, continue with `--cursor`.
|
|
48
|
+
|
|
49
|
+
These commands do not modify selection, phase, or change content.
|
|
50
|
+
|
|
51
|
+
### Resume an existing change
|
|
52
|
+
|
|
53
|
+
```text
|
|
17
54
|
comet native select <change-name>
|
|
18
|
-
comet native spec remove <change-name> <capability>
|
|
19
|
-
comet native spec rebase <change-name> --summary <text>
|
|
20
55
|
```
|
|
21
56
|
|
|
22
|
-
|
|
57
|
+
Run this only after the target change is unique or the user has explicitly selected it. `select` updates only the current Native selection and does not change the phase. A successful result returns that change's continuation.
|
|
23
58
|
|
|
24
|
-
`status
|
|
59
|
+
After selecting, reread `status <change-name>`, confirm the phase, and then load the reference for that phase. Do not treat `select` as a phase-transition command.
|
|
25
60
|
|
|
26
|
-
|
|
61
|
+
### Create a new change
|
|
27
62
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
63
|
+
```text
|
|
64
|
+
comet native new <change-name> [--language en|zh-CN]
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Run `new` only after confirming that no matching active change exists. When configuration is absent, it creates the default Native configuration and `docs/comet/`; it then creates a Shape change, makes it the current selection, and returns a continuation.
|
|
31
68
|
|
|
32
|
-
|
|
69
|
+
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
|
+
|
|
71
|
+
### Correct the specification history
|
|
72
|
+
|
|
73
|
+
```text
|
|
74
|
+
comet native spec remove <change-name> <capability>
|
|
75
|
+
comet native spec rebase <change-name> --summary <text>
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Neither command is an ordinary file-editing command. `spec remove` records a specification operation that removes a capability; use it only when the target behavior truly requires that capability to be removed. `spec rebase` handles concurrent canonical specification changes only: reread the canonical specification, rewrite the complete target specification, and use the summary to record why the rebase was needed.
|
|
79
|
+
|
|
80
|
+
Both `spec remove` and `spec rebase` modify the change's specification history and return a new continuation. Immediately reread `status <change-name>` afterward. Do not edit operations, base hashes, or Runtime state manually.
|
|
33
81
|
|
|
34
82
|
## Checkpoints and checks
|
|
35
83
|
|
|
@@ -66,53 +114,23 @@ Manual observation:
|
|
|
66
114
|
```text
|
|
67
115
|
comet native receipt manual <change-name> \
|
|
68
116
|
--acceptance <id> \
|
|
69
|
-
--responsible <text> \
|
|
70
117
|
--step <text> \
|
|
71
|
-
--observation <text>
|
|
72
|
-
--confirmed
|
|
118
|
+
--observation <text>
|
|
73
119
|
```
|
|
74
120
|
|
|
75
121
|
Create receipts only for commands or manual observations that actually occurred. Failed, skipped, blocked, or timed-out results cannot support pass.
|
|
76
122
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
A high-risk change may require an implementation attestation, independent review, or waiver before it can pass. The current Agent may prepare and finalize handoff artifacts, but must not perform an external role's approve or sign action or receive its private key.
|
|
80
|
-
|
|
81
|
-
Implementation handoff:
|
|
123
|
+
Refresh stale receipts in bulk:
|
|
82
124
|
|
|
83
125
|
```text
|
|
84
|
-
comet native receipt
|
|
85
|
-
--identity <implementation-identity> \
|
|
86
|
-
--output <preparation.json>
|
|
87
|
-
|
|
88
|
-
comet native receipt implement <change-name> finalize \
|
|
89
|
-
--preparation <preparation.json> \
|
|
90
|
-
--attestation <owner-provided-attestation.json> \
|
|
91
|
-
--confirmed
|
|
126
|
+
comet native receipt refresh <change-name> [--apply]
|
|
92
127
|
```
|
|
93
128
|
|
|
94
|
-
|
|
129
|
+
A receipt is bound to the revision, contract, scope, snapshot, and artifacts in effect when it was issued. Any state write (checkpoint, spec refresh, phase advance) bumps the revision, which invalidates receipts issued before that bump. `next --result` then fails with `verification-receipt-binding-mismatch`, listing each stale receipt and the diverging field.
|
|
95
130
|
|
|
96
|
-
|
|
97
|
-
comet native receipt review <change-name> prepare \
|
|
98
|
-
--implementation-receipt <ref> \
|
|
99
|
-
--report <verification.md> \
|
|
100
|
-
--required-receipt <ref> \
|
|
101
|
-
--identity <reviewer-identity> \
|
|
102
|
-
[--unified-io-receipt <ref> \
|
|
103
|
-
--adversarial-paths-receipt <ref> \
|
|
104
|
-
--generated-assets-receipt <ref> \
|
|
105
|
-
--lifecycle-eval-receipt <ref>] \
|
|
106
|
-
--output <preparation.json>
|
|
107
|
-
|
|
108
|
-
comet native receipt review <change-name> finalize \
|
|
109
|
-
--preparation <preparation.json> \
|
|
110
|
-
--approval <reviewer-provided-approval.json> \
|
|
111
|
-
--attestation <reviewer-provided-attestation.json> \
|
|
112
|
-
--confirmed
|
|
113
|
-
```
|
|
131
|
+
Without `--apply` (default) it is a preview: it reports which manual receipts are stale, which automated receipts must be re-run, and which required-check receipts must be regenerated via `comet native check`, without touching any file.
|
|
114
132
|
|
|
115
|
-
|
|
133
|
+
With `--apply`: it re-issues only stale manual receipts whose binding mismatch is limited to `sourceRevision`, and writes the canonical evidence block back into the `# Acceptance evidence` section of verification.md. Contract, scope, snapshot, or artifact mismatches remain manual verification blockers. Automated receipts are never silently re-issued (they attest to a real command execution); refresh only reports the commands you must re-run via `receipt automated`.
|
|
116
134
|
|
|
117
135
|
## Phase progression
|
|
118
136
|
|
|
@@ -124,12 +142,6 @@ comet native next <change-name> --summary <text> \
|
|
|
124
142
|
[--allow-partial-scope <sha256> --partial-reason <text> --confirmed] \
|
|
125
143
|
[--result pass|fail] \
|
|
126
144
|
[--report <change-relative-path>] \
|
|
127
|
-
[--receipt <required-receipt-ref>] \
|
|
128
|
-
[--evidence-receipt <acceptance-receipt-ref>]... \
|
|
129
|
-
[--waiver <waiver-ref>]... \
|
|
130
|
-
[--independent-review-receipt <review-receipt-ref>] \
|
|
131
|
-
[--failure-category <token>]... \
|
|
132
|
-
[--failed-check <token>]... \
|
|
133
145
|
[--override-repair <sha256> --override-summary <text>]
|
|
134
146
|
|
|
135
147
|
comet native archive <change-name> --dry-run
|
|
@@ -137,9 +149,9 @@ comet native archive <change-name> --expect-preflight <sha256> [--confirmed]
|
|
|
137
149
|
```
|
|
138
150
|
|
|
139
151
|
- Shape: pass `--confirmed` only after the user confirms the final shared understanding.
|
|
140
|
-
- Build: provide a real `--artifact`; use `--no-code-reason` only when no project file changed.
|
|
152
|
+
- 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`.
|
|
141
153
|
- 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.
|
|
142
|
-
- 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
|
|
154
|
+
- Verify: provide `--result` and a complete report. For the standard report path, submit `comet native next <change-name> --summary <summary> --result pass|fail --report verification.md`. On pass, the Runtime runs the built-in required check automatically. Acceptance entries in the report reference automated/manual receipts directly. Executed failures reference their failed receipts, while checks that were not run include a `skipped_reason`. The Runtime derives failed acceptance and check identifiers from the report and receipts.
|
|
143
155
|
- Repair override: use only the signature returned by status and only for one explicit new repair hypothesis.
|
|
144
156
|
- Archive: dry-run first, then use the exact preflight hash returned by that preview. `required` mode also requires explicit user confirmation.
|
|
145
157
|
|
|
@@ -39,6 +39,8 @@ The only safe options are:
|
|
|
39
39
|
|
|
40
40
|
Changes to the brief, specifications, implementation, report, or receipts may stale the old scope or Verify pass. Follow the continuation back to Build, reconfirm changed user-visible behavior, generate a new scope, and verify again. Do not reuse an old pass or preflight.
|
|
41
41
|
|
|
42
|
+
Receipts are bound to revision: every state write (checkpoint, spec refresh, phase advance) bumps the revision, which invalidates receipts issued before that bump. When `next --result` reports `verification-receipt-binding-mismatch`, the finding lists each stale receipt and the diverging field (e.g. `sourceRevision: expected 6, got 5`) and gives the recovery command. Only a source-revision-only mismatch on manual evidence can be refreshed without returning to Verify; run `comet native receipt refresh <change> --apply` to re-issue it at the current revision and rewrite verification.md. Contract, scope, snapshot, or artifact mismatches require fresh verification. Automated receipts must be re-executed with `receipt automated` and are never silently re-issued.
|
|
43
|
+
|
|
42
44
|
## Verify fail and repair stop
|
|
43
45
|
|
|
44
46
|
After Verify fail returns to Build:
|
|
@@ -48,7 +50,15 @@ After Verify fail returns to Build:
|
|
|
48
50
|
3. rerun the relevant validation;
|
|
49
51
|
4. submit the Verify result again.
|
|
50
52
|
|
|
51
|
-
When the same gap
|
|
53
|
+
When the same gap appears for the third time, the Runtime returns `repair-stagnation-stop`. This is not a user decision: read the signature from status, form one concrete new repair hypothesis that differs from the previous attempt, make the corresponding change, and use that signature and hypothesis summary for one repair override. Do not ask the user for a signature, hash, or override argument.
|
|
54
|
+
|
|
55
|
+
When the override is exhausted or `native.max_verify_failures` is reached, the continuation returns `await-user` with `repair-continuation-decision`. Explain the current failure and attempted approaches, then ask the user to choose only:
|
|
56
|
+
|
|
57
|
+
1. continue trying: increase `native.max_verify_failures` and continue;
|
|
58
|
+
2. change the confirmed contract: return to Shape, update the brief and complete target specification, and reconfirm;
|
|
59
|
+
3. stop this repair: preserve the change and current scene without progressing or running Archive.
|
|
60
|
+
|
|
61
|
+
The user chooses only the direction. You update configuration or formal artifacts, read the Runtime signature, and execute the follow-up commands.
|
|
52
62
|
|
|
53
63
|
## Canonical specification conflict
|
|
54
64
|
|