omnius 1.0.591 → 1.0.592

package/docs/discovery/catalog-overrides.json

@@ -0,0 +1,724 @@
+{
+  "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",
+        "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": "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"
+    }
+  ]
+}