ironcode-ai 1.19.2 → 1.20.1

package/README.md

@@ -22,67 +22,6 @@
 
 ---
 
-## What's New
-
-### v1.18.0 — Chat Integrations Upgrade
-
-**New Discord Bot & Enhanced Telegram:**
-
-- **Discord Bot** — Full-featured Discord integration with slash commands, rich embeds, and file upload support (up to 25MB)
-  - `/start`, `/new`, `/info`, `/sessions`, `/diff`, `/init` commands
-  - 📸 Image & document upload
-  - 🎤 Voice message transcription
-  - ✨ Real-time response streaming
-  - 👍 Reactions on completion
-- **Telegram Enhancement** — Added comprehensive file upload support
-  - 📸 Image upload (screenshots, diagrams, mockups)
-  - 📄 Document upload (code files, PDFs, up to 20MB)
-  - 📦 Media groups (multiple files at once)
-  - 🎤 Voice transcription via Groq Whisper
-- **Packages Available**:
-  - `@ironcode-ai/telegram` — Telegram bot integration
-  - `@ironcode-ai/discord` — Discord bot integration (NEW)
-  - `@ironcode-ai/slack` — Slack bot integration
-
-### v1.17.6 — AI SDK v6 ModelRef Migration
-
-**Completed ModelRef migration as part of AI SDK v6 upgrade:**
-
-- **Schema migration** — Migrated model references from object format `{ providerID: string, modelID: string }` to string-based `ModelRef` format (`"provider:model"`) throughout the codebase
-- **Parser/formatter utilities** — All code now uses `ProviderRegistry.parse(modelRef)` to extract components and `ProviderRegistry.format(providerID, modelID)` to create ModelRef strings
-- **Runtime compatibility** — Added `ensureModelRef()` helper to handle legacy object formats gracefully during transition
-- **Bug fixes** — Fixed `ProviderModelNotFoundError` with undefined values caused by incomplete migration; fixed `Provider.defaultModel()` to return strings consistently
-
-**Technical details:**
-
-- Updated schemas in `message-v2.ts`: User, Assistant, and SubtaskPart now use `model: z.string()` instead of separate modelID/providerID fields
-- Migrated 24 files including session handling, compaction, summary, task/plan tools, telegram bot, and SDK types
-- Zero breaking changes for end users
-
-### v1.17.5 — Voice Message Support
-
-- **Voice messages** — Send voice messages to the Telegram bot; audio is automatically transcribed via Groq Whisper and forwarded to the agent
-- **BM25 improvements** — Updated `STOP_WORDS` to retain method-prefix tokens (`get`/`set`/`is`/`has`/`new`) for more accurate code search
-
-### v1.17.3 — Rust Rule Engine Migration
-
-- **Permission Rule Engine** — `PermissionNext.evaluate()` and `disabled()` migrated to Rust; entire ruleset batched into a single FFI call instead of N JS roundtrips
-- **File Ignore Matching** — `FileIgnore.match()` migrated to Rust using `globset` compiled regex, faster than per-call `Bun.Glob` allocation
-- **Dead code removed** — `permission/arity.ts` (BashArity) removed, replaced by `extractPrefixFFI` (Rust)
-
-### v1.17.2 — Telegram Enhancement
-
-- **`/init` command** — Analyze a project and generate `AGENTS.md` directly from the Telegram bot
-- **Code diff streaming** — `/diff` shows all changed files in the current session
-- **Session management UI** — `/sessions` with inline switch buttons
-
-### v1.17.0 — AI SDK v6
-
-- Upgraded to AI SDK v6 with full support for new providers
-- Improved terminal UX
-
----
-
 ## What is IronCode?
 
 IronCode is a **high-performance CLI AI coding agent** — a fork of [OpenCode](https://github.com/anomalyco/opencode) that runs entirely on your machine. It rewrites performance-critical components in Rust for dramatically improved speed and memory efficiency.
@@ -95,28 +34,12 @@ IronCode is a **high-performance CLI AI coding agent** — a fork of [OpenCode](
 - 🔍 **Code Changes Panel** — Diff viewer with inline comments and hunk revert
 - 🔎 **Local Code Search** — BM25 + tree-sitter semantic search, offline, zero latency
 - 💬 **Chat Integrations** — Control IronCode from Telegram, Discord, or Slack
-  - 📸 Image & file upload (screenshots, code files, PDFs)
-  - 🎤 Voice message transcription
-  - 📱 Code from anywhere, even mobile
 - 💻 **Built-in Terminal** — Fish-style autosuggest, tab completion, syntax highlighting
 - 📝 **External Editor** — Opens `$EDITOR`/nvim with auto-install if missing
+- 🧩 **Built-in Skills** — 9 opinionated slash commands: plan review, code review, QA, ship, retro, and more
 - 🏠 **100% Local** — No cloud services, works completely offline
 - ⚡ **Blazing Fast** — Native Rust for all performance-critical operations
 
-### Performance (Native Rust Components)
-
-| Operation             | Speedup                            | Notes                                                      |
-| --------------------- | ---------------------------------- | ---------------------------------------------------------- |
-| PTY/Terminal          | **15x faster**                     | Zero-copy ring buffer                                      |
-| Edit Tool             | **2–6x faster**                    | 9 smart replacement strategies                             |
-| Bash Parser           | **50–100x faster**                 | Native tree-sitter vs WASM                                 |
-| Archive extraction    | **3–5x faster**                    | s-zip streaming reader                                     |
-| Grep search           | **90–99% less memory**             | Streams GB-sized files                                     |
-| File read             | **1.5x faster, 99.7% less memory** | 64KB buffer + pre-allocation                               |
-| Git operations        | **1.8x faster**                    | libgit2, no process spawning                               |
-| Permission evaluation | **N× fewer FFI calls**             | Entire ruleset in 1 native call vs N roundtrips            |
-| File ignore matching  | **Faster glob matching**           | Compiled `globset` regex vs per-call `Bun.Glob` allocation |
-
 ---
 
 ## Installation
@@ -172,121 +95,207 @@ ironcode auth login
 | `/init`     | Create `AGENTS.md` for the project     |
 | `Tab`       | Switch between agents (build / plan)   |
 | `Ctrl+T`    | Cycle model variants (low/medium/high) |
-| `Ctrl+X I`  | Git panel shortcut                     |
-| `Ctrl+X R`  | Code changes panel shortcut            |
 
-### Model Variants & Thinking
+### Model Variants
+
+Press **`Ctrl+T`** to cycle between variants:
 
-IronCode supports **model variants** that control the quality/speed tradeoff:
+| Variant | Description |
+|---------|-------------|
+| `low` | Faster responses, lower cost |
+| `medium` | Balanced performance and quality |
+| `high 🧠` | Best quality with thinking enabled (default) |
+| `thinking 🧠` | Extended reasoning for complex problems |
 
-- **low** — Faster responses, lower cost, suitable for simple tasks
-- **medium** — Balanced performance and quality
-- **high** — Best quality, includes extended thinking/reasoning output (default)
-- **thinking** — Extended reasoning mode for complex problems
+---
 
-Press **`Ctrl+T`** to cycle between available variants. The status bar shows the current variant with indicators:
+## Skills
 
-- `high 🧠` — High quality with thinking enabled
-- `thinking 🧠` — Thinking variant with extended reasoning
-- `medium` — Medium quality
-- `low` — Low cost, faster responses
+IronCode ships with **9 built-in skill workflows** — opinionated slash commands that switch the agent into a specialist mode. Instead of one generic assistant, you get: founder, tech lead, paranoid reviewer, release engineer, QA tester, technical writer, and engineering manager.
 
-**Thinking mode** shows the model's internal reasoning process before generating the final response, helping with complex problem-solving and understanding the model's decision-making process.
+| Skill | Mode | What it does |
+|-------|------|-------------|
+| `/ceo-review` | Founder / CEO | Rethink the problem. Find the 10-star product hiding inside the request. Three modes: Scope Expansion, Hold Scope, Scope Reduction. |
+| `/eng-review` | Tech lead | Lock in architecture, data flow, failure modes, edge cases, and test matrix. |
+| `/code-review` | Staff engineer | Find bugs that pass CI but blow up in production. Two-pass: critical + informational. |
+| `/code-ship` | Release engineer | Merge, test, typecheck, review, changelog, bisectable commits, push, and PR — one command. |
+| `/browse` | QA engineer | Headless Chromium via Playwright. Navigate, click, fill forms, screenshot, assert states, test responsive layouts. |
+| `/qa` | QA + fix engineer | Test app, find bugs, fix them with atomic commits, re-verify. Four modes: diff-aware, full, quick, regression. |
+| `/qa-only` | QA reporter | Report-only QA. Same methodology as `/qa` but never fixes anything. Pure bug report with health score. |
+| `/document-release` | Technical writer | Post-ship doc update. Cross-references diff against README, ARCHITECTURE, CONTRIBUTING, CHANGELOG. |
+| `/retro` | Engineering manager | Team-aware weekly retro: commit analysis, session detection, per-person praise and growth areas. |
 
----
+### Workflow
 
-## Chat Integrations
+```
+/ceo-review  →  /eng-review  →  (code)  →  /code-review  →  /code-ship  →  /qa  →  /document-release  →  /retro
+  product        architecture     build      find bugs        land it       verify     update docs         reflect
+```
 
-Control IronCode from your favorite messaging app — send tasks from your phone, upload files, and get live streaming responses.
+### Example
 
-### Telegram Bot
+```
+You:      I want to add voice message transcription.
+          /ceo-review
 
-Full-featured Telegram integration with file upload and voice transcription.
+IronCode: "Voice transcription" is not the feature. The real job is
+          letting users code from anywhere — even when they can't type.
 
-```bash
-# Install
-bun install -g @ironcode-ai/telegram
+          A) SCOPE EXPANSION — voice commands, image upload, voice-to-diff
+          B) HOLD SCOPE — transcription only, production-ready
+          C) SCOPE REDUCTION — bare minimum Whisper API call
 
-# Configure
-ironcode-telegram setup
+You:      B
+
+You:      /eng-review
+IronCode: [Architecture diagram, data flow, failure modes, test matrix]
+
+You:      (implement the plan)
+You:      /code-review
+IronCode: Missing .catch() on Whisper API — unhandled rejection will crash the bot.
+
+You:      (fix it)
+You:      /code-ship
+IronCode: ✅ Format → typecheck → test → push → PR created
 
-# Run
-cd your-project
-ironcode-telegram
+You:      /qa http://localhost:3000
+IronCode: [Screenshots, console check, form test] All pages load. Voice flow works.
+          Health score: 92/100. 1 medium issue found and fixed.
+
+You:      /document-release
+IronCode: README.md: added voice transcription to features table.
+          CHANGELOG.md: polished voice. All docs up to date.
+
+You:      /retro
+IronCode: Week of Mar 10: 23 commits, 1.8k LOC, 42% tests, peak: 10pm
+          Your biggest ship: voice transcription pipeline.
+          Streak: 12 consecutive days.
 ```
 
-**Features:**
+### Custom Skills
 
-- 📸 Image upload (screenshots, diagrams, mockups)
-- 📄 Document upload (code files, PDFs, up to 20MB)
-- 📦 Media groups (multiple files at once)
-- 🎤 Voice transcription via Groq Whisper
-- ⚡ Real-time response streaming
-- 🔗 Session sharing with team
+Create `.ironcode/skill/<name>/SKILL.md` with YAML frontmatter:
 
-**Commands:** `/new`, `/sessions`, `/info`, `/init`, `/diff`
+```yaml
+---
+name: my-skill
+description: What this skill does and when to use it.
+---
 
-See [`packages/telegram/README.md`](./packages/telegram/README.md) for full documentation.
+# Instructions for the agent
 
-### Discord Bot
+Your prompt content here...
+```
 
-Modern Discord integration with slash commands and rich embeds.
+Skills are automatically discovered — no restart needed.
 
-```bash
-# Install
-bun install -g @ironcode-ai/discord
+### Built-in Skill Auto-Install
 
-# Configure
-ironcode-discord setup
+Built-in skills are embedded in the IronCode binary. On first run, they are extracted to `~/.ironcode/skill/`. If you customize a built-in skill (remove the `.builtin` marker), your version is preserved across upgrades.
+
+---
+
+## Agents
 
-# Run
-cd your-project
-ironcode-discord
+Switch between agents with `Tab`:
+
+| Agent | Access | Use for |
+|-------|--------|---------|
+| **build** | Full read/write | Development, implementation (default) |
+| **plan** | Read-only | Analysis, code exploration, planning |
+
+---
+
+## Chat Integrations
+
+Control IronCode from your favorite messaging app — send tasks from your phone, upload files, and get live streaming responses.
+
+### Telegram
+
+```bash
+bun install -g @ironcode-ai/telegram
+ironcode-telegram setup
+cd your-project && ironcode-telegram
 ```
 
-**Features:**
+📸 Image upload · 📄 Document upload (20MB) · 🎤 Voice transcription · ⚡ Streaming · `/new` `/sessions` `/info` `/init` `/diff`
 
-- ⚡ Slash commands (`/start`, `/new`, `/info`, `/diff`, `/init`)
-- 📸 Image & file upload (up to 25MB)
-- 🎤 Voice message transcription
-- ✨ Rich embeds for better UX
-- 👍 Reactions on completion
-- 🔗 Session per channel
+→ [`packages/telegram/README.md`](./packages/telegram/README.md)
 
-See [`packages/discord/README.md`](./packages/discord/README.md) for full documentation.
+### Discord
 
-### Slack Bot
+```bash
+bun install -g @ironcode-ai/discord
+ironcode-discord setup
+cd your-project && ironcode-discord
+```
 
-Slack integration with threaded conversations.
+⚡ Slash commands · 📸 File upload (25MB) · 🎤 Voice transcription · ✨ Rich embeds · 👍 Reactions
+
+→ [`packages/discord/README.md`](./packages/discord/README.md)
+
+### Slack
 
 ```bash
-cd packages/slack
-bun dev
+cd packages/slack && bun dev
 ```
 
-**Features:**
+💬 Threaded conversations · ⚡ Real-time tool notifications · 🤖 Socket mode
 
-- 💬 Threaded conversations
-- ⚡ Real-time tool notifications
-- 🔗 Session sharing
-- 🤖 Socket mode support
+→ [`packages/slack/README.md`](./packages/slack/README.md)
 
-See [`packages/slack/README.md`](./packages/slack/README.md) for setup instructions.
+---
+
+## Performance
+
+Native Rust components via FFI:
+
+| Operation             | Speedup                            | Notes                                          |
+| --------------------- | ---------------------------------- | ---------------------------------------------- |
+| PTY/Terminal          | **15x faster**                     | Zero-copy ring buffer                          |
+| Edit Tool             | **2–6x faster**                    | 9 smart replacement strategies                 |
+| Bash Parser           | **50–100x faster**                 | Native tree-sitter vs WASM                     |
+| Archive extraction    | **3–5x faster**                    | s-zip streaming reader                         |
+| Grep search           | **90–99% less memory**             | Streams GB-sized files                         |
+| File read             | **1.5x faster, 99.7% less memory** | 64KB buffer + pre-allocation                  |
+| Git operations        | **1.8x faster**                    | libgit2, no process spawning                   |
+| Permission evaluation | **N× fewer FFI calls**             | Entire ruleset in 1 native call                |
+| File ignore matching  | **Faster glob matching**           | Compiled `globset` regex                       |
 
 ---
 
-## Agents
+## Architecture
 
-Switch between agents with the `Tab` key:
+```
+┌──────────────────────────────────────────────┐
+│                 IronCode CLI                  │
+│              TypeScript + Bun                 │
+├──────────────────────────────────────────────┤
+│  TUI  │  Agents  │  Skills  │  Integrations  │
+│       │ build/   │ ceo/eng/ │  Telegram/     │
+│       │ plan     │ review/  │  Discord/Slack │
+│       │          │ ship/qa  │                │
+├──────────────────────────────────────────────┤
+│           Native Performance Layer            │
+│                Rust via FFI                    │
+│  PTY · Edit · Grep · Git · Bash · BM25 ·     │
+│  Archive · Permission · Glob · Stats          │
+└──────────────────────────────────────────────┘
+```
 
-- **build** — Full-access agent for development (default)
-- **plan** — Read-only agent for analysis and code exploration
+| Layer | Tech | Packages |
+|-------|------|----------|
+| CLI/TUI | TypeScript + Bun | `packages/ironcode` |
+| Native | Rust FFI | `packages/ironcode/native/tool` |
+| Telegram | grammy + SDK + Groq Whisper | `@ironcode-ai/telegram` |
+| Discord | discord.js + SDK | `@ironcode-ai/discord` |
+| Slack | Bolt + SDK | `@ironcode-ai/slack` |
 
 ---
 
 ## Development
 
-**Requirements:** Bun 1.3.8, Rust (stable), Git
+**Requirements:** Bun 1.3.8+, Rust (stable), Git
 
 ```bash
 git clone https://github.com/KSD-CO/IronCode.git
@@ -302,23 +311,64 @@ bun dev
 
 ---
 
-## Architecture
+## Contributing
 
-- **CLI/TUI**: TypeScript + Bun
-- **Native Performance Layer**: Rust via FFI — PTY, edit, grep, glob, git, archive, bash parser, BM25 search, wildcard matching, RETE command prefix, permission rule engine, file ignore matching, system stats
-- **Telegram Bot**: `@ironcode-ai/telegram` — grammy + `@ironcode-ai/sdk` + Groq Whisper for voice transcription
+Contributions welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+Areas to help with: performance optimizations, bug fixes, documentation, new plugins, additional Rust components, new skills.
 
 ---
 
-## Contributing
+## Changelog
 
-Contributions welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md).
+<details>
+<summary><strong>v1.18.0</strong> — Chat Integrations Upgrade</summary>
 
-Areas to help with: performance optimizations, bug fixes, documentation, new plugins, additional Rust components.
+- **Discord Bot** — Full-featured Discord integration with slash commands, rich embeds, file upload (25MB)
+- **Telegram Enhancement** — Image upload, document upload, media groups, voice transcription via Groq Whisper
+- **Packages:** `@ironcode-ai/telegram`, `@ironcode-ai/discord`, `@ironcode-ai/slack`
 
----
+</details>
+
+<details>
+<summary><strong>v1.17.6</strong> — AI SDK v6 ModelRef Migration</summary>
+
+- Migrated model references from object format to string-based `ModelRef` format (`"provider:model"`)
+- Updated 24 files including session handling, compaction, summary, task/plan tools
+- Zero breaking changes for end users
+
+</details>
 
-## Acknowledgments
+<details>
+<summary><strong>v1.17.5</strong> — Voice Message Support</summary>
+
+- Voice messages in Telegram bot — auto-transcribed via Groq Whisper
+- BM25 improvements — retain method-prefix tokens for more accurate code search
+
+</details>
+
+<details>
+<summary><strong>v1.17.3</strong> — Rust Rule Engine Migration</summary>
+
+- Permission rule engine migrated to Rust — entire ruleset in 1 FFI call
+- File ignore matching migrated to Rust using `globset` compiled regex
+- Removed dead code (`permission/arity.ts`)
+
+</details>
+
+<details>
+<summary><strong>v1.17.2</strong> — Telegram Enhancement</summary>
+
+- `/init` command — generate `AGENTS.md` from Telegram
+- `/diff` — stream changed files
+- `/sessions` — inline switch buttons
+
+</details>
+
+<details>
+<summary><strong>v1.17.0</strong> — AI SDK v6</summary>
+
+- Upgraded to AI SDK v6 with full support for new providers
+- Improved terminal UX
 
-- **IronCode Team** — original open-source AI coding agent
-- All contributors to this fork
+</details>

package/package.json

@@ -6,13 +6,13 @@
   "scripts": {
     "postinstall": "bun ./postinstall.mjs || node ./postinstall.mjs"
   },
-  "version": "1.19.2",
+  "version": "1.20.1",
   "license": "MIT",
   "optionalDependencies": {
-    "ironcode-linux-x64-baseline": "1.19.2",
-    "ironcode-linux-x64-modern": "1.19.2",
-    "ironcode-linux-x64-baseline-musl": "1.19.2",
-    "ironcode-windows-x64-modern": "1.19.2",
-    "ironcode-darwin-arm64": "1.19.2"
+    "ironcode-linux-x64-baseline": "1.20.1",
+    "ironcode-linux-x64-modern": "1.20.1",
+    "ironcode-linux-x64-baseline-musl": "1.20.1",
+    "ironcode-windows-x64-modern": "1.20.1",
+    "ironcode-darwin-arm64": "1.20.1"
   }
 }