{
  "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.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"
    }
  ]
}
