chore: fix docs accuracy and remove dead event_bus param

Correct factual errors in internal and public docs before production
release: default backend "claude" → "claude-code", _git.py → git.py,
add missing server route files and core modules to architecture trees,
replace nonexistent plugin endpoints with actual API, clarify persona
pipeline is orchestrator-driven, fix KanbanChatScreen misnomer, remove
placeholder PGP block, use "14+" instead of hardcoded agent count.
Remove dead event_bus parameter from Events.__init__ left over from
EventBus removal refactor.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: aorumbayev

docs/index.md

@@ -8,7 +8,7 @@ hide:
 
 # Your agents work. You decide.
 
-Fourteen AI agents. One board. Every task tracked from backlog to merge -- while you keep your hands on the wheel.
+14+ AI agents. One board. Every task tracked from backlog to merge -- while you keep your hands on the wheel.
 
 Kagan is a keyboard-first Kanban TUI that orchestrates coding agents across the full task lifecycle. Plan. Run. Review. Merge. No context lost between steps, no state scattered across terminals.
 

docs/internal/architecture/core.md

@@ -50,7 +50,7 @@ kagan/core/
 ├── enums.py               # TaskStatus, SessionStatus, Priority, SessionEventType
 ├── errors.py              # KaganError hierarchy
 │
-├── _git.py                # git operations wrapper
+├── git.py                 # git operations wrapper (public module)
 ├── _acp.py                # ACP adapter: KaganACPClient + event mapping
 ├── _agent.py              # agent backend registry + launcher
 ├── _asyncio_compat.py     # asyncio compatibility shims
@@ -73,14 +73,26 @@ kagan/core/
 ├── _tasks.py              # task repository
 ├── _transitions.py        # task lifecycle state machine
 ├── _utils.py              # utility functions
+├── _watcher.py            # DBWatcher: filesystem DB change watcher
 ├── _worktrees.py          # worktree management logic
 │
+├── _agent_monitor.py      # post-agent evaluation and rebase helpers
+├── _checkpoints.py        # task execution checkpoints (create, list, rewind, cleanup)
+├── _compaction.py         # database compaction
+├── _event_rendering.py    # event display rendering helpers
+├── _hooks.py              # hook system (Hook, HookRunner, HookContext)
+├── _insights.py           # project insight extraction with decay and relevance
+├── _prompt_export.py      # prompt export functionality
+├── _security.py           # security helpers
+├── _session_helpers.py    # session utility functions
+├── _verification.py       # step-level verification tracking for acceptance criteria
+│
 └── adapters/              # adapter sub-package
     ├── __init__.py
     └── db/                # database adapters
 ```
 
-~31 files. Flat structure with private modules (underscore prefix) and adapters sub-package.
+~42 files. Flat structure with private modules (underscore prefix) and adapters sub-package.
 
 ## Frontend Construction
 
@@ -301,7 +313,7 @@ DONE ───────► BACKLOG (via task.set_status)
 
 Direct DONE from `task.set_status()` is blocked; only `review.merge()` can transition to DONE.
 
-### `_git.py` — Git Operations
+### `git.py` — Git Operations
 
 Created per-repo via `client._git_for_task()`. Operations: `worktree_add`, `worktree_remove`, `diff`, `merge`, `rebase`, etc.
 

docs/internal/architecture/server.md

@@ -36,9 +36,12 @@ ______________________________________________________________________
 src/kagan/server/
 ├── __init__.py          # re-export create_api_server
 ├── server.py            # ApiServer factory, entry point
-├── _routes.py           # Core REST API + SSE event stream (tasks, projects, settings)
+├── _routes.py           # Route dispatcher: imports and registers task, project, system routes
+├── _task_routes.py      # Task REST endpoints (CRUD, run, cancel, review)
+├── _project_routes.py   # Project REST endpoints
+├── _system_routes.py    # System endpoints (preflight, settings, presence)
 ├── _chat_routes.py      # Chat REST + SSE streaming routes (orchestrator sessions)
-├── _plugin_routes.py    # Plugin-specific REST routes (sync, preflight)
+├── _plugin_routes.py    # Plugin REST routes (list, preflight, detect-repo, import)
 ├── _sse.py              # SSE streaming helpers (event generator, keepalive)
 ├── _access.py           # Access control helpers (HTTP access tiers for REST routes)
 ├── _helpers.py          # Route helper functions (JSON response builders, error formatting)
@@ -64,8 +67,9 @@ ______________________________________________________________________
 
 1. Calls `kagan.server.mcp.server.create_server(opts.mcp_opts)`.
 1. Registers a `/health` endpoint.
-1. Calls `register_routes(mcp)` to add the REST API and SSE event stream.
+1. Calls `register_routes(mcp)` — dispatches to `_task_routes`, `_project_routes`, `_system_routes`, and adds the SSE event stream.
 1. Calls `register_chat_routes(mcp)` to add chat REST + SSE streaming.
+1. Calls `register_plugin_routes(mcp)` to add plugin REST routes.
 
 ______________________________________________________________________
 

docs/internal/architecture/tui.md

@@ -75,7 +75,7 @@ KaganApp (Textual App)
 │   ├── Session sidebar      # Searchable orchestrator conversation list
 │   └── ChatPanel            # Full-width main conversation surface
 │
-├── KanbanChatScreen         # Dedicated kanban + chat (orchestrator / task chat modes)
+├── (kanban_chat helpers)     # ACP payload extraction, stream chunk helpers (not a Screen)
 │
 ├── TaskScreen               # Primary task detail screen pushed from kanban after inspector-open
 │
@@ -274,7 +274,7 @@ src/kagan/tui/
 │   ├── welcome.py           # WelcomeScreen
 │   ├── setup.py             # OnboardingFlow (modal)
 │   ├── kanban.py            # KanbanScreen
-│   ├── kanban_chat.py       # KanbanChatScreen
+│   ├── kanban_chat.py       # ACP payload + stream chunk helpers (not a Screen class)
 │   ├── workspace.py         # WorkspaceScreen
 │   ├── task_screen.py       # TaskScreen
 │   ├── session_dashboard.py # SessionDashboardScreen

docs/internal/features/core.md

@@ -119,11 +119,12 @@ ______________________________________________________________________
 
 - Four built-in personas: `analyst`, `planner`, `implementer`, `reviewer`
 - Each persona has a distinct prompt profile tuned to its role
-- Run a persona against a repo for structured analysis (`audit_repo`)
+- Activate a persona per session via `run_start(task_id, persona="implementer")`
 - Import persona presets from GitHub repos (subject to whitelist)
 - Export persona presets to GitHub repos
 - Manage an import whitelist of approved persona source repos
-- Multi-session task execution: run a task through a sequence of personas in order (analyst → planner → implementer → reviewer) without manual handoff between sessions
+- Audit persona repositories for preset structure and validity (`audit_repo`)
+- Multi-session sequencing is orchestrator-driven: the orchestrator agent plans and starts sequential persona sessions via MCP tools, not an automated Python-level pipeline
 
 ______________________________________________________________________
 

docs/internal/features/server.md

@@ -164,22 +164,38 @@ ______________________________________________________________________
 
 ## Plugin Routes
 
-Plugins can be synced and checked via REST without restarting the server.
+Plugins can be listed, checked, and imported via REST without restarting the server.
 
-### Syncing plugins
+### List plugins
 
-Triggers discovery and registration of all installed plugins:
+Returns all registered plugins:
 
 ```bash
-curl -X POST http://localhost:8765/api/plugins/sync
+curl http://localhost:8765/api/plugins
 ```
 
-### Preflight check
+### Preflight check (per plugin)
 
-Returns readiness status for each registered plugin:
+Returns readiness status for a specific plugin:
 
 ```bash
-curl http://localhost:8765/api/plugins/preflight
+curl http://localhost:8765/api/plugins/{name}/preflight
+```
+
+### Detect repo
+
+Detect repo metadata for a specific plugin:
+
+```bash
+curl http://localhost:8765/api/plugins/{name}/detect-repo
+```
+
+### Import
+
+Import a plugin by name:
+
+```bash
+curl -X POST http://localhost:8765/api/plugins/{name}/import
 ```
 
 ______________________________________________________________________

docs/reference/configuration.md

@@ -23,7 +23,7 @@ Files: `config.toml`, `kagan.db`, core runtime (`endpoint.json`, `token`, etc.).
 
 ```toml
 [general]
-default_agent_backend = "claude"
+default_agent_backend = "claude-code"
 auto_skill_discovery = false
 review_strictness = "balanced"
 additional_instructions = "Use conventional commit format"
@@ -45,7 +45,7 @@ max_concurrent_agents = 3
 | `auto_skill_discovery`               | boolean        | `false`                          | Enable trusted local skill metadata discovery for orchestrator `/skills`            |
 | `require_review_approval`            | boolean        | `false`                          | Require review approval before merge                                                |
 | `serialize_merges`                   | boolean        | `true`                           | Queue merge actions                                                                 |
-| `default_agent_backend`              | string         | `"claude"`                       | Default worker agent                                                                |
+| `default_agent_backend`              | string         | `"claude-code"`                  | Default worker agent                                                                |
 | `additional_instructions`            | string         | `""`                             | Free-text rules appended to every agent prompt                                      |
 | `review_strictness`                  | string         | `"balanced"`                     | Review rigor. Allowed: `strict`, `balanced`, `relaxed`                              |
 | `planning_depth`                     | string         | `"always"`                       | When to create task plans. Allowed: `always`, `multi_task`, `never`                 |

docs/security.md

@@ -452,13 +452,7 @@ If you discover a security vulnerability in Kagan, please report it responsibly:
 
 **Email:** `security@kagan.sh`
 
-**PGP Key:** (Placeholder — contact security@kagan.sh for the current PGP key)
-
-```
------BEGIN PGP PUBLIC KEY BLOCK-----
-[Placeholder - PGP key will be provided upon request]
------END PGP PUBLIC KEY BLOCK-----
-```
+**PGP Key:** Contact security@kagan.sh to request the current PGP key for encrypted communication.
 
 ### Responsible Disclosure
 

src/kagan/core/_events.py

@@ -311,11 +311,9 @@ def __init__(
         self,
         engine: Engine,
         signals: dict[str, asyncio.Event],
-        event_bus: Any = None,
     ) -> None:
         self._engine = engine
         self._signals = signals
-        self._event_bus = None
         self._live_queues: dict[str, list[_BoundedEventQueue[SessionEvent]]] = {}
         self._global_live_queues: list[_BoundedEventQueue[SessionEvent]] = []
         self._board_live_queues: list[_BoundedEventQueue[BoardEvent]] = []

src/kagan/core/_tasks.py

@@ -493,7 +493,6 @@ def __init__(
         self.events = Events(
             engine,
             signals,
-            event_bus=None,
         )
         self.sessions = Sessions(
             engine,