@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
|
@@ -7,15 +7,6 @@ description: 当用户明确调用 /comet-native、要求启动或恢复 Native
|
|
|
7
7
|
|
|
8
8
|
Native 保存需求、完整目标规格、状态和证据。你负责理解、实现和验证;Runtime 负责状态、边界和恢复。
|
|
9
9
|
|
|
10
|
-
## 按需加载
|
|
11
|
-
|
|
12
|
-
先只使用本文件。遇到对应任务时再读取一份 reference:
|
|
13
|
-
|
|
14
|
-
- Shape 中存在尚未确定的用户可见行为时,读取[澄清参考](reference/clarification.md)。
|
|
15
|
-
- 需要高级参数、receipt、partial scope 或外部角色交接命令时,读取[命令参考](reference/commands.md)。
|
|
16
|
-
- 需要编辑 brief、规格或 verification 时,读取[产物参考](reference/artifacts.md)。
|
|
17
|
-
- 出现中断、失效证据、repair stop、冲突、锁或迁移问题时,读取[恢复参考](reference/recovery.md)。
|
|
18
|
-
|
|
19
10
|
## 核心规则
|
|
20
11
|
|
|
21
12
|
从 `.comet/config.yaml` 读取:
|
|
@@ -28,15 +19,27 @@ Native 保存需求、完整目标规格、状态和证据。你负责理解、
|
|
|
28
19
|
|
|
29
20
|
Native 主流程不依赖任何外部 Skill。
|
|
30
21
|
|
|
31
|
-
|
|
22
|
+
## CLI 引导
|
|
23
|
+
|
|
24
|
+
Native Skill 只使用 PATH 中的公开 `comet native <cmd>` CLI;随 Skill 发布的命令 bundle 属于内部安装与 Runtime 资产,不由 Skill 搜索或直接调用。若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整;不得搜索 Skill 文件、枚举平台目录或直接调用内部 bundle。
|
|
25
|
+
|
|
26
|
+
常用命令:
|
|
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
|
## 开始或恢复
|
|
34
38
|
|
|
35
39
|
1. 运行 `comet native status`,确认当前 change 和 phase。
|
|
36
|
-
2. 对目标运行 `comet native show <change-name>`;Verify、Archive 或失败后的 Build
|
|
40
|
+
2. 对目标运行 `comet native show <change-name>`;Verify、Archive 或失败后的 Build 再对 status 命令加 `--details` 运行。
|
|
37
41
|
3. 需要更多 acceptance 时,按 `acceptancePage.nextCursor` 分页;findings 被截断时,先处理已返回项,再重新读取。
|
|
38
42
|
4. 确认目标后运行 `comet native select <change-name>`。
|
|
39
|
-
5. 只读取当前 phase 需要的正式产物、实现、测试和项目规则。
|
|
40
43
|
|
|
41
44
|
存在多个合理候选时让用户选择。只有确认没有对应 active change 时才创建:
|
|
42
45
|
|
|
@@ -47,11 +50,20 @@ comet native new <change-name> \
|
|
|
47
50
|
|
|
48
51
|
只使用配置指定的 Native artifact root。
|
|
49
52
|
|
|
53
|
+
## 按需加载
|
|
54
|
+
|
|
55
|
+
确认当前 change 和 phase 后,再按需读取一份对应 reference:
|
|
56
|
+
|
|
57
|
+
- 进入 Shape 时,必须先读取并执行[澄清参考](reference/clarification.md)。不得以“需求看起来明确”为由跳过;完成共享理解确认前,不得修改项目实现或推进到 Build。
|
|
58
|
+
- 需要高级参数、receipt 或 partial scope 命令时,读取[命令参考](reference/commands.md)。
|
|
59
|
+
- 需要编辑 brief、规格或 verification 时,读取[产物参考](reference/artifacts.md)。
|
|
60
|
+
- 出现中断、失效证据、repair stop、冲突、锁或迁移问题时,读取[恢复参考](reference/recovery.md)。
|
|
61
|
+
|
|
50
62
|
## Shape
|
|
51
63
|
|
|
52
64
|
先调查能从仓库、工具和运行环境查明的事实。只有不同选择会实质改变用户可见结果,并且无法从已有要求可靠确定时,才询问用户;实现方式由你决定。
|
|
53
65
|
|
|
54
|
-
|
|
66
|
+
按 `clarification_mode` 执行澄清参考。即使初步判断没有未决行为,也必须完成其中的信息分类和静默假设检查。每次用户回答后,立即更新同一个 change 的 Decisions、brief 和完整目标规格。未解决项继续以 `[blocking]` 保存;存在阻塞项时不修改项目实现,也不推进阶段。
|
|
55
67
|
|
|
56
68
|
所有用户决定处理完后,重新检查是否仍有静默假设,并向用户提供目标、范围、关键决定、验收标准和非目标的共享理解摘要。只有用户明确确认后,才移除最终阻塞项并推进:
|
|
57
69
|
|
|
@@ -65,14 +77,15 @@ brief 或规格改变已确认的行为时,重新取得用户确认;不要
|
|
|
65
77
|
|
|
66
78
|
实现满足 brief 和完整目标规格的最简单可靠方案。可以分批完成;长任务可使用 checkpoint 保存恢复摘要,但 checkpoint 不是完成证据。
|
|
67
79
|
|
|
68
|
-
|
|
80
|
+
需求变化时先更新正式产物。出现新的用户决定时保持在 Build,但重新执行 Shape 的澄清与确认边界:保存 `[blocking]`、暂停实现并询问用户。用户确认后,更新 Decisions、brief 和完整目标规格并移除阻塞项;离开 Build 时执行 Runtime 返回的命令并传入 `--confirmed`。
|
|
69
81
|
|
|
70
82
|
候选实现完成后,对照完整规格和全部 acceptance 复核是否仍有遗漏,再提供真实项目产物推进:
|
|
71
83
|
|
|
72
84
|
```text
|
|
73
85
|
comet native next <change-name> \
|
|
74
86
|
--summary <摘要> \
|
|
75
|
-
--artifact <项目内路径>
|
|
87
|
+
--artifact <项目内路径> \
|
|
88
|
+
[--confirmed]
|
|
76
89
|
```
|
|
77
90
|
|
|
78
91
|
没有代码变化或 Runtime 无法证明完整 scope 时,读取命令参考。不得把未知或不完整范围声明为 complete。
|
|
@@ -81,23 +94,23 @@ comet native next <change-name> \
|
|
|
81
94
|
|
|
82
95
|
进入 Build 后按以下循环收敛:
|
|
83
96
|
|
|
84
|
-
1. 运行 `status <change-name> --details
|
|
97
|
+
1. 运行 `comet native status <change-name> --details`,读取当前需要的 acceptance 页;上一轮 Verify 失败时,优先处理 failed/missing acceptance 和 failed check。
|
|
85
98
|
2. 完成一批相关的实际修复。需要中断时可以写 checkpoint,但 checkpoint 不是完成证据。
|
|
86
99
|
3. 形成候选实现后,重新读取 brief、完整规格和全部 acceptance,执行一次完整审查。
|
|
87
100
|
4. 运行真实验证并提交 Verify 结果。
|
|
88
101
|
5. `fail` 回到 Build,从第 1 步继续,且不运行 Archive;`pass` 才进入 Archive。
|
|
89
102
|
|
|
90
|
-
|
|
103
|
+
`blocked` 会暂停正常 Build → Verify 循环并进入恢复分支。处理 findings 后,根据新的 continuation 从第 1 步恢复循环。只有 `done`、`await-user` 或调用方明确要求停止时,才结束当前工作。一次 Agent turn、一次 checkpoint、一次 `blocked` 或 Agent 自述“已完成”都不是终态。Agent 负责发现并修复缺口,Runtime 负责判断是否完成。
|
|
91
104
|
|
|
92
105
|
## Verify
|
|
93
106
|
|
|
94
107
|
根据 acceptance、完整目标规格和改动风险运行真实验证。用实际结果完成 `verification.md` 和验收证据;未运行或失败的检查不能写成通过。
|
|
95
108
|
|
|
96
|
-
使用 Runtime 返回的 acceptance ID 和 receipt
|
|
109
|
+
使用 Runtime 返回的 acceptance ID 和 receipt。需要生成证据块或记录 automated/manual receipt 时,读取产物与命令参考。
|
|
97
110
|
|
|
98
|
-
只有 Runtime
|
|
111
|
+
只有 Runtime 接受完整且新鲜的验收矩阵和 required checks 时才能提交 `pass`。相关实现、规格、报告或证据改变后重新验证。
|
|
99
112
|
|
|
100
|
-
`fail` 会回到 Build。先根据 Runtime 返回的 failed/missing acceptance 和 failed check 修复,再重新验证;不要把再次调用 `next`
|
|
113
|
+
`fail` 会回到 Build。先根据 Runtime 返回的 failed/missing acceptance 和 failed check 修复,再重新验证;不要把再次调用 `next` 当作修复。`repair-stagnation-stop` 由 Agent 按恢复参考提出新假设并使用 Runtime 返回的 override;只有 continuation 要求 `repair-continuation-decision` 时才等待用户选择。
|
|
101
114
|
|
|
102
115
|
Verify 失败的中间循环不运行 Archive,也不触发归档确认。持续执行 Build → Verify,直到 pass、Runtime 阻塞或需要用户决定。
|
|
103
116
|
|
|
@@ -121,8 +134,8 @@ comet native archive <change-name> --dry-run
|
|
|
121
134
|
Shape、Build 和 Verify 的 transition 都会返回 `next: auto | manual`、`continuation.disposition: continue | await-user | blocked | done`、所需输入与下一步动作;Archive 不通过 `next` 推进,归档成功才返回 `done`。每次 transition 后按该 Runtime continuation 行动:
|
|
122
135
|
|
|
123
136
|
- `continue`:重新读取 phase 和当前所需产物后继续;
|
|
124
|
-
- `await-user
|
|
125
|
-
- `blocked
|
|
137
|
+
- `await-user`:等待确实需要用户决定或补充的输入;
|
|
138
|
+
- `blocked`:暂停正常循环,处理 findings,必要时读取恢复参考;处理后按新的 continuation 恢复,不因 `blocked` 本身结束任务;
|
|
126
139
|
- `done`:change 已完成。
|
|
127
140
|
|
|
128
141
|
`next: auto` 只表示本次 transition 成功,不表示后续步骤已执行。调用方明确要求在某次 transition 后停止时,严格按“更新正式产物 → 执行一次允许的 transition → transition 成功后不再调用工具 → 输出约定标记并结束本轮”执行;即使 continuation 为 `continue` 也不得继续执行后续步骤。
|
|
@@ -124,18 +124,11 @@ comet native evidence format [--entries <path>]
|
|
|
124
124
|
"status": "failed",
|
|
125
125
|
"evidence_refs": [],
|
|
126
126
|
"skipped_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` 引用当前有效的 typed receipt。
|
|
138
132
|
- `failed` 说明真实失败或跳过原因。
|
|
139
|
-
- `waived` 引用外部 signer 返回的 waiver。
|
|
140
133
|
|
|
141
134
|
不要手工排版机器块,不要复用旧 change 的 evidence ref,也不要把失败、跳过或阻塞结果写成通过。
|
|
@@ -1,35 +1,83 @@
|
|
|
1
1
|
# Native 命令参考
|
|
2
2
|
|
|
3
|
-
只在需要主 Skill 未列出的参数、receipt、partial scope
|
|
3
|
+
只在需要主 Skill 未列出的参数、receipt、partial scope 或恢复命令时读取本文件。
|
|
4
4
|
|
|
5
5
|
## 项目与 change
|
|
6
6
|
|
|
7
|
+
先判断当前意图;不要按本节顺序逐条执行。只读命令用于确认事实,写命令只在对应条件满足时执行。执行写命令后立即重读 `status <change-name>`,按返回的 phase 和 continuation 决定下一步。
|
|
8
|
+
|
|
9
|
+
### 首次启用 Native
|
|
10
|
+
|
|
7
11
|
```text
|
|
8
12
|
comet native init [--root <artifact-root>] [--language en|zh-CN]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
只在项目尚未启用 Native,或需要补齐 Native 目录与语言配置时使用。它会创建所需目录并写入 `.comet/config.yaml`;已有配置会保留当前 artifact root,但可更新语言。`init` 不迁移已有 artifact root;显式 `--root` 与现有配置冲突时命令会失败。
|
|
16
|
+
|
|
17
|
+
完成后运行 `root show` 确认实际位置。不要在已经存在 change 时把 `init` 当作恢复命令。
|
|
18
|
+
|
|
19
|
+
### 查看或迁移 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` 是项目内相对路径。
|
|
27
|
+
|
|
28
|
+
- `root show` 是只读命令,返回项目根、配置的 artifact root、实际 Native 目录、语言和未完成迁移。
|
|
29
|
+
- `root move` 是事务性写操作,只在用户明确要迁移整个 Native artifact root 时执行;它会移动 Native 数据并更新配置。不要直接编辑配置模拟迁移。
|
|
30
|
+
|
|
31
|
+
迁移未完成时,其他 Native 写操作会被阻塞。先运行只读 `doctor`,再按报告使用 `doctor --repair` 恢复。
|
|
32
|
+
|
|
33
|
+
### 发现并读取 change(只读)
|
|
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
|
+
无 change 名称的 `status` 返回分页候选。存在多个合理候选时,把候选及 phase 展示给用户选择,不要猜测。
|
|
42
|
+
|
|
43
|
+
- `status <change-name>` 返回 phase、revision、检查摘要、下一条命令和 continuation;需要 findings、checkpoint 细节或 acceptance 时加 `--details`。
|
|
44
|
+
- `show` 返回 state、brief 和 proposed specs;只在已经确定目标 change 后使用它读取需求与规格,不用它代替 phase/continuation 检查。
|
|
45
|
+
- `findingsTruncated` 为 true 时,先处理已返回项,再重新读取。
|
|
46
|
+
- `acceptancePage.nextCursor` 非空时,用 `--acceptance-cursor` 继续读取。
|
|
47
|
+
- change 集合的 `nextCursor` 非空时,用 `--cursor` 继续读取。
|
|
48
|
+
|
|
49
|
+
这些命令都不修改 selection、phase 或 change 内容。
|
|
50
|
+
|
|
51
|
+
### 恢复已有 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
|
+
只在目标 change 已唯一确定或由用户明确选择后执行。`select` 只更新当前 Native selection,不改变 phase;成功结果会返回该 change 的 continuation。
|
|
23
58
|
|
|
24
|
-
`status
|
|
59
|
+
选择后重新读取 `status <change-name>`,确认 phase,再加载该 phase 对应的 reference。不要把 `select` 当作阶段推进命令。
|
|
25
60
|
|
|
26
|
-
|
|
61
|
+
### 创建新 change
|
|
27
62
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
63
|
+
```text
|
|
64
|
+
comet native new <change-name> [--language en|zh-CN]
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
只有确认没有对应 active change 时才运行 `new`。配置缺失时,它会创建默认 Native 配置与 `docs/comet/`;随后创建一个 Shape change、把它设为当前 selection,并返回 continuation。
|
|
68
|
+
|
|
69
|
+
创建后立即运行 `show <change-name>` 与 `status <change-name>`,然后进入 Shape 澄清与共享理解确认。不要创建新 change 来绕过旧 change 的阻塞、冲突或恢复问题。
|
|
31
70
|
|
|
32
|
-
|
|
71
|
+
### 修正规格轨迹
|
|
72
|
+
|
|
73
|
+
```text
|
|
74
|
+
comet native spec remove <change-name> <capability>
|
|
75
|
+
comet native spec rebase <change-name> --summary <text>
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
这两条都不是普通文件编辑命令。`spec remove` 把 capability 记录为待移除的规格操作;只在目标行为确实要求移除该 capability 时使用。`spec rebase` 只处理 canonical 规格发生并发变化的情况:先重读 canonical 规格并改写完整目标规格,再用摘要记录 rebase 原因。
|
|
79
|
+
|
|
80
|
+
`spec remove` 和 `spec rebase` 都会修改 change 的规格轨迹并返回新的 continuation。执行后立即重读 `status <change-name>`;不要手改 operation、base hash 或 Runtime 状态。
|
|
33
81
|
|
|
34
82
|
## Checkpoint 与检查
|
|
35
83
|
|
|
@@ -66,53 +114,23 @@ comet native receipt automated <change-name> \
|
|
|
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
|
只为真实执行的命令或人工观察生成 receipt。失败、跳过、阻塞或超时结果不能作为 pass。
|
|
76
122
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
高风险 change 的 pass 可能要求 implementation attestation、independent review 或 waiver。当前 Agent 可以准备和最终导入交接产物,但不得执行外部角色的 approve/sign,也不得接收其私钥。
|
|
80
|
-
|
|
81
|
-
Implementation 交接:
|
|
123
|
+
批量刷新过期 receipt:
|
|
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
|
+
receipt 绑定生成时的 revision、contract、scope、snapshot 与 artifact。任何一次状态写入(checkpoint、规格刷新、阶段推进)都会让 revision 递增,导致此前签发的 receipt 绑定过期。`next --result` 会因此报 `verification-receipt-binding-mismatch` 并列出每个过期 receipt 及其不一致字段。
|
|
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
|
+
不带 `--apply`(默认)为预览:只报告哪些 manual receipt 过期、哪些 automated receipt 需重跑、哪些 required-check receipt 需用 `comet native check` 重生成,不改动任何文件。
|
|
114
132
|
|
|
115
|
-
|
|
133
|
+
带 `--apply` 时:只对绑定不一致仅限于 `sourceRevision` 的过期 manual receipt 按当前 revision 重新签发,并把规范证据块写回 verification.md 的 `# Acceptance evidence` 段;contract、scope、snapshot 或 artifact 不一致仍会阻塞并要求重新人工验证。automated receipt 不会被静默重签(它证明一次真实命令执行),refresh 只报告需重跑的命令让你用 `receipt automated` 重新执行。
|
|
116
134
|
|
|
117
135
|
## 阶段推进
|
|
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:只有用户确认最终共享理解后才传 `--confirmed`。
|
|
140
|
-
- Build:提供真实 `--artifact`;确实没有项目文件变化时使用 `--no-code-reason`。
|
|
152
|
+
- Build:提供真实 `--artifact`;确实没有项目文件变化时使用 `--no-code-reason`。如果需求变化引入新的用户决定,先保持在 Build 并重新完成澄清与确认;确认后更新正式产物,再执行 Runtime 返回的 transition 命令并传入 `--confirmed`。
|
|
141
153
|
- Partial scope:先向用户说明 Runtime 返回的具体缺口和风险。超出已返回明细预算的变化由 `scope-detail-overflow` 数量和内容 hash 汇总;只有用户接受后才使用完全匹配的 scope hash、理由和 `--confirmed`。
|
|
142
|
-
- Verify:提供 `--result` 和完整报告。标准报告路径提交为 `comet native next <change-name> --summary <摘要> --result pass|fail --report verification.md
|
|
154
|
+
- Verify:提供 `--result` 和完整报告。标准报告路径提交为 `comet native next <change-name> --summary <摘要> --result pass|fail --report verification.md`。Runtime 在 pass 时自动执行内置 required check;报告中的 acceptance 条目直接引用 automated/manual receipt。已执行但失败的条目引用对应失败 receipt,未执行的条目写明 `skipped_reason`。repair 的失败 acceptance 和检查标识由 Runtime 从报告与 receipt 自动推导。
|
|
143
155
|
- Repair override:只使用 status 返回的 signature,并且只在有一个明确新修复假设时执行。
|
|
144
156
|
- Archive:先 dry-run,再使用本次预演返回的精确 preflight hash;`required` 模式还需要用户明确确认。
|
|
145
157
|
|
|
@@ -39,6 +39,8 @@ comet native doctor <change-name> --repair --strategy continue
|
|
|
39
39
|
|
|
40
40
|
brief、规格、实现、报告或 receipt 改变后,旧 scope 或 Verify pass 可能失效。按 continuation 回到 Build,重新确认发生变化的用户行为、生成新 scope 并重新验证。不要复用旧 pass 或旧 preflight。
|
|
41
41
|
|
|
42
|
+
receipt 与 revision 绑定:每次状态写入(checkpoint、规格刷新、阶段推进)都会让 revision 递增,此前签发的 receipt 会因此绑定过期。`next --result` 报 `verification-receipt-binding-mismatch` 时,finding 会列出每个过期 receipt 及其不一致字段(如 `sourceRevision: expected 6, got 5`),并给出恢复命令。只有 manual evidence 仅发生 sourceRevision 不一致时,才可以不回到 Verify,运行 `comet native receipt refresh <change> --apply` 按当前 revision 重签并写回 verification.md;contract、scope、snapshot 或 artifact 不一致都必须重新验证。automated receipt 必须用 `receipt automated` 重新执行原命令,不能静默重签。
|
|
43
|
+
|
|
42
44
|
## Verify fail 与 repair stop
|
|
43
45
|
|
|
44
46
|
Verify fail 回到 Build 后:
|
|
@@ -48,7 +50,15 @@ Verify fail 回到 Build 后:
|
|
|
48
50
|
3. 重新运行相关验证;
|
|
49
51
|
4. 再提交 Verify 结果。
|
|
50
52
|
|
|
51
|
-
|
|
53
|
+
相同缺口第三次出现时,Runtime 返回 `repair-stagnation-stop`。这不是用户决策:Agent 从 status 读取 signature,提出一个与上一轮不同且具体的新的修复假设,完成对应修改后,使用该 signature 和假设摘要执行一次 repair override。不要让用户提供 signature、hash 或 override 参数。
|
|
54
|
+
|
|
55
|
+
override 已耗尽或达到 `native.max_verify_failures` 时,continuation 返回 `await-user` 和 `repair-continuation-decision`。向用户说明当前失败和已尝试方案,只让用户选择:
|
|
56
|
+
|
|
57
|
+
1. 继续尝试:由 Agent 提高 `native.max_verify_failures` 后继续;
|
|
58
|
+
2. 调整已确认契约:回到 Shape 更新 brief 和完整目标规格,并重新确认;
|
|
59
|
+
3. 停止本次修复:保留 change 和当前现场,不继续推进或 Archive。
|
|
60
|
+
|
|
61
|
+
用户只做方向选择;Agent 负责修改配置或正式产物、读取 Runtime signature,并执行后续命令。
|
|
52
62
|
|
|
53
63
|
## Canonical spec 冲突
|
|
54
64
|
|
|
@@ -29,7 +29,7 @@ Tweak 是 Comet 五阶段能力的预设工作流,不是独立的平行流程
|
|
|
29
29
|
|
|
30
30
|
执行链路:open → OpenSpec apply → verify → archive。Tweak 为每个阶段提供默认决策:精简开启、通过 OpenSpec apply 直接构建、按规模与 delta spec 判定验证轻重、验证通过后进入归档前最终确认。
|
|
31
31
|
|
|
32
|
-
开始前按 `comet/reference/scripts.md`
|
|
32
|
+
开始前按 `comet/reference/scripts.md` 运行公开 Comet CLI 命令;从任意入口恢复时先按 `comet/reference/context-recovery.md` 检查 phase/workflow。
|
|
33
33
|
|
|
34
34
|
恢复已有 tweak change 时,第一项状态操作必须是 `comet state select <change-name>`;创建新 change 时,在 `.comet.yaml` 初始化成功后立即运行该命令,再进入源码写入步骤。
|
|
35
35
|
|
|
@@ -153,7 +153,7 @@ comet state set <change-name> verify_mode full
|
|
|
153
153
|
<IMPORTANT>
|
|
154
154
|
Tweak 流程默认 **一次性连续执行**。调用 `/comet-tweak` 后,agent 在 tweak 自有步骤间自动推进,不主动停顿。**例外**:若 `auto_transition: false`,则在每个 phase 边界(build/verify/archive 之间)结束当前调用并按 `HINT` 交还控制权,由用户稍后手动运行下一阶段命令;这是手动衔接,不是新的确认点。无论 `auto_transition` 取何值,以下真正的用户决策仍需暂停:
|
|
155
155
|
|
|
156
|
-
1.
|
|
156
|
+
1. 遇到升级判定信号(见「升级判定」章节),**必须暂停、展示选择并等待用户明确选择**:继续 tweak 轻量流程,还是升级为完整 `/comet-classic` 流程
|
|
157
157
|
2. 验证阶段(comet-verify)接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移或超过自动修复上限后的策略决策;前 3 次明确可修复失败自动闭环
|
|
158
158
|
3. 归档前最终确认,以及归档提交后的分支处理决策
|
|
159
159
|
|
|
@@ -63,7 +63,7 @@ comet state get <change-name> plan
|
|
|
63
63
|
git diff --stat <从 plan frontmatter 读取的 base-ref>...HEAD
|
|
64
64
|
```
|
|
65
65
|
|
|
66
|
-
第一条命令返回 plan
|
|
66
|
+
第一条命令返回 plan 路径;使用文件读取工具解析其 frontmatter 中唯一的 `base-ref`,确认它是有效提交后再代入第二条命令。不得依赖 POSIX 文本管道。
|
|
67
67
|
|
|
68
68
|
若提交区间显示改动超过轻量阈值(> 8 个文件、跨模块协调、或 delta spec 超过 1 个 capability),手动设置为完整验证:
|
|
69
69
|
|
|
@@ -173,7 +173,7 @@ comet state transition <change-name> verify-fail
|
|
|
173
173
|
```
|
|
174
174
|
|
|
175
175
|
**Spec 漂移处理**(用户决策点):
|
|
176
|
-
- 若检查项 6 发现矛盾(delta spec 有内容但 design doc
|
|
176
|
+
- 若检查项 6 发现矛盾(delta spec 有内容但 design doc 未体现),**必须以单选题形式暂停、展示处理方式并等待用户选择**,不得自动选择。选项:
|
|
177
177
|
- 选项 A:在 design doc 追加 "Implementation Divergence" 节记录偏差原因。选项 A 属于 verify 阶段允许产物;写入后不得因该 design doc 变更再次触发 Step 1b dirty-worktree 决策
|
|
178
178
|
- 选项 B:用户选择 B 后,运行 `comet state transition <change-name> verify-fail`,然后调用 `/comet-build`;由 `/comet-build` 的 Spec 增量更新规则加载 Superpowers `brainstorming` 更新 Design Doc + delta spec
|
|
179
179
|
- 选项 C:确认偏差可接受,继续验证(归档时 design doc 将标记为 `superseded-by-main-spec`)
|
|
@@ -186,7 +186,7 @@ comet state transition <change-name> verify-fail
|
|
|
186
186
|
comet state set <change-name> verification_report docs/superpowers/reports/YYYY-MM-DD-<change-name>-verify.md
|
|
187
187
|
```
|
|
188
188
|
|
|
189
|
-
|
|
189
|
+
使用文件工具创建 `docs/superpowers/reports/` 和报告文件,不依赖 POSIX 专用目录命令。
|
|
190
190
|
|
|
191
191
|
## 退出条件
|
|
192
192
|
|
package/bin/comet.js
CHANGED
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { existsSync } from 'fs';
|
|
2
|
+
import { fileURLToPath } from 'url';
|
|
3
|
+
|
|
4
|
+
const CLASSIC_ASSETS = {
|
|
5
|
+
state: 'assets/skills/comet/scripts/comet-state.mjs',
|
|
6
|
+
guard: 'assets/skills/comet/scripts/comet-guard.mjs',
|
|
7
|
+
handoff: 'assets/skills/comet/scripts/comet-handoff.mjs',
|
|
8
|
+
archive: 'assets/skills/comet/scripts/comet-archive.mjs',
|
|
9
|
+
};
|
|
10
|
+
|
|
11
|
+
const NATIVE_COMMANDS = new Set([
|
|
12
|
+
'init',
|
|
13
|
+
'root',
|
|
14
|
+
'new',
|
|
15
|
+
'spec',
|
|
16
|
+
'show',
|
|
17
|
+
'status',
|
|
18
|
+
'select',
|
|
19
|
+
'checkpoint',
|
|
20
|
+
'check',
|
|
21
|
+
'evidence',
|
|
22
|
+
'receipt',
|
|
23
|
+
'next',
|
|
24
|
+
'archive',
|
|
25
|
+
'doctor',
|
|
26
|
+
]);
|
|
27
|
+
|
|
28
|
+
function hasHelpFlag(args) {
|
|
29
|
+
const separator = args.indexOf('--');
|
|
30
|
+
const commandArgs = separator < 0 ? args : args.slice(0, separator);
|
|
31
|
+
return commandArgs.includes('--help') || commandArgs.includes('-h');
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Resolves only public commands whose package-owned self-contained runtime has
|
|
36
|
+
* the same argv contract. Returning null preserves Commander for all other
|
|
37
|
+
* commands, including help and unknown-command diagnostics.
|
|
38
|
+
*/
|
|
39
|
+
export function resolveFastRuntime(argv) {
|
|
40
|
+
if (argv.length === 0 || hasHelpFlag(argv)) return null;
|
|
41
|
+
|
|
42
|
+
const [group, command, ...tail] = argv;
|
|
43
|
+
const classicAsset = CLASSIC_ASSETS[group];
|
|
44
|
+
if (classicAsset) return { assetPath: classicAsset, args: argv.slice(1) };
|
|
45
|
+
|
|
46
|
+
if (group === 'workflow' && command === 'resolve') {
|
|
47
|
+
return {
|
|
48
|
+
assetPath: 'assets/skills/comet/scripts/comet-entry-runtime.mjs',
|
|
49
|
+
args: tail,
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
if (group === 'native' && command && NATIVE_COMMANDS.has(command)) {
|
|
54
|
+
return {
|
|
55
|
+
assetPath: `assets/skills/comet-native/scripts/comet-native-${command}.mjs`,
|
|
56
|
+
args: tail,
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
return null;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
function assetUrl(assetPath) {
|
|
64
|
+
return new URL(`../${assetPath}`, import.meta.url);
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* Runs a fast runtime in this same Node process. Package-relative resolution
|
|
69
|
+
* deliberately belongs to the CLI; Skills never locate or invoke bundles.
|
|
70
|
+
*/
|
|
71
|
+
export async function tryRunFastRuntime(argv = process.argv.slice(2)) {
|
|
72
|
+
const route = resolveFastRuntime(argv);
|
|
73
|
+
if (!route) return false;
|
|
74
|
+
|
|
75
|
+
const runtimeUrl = assetUrl(route.assetPath);
|
|
76
|
+
const runtimePath = fileURLToPath(runtimeUrl);
|
|
77
|
+
if (!existsSync(runtimePath)) return false;
|
|
78
|
+
|
|
79
|
+
process.argv = [process.execPath, runtimePath, ...route.args];
|
|
80
|
+
await import(runtimeUrl.href);
|
|
81
|
+
return true;
|
|
82
|
+
}
|