v0.3.3 — Windows support

Windows support (#19)

Iago now runs on Windows (Git Bash), verified across Windows + Ubuntu + macOS in CI.

• CRLF-aware sanitize — the Mermaid sanitizer matches \r?\n fences, splits on either line ending, and re-joins with the document's original EOL, so CRLF files round-trip byte-for-byte instead of being normalized.
• tar --force-local — added on Windows Git Bash only (win32 + MSYSTEM), so GNU tar doesn't read the colon in C:\…\iago.tar.gz as a remote host. Native-Windows bsdtar (which doesn't support the flag) is left untouched.
• Tests now cover CRLF through an actual transformation (;→, message rewrite and [@…] flowchart label), not just the no-op path.

Thanks to @contributor for the fix and the cross-platform verification.

Internal

• OpenSpec baseline (config + principles + glossary) (#20).

npm: @drakulavich/iago@0.3.3

v0.3.2 — auto-quote leading-@ flowchart labels, mermaid.parse regression suite

Patch release.

Fixed

• #17 — A flowchart node label starting with @ (e.g. N[@utils/utils -> …]) made Mermaid ≥ 10.5 reject the whole diagram on GitHub ([@ is lexed as edge-ID/shape syntax). iago/scripts/sanitize.ts now auto-quotes such labels inside flowchart/graph blocks — including blocks prefixed by %% comments or %%{init: …}%% directives — so posted diagrams self-heal. The authoring rule was added to SKILL.md and references/mermaid-templates.md.

Maintenance

• #17 — New jsdom-backed mermaid.parse() validation helper and fixture-driven regression suite (cli/tests/fixtures/mermaid/{valid,invalid}/): the exact field-incident diagram is stored verbatim, and every Mermaid block in iago/examples/, the templates reference, and the README is parse-validated on each bun test run.
• #16 — Gitignore local cocoindex index + blog drafts.
• Aligned version bump across cli/package.json, .claude-plugin/plugin.json, and .claude-plugin/marketplace.json.

No breaking changes. The CLI is published to npm as @drakulavich/iago@0.3.2 (with provenance); the Claude plugin updates via the bumped marketplace manifests.

Full changelog: v0.3.1...v0.3.2

v0.3.1 — fix standalone-comment diagram replacement

Patch release.

Fixed

• #14 — iago/scripts/post.ts now replaces a prior Iago diagram posted as a standalone comment (one with no <!-- review-skill --> marker and no ## Review heading) in place, instead of posting a duplicate block. This restores the "one block per PR / replaced on the next run" guarantee when the diagram wasn't appended to a /review comment. Internally, the comment search was refactored into a tiered findTargetCommentId (marker → heading → standalone Iago block → new comment).

Maintenance

• Aligned version bump across cli/package.json, .claude-plugin/plugin.json, and .claude-plugin/marketplace.json.

No breaking changes. The CLI is published to npm as `@drakulavich/iago@0.3.1` (with provenance); the Claude plugin updates via the bumped marketplace manifests.

Full changelog: v0.3.0...v0.3.1

v0.3.0 — skill-first: dropped the Action, TypeScript runtime helper

Skill-first release. Iago is now driven by your own coding agent — no GitHub Action, no SaaS.

Removed / Breaking

• Dropped the GitHub Action and the curl | bash installer. Install via the Claude plugin or bunx @drakulavich/iago; your own agent draws the diagram. (#5, #9)

Changed

• Runtime helper rewritten in TypeScript (run by bun), replacing the bash + Python scripts. Requires bun + gh. (#6)

Fixed

• sequence.md example now renders (Mermaid loop reserved-keyword collision); ER entity-name fix; sequence-label ;→, sanitizing. (#6, #7)

Docs

• Lean, human-first README + docs/ split; new CLAUDE.md (canonical agent config) + AGENTS.md. (#8, #10, #11)

Internal

• Retired the bats suite (tests via bun test + claude plugin validate); gitignore local dev state. (#9)

---

Install: bunx @drakulavich/iago install --force · Claude plugin: /plugin marketplace update iago-marketplace then reinstall.

v0.2.0 — OpenCode support, npm CLI, Mermaid hardening

Highlights

• OpenCode is now a first-class install target. Both iago and squawk skills install into ~/.config/opencode/skills/ natively, with auto-detection in install.sh and the new TS CLI. The skills are also runtime-agnostic — no more hard-coded ${CLAUDE_SKILL_DIR} references.
• @drakulavich/iago CLI on npm. A Bun + TypeScript CLI ships alongside the bash installer for users who prefer npx / bunx. Exposes install, update, and uninstall with the same target/skill-only flags as the shell installer.
• Mermaid rendering hardened. Three layers of defense against the most common rendering failure (; inside sequenceDiagram message labels breaking GitHub's parser): updated authoring rules in SKILL.md + references/mermaid-templates.md, an explicit ban on bypassing the helper script, and a deterministic Python sanitizer that rewrites ; → , in sequence messages before posting.

What's new

Skills

• feat(skill): make SKILL.md runtime-agnostic — fallback chain ${CLAUDE_SKILL_DIR:-${OPENCODE_SKILL_DIR:-$(dirname "$0")}} (3ae2010)
• fix(skill): teach iago about Mermaid sequence pitfalls — ;-as-separator and bare-statements-in-alt rules added to references/mermaid-templates.md (0d593ee)
• fix(skill): auto-sanitize ';' in Mermaid sequence message labels — deterministic safety net runs before posting (1818b5c)
• fix(skill): require helper script + promote ';' rule to top-level — gh pr comment / gh api PATCH direct writes for the diagram are now forbidden by the skill contract (9238635)
• fix(skill): extract Mermaid sanitizer to standalone Python file — fixes a heredoc parse error on macOS bash 3.2 by moving the sanitizer to iago/scripts/sanitize_mermaid.py (c2c6ef5)

CLI (@drakulavich/iago)

• Add @drakulavich/iago CLI (TS + Bun) — Phase 2 — initial CLI with 41 unit/integration tests (88f05ff)
• feat: add opencode as a native install target — fifth target across install.sh, cli/src/{args,types,targets}.ts, plus tests (a14f69b)
• fix(cli): replace Bun-only APIs with node:* equivalents — Bun.file/write/spawn → node:fs + node:child_process, fixes ReferenceError: Bun is not defined under npx (fdd45c7)
• feat(cli): npm publish workflow + cli-local README/LICENSE — tag-triggered publish with provenance (fd8cf0d)

Install / update

Bash installer (existing users — recommended path)

curl -fsSL https://raw.githubusercontent.com/drakulavich/iago/main/install.sh | bash -s -- --force

npm / bunx (new in this release)

npx -y @drakulavich/iago install
# or
bunx @drakulavich/iago install

Both honor --target=claude|codex|agents|opencode|both, --skill-only=iago|squawk, --force, --dry-run, and --uninstall.

Compatibility

• macOS bash 3.2: tested via the bats CI matrix and explicitly fixed in c2c6ef5.
• Node ≥ 18: required by the npm CLI; Bun also supported.
• OpenCode: native install target. Existing ~/.claude/skills/ and ~/.agents/skills/ installs already light up under OpenCode per opencode docs.

Full changelog

v0.1.1...v0.2.0

v0.1.1 — clickable footer

Patch release.

What changed

Every auto-generated diagram block now footnotes:

Auto-generated by iago. Edit or remove this block; it will be replaced on the next run.

The repo name is a clickable link, so anyone viewing the PR can find their way back to the project in one click.

Updated across all generation paths — CLI skill template, Action runner, and bundled examples.

Upgrade

• Action users on @v0.1 — already on it (moving tag now points to v0.1.1).
• Action users pinned to @v0.1.0 — bump to @v0.1.1 (or @v0.1).
• Skill users — git pull in your skill folder.

Full diff: v0.1.0...v0.1.1

v0.1.0 — initial public release

First public release of Iago — Greptile-style Mermaid diagrams for AI code reviews.

What's in the box

• 🤖 GitHub Action (`drakulavich/iago@v0.1.0`) — comment `/iago` on any PR, no CLI needed.
• 💻 Claude Code skill — `/iago`, `/squawk`.
• 🦦 Codex CLI skill — same skill, same open standard.

Diagram types

`sequence`, `flow`, `class`, `er` — auto-detected from the diff, override anytime with `/iago `.

Generation modes

• LLM-quality (Anthropic or OpenAI key in secrets).
• Heuristic fallback (no key needed) — basic but always works.

Install (Action)

```yaml

• uses: drakulavich/iago@v0.1.0
  with:
  anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
  ```

See README for Claude Code, Codex CLI, Copilot, and Gemini install paths.