What’s Changed [0.2.5] - 2026-05-22
Added
- PR title lint workflow: Added GitHub Actions validation for semantic PR titles with Comet-specific scopes (
cli,commands,core,skills,assets,scripts,docs,ci,deps,release) - Structured JSON output:
comet init --jsonandcomet update --jsonnow emit machine-readable results instead of mixed human logs doctor --scope:comet doctorcan diagnoseauto,project, orglobalscope, withautochecking both project and global installs- Next-step status hint:
comet statusnow reports the next workflow command (/comet-open,/comet-design,/comet-build,/comet-verify,/comet-archive) in text and JSON output - README asset guard: Added tests and prepublish validation to keep README images on npm-friendly absolute URLs
Changed
comet updatepreserves installed context: Update now detects existing Comet skill targets across project/global scopes, preserves installed scope, detects Chinese vs English skills, and updates only platforms where Comet skills are already installedcomet updateself-updates npm package: Update now prints and runs the matching npm update command for the detected package scope before refreshing installed skills- Friendlier update output: Update logs the npm command, per-target skill copy command, final npm status, updated target count, scope, and language summary
- Init overwrite flow: Interactive
comet initnow offers a bulk overwrite/skip choice when multiple existing components are detected on the same platform - CLI option validation:
update --language,update --scope, anddoctor --scopenow validate accepted values through Commander choices - README CLI docs: Updated English and Chinese README command sections to document JSON output, doctor scope, update behavior, status next-step hints, and init overwrite behavior
- CONTRIBUTING link: Added contribution guide references to both English and Chinese README development sections
Fixed
- Doctor false positives:
comet doctornow recognizes current.comet.yamlfields includingverification_reportandbranch_status - npm README images: README images now use absolute GitHub URLs so package pages can render them
Tests
- Added coverage for update language/scope detection, JSON output, friendly command display, status next-step hints, doctor current-state validation, README image URLs, init bulk overwrite selection, and PR title workflow configuration