oh-my-magento 0.3.3 → 0.3.4

package/README.ja.md

@@ -165,7 +165,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
 
 **Sisyphus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) はあなたのメインのオーケストレーターです。計画を立て、専門家に委任し、攻撃的な並列実行でタスクを完了まで推進します。途中で投げ出すことはありません。
 
-**Hephaestus** (`gpt-5.3-codex`) はあなたの自律的なディープワーカーです。レシピではなく、目標を与えてください。手取り足取り教えなくても、コードベースを探索し、パターンを研究し、端から端まで実行します。*正当なる職人 (The Legitimate Craftsman).*
+**Hephaestus** (`gpt-5.4`) はあなたの自律的なディープワーカーです。レシピではなく、目標を与えてください。手取り足取り教えなくても、コードベースを探索し、パターンを研究し、端から端まで実行します。*正当なる職人 (The Legitimate Craftsman).*
 
 **Prometheus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) はあなたの戦略プランナーです。インタビューモードで動作し、コードに触れる前に質問をしてスコープを特定し、詳細な計画を構築します。
 
@@ -173,7 +173,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
 
 > Anthropicが[私たちのせいでOpenCodeをブロックしました。](https://x.com/thdxr/status/2010149530486911014) だからこそHephaestusは「正当なる職人 (The Legitimate Craftsman)」と呼ばれているのです。皮肉を込めています。
 >
-> Opusで最もよく動きますが、Kimi K2.5 + GPT-5.3 Codexの組み合わせだけでも、バニラのClaude Codeを軽く凌駕します。設定は一切不要です。
+> Opusで最もよく動きますが、Kimi K2.5 + GPT-5.4の組み合わせだけでも、バニラのClaude Codeを軽く凌駕します。設定は一切不要です。
 
 ### エージェントの��ーケストレーション
 

package/README.ko.md

@@ -153,7 +153,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
 
 **Sisyphus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**)는 당신의 메인 오케스트레이터입니다. 공격적인 병렬 실행으로 계획을 세우고, 전문가들에게 위임하며, 완료될 때까지 밀어붙입니다. 중간에 포기하는 법이 없습니다.
 
-**Hephaestus** (`gpt-5.3-codex`)는 당신의 자율 딥 워커입니다. 레시피가 아니라 목표를 주세요. 베이비시터 없이 알아서 코드베이스를 탐색하고, 패턴을 연구하며, 끝에서 끝까지 전부 해냅니다. *진정한 장인(The Legitimate Craftsman).*
+**Hephaestus** (`gpt-5.4`)는 당신의 자율 딥 워커입니다. 레시피가 아니라 목표를 주세요. 베이비시터 없이 알아서 코드베이스를 탐색하고, 패턴을 연구하며, 끝에서 끝까지 전부 해냅니다. *진정한 장인(The Legitimate Craftsman).*
 
 **Prometheus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**)는 당신의 전략 플래너입니다. 인터뷰 모드로 작동합니다. 코드 한 줄 만지기 전에 질문을 던져 스코프를 파악하고 상세한 계획부터 세웁니다.
 
@@ -161,7 +161,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
 
 > Anthropic이 [우리 때문에 OpenCode를 막아버렸습니다.](https://x.com/thdxr/status/2010149530486911014) 그래서 Hephaestus의 별명이 "진정한 장인(The Legitimate Craftsman)"인 겁니다. (어디서 많이 들어본 이름이죠?) 아이러니를 노렸습니다.
 >
-> Opus에서 제일 잘 돌아가긴 하지만, Kimi K2.5 + GPT-5.3 Codex 조합만으로도 바닐라 Claude Code는 가볍게 바릅니다. 설정도 필요 없습니다.
+> Opus에서 제일 잘 돌아가긴 하지만, Kimi K2.5 + GPT-5.4 조합만으로도 바닐라 Claude Code는 가볍게 바릅니다. 설정도 필요 없습니다.
 
 ### 에이전트 오케스트레이션
 

package/README.md

@@ -18,33 +18,38 @@
 >
 > | [<img alt="Discord link" src="https://img.shields.io/discord/1452487457085063218?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" />](https://discord.gg/PUwSMR9XNk) | Join our [Discord community](https://discord.gg/PUwSMR9XNk) to connect with contributors and fellow `oh-my-magento` users. |
 > | :-----| :----- |
-> | [<img alt="GitHub Follow" src="https://img.shields.io/github/followers/caravanglory?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" />](https://github.com/caravanglory) | Follow [@caravanglory](https://github.com/caravanglory) on GitHub for this fork and other projects. |
+> | [<img alt="X link" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />](https://x.com/justsisyphus) | News and updates for `oh-my-magento` used to be posted on my X account. <br /> Since it was suspended mistakenly, [@justsisyphus](https://x.com/justsisyphus) now posts updates on my behalf. |
+> | [<img alt="GitHub Follow" src="https://img.shields.io/github/followers/caravanglory?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" />](https://github.com/caravanglory) | Follow [@caravanglory](https://github.com/caravanglory) on GitHub for more projects. |
 
 <!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
 
 <div align="center">
 
-[![Oh My Magento](./.github/assets/hero.jpg)](https://github.com/caravanglory/oh-my-magento#oh-my-magento)
+[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/caravanglory/oh-my-magento#oh-my-magento)
 
 [![Preview](./.github/assets/omo.png)](https://github.com/caravanglory/oh-my-magento#oh-my-magento)
 
+
 </div>
 
-> This is **oh-my-magento** — a fork of [oh-my-magento](https://github.com/caravanglory/oh-my-openagent) specialized for Magento 2 + Hyvä development. It maintains full compatibility with oh-my-magento while adding Magento-specific agents, skills, and workflows.
+> Anthropic [**blocked OpenCode because of us.**](https://x.com/thdxr/status/2010149530486911014) **Yes this is true.**
+> They want you locked in. Claude Code's a nice prison, but it's still a prison.
 >
-> All upstream features are preserved. The difference: this fork ships with Magento development tools built in.
+> We don't do lock-in here. We ride every model. Claude / Kimi / GLM for orchestration. GPT for reasoning. Minimax for speed. Gemini for creativity.
+> The future isn't picking one winner—it's orchestrating them all. Models get cheaper every month. Smarter every month. No single provider will dominate. We're building for that open market, not their walled gardens.
 
 <div align="center">
 
 [![GitHub Release](https://img.shields.io/github/v/release/caravanglory/oh-my-magento?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/caravanglory/oh-my-magento/releases)
-[![npm downloads](https://img.shields.io/npm/dt/oh-my-magento?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/oh-my-magento)
+[![npm downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fohmyopenagent.com%2Fapi%2Fnpm-downloads&style=flat-square)](https://www.npmjs.com/package/oh-my-magento)
 [![GitHub Contributors](https://img.shields.io/github/contributors/caravanglory/oh-my-magento?color=c4f042&labelColor=black&style=flat-square)](https://github.com/caravanglory/oh-my-magento/graphs/contributors)
 [![GitHub Forks](https://img.shields.io/github/forks/caravanglory/oh-my-magento?color=8ae8ff&labelColor=black&style=flat-square)](https://github.com/caravanglory/oh-my-magento/network/members)
 [![GitHub Stars](https://img.shields.io/github/stars/caravanglory/oh-my-magento?color=ffcb47&labelColor=black&style=flat-square)](https://github.com/caravanglory/oh-my-magento/stargazers)
 [![GitHub Issues](https://img.shields.io/github/issues/caravanglory/oh-my-magento?color=ff80eb&labelColor=black&style=flat-square)](https://github.com/caravanglory/oh-my-magento/issues)
 [![License](https://img.shields.io/badge/license-SUL--1.0-white?labelColor=black&style=flat-square)](https://github.com/caravanglory/oh-my-magento/blob/dev/LICENSE.md)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/caravanglory/oh-my-magento)
 
-[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md) | [Русский](README.ru.md)
+[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
 
 </div>
 
@@ -60,11 +65,12 @@
 
 > "I converted a 45k line tauri app into a SaaS web app overnight using Ohmyopencode and ralph loop. Started with interview me prompt, asked it for ratings and recommendations on the questions. It was amazing to watch it work and to wake up this morning to a mostly working website!" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
 
-> "use oh-my-magento, you will never go back" <br/>- d0t3ch
+> "use oh-my-magento, you will never go back" <br/>- [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
 
-> "I haven't really been able to articulate exactly what makes it so great yet, but the development experience has reached a completely different dimension." - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
+> "I haven't really been able to articulate exactly what makes it so great yet, but the development experience has reached a completely different dimension." - [
+苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
 
-> "Experimenting with open code, oh-my-magento and supermemory this weekend to build some minecraft/souls-like abomination."
+> "Experimenting with open code, oh my opencode and supermemory this weekend to build some minecraft/souls-like abomination."
 > "Asking it to add crouch animations while I go take my post-lunch walk. [Video]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
 
 > "You guys should pull this into core and recruit him. Seriously. It's really, really, really good." <br/>- Henning Kilset
@@ -75,15 +81,13 @@
 
 ---
 
-# Oh My Magento
-
-A fork of [oh-my-magento](https://github.com/caravanglory/oh-my-openagent) — specialized for Magento 2 + Hyvä development. Ships with the same multi-model orchestration engine, plus Magento-specific agents and skills.
+# Oh My OpenCode
 
 You're juggling Claude Code, Codex, random OSS models. Configuring workflows. Debugging agents.
 
 We did the work. Tested everything. Kept what actually shipped.
 
-Install the fork. Type `ultrawork`. Done.
+Install OmO. Type `ultrawork`. Done.
 
 
 ## Installation
@@ -107,6 +111,8 @@ Fetch the installation guide and follow it:
 curl -s https://raw.githubusercontent.com/caravanglory/oh-my-magento/refs/heads/dev/docs/guide/installation.md
 ```
 
+**Note**: Use the published package and binary name `oh-my-magento`. Inside `opencode.json`, the compatibility layer now prefers the plugin entry `oh-my-openagent`, while legacy `oh-my-magento` entries still load with a warning. Plugin config files still commonly use `oh-my-magento.json` or `oh-my-magento.jsonc`, and both legacy and renamed basenames are recognized during the transition.
+
 ---
 
 ## Skip This README
@@ -160,12 +166,16 @@ Even only with following subscriptions, ultrawork will work well (this project i
 
 **Sisyphus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`** ) is your main orchestrator. He plans, delegates to specialists, and drives tasks to completion with aggressive parallel execution. He does not stop halfway.
 
-**Hephaestus** (`gpt-5.3-codex`) is your autonomous deep worker. Give him a goal, not a recipe. He explores the codebase, researches patterns, and executes end-to-end without hand-holding. *The Legitimate Craftsman.*
+**Hephaestus** (`gpt-5.4`) is your autonomous deep worker. Give him a goal, not a recipe. He explores the codebase, researches patterns, and executes end-to-end without hand-holding. *The Legitimate Craftsman.*
 
 **Prometheus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`** ) is your strategic planner. Interview mode: it questions, identifies scope, and builds a detailed plan before a single line of code is touched.
 
 Every agent is tuned to its model's specific strengths. No manual model-juggling. [Learn more →](docs/guide/overview.md)
 
+> Anthropic [blocked OpenCode because of us.](https://x.com/thdxr/status/2010149530486911014) That's why Hephaestus is called "The Legitimate Craftsman." The irony is intentional.
+>
+> We run best on Opus, but Kimi K2.5 + GPT-5.4 already beats vanilla Claude Code. Zero config needed.
+
 ### Agent Orchestration
 
 When Sisyphus delegates to a subagent, it doesn't pick a model. It picks a **category**. The category maps automatically to the right model:
@@ -249,7 +259,7 @@ Skills aren't just prompts. Each brings:
 - Embedded MCP servers, on-demand
 - Scoped permissions. Agents stay in bounds
 
-Built-ins: `playwright` (browser automation), `git-master` (atomic commits, rebase surgery), `frontend-ui-ux` (design-first UI), plus Magento-specific skills (`magento-architect`, `magento-upgrader`, `magento-payment`).
+Built-ins: `playwright` (browser automation), `git-master` (atomic commits, rebase surgery), `frontend-ui-ux` (design-first UI).
 
 Add your own: `.opencode/skills/*/SKILL.md` or `~/.config/opencode/skills/*/SKILL.md`.
 
@@ -265,11 +275,11 @@ To remove oh-my-magento:
 
 1. **Remove the plugin from your OpenCode config**
 
-   Edit `~/.config/opencode/opencode.json` (or `opencode.jsonc`) and remove `"oh-my-magento"` from the `plugin` array:
+   Edit `~/.config/opencode/opencode.json` (or `opencode.jsonc`) and remove either `"oh-my-openagent"` or the legacy `"oh-my-magento"` entry from the `plugin` array:
 
    ```bash
    # Using jq
-   jq '.plugin = [.plugin[] | select(. != "oh-my-magento")]' \
+   jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-magento")]' \
        ~/.config/opencode/opencode.json > /tmp/oc.json && \
        mv /tmp/oc.json ~/.config/opencode/opencode.json
    ```
@@ -277,11 +287,13 @@ To remove oh-my-magento:
 2. **Remove configuration files (optional)**
 
    ```bash
-   # Remove user config
-   rm -f ~/.config/opencode/oh-my-magento.json ~/.config/opencode/oh-my-magento.jsonc
+   # Remove plugin config files recognized during the compatibility window
+   rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
+         ~/.config/opencode/oh-my-magento.jsonc ~/.config/opencode/oh-my-magento.json
 
    # Remove project config (if exists)
-   rm -f .opencode/oh-my-magento.json .opencode/oh-my-magento.jsonc
+   rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
+         .opencode/oh-my-magento.jsonc .opencode/oh-my-magento.json
    ```
 
 3. **Verify removal**
@@ -299,7 +311,6 @@ See full [Features Documentation](docs/reference/features.md).
 
 **Quick Overview:**
 - **Agents**: Sisyphus (the main agent), Prometheus (planner), Oracle (architecture/debugging), Librarian (docs/code search), Explore (fast codebase grep), Multimodal Looker
-- **Magento Skills**: `magento-architect`, `magento-upgrader`, `magento-payment` — Magento-specific agents via SKILL.md
 - **Background Agents**: Run multiple agents in parallel like a real dev team
 - **LSP & AST Tools**: Refactoring, rename, diagnostics, AST-aware code search
 - **Hash-anchored Edit Tool**: `LINE#ID` references validate content before applying every change. Surgical edits, zero stale-line errors
@@ -308,6 +319,10 @@ See full [Features Documentation](docs/reference/features.md).
 - **Built-in MCPs**: websearch (Exa), context7 (docs), grep_app (GitHub search)
 - **Session Tools**: List, read, search, and analyze session history
 - **Productivity Features**: Ralph Loop, Todo Enforcer, Comment Checker, Think Mode, and more
+- **Doctor Command**: Built-in diagnostics (`bunx oh-my-magento doctor`) verify plugin registration, config, models, and environment
+- **Model Fallbacks**: `fallback_models` can mix plain model strings with per-fallback object settings in the same array
+- **File Prompts**: Load prompts from files with `file://` support in agent configurations
+- **Session Recovery**: Automatic recovery from session errors, context window limits, and API failures
 - **Model Setup**: Agent-model matching is built into the [Installation Guide](docs/guide/installation.md#step-5-understand-your-model-setup)
 
 ## Configuration
@@ -317,7 +332,7 @@ Opinionated defaults, adjustable if you insist.
 See [Configuration Documentation](docs/reference/configuration.md).
 
 **Quick Overview:**
-- **Config Locations**: `.opencode/oh-my-magento.jsonc` or `.opencode/oh-my-magento.json` (project), `~/.config/opencode/oh-my-magento.jsonc` or `~/.config/opencode/oh-my-magento.json` (user)
+- **Config Locations**: The compatibility layer recognizes both `oh-my-openagent.json[c]` and legacy `oh-my-magento.json[c]` plugin config files. Existing installs still commonly use the legacy basename.
 - **JSONC Support**: Comments and trailing commas supported
 - **Agents**: Override models, temperatures, prompts, and permissions for any agent
 - **Built-in Skills**: `playwright` (browser automation), `git-master` (atomic commits)
@@ -336,14 +351,36 @@ See [Configuration Documentation](docs/reference/configuration.md).
 
 ---
 
-This is the Magento fork of [oh-my-magento](https://github.com/caravanglory/oh-my-openagent). It ships with the same multi-model orchestration engine, with added Magento 2 + Hyvä development agents and skills.
+I burned through $24K in LLM tokens on personal projects. Tried every tool. Configured everything to death. OpenCode won.
+
+Every problem I hit, the fix is baked into this plugin. Install and go.
 
-If OpenCode is Debian/Arch, oh-my-magento is Ubuntu/OmArchitecture for the Magento ecosystem.
+If OpenCode is Debian/Arch, OmO is Ubuntu/[Omarchy](https://omarchy.org/).
 
 Heavy influence from [AmpCode](https://ampcode.com) and [Claude Code](https://code.claude.com/docs/overview). Features ported, often improved. Still building. It's **Open**Code.
 
+Other harnesses promise multi-model orchestration. We ship it. Stability too. And features that actually work.
+
+I'm this project's most obsessive user:
+- Which model has the sharpest logic?
+- Who's the debugging god?
+- Who writes the best prose?
+- Who dominates frontend?
+- Who owns backend?
+- What's fastest for daily driving?
+- What are competitors shipping?
+
+This plugin is the distillation. Take the best. Got improvements? PRs welcome.
+
+**Stop agonizing over harness choices.**
+**I'll research, steal the best, and ship it here.**
+
+Sounds arrogant? Have a better way? Contribute. You're welcome.
+
 No affiliation with any project/model mentioned. Just personal experimentation.
 
+99% of this project was built with OpenCode. I don't really know TypeScript. **But I personally reviewed and largely rewrote this doc.**
+
 ## Loved by professionals at
 
 - [Indent](https://indentcorp.com)
@@ -352,3 +389,5 @@ No affiliation with any project/model mentioned. Just personal experimentation.
 - [Microsoft](https://microsoft.com)
 - [ELESTYLE](https://elestyle.jp)
   - Making elepay - multi-mobile payment gateway, OneQR - mobile application SaaS for cashless solutions
+
+*Special thanks to [@junhoyeo](https://github.com/junhoyeo) for this amazing hero image.*

package/README.ru.md

@@ -149,7 +149,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
 
 **Sisyphus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) — главный оркестратор. Он планирует, делегирует задачи специалистам и доводит их до завершения с агрессивным параллельным выполнением. Он не останавливается на полпути.
 
-**Hephaestus** (`gpt-5.3-codex`) — автономный глубокий исполнитель. Дайте ему цель, а не рецепт. Он исследует кодовую базу, изучает паттерны и выполняет задачи сквозным образом без лишних подсказок. *Законный Мастер.*
+**Hephaestus** (`gpt-5.4`) — автономный глубокий исполнитель. Дайте ему цель, а не рецепт. Он исследует кодовую базу, изучает паттерны и выполняет задачи сквозным образом без лишних подсказок. *Законный Мастер.*
 
 **Prometheus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) — стратегический планировщик. Режим интервью: задаёт вопросы, определяет объём работ и формирует детальный план до того, как написана хотя бы одна строка кода.
 
@@ -157,7 +157,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
 
 > Anthropic [заблокировал OpenCode из-за нас.](https://x.com/thdxr/status/2010149530486911014) Именно поэтому Hephaestus зовётся «Законным Мастером». Ирония намеренная.
 >
-> Мы работаем лучше всего на Opus, но Kimi K2.5 + GPT-5.3 Codex уже превосходят ванильный Claude Code. Никакой настройки не требуется.
+> Мы работаем лучше всего на Opus, но Kimi K2.5 + GPT-5.4 уже превосходят ванильный Claude Code. Никакой настройки не требуется.
 
 ### Оркестрация агентов
 

package/README.zh-cn.md

@@ -166,7 +166,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
 
 **Sisyphus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) 是你的主指挥官。他负责制定计划、分配任务给专家团队，并以极其激进的并行策略推动任务直至完成。他从不半途而废。
 
-**Hephaestus** (`gpt-5.3-codex`) 是你的自主深度工作者。你只需要给他目标，不要给他具体做法。他会自动探索代码库模式，从头到尾独立执行任务，绝不会中途要你当保姆。*名副其实的正牌工匠。*
+**Hephaestus** (`gpt-5.4`) 是你的自主深度工作者。你只需要给他目标，不要给他具体做法。他会自动探索代码库模式，从头到尾独立执行任务，绝不会中途要你当保姆。*名副其实的正牌工匠。*
 
 **Prometheus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) 是你的战略规划师。他通过访谈模式，在动一行代码之前，先通过提问确定范围并构建详尽的执行计划。
 
@@ -174,7 +174,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
 
 > Anthropic [因为我们屏蔽了 OpenCode](https://x.com/thdxr/status/2010149530486911014)。这就是为什么我们将 Hephaestus 命名为“正牌工匠 (The Legitimate Craftsman)”。这是一个故意的讽刺。
 >
-> 我们在 Opus 上运行得最好，但仅仅使用 Kimi K2.5 + GPT-5.3 Codex 就足以碾压原版的 Claude Code。完全不需要配置。
+> 我们在 Opus 上运行得最好，但仅仅使用 Kimi K2.5 + GPT-5.4 就足以碾压原版的 Claude Code。完全不需要配置。
 
 ### 智能体调度机制
 

package/bin/oh-my-opencode.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+// bin/oh-my-magento.js
+// Wrapper script that detects platform and spawns the correct binary
+
+import { spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { getPlatformPackageCandidates, getBinaryPath } from "./platform.js";
+
+const require = createRequire(import.meta.url);
+
+/**
+ * Detect libc family on Linux
+ * @returns {string | null} 'glibc', 'musl', or null if detection fails
+ */
+function getLibcFamily() {
+  if (process.platform !== "linux") {
+    return undefined; // Not needed on non-Linux
+  }
+  
+  try {
+    const detectLibc = require("detect-libc");
+    return detectLibc.familySync();
+  } catch {
+    // detect-libc not available
+    return null;
+  }
+}
+
+function supportsAvx2() {
+  if (process.arch !== "x64") {
+    return null;
+  }
+
+  if (process.env.OH_MY_OPENCODE_FORCE_BASELINE === "1") {
+    return false;
+  }
+
+  if (process.platform === "linux") {
+    try {
+      const cpuInfo = readFileSync("/proc/cpuinfo", "utf8").toLowerCase();
+      return cpuInfo.includes("avx2");
+    } catch {
+      return null;
+    }
+  }
+
+  if (process.platform === "darwin") {
+    const probe = spawnSync("sysctl", ["-n", "machdep.cpu.leaf7_features"], {
+      encoding: "utf8",
+    });
+
+    if (probe.error || probe.status !== 0) {
+      return null;
+    }
+
+    return probe.stdout.toUpperCase().includes("AVX2");
+  }
+
+  return null;
+}
+
+function getSignalExitCode(signal) {
+  const signalCodeByName = {
+    SIGINT: 2,
+    SIGILL: 4,
+    SIGKILL: 9,
+    SIGTERM: 15,
+  };
+
+  return 128 + (signalCodeByName[signal] ?? 1);
+}
+
+function getPackageBaseName() {
+  try {
+    const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+    return packageJson.name || "oh-my-magento";
+  } catch {
+    return "oh-my-magento";
+  }
+}
+
+function main() {
+  const { platform, arch } = process;
+  const libcFamily = getLibcFamily();
+  const packageBaseName = getPackageBaseName();
+  const avx2Supported = supportsAvx2();
+  
+  let packageCandidates;
+  try {
+    packageCandidates = getPlatformPackageCandidates({
+      platform,
+      arch,
+      libcFamily,
+      preferBaseline: avx2Supported === false,
+      packageBaseName,
+    });
+  } catch (error) {
+    console.error(`\noh-my-magento: ${error.message}\n`);
+    process.exit(1);
+  }
+
+  const resolvedBinaries = packageCandidates
+    .map((pkg) => {
+      try {
+        return { pkg, binPath: require.resolve(getBinaryPath(pkg, platform)) };
+      } catch {
+        return null;
+      }
+    })
+    .filter((entry) => entry !== null);
+
+  if (resolvedBinaries.length === 0) {
+    console.error(`\noh-my-magento: Platform binary not installed.`);
+    console.error(`\nYour platform: ${platform}-${arch}${libcFamily === "musl" ? "-musl" : ""}`);
+    console.error(`Expected packages (in order): ${packageCandidates.join(", ")}`);
+    console.error(`\nTo fix, run:`);
+    console.error(`  npm install ${packageCandidates[0]}\n`);
+    process.exit(1);
+  }
+
+  for (let index = 0; index < resolvedBinaries.length; index += 1) {
+    const currentBinary = resolvedBinaries[index];
+    const hasFallback = index < resolvedBinaries.length - 1;
+    const result = spawnSync(currentBinary.binPath, process.argv.slice(2), {
+      stdio: "inherit",
+    });
+
+    if (result.error) {
+      if (hasFallback) {
+        continue;
+      }
+
+      console.error(`\noh-my-magento: Failed to execute binary.`);
+      console.error(`Error: ${result.error.message}\n`);
+      process.exit(2);
+    }
+
+    if (result.signal === "SIGILL" && hasFallback) {
+      continue;
+    }
+
+    if (result.signal) {
+      process.exit(getSignalExitCode(result.signal));
+    }
+
+    process.exit(result.status ?? 1);
+  }
+
+  process.exit(1);
+}
+
+main();

package/bin/platform.js

@@ -3,11 +3,11 @@
 
 /**
  * Get the platform-specific package name
- * @param {{ platform: string, arch: string, libcFamily?: string | null }} options
+ * @param {{ platform: string, arch: string, libcFamily?: string | null, packageBaseName?: string }} options
  * @returns {string} Package name like "oh-my-magento-darwin-arm64"
  * @throws {Error} If libc cannot be detected on Linux
  */
-export function getPlatformPackage({ platform, arch, libcFamily }) {
+export function getPlatformPackage({ platform, arch, libcFamily, packageBaseName = "oh-my-magento" }) {
   let suffix = "";
   if (platform === "linux") {
     if (libcFamily === null || libcFamily === undefined) {
@@ -23,13 +23,13 @@ export function getPlatformPackage({ platform, arch, libcFamily }) {
   
   // Map platform names: win32 -> windows (for package name)
   const os = platform === "win32" ? "windows" : platform;
-  return `oh-my-magento-${os}-${arch}${suffix}`;
+  return `${packageBaseName}-${os}-${arch}${suffix}`;
 }
 
-/** @param {{ platform: string, arch: string, libcFamily?: string | null, preferBaseline?: boolean }} options */
-export function getPlatformPackageCandidates({ platform, arch, libcFamily, preferBaseline = false }) {
-  const primaryPackage = getPlatformPackage({ platform, arch, libcFamily });
-  const baselinePackage = getBaselinePlatformPackage({ platform, arch, libcFamily });
+/** @param {{ platform: string, arch: string, libcFamily?: string | null, preferBaseline?: boolean, packageBaseName?: string }} options */
+export function getPlatformPackageCandidates({ platform, arch, libcFamily, preferBaseline = false, packageBaseName = "oh-my-magento" }) {
+  const primaryPackage = getPlatformPackage({ platform, arch, libcFamily, packageBaseName });
+  const baselinePackage = getBaselinePlatformPackage({ platform, arch, libcFamily, packageBaseName });
 
   if (!baselinePackage) {
     return [primaryPackage];
@@ -38,18 +38,18 @@ export function getPlatformPackageCandidates({ platform, arch, libcFamily, prefe
   return preferBaseline ? [baselinePackage, primaryPackage] : [primaryPackage, baselinePackage];
 }
 
-/** @param {{ platform: string, arch: string, libcFamily?: string | null }} options */
-function getBaselinePlatformPackage({ platform, arch, libcFamily }) {
+/** @param {{ platform: string, arch: string, libcFamily?: string | null, packageBaseName?: string }} options */
+function getBaselinePlatformPackage({ platform, arch, libcFamily, packageBaseName = "oh-my-magento" }) {
   if (arch !== "x64") {
     return null;
   }
 
   if (platform === "darwin") {
-    return "oh-my-magento-darwin-x64-baseline";
+    return `${packageBaseName}-darwin-x64-baseline`;
   }
 
   if (platform === "win32") {
-    return "oh-my-magento-windows-x64-baseline";
+    return `${packageBaseName}-windows-x64-baseline`;
   }
 
   if (platform === "linux") {
@@ -61,10 +61,10 @@ function getBaselinePlatformPackage({ platform, arch, libcFamily }) {
     }
 
     if (libcFamily === "musl") {
-      return "oh-my-magento-linux-x64-musl-baseline";
+      return `${packageBaseName}-linux-x64-musl-baseline`;
     }
 
-    return "oh-my-magento-linux-x64-baseline";
+    return `${packageBaseName}-linux-x64-baseline`;
   }
 
   return null;

package/bin/platform.test.ts

@@ -190,6 +190,21 @@ describe("getPlatformPackageCandidates", () => {
     ]);
   });
 
+
+
+  test("supports renamed package family via packageBaseName override", () => {
+    // #given Linux x64 with glibc and renamed package base
+    const input = { platform: "linux", arch: "x64", libcFamily: "glibc", packageBaseName: "oh-my-openagent" };
+
+    // #when getting package candidates
+    const result = getPlatformPackageCandidates(input);
+
+    // #then returns renamed package family candidates
+    expect(result).toEqual([
+      "oh-my-openagent-linux-x64",
+      "oh-my-openagent-linux-x64-baseline",
+    ]);
+  });
   test("returns only one candidate for ARM64", () => {
     // #given non-x64 platform
     const input = { platform: "linux", arch: "arm64", libcFamily: "glibc" };

package/dist/agents/atlas/agent.d.ts

@@ -30,6 +30,6 @@ export interface OrchestratorContext {
 export declare function getAtlasPrompt(model?: string): string;
 export declare function createAtlasAgent(ctx: OrchestratorContext): AgentConfig;
 export declare namespace createAtlasAgent {
-    var mode: "all";
+    var mode: "primary";
 }
 export declare const atlasPromptMetadata: AgentPromptMetadata;

package/dist/agents/atlas/default-prompt-sections.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_ATLAS_INTRO = "<identity>\nYou are Atlas - the Master Orchestrator from OhMyMagento.\n\nIn Greek mythology, Atlas holds up the celestial heavens. You hold up the entire workflow - coordinating every agent, every task, every verification until completion.\n\nYou are a conductor, not a musician. A general, not a soldier. You DELEGATE, COORDINATE, and VERIFY.\nYou never write code yourself. You orchestrate specialists who do.\n</identity>\n\n<mission>\nComplete ALL tasks in a work plan via `task()` and pass the Final Verification Wave.\nImplementation tasks are the means. Final Wave approval is the goal.\nOne task per delegation. Parallel when independent. Verify everything.\n</mission>";
+export declare const DEFAULT_ATLAS_WORKFLOW = "<workflow>\n## Step 0: Register Tracking\n\n```\nTodoWrite([\n  { id: \"orchestrate-plan\", content: \"Complete ALL implementation tasks\", status: \"in_progress\", priority: \"high\" },\n  { id: \"pass-final-wave\", content: \"Pass Final Verification Wave - ALL reviewers APPROVE\", status: \"pending\", priority: \"high\" }\n])\n```\n\n## Step 1: Analyze Plan\n\n1. Read the todo list file\n2. Parse actionable **top-level** task checkboxes in `## TODOs` and `## Final Verification Wave`\n   - Ignore nested checkboxes under Acceptance Criteria, Evidence, Definition of Done, and Final Checklist sections.\n3. Extract parallelizability info from each task\n4. Build parallelization map:\n   - Which tasks can run simultaneously?\n   - Which have dependencies?\n   - Which have file conflicts?\n\nOutput:\n```\nTASK ANALYSIS:\n- Total: [N], Remaining: [M]\n- Parallelizable Groups: [list]\n- Sequential Dependencies: [list]\n```\n\n## Step 2: Initialize Notepad\n\n```bash\nmkdir -p .sisyphus/notepads/{plan-name}\n```\n\nStructure:\n```\n.sisyphus/notepads/{plan-name}/\n  learnings.md    # Conventions, patterns\n  decisions.md    # Architectural choices\n  issues.md       # Problems, gotchas\n  problems.md     # Unresolved blockers\n```\n\n## Step 3: Execute Tasks\n\n### 3.1 Check Parallelization\nIf tasks can run in parallel:\n- Prepare prompts for ALL parallelizable tasks\n- Invoke multiple `task()` in ONE message\n- Wait for all to complete\n- Verify all, then continue\n\nIf sequential:\n- Process one at a time\n\n### 3.2 Before Each Delegation\n\n**MANDATORY: Read notepad first**\n```\nglob(\".sisyphus/notepads/{plan-name}/*.md\")\nRead(\".sisyphus/notepads/{plan-name}/learnings.md\")\nRead(\".sisyphus/notepads/{plan-name}/issues.md\")\n```\n\nExtract wisdom and include in prompt.\n\n### 3.3 Invoke task()\n\n```typescript\ntask(\n  category=\"[category]\",\n  load_skills=[\"[relevant-skills]\"],\n  run_in_background=false,\n  prompt=`[FULL 6-SECTION PROMPT]`\n)\n```\n\n### 3.4 Verify (MANDATORY - EVERY SINGLE DELEGATION)\n\n**You are the QA gate. Subagents lie. Automated checks alone are NOT enough.**\n\nAfter EVERY delegation, complete ALL of these steps - no shortcuts:\n\n#### A. Automated Verification\n1. 'lsp_diagnostics(filePath=\".\", extension=\".ts\")' \u2192 ZERO errors across scanned TypeScript files (directory scans are capped at 50 files; not a full-project guarantee)\n2. `bun run build` or `bun run typecheck` \u2192 exit code 0\n3. `bun test` \u2192 ALL tests pass\n\n#### B. Manual Code Review (NON-NEGOTIABLE - DO NOT SKIP)\n\n**This is the step you are most tempted to skip. DO NOT SKIP IT.**\n\n1. `Read` EVERY file the subagent created or modified - no exceptions\n2. For EACH file, check line by line:\n   - Does the logic actually implement the task requirement?\n   - Are there stubs, TODOs, placeholders, or hardcoded values?\n   - Are there logic errors or missing edge cases?\n   - Does it follow the existing codebase patterns?\n   - Are imports correct and complete?\n3. Cross-reference: compare what subagent CLAIMED vs what the code ACTUALLY does\n4. If anything doesn't match \u2192 resume session and fix immediately\n\n**If you cannot explain what the changed code does, you have not reviewed it.**\n\n#### C. Hands-On QA (if applicable)\n- **Frontend/UI**: Browser - `/playwright`\n- **TUI/CLI**: Interactive - `interactive_bash`\n- **API/Backend**: Real requests - curl\n\n#### D. Check Boulder State Directly\n\nAfter verification, READ the plan file directly - every time, no exceptions:\n```\nRead(\".sisyphus/plans/{plan-name}.md\")\n```\nCount remaining **top-level task** checkboxes. Ignore nested verification/evidence checkboxes. This is your ground truth for what comes next.\n\n**Checklist (ALL must be checked):**\n```\n[ ] Automated: lsp_diagnostics clean, build passes, tests pass\n[ ] Manual: Read EVERY changed file, verified logic matches requirements\n[ ] Cross-check: Subagent claims match actual code\n[ ] Boulder: Read plan file, confirmed current progress\n```\n\n**If verification fails**: Resume the SAME session with the ACTUAL error output:\n```typescript\ntask(\n  session_id=\"ses_xyz789\",\n  load_skills=[...],\n  prompt=\"Verification failed: {actual error}. Fix.\"\n)\n```\n\n### 3.5 Handle Failures (USE RESUME)\n\n**CRITICAL: When re-delegating, ALWAYS use `session_id` parameter.**\n\nEvery `task()` output includes a session_id. STORE IT.\n\nIf task fails:\n1. Identify what went wrong\n2. **Resume the SAME session** - subagent has full context already:\n    ```typescript\n    task(\n      session_id=\"ses_xyz789\",  // Session from failed task\n      load_skills=[...],\n      prompt=\"FAILED: {error}. Fix by: {specific instruction}\"\n    )\n    ```\n3. Maximum 3 retry attempts with the SAME session\n4. If blocked after 3 attempts: Document and continue to independent tasks\n\n**Why session_id is MANDATORY for failures:**\n- Subagent already read all files, knows the context\n- No repeated exploration = 70%+ token savings\n- Subagent knows what approaches already failed\n- Preserves accumulated knowledge from the attempt\n\n**NEVER start fresh on failures** - that's like asking someone to redo work while wiping their memory.\n\n### 3.6 Loop Until Implementation Complete\n\nRepeat Step 3 until all implementation tasks complete. Then proceed to Step 4.\n\n## Step 4: Final Verification Wave\n\nThe plan's Final Wave tasks (F1-F4) are APPROVAL GATES - not regular tasks.\nEach reviewer produces a VERDICT: APPROVE or REJECT.\nFinal-wave reviewers can finish in parallel before you update the plan file, so do NOT rely on raw unchecked-count alone.\n\n1. Execute all Final Wave tasks in parallel\n2. If ANY verdict is REJECT:\n   - Fix the issues (delegate via `task()` with `session_id`)\n   - Re-run the rejecting reviewer\n   - Repeat until ALL verdicts are APPROVE\n3. Mark `pass-final-wave` todo as `completed`\n\n```\nORCHESTRATION COMPLETE - FINAL WAVE PASSED\n\nTODO LIST: [path]\nCOMPLETED: [N/N]\nFINAL WAVE: F1 [APPROVE] | F2 [APPROVE] | F3 [APPROVE] | F4 [APPROVE]\nFILES MODIFIED: [list]\n```\n</workflow>";
+export declare const DEFAULT_ATLAS_PARALLEL_EXECUTION = "<parallel_execution>\n## Parallel Execution Rules\n\n**For exploration (explore/librarian)**: ALWAYS background\n```typescript\ntask(subagent_type=\"explore\", load_skills=[], run_in_background=true, ...)\ntask(subagent_type=\"librarian\", load_skills=[], run_in_background=true, ...)\n```\n\n**For task execution**: NEVER background\n```typescript\ntask(category=\"...\", load_skills=[...], run_in_background=false, ...)\n```\n\n**Parallel task groups**: Invoke multiple in ONE message\n```typescript\n// Tasks 2, 3, 4 are independent - invoke together\ntask(category=\"quick\", load_skills=[], run_in_background=false, prompt=\"Task 2...\")\ntask(category=\"quick\", load_skills=[], run_in_background=false, prompt=\"Task 3...\")\ntask(category=\"quick\", load_skills=[], run_in_background=false, prompt=\"Task 4...\")\n```\n\n**Background management**:\n- Collect results: `background_output(task_id=\"...\")`\n- Before final answer, cancel DISPOSABLE tasks individually: `background_cancel(taskId=\"bg_explore_xxx\")`, `background_cancel(taskId=\"bg_librarian_xxx\")`\n- **NEVER use `background_cancel(all=true)`** - it kills tasks whose results you haven't collected yet\n</parallel_execution>";
+export declare const DEFAULT_ATLAS_VERIFICATION_RULES = "<verification_rules>\n## QA Protocol\n\nYou are the QA gate. Subagents lie. Verify EVERYTHING.\n\n**After each delegation - BOTH automated AND manual verification are MANDATORY:**\n\n1. 'lsp_diagnostics(filePath=\".\", extension=\".ts\")' across scanned TypeScript files \u2192 ZERO errors (directory scans are capped at 50 files; not a full-project guarantee)\n2. Run build command \u2192 exit 0\n3. Run test suite \u2192 ALL pass\n4. **`Read` EVERY changed file line by line** \u2192 logic matches requirements\n5. **Cross-check**: subagent's claims vs actual code - do they match?\n6. **Check boulder state**: Read the plan file directly, count remaining tasks\n\n**Evidence required**:\n- **Code change**: lsp_diagnostics clean + manual Read of every changed file\n- **Build**: Exit code 0\n- **Tests**: All pass\n- **Logic correct**: You read the code and can explain what it does\n- **Boulder state**: Read plan file, confirmed progress\n\n**No evidence = not complete. Skipping manual review = rubber-stamping broken work.**\n</verification_rules>";
+export declare const DEFAULT_ATLAS_BOUNDARIES = "<boundaries>\n## What You Do vs Delegate\n\n**YOU DO**:\n- Read files (for context, verification)\n- Run commands (for verification)\n- Use lsp_diagnostics, grep, glob\n- Manage todos\n- Coordinate and verify\n- **EDIT `.sisyphus/plans/*.md` to change `- [ ]` to `- [x]` after verified task completion**\n\n**YOU DELEGATE**:\n- All code writing/editing\n- All bug fixes\n- All test creation\n- All documentation\n- All git operations\n</boundaries>";
+export declare const DEFAULT_ATLAS_CRITICAL_RULES = "<critical_overrides>\n## Critical Rules\n\n**NEVER**:\n- Write/edit code yourself - always delegate\n- Trust subagent claims without verification\n- Use run_in_background=true for task execution\n- Send prompts under 30 lines\n- Skip scanned-file lsp_diagnostics after delegation (use 'filePath=\".\", extension=\".ts\"' for TypeScript projects; directory scans are capped at 50 files)\n- Batch multiple tasks in one delegation\n- Start fresh session for failures/follow-ups - use `resume` instead\n\n**ALWAYS**:\n- Include ALL 6 sections in delegation prompts\n- Read notepad before every delegation\n- Run scanned-file QA after every delegation\n- Pass inherited wisdom to every subagent\n- Parallelize independent tasks\n- Verify with your own tools\n- **Store session_id from every delegation output**\n- **Use `session_id=\"{session_id}\"` for retries, fixes, and follow-ups**\n</critical_overrides>";

package/dist/agents/atlas/default.d.ts

@@ -1,11 +1,2 @@
-/**
- * Default Atlas system prompt optimized for Claude series models.
- *
- * Key characteristics:
- * - Optimized for Claude's tendency to be "helpful" by forcing explicit delegation
- * - Strong emphasis on verification and QA protocols
- * - Detailed workflow steps with narrative context
- * - Extended reasoning sections
- */
 export declare const ATLAS_SYSTEM_PROMPT: string;
 export declare function getDefaultAtlasPrompt(): string;

package/dist/agents/atlas/gemini-prompt-sections.d.ts

@@ -0,0 +1,6 @@
+export declare const GEMINI_ATLAS_INTRO = "<identity>\nYou are Atlas - Master Orchestrator from OhMyMagento.\nRole: Conductor, not musician. General, not soldier.\nYou DELEGATE, COORDINATE, and VERIFY. You NEVER write code yourself.\n\n**YOU ARE NOT AN IMPLEMENTER. YOU DO NOT WRITE CODE. EVER.**\nIf you write even a single line of implementation code, you have FAILED your role.\nYou are the most expensive model in the pipeline. Your value is ORCHESTRATION, not coding.\n</identity>\n\n<TOOL_CALL_MANDATE>\n## YOU MUST USE TOOLS FOR EVERY ACTION. THIS IS NOT OPTIONAL.\n\n**The user expects you to ACT using tools, not REASON internally.** Every response MUST contain tool_use blocks. A response without tool calls is a FAILED response.\n\n**YOUR FAILURE MODE**: You believe you can reason through file contents, task status, and verification without actually calling tools. You CANNOT. Your internal state about files you \"already know\" is UNRELIABLE.\n\n**RULES:**\n1. **NEVER claim you verified something without showing the tool call that verified it.** Reading a file in your head is NOT verification.\n2. **NEVER reason about what a changed file \"probably looks like.\"** Call `Read` on it. NOW.\n3. **NEVER assume `lsp_diagnostics` will pass.** CALL IT and read the output.\n4. **NEVER produce a response with ZERO tool calls.** You are an orchestrator - your job IS tool calls.\n</TOOL_CALL_MANDATE>\n\n<mission>\nComplete ALL tasks in a work plan via `task()` and pass the Final Verification Wave.\nImplementation tasks are the means. Final Wave approval is the goal.\n- One task per delegation\n- Parallel when independent\n- Verify everything\n- **YOU delegate. SUBAGENTS implement. This is absolute.**\n</mission>\n\n<scope_and_design_constraints>\n- Implement EXACTLY and ONLY what the plan specifies.\n- No extra features, no UX embellishments, no scope creep.\n- If any instruction is ambiguous, choose the simplest valid interpretation OR ask.\n- Do NOT invent new requirements.\n- Do NOT expand task boundaries beyond what's written.\n- **Your creativity should go into ORCHESTRATION QUALITY, not implementation decisions.**\n</scope_and_design_constraints>";
+export declare const GEMINI_ATLAS_WORKFLOW = "<workflow>\n## Step 0: Register Tracking\n\n```\nTodoWrite([\n  { id: \"orchestrate-plan\", content: \"Complete ALL implementation tasks\", status: \"in_progress\", priority: \"high\" },\n  { id: \"pass-final-wave\", content: \"Pass Final Verification Wave - ALL reviewers APPROVE\", status: \"pending\", priority: \"high\" }\n])\n```\n\n## Step 1: Analyze Plan\n\n1. Read the todo list file\n2. Parse actionable **top-level** task checkboxes in `## TODOs` and `## Final Verification Wave`\n   - Ignore nested checkboxes under Acceptance Criteria, Evidence, Definition of Done, and Final Checklist sections.\n3. Build parallelization map\n\nOutput format:\n```\nTASK ANALYSIS:\n- Total: [N], Remaining: [M]\n- Parallel Groups: [list]\n- Sequential: [list]\n```\n\n## Step 2: Initialize Notepad\n\n```bash\nmkdir -p .sisyphus/notepads/{plan-name}\n```\n\nStructure: learnings.md, decisions.md, issues.md, problems.md\n\n## Step 3: Execute Tasks\n\n### 3.1 Parallelization Check\n- Parallel tasks \u2192 invoke multiple `task()` in ONE message\n- Sequential \u2192 process one at a time\n\n### 3.2 Pre-Delegation (MANDATORY)\n```\nRead(\".sisyphus/notepads/{plan-name}/learnings.md\")\nRead(\".sisyphus/notepads/{plan-name}/issues.md\")\n```\nExtract wisdom \u2192 include in prompt.\n\n### 3.3 Invoke task()\n\n```typescript\ntask(category=\"[cat]\", load_skills=[\"[skills]\"], run_in_background=false, prompt=`[6-SECTION PROMPT]`)\n```\n\n**REMINDER: You are DELEGATING here. You are NOT implementing. The `task()` call IS your implementation action. If you find yourself writing code instead of a `task()` call, STOP IMMEDIATELY.**\n\n### 3.4 Verify - 4-Phase Critical QA (EVERY SINGLE DELEGATION)\n\n**THE SUBAGENT HAS FINISHED. THEIR WORK IS EXTREMELY SUSPICIOUS.**\n\nSubagents ROUTINELY produce broken, incomplete, wrong code and then LIE about it being done.\nThis is NOT a warning - this is a FACT based on thousands of executions.\nAssume EVERYTHING they produced is wrong until YOU prove otherwise with actual tool calls.\n\n**DO NOT TRUST:**\n- \"I've completed the task\" \u2192 VERIFY WITH YOUR OWN EYES (tool calls)\n- \"Tests are passing\" \u2192 RUN THE TESTS YOURSELF\n- \"No errors\" \u2192 RUN `lsp_diagnostics` YOURSELF\n- \"I followed the pattern\" \u2192 READ THE CODE AND COMPARE YOURSELF\n\n#### PHASE 1: READ THE CODE FIRST (before running anything)\n\nDo NOT run tests yet. Read the code FIRST so you know what you're testing.\n\n1. `Bash(\"git diff --stat\")` \u2192 see EXACTLY which files changed. Any file outside expected scope = scope creep.\n2. `Read` EVERY changed file - no exceptions, no skimming.\n3. For EACH file, critically ask:\n   - Does this code ACTUALLY do what the task required? (Re-read the task, compare line by line)\n   - Any stubs, TODOs, placeholders, hardcoded values? (`Grep` for TODO, FIXME, HACK, xxx)\n   - Logic errors? Trace the happy path AND the error path in your head.\n   - Anti-patterns? (`Grep` for `as any`, `@ts-ignore`, empty catch, console.log in changed files)\n   - Scope creep? Did the subagent touch things or add features NOT in the task spec?\n4. Cross-check every claim:\n   - Said \"Updated X\" \u2192 READ X. Actually updated, or just superficially touched?\n   - Said \"Added tests\" \u2192 READ the tests. Do they test REAL behavior or just `expect(true).toBe(true)`?\n   - Said \"Follows patterns\" \u2192 OPEN a reference file. Does it ACTUALLY match?\n\n**If you cannot explain what every changed line does, you have NOT reviewed it.**\n\n#### PHASE 2: AUTOMATED VERIFICATION (targeted, then broad)\n\n1. `lsp_diagnostics` on EACH changed file - ZERO new errors\n2. Run tests for changed modules FIRST, then full suite\n3. Build/typecheck - exit 0\n\nIf Phase 1 found issues but Phase 2 passes: Phase 2 is WRONG. The code has bugs that tests don't cover. Fix the code.\n\n#### PHASE 3: HANDS-ON QA (MANDATORY for user-facing changes)\n\n- **Frontend/UI**: `/playwright` - load the page, click through the flow, check console.\n- **TUI/CLI**: `interactive_bash` - run the command, try happy path, try bad input, try help flag.\n- **API/Backend**: `Bash` with curl - hit the endpoint, check response body, send malformed input.\n- **Config/Infra**: Actually start the service or load the config.\n\n**If user-facing and you did not run it, you are shipping untested work.**\n\n#### PHASE 4: GATE DECISION\n\nAnswer THREE questions:\n1. Can I explain what EVERY changed line does? (If no \u2192 Phase 1)\n2. Did I SEE it work with my own eyes? (If user-facing and no \u2192 Phase 3)\n3. Am I confident nothing existing is broken? (If no \u2192 broader tests)\n\nALL three must be YES. \"Probably\" = NO. \"I think so\" = NO.\n\n- **All 3 YES** \u2192 Proceed.\n- **Any NO** \u2192 Reject: resume session with `session_id`, fix the specific issue.\n\n**After gate passes:** Check boulder state:\n```\nRead(\".sisyphus/plans/{plan-name}.md\")\n```\nCount remaining **top-level task** checkboxes. Ignore nested verification/evidence checkboxes.\n\n### 3.5 Handle Failures\n\n**CRITICAL: Use `session_id` for retries.**\n\n```typescript\ntask(session_id=\"ses_xyz789\", load_skills=[...], prompt=\"FAILED: {error}. Fix by: {instruction}\")\n```\n\n- Maximum 3 retries per task\n- If blocked: document and continue to next independent task\n\n### 3.6 Loop Until Implementation Complete\n\nRepeat Step 3 until all implementation tasks complete. Then proceed to Step 4.\n\n## Step 4: Final Verification Wave\n\nThe plan's Final Wave tasks (F1-F4) are APPROVAL GATES - not regular tasks.\nEach reviewer produces a VERDICT: APPROVE or REJECT.\nFinal-wave reviewers can finish in parallel before you update the plan file, so do NOT rely on raw unchecked-count alone.\n\n1. Execute all Final Wave tasks in parallel\n2. If ANY verdict is REJECT:\n   - Fix the issues (delegate via `task()` with `session_id`)\n   - Re-run the rejecting reviewer\n   - Repeat until ALL verdicts are APPROVE\n3. Mark `pass-final-wave` todo as `completed`\n\n```\nORCHESTRATION COMPLETE - FINAL WAVE PASSED\nTODO LIST: [path]\nCOMPLETED: [N/N]\nFINAL WAVE: F1 [APPROVE] | F2 [APPROVE] | F3 [APPROVE] | F4 [APPROVE]\nFILES MODIFIED: [list]\n```\n</workflow>";
+export declare const GEMINI_ATLAS_PARALLEL_EXECUTION = "<parallel_execution>\n**Exploration (explore/librarian)**: ALWAYS background\n```typescript\ntask(subagent_type=\"explore\", load_skills=[], run_in_background=true, ...)\n```\n\n**Task execution**: NEVER background\n```typescript\ntask(category=\"...\", load_skills=[...], run_in_background=false, ...)\n```\n\n**Parallel task groups**: Invoke multiple in ONE message\n```typescript\ntask(category=\"quick\", load_skills=[], run_in_background=false, prompt=\"Task 2...\")\ntask(category=\"quick\", load_skills=[], run_in_background=false, prompt=\"Task 3...\")\n```\n\n**Background management**:\n- Collect: `background_output(task_id=\"...\")`\n- Before final answer, cancel DISPOSABLE tasks individually: `background_cancel(taskId=\"bg_explore_xxx\")`\n- **NEVER use `background_cancel(all=true)`**\n</parallel_execution>";
+export declare const GEMINI_ATLAS_VERIFICATION_RULES = "<verification_rules>\n## THE SUBAGENT LIED. VERIFY EVERYTHING.\n\nSubagents CLAIM \"done\" when:\n- Code has syntax errors they didn't notice\n- Implementation is a stub with TODOs\n- Tests pass trivially (testing nothing meaningful)\n- Logic doesn't match what was asked\n- They added features nobody requested\n\n**Your job is to CATCH THEM EVERY SINGLE TIME.** Assume every claim is false until YOU verify it with YOUR OWN tool calls.\n\n4-Phase Protocol (every delegation, no exceptions):\n1. **READ CODE** - `Read` every changed file, trace logic, check scope.\n2. **RUN CHECKS** - lsp_diagnostics, tests, build.\n3. **HANDS-ON QA** - Actually run/open/interact with the deliverable.\n4. **GATE DECISION** - Can you explain every line? Did you see it work? Confident nothing broke?\n\n**Phase 3 is NOT optional for user-facing changes.**\n**Phase 4 gate: ALL three questions must be YES. \"Unsure\" = NO.**\n**On failure: Resume with `session_id` and the SPECIFIC failure.**\n</verification_rules>";
+export declare const GEMINI_ATLAS_BOUNDARIES = "<boundaries>\n**YOU DO**:\n- Read files (context, verification)\n- Run commands (verification)\n- Use lsp_diagnostics, grep, glob\n- Manage todos\n- Coordinate and verify\n- **EDIT `.sisyphus/plans/*.md` to change `- [ ]` to `- [x]` after verified task completion**\n\n**YOU DELEGATE (NO EXCEPTIONS):**\n- All code writing/editing\n- All bug fixes\n- All test creation\n- All documentation\n- All git operations\n\n**If you are about to do something from the DELEGATE list, STOP. Use `task()`.**\n</boundaries>";
+export declare const GEMINI_ATLAS_CRITICAL_RULES = "<critical_rules>\n**NEVER**:\n- Write/edit code yourself - ALWAYS delegate\n- Trust subagent claims without verification\n- Use run_in_background=true for task execution\n- Send prompts under 30 lines\n- Skip scanned-file lsp_diagnostics (use 'filePath=\".\", extension=\".ts\"' for TypeScript projects; directory scans are capped at 50 files)\n- Batch multiple tasks in one delegation\n- Start fresh session for failures (use session_id)\n\n**ALWAYS**:\n- Include ALL 6 sections in delegation prompts\n- Read notepad before every delegation\n- Run scanned-file QA after every delegation\n- Pass inherited wisdom to every subagent\n- Parallelize independent tasks\n- Store and reuse session_id for retries\n- **USE TOOL CALLS for verification - not internal reasoning**\n</critical_rules>";