{
  "schema_version": "1.0.0",
  "entries": [
    {
      "id": "overview",
      "kind": "capability",
      "title": "Omnius capability overview",
      "summary": "Start here to discover Omnius providers, tools, APIs, commands, skills, configuration, operations, and shipped documentation.",
      "aliases": ["omnius", "help", "documentation", "capabilities"],
      "keywords": ["discover", "show", "docs", "catalog"],
      "maturity": "stable",
      "interfaces": [
        {"type": "cli", "target": "omnius discover \"<need>\""},
        {"type": "cli", "target": "omnius capabilities --json"},
        {"type": "http", "target": "GET /v1/discovery"}
      ],
      "references": [
        {"type": "guide", "target": "docs/DISCOVERY.md", "relation": "start-here"},
        {"type": "guide", "target": "README.md", "relation": "overview"}
      ],
      "related": [
        "capability.bring-your-own-inference",
        "capability.osint-research",
        "api.discovery",
        "api.tools",
        "operation.version-compatibility"
      ]
    },
    {
      "id": "guide.discovery-markdown",
      "kind": "guide",
      "title": "Omnius Discovery Catalog",
      "summary": "Human-readable generated index of every discoverable Omnius capability and bundled documentation artifact.",
      "aliases": ["DISCOVERY.md", "discovery guide"],
      "keywords": ["generated", "catalog", "documentation"],
      "maturity": "stable",
      "interfaces": [{"type": "file", "target": "docs/DISCOVERY.md"}],
      "references": [{"type": "documentation", "target": "docs/DISCOVERY.md", "relation": "canonical-artifact"}],
      "related": ["overview", "guide.discovery-json", "api.discovery"]
    },
    {
      "id": "guide.discovery-json",
      "kind": "guide",
      "title": "Omnius Machine Discovery Catalog",
      "summary": "Generated JSON catalog consumed by the CLI, REST discovery API, JavaScript API, and offline agents.",
      "aliases": ["DISCOVERY.json", "machine catalog"],
      "keywords": ["generated", "json", "schema", "catalog"],
      "maturity": "stable",
      "interfaces": [{"type": "file", "target": "docs/DISCOVERY.json"}],
      "references": [{"type": "documentation", "target": "docs/DISCOVERY.json", "relation": "canonical-artifact"}],
      "related": ["overview", "guide.discovery-markdown", "api.discovery"]
    },
    {
      "id": "guide.discovery-catalog-overrides",
      "kind": "guide",
      "title": "Discovery Catalog Curated Source",
      "summary": "Curated aliases, relationships, invocation modes, and conceptual entries merged into the generated catalog.",
      "aliases": ["catalog overrides", "discovery source"],
      "keywords": ["source", "aliases", "relationships", "generation"],
      "maturity": "stable",
      "interfaces": [{"type": "file", "target": "docs/discovery/catalog-overrides.json"}],
      "references": [{"type": "documentation", "target": "docs/discovery/catalog-overrides.json", "relation": "canonical-artifact"}],
      "related": ["guide.discovery-json", "guide.discovery-markdown"]
    },
    {
      "id": "capability.bring-your-own-inference",
      "kind": "capability",
      "title": "Bring your own inference",
      "summary": "Connect local runtimes, Claude, Gemini, and registered OpenAI-compatible providers through explicit protocol and credential descriptors.",
      "aliases": ["BYOI", "BYO inference", "external inference", "provider account", "provider keys"],
      "keywords": ["endpoint", "model", "protocol", "api key", "claude", "gemini"],
      "maturity": "stable",
      "prerequisites": ["Configured endpoint", "Exact provider protocol", "Provider credential when required"],
      "interfaces": [
        {"type": "cli", "target": "/endpoint providers"},
        {"type": "cli", "target": "/model"},
        {"type": "http", "target": "PUT /v1/config/endpoint"}
      ],
      "references": [
        {"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "canonical-guide"},
        {"type": "config", "target": "docs/reference/configuration.md", "relation": "credentials"}
      ],
      "related": [
        "provider.anthropic",
        "provider.gemini",
        "config.provider-credentials",
        "config.provider-protocol",
        "operation.version-compatibility"
      ]
    },
    {
      "id": "capability.osint-research",
      "kind": "capability",
      "title": "Categorized OSINT research",
      "summary": "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.",
      "aliases": ["OSINT", "OSINT4ALL", "long-haul research", "open source intelligence"],
      "keywords": ["research", "catalog", "search", "provenance", "corroboration", "identity", "social", "network", "geospatial"],
      "maturity": "stable",
      "prerequisites": ["Legitimate research purpose", "Authorization for active or sensitive target interaction"],
      "interfaces": [
        {"type": "agent-tool", "target": "osint_search", "description": "Compact deterministic local discovery"},
        {"type": "agent-tool", "target": "osint_show", "description": "Exact resource expansion"}
      ],
      "references": [
        {"type": "guide", "target": "docs/guides/osint-research.md", "relation": "canonical-guide"},
        {"type": "source", "target": "packages/execution/src/tools/osint-catalog-data.ts", "relation": "generated-catalog"}
      ],
      "related": ["tool.osint-search", "tool.osint-show", "tool.web-search", "tool.web-fetch", "tool.web-crawl"]
    },
    {
      "id": "tool.osint-search",
      "kind": "tool",
      "title": "OSINT Search",
      "summary": "Search the bundled OSINT4ALL snapshot locally and return a bounded ranked shortlist with category, archived-health, interaction, and risk metadata; no cataloged service is contacted.",
      "aliases": ["osint_search", "OSINT catalog search"],
      "keywords": ["OSINT4ALL", "local index", "top-k", "77 categories", "1446 resources", "1456 placements"],
      "maturity": "stable",
      "interfaces": [
        {"type": "rest-schema", "target": "/v1/tools/osint_search"},
        {"type": "agent-run", "target": "/v1/run"},
        {"type": "agent-chat", "target": "/v1/chat/completions"}
      ],
      "references": [
        {"type": "source", "target": "packages/execution/src/tools/osint-catalog.ts", "relation": "implementation"},
        {"type": "guide", "target": "docs/guides/osint-research.md", "relation": "usage"}
      ],
      "related": ["capability.osint-research", "tool.osint-show"],
      "direct_callable": false
    },
    {
      "id": "tool.osint-show",
      "kind": "tool",
      "title": "OSINT Show",
      "summary": "Expand one exact local OSINT resource ID into its URL, aliases, original category placements, archived health, and safe next-tool route; no cataloged service is contacted.",
      "aliases": ["osint_show", "OSINT resource expansion"],
      "keywords": ["OSINT4ALL", "exact lookup", "provenance", "risk", "archived health"],
      "maturity": "stable",
      "interfaces": [
        {"type": "rest-schema", "target": "/v1/tools/osint_show"},
        {"type": "agent-run", "target": "/v1/run"},
        {"type": "agent-chat", "target": "/v1/chat/completions"}
      ],
      "references": [
        {"type": "source", "target": "packages/execution/src/tools/osint-catalog.ts", "relation": "implementation"},
        {"type": "guide", "target": "docs/guides/osint-research.md", "relation": "usage"}
      ],
      "related": ["capability.osint-research", "tool.osint-search", "tool.web-fetch", "tool.web-crawl"],
      "direct_callable": false
    },
    {
      "id": "provider.ollama",
      "kind": "provider",
      "title": "Ollama",
      "summary": "Local Ollama inference using native Ollama model, chat, generate, and embeddings paths.",
      "aliases": ["local Ollama"],
      "keywords": ["local", "ollama", "api tags"],
      "maturity": "stable",
      "protocol": "ollama",
      "base_url": "http://127.0.0.1:11434",
      "auth": "none by default",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "operation.hardware-preflight"]
    },
    {
      "id": "provider.anthropic",
      "kind": "provider",
      "title": "Anthropic Claude",
      "summary": "Claude through Anthropic's native Messages API with system, tool, streaming, stop-reason, and usage translation.",
      "aliases": ["anthropic", "claude"],
      "keywords": ["messages api", "x-api-key", "anthropic-version", "tool_use", "tool_result"],
      "maturity": "stable",
      "protocol": "anthropic-messages",
      "base_url": "https://api.anthropic.com/v1",
      "auth": "x-api-key plus anthropic-version",
      "interfaces": [{"type": "http-upstream", "target": "POST https://api.anthropic.com/v1/messages"}],
      "references": [
        {"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"},
        {"type": "external", "target": "https://platform.claude.com/docs/en/api/messages/create", "relation": "upstream-contract"}
      ],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials", "config.provider-protocol"]
    },
    {
      "id": "provider.gemini",
      "kind": "provider",
      "title": "Google Gemini",
      "summary": "Gemini through Google's official OpenAI-compatible endpoint with Bearer authentication.",
      "aliases": ["gemini", "google", "google-ai"],
      "keywords": ["openai compatibility", "generativelanguage", "v1beta", "bearer"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://generativelanguage.googleapis.com/v1beta/openai",
      "auth": "Bearer plus x-goog-api-client",
      "interfaces": [{"type": "http-upstream", "target": "POST https://generativelanguage.googleapis.com/v1beta/openai/chat/completions"}],
      "references": [
        {"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"},
        {"type": "external", "target": "https://ai.google.dev/gemini-api/docs/openai", "relation": "upstream-contract"}
      ],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials", "config.provider-protocol"]
    },
    {
      "id": "provider.openai",
      "kind": "provider",
      "title": "OpenAI",
      "summary": "OpenAI models through the OpenAI chat-compatible protocol and Bearer authentication.",
      "aliases": ["openai api"],
      "keywords": ["cloud", "openai-chat", "bearer"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://api.openai.com/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.lmstudio",
      "kind": "provider",
      "title": "LM Studio",
      "summary": "A local OpenAI-compatible LM Studio server, normally on port 1234.",
      "aliases": ["lm studio"],
      "keywords": ["local", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "http://127.0.0.1:1234/v1",
      "auth": "optional Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "operation.hardware-preflight"]
    },
    {
      "id": "provider.vllm",
      "kind": "provider",
      "title": "vLLM",
      "summary": "A self-hosted OpenAI-compatible vLLM server, normally on port 8000.",
      "aliases": ["vllm", "self hosted openai"],
      "keywords": ["local", "openai compatible", "gpu"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "http://127.0.0.1:8000/v1",
      "auth": "optional Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "operation.hardware-preflight"]
    },
    {
      "id": "provider.openrouter",
      "kind": "provider",
      "title": "OpenRouter",
      "summary": "OpenAI-compatible routing across hosted model providers.",
      "aliases": ["open router"],
      "keywords": ["router", "cloud", "bearer"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://openrouter.ai/api/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.groq",
      "kind": "provider",
      "title": "Groq",
      "summary": "Groq hosted inference through its OpenAI-compatible API.",
      "aliases": ["groq cloud"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://api.groq.com/openai/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.chutes",
      "kind": "provider",
      "title": "Chutes",
      "summary": "Chutes hosted models through an OpenAI-compatible API.",
      "aliases": ["chutes ai"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://llm.chutes.ai/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.deepinfra",
      "kind": "provider",
      "title": "DeepInfra",
      "summary": "DeepInfra hosted models through its OpenAI-compatible prefix.",
      "aliases": ["deep infra"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://api.deepinfra.com/v1/openai",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.together",
      "kind": "provider",
      "title": "Together AI",
      "summary": "Together hosted inference through its OpenAI-compatible API.",
      "aliases": ["together"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://api.together.xyz/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.fireworks",
      "kind": "provider",
      "title": "Fireworks AI",
      "summary": "Fireworks hosted inference through its OpenAI-compatible prefix.",
      "aliases": ["fireworks"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://api.fireworks.ai/inference/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.mistral",
      "kind": "provider",
      "title": "Mistral AI",
      "summary": "Mistral hosted models through an OpenAI-compatible API.",
      "aliases": ["mistral"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://api.mistral.ai/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.cerebras",
      "kind": "provider",
      "title": "Cerebras",
      "summary": "Cerebras inference through its OpenAI-compatible API.",
      "aliases": ["cerebras cloud"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://api.cerebras.ai/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.sambanova",
      "kind": "provider",
      "title": "SambaNova",
      "summary": "SambaNova inference through its OpenAI-compatible API.",
      "aliases": ["samba nova"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://api.sambanova.ai/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.nvidia",
      "kind": "provider",
      "title": "NVIDIA NIM",
      "summary": "NVIDIA-hosted NIM models through an OpenAI-compatible API.",
      "aliases": ["nvidia", "nim"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://integrate.api.nvidia.com/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.hyperbolic",
      "kind": "provider",
      "title": "Hyperbolic",
      "summary": "Hyperbolic hosted models through an OpenAI-compatible API.",
      "aliases": ["hyperbolic xyz"],
      "keywords": ["cloud", "openai compatible"],
      "maturity": "stable",
      "protocol": "openai-chat",
      "base_url": "https://api.hyperbolic.xyz/v1",
      "auth": "Bearer",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "provider-guide"}],
      "related": ["capability.bring-your-own-inference", "config.provider-credentials"]
    },
    {
      "id": "provider.custom",
      "kind": "provider",
      "title": "Custom inference endpoint",
      "summary": "A user-supplied endpoint that remains disabled until its protocol is declared explicitly.",
      "aliases": ["custom provider", "custom URL"],
      "keywords": ["fail closed", "unknown protocol", "endpoint"],
      "maturity": "stable",
      "protocol": "explicitly required",
      "auth": "configured per endpoint",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "fail-closed-contract"}],
      "related": ["capability.bring-your-own-inference", "config.provider-protocol"]
    },
    {
      "id": "tool.web-search",
      "kind": "tool",
      "title": "Web search",
      "summary": "Search the web from an Omnius agent loop; discoverable as metadata but intentionally not assumed to be directly callable.",
      "aliases": ["web_search", "internet search", "search the web"],
      "keywords": ["agent-bound", "network read", "factual-first", "sources"],
      "maturity": "stable",
      "direct_callable": false,
      "prerequisites": ["Run-scope daemon access", "Configured model with tool calling", "Network access"],
      "interfaces": [
        {"type": "metadata", "target": "GET /v1/tools/web_search", "description": "Inspect schema and live invocation mode"},
        {"type": "agent", "target": "POST /v1/run"},
        {"type": "agent", "target": "POST /v1/chat"},
        {"type": "agent", "target": "POST /v1/chat/completions"}
      ],
      "references": [
        {"type": "guide", "target": "docs/guides/tools-and-web-search.md", "relation": "canonical-guide"},
        {"type": "api", "target": "docs/rest/endpoints/tools.md", "relation": "wire-contract"}
      ],
      "related": ["api.tools", "tool.tool-search", "operation.version-compatibility"]
    },
    {
      "id": "tool.adjudicate",
      "kind": "tool",
      "title": "Evidence-bound adjudication",
      "summary": "Resolve one genuine decision impasse outside the accumulated parent narrative through a frozen evidence record, process-isolated tools-free constituent review, deterministic planner fallback, host-validated citations, quorum and dissent, a final judge, and replay-verifiable durable artifacts.",
      "aliases": ["adjudicate", "adjudication", "decision impasse", "impartial decision", "evidence-bound decision"],
      "keywords": ["agent-bound", "impasse", "evidence", "constituents", "quorum", "judge", "verdict", "dissent"],
      "maturity": "stable",
      "layer": "orchestration",
      "audiences": ["coding-agent", "maintainer", "interactive-user"],
      "direct_callable": false,
      "use_when": [
        "A top-level full agent has one exact unresolved decision with at least two materially plausible outcomes",
        "The admissible evidence supports conflicting conclusions or risk tradeoffs",
        "The decision changes the next action and benefits from fresh evidence-scoped review that reduces parent-context anchoring",
        "The caller can make record selection and framing explicit and auditable"
      ],
      "avoid_when": [
        "The question is an ordinary implementation choice, factual lookup, or substitute for gathering missing evidence",
        "The caller is a child agent, daemon direct-tool client, bounded /v1/chat/completions loop, Telegram runner, or voice-call runner"
      ],
      "interfaces": [
        {"type": "tui-agent-tool", "target": "omnius", "description": "Top-level interactive agent with the specialized streamed adjudication block"},
        {"type": "cli-agent-tool", "target": "omnius \"<task>\"", "description": "Top-level one-shot agent with ordinary tool events"},
        {"type": "agent-run", "target": "POST /v1/run", "description": "Spawned top-level full agent; subject to the active tool profile"},
        {"type": "agent-chat", "target": "POST /v1/chat", "description": "Default full-agent chat mode; subject to the active tool profile"}
      ],
      "references": [
        {"type": "guide", "target": "docs/ADJUDICATION.md", "relation": "canonical-guide"},
        {"type": "source", "target": "packages/orchestrator/src/adjudication.ts", "relation": "implementation"},
        {"type": "source", "target": "packages/execution/src/tools/full-sub-agent.ts", "relation": "isolated-constituent-process"},
        {"type": "source", "target": "packages/cli/src/commands/adjudication-constituent.ts", "relation": "tools-free-child-entrypoint"},
        {"type": "source", "target": "packages/cli/src/tui/interactive.ts", "relation": "top-level-registration"},
        {"type": "source", "target": "packages/cli/src/tui/adjudication-live-block.ts", "relation": "live-projection"}
      ],
      "related": ["workflow.evidence-bound-adjudication", "layer.orchestration", "layer.observability", "module.orchestrator", "guide.adjudication-uppercase"],
      "verification": [
        {"check": "Run pnpm harness:adjudication", "expected": "Parallel constituent streams, judge synthesis, and replay-verifiable durable artifacts complete without loading a real model"},
        {"check": "Run the adjudication full-sub-agent and internal-profile tests", "expected": "Real child processes run concurrently with tools and mutation closed; cancellation, deadline, fallback, recombination, and context isolation pass"},
        {"check": "Inspect the parent-runner and child-agent tool registration tests", "expected": "Top-level full agents keep adjudicate inline and host scope enforcement excludes it from child runners"}
      ],
      "failure_modes": [
        {"symptom": "A caller attempts /v1/tools/adjudicate/call", "likely_cause": "Static tool discovery was mistaken for daemon direct-tool exposure", "recovery": "Use a top-level TUI, one-shot CLI, /v1/run, or default full-agent /v1/chat path"},
        {"symptom": "A finding reports direct_bounded after auto requested process isolation", "likely_cause": "The dedicated full_sub_agent child profile failed before returning a contract", "recovery": "Inspect the recorded constituent fallback failure and child process health; cancellation and deadlines intentionally do not fall through"},
        {"symptom": "The case returns held instead of a verdict", "likely_cause": "Admission, citation validation, quorum, or final verdict validation failed", "recovery": "Inspect the receipt and provide a corrected admissible record; do not infer a decision"}
      ],
      "source_of_truth": ["docs/ADJUDICATION.md", "packages/orchestrator/src/adjudication.ts", "packages/execution/src/tools/full-sub-agent.ts", "packages/cli/src/commands/adjudication-constituent.ts", "packages/cli/src/tui/interactive.ts"]
    },
    {
      "id": "tool.tool-search",
      "kind": "tool",
      "title": "Tool search",
      "summary": "Find relevant tool schemas without loading the entire tool catalog into an agent context.",
      "aliases": ["tool_search", "explore_tools"],
      "keywords": ["tool discovery", "schema", "large catalog"],
      "maturity": "stable",
      "references": [{"type": "guide", "target": "docs/guides/tools-and-web-search.md", "relation": "canonical-guide"}],
      "related": ["api.tools", "tool.web-search"]
    },
    {
      "id": "api.discovery",
      "kind": "api",
      "title": "Discovery API",
      "summary": "Search the Omnius capability catalog and expand a stable entry over REST.",
      "aliases": ["discovery endpoint", "capabilities api"],
      "keywords": ["search", "catalog", "etag", "pagination"],
      "maturity": "stable",
      "interfaces": [
        {"type": "http", "target": "GET /v1/discovery"},
        {"type": "http", "target": "GET /v1/discovery/{id}"}
      ],
      "references": [
        {"type": "api", "target": "docs/rest/endpoints/discovery.md", "relation": "wire-contract"},
        {"type": "schema", "target": "docs/DISCOVERY.json", "relation": "offline-catalog"}
      ],
      "related": ["overview", "command.discover", "command.show"]
    },
    {
      "id": "api.tools",
      "kind": "api",
      "title": "Tools API",
      "summary": "Inspect live tool schemas and invocation metadata, register external tools, and call only tools marked direct-callable.",
      "aliases": ["tools endpoint", "direct tool api"],
      "keywords": ["tool metadata", "direct_callable", "MCP", "external tools"],
      "maturity": "stable",
      "interfaces": [
        {"type": "http", "target": "GET /v1/tools"},
        {"type": "http", "target": "GET /v1/tools/{name}"},
        {"type": "http", "target": "POST /v1/tools/{name}/call"}
      ],
      "references": [{"type": "api", "target": "docs/rest/endpoints/tools.md", "relation": "wire-contract"}],
      "related": ["tool.web-search", "tool.tool-search", "operation.version-compatibility"]
    },
    {
      "id": "api.skills",
      "kind": "api",
      "title": "Skills API",
      "summary": "List and load Omnius and project skills incrementally.",
      "aliases": ["skills endpoint", "skill discovery"],
      "keywords": ["skills", "incremental context"],
      "maturity": "stable",
      "interfaces": [
        {"type": "http", "target": "GET /v1/skills"},
        {"type": "http", "target": "GET /v1/skills/{name}"}
      ],
      "references": [{"type": "api", "target": "docs/rest/endpoints/skills.md", "relation": "wire-contract"}],
      "related": ["skill.omnius-docs", "skill.omnius-rest-docs"]
    },
    {
      "id": "api.openapi",
      "kind": "api",
      "title": "OpenAPI contract",
      "summary": "The live machine-readable REST contract for the running Omnius daemon.",
      "aliases": ["swagger", "openapi.json", "api docs"],
      "keywords": ["OpenAPI", "REST", "schema"],
      "maturity": "stable",
      "interfaces": [
        {"type": "http", "target": "GET /openapi.json"},
        {"type": "http", "target": "GET /docs"}
      ],
      "references": [{"type": "guide", "target": "docs/rest/openapi-source.md", "relation": "documentation"}],
      "related": ["api.discovery", "api.tools", "operation.version-compatibility"]
    },
    {
      "id": "command.discover",
      "kind": "command",
      "title": "Discover capabilities",
      "summary": "Rank Omnius capabilities by intent, with optional kind and result limits.",
      "aliases": ["omnius discover"],
      "keywords": ["search", "catalog", "json"],
      "maturity": "stable",
      "interfaces": [{"type": "cli", "target": "omnius discover \"<query>\" [--kind <kind>] [--limit <n>] [--json]"}],
      "references": [{"type": "guide", "target": "docs/DISCOVERY.md", "relation": "usage"}],
      "related": ["api.discovery", "command.show", "overview"]
    },
    {
      "id": "command.show",
      "kind": "command",
      "title": "Show a capability",
      "summary": "Expand one Omnius discovery entry by stable ID.",
      "aliases": ["omnius show"],
      "keywords": ["expand", "entry", "json"],
      "maturity": "stable",
      "interfaces": [{"type": "cli", "target": "omnius show <id> [--json]"}],
      "references": [{"type": "guide", "target": "docs/DISCOVERY.md", "relation": "usage"}],
      "related": ["api.discovery", "command.discover"]
    },
    {
      "id": "command.docs",
      "kind": "command",
      "title": "Open the documentation overview",
      "summary": "Print the human-readable Omnius documentation and discovery entrypoints.",
      "aliases": ["omnius docs"],
      "keywords": ["documentation", "overview"],
      "maturity": "stable",
      "interfaces": [{"type": "cli", "target": "omnius docs"}],
      "references": [{"type": "guide", "target": "docs/DISCOVERY.md", "relation": "overview"}],
      "related": ["overview", "command.discover"]
    },
    {
      "id": "command.capabilities",
      "kind": "command",
      "title": "List machine capabilities",
      "summary": "Print the complete Omnius discovery catalog for programmatic use.",
      "aliases": ["omnius capabilities"],
      "keywords": ["json", "catalog", "machine-readable"],
      "maturity": "stable",
      "interfaces": [{"type": "cli", "target": "omnius capabilities --json"}],
      "references": [{"type": "schema", "target": "docs/DISCOVERY.json", "relation": "output-contract"}],
      "related": ["overview", "api.discovery"]
    },
    {
      "id": "command.init",
      "kind": "command",
      "title": "Initialize agent discovery guidance",
      "summary": "Create or update managed Omnius discovery blocks in project guidance while preserving user content.",
      "aliases": ["omnius init"],
      "keywords": ["AGENTS.md", "OMNIUS.md", "check", "dry-run"],
      "maturity": "stable",
      "interfaces": [{"type": "cli", "target": "omnius init [--check|--dry-run|--json]"}],
      "references": [{"type": "guide", "target": "docs/getting-started/install.md", "relation": "usage"}],
      "related": ["operation.install-discovery", "overview"]
    },
    {
      "id": "config.provider-credentials",
      "kind": "config",
      "title": "Provider credential precedence",
      "summary": "Resolve one upstream credential from the explicit provider namespace through compatibility and persisted settings.",
      "aliases": ["provider keys", "api key precedence", "inference key"],
      "keywords": ["OMNIUS_PROVIDER_API_KEY", "OMNIUS_MODEL_API_KEY", "OMNIUS_UPSTREAM_API_KEY", "VLLM_API_KEY"],
      "maturity": "stable",
      "interfaces": [{"type": "environment", "target": "OMNIUS_PROVIDER_API_KEY > OMNIUS_MODEL_API_KEY > OMNIUS_UPSTREAM_API_KEY > OMNIUS_API_KEY > VLLM_API_KEY > persisted config"}],
      "references": [
        {"type": "config", "target": "docs/reference/configuration.md", "relation": "canonical-reference"},
        {"type": "security", "target": "docs/reference/auth-map.md", "relation": "boundary-map"}
      ],
      "related": ["capability.bring-your-own-inference", "config.rest-auth"]
    },
    {
      "id": "config.rest-auth",
      "kind": "config",
      "title": "REST bearer authentication",
      "summary": "Authenticate daemon callers with scoped, rate-limited, revocable bearer keys kept separate from provider credentials.",
      "aliases": ["daemon auth", "rest api key", "scopes"],
      "keywords": ["OMNIUS_REST_API_KEY", "OMNIUS_REST_API_KEYS", "read", "run", "admin"],
      "maturity": "stable",
      "references": [
        {"type": "security", "target": "docs/rest/auth-and-scopes.md", "relation": "canonical-reference"},
        {"type": "security", "target": "docs/reference/auth-map.md", "relation": "boundary-map"}
      ],
      "related": ["config.provider-credentials", "api.tools"]
    },
    {
      "id": "config.provider-protocol",
      "kind": "config",
      "title": "Provider protocol selection",
      "summary": "Select ollama, openai-chat, or anthropic-messages explicitly; ambiguous custom endpoints remain disabled without network requests.",
      "aliases": ["endpoint protocol", "unknown protocol", "fail closed provider"],
      "keywords": ["ollama", "openai-chat", "anthropic-messages", "custom endpoint"],
      "maturity": "stable",
      "references": [{"type": "guide", "target": "docs/guides/bring-your-own-inference.md", "relation": "canonical-reference"}],
      "related": ["capability.bring-your-own-inference", "provider.custom"]
    },
    {
      "id": "operation.version-compatibility",
      "kind": "operation",
      "title": "Service version compatibility",
      "summary": "Reject execution before handler state creation when the running Omnius package is older than the client's required SemVer.",
      "aliases": ["runtime version gate", "stale Omnius service", "minimum version"],
      "keywords": ["X-Omnius-Min-Version", "412", "400", "package_version"],
      "maturity": "stable",
      "interfaces": [
        {"type": "http", "target": "GET /version", "description": "Inspect package and API compatibility"},
        {"type": "header", "target": "X-Omnius-Min-Version: <semver>", "description": "Execution-time precondition"}
      ],
      "references": [{"type": "operation", "target": "docs/operations/version-compatibility.md", "relation": "canonical-guide"}],
      "related": ["api.discovery", "api.tools", "capability.bring-your-own-inference"]
    },
    {
      "id": "operation.hardware-preflight",
      "kind": "operation",
      "title": "Local inference hardware preflight",
      "summary": "Verify the requested endpoint, exact model, and actual GPU placement before any token-generating local inference.",
      "aliases": ["GPU gate", "nvidia-smi preflight", "local model hardware"],
      "keywords": ["Ollama", "GPU placement", "CUDA_VISIBLE_DEVICES", "zero-token probe"],
      "maturity": "stable",
      "prerequisites": ["User-designated endpoint", "Exact model tag", "Requested capable GPU"],
      "references": [{"type": "policy", "target": "AGENTS.md", "relation": "mandatory-gate"}],
      "related": ["provider.ollama", "provider.vllm", "capability.bring-your-own-inference"]
    },
    {
      "id": "operation.install-discovery",
      "kind": "operation",
      "title": "Installation discovery bootstrap",
      "summary": "Expose concise secret-free discovery commands after install and add managed project guidance with omnius init.",
      "aliases": ["postinstall discovery", "agent setup", "omnius init"],
      "keywords": ["installation", "AGENTS.md", "OMNIUS.md", "managed markers"],
      "maturity": "stable",
      "interfaces": [{"type": "cli", "target": "omnius init [--check|--dry-run|--json]"}],
      "references": [{"type": "guide", "target": "docs/getting-started/install.md", "relation": "canonical-guide"}],
      "related": ["command.init", "overview"]
    },
    {
      "id": "skill.omnius-docs",
      "kind": "skill",
      "title": "Omnius documentation router",
      "summary": "Find the smallest Omnius documentation artifact needed for a question.",
      "aliases": ["omnius-docs"],
      "keywords": ["docs", "routing", "incremental context"],
      "maturity": "stable",
      "references": [{"type": "skill", "target": ".aiwg/addons/omnius-docs/skills/omnius-docs/SKILL.md", "relation": "definition"}],
      "related": ["overview", "skill.omnius-rest-docs"]
    },
    {
      "id": "skill.omnius-rest-docs",
      "kind": "skill",
      "title": "Omnius REST documentation router",
      "summary": "Route a REST API question to the smallest endpoint-family reference.",
      "aliases": ["omnius-rest-docs"],
      "keywords": ["REST", "OpenAPI", "endpoint"],
      "maturity": "stable",
      "references": [{"type": "skill", "target": ".aiwg/addons/omnius-rest-docs/skills/omnius-rest-docs/SKILL.md", "relation": "definition"}],
      "related": ["api.openapi", "api.discovery", "skill.omnius-docs"]
    },
    {
      "id": "skill.omnius-inference-docs",
      "kind": "skill",
      "title": "Omnius inference documentation",
      "summary": "Route provider, protocol, credential, Claude, Gemini, and custom endpoint questions.",
      "aliases": ["omnius-inference-docs"],
      "keywords": ["provider", "inference", "keys", "protocol"],
      "maturity": "stable",
      "references": [{"type": "skill", "target": ".aiwg/addons/omnius-docs/skills/omnius-inference-docs/SKILL.md", "relation": "definition"}],
      "related": ["capability.bring-your-own-inference"]
    },
    {
      "id": "skill.omnius-tools-docs",
      "kind": "skill",
      "title": "Omnius tools documentation",
      "summary": "Route tool discovery and direct-versus-agent-bound invocation questions.",
      "aliases": ["omnius-tools-docs"],
      "keywords": ["tools", "web search", "direct callable", "MCP"],
      "maturity": "stable",
      "references": [{"type": "skill", "target": ".aiwg/addons/omnius-docs/skills/omnius-tools-docs/SKILL.md", "relation": "definition"}],
      "related": ["tool.web-search", "api.tools"]
    },
    {
      "id": "skill.omnius-integration-docs",
      "kind": "skill",
      "title": "Omnius integration documentation",
      "summary": "Route agent and service integration through discovery, OpenAPI, provider, tool, auth, and version contracts.",
      "aliases": ["omnius-integration-docs"],
      "keywords": ["integration", "adapter", "service", "agent"],
      "maturity": "stable",
      "references": [{"type": "skill", "target": ".aiwg/addons/omnius-docs/skills/omnius-integration-docs/SKILL.md", "relation": "definition"}],
      "related": ["api.discovery", "operation.version-compatibility"]
    },
    {
      "id": "skill.omnius-version-compatibility-docs",
      "kind": "skill",
      "title": "Omnius version compatibility documentation",
      "summary": "Route stale-daemon and minimum-version questions to the runtime gate contract.",
      "aliases": ["omnius-version-compatibility-docs"],
      "keywords": ["version", "stale service", "412", "SemVer"],
      "maturity": "stable",
      "references": [{"type": "skill", "target": ".aiwg/addons/omnius-docs/skills/omnius-version-compatibility-docs/SKILL.md", "relation": "definition"}],
      "related": ["operation.version-compatibility"]
    },
    {
      "id": "skill.browser-interaction-validation",
      "kind": "skill",
      "title": "Browser interaction validation",
      "summary": "Validate a user-facing browser flow with canonical Playwright interactions, explicit postconditions, and honest blocked or inconclusive evidence.",
      "aliases": ["browser interaction validation", "UI interaction test", "Playwright validation", "browser flow"],
      "keywords": ["dashboard validation", "form interaction", "postcondition", "browser evidence"],
      "maturity": "stable"
    },
    {
      "id": "skill.evidence-directed-delivery",
      "kind": "skill",
      "title": "Evidence-directed delivery",
      "summary": "Use claim-and-evidence, anti-reward-hacking, bounded recovery, and feedback-only completion rules for non-trivial work.",
      "aliases": ["evidence based completion", "delivery audit", "completion evidence"],
      "keywords": ["verify claims", "remaining gaps", "evidence"],
      "maturity": "stable"
    },
    {
      "id": "skill.workspace-reality-audit",
      "kind": "skill",
      "title": "Workspace reality audit",
      "summary": "Audit repository truth, generated artifacts, documentation drift, and delivery ownership before claiming progress.",
      "aliases": ["workspace audit", "repository reality"],
      "keywords": ["stale artifact", "untracked source", "documentation drift"],
      "maturity": "stable"
    },
    {
      "id": "skill.test-surface-audit",
      "kind": "skill",
      "title": "Test surface audit",
      "summary": "Map canonical tests to claims and expose placeholder, mock-only, copied-logic, and unwired verification gaps.",
      "aliases": ["test audit", "test coverage", "test surface"],
      "keywords": ["canonical test", "mock only", "verification"],
      "maturity": "stable"
    },
    {
      "id": "skill.runtime-provenance-audit",
      "kind": "skill",
      "title": "Runtime provenance audit",
      "summary": "Prove active process, artifact, port, configuration, and restart ownership for runtime claims.",
      "aliases": ["runtime provenance", "deployed version", "process audit"],
      "keywords": ["service ownership", "running artifact", "deployment"],
      "maturity": "stable"
    },
    {
      "id": "skill.hardware-evidence-audit",
      "kind": "skill",
      "title": "Hardware evidence audit",
      "summary": "Classify static, simulation, integration, and physical-device evidence without overstating hardware proof.",
      "aliases": ["hardware validation", "device evidence", "simulation versus hardware"],
      "keywords": ["firmware test", "physical device", "evidence ladder"],
      "maturity": "stable"
    },
    {
      "id": "skill.secrets-and-config-audit",
      "kind": "skill",
      "title": "Secrets and configuration audit",
      "summary": "Audit credential and configuration provenance without exposing secret values.",
      "aliases": ["secret audit", "credential provenance", "endpoint credential"],
      "keywords": ["configuration security", "secrets", "redaction"],
      "maturity": "stable"
    },
    {
      "id": "skill.agent-failure-recovery",
      "kind": "skill",
      "title": "Agent failure recovery",
      "summary": "Convert failed calls into bounded evidence-backed recovery actions and stop blind retries.",
      "aliases": ["recover tool failure", "stale hash", "unknown tool"],
      "keywords": ["retry loop", "agent recovery", "bounded recovery"],
      "maturity": "stable"
    }
  ]
}
