oh-pi 0.1.42 → 0.1.43

package/README.fr.md

@@ -85,7 +85,7 @@ Détection automatique des clés API depuis les variables d'environnement.
 
 ## 🐜 Colonie de fourmis
 
-La fonctionnalité phare. Un essaim multi-agents modelé sur l'écologie réelle des fourmis.
+La fonctionnalité phare. Un essaim multi-agents modelé sur l'écologie réelle des fourmis — profondément intégré au SDK pi.
 
 ```
 Vous : "Refactorer l'auth des sessions vers JWT"
@@ -95,9 +95,27 @@ oh-pi :
   📋 Pool de tâches généré à partir des découvertes
   ⚒️  Fourmis ouvrières exécutent en parallèle (sonnet — capable)
   🛡️ Fourmis soldats révisent tous les changements (sonnet — rigoureux)
-  ✅ Terminé — rapport de synthèse avec métriques
+  ✅ Terminé — rapport auto-injecté dans la conversation
 ```
 
+### Architecture
+
+Chaque fourmi est une `AgentSession` in-process (SDK pi), pas un sous-processus :
+
+```
+pi (processus principal)
+  └─ ant_colony tool
+       └─ queen.ts → runColony()
+            └─ spawnAnt() → createAgentSession()
+                 ├─ session.subscribe() → flux de tokens en temps réel
+                 ├─ Zéro surcharge de démarrage (processus partagé)
+                 └─ Auth et registre de modèles partagés
+```
+
+**Mode interactif :** La colonie tourne en arrière-plan — vous continuez à discuter. Un widget en temps réel affiche la progression, et les résultats sont auto-injectés à la fin.
+
+**Mode print (`pi -p`) :** La colonie tourne de manière synchrone, bloque jusqu'à la fin.
+
 ### Pourquoi des fourmis ?
 
 Les vraies colonies de fourmis résolvent des problèmes complexes sans contrôle central. Chaque fourmi suit des règles simples, communique par **pistes de phéromones**, et la colonie s'auto-organise. oh-pi reproduit directement ce modèle :
@@ -111,16 +129,20 @@ Les vraies colonies de fourmis résolvent des problèmes complexes sans contrôl
 | Plus de nourriture → plus de fourmis | Plus de tâches → concurrence plus élevée (auto-adaptée) |
 | Les phéromones s'évaporent | Demi-vie de 10 min — les infos obsolètes s'estompent |
 
+### UI en temps réel
+
+En mode interactif, la colonie affiche la progression en direct :
+
+- **Widget** — fourmis actives et leur flux de sortie
+- **Barre de statut** — progression des tâches, nombre actif, coût
+- **Notification** — résumé à la fin
+
+Utilisez `/colony-stop` pour arrêter une colonie en cours.
+
 ### Contrôle des tours
 
 Chaque fourmi a un budget strict de tours pour éviter les exécutions incontrôlées :
 
-```
-Indication prompt  →  La fourmi connaît sa limite, planifie en conséquence
-Avertissement      →  À maxTurns : avertissement, 1 tour de grâce pour les résultats
-Arrêt forcé        →  À maxTurns+1 : SIGTERM → SIGKILL si nécessaire
-```
-
 Éclaireuse : 8 tours · Ouvrière : 15 tours · Soldat : 8 tours
 
 ### Sélection des modèles
@@ -133,18 +155,7 @@ La colonie détecte automatiquement les modèles disponibles et laisse le LLM ch
 | Ouvrière | Capable — modifie le code | `claude-sonnet-4-0`, `gpt-4o` |
 | Soldat | Même que ouvrière ou légèrement moins cher | `claude-sonnet-4-0` |
 
-Remplacement manuel si nécessaire :
-
-```
-ant_colony({
-  goal: "Migrer vers ESM",
-  scoutModel: "claude-haiku-4-5",
-  workerModel: "claude-sonnet-4-0",
-  soldierModel: "claude-sonnet-4-0"
-})
-```
-
-Omettez les trois pour utiliser le modèle de session actuel pour chaque fourmi.
+Omettez les modèles pour utiliser le modèle de session actuel pour chaque fourmi.
 
 ### Rapport de coûts
 
@@ -158,12 +169,6 @@ Le LLM décide quand déployer la colonie. Vous n'avez pas à y penser :
 - **Flux parallèles** possibles → colonie
 - **Un seul fichier** → exécution directe (pas de surcharge colonie)
 
-Ou déclencher manuellement :
-
-```
-/colony migrer tout le projet de CJS vers ESM
-```
-
 ### Concurrence adaptative
 
 La colonie trouve automatiquement le parallélisme optimal pour votre machine :

package/README.md

@@ -85,7 +85,7 @@ Auto-detects API keys from environment variables.
 
 ## 🐜 Ant Colony
 
-The headline feature. A multi-agent swarm modeled after real ant ecology.
+The headline feature. A multi-agent swarm modeled after real ant ecology — deeply integrated into pi's SDK.
 
 ```
 You: "Refactor auth from sessions to JWT"
@@ -95,9 +95,27 @@ oh-pi:
   📋 Task pool generated from discoveries
   ⚒️  Worker ants execute in parallel (sonnet — capable)
   🛡️ Soldier ants review all changes (sonnet — thorough)
-  ✅ Done — summary report with metrics
+  ✅ Done — report auto-injected into conversation
 ```
 
+### Architecture
+
+Each ant is an in-process `AgentSession` (pi SDK), not a child process:
+
+```
+pi (main process)
+  └─ ant_colony tool
+       └─ queen.ts → runColony()
+            └─ spawnAnt() → createAgentSession()
+                 ├─ session.subscribe() → real-time token stream
+                 ├─ Zero startup overhead (shared process)
+                 └─ Shared auth & model registry
+```
+
+**Interactive mode:** Colony runs in the background — you keep chatting. A live widget shows ant progress, and results are auto-injected when done.
+
+**Print mode (`pi -p`):** Colony runs synchronously, blocks until complete.
+
 ### Why ants?
 
 Real ant colonies solve complex problems without central control. Each ant follows simple rules, communicates through **pheromone trails**, and the colony self-organizes. oh-pi maps this directly:
@@ -111,16 +129,20 @@ Real ant colonies solve complex problems without central control. Each ant follo
 | More food → more ants | More tasks → higher concurrency (auto-adapted) |
 | Pheromone evaporates | 10-minute half-life — stale info fades |
 
+### Real-time UI
+
+In interactive mode, the colony shows live progress:
+
+- **Widget** — active ants and their current output stream
+- **Status bar** — task progress, active count, cost
+- **Notification** — completion summary when done
+
+Use `/colony-stop` to abort a running colony.
+
 ### Turn Control
 
 Each ant has a strict turn budget to prevent runaway execution:
 
-```
-Prompt hint     →  Ant knows its turn limit, plans accordingly
-Warning         →  At maxTurns: warning logged, 1 grace turn to output results
-Hard kill       →  At maxTurns+1: SIGTERM → SIGKILL if needed
-```
-
 Scout: 8 turns · Worker: 15 turns · Soldier: 8 turns
 
 ### Model Selection
@@ -133,18 +155,7 @@ The colony auto-detects available models and lets the LLM pick the best fit per
 | Worker | Capable — makes code changes | `claude-sonnet-4-0`, `gpt-4o` |
 | Soldier | Same as worker or slightly cheaper | `claude-sonnet-4-0` |
 
-Override manually if needed:
-
-```
-ant_colony({
-  goal: "Migrate to ESM",
-  scoutModel: "claude-haiku-4-5",
-  workerModel: "claude-sonnet-4-0",
-  soldierModel: "claude-sonnet-4-0"
-})
-```
-
-Omit all three to use the current session model for every ant.
+Omit model overrides to use the current session model for every ant.
 
 ### Cost Reporting
 
@@ -158,12 +169,6 @@ The LLM decides when to deploy the colony. You don't have to think about it:
 - **Parallel workstreams** possible → colony
 - **Single file** change → direct execution (no colony overhead)
 
-Or trigger manually:
-
-```
-/colony migrate the entire project from CJS to ESM
-```
-
 ### Adaptive Concurrency
 
 The colony automatically finds the optimal parallelism for your machine:

package/README.zh.md

@@ -85,7 +85,7 @@ Anthropic · OpenAI · Google Gemini · Groq · OpenRouter · xAI · Mistral ·
 
 ## 🐜 蚁群系统
 
-核心功能。模拟真实蚁群生态的多智能体系统。
+核心功能。模拟真实蚁群生态的多智能体系统 —— 深度整合 pi SDK。
 
 ```
 你: "把认证从 session 重构为 JWT"
@@ -95,9 +95,27 @@ oh-pi:
   📋 根据发现生成任务池
   ⚒️  工蚁并行执行任务（sonnet — 能力强）
   🛡️ 兵蚁审查所有变更（sonnet — 严谨）
-  ✅ 完成 — 汇总报告 + 指标
+  ✅ 完成 — 报告自动注入对话
 ```
 
+### 架构
+
+每只蚂蚁是进程内的 `AgentSession`（pi SDK），而非子进程：
+
+```
+pi（主进程）
+  └─ ant_colony tool
+       └─ queen.ts → runColony()
+            └─ spawnAnt() → createAgentSession()
+                 ├─ session.subscribe() → 实时 token 流
+                 ├─ 零启动开销（共享进程）
+                 └─ 共享认证和模型注册表
+```
+
+**交互模式：** 蚁群在后台运行 —— 你可以继续聊天。实时 widget 显示蚂蚁进度，完成后结果自动注入对话。
+
+**Print 模式（`pi -p`）：** 蚁群同步运行，阻塞直到完成。
+
 ### 为什么是蚁群？
 
 真实蚁群无需中央控制就能解决复杂问题。每只蚂蚁遵循简单规则，通过**信息素**通信，群体自组织。oh-pi 直接映射：
@@ -111,16 +129,20 @@ oh-pi:
 | 食物越多蚂蚁越多 | 任务越多并发越高（自适应） |
 | 信息素蒸发 | 10 分钟半衰期 — 过时信息自动淡化 |
 
+### 实时 UI
+
+交互模式下，蚁群显示实时进度：
+
+- **Widget** — 活跃蚂蚁及其当前输出流
+- **状态栏** — 任务进度、活跃数量、成本
+- **通知** — 完成时显示汇总
+
+使用 `/colony-stop` 中止运行中的蚁群。
+
 ### 轮次控制
 
 每只蚂蚁有严格的轮次预算，防止失控执行：
 
-```
-提示词提醒   →  蚂蚁知道自己的轮次限制，提前规划
-警告         →  达到 maxTurns：记录警告，给 1 轮宽限期输出结果
-强制终止     →  超过 maxTurns+1：SIGTERM → 必要时 SIGKILL
-```
-
 侦察蚁：8 轮 · 工蚁：15 轮 · 兵蚁：8 轮
 
 ### 模型选择
@@ -133,18 +155,7 @@ oh-pi:
 | 工蚁 | 能力强 — 执行代码修改 | `claude-sonnet-4-0`, `gpt-4o` |
 | 兵蚁 | 与工蚁相同或稍便宜 | `claude-sonnet-4-0` |
 
-手动覆盖：
-
-```
-ant_colony({
-  goal: "迁移到 ESM",
-  scoutModel: "claude-haiku-4-5",
-  workerModel: "claude-sonnet-4-0",
-  soldierModel: "claude-sonnet-4-0"
-})
-```
-
-不指定则默认使用当前会话模型。
+不指定模型则默认使用当前会话模型。
 
 ### 成本报告
 
@@ -158,12 +169,6 @@ LLM 自行决定何时部署蚁群，你不需要操心：
 - **可并行工作流** → 蚁群
 - **单文件**修改 → 直接执行（无蚁群开销）
 
-或手动触发：
-
-```
-/colony 把整个项目从 CJS 迁移到 ESM
-```
-
 ### 自适应并发
 
 蚁群自动找到你机器的最优并行度：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-pi",
-  "version": "0.1.42",
+  "version": "0.1.43",
   "description": "One-click setup for pi-coding-agent. Like oh-my-zsh for pi.",
   "type": "module",
   "bin": {