Release v0.3.2

Highlights

• Per-mode permissions matrix in modes.json, emitted as opencode v2 permissions: rules and enforced by verify.py and the opencode install smoke test.
• Breaking: v1 permission: dict replaced by v2 permissions: list — migrate downstream parsers.
• new_task → task rename across skills/agents; emitter fail-loud and scoped-glob oracle hardening.

Full changelog: https://github.com/gelse/AI-snippets/blob/main/CHANGELOG.md#032---2026-10-10

Release v0.3.1

Fixed

• Makefile install-opencode-global skill copy: the loop globbed the flat output/opencode/skill/*.md path while the generator emits output/opencode/skill/<name>/SKILL.md, so no skills were installed (cp: cannot stat). The loop now iterates output/opencode/skill/*/SKILL.md and installs every skill as $(OPENCODE_CONFIG_HOME)/opencode/skills/<name>/SKILL.md with companion files alongside; a failing SKILL.md copy aborts the target. Regression test: scripts/smoke-test-opencode-install.sh.

Included fix commits

• 9f4b6f3 Harden opencode install loop and log fix in changelog
• 3901e24 Assert skill side files in opencode smoke test
• 4177c98 Update docs for fixed opencode skill install
• 757d731 Fix install-opencode-global skill copy

Release v0.3.0

Highlights

Release v0.3.0 — Python-only installer port, agent/skill refactor, and the removal of all npm packaging.

Fixed

• OpenCode skill emitter dir form: generate.py emitted flat output/opencode/skill/<name>.md files — a latent pre-existing bug, since OpenCode only discovers {skill,skills}/**/SKILL.md and silently ignored the flat output. Skills are now written as output/opencode/skill/<name>/SKILL.md (frontmatter and body unchanged).
• docs/development.md CLI-installer note states the CLI emits directory-form skills that OpenCode discovers; the scripts/smoke-test.sh post-overwrite assertion comment references the generated output/ tree.

Changed

• Agent/skill refactor: each active mode's agents/<slug>.md instruction file is reduced to a stub that names its agent-<slug> runbook skill, and ten new skills/agent-<slug>.md skills carry the full workflows; modes.json wires the two together. docs/architecture.md, docs/lieutenant-workflow.md, and README.md reflect the stub/runbook split.
• Dispatch contract: the target-agent / target-agent-skill header every new_task dispatch must carry is specified in skills/agent-captain.md and skills/agent-lieutenant.md.

Added

• scripts/install.py — Python installer: plan-then-execute, collision prompts [o]verwrite/[s]kip/[a]bt], --yes/--dry-run, --global|--local, --skills-only|--agents-only, interactive wizard, and the non-TTY stdin contract. Reads output/install-manifest.json.
• scripts/merge-modes.py importable merge() refactor with byte-identical CLI behavior.
• Smoke tests (scripts/smoke-test.sh, scripts/smoke-test-double-install.sh) rewritten to invoke the Python installer.
• Dockerfile and docker-compose.yml for running the generators on hosts without Python 3.11.
• Claude Code documented in README.md as a research-phase target that is not officially supported.

Removed

• npm publishing: the npm-publish GitHub Actions workflow and docs/npm-trusted-publishing.md; release.py finalize (GitHub release + tag on main) is the sole release automation.
• npm packaging + npx install path: package.json, package-lock.json, tsconfig.json, tsup.config.ts, the src/ TypeScript sources, skills/release/release.ts, and the Makefile node targets; make verify is now a thin alias of make check-py.

Release v0.2.0

AI-snippets v0.2.0

Second release. Testing promoted to main; tag v0.2.0 on main HEAD.

Added

• captain classification/supervision mode (default entry point, referenced by lieutenant); five task-type skills (full-feature, small-feature, bugfix, architecture, implementation-from-milestone); documentation skill.
• npm package scaffold + installer CLI (npx @gelse/ai-snippets install <tool> for zoo, kilo, opencode, claude) with interactive wizard, collision prompts, YAML merge for zoo global modes, and non-TTY stdin contract; install-manifest.json emitter; make package-npx* targets; OIDC npm publish workflow (trusted publishing).
• models/mapping.yaml model mapping (v0.1): OpenCode agents emit mapped model and a mode field derived from the mode's instantiation (default all); docs/opencode-target-drift.md drift report.
• make install-opencode-global (honors XDG_CONFIG_HOME); double-install and merge-idempotency smoke tests; check-node Makefile guard; node-optional block in make verify.

Changed

• orchestrator deprecated in favour of lieutenant (gatekeeper redirects); sequential nested new_task spawning in code/lieutenant; review-code/review-plan no longer spawn sub-tasks; merge-modes.py hardened; docs restructure (docs/architecture.md, docs/development.md, docs/lieutenant-workflow.md); README rewritten around the captain/skills layout; github-issue routed through captain.

Fixed

• Duplicate entries on re-install: mergeModesYaml() replaced the stale-index splice with single-pass filter by slug.
• OpenCode skills docs: discovery requires directory form {skill,skills}/**/SKILL.md.
• install-opencode-global honors XDG_CONFIG_HOME.

Removed

• Legacy JS-only Makefile targets and dual-stack scripts (generate.mjs, verify.mjs, scripts/package.json); Python (generate.py, verify.py) is the sole generator.

Full notes: see CHANGELOG.md → ## [0.2.0] - 2026-09-29.

Release v0.1.0

Initial development release of the AI-snippets toolkit.

Added

• modes.json mode definitions with generate.py generator and Makefile targets for Zoo, Claude Code, OpenCode, and Kilo Code deployment.
• Skills: github-issue, grilling, writing-for-humans, release (dual-form: markdown and directory with companion scripts).
• release.py CLI with preflight, changes, check-version, finalize, and post-verify subcommands, plus SKILL.md with pause gates.
• verify.py with dual-form skill validation and collision checks.

Fixed

• release.py now tags the release on main (after promotion) instead of testing.
• Moved finalize ancestry guards before checkout so aborted runs leave the tree on the original branch.