0.3.2 - Comet

What’s Changed [0.3.2] - 2026-05-27

Script discovery helper: New comet-env.sh centralizes script path resolution by sourcing sibling scripts from its own directory, replacing the scattered COMET_SEARCH_ROOTS find logic across all English and Chinese skills.
OpenCode global config directory: OpenCode platform now supports a separate globalSkillsDir (.config/opencode) for global installs, keeping project and user-level skills distinct.
Command error diagnostics: New command-error.ts module extracts and cleans stderr/stdout from failed shell commands, used by both OpenSpec and Superpowers install paths to surface actionable failure details.

Build decision-point wording: Strengthened the build skill’s workspace-isolation and execution-method selection wording so agents cannot choose on behalf of the user based on recommendation rules.
Hotfix/Tweak upgrade wording: Reworded upgrade-condition and verification-failure pause requirements in hotfix and tweak skills for clearer blocking semantics.
Comet user decision numbering: Fixed out-of-sequence numbering in the Chinese comet skill’s user decision point list.

OpenSpec workflow installation: comet init now runs OpenSpec with --profile custom and a temporary config that enables all workflows (propose, explore, new, continue, apply, ff, sync, archive, bulk-archive, verify, onboard), ensuring Comet installs more than the default core workflow set.
OpenCode slash commands: comet init now generates OpenCode command files (commands/*.md) that keep the /comet* command names while embedding the corresponding Comet workflow content, so OpenCode users can invoke /comet, /comet-open, etc. directly.
Lingma Superpowers path: comet init now keeps Lingma out of the unsupported skills --agent lingma path and copies staged Superpowers skills into .lingma/skills, preventing the whole external installer batch from failing while preserving Lingma’s expected directory layout.
Lingma global directory: Lingma’s global skills directory is explicitly .lingma, matching ~/.lingma/skills/{skill-name}/SKILL.md for user-level installs and .lingma/skills/{skill-name}/SKILL.md for project installs.
Script discovery safety: comet-env.sh no longer changes caller shell options when sourced, returns failure when bundled scripts are missing, and avoids ShellCheck unreachable-command diagnostics.
comet-state.sh field whitelist: Added created_at and base_ref to the cmd_set allowed fields list, aligning validation with fields already written during .comet.yaml initialization.

Script discovery coverage: Added tests verifying comet-env.sh exports all bundled script paths and that no skill file inlines COMET_SEARCH_ROOTS.
Script discovery safety: Added regression coverage for sourced shell option preservation and expandable $HOME skill-directory globs.
OpenCode Comet detection: Added tests for OpenCode requiring both skill directories and matching command files before reporting Comet as installed.
OpenCode E2E init: Added end-to-end tests for OpenCode project and global scope installs, including command file generation.
OpenCode command content: Added tests that OpenCode command files preserve Comet command names and include full selected-language workflow content instead of a thin skill-delegation stub.
English workflow safeguards: Added parity tests matching the existing Chinese workflow decision-point requirements.
OpenSpec profile and diagnostics: Added tests for custom profile creation, --profile custom flag, and stderr/stdout detail printing on install failures.
Lingma Superpowers fallback: Added regression coverage that Lingma is excluded from the unsupported skills CLI agent list and uses a staging install before copying skills to .lingma.
Lingma global install path: Added regression coverage for comet init --scope global installing Lingma Comet skills under the user .lingma/skills directory.