0.2.0 - Comet

What’s Changed [0.2.0] - 2026-05-18

Comet 0.2.0 is a comprehensive optimization release: skill reliability, CLI completeness, and engineering quality.

SKILL.md two-zone structure: All 8 skills split into “Decision Core” (phase detection, upgrade criteria, error handling) and “Reference Appendix” (field reference, scripts, best practices)
Quantified upgrade criteria: Hotfix/tweak now define explicit thresholds for upgrading to full workflow (file count, cross-module coordination, architecture changes, etc.)
Script location caching: All skills use ${VAR:-$(find ...)} env-var cache pattern, avoiding repeated find calls
manifest.json fixed: Added missing comet-state.sh and comet-archive.sh entries
comet-state.sh init fixed: Now writes workflow field to .comet.yaml, fixing check design which always failed

comet status: Show active changes with phase, task progress, workflow mode, design doc, and plan (--json supported)
comet doctor: Diagnose installation health — OpenSpec CLI, working directories, skill completeness per platform, script presence, .comet.yaml validity (--json supported)
comet update: Update comet skill files to latest version from npm package (--language, --scope supported)
--json on all commands: init, status, doctor, update all accept structured output

Test suite: 54 unit tests (5 suites) with 93.8% statement / 100% function coverage; 26 bats shell tests
GitHub Actions CI: Build + lint + format + test (Node 18/20/22) + shellcheck + bats on push/PR
ESLint + Prettier: Code quality tooling with pnpm lint / pnpm format
Code organization: Monolithic init.ts (620 lines) split into 5 focused core modules + 4 command modules
Command injection hardening: Platform/tool ID validation before shell command construction
Per-file error handling: Copy loop continues past individual file failures