zidane 4.1.8 → 5.0.0

package/README.md

@@ -479,7 +479,7 @@ await Promise.all([agent.warmup(), authenticate(), loadConfig()])  // pre-warm m
 const agent = createAgent({ provider, mcpServers, eager: true })   // or kick off automatically
 ```
 
-`warmup()` is idempotent and concurrency-safe. Failures surface on the next `warmup()` / `run()`, not on the eager kickoff.
+`warmup()` fans MCP connect + skills resolution out in parallel — both idempotent and concurrency-safe. Failures surface on the next `warmup()` / `run()`, not on the eager kickoff. `agent.activateSkill(name)` also auto-resolves the catalog on its first call, so a TUI can wire `/slash`-style activation at submit time without ordering it against `run()`.
 
 Two hooks fire per bootstrap regardless of outcome — attribute cold-start latency per server:
 
@@ -570,7 +570,7 @@ agent.isRunning           // run in progress?
 agent.turns               // SessionTurn[]
 agent.abort()             // cancel current run
 agent.reset()             // clear turns + queues
-await agent.warmup()      // pre-connect MCP (idempotent)
+await agent.warmup()      // pre-connect MCP + resolve skills (idempotent)
 await agent.destroy()     // clean up context + MCP
 await agent.waitForIdle() // wait for run to complete
 ```
@@ -670,6 +670,15 @@ bun test
 
 Benchmark harnesses live in [`benchmarks/`](./benchmarks). First integration: [Terminal-Bench](./benchmarks/terminal-bench).
 
+## Docs
+
+| Doc | What |
+|---|---|
+| [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) | Mermaid diagrams of the agent loop, tool execution, hook firing order, dependency graph. |
+| [docs/SKILL.md](./docs/SKILL.md) | Authoritative reference for `createAgent` + hooks + tools + sessions + skills + MCP. Long-form. |
+| [docs/CHAT.md](./docs/CHAT.md) | `zidane/chat` — renderer-agnostic chat engine (auth, sessions, safe-mode, settings, theme). Consumed by the TUI and any future GUI. |
+| [docs/TUI.md](./docs/TUI.md) | `zidane/tui` — terminal shell built on `zidane/chat`. `runTui()`, screens, modals, keyboard, theming. |
+
 ## License
 
 ISC