omnius 1.0.607 → 1.0.609

package/docs/DISCOVERY.md

@@ -1,332 +1,342 @@
 # Omnius Discovery Catalog
 
-Generated discovery schema: `1.0.0`. This index covers Omnius providers, tools, APIs, commands, skills, configuration, operations, addons, and every artifact shipped under `docs/`.
+Generated discovery schema: `2.0.0`. This index covers the system layers, runtimes, stores, workflows, modules, providers, tools, APIs, commands, skills, configuration, operations, addons, and bundled documentation.
 
-## Discovery Cascade
+## Agent Bootstrap
 
-1. Search with the user's intent; do not guess a provider, tool, or path.
-2. Expand the selected stable ID and inspect its interfaces, prerequisites, references, and related entries.
-3. Read only the smallest referenced guide. For live work, confirm the running service through `/version`, `/openapi.json`, `/v1/tools`, or provider metadata.
-4. Send `X-Omnius-Min-Version` on execution requests so a stale daemon fails before creating work.
+1. Identify the caller and intent, then search instead of guessing a command, route, tool, provider, or file.
+2. Expand one stable ID and read its use/avoid conditions, exact interfaces, safety data, workflow, failure recovery, and source of truth.
+3. For live work, compare the installed package and daemon at GET /version, then inspect GET /openapi.json and the relevant live registry.
+4. Choose one execution surface, send X-Omnius-Min-Version for mutating or model-backed requests, and preserve the project/global state boundary.
+5. Verify the observable result described by the entry; do not equate an accepted or queued request with completion.
+
+Start with: `overview`, `layer.interface`, `layer.orchestration`, `workflow.choose-entrypoint`, `store.project`, `store.global`, `workflow.debug-runtime`.
 
 ```bash
-omnius discover "bring your own inference"
-omnius show provider.anthropic
-omnius show provider.gemini
-omnius show tool.web-search
+omnius discover "run a long coding task through REST"
+omnius show workflow.async-agent-run
+omnius show layer.orchestration
 omnius capabilities --json
 ```
 
-Daemon equivalents are `GET /v1/discovery?q=<intent>` and `GET /v1/discovery/{id}`. `web_search` is agent-bound: inspect its metadata, then offer it through `/v1/run`, `/v1/chat`, or `/v1/chat/completions`; do not infer a direct-call route.
+Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<intent>`, and `GET /v1/discovery/{id}`. Treat interfaces and safety fields as authoritative; never infer a REST route from a TUI command or a direct-call route from a tool name.
+
+## System Layers
+
+| ID | Responsibility |
+| --- | --- |
+| `layer.architecture` | The process, package, dependency, and data-flow map that connects public interfaces to their source owners and runtime boundaries. |
+| `layer.code-intelligence` | Repository indexing, symbol and code graph storage, retrieval, repository context, and evidence-directed navigation used by coding agents. |
+| `layer.context` | System prompts, task templates, context compilation, admission, compaction, dumps, history sanitation, token budgeting, and working-context recovery. |
+| `layer.contracts` | Shared TypeScript schemas, OpenAPI, command/tool/provider registries, version preconditions, and generated documentation that keep surfaces consistent. |
+| `layer.discovery` | Stable IDs, bootstrap profiles, task workflows, generated catalogs, package guidance, and live discovery endpoints that let agents navigate Omnius without prior repository knowledge. |
+| `layer.documentation` | User, operator, integrator, and maintainer explanations linked from the generated discovery graph and deployable AIWG skills. |
+| `layer.execution` | Executable tools, schemas, security classification, direct versus agent-bound exposure, MCP/custom tools, mutation contracts, and shell/file/browser boundaries. |
+| `layer.inference` | Provider descriptors, endpoint protocol selection, model routing, local Ollama/vLLM, hosted APIs, sponsor capacity, and compatibility translation. |
+| `layer.interface` | The TUI, one-shot CLI, REST daemon, dashboard, tray indicator, Telegram gateway, and JavaScript library through which users and agents enter Omnius. |
+| `layer.media` | ASR engine registry and managed weights, TTS/voice cloning, realtime voicechat, live sensors, vision, and image/video/audio generation backed by shared model storage. |
+| `layer.memory` | Project sessions, episodes, temporal graph memory, maintenance, summaries, task continuity, and explicit separation between conversational history and slash-command control input. |
+| `layer.observability` | Action trees, run events, status, metrics, context dumps, logs, evidence and verification ledgers, debug artifacts, and UI projections for proving what happened. |
+| `layer.operations` | Daemon lifecycle and port ownership, tray indicator, update and restart verification, schedulers, installation, runtime dependencies, packaging, and publish staging. |
+| `layer.orchestration` | Long-horizon task intake, planning, agent/tool turns, sub-agents, completion contracts, trajectory checkpoints, recovery, and run lifecycle. |
+| `layer.persistence` | Project-local .omnius state, user-global ~/.omnius state, shared model/runtime caches, configuration precedence, and the rules preventing cross-project leakage. |
+| `layer.security` | Authentication, REST scopes, secret handling, tool risk and mutation policy, remote access, hardware preflight, AIMS controls, and fail-closed execution gates. |
 
 ## Api
 
 | ID | Title | Summary |
 | --- | --- | --- |
 | `api.discovery` | Discovery API | Search the Omnius capability catalog and expand a stable entry over REST. |
-| `api.health` | /health | Omnius REST API route /health. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.health-ready` | /health/ready | Omnius REST API route /health/ready. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.health-startup` | /health/startup | Omnius REST API route /health/startup. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.metrics` | /metrics | Omnius REST API route /metrics. Inspect the live OpenAPI document for methods and wire schemas. |
+| `api.health` | /health | Liveness probe |
+| `api.health-ready` | /health/ready | Readiness probe |
+| `api.health-startup` | /health/startup | Startup complete |
+| `api.metrics` | /metrics | Prometheus metrics |
 | `api.openapi` | OpenAPI contract | The live machine-readable REST contract for the running Omnius daemon. |
 | `api.skills` | Skills API | List and load Omnius and project skills incrementally. |
 | `api.tools` | Tools API | Inspect live tool schemas and invocation metadata, register external tools, and call only tools marked direct-callable. |
-| `api.v1-agents` | /v1/agents | Omnius REST API route /v1/agents. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims` | /v1/aims | Omnius REST API route /v1/aims. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-config-history` | /v1/aims/config-history | Omnius REST API route /v1/aims/config-history. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-data-quality` | /v1/aims/data-quality | Omnius REST API route /v1/aims/data-quality. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-decisions` | /v1/aims/decisions | Omnius REST API route /v1/aims/decisions. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-impact-assessments` | /v1/aims/impact-assessments | Omnius REST API route /v1/aims/impact-assessments. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-incidents` | /v1/aims/incidents | Omnius REST API route /v1/aims/incidents. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-lifecycle` | /v1/aims/lifecycle | Omnius REST API route /v1/aims/lifecycle. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-oversight` | /v1/aims/oversight | Omnius REST API route /v1/aims/oversight. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-policies` | /v1/aims/policies | Omnius REST API route /v1/aims/policies. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-resources` | /v1/aims/resources | Omnius REST API route /v1/aims/resources. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-roles` | /v1/aims/roles | Omnius REST API route /v1/aims/roles. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-suppliers` | /v1/aims/suppliers | Omnius REST API route /v1/aims/suppliers. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-transparency` | /v1/aims/transparency | Omnius REST API route /v1/aims/transparency. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aims-usage` | /v1/aims/usage | Omnius REST API route /v1/aims/usage. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg` | /v1/aiwg | Omnius REST API route /v1/aiwg. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-addons` | /v1/aiwg/addons | Omnius REST API route /v1/aiwg/addons. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-agents` | /v1/aiwg/agents | Omnius REST API route /v1/aiwg/agents. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-agents-name` | /v1/aiwg/agents/{name} | Omnius REST API route /v1/aiwg/agents/{name}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-expand` | /v1/aiwg/expand | Omnius REST API route /v1/aiwg/expand. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-frameworks` | /v1/aiwg/frameworks | Omnius REST API route /v1/aiwg/frameworks. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-frameworks-name` | /v1/aiwg/frameworks/{name} | Omnius REST API route /v1/aiwg/frameworks/{name}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-frameworks-name-content` | /v1/aiwg/frameworks/{name}/content | Omnius REST API route /v1/aiwg/frameworks/{name}/content. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-skills` | /v1/aiwg/skills | Omnius REST API route /v1/aiwg/skills. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-skills-name` | /v1/aiwg/skills/{name} | Omnius REST API route /v1/aiwg/skills/{name}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-aiwg-use` | /v1/aiwg/use | Omnius REST API route /v1/aiwg/use. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-audio-speech` | /v1/audio/speech | Omnius REST API route /v1/audio/speech. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-audio-transcriptions` | /v1/audio/transcriptions | Omnius REST API route /v1/audio/transcriptions. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-audit` | /v1/audit | Omnius REST API route /v1/audit. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-chat` | /v1/chat | Omnius REST API route /v1/chat. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-chat-check-in` | /v1/chat/check-in | Omnius REST API route /v1/chat/check-in. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-chat-completions` | /v1/chat/completions | Omnius REST API route /v1/chat/completions. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-chat-sessions` | /v1/chat/sessions | Omnius REST API route /v1/chat/sessions. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-chat-sessions-id-status` | /v1/chat/sessions/{id}/status | Omnius REST API route /v1/chat/sessions/{id}/status. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-chat-sessions-id-summarize` | /v1/chat/sessions/{id}/summarize | Omnius REST API route /v1/chat/sessions/{id}/summarize. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-chat-suggest-followup` | /v1/chat/suggest-followup | Omnius REST API route /v1/chat/suggest-followup. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-codegraph-events` | /v1/codegraph/events | Omnius REST API route /v1/codegraph/events. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-codegraph-snapshot` | /v1/codegraph/snapshot | Omnius REST API route /v1/codegraph/snapshot. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-commands` | /v1/commands | Omnius REST API route /v1/commands. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-commands-cmd` | /v1/commands/{cmd} | Omnius REST API route /v1/commands/{cmd}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-config` | /v1/config | Omnius REST API route /v1/config. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-config-endpoint` | /v1/config/endpoint | Omnius REST API route /v1/config/endpoint. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-config-endpoint-test` | /v1/config/endpoint/test | Omnius REST API route /v1/config/endpoint/test. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-config-model` | /v1/config/model | Omnius REST API route /v1/config/model. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-config-model-check` | /v1/config/model/check | Omnius REST API route /v1/config/model/check. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-context` | /v1/context | Omnius REST API route /v1/context. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-context-compact` | /v1/context/compact | Omnius REST API route /v1/context/compact. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-context-restore` | /v1/context/restore | Omnius REST API route /v1/context/restore. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-context-save` | /v1/context/save | Omnius REST API route /v1/context/save. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-context-window-dumps` | /v1/context/window-dumps | Omnius REST API route /v1/context/window-dumps. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-context-window-dumps-id` | /v1/context/window-dumps/{id} | Omnius REST API route /v1/context/window-dumps/{id}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-cost` | /v1/cost | Omnius REST API route /v1/cost. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-discovery` | /v1/discovery | Omnius REST API route /v1/discovery. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-discovery-id` | /v1/discovery/{id} | Omnius REST API route /v1/discovery/{id}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-embeddings` | /v1/embeddings | Omnius REST API route /v1/embeddings. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-engines` | /v1/engines | Omnius REST API route /v1/engines. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-evaluate` | /v1/evaluate | Omnius REST API route /v1/evaluate. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-events` | /v1/events | Omnius REST API route /v1/events. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-files` | /v1/files | Omnius REST API route /v1/files. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-files-read` | /v1/files/read | Omnius REST API route /v1/files/read. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-hooks` | /v1/hooks | Omnius REST API route /v1/hooks. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-index` | /v1/index | Omnius REST API route /v1/index. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-keys` | /v1/keys | Omnius REST API route /v1/keys. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-keys-prefix` | /v1/keys/{prefix} | Omnius REST API route /v1/keys/{prefix}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-mcps` | /v1/mcps | Omnius REST API route /v1/mcps. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-mcps-name` | /v1/mcps/{name} | Omnius REST API route /v1/mcps/{name}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-mcps-name-call` | /v1/mcps/{name}/call | Omnius REST API route /v1/mcps/{name}/call. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-audio` | /v1/media/audio | Omnius REST API route /v1/media/audio. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-av-analyze` | /v1/media/av/analyze | Omnius REST API route /v1/media/av/analyze. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-file` | /v1/media/file | Omnius REST API route /v1/media/file. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-gallery` | /v1/media/gallery | Omnius REST API route /v1/media/gallery. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-image` | /v1/media/image | Omnius REST API route /v1/media/image. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-migrate` | /v1/media/migrate | Omnius REST API route /v1/media/migrate. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-models` | /v1/media/models | Omnius REST API route /v1/media/models. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-music` | /v1/media/music | Omnius REST API route /v1/media/music. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-relocate` | /v1/media/relocate | Omnius REST API route /v1/media/relocate. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-relocate-status` | /v1/media/relocate/status | Omnius REST API route /v1/media/relocate/status. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-store` | /v1/media/store | Omnius REST API route /v1/media/store. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-media-video` | /v1/media/video | Omnius REST API route /v1/media/video. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-memory` | /v1/memory | Omnius REST API route /v1/memory. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-memory-episodes` | /v1/memory/episodes | Omnius REST API route /v1/memory/episodes. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-memory-failures` | /v1/memory/failures | Omnius REST API route /v1/memory/failures. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-memory-search` | /v1/memory/search | Omnius REST API route /v1/memory/search. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-memory-write` | /v1/memory/write | Omnius REST API route /v1/memory/write. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-models` | /v1/models | Omnius REST API route /v1/models. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-nexus-status` | /v1/nexus/status | Omnius REST API route /v1/nexus/status. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-ollama-pool-cleanup` | /v1/ollama/pool/cleanup | Omnius REST API route /v1/ollama/pool/cleanup. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-ollama-pool-processes` | /v1/ollama/pool/processes | Omnius REST API route /v1/ollama/pool/processes. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-profiles` | /v1/profiles | Omnius REST API route /v1/profiles. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-profiles-name` | /v1/profiles/{name} | Omnius REST API route /v1/profiles/{name}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-projects` | /v1/projects | Omnius REST API route /v1/projects. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-projects-current` | /v1/projects/current | Omnius REST API route /v1/projects/current. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-projects-preferences` | /v1/projects/preferences | Omnius REST API route /v1/projects/preferences. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-projects-register` | /v1/projects/register | Omnius REST API route /v1/projects/register. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-projects-rename` | /v1/projects/rename | Omnius REST API route /v1/projects/rename. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-projects-switch` | /v1/projects/switch | Omnius REST API route /v1/projects/switch. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-run` | /v1/run | Omnius REST API route /v1/run. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-runs` | /v1/runs | Omnius REST API route /v1/runs. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-runs-id` | /v1/runs/{id} | Omnius REST API route /v1/runs/{id}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-scheduled` | /v1/scheduled | Omnius REST API route /v1/scheduled. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-scheduled-all` | /v1/scheduled/all | Omnius REST API route /v1/scheduled/all. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-scheduled-fixup` | /v1/scheduled/fixup | Omnius REST API route /v1/scheduled/fixup. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-scheduled-kill` | /v1/scheduled/kill | Omnius REST API route /v1/scheduled/kill. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-scheduled-reconcile` | /v1/scheduled/reconcile | Omnius REST API route /v1/scheduled/reconcile. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-scheduled-status` | /v1/scheduled/status | Omnius REST API route /v1/scheduled/status. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-services-systemd` | /v1/services/systemd | Omnius REST API route /v1/services/systemd. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-sessions` | /v1/sessions | Omnius REST API route /v1/sessions. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-sessions-id` | /v1/sessions/{id} | Omnius REST API route /v1/sessions/{id}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-skills` | /v1/skills | Omnius REST API route /v1/skills. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-skills-name` | /v1/skills/{name} | Omnius REST API route /v1/skills/{name}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-sponsors` | /v1/sponsors | Omnius REST API route /v1/sponsors. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-system` | /v1/system | Omnius REST API route /v1/system. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-todos` | /v1/todos | Omnius REST API route /v1/todos. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-todos-session-id` | /v1/todos/{session_id} | Omnius REST API route /v1/todos/{session_id}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-tools` | /v1/tools | Omnius REST API route /v1/tools. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-tools-name` | /v1/tools/{name} | Omnius REST API route /v1/tools/{name}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-tools-name-call` | /v1/tools/{name}/call | Omnius REST API route /v1/tools/{name}/call. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-tools-name-eval` | /v1/tools/{name}/eval | Omnius REST API route /v1/tools/{name}/eval. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-tools-register` | /v1/tools/register | Omnius REST API route /v1/tools/register. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-update` | /v1/update | Omnius REST API route /v1/update. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-usage` | /v1/usage | Omnius REST API route /v1/usage. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-vision-describe` | /v1/vision/describe | Omnius REST API route /v1/vision/describe. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-asr` | /v1/voice/asr | Omnius REST API route /v1/voice/asr. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-asr-models` | /v1/voice/asr-models | Omnius REST API route /v1/voice/asr-models. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-asr-models-switch` | /v1/voice/asr-models/switch | Omnius REST API route /v1/voice/asr-models/switch. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-clone-refs` | /v1/voice/clone-refs | Omnius REST API route /v1/voice/clone-refs. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-clone-refs-filename` | /v1/voice/clone-refs/{filename} | Omnius REST API route /v1/voice/clone-refs/{filename}. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-clone-refs-filename-activate` | /v1/voice/clone-refs/{filename}/activate | Omnius REST API route /v1/voice/clone-refs/{filename}/activate. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-clone-refs-filename-rename` | /v1/voice/clone-refs/{filename}/rename | Omnius REST API route /v1/voice/clone-refs/{filename}/rename. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-clone-refs-from-url` | /v1/voice/clone-refs/from-url | Omnius REST API route /v1/voice/clone-refs/from-url. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-clone-refs-upload` | /v1/voice/clone-refs/upload | Omnius REST API route /v1/voice/clone-refs/upload. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-models` | /v1/voice/models | Omnius REST API route /v1/voice/models. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-models-switch` | /v1/voice/models/switch | Omnius REST API route /v1/voice/models/switch. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-speak` | /v1/voice/speak | Omnius REST API route /v1/voice/speak. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-start` | /v1/voice/start | Omnius REST API route /v1/voice/start. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-state` | /v1/voice/state | Omnius REST API route /v1/voice/state. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-stop` | /v1/voice/stop | Omnius REST API route /v1/voice/stop. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-supertonic-settings` | /v1/voice/supertonic-settings | Omnius REST API route /v1/voice/supertonic-settings. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-transcribe` | /v1/voice/transcribe | Omnius REST API route /v1/voice/transcribe. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-transcribe-stream` | /v1/voice/transcribe/stream | Omnius REST API route /v1/voice/transcribe/stream. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voice-tts` | /v1/voice/tts | Omnius REST API route /v1/voice/tts. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.v1-voicechat-ws` | /v1/voicechat/ws | Omnius REST API route /v1/voicechat/ws. Inspect the live OpenAPI document for methods and wire schemas. |
-| `api.version` | /version | Omnius REST API route /version. Inspect the live OpenAPI document for methods and wire schemas. |
+| `api.v1-agents` | /v1/agents | List agent types |
+| `api.v1-aims` | /v1/aims | AIMS root — control map and endpoint index |
+| `api.v1-aims-config-history` | /v1/aims/config-history | Configuration change history (A.6.2.8) |
+| `api.v1-aims-data-quality` | /v1/aims/data-quality | Data quality controls (A.7.2) |
+| `api.v1-aims-decisions` | /v1/aims/decisions | Consequential decision log (A.9) |
+| `api.v1-aims-impact-assessments` | /v1/aims/impact-assessments | Impact assessment register (A.5); File an impact assessment (A.5) |
+| `api.v1-aims-incidents` | /v1/aims/incidents | Incident register (A.6.2.8); Raise an incident (A.6.2.8) |
+| `api.v1-aims-lifecycle` | /v1/aims/lifecycle | AI system lifecycle state (A.6) |
+| `api.v1-aims-oversight` | /v1/aims/oversight | Human oversight gates (A.6.2.7) |
+| `api.v1-aims-policies` | /v1/aims/policies | AI policies (ISO 42001 A.2); Replace the policy register (ISO 42001 A.2) |
+| `api.v1-aims-resources` | /v1/aims/resources | Resources inventory (A.4) |
+| `api.v1-aims-roles` | /v1/aims/roles | Roles and responsibilities (A.3) |
+| `api.v1-aims-suppliers` | /v1/aims/suppliers | Third-party supplier inventory (A.10) |
+| `api.v1-aims-transparency` | /v1/aims/transparency | Model cards and transparency info (A.8) |
+| `api.v1-aims-usage` | /v1/aims/usage | AI system usage (A.9 alias of /v1/usage) |
+| `api.v1-aiwg` | /v1/aiwg | AIWG installation root + control map |
+| `api.v1-aiwg-addons` | /v1/aiwg/addons | List AIWG addons |
+| `api.v1-aiwg-agents` | /v1/aiwg/agents | List AIWG agents |
+| `api.v1-aiwg-agents-name` | /v1/aiwg/agents/{name} | Agent definition |
+| `api.v1-aiwg-expand` | /v1/aiwg/expand | Sub-agent unpack a specific AIWG skill or agent on demand |
+| `api.v1-aiwg-frameworks` | /v1/aiwg/frameworks | List AIWG frameworks (paginated) |
+| `api.v1-aiwg-frameworks-name` | /v1/aiwg/frameworks/{name} | Framework details + items |
+| `api.v1-aiwg-frameworks-name-content` | /v1/aiwg/frameworks/{name}/content | Framework content (cascade-tier-aware) |
+| `api.v1-aiwg-skills` | /v1/aiwg/skills | List AIWG skills (paginated) |
+| `api.v1-aiwg-skills-name` | /v1/aiwg/skills/{name} | Skill content |
+| `api.v1-aiwg-use` | /v1/aiwg/use | AIWG cascade activation bundle (aiwg use all equivalent, model-tier sized) |
+| `api.v1-asr-activate` | /v1/asr/activate | Activate and persist an exact ASR engine/model |
+| `api.v1-asr-engines` | /v1/asr/engines | List all ASR engines, models, capabilities, resource requirements, readiness, and active selection |
+| `api.v1-asr-engines-engine-id-setup` | /v1/asr/engines/{engineId}/setup | Install a managed ASR runtime and its pinned weights |
+| `api.v1-asr-selection` | /v1/asr/selection | Read the selected ASR engine/model; Persist and activate an exact ASR selection |
+| `api.v1-asr-status` | /v1/asr/status | Read the selected ASR engine/model and runtime status |
+| `api.v1-asr-test` | /v1/asr/test | Test the selected ASR engine using an uploaded audio sample |
+| `api.v1-asr-transcriptions` | /v1/asr/transcriptions | Transcribe audio with the selected ASR engine |
+| `api.v1-audio-speech` | /v1/audio/speech | OpenAI-compatible alias of /v1/voice/tts (input/voice/response_format names) |
+| `api.v1-audio-transcriptions` | /v1/audio/transcriptions | OpenAI-compatible alias of /v1/asr/transcriptions |
+| `api.v1-audit` | /v1/audit | Query audit log |
+| `api.v1-chat` | /v1/chat | Stateful chat session with full agent tool access (OpenAI-compatible response shape) |
+| `api.v1-chat-check-in` | /v1/chat/check-in | Send a steering check-in to the active chat session — returns model inference + queued steering_packet |
+| `api.v1-chat-completions` | /v1/chat/completions | OpenAI-compatible chat completion (with optional server-side agent loop) |
+| `api.v1-chat-sessions` | /v1/chat/sessions | List active chat sessions |
+| `api.v1-chat-sessions-id-status` | /v1/chat/sessions/{id}/status | Reactive recall: is this session running right now + unseen deltas since ?since=&lt;seq&gt; (running, phase, seq, partial, deltas[]) |
+| `api.v1-chat-sessions-id-summarize` | /v1/chat/sessions/{id}/summarize | Generate + cache an inference-based title/summary for a session — body {force?, root?} |
+| `api.v1-chat-suggest-followup` | /v1/chat/suggest-followup | Suggest one short next-message follow-up for a session (ghost-text input) — body {session_id} |
+| `api.v1-codegraph-events` | /v1/codegraph/events | Code graph live events (SSE) |
+| `api.v1-codegraph-snapshot` | /v1/codegraph/snapshot | Code graph stats + last N events |
+| `api.v1-commands` | /v1/commands | List available slash commands |
+| `api.v1-commands-cmd` | /v1/commands/{cmd} | Execute a slash command (isolated subprocess) |
+| `api.v1-config` | /v1/config | Get daemon configuration and settings; Update configuration (PT-01 full settings surface) |
+| `api.v1-config-endpoint` | /v1/config/endpoint | Current provider endpoint, protocol, and stable provider id; Resolve, persist, and live-reload an inference provider |
+| `api.v1-config-endpoint-test` | /v1/config/endpoint/test | Probe a protocol-resolved provider from the daemon process |
+| `api.v1-config-model` | /v1/config/model | Current model; Switch model |
+| `api.v1-config-model-check` | /v1/config/model/check | Probe configured model readiness |
+| `api.v1-context` | /v1/context | Show current session context |
+| `api.v1-context-compact` | /v1/context/compact | Request context compaction (event-driven) |
+| `api.v1-context-restore` | /v1/context/restore | Build a restore prompt from saved context |
+| `api.v1-context-save` | /v1/context/save | Save a session context entry |
+| `api.v1-context-window-dumps` | /v1/context/window-dumps | List persisted outbound model context-window dumps |
+| `api.v1-context-window-dumps-id` | /v1/context/window-dumps/{id} | Fetch a full outbound model context-window dump |
+| `api.v1-cost` | /v1/cost | Cost tracker (pricing model) |
+| `api.v1-discovery` | /v1/discovery | Discover Omnius layers, workflows, runtimes, modules, stores, capabilities, tools, APIs, commands, skills, and docs |
+| `api.v1-discovery-bootstrap` | /v1/discovery/bootstrap | Get the compact agent bootstrap, profiles, common intents, live checks, and expanded start-here entries |
+| `api.v1-discovery-id` | /v1/discovery/{id} | Expand one Omnius discovery entry and its downstream references |
+| `api.v1-embeddings` | /v1/embeddings | Generate embeddings |
+| `api.v1-engines` | /v1/engines | List long-running engines |
+| `api.v1-evaluate` | /v1/evaluate | Evaluate a run by ID |
+| `api.v1-events` | /v1/events | Subscribe to the event bus (PT-06) |
+| `api.v1-files` | /v1/files | List workspace directory |
+| `api.v1-files-read` | /v1/files/read | Read file content (PT-05) |
+| `api.v1-hooks` | /v1/hooks | List hook types and counts |
+| `api.v1-index` | /v1/index | Trigger repository indexing |
+| `api.v1-keys` | /v1/keys | List runtime API keys (admin scope); Mint a new runtime API key (admin scope) |
+| `api.v1-keys-prefix` | /v1/keys/{prefix} | Revoke a runtime key by prefix (admin scope) |
+| `api.v1-mcps` | /v1/mcps | List MCP servers (PT-03) |
+| `api.v1-mcps-name` | /v1/mcps/{name} | Get MCP server details (PT-03) |
+| `api.v1-mcps-name-call` | /v1/mcps/{name}/call | Invoke a tool on an MCP server (PT-03) |
+| `api.v1-media-audio` | /v1/media/audio | Generate a sound effect — body {prompt, model?, backend?, duration?, seed?} |
+| `api.v1-media-av-analyze` | /v1/media/av/analyze | Analyze a media file into a grounded entity/event/evidence answer (AV entity-comprehension) — body {path\|mediaUri, question?}; reports per-role live-vs-mock adapter status |
+| `api.v1-media-file` | /v1/media/file | Stream one generated media file — query {kind, name} |
+| `api.v1-media-gallery` | /v1/media/gallery | List previously generated media from the global store, newest first |
+| `api.v1-media-image` | /v1/media/image | Generate an image — body {prompt, model?, backend?, width?, height?, steps?, guidance?, seed?, aspect_ratio?} |
+| `api.v1-media-migrate` | /v1/media/migrate | Dedup + migrate legacy per-group media caches into the unified store — body {dryRun?, roots?, maxDepth?} |
+| `api.v1-media-models` | /v1/media/models | List available generative media models per kind (image/video/audio/music) |
+| `api.v1-media-music` | /v1/media/music | Generate music — body {prompt, model?, backend?, duration?, seed?} |
+| `api.v1-media-relocate` | /v1/media/relocate | Relocate the whole media store (weights/venvs/gallery) to a chosen folder — body {newRoot, dryRun?}; streams media.relocate_progress and returns 202 + job_id |
+| `api.v1-media-relocate-status` | /v1/media/relocate/status | Status of the in-flight (or last) media-store relocation job |
+| `api.v1-media-store` | /v1/media/store | Media-store root + disk usage plus any legacy per-group caches still reclaimable |
+| `api.v1-media-video` | /v1/media/video | Generate a video — body {prompt, model?, backend?, num_frames?, fps?, width?, height?, steps?, guidance?, seed?} |
+| `api.v1-memory` | /v1/memory | Memory backends summary (PT-04) |
+| `api.v1-memory-episodes` | /v1/memory/episodes | List episodes |
+| `api.v1-memory-failures` | /v1/memory/failures | List failures |
+| `api.v1-memory-search` | /v1/memory/search | Search memory stores (PT-04) |
+| `api.v1-memory-write` | /v1/memory/write | Write a memory entry (PT-04) |
+| `api.v1-models` | /v1/models | List aggregated models |
+| `api.v1-nexus-status` | /v1/nexus/status | Nexus peer state |
+| `api.v1-ollama-pool-cleanup` | /v1/ollama/pool/cleanup | Clean up stale Ollama pool processes |
+| `api.v1-ollama-pool-processes` | /v1/ollama/pool/processes | Scan local Ollama pool processes |
+| `api.v1-profiles` | /v1/profiles | List tool profiles; Create tool profile |
+| `api.v1-profiles-name` | /v1/profiles/{name} | Get profile; Delete profile |
+| `api.v1-projects` | /v1/projects | List registered project workspaces + current selection; Unregister a project — body {root} |
+| `api.v1-projects-current` | /v1/projects/current | Get the active project |
+| `api.v1-projects-preferences` | /v1/projects/preferences | Get per-project UI preferences (model, theme, current chat session id, current agent run id, recent indexes); Patch preferences (server-managed v + updatedAt are stripped from client patches); Reset preferences to default |
+| `api.v1-projects-register` | /v1/projects/register | Register a project root — body {root, pid?} |
+| `api.v1-projects-rename` | /v1/projects/rename | Rename a project — body {root, name} |
+| `api.v1-projects-switch` | /v1/projects/switch | Set the active project — body {root, registerIfMissing?} |
+| `api.v1-run` | /v1/run | Submit agentic task |
+| `api.v1-runs` | /v1/runs | List runs |
+| `api.v1-runs-id` | /v1/runs/{id} | Get run details; Abort run |
+| `api.v1-scheduled` | /v1/scheduled | List scheduled jobs |
+| `api.v1-scheduled-all` | /v1/scheduled/all | List all scheduled jobs (all queues) |
+| `api.v1-scheduled-fixup` | /v1/scheduled/fixup | Reconcile scheduled job state |
+| `api.v1-scheduled-kill` | /v1/scheduled/kill | Kill a running scheduled job |
+| `api.v1-scheduled-reconcile` | /v1/scheduled/reconcile | Force-reconcile scheduled jobs against persisted state |
+| `api.v1-scheduled-status` | /v1/scheduled/status | Status of scheduled job runner |
+| `api.v1-services-systemd` | /v1/services/systemd | Systemd service status (where supported) |
+| `api.v1-sessions` | /v1/sessions | List Omnius task sessions |
+| `api.v1-sessions-id` | /v1/sessions/{id} | Get session history |
+| `api.v1-skills` | /v1/skills | List AIWG skills (PT-02) |
+| `api.v1-skills-name` | /v1/skills/{name} | Get skill content (PT-02) |
+| `api.v1-sponsors` | /v1/sponsors | Local sponsor directory cache |
+| `api.v1-system` | /v1/system | System info + GPU/RAM/CPU |
+| `api.v1-todos` | /v1/todos | List sessions that have todo lists; Write/replace the todo list for a session |
+| `api.v1-todos-session-id` | /v1/todos/{session_id} | Read the todo list for a session; Delete the todo list for a session |
+| `api.v1-tools` | /v1/tools | List agentic tool registry with security metadata |
+| `api.v1-tools-name` | /v1/tools/{name} | Single tool schema + security policy; Unregister an external tool (run scope) |
+| `api.v1-tools-name-call` | /v1/tools/{name}/call | Execute a single tool directly (MCP-style, no agent loop) |
+| `api.v1-tools-name-eval` | /v1/tools/{name}/eval | Evaluate an external tool against test cases (dev cycle) |
+| `api.v1-tools-register` | /v1/tools/register | Register an application-specific external tool (run scope) |
+| `api.v1-update` | /v1/update | Global Omnius update transaction status; Start an exact-version global Omnius update |
+| `api.v1-usage` | /v1/usage | Token usage and rate limits |
+| `api.v1-vision-describe` | /v1/vision/describe | Vision describe (deferred to PT-07) |
+| `api.v1-voice-asr` | /v1/voice/asr | Legacy alias of /v1/asr/transcriptions |
+| `api.v1-voice-asr-models` | /v1/voice/asr-models | Compatibility alias of GET /v1/asr/engines |
+| `api.v1-voice-asr-models-switch` | /v1/voice/asr-models/switch | Compatibility alias of POST /v1/asr/activate |
+| `api.v1-voice-clone-refs` | /v1/voice/clone-refs | List voice clone references; Upload a voice clone reference (JSON+base64) |
+| `api.v1-voice-clone-refs-filename` | /v1/voice/clone-refs/{filename} | Delete a voice clone reference |
+| `api.v1-voice-clone-refs-filename-activate` | /v1/voice/clone-refs/{filename}/activate | Set this clone reference as the active LuxTTS clone target |
+| `api.v1-voice-clone-refs-filename-rename` | /v1/voice/clone-refs/{filename}/rename | Rename the friendly name (filename unchanged) — body {name} |
+| `api.v1-voice-clone-refs-from-url` | /v1/voice/clone-refs/from-url | Fetch a voice clone reference from a URL |
+| `api.v1-voice-clone-refs-upload` | /v1/voice/clone-refs/upload | Upload a voice clone reference (raw bytes) |
+| `api.v1-voice-models` | /v1/voice/models | List TTS voice models with backend-specific metadata |
+| `api.v1-voice-models-switch` | /v1/voice/models/switch | Switch and enable the active TTS model — body {modelId, enable?} |
+| `api.v1-voice-speak` | /v1/voice/speak | Synthesize text and broadcast to /v1/voicechat/ws clients (no audio in response body) |
+| `api.v1-voice-start` | /v1/voice/start | Enable and warm the daemon voice runtime; optional body {modelId\|model\|voice} |
+| `api.v1-voice-state` | /v1/voice/state | Voice runtime status (engine load state, active model, current clone ref, client count) |
+| `api.v1-voice-stop` | /v1/voice/stop | Pause daemon voice input immediately (TTS models remain warm) |
+| `api.v1-voice-supertonic-settings` | /v1/voice/supertonic-settings | Read Supertonic3 voice style settings and options; Update Supertonic3 voice style settings |
+| `api.v1-voice-transcribe` | /v1/voice/transcribe | Transcribe an uploaded audio file |
+| `api.v1-voice-transcribe-stream` | /v1/voice/transcribe/stream | Isolated final ASR over Server-Sent Events |
+| `api.v1-voice-tts` | /v1/voice/tts | Synthesize text to audio bytes |
+| `api.v1-voicechat-ws` | /v1/voicechat/ws | WebSocket — full-duplex voicechat (binary PCM + JSON control) |
+| `api.version` | /version | Package, API, and discovery contract versions |
 
 ## Capability
 
 | ID | Title | Summary |
 | --- | --- | --- |
-| `addon.omnius-docs` | Omnius Documentation | Project-local Omnius documentation bundle for discover-then-expand agent workflows. |
+| `addon.omnius-docs` | Omnius Documentation | Project-local Omnius agent onboarding, system map, and discover-then-expand documentation bundle. |
 | `addon.omnius-rest-docs` | Omnius REST Documentation | Project-local Omnius REST API documentation bundle for discover-then-expand agent workflows. |
 | `capability.bring-your-own-inference` | Bring your own inference | Connect local runtimes, Claude, Gemini, and registered OpenAI-compatible providers through explicit protocol and credential descriptors. |
 | `capability.osint-research` | Categorized OSINT research | Discover a compact ranked shortlist from the bundled 77-category OSINT4ALL snapshot, expand one exact resource, then deliberately route it through an appropriate web tool with provenance and safety guidance. |
-| `overview` | Omnius capability overview | Start here to discover Omnius providers, tools, APIs, commands, skills, configuration, operations, and shipped documentation. |
+| `overview` | Omnius agent bootstrap | The canonical first stop for discovering Omnius by intent, choosing the correct surface, locating ownership and state, and verifying live behavior without guessing. |
 
 ## Command
 
 | ID | Title | Summary |
 | --- | --- | --- |
-| `command.access` | /access | Set access policy (OMNIUS_ACCESS) and restart daemon |
-| `command.apikey` | /apikey | Rotate to a new API key (regenerate) |
+| `command.access` | /access | Show access policy and host binding |
+| `command.apikey` | /apikey | Show current API key (for pasting into Web UI / clients) |
 | `command.approve` | /approve | Approve a pending gateway/admin action |
 | `command.background` | /background | Run a prompt in an independent background session |
-| `command.bg` | /bg | Alias for /background &lt;prompt&gt; |
 | `command.bless` | /bless | End blessed mode + DMN |
-| `command.broker` | /broker | Tune broker thresholds (RAM/VRAM in MB, idle in seconds) |
+| `command.broker` | /broker | Show resource broker status — loaded models, in-flight loads, RAM/VRAM headroom |
 | `command.browser` | /browser | Manage browser-agent connectivity |
 | `command.bruteforce` | /bruteforce | Toggle brute-force mode (auto re-engage on turn limit) |
 | `command.call` | /call | Start voice call session (cloudflared tunnel + ASR/TTS) |
-| `command.camera` | /camera | Manage camera source, preview, resolution, FPS, and orientation |
+| `command.camera` | /camera | Open compact camera preset menu shared with /live |
 | `command.capabilities` | List machine capabilities | Print the complete Omnius discovery catalog for programmatic use. |
-| `command.cg` | /cg | Alias for /codegraph |
 | `command.clear` | /clear | Clear the screen |
-| `command.cmds` | /cmds | Alias for /commands auto |
-| `command.codegraph` | /codegraph | Subscribe to live code-graph events for N seconds (default 30) |
-| `command.cohere` | /cohere | Hide a model from remote COHERE queries |
+| `command.codegraph` | /codegraph | Code-graph snapshot: stats, top files, recent activity |
+| `command.cohere` | /cohere | Toggle COHERE cognitive commons - join distributed memory/identity mesh |
 | `command.color` | /color | Show or configure terminal colors/theme |
-| `command.commands` | /commands | Slash commands are user-only (default) |
-| `command.compact` | /compact | Compact with strategy: aggressive, decisions, errors, summary, structured |
+| `command.commands` | /commands | Allow agent to invoke slash commands as tools |
+| `command.compact` | /compact | Force context compaction now (default strategy) |
 | `command.config` | /config | Show current configuration |
-| `command.context` | /context | Show saved session context status |
+| `command.context` | /context | Force-save session context to .omnius/context/ |
 | `command.cost` | /cost | Show session token cost breakdown |
-| `command.cron` | /cron | Run scheduler tick |
-| `command.daemon` | /daemon | Control the local API daemon |
-| `command.debug` | /debug | Hide trust_tier wrappers and REG fires (default) |
+| `command.cron` | /cron | Cron/scheduled job management |
+| `command.daemon` | /daemon | Show or manage the local API daemon |
+| `command.debug` | /debug | Toggle debug mode — show/hide trust_tier wrappers and REG fires |
 | `command.deep` | /deep | Toggle deep context - relaxes compaction so large models use 85% of context |
 | `command.deny` | /deny | Deny a pending gateway/admin action |
-| `command.destroy` | /destroy | Remove .omnius folder, kill all tasks, clear console, and exit |
+| `command.destroy` | /destroy | Find and kill orphaned Omnius child processes (this project) |
 | `command.discover` | Discover capabilities | Rank Omnius capabilities by intent, with optional kind and result limits. |
 | `command.docs` | Open the documentation overview | Print the human-readable Omnius documentation and discovery entrypoints. |
-| `command.dream` | /dream | Wake up - stop dreaming |
+| `command.dream` | /dream | Start dream mode - creative idle exploration (writes to .omnius/dreams/) |
 | `command.emojis` | /emojis | Toggle emoji rendering in TUI messages |
-| `command.endpoint` | /endpoint | Browse and connect to sponsored inference from the nexus mesh |
+| `command.endpoint` | /endpoint | Show current endpoint |
 | `command.evaluate` | /evaluate | Evaluate last completed task (LLM quality scoring) |
-| `command.expose` | /expose | Stop libp2p gateway only |
-| `command.files` | /files | Open searchable workspace file selector |
+| `command.expose` | /expose | Expose local inference via libp2p (default) |
+| `command.files` | /files | Show searchable working-directory file overview |
 | `command.flow` | /flow | Toggle FlowState protocol - immediate action, tight loops, goal clarity |
 | `command.fortemi` | /fortemi | Manage Fortemi React bridge integration |
 | `command.full-send-bless` | /full-send-bless | Infinite warm loop - DMN self-reflection chains tasks autonomously |
-| `command.gateway` | /gateway | Alias for /platforms menu |
 | `command.hangup` | /hangup | End active call session |
 | `command.help` | /help | Show this help |
-| `command.hf` | /hf | Cancel any pending HF token prompt and fall back immediately |
+| `command.hf` | /hf | Show HF token status (set / not set) |
 | `command.host` | /host | Set bind host:port (OMNIUS_HOST) and restart daemon |
-| `command.image` | /image | List image models by category, quality, size, and hardware fit |
-| `command.indicator` | /indicator | Report native system indicator readiness and daemon health |
+| `command.image` | /image | Open image-generation model/setup menu |
+| `command.indicator` | /indicator | Start the native system indicator and report readiness |
 | `command.ingest` | /ingest | Ingest an audio, PDF, or text file into memory |
 | `command.init` | Initialize agent discovery guidance | Create or update managed Omnius discovery blocks in project guidance while preserving user content. |
 | `command.insights` | /insights | Show historical session insights |
-| `command.ipfs` | /ipfs | Import a shared IPFS tool or skill reference |
-| `command.k` | /k | Quick network access helper |
-| `command.key` | /key | Alias for /apikey |
-| `command.listen` | /listen | Stop listening |
-| `command.live` | /live | Disable all live sensor streams |
+| `command.ipfs` | /ipfs | Show IPFS/Helia status |
+| `command.listen` | /listen | Toggle live microphone transcription (Whisper) |
+| `command.live` | /live | Open live sensor stream menu for video/audio context |
 | `command.livechat` | /livechat | Alias for /live chat, used by the top live button |
-| `command.mcp` | /mcp | Reload MCP servers and tools |
-| `command.memory` | /memory | Show temporal timeline view |
+| `command.mcp` | /mcp | Show MCP server/tool status and controls |
+| `command.memory` | /memory | Toggle memory visualizer - graph/episodes/concepts/timeline |
 | `command.metabolize` | /metabolize | Run memory maintenance: import deferred memory, prune episodes, compact graph stores |
 | `command.metrics` | /metrics | Show runtime metrics: tokens, context window, throughput, and tool usage |
-| `command.mic` | /mic | Alias for /listen |
-| `command.model` | /model | Switch to a specific model |
-| `command.models` | /models | Preview /models cleanup without touching disk |
+| `command.model` | /model | Select from available models |
+| `command.models` | /models | List all available models |
 | `command.mouse` | /mouse | Toggle terminal mouse tracking |
-| `command.music` | /music | List music models by category, quality, size, and hardware fit |
-| `command.neovim` | /neovim | Open file in embedded Neovim editor |
-| `command.network` | /network | Interactive network access menu |
-| `command.nexus` | /nexus | Show wallet address and x402 payment status |
-| `command.nvim` | /nvim | Alias for /neovim &lt;file&gt; |
-| `command.ollama` | /ollama | Terminate guarded stale Ollama pool runners |
-| `command.p2p` | /p2p | Leave the mesh network |
-| `command.parallel` | /parallel | Set parallel slots (restarts Ollama, max 15) |
+| `command.music` | /music | Open music-generation model/setup menu |
+| `command.neovim` | /neovim | Toggle embedded Neovim editor (Ctrl+N to switch focus) |
+| `command.network` | /network | Quick network access helper |
+| `command.nexus` | /nexus | Show nexus P2P network status |
+| `command.ollama` | /ollama | Dry-run stale Ollama pool process cleanup |
+| `command.p2p` | /p2p | Join the P2P agent mesh network |
+| `command.parallel` | /parallel | Show current Ollama parallel inference slots |
 | `command.paste` | /paste | Attach clipboard image content to the current or next prompt |
 | `command.pause` | /pause | Pause after current turn finishes (gentle halt, /resume to continue) |
-| `command.pcl` | /pcl | Alias for /pointcloud |
 | `command.personality` | /personality | Alias family for response style/personality controls |
-| `command.platforms` | /platforms | Clear saved adapter token, token-env, base-url, or target |
+| `command.platforms` | /platforms | Show gateway platform state |
 | `command.plugins` | /plugins | List or manage plugins |
-| `command.pointcloud` | /pointcloud | Download and warm up the selected depth model |
-| `command.points` | /points | Alias for /pointcloud |
+| `command.pointcloud` | /pointcloud | Open point-cloud generation model/setup menu |
 | `command.prompt` | /prompt | Show or edit the active prompt template |
 | `command.provider` | /provider | Show or select provider profile |
-| `command.prune` | /prune | Shrink knowledge.db in the background: evict low-signal graph nodes (archived), then VACUUM.  |
-| `command.q` | /q | Alias for /queue &lt;prompt&gt; |
+| `command.prune` | /prune | Shrink knowledge.db in the background: evict low-signal graph nodes (archived), then VACUUM. 'infer' = model-guided sleep consolidation. No arg shows stats + usage |
 | `command.queue` | /queue | Queue a prompt for the next turn without interrupting the current run |
 | `command.quit` | /quit | Exit omnius |
-| `command.realtime` | /realtime | Set or inspect realtime conversation mode |
+| `command.realtime` | /realtime | Toggle short spoken-dialogue mode for ASR/TTS-backed chat |
 | `command.reasoning` | /reasoning | Alias family for thinking/reasoning controls |
 | `command.reload-mcp` | /reload-mcp | Reload MCP servers and tools |
-| `command.remind` | /remind | Set a scoped minimal reminder with a relative due time |
 | `command.reminder` | /reminder | List scoped TUI reminders |
-| `command.reminders` | /reminders | Alias for /reminder |
 | `command.resume` | /resume | Resume a paused/stopped task or named saved session when available |
 | `command.retry` | /retry | Retry the last submitted request |
 | `command.rollback` | /rollback | List checkpoints or restore an explicit checkpoint when policy allows |
-| `command.sb` | /sb | Alias for /statusbar |
-| `command.scheduler` | /scheduler | Kill schedulers + active runs (with escalation if needed) |
+| `command.scheduler` | /scheduler | Scheduled tasks control panel (list/kill/toggle) |
 | `command.score` | /score | Show inference capability scorecard (memory, compute, speed, models) |
-| `command.secrets` | /secrets | Remove a registered secret |
-| `command.selfmodify` | /selfmodify | Show current self-modify mode |
+| `command.secrets` | /secrets | List registered secrets |
+| `command.selfmodify` | /selfmodify | Toggle agent self-modify mode for natural-language runtime commands |
 | `command.sessions` | /sessions | Browse saved sessions |
 | `command.sethome` | /sethome | Set the project home for gateway/session use |
 | `command.setup` | /setup | Run the initial setup wizard again |
 | `command.show` | Show a capability | Expand one Omnius discovery entry by stable ID. |
-| `command.skill` | /skill | Alias for /skills |
 | `command.skillify` | /skillify | Extract a reusable skill from the current session |
-| `command.skills` | /skills | Filter skills by name or trigger |
+| `command.skills` | /skills | List available AIWG skills |
 | `command.skin` | /skin | Configure the visual skin/theme bundle |
-| `command.sound` | /sound | List sound models by category, quality, size, and hardware fit |
-| `command.sponsor` | /sponsor | Remove sponsorship entirely |
+| `command.sound` | /sound | Open sound-effect model/setup menu |
+| `command.sponsor` | /sponsor | Sponsor inference - onboarding wizard or dashboard |
 | `command.stats` | /stats | Show session dashboard (metrics, tool usage, task history) |
 | `command.status` | /status | Show overall runtime status |
 | `command.statusbar` | /statusbar | Configure the status bar |
 | `command.stop` | /stop | Kill current inference immediately and save state (/resume to continue) |
 | `command.storage` | /storage | Show .omnius storage usage and safety summary |
 | `command.stream` | /stream | Toggle real-time token streaming (pastel syntax highlighting) |
-| `command.style` | /style | Set style: concise, balanced, verbose, pedagogical |
+| `command.style` | /style | Show current response style |
 | `command.task-type` | /task-type | Set task type (code, document, analysis, plan, general, auto) |
-| `command.telegram` | /telegram | Delete recent Telegram message reactions by user or chat |
-| `command.theme` | /theme | Alias for /color |
+| `command.telegram` | /telegram | Save Telegram bot token (persisted to settings) |
 | `command.think` | /think | Toggle thinking/reasoning mode (Qwen3, DeepSeek-R1, etc.) |
 | `command.title` | /title | Show or set the current session title |
 | `command.tools` | /tools | List agent-created custom tools |
 | `command.toolsets` | /toolsets | Show or select tool exposure sets |
 | `command.transcribe` | /transcribe | Alias for /ingest &lt;file&gt; |
-| `command.tray` | /tray | Alias for /indicator status |
-| `command.tree` | /tree | Show, hide, or inspect the action-tree presentation |
+| `command.tree` | /tree | Switch between the action waterfall and an explorable action tree |
 | `command.undo` | /undo | Undo the last queued or saved exchange when available |
-| `command.update` | /update | Run full non-interactive update: package, deps, rebuild, Python, cloudflared |
-| `command.upgrade` | /upgrade | Alias for /update |
+| `command.update` | /update | Check for updates and auto-install |
 | `command.usage` | /usage | Show current session token count and cost |
 | `command.verbose` | /verbose | Toggle verbose mode |
-| `command.video` | /video | Download and warm up the selected video model |
-| `command.vim` | /vim | Alias for /neovim &lt;file&gt; |
-| `command.voice` | /voice | Generate clone ref from Overwatch for LuxTTS/MisoTTS voice cloning |
-| `command.voicechat` | /voicechat | Stop voice chat session |
-| `command.wizard` | /wizard | Alias for /setup |
-| `command.workspace` | /workspace | Alias for /files menu |
+| `command.video` | /video | Open video-generation model/setup menu |
+| `command.voice` | /voice | Toggle TTS voice feedback |
+| `command.voicechat` | /voicechat | Start voice chat session (async voice conversation) |
 
 ## Config
 
@@ -340,128 +350,167 @@ Daemon equivalents are `GET /v1/discovery?q=<intent>` and `GET /v1/discovery/{id
 
 | ID | Title | Summary |
 | --- | --- | --- |
-| `guide.agent-memory-index` | Agent Memory Index | Bundled Omnius documentation artifact: docs/agent-memory/index.md. |
-| `guide.agent-memory-index-uppercase` | Agent-Explorable Documentation | Bundled Omnius documentation artifact: docs/agent-memory/INDEX.md. |
-| `guide.architecture-overview` | Architecture Overview | Bundled Omnius documentation artifact: docs/architecture/overview.md. |
-| `guide.concept-relational-language` | Concept Relational Language (CRL) — Token-Efficient Concept Communication | Bundled Omnius documentation artifact: docs/concept-relational-language.md. |
-| `guide.context-management-medium-models-proposal` | Context Management for Medium Models (30-40B) — Implementation Proposal | Bundled Omnius documentation artifact: docs/context-management-medium-models-proposal.md. |
-| `guide.dedup-false-positive-meta-analysis` | Meta-Analysis: False Positive Duplicate Tool Call Detection | Bundled Omnius documentation artifact: docs/dedup-false-positive-meta-analysis.md. |
+| `guide.agent-memory-index` | Agent Memory Index | Use the Omnius docs skills when an agent needs to explore the documentation corpus instead of loading the whole docs tree. |
+| `guide.agent-memory-index-uppercase` | Agent-Explorable Documentation | Omnius documentation is exposed to agents through project-local AIWG-style bundles under .aiwg/addons/. |
+| `guide.architecture-agent-system-map` | Omnius Agent System Map | Use this page when you need to understand how a user-visible behavior travels through Omnius, where its state lives, and which package owns a change. For a specific task recipe, search the generated catalog first: |
+| `guide.architecture-overview` | Architecture Overview | Omnius combines a terminal-first agent loop, REST daemon, model routing layer, tool runtime, persistent context, and peer mesh. |
+| `guide.concept-relational-language` | Concept Relational Language (CRL) — Token-Efficient Concept Communication | &gt; Experimental hyper-compressed symbolic notation for mind-mapped logical flow tracking |
+| `guide.context-management-medium-models-proposal` | Context Management for Medium Models (30-40B) — Implementation Proposal | Date: 2026-04-25 Problem: Medium-tier models (~35B params) exhibit excessive repetition at ~35% context fill despite 256K context windows Root Cause: Monolithic context structure + attention degradation + tool schema bloat |
+| `guide.dedup-false-positive-meta-analysis` | Meta-Analysis: False Positive Duplicate Tool Call Detection | Date: 2026-05-14 Scope: packages/orchestrator/src/agenticRunner.ts — proactivePrune() + buildResourceKey() |
+| `guide.discovery-agent-map` | Agent Map | Bundled Omnius documentation artifact: docs/discovery/agent-map.json. |
 | `guide.discovery-catalog-overrides` | Discovery Catalog Curated Source | Curated aliases, relationships, invocation modes, and conceptual entries merged into the generated catalog. |
 | `guide.discovery-json` | Omnius Machine Discovery Catalog | Generated JSON catalog consumed by the CLI, REST discovery API, JavaScript API, and offline agents. |
 | `guide.discovery-markdown` | Omnius Discovery Catalog | Human-readable generated index of every discoverable Omnius capability and bundled documentation artifact. |
-| `guide.duplicate-calls-root-cause-analysis` | Duplicate Tool Calls — Root Cause Analysis | Bundled Omnius documentation artifact: docs/duplicate-calls-root-cause-analysis.md. |
-| `guide.duplicate-calls-root-cause-deep` | Duplicate Tool Calls — Deep Root Cause Analysis | Bundled Omnius documentation artifact: docs/duplicate-calls-root-cause-deep.md. |
-| `guide.ephemeral-skill-pack-small-context` | Ephemeral Skill Pack Small-Context Plan | Bundled Omnius documentation artifact: docs/ephemeral-skill-pack-small-context.md. |
-| `guide.explorations-context-window-todo-association` | Exploration: Associating Context-Window Entries with Todo-Scoped Run Periods | Bundled Omnius documentation artifact: docs/explorations/context-window-todo-association.md. |
+| `guide.duplicate-calls-root-cause-analysis` | Duplicate Tool Calls — Root Cause Analysis | The agent repeatedly calls the same tool with the same arguments (e.g., fileread on the same path, grepsearch with the same pattern, shell with the same command). This wastes turns, burns context, and creates visible "looping" behavior. |
+| `guide.duplicate-calls-root-cause-deep` | Duplicate Tool Calls — Deep Root Cause Analysis | The agent repeatedly calls the same tool with the same arguments right after having already called it. This is visible even in this agent's own conversation — fileread and grepsearch calls get duplicated within 1-2 turns. |
+| `guide.ephemeral-skill-pack-small-context` | Ephemeral Skill Pack Small-Context Plan | AIWG and Omnius skills are valuable, but full SKILL.md bodies are too large for small and medium context windows. The main agent should see only a tiny, task-scoped skill manifest, then delegate full skill unpacking to a sub-agent that returns a compact extraction. |
+| `guide.explorations-context-window-todo-association` | Exploration: Associating Context-Window Entries with Todo-Scoped Run Periods | Goal (from user): Understand how granular context-window entries (messages / tool results) are associated with periods of an agentic run, and specifically whether they are tied to a todo item so that, when that todo completes, its context content can be compressed. |
 | `guide.explorations-todo-association-verify` | Todo Association Verify | Bundled Omnius documentation artifact: docs/explorations/todo-association-verify.json. |
 | `guide.explorations-verification-ledger` | Verification Ledger | Bundled Omnius documentation artifact: docs/explorations/verification-ledger.json. |
 | `guide.explorations-verify-todo-association` | Verify Todo Association | Bundled Omnius documentation artifact: docs/explorations/verify-todo-association.sh. |
-| `guide.flowstate` | FLOWSTATE.md | Bundled Omnius documentation artifact: docs/flowstate.md. |
-| `guide.getting-started-first-run` | First Run And Setup | Bundled Omnius documentation artifact: docs/getting-started/first-run.md. |
-| `guide.getting-started-install` | Install Omnius | Bundled Omnius documentation artifact: docs/getting-started/install.md. |
-| `guide.getting-started-model-providers` | Model Providers And Endpoints | Bundled Omnius documentation artifact: docs/getting-started/model-providers.md. |
-| `guide.guides-agent-integration` | Agent And Service Integration | Bundled Omnius documentation artifact: docs/guides/agent-integration.md. |
-| `guide.guides-bring-your-own-inference` | Bring Your Own Inference | Bundled Omnius documentation artifact: docs/guides/bring-your-own-inference.md. |
-| `guide.guides-media-generation` | Media Generation | Bundled Omnius documentation artifact: docs/guides/media-generation.md. |
-| `guide.guides-osint-research` | Categorized OSINT research | Bundled Omnius documentation artifact: docs/guides/osint-research.md. |
-| `guide.guides-realtime` | Realtime Conversations | Bundled Omnius documentation artifact: docs/guides/realtime.md. |
-| `guide.guides-sponsor-and-cohere` | Sponsor And COHERE Mesh | Bundled Omnius documentation artifact: docs/guides/sponsor-and-cohere.md. |
-| `guide.guides-system-tray` | System Tray Indicator | Bundled Omnius documentation artifact: docs/guides/system-tray.md. |
-| `guide.guides-telegram` | Telegram Bridge | Bundled Omnius documentation artifact: docs/guides/telegram.md. |
-| `guide.guides-tools-and-web-search` | Tools And Web Search | Bundled Omnius documentation artifact: docs/guides/tools-and-web-search.md. |
-| `guide.guides-tui-workflows` | TUI Workflows | Bundled Omnius documentation artifact: docs/guides/tui-workflows.md. |
-| `guide.handoff-crl-encoder-decoder-fix-uppercase` | HANDOFF: CRL Encoder/Decoder Bidirectional Fix | Bundled Omnius documentation artifact: docs/HANDOFF-crl-encoder-decoder-fix.md. |
-| `guide.index` | Omnius Documentation | Bundled Omnius documentation artifact: docs/index.md. |
-| `guide.longhaul-35b-workorders` | Work Orders — Long-Haul Implementation on a 35B-Class Model | Bundled Omnius documentation artifact: docs/longhaul-35b-workorders.md. |
-| `guide.memory-integration-analysis` | Memory Integration Analysis — Parallel Systems Gap Assessment | Bundled Omnius documentation artifact: docs/memory-integration-analysis.md. |
-| `guide.model-capability-awareness-and-multimodal-memory-root-fix` | Model Capability Awareness And Multimodal Identity Memory Root Fix | Bundled Omnius documentation artifact: docs/model-capability-awareness-and-multimodal-memory-root-fix.md. |
-| `guide.multimodal-identity-memory-implementation` | Multimodal Identity Memory Implementation Tracker | Bundled Omnius documentation artifact: docs/multimodal-identity-memory-implementation.md. |
-| `guide.omnius-self-edit-eval-2026-06-10` | Omnius Self-Edit Evaluation — Uncommitted Changes &amp; Duplicate-Tool-Call Failure Mode | Bundled Omnius documentation artifact: docs/omnius-self-edit-eval-2026-06-10.md. |
-| `guide.opencode-agentic-loop-comparison` | OpenCode → Omnius: Agentic Loop &amp; Sub-Agent Delegation Comparison | Bundled Omnius documentation artifact: docs/opencode-agentic-loop-comparison.md. |
-| `guide.operations-delay-analysis` | Unnecessary Causes of Delays Between Agent Actions | Bundled Omnius documentation artifact: docs/operations/delay-analysis.md. |
-| `guide.operations-delay-fix-review` | Delay Fix Review — Commits Since Delay Analysis | Bundled Omnius documentation artifact: docs/operations/delay-fix-review.md. |
-| `guide.operations-runtime-hygiene` | Runtime Hygiene | Bundled Omnius documentation artifact: docs/operations/runtime-hygiene.md. |
-| `guide.operations-security-and-remote-access` | Security And Remote Access | Bundled Omnius documentation artifact: docs/operations/security-and-remote-access.md. |
-| `guide.operations-version-compatibility` | Service Version Compatibility | Bundled Omnius documentation artifact: docs/operations/version-compatibility.md. |
-| `guide.proposals-git-progress-tracking-strategy` | Git Progress Tracking Strategy | Bundled Omnius documentation artifact: docs/proposals/git-progress-tracking-strategy.md. |
+| `guide.flowstate` | FLOWSTATE.md | Derived from 18 articles by Rian Doris (Founder &amp; CEO, FlowState.com) and mapped to the Omnius AI execution framework. This document enables any agent to explore systems optimization through the lens of human peak performance neuroscience. |
+| `guide.getting-started-first-run` | First Run And Setup | The setup flow is responsible for choosing a usable model path without assuming local Ollama is the only option. |
+| `guide.getting-started-install` | Install Omnius | This guide gets a machine ready to run Omnius from npm or from the workspace. |
+| `guide.getting-started-model-providers` | Model Providers And Endpoints | Omnius routes model requests through a provider abstraction instead of treating local Ollama as the only source of models. |
+| `guide.guides-agent-integration` | Agent And Service Integration | An integration should discover Omnius at runtime instead of encoding a partial provider or tool list. |
+| `guide.guides-bring-your-own-inference` | Bring Your Own Inference | Omnius routes local and hosted models through an explicit provider descriptor. The descriptor determines the wire protocol, URL paths, authentication headers, and supported operations. It is the source of truth used by setup, model discovery, TUI runs, REST chat, summaries, voice, Telegram, sponsors, and endpoint probes. |
+| `guide.guides-media-generation` | Media Generation | Omnius exposes media generation through TUI commands, tools, Telegram creative workflows, and sponsor media endpoints. |
+| `guide.guides-osint-research` | Categorized OSINT research | Omnius ships a local, searchable snapshot of the OSINT4ALL Start.me page. It uses the same compact discovery pattern as AIWG skills: |
+| `guide.guides-realtime` | Realtime Conversations | Realtime mode is for short, natural, back-and-forth spoken conversation behind ASR and TTS. |
+| `guide.guides-sponsor-and-cohere` | Sponsor And COHERE Mesh | Sponsor and COHERE let Omnius share inference capacity across peers. Sponsor mode is explicit provider/consumer sharing. COHERE is a distributed cognitive inference mesh. |
+| `guide.guides-system-tray` | System Tray Indicator | Omnius ships a native per-login tray indicator for Linux, macOS, and Windows on x64 hosts. It is separate from the REST daemon: closing the indicator never stops the daemon, and the daemon remains usable in headless sessions. |
+| `guide.guides-telegram` | Telegram Bridge | The Telegram bridge is a scoped public ingress and egress layer. It supports admin DMs, admin group mode, public group mode, media intake, generated artifact return, scoped memory, and persona documents. |
+| `guide.guides-tools-and-web-search` | Tools And Web Search | Omnius has two related tool surfaces: |
+| `guide.guides-tui-workflows` | TUI Workflows | The TUI is the primary Omnius control surface for interactive use. |
+| `guide.handoff-crl-encoder-decoder-fix-uppercase` | HANDOFF: CRL Encoder/Decoder Bidirectional Fix | Date: 2026-04-22 Status: Needs Implementation Failing Test: packages/memory/tests/crl-converter.test.ts - "should validate roundtrip accuracy" |
+| `guide.index` | Omnius Documentation | Omnius is an autonomous local-first agent runtime with a TUI, REST daemon, P2P sponsor mesh, Telegram bridge, realtime conversation mode, media generation routes, and AIWG-compatible documentation skills. |
+| `guide.longhaul-35b-workorders` | Work Orders — Long-Haul Implementation on a 35B-Class Model | Origin: Root-cause review of the myactuator ESP32/PlatformIO session (35B ornith-vision) plus a 2026-literature sweep of surprising remedies. See companion analysis in docs/context-management-medium-models-proposal.md and docs/duplicate-calls-root-cause-analysis.md. |
+| `guide.memory-integration-analysis` | Memory Integration Analysis — Parallel Systems Gap Assessment | Date: 2026-04-23 Status: ✅ INTEGRATED — All P0 gaps closed Context: Review of literature on memory compression + integration testing of Omnius parallel memory systems |
+| `guide.model-capability-awareness-and-multimodal-memory-root-fix` | Model Capability Awareness And Multimodal Identity Memory Root Fix | Status: planning and integration tracker |
+| `guide.multimodal-identity-memory-implementation` | Multimodal Identity Memory Implementation Tracker | Goal: make voice, text, image, Telegram reply context, CLIP-like embeddings, zettelkasten links, and social profiles converge on one evidence-based identity substrate. |
+| `guide.omnius-self-edit-eval-2026-06-10` | Omnius Self-Edit Evaluation — Uncommitted Changes &amp; Duplicate-Tool-Call Failure Mode | &gt; Eval of the working-tree changes against docs/opencode-agentic-loop-comparison.md. &gt; Subject: an Omnius instance editing its own orchestrator to implement the P0–P10 &gt; learnings. Generated 2026-06-10. |
+| `guide.opencode-agentic-loop-comparison` | OpenCode → Omnius: Agentic Loop &amp; Sub-Agent Delegation Comparison | &gt; Exhaustive comparison between https://github.com/anomalyco/opencode/tree/dev and &gt; packages/orchestrator/src/agenticRunner.ts (omnius). &gt; Generated 2026-06-10. |
+| `guide.operations-delay-analysis` | Unnecessary Causes of Delays Between Agent Actions | Analysis of packages/orchestrator/src/ (95 files) — identified delay sources ranked by impact. |
+| `guide.operations-delay-fix-review` | Delay Fix Review — Commits Since Delay Analysis | Date: 2026-06-10 Reference: /docs/operations/delay-analysis.md (15 delay sources documented) |
+| `guide.operations-runtime-hygiene` | Runtime Hygiene | Runtime hygiene keeps long-running Omnius instances from accumulating stale state, stuck child processes, or leaked project artifacts. |
+| `guide.operations-security-and-remote-access` | Security And Remote Access | Omnius is local-first by default. Remote access should be explicit, authenticated, and scoped. |
+| `guide.operations-version-compatibility` | Service Version Compatibility | A client may be newer than the long-running Omnius daemon it reaches. The runtime version gate prevents a stale service from quietly accepting work whose provider, tool, or request contract it does not understand. |
+| `guide.proposals-git-progress-tracking-strategy` | Git Progress Tracking Strategy | Use Git as an optional runtime evidence layer for Omnius agent sessions. When a project already has Git, Omnius should track its own mutations with the same discipline a careful implementer uses manually: baseline status, scoped diffs, changed-file summaries, verifier results after changes, and recovery artifacts. |
 | `guide.proposals-opencode-modules-backend-adapter-uppercase` | Backend Adapter | Bundled Omnius documentation artifact: docs/proposals/opencode-modules/backendAdapter.ts. |
 | `guide.proposals-opencode-modules-child-session-uppercase` | Child Session | Bundled Omnius documentation artifact: docs/proposals/opencode-modules/childSession.ts. |
 | `guide.proposals-opencode-modules-compaction-agent-uppercase` | Compaction Agent | Bundled Omnius documentation artifact: docs/proposals/opencode-modules/compactionAgent.ts. |
 | `guide.proposals-opencode-modules-orchestrator` | Orchestrator | Bundled Omnius documentation artifact: docs/proposals/opencode-modules/orchestrator.ts. |
 | `guide.proposals-opencode-modules-runner` | Runner | Bundled Omnius documentation artifact: docs/proposals/opencode-modules/runner.ts. |
-| `guide.reference-auth-map` | Authentication And Authorization Map | Bundled Omnius documentation artifact: docs/reference/auth-map.md. |
-| `guide.reference-configuration` | Configuration Reference | Bundled Omnius documentation artifact: docs/reference/configuration.md. |
-| `guide.reference-rest-api` | REST API Reference | Bundled Omnius documentation artifact: docs/reference/rest-api.md. |
-| `guide.reference-slash-commands` | Slash Commands | Bundled Omnius documentation artifact: docs/reference/slash-commands.md. |
+| `guide.reference-auth-map` | Authentication And Authorization Map | Omnius has two separate credential boundaries: |
+| `guide.reference-configuration` | Configuration Reference | Configuration is layered from environment, global user settings, project settings, and active TUI state. |
+| `guide.reference-rest-api` | REST API Reference | This is the maintained human endpoint inventory for the Omnius daemon. The machine contract is generated by packages/cli/src/api/openapi.ts and served at /openapi.json. |
+| `guide.reference-slash-commands` | Slash Commands | This file is generated from packages/cli/src/tui/command-registry.ts. |
 | `guide.research-archived-context-window-attention-model` | Context Window Attention Model | Bundled Omnius documentation artifact: docs/research/_archived/context_window_attention_model.py. |
-| `guide.research-archived-context-window-attention-spec` | Context Window Attention-Weighted Optimization Spec | Bundled Omnius documentation artifact: docs/research/_archived/context_window_attention_spec.md. |
+| `guide.research-archived-context-window-attention-spec` | Context Window Attention-Weighted Optimization Spec | The context window treats all items (system prompt, memory cards, chat history, voice transcriptions, reflection notes) at roughly equal attention weight (~1.0). This causes: |
 | `guide.research-archived-context-window-attention-weights` | Context Window Attention Weights | Bundled Omnius documentation artifact: docs/research/_archived/context_window_attention_weights.json. |
-| `guide.research-archived-readme-uppercase` | Archived design notes — unwired | Bundled Omnius documentation artifact: docs/research/_archived/README.md. |
+| `guide.research-archived-readme-uppercase` | Archived design notes — unwired | Documents in this directory describe design proposals that were never wired into the runtime. They are kept for historical context only. |
 | `guide.research-k-splanifolds` | K Splanifolds | Bundled Omnius documentation artifact: docs/research/k-splanifolds.pdf. |
-| `guide.research-personality-verbosity-control` | LLM Personality Guidance &amp; Verbosity Control: Research Synthesis | Bundled Omnius documentation artifact: docs/research/personality-verbosity-control.md. |
-| `guide.rest-auth-and-scopes` | Auth And Scopes | Bundled Omnius documentation artifact: docs/rest/auth-and-scopes.md. |
-| `guide.rest-endpoints-aims` | AIMS Governance Endpoints | Bundled Omnius documentation artifact: docs/rest/endpoints/aims.md. |
-| `guide.rest-endpoints-aiwg` | AIWG Cascade Endpoints | Bundled Omnius documentation artifact: docs/rest/endpoints/aiwg.md. |
-| `guide.rest-endpoints-chat` | Chat And Inference Endpoints | Bundled Omnius documentation artifact: docs/rest/endpoints/chat.md. |
-| `guide.rest-endpoints-config` | Config, Endpoints, Keys, Profiles, And Projects | Bundled Omnius documentation artifact: docs/rest/endpoints/config.md. |
-| `guide.rest-endpoints-discovery` | Discovery | Bundled Omnius documentation artifact: docs/rest/endpoints/discovery.md. |
-| `guide.rest-endpoints-events` | Events, Metrics, Usage, Audit, System, Nexus, And Ollama Pool | Bundled Omnius documentation artifact: docs/rest/endpoints/events.md. |
-| `guide.rest-endpoints-files` | Files | Bundled Omnius documentation artifact: docs/rest/endpoints/files.md. |
-| `guide.rest-endpoints-memory` | Memory, Sessions, And Context | Bundled Omnius documentation artifact: docs/rest/endpoints/memory.md. |
-| `guide.rest-endpoints-run` | Runs, Jobs, Todos, And Scheduled Work | Bundled Omnius documentation artifact: docs/rest/endpoints/run.md. |
-| `guide.rest-endpoints-skills` | Skills And Commands | Bundled Omnius documentation artifact: docs/rest/endpoints/skills.md. |
-| `guide.rest-endpoints-tools` | Tools, MCP, Hooks, Agents, And Code Graph | Bundled Omnius documentation artifact: docs/rest/endpoints/tools.md. |
-| `guide.rest-endpoints-voice-vision` | Voice, Audio, Vision, And Voicechat | Bundled Omnius documentation artifact: docs/rest/endpoints/voice-vision.md. |
-| `guide.rest-errors-pagination-etags` | Errors, Pagination, ETags, And Request IDs | Bundled Omnius documentation artifact: docs/rest/errors-pagination-etags.md. |
-| `guide.rest-examples-curl` | Curl Examples | Bundled Omnius documentation artifact: docs/rest/examples/curl.md. |
-| `guide.rest-examples-openai-sdk` | OpenAI SDK Examples | Bundled Omnius documentation artifact: docs/rest/examples/openai-sdk.md. |
-| `guide.rest-index-uppercase` | Omnius REST API Docs | Bundled Omnius documentation artifact: docs/rest/INDEX.md. |
-| `guide.rest-openapi-source` | OpenAPI Source And Renderers | Bundled Omnius documentation artifact: docs/rest/openapi-source.md. |
-| `guide.rest-quickref-uppercase` | Omnius REST Quick Reference | Bundled Omnius documentation artifact: docs/rest/QUICKREF.md. |
+| `guide.research-personality-verbosity-control` | LLM Personality Guidance &amp; Verbosity Control: Research Synthesis | Date: 2026-03-13 Purpose: Literature review and integration strategy for transient personality/verbosity steering in the Omnius framework |
+| `guide.rest-auth-and-scopes` | Auth And Scopes | Omnius can run without auth for local development, but shared deployments should use bearer keys. |
+| `guide.rest-endpoints-aims` | AIMS Governance Endpoints | Omnius exposes an ISO/IEC 42001-oriented AI Management System surface for audit-aligned deployments. |
+| `guide.rest-endpoints-aiwg` | AIWG Cascade Endpoints | AIWG endpoints expose a discover-then-expand documentation and workflow model for small and large context agents. |
+| `guide.rest-endpoints-chat` | Chat And Inference Endpoints | Returns an OpenAI-style model list aggregated from enabled endpoints. Model discovery should include local Ollama, configured external endpoints, sponsor endpoints, and COHERE/passthrough models where enabled. |
+| `guide.rest-endpoints-config` | Config, Endpoints, Keys, Profiles, And Projects | Endpoint switching uses the same normalization as the TUI. Use /v1/config/endpoint/test before switching a remote endpoint in automation. |
+| `guide.rest-endpoints-discovery` | Discovery | The discovery API exposes the same catalog shipped in docs/DISCOVERY.json and used by omnius discover / omnius show. |
+| `guide.rest-endpoints-events` | Events, Metrics, Usage, Audit, System, Nexus, And Ollama Pool | GET /v1/events is an SSE stream. Filter by exact type or prefix: |
+| `guide.rest-endpoints-files` | Files | GET /v1/files?path=&lt;relative-or-absolute&gt; returns directory entries for the active or requested workspace. |
+| `guide.rest-endpoints-memory` | Memory, Sessions, And Context | Use memory search for persistent knowledge, failures, prior decisions, and scoped context. Public connector surfaces such as Telegram should keep scope explicit so one chat does not pollute another. |
+| `guide.rest-endpoints-run` | Runs, Jobs, Todos, And Scheduled Work | Submits a long-running task to the daemon and returns an accepted job record. Runs are tracked under .omnius/jobs/. |
+| `guide.rest-endpoints-skills` | Skills And Commands | The REST docs bundle is available as: |
+| `guide.rest-endpoints-tools` | Tools, MCP, Hooks, Agents, And Code Graph | GET /v1/tools and POST /v1/tools/{name}/call use the same direct-call registry, built from the @omnius/execution tool manifest plus virtual lifecycle tools such as taskcomplete. If a tool appears in /v1/tools with directcallable: true, the same name is callable at /v1/tools/{name}/call. |
+| `guide.rest-endpoints-voice-vision` | Voice, Audio, Vision, And Voicechat | POST /v1/voice/tts returns audio bytes. format can be wav or pcm. X-Sample-Rate reports the sample rate. |
+| `guide.rest-errors-pagination-etags` | Errors, Pagination, ETags, And Request IDs | The OpenAPI contract documents RFC 7807 Problem Details for common errors: |
+| `guide.rest-examples-curl` | Curl Examples | curl -s "$BASE/openapi.json" \| jq '.info.title, .info.version' |
+| `guide.rest-examples-openai-sdk` | OpenAI SDK Examples | Omnius exposes an OpenAI-compatible chat-completions endpoint at /v1/chat/completions. |
+| `guide.rest-index-uppercase` | Omnius REST API Docs | This directory is the human-readable REST API reference for Omnius. It is meant to be explored incrementally by agents and humans. |
+| `guide.rest-openapi-source` | OpenAPI Source And Renderers | The canonical REST contract is generated by: |
+| `guide.rest-quickref-uppercase` | Omnius REST Quick Reference | GET /docs GET /api/docs GET /openapi.json GET /openapi.yaml GET /redoc |
 | `guide.rest-rest-docs-manifest-uppercase` | Rest Docs Manifest | Bundled Omnius documentation artifact: docs/rest/REST-DOCS-MANIFEST.json. |
-| `guide.reviews-adversary-system-review` | Adversary System Review | Bundled Omnius documentation artifact: docs/reviews/adversary-system-review.md. |
-| `guide.sana-and-video-generation-integration-plan` | Sana (Image) + `/video` (Video Generation) Integration Plan | Bundled Omnius documentation artifact: docs/sana-and-video-generation-integration-plan.md. |
-| `guide.session-diary-llm-training-analysis` | Session Diary: LLM Training Alignment Analysis | Bundled Omnius documentation artifact: docs/session-diary-llm-training-analysis.md. |
-| `guide.telegram-dmn-curiosity-outreach-scaffold` | Telegram DMN Curiosity Outreach Scaffold | Bundled Omnius documentation artifact: docs/telegram-dmn-curiosity-outreach-scaffold.md. |
-| `guide.telegram-mid-horizon-download-loop-handoff` | Telegram Mid-Horizon Download Loop Handoff | Bundled Omnius documentation artifact: docs/telegram-mid-horizon-download-loop-handoff.md. |
-| `guide.telegram-reflection-corpus-integration-plan` | Telegram Reflection Corpus Integration Plan | Bundled Omnius documentation artifact: docs/telegram-reflection-corpus-integration-plan.md. |
-| `guide.telegram-unified-tooling-architecture` | Telegram Unified Tooling Architecture | Bundled Omnius documentation artifact: docs/telegram-unified-tooling-architecture.md. |
-| `guide.threat-model` | Omnius Threat Model | Bundled Omnius documentation artifact: docs/threat-model.md. |
-| `guide.trajectory-grounding` | Trajectory Grounding | Bundled Omnius documentation artifact: docs/trajectory-grounding.md. |
+| `guide.reviews-adversary-system-review` | Adversary System Review | Date: 2026-06-28 Scope: Read-only pass Files reviewed: |
+| `guide.sana-and-video-generation-integration-plan` | Sana (Image) + `/video` (Video Generation) Integration Plan | &gt; Status: Plan only. Builds a complete, anchored handoff for a downstream implementation agent. &gt; Goal: (A) Promote NVIDIA Sana to the primary image-generation model for /image and the image-generation tool, (B) ship an entirely new /video pipeline modeled exactly on the existing /image and /sound-/music patterns, including its agent tool, Telegram public/pr |
+| `guide.session-diary-llm-training-analysis` | Session Diary: LLM Training Alignment Analysis | Is the session diary format what LLMs are trained on, such that it helps system handling? |
+| `guide.telegram-dmn-curiosity-outreach-scaffold` | Telegram DMN Curiosity Outreach Scaffold | This document tracks the root design for idle Telegram channel "daydream" behavior: private meta-analysis while a public group is idle, curiosity-driven exploration, scoped tool awareness, same-group follow-up planning, private DM follow-up planning, and persona document steering. It is intentionally a scaffold: artifacts describe possible actions and tool a |
+| `guide.telegram-mid-horizon-download-loop-handoff` | Telegram Mid-Horizon Download Loop Handoff | A Telegram admin-DM action run for "can you please get me the pdf for Snow Crash" burned 60+ turns trying Archive.org, browser clicks, repeated curl downloads, and third-party PDF mirrors. It eventually sent visible self-talk to Telegram: |
+| `guide.telegram-reflection-corpus-integration-plan` | Telegram Reflection Corpus Integration Plan | Status: planning and implementation tracker |
+| `guide.telegram-unified-tooling-architecture` | Telegram Unified Tooling Architecture | Goal: give Telegram-sourced agent runs one scoped telegram tool that covers Telegram Bot API operations behind explicit Omnius policy, Telegram bot rights, and admin-controlled toggles. This replaces the current drift where some Telegram powers exist as private helpers, some exist as TUI slash commands, and only telegramsendfile is model-facing. |
+| `guide.threat-model` | Omnius Threat Model | &gt; Version: 1.0.0 &gt; Last Updated: 2026-03-26 &gt; Classification: Internal Security Review &gt; Status: Phase 1 - Initial Assessment |
+| `guide.trajectory-grounding` | Trajectory Grounding | Trajectory Grounding gives a running agent a compact, evidence-bound account of where a project stands, what changed, what remains uncertain, and the safest next action. Before the first main-agent request, Omnius asks the selected model to form a specific, structured orientation from that evidence. This is a control-plane checkpoint, not free-form self-talk |
 | `guide.vitepress-config` | Config | Bundled Omnius documentation artifact: docs/.vitepress/config.mts. |
-| `guide.voice-flow-architecture` | Voice TTS Flow — Architecture &amp; Implementation Guide | Bundled Omnius documentation artifact: docs/voice-flow-architecture.md. |
-| `guide.work-orders-daemon-hud-ui-overhaul` | Daemon HUD UI Overhaul Work Order | Bundled Omnius documentation artifact: docs/work-orders/daemon-hud-ui-overhaul.md. |
+| `guide.voice-flow-architecture` | Voice TTS Flow — Architecture &amp; Implementation Guide | This document describes the voice synthesis system in omnius: how it's built, how all the pieces connect, and how to add new voice features following the same patterns. |
+| `guide.work-orders-daemon-hud-ui-overhaul` | Daemon HUD UI Overhaul Work Order | Overhaul the daemon web interface using /home/roko/Desktop/hud-ui-style-kit(6)/hud-ui-style-kit as the source of truth. Preserve current daemon behavior while replacing the OpenWebUI-like rounded dashboard styling with the cold tactical HUD visual system. |
 | `guide.work-orders-hermes-architecture-deltas-01-public-scrutiny-provenance-control-index-uppercase` | Public Scrutiny Provenance Control Index | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/01-public-scrutiny-provenance-control/INDEX.md. |
-| `guide.work-orders-hermes-architecture-deltas-01-public-scrutiny-provenance-control-workorder-uppercase` | Workorder: Public Scrutiny Provenance Control | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/01-public-scrutiny-provenance-control/WORKORDER.md. |
+| `guide.work-orders-hermes-architecture-deltas-01-public-scrutiny-provenance-control-workorder-uppercase` | Workorder: Public Scrutiny Provenance Control | Add a public Telegram scrutiny control plane that can elevate completion provenance checks when public accuracy risk rises, without hard-coded scenario phrases or shortcut wording that teaches the model to satisfy the gate without evidence. |
 | `guide.work-orders-hermes-architecture-deltas-02-context-engine-plugin-boundary-index-uppercase` | Context Engine Plugin Boundary Index | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/02-context-engine-plugin-boundary/INDEX.md. |
-| `guide.work-orders-hermes-architecture-deltas-02-context-engine-plugin-boundary-workorder-uppercase` | Workorder: Context Engine Plugin Boundary | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/02-context-engine-plugin-boundary/WORKORDER.md. |
+| `guide.work-orders-hermes-architecture-deltas-02-context-engine-plugin-boundary-workorder-uppercase` | Workorder: Context Engine Plugin Boundary | Extract context assembly, compaction, memory stitching, and completion framing behind a small orchestrator-owned interface. The current runner should remain behaviorally compatible, but future context strategies should be swappable without editing the main AgenticRunner loop. |
 | `guide.work-orders-hermes-architecture-deltas-03-typed-gateway-event-stream-index-uppercase` | Typed Gateway Event Stream Index | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/03-typed-gateway-event-stream/INDEX.md. |
-| `guide.work-orders-hermes-architecture-deltas-03-typed-gateway-event-stream-workorder-uppercase` | Workorder: Typed Gateway Event Stream | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/03-typed-gateway-event-stream/WORKORDER.md. |
+| `guide.work-orders-hermes-architecture-deltas-03-typed-gateway-event-stream-workorder-uppercase` | Workorder: Typed Gateway Event Stream | Replace fragile renderer-facing string events with a typed event stream that separates what happened in the runner from how each gateway renders it. |
 | `guide.work-orders-hermes-architecture-deltas-04-task-local-gateway-context-index-uppercase` | Task-Local Gateway Context Index | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/04-task-local-gateway-context/INDEX.md. |
-| `guide.work-orders-hermes-architecture-deltas-04-task-local-gateway-context-workorder-uppercase` | Workorder: Task-Local Gateway Context | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/04-task-local-gateway-context/WORKORDER.md. |
+| `guide.work-orders-hermes-architecture-deltas-04-task-local-gateway-context-workorder-uppercase` | Workorder: Task-Local Gateway Context | Introduce a task-local gateway context based on Node AsyncLocalStorage so Telegram, REST, TUI, scheduler, and background runs can share a common current-session context without mutable cross-run leakage. |
 | `guide.work-orders-hermes-architecture-deltas-05-process-lifecycle-monitoring-notifications-index-uppercase` | Process Lifecycle Monitoring Notifications Index | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/05-process-lifecycle-monitoring-notifications/INDEX.md. |
-| `guide.work-orders-hermes-architecture-deltas-05-process-lifecycle-monitoring-notifications-workorder-uppercase` | Workorder: Process Lifecycle Monitoring Notifications | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/05-process-lifecycle-monitoring-notifications/WORKORDER.md. |
+| `guide.work-orders-hermes-architecture-deltas-05-process-lifecycle-monitoring-notifications-workorder-uppercase` | Workorder: Process Lifecycle Monitoring Notifications | Extend Omnius's registry-based process lifecycle architecture with active monitoring, user-visible diagnostics, and cleanup of remaining direct legacy kill paths. Keep the lease registry as the only authority for automatic stale process termination. |
 | `guide.work-orders-hermes-architecture-deltas-06-vision-evidence-routing-ladder-index-uppercase` | Vision Evidence Routing Ladder Index | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/06-vision-evidence-routing-ladder/INDEX.md. |
-| `guide.work-orders-hermes-architecture-deltas-06-vision-evidence-routing-ladder-workorder-uppercase` | Workorder: Vision Evidence Routing Ladder | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/06-vision-evidence-routing-ladder/WORKORDER.md. |
+| `guide.work-orders-hermes-architecture-deltas-06-vision-evidence-routing-ladder-workorder-uppercase` | Workorder: Vision Evidence Routing Ladder | Build a generic visual evidence router that resolves scoped media reliably and chooses an analysis ladder based on the current request's information need: |
 | `guide.work-orders-hermes-architecture-deltas-07-durable-multi-agent-kanban-index-uppercase` | Durable Multi-Agent Kanban Index | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/07-durable-multi-agent-kanban/INDEX.md. |
-| `guide.work-orders-hermes-architecture-deltas-07-durable-multi-agent-kanban-workorder-uppercase` | Workorder: Durable Multi-Agent Kanban | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/07-durable-multi-agent-kanban/WORKORDER.md. |
+| `guide.work-orders-hermes-architecture-deltas-07-durable-multi-agent-kanban-workorder-uppercase` | Workorder: Durable Multi-Agent Kanban | Add a durable multi-agent work board for long-running admin tasks and public disputed factual work. The board should support decomposition, worker assignment, verification, synthesis, diagnostics, and completion evidence without relying on one runner's transient todo list. |
 | `guide.work-orders-hermes-architecture-deltas-08-completion-critic-reconciliation-ledger-index-uppercase` | Completion Critic Reconciliation Ledger Index | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/08-completion-critic-reconciliation-ledger/INDEX.md. |
-| `guide.work-orders-hermes-architecture-deltas-08-completion-critic-reconciliation-ledger-workorder-uppercase` | Workorder: Completion Critic Reconciliation Ledger | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/08-completion-critic-reconciliation-ledger/WORKORDER.md. |
-| `guide.work-orders-hermes-architecture-deltas-index-uppercase` | Hermes Architecture Deltas Workorder Index | Bundled Omnius documentation artifact: docs/work-orders/hermes-architecture-deltas/INDEX.md. |
-| `guide.work-orders-omnius-context-engineering-behavior-fixes` | Omnius Context Engineering Behavior Fixes | Bundled Omnius documentation artifact: docs/work-orders/omnius-context-engineering-behavior-fixes.md. |
-| `guide.work-orders-telegram-dropbear-context-rca-workorder` | Telegram Dropbear Context Engineering RCA Work Order | Bundled Omnius documentation artifact: docs/work-orders/telegram-dropbear-context-rca-workorder.md. |
-| `guide.work-orders-wo-am-gaps-uppercase` | Associative Memory Gap Work Orders | Bundled Omnius documentation artifact: docs/work-orders/WO-AM-GAPS.md. |
-| `guide.work-orders-world-class-memory-compiler-readme-uppercase` | World-Class Memory Compiler Program | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/README.md. |
-| `guide.work-orders-world-class-memory-compiler-tracker-uppercase` | Memory Compiler Implementation Tracker | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/TRACKER.md. |
-| `guide.work-orders-world-class-memory-compiler-wo-01-exact-request-budget-uppercase` | WO-01 — Exact Request and Budget Compiler | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/WO-01-exact-request-budget.md. |
-| `guide.work-orders-world-class-memory-compiler-wo-02-typed-memory-fabric-uppercase` | WO-02 — Typed Memory Fabric and Immutable Event Ledger | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/WO-02-typed-memory-fabric.md. |
-| `guide.work-orders-world-class-memory-compiler-wo-03-dependency-working-set-uppercase` | WO-03 — Dependency Graph and Working-Set Materializer | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/WO-03-dependency-working-set.md. |
-| `guide.work-orders-world-class-memory-compiler-wo-04-inference-memory-compiler-uppercase` | WO-04 — Inference-Driven Memory Compiler | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/WO-04-inference-memory-compiler.md. |
-| `guide.work-orders-world-class-memory-compiler-wo-05-artifact-fidelity-materialization-uppercase` | WO-05 — Artifact Fidelity and Explicit Materialization | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/WO-05-artifact-fidelity-materialization.md. |
-| `guide.work-orders-world-class-memory-compiler-wo-06-temporal-hybrid-retrieval-uppercase` | WO-06 — Temporal Hybrid Retrieval | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/WO-06-temporal-hybrid-retrieval.md. |
-| `guide.work-orders-world-class-memory-compiler-wo-07-evaluation-harness-uppercase` | WO-07 — Replay Evaluation and Adversarial Harness | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/WO-07-evaluation-harness.md. |
-| `guide.work-orders-world-class-memory-compiler-wo-08-rollout-legacy-removal-uppercase` | WO-08 — Shadow Rollout, Migration, and Legacy Removal | Bundled Omnius documentation artifact: docs/work-orders/world-class-memory-compiler/WO-08-rollout-legacy-removal.md. |
-| `guide.x402-remote-inference-plan` | x402 Remote Inference Integration — Security Audit &amp; Comprehensive Plan | Bundled Omnius documentation artifact: docs/x402-remote-inference-plan.md. |
+| `guide.work-orders-hermes-architecture-deltas-08-completion-critic-reconciliation-ledger-workorder-uppercase` | Workorder: Completion Critic Reconciliation Ledger | Convert completion verification into a durable claim/evidence ledger. The critic must receive: |
+| `guide.work-orders-hermes-architecture-deltas-index-uppercase` | Hermes Architecture Deltas Workorder Index | Status: ready for implementation planning. These documents are workorders only; they do not claim the features are implemented. |
+| `guide.work-orders-omnius-context-engineering-behavior-fixes` | Omnius Context Engineering Behavior Fixes | Source observation: current Omnius behavior while supervising a noclip/earth sidebar cleanup task. The observed run mixed internal cognitive-agent artifacts with user-task artifacts, repeated stale edit attempts after the file had changed, and overclaimed completion despite stale or missing verification. |
+| `guide.work-orders-telegram-dropbear-context-rca-workorder` | Telegram Dropbear Context Engineering RCA Work Order | Observed run: /home/roko/Documents/Projects/Adjacent/telegramtest/.omnius, run id 1782873796963-i5r7mv. |
+| `guide.work-orders-wo-am-gaps-uppercase` | Associative Memory Gap Work Orders | Generated: 2026-04-13 Source: Deep audit of multimodal associative memory systems Status: READY FOR IMPLEMENTATION |
+| `guide.work-orders-world-class-memory-compiler-readme-uppercase` | World-Class Memory Compiler Program | Status: active implementation program Owner: Omnius orchestration and memory packages Last updated: 2026-07-13 |
+| `guide.work-orders-world-class-memory-compiler-tracker-uppercase` | Memory Compiler Implementation Tracker | Last reconciled: 2026-07-13 Authority: This file is the granular program tracker. The work-order documents define the contract and acceptance criteria; neither test output nor a model claim may check an item without the named evidence. |
+| `guide.work-orders-world-class-memory-compiler-wo-01-exact-request-budget-uppercase` | WO-01 — Exact Request and Budget Compiler | Status: in progress Primary modules: packages/orchestrator/src/agenticRunner.ts, contextWindowDump.ts, context-compiler.ts, context-fabric.ts Depends on: none |
+| `guide.work-orders-world-class-memory-compiler-wo-02-typed-memory-fabric-uppercase` | WO-02 — Typed Memory Fabric and Immutable Event Ledger | Status: in progress Primary modules: packages/memory/src/, packages/schemas/src/memory.ts, packages/orchestrator/src/evidenceLedger.ts, runEvents.ts Depends on: WO-01 |
+| `guide.work-orders-world-class-memory-compiler-wo-03-dependency-working-set-uppercase` | WO-03 — Dependency Graph and Working-Set Materializer | Status: in progress Primary modules: packages/memory/src/memoryGraph.ts, temporalGraph.ts, packages/orchestrator/src/evidenceLedger.ts, agenticRunner.ts Depends on: WO-02 |
+| `guide.work-orders-world-class-memory-compiler-wo-04-inference-memory-compiler-uppercase` | WO-04 — Inference-Driven Memory Compiler | Status: in progress Primary modules: packages/orchestrator/src/compaction-analyst.ts, agenticRunner.ts, contextWindowDump.ts Depends on: WO-01, WO-03 |
+| `guide.work-orders-world-class-memory-compiler-wo-05-artifact-fidelity-materialization-uppercase` | WO-05 — Artifact Fidelity and Explicit Materialization | Status: in progress Primary modules: packages/execution/src/tools/file-read.ts, packages/orchestrator/src/evidenceBranch.ts, evidenceLedger.ts, artifactContract.ts Depends on: WO-02, WO-03 |
+| `guide.work-orders-world-class-memory-compiler-wo-06-temporal-hybrid-retrieval-uppercase` | WO-06 — Temporal Hybrid Retrieval | Status: in progress Primary modules: packages/memory/src/hybridMemoryRetriever.ts, pprRetrieval.ts, temporalGraph.ts, memoryGraph.ts Depends on: WO-02, WO-03, WO-05 |
+| `guide.work-orders-world-class-memory-compiler-wo-07-evaluation-harness-uppercase` | WO-07 — Replay Evaluation and Adversarial Harness | Status: in progress Primary modules: packages/orchestrator/scripts/, test fixtures, context audit/log serializers Depends on: WO-01 through WO-06 |
+| `guide.work-orders-world-class-memory-compiler-wo-08-rollout-legacy-removal-uppercase` | WO-08 — Shadow Rollout, Migration, and Legacy Removal | Status: in progress Primary modules: orchestrator configuration, telemetry, TUI audit display, legacy compaction/rehydration paths Depends on: WO-07 |
+| `guide.x402-remote-inference-plan` | x402 Remote Inference Integration — Security Audit &amp; Comprehensive Plan | C1: Private key not truly zeroed (nexus.ts L1455, L1901) privKeyHex = "0".repeat(64) only rebinds the JS variable — the original string lives on the heap until GC. JavaScript strings are immutable. |
+
+## Layer
+
+| ID | Title | Summary |
+| --- | --- | --- |
+| `layer.architecture` | Architecture and ownership | The process, package, dependency, and data-flow map that connects public interfaces to their source owners and runtime boundaries. |
+| `layer.code-intelligence` | Code intelligence | Repository indexing, symbol and code graph storage, retrieval, repository context, and evidence-directed navigation used by coding agents. |
+| `layer.context` | Prompts and context engineering | System prompts, task templates, context compilation, admission, compaction, dumps, history sanitation, token budgeting, and working-context recovery. |
+| `layer.contracts` | Contracts and schemas | Shared TypeScript schemas, OpenAPI, command/tool/provider registries, version preconditions, and generated documentation that keep surfaces consistent. |
+| `layer.discovery` | Discovery and onboarding | Stable IDs, bootstrap profiles, task workflows, generated catalogs, package guidance, and live discovery endpoints that let agents navigate Omnius without prior repository knowledge. |
+| `layer.documentation` | Documentation | User, operator, integrator, and maintainer explanations linked from the generated discovery graph and deployable AIWG skills. |
+| `layer.execution` | Tool execution and policy | Executable tools, schemas, security classification, direct versus agent-bound exposure, MCP/custom tools, mutation contracts, and shell/file/browser boundaries. |
+| `layer.inference` | Inference and provider routing | Provider descriptors, endpoint protocol selection, model routing, local Ollama/vLLM, hosted APIs, sponsor capacity, and compatibility translation. |
+| `layer.interface` | Interfaces | The TUI, one-shot CLI, REST daemon, dashboard, tray indicator, Telegram gateway, and JavaScript library through which users and agents enter Omnius. |
+| `layer.media` | Voice, ASR, TTS, vision, and media | ASR engine registry and managed weights, TTS/voice cloning, realtime voicechat, live sensors, vision, and image/video/audio generation backed by shared model storage. |
+| `layer.memory` | Memory and sessions | Project sessions, episodes, temporal graph memory, maintenance, summaries, task continuity, and explicit separation between conversational history and slash-command control input. |
+| `layer.observability` | Observability and evidence | Action trees, run events, status, metrics, context dumps, logs, evidence and verification ledgers, debug artifacts, and UI projections for proving what happened. |
+| `layer.operations` | Runtime operations | Daemon lifecycle and port ownership, tray indicator, update and restart verification, schedulers, installation, runtime dependencies, packaging, and publish staging. |
+| `layer.orchestration` | Agent orchestration | Long-horizon task intake, planning, agent/tool turns, sub-agents, completion contracts, trajectory checkpoints, recovery, and run lifecycle. |
+| `layer.persistence` | Persistence and state scopes | Project-local .omnius state, user-global ~/.omnius state, shared model/runtime caches, configuration precedence, and the rules preventing cross-project leakage. |
+| `layer.security` | Security and trust boundaries | Authentication, REST scopes, secret handling, tool risk and mutation policy, remote access, hardware preflight, AIMS controls, and fail-closed execution gates. |
+
+## Module
+
+| ID | Title | Summary |
+| --- | --- | --- |
+| `module.app-api` | @omnius/api | Express-based API server for the omnius coding framework |
+| `module.app-worker` | @omnius/worker | Background worker for async agent task processing |
+| `module.backend-vllm` | @omnius/backend-vllm | vLLM backend client for model inference |
+| `module.cli` | omnius | Command-line interface for the omnius coding framework |
+| `module.execution` | @omnius/execution | Execution and validation tools for the omnius coding framework |
+| `module.indexer` | @omnius/indexer | Codebase indexing and file tree analysis |
+| `module.memory` | @omnius/memory | Durable SQLite-backed memory stores for the omnius coding agent |
+| `module.orchestrator` | @omnius/orchestrator | RALPH loop orchestrator - central brain of the coding agent |
+| `module.prompts` | @omnius/prompts | Prompt templates and loader for the omnius coding framework |
+| `module.retrieval` | @omnius/retrieval | Code retrieval and semantic search for agent context |
+| `module.schemas` | @omnius/schemas | Shared TypeScript schemas and type definitions for the omnius framework |
 
 ## Operation
 
@@ -494,6 +543,18 @@ Daemon equivalents are `GET /v1/discovery?q=<intent>` and `GET /v1/discovery/{id
 | `provider.together` | Together AI | Together hosted inference through its OpenAI-compatible API. |
 | `provider.vllm` | vLLM | A self-hosted OpenAI-compatible vLLM server, normally on port 8000. |
 
+## Runtime
+
+| ID | Title | Summary |
+| --- | --- | --- |
+| `runtime.daemon` | REST daemon | Long-running HTTP/WebSocket service, normally on 127.0.0.1:11435, that owns automation, dashboard, chat/run, tool, voice, media, update, and health routes. |
+| `runtime.dashboard` | Dashboard | Browser UI served by the daemon for projects, chats, runs, activity, voice/media, settings, updates, and observability. |
+| `runtime.model-workers` | Model and media workers | External local processes and managed Python environments used for inference, ASR, TTS, and generated media; their real hardware placement must be verified before live inference. |
+| `runtime.one-shot` | One-shot CLI task | Foreground single-task agent execution from a shell, suitable when the caller can wait for completion and consume terminal output. |
+| `runtime.telegram` | Telegram gateway | Scoped external chat/control bridge with its own authentication, command exposure, persona/session state, and observability. |
+| `runtime.tray` | System tray indicator | Desktop status and update control registered through the host tray implementation, focused on Ubuntu/Linux and linked to daemon readiness. |
+| `runtime.tui` | Interactive TUI | Foreground terminal control plane for chat, tasks, slash commands, action trees, media, setup, and operator confirmation. |
+
 ## Skill
 
 | ID | Title | Summary |
@@ -502,6 +563,7 @@ Daemon equivalents are `GET /v1/discovery?q=<intent>` and `GET /v1/discovery/{id
 | `skill.browser-interaction-validation` | Browser interaction validation | Validate a user-facing browser flow with canonical Playwright interactions, explicit postconditions, and honest blocked or inconclusive evidence. |
 | `skill.evidence-directed-delivery` | Evidence-directed delivery | Use claim-and-evidence, anti-reward-hacking, bounded recovery, and feedback-only completion rules for non-trivial work. |
 | `skill.hardware-evidence-audit` | Hardware evidence audit | Classify static, simulation, integration, and physical-device evidence without overstating hardware proof. |
+| `skill.omnius-agent-onboarding` | omnius-agent-onboarding | Bootstrap any agent into Omnius, choose the correct entrypoint, locate layer/module/state ownership, and verify live behavior without guessing. |
 | `skill.omnius-docs` | Omnius documentation router | Find the smallest Omnius documentation artifact needed for a question. |
 | `skill.omnius-inference-docs` | Omnius inference documentation | Route provider, protocol, credential, Claude, Gemini, and custom endpoint questions. |
 | `skill.omnius-integration-docs` | Omnius integration documentation | Route agent and service integration through discovery, OpenAPI, provider, tool, auth, and version contracts. |
@@ -517,6 +579,13 @@ Daemon equivalents are `GET /v1/discovery?q=<intent>` and `GET /v1/discovery/{id
 | `skill.test-surface-audit` | Test surface audit | Map canonical tests to claims and expose placeholder, mock-only, copied-logic, and unwired verification gaps. |
 | `skill.workspace-reality-audit` | Workspace reality audit | Audit repository truth, generated artifacts, documentation drift, and delivery ownership before claiming progress. |
 
+## Store
+
+| ID | Title | Summary |
+| --- | --- | --- |
+| `store.global` | User-global state | Machine/user-scoped Omnius state under ~/.omnius for daemon identity, global configuration and credentials, shared managed environments, model weights, media store, updates, and cross-project registries. |
+| `store.project` | Project-local state | State scoped to one workspace under &lt;project&gt;/.omnius, including sessions, task/run artifacts, project context, indexes, memories, skills, and UI preferences where applicable. |
+
 ## Tool
 
 | ID | Title | Summary |
@@ -656,3 +725,19 @@ Daemon equivalents are `GET /v1/discovery?q=<intent>` and `GET /v1/discovery/{id
 | `tool.working-notes` | Working Notes | working_notes is a directly callable Omnius tool. |
 | `tool.youtube-download` | Youtube Download | youtube_download is an agent-bound Omnius tool available through chat/run tool exposure. |
 
+## Workflow
+
+| ID | Title | Summary |
+| --- | --- | --- |
+| `workflow.agent-bound-tools` | Use agent-bound tools such as web_search | Offer a non-direct tool to an Omnius agent loop through run/chat instead of inventing a direct REST call. |
+| `workflow.async-agent-run` | Run a long-horizon task through REST | Create an asynchronous agent run, retain its ID, stream or poll evidence, steer/cancel when needed, and verify terminal completion. |
+| `workflow.choose-entrypoint` | Choose the correct Omnius entrypoint | Select TUI, one-shot CLI, REST chat, asynchronous run, OpenAI-compatible completion, or direct tool execution from the caller's lifecycle and state requirements. |
+| `workflow.daemon-tray-update` | Operate daemon, tray, and updates | Ensure one current daemon owns the service port, start the tray against it, install updates through the real global npm flow, stream progress, restart components, and verify the target runtime. |
+| `workflow.debug-runtime` | Debug an Omnius runtime failure | Diagnose from identity and ownership outward: version, health, port/process, live contract, status/events, state scope, logs/evidence, then the owning module. |
+| `workflow.direct-tool-call` | Call a directly exposed tool | Inspect live metadata, confirm direct-call exposure and safety, submit the exact schema, and verify the tool result. |
+| `workflow.extend-omnius` | Extend or modify Omnius safely | Locate the owning layer/module and canonical registry, change the smallest source boundary, update discovery/docs/contracts, and run targeted plus freshness tests. |
+| `workflow.provider-selection` | Select an inference provider and model | Resolve an explicit provider protocol, credentials, endpoint, and model; verify live reachability and hardware placement for local inference. |
+| `workflow.publish-package` | Build and publish the Omnius package | Follow the repository Minimal Publish SOP: clean all workspaces, rebuild, bundle publish/, inspect a local-cache tarball, patch-bump, publish only from publish/, and verify npm metadata. |
+| `workflow.stateful-chat` | Use stateful daemon chat | Create or select a real chat session, send conversational turns, and load its history without treating control commands such as /quit as chats. |
+| `workflow.voice-asr-tts` | Select and use ASR/TTS engines | Discover installed and supported ASR/TTS systems, perform managed setup when needed, activate one exact engine/model/device, and use the documented REST or TUI surface. |
+