{
  "$schema": "command-manifest.schema.json",
  "description": "Agent-Nuvira command manifest — maps plain-English intents to CLI commands. Feed this file (or the docs/COMMANDS.md it mirrors) to the agent so it can execute any task by running the right 'buff' command.",
  "version": "1.0.0",
  "note": "Ambiguous asks are represented by entries sharing an 'ambiguityGroup'; the router must ask the user which group member they mean before executing.",
  "intents": [
    {
      "intent": "dashboard.start",
      "summary": "Start the web dashboard",
      "aliases": ["start the dashboard", "open the dashboard", "launch the dashboard", "run the dashboard", "start the web ui", "open the web ui"],
      "objective": "Launch the web UI (Agent Hub, Channels, Tasks, Chat, Gateway ops, Admin)",
      "command": "nuvira dashboard",
      "example": "nuvira dashboard",
      "args": [
        { "name": "port", "flag": "--port", "optional": true, "example": "--port 8080" },
        { "name": "noOpen", "flag": "--no-open", "optional": true, "example": "--no-open" }
      ],
      "rbac": "dashboard.manage",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "dashboard.stop",
      "summary": "Stop the web dashboard gracefully",
      "aliases": ["stop the dashboard", "kill the dashboard", "bounce the dashboard", "shut down the dashboard", "shutdown dashboard", "stop the web ui", "turn off the dashboard"],
      "objective": "Gracefully stop a running dashboard from any terminal",
      "command": "nuvira dashboard stop",
      "example": "nuvira dashboard stop",
      "args": [
        { "name": "port", "flag": "--port", "optional": true, "example": "--port 8080" }
      ],
      "rbac": "dashboard.manage",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "gateway.start",
      "summary": "Start the multi-channel gateway",
      "aliases": ["start the gateway", "run the gateway", "bring up the gateway", "start gateway", "start the bot", "start messaging"],
      "objective": "Run all configured adapters so the agent answers on WhatsApp/Telegram/Discord/Slack/Email/Signal",
      "command": "nuvira gateway start",
      "example": "nuvira gateway start",
      "args": [
        { "name": "port", "flag": "--port", "optional": true, "example": "--port 9090" },
        { "name": "host", "flag": "--host", "optional": true, "example": "--host 0.0.0.0" },
        { "name": "noEvents", "flag": "--no-events", "optional": true, "example": "--no-events" }
      ],
      "rbac": "gateway.manage",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "gateway.stop",
      "summary": "Stop the running gateway gracefully",
      "aliases": ["stop the gateway", "kill the gateway", "shut down the gateway", "stop gateway", "stop the bot", "turn off the gateway"],
      "objective": "Gracefully SIGTERM a running gateway from any terminal",
      "command": "nuvira gateway stop",
      "example": "nuvira gateway stop",
      "args": [
        { "name": "port", "flag": "--port", "optional": true, "example": "--port 9090" }
      ],
      "rbac": "gateway.manage",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "gateway.status",
      "summary": "Show gateway status and reachable channels",
      "aliases": ["gateway status", "is the gateway running", "what channels are connected", "gateway health", "status of the gateway", "is the bot online", "check the gateway health", "is the gateway healthy"],
      "objective": "See which platforms are configured and which channels are reachable",
      "command": "nuvira gateway status",
      "example": "nuvira gateway status",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "gateway.send",
      "summary": "Send a message to a channel",
      "aliases": ["send a message", "send to", "message the channel", "notify the channel", "post to", "send a whatsapp message", "send a telegram message", "send sms"],
      "objective": "Send a one-shot message to an alias or platform:channelId",
      "command": "nuvira gateway send <target> \"<text>\"",
      "example": "nuvira gateway send ops \"nightly build done\"",
      "args": [
        { "name": "target", "flag": "<target>", "optional": false, "example": "ops | telegram:123456789 | whatsapp:Alex | whatsapp:+919876543210" },
        { "name": "text", "flag": "\"<text>\"", "optional": false, "example": "\"your report is ready\"" }
      ],
      "rbac": "gateway.send",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["target", "text"]
    },
    {
      "intent": "gateway.send-media",
      "summary": "Send a media file to a channel",
      "aliases": ["send an image", "send a file", "send a photo", "send a document", "send a video", "send media"],
      "objective": "Send an image/video/audio/document to a channel",
      "command": "nuvira gateway send-media <target> <file> [--caption <text>]",
      "example": "nuvira gateway send-media ops ./screenshot.png --caption \"new build\"",
      "args": [
        { "name": "target", "flag": "<target>", "optional": false, "example": "ops" },
        { "name": "file", "flag": "<file>", "optional": false, "example": "./report.pdf" },
        { "name": "caption", "flag": "--caption", "optional": true, "example": "--caption \"v2\"" }
      ],
      "rbac": "gateway.send",
      "confirmation": false,
      "platforms": ["whatsapp", "telegram", "discord"],
      "requires": ["target", "file"]
    },
    {
      "intent": "alias.add",
      "summary": "Register a channel alias",
      "aliases": ["add an alias", "create an alias", "name a channel", "register a channel alias"],
      "objective": "Give a channel a friendly name so 'buff gateway send <alias>' works",
      "command": "nuvira gateway alias add <alias> <platform> <channelId>",
      "example": "nuvira gateway alias add ops slack C0123",
      "args": [
        { "name": "alias", "flag": "<alias>", "optional": false, "example": "ops" },
        { "name": "platform", "flag": "<platform>", "optional": false, "example": "slack" },
        { "name": "channelId", "flag": "<channelId>", "optional": false, "example": "C0123" }
      ],
      "rbac": "gateway.manage",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["alias", "platform", "channelId"]
    },
    {
      "intent": "alias.remove",
      "summary": "Remove a channel alias",
      "aliases": ["remove an alias", "delete an alias", "drop the alias"],
      "objective": "Delete a registered channel alias",
      "command": "nuvira gateway alias remove <alias>",
      "example": "nuvira gateway alias remove ops",
      "args": [{ "name": "alias", "flag": "<alias>", "optional": false, "example": "ops" }],
      "rbac": "gateway.manage",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["alias"]
    },
    {
      "intent": "contacts.add",
      "summary": "Add a person to a WhatsApp/sender contact list",
      "aliases": ["add <name> to whatsapp", "add <name> contact", "add a contact", "save a contact", "add <name> mobile", "add <name> number", "add rahul to whatsapp"],
      "objective": "AMBIGUOUS — two lists exist. The router MUST ask which one: (a) verified list = the number can TRIGGER the agent; (b) send-by-name mapping = you can send TO them by name.",
      "ambiguityGroup": "contacts.add",
      "resolutions": [
        {
          "when": "trigger / respond to / message the bot / verified list",
          "command": "nuvira config gateway allow whatsapp user <number>",
          "example": "nuvira config gateway allow whatsapp user 919958604222",
          "summary": "Verified list — the number may trigger the agent",
          "rbac": "gateway.manage",
          "confirmation": false
        },
        {
          "when": "send by name / send to them / send-by-name mapping",
          "command": "nuvira whatsapp contact add <Name> <number>",
          "example": "nuvira whatsapp contact add Rahul 919958604222",
          "summary": "Send-by-name mapping — lets YOU send to them by name (does NOT grant trigger access)",
          "rbac": "gateway.manage",
          "confirmation": false
        }
      ]
    },
    {
      "intent": "contacts.remove",
      "summary": "Remove a person from a WhatsApp/sender contact list",
      "aliases": ["remove <name> from whatsapp", "delete <name> contact", "block <name>", "remove a contact", "remove <name> from the verified list"],
      "objective": "AMBIGUOUS — remove from the verified (trigger) list or the send-by-name mapping. Router must ask which.",
      "ambiguityGroup": "contacts.remove",
      "resolutions": [
        {
          "when": "block / stop them messaging / verified list",
          "command": "nuvira config gateway disallow whatsapp user <number>",
          "example": "nuvira config gateway disallow whatsapp user 919958604222",
          "summary": "Remove from verified list — they can no longer trigger the agent",
          "rbac": "gateway.manage",
          "confirmation": true
        },
        {
          "when": "send-by-name mapping",
          "command": "nuvira whatsapp contact remove <Name>",
          "example": "nuvira whatsapp contact remove Rahul",
          "summary": "Remove the send-by-name mapping",
          "rbac": "gateway.manage",
          "confirmation": false
        }
      ]
    },
    {
      "intent": "contacts.list",
      "summary": "List saved sender contacts",
      "aliases": ["what contacts do i have", "list contacts", "show contacts", "who is saved", "list saved contacts"],
      "objective": "Show the resolvable send-by-name contacts (numbers masked on screen)",
      "command": "nuvira whatsapp contacts",
      "example": "nuvira whatsapp contacts",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["whatsapp"]
    },
    {
      "intent": "permissions.allow",
      "summary": "Allow a user/group to trigger the agent on a platform",
      "aliases": ["let <name> message the bot", "allow <name> to trigger", "allow <number> on whatsapp", "add <name> to verified list", "allow a group", "approve <name>"],
      "objective": "Add a sender to the verified (trigger) list on a platform. Blank list = no one may trigger; 'Allow-All' = everyone.",
      "command": "nuvira config gateway allow <platform> user|group <id...>",
      "example": "nuvira config gateway allow whatsapp user 919958604222",
      "args": [
        { "name": "platform", "flag": "<platform>", "optional": false, "example": "whatsapp | telegram | discord" },
        { "name": "kind", "flag": "<user|group>", "optional": false, "example": "user" },
        { "name": "ids", "flag": "<id...>", "optional": false, "example": "919958604222" }
      ],
      "rbac": "gateway.manage",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["platform", "kind", "ids"]
    },
    {
      "intent": "permissions.disallow",
      "summary": "Remove a user/group from the allowed list",
      "aliases": ["block <name>", "disallow <name>", "remove <name> from verified list", "ban <name>", "stop <name> triggering"],
      "objective": "Remove a sender from the verified (trigger) list on a platform",
      "command": "nuvira config gateway disallow <platform> user|group <id...>",
      "example": "nuvira config gateway disallow whatsapp user 919958604222",
      "args": [
        { "name": "platform", "flag": "<platform>", "optional": false, "example": "whatsapp" },
        { "name": "kind", "flag": "<user|group>", "optional": false, "example": "user" },
        { "name": "ids", "flag": "<id...>", "optional": false, "example": "919958604222" }
      ],
      "rbac": "gateway.manage",
      "confirmation": true,
      "platforms": ["*"],
      "requires": ["platform", "kind", "ids"]
    },
    {
      "intent": "permissions.reply-mode",
      "summary": "Set how unapproved senders are handled",
      "aliases": ["reply mode", "polite mode", "silent mode", "how are unknown senders handled", "set silent drops"],
      "objective": "polite = refusal message; silent = drop with no reply (default)",
      "command": "nuvira config gateway reply <platform> <polite|silent>",
      "example": "nuvira config gateway reply whatsapp silent",
      "args": [
        { "name": "platform", "flag": "<platform>", "optional": false, "example": "whatsapp" },
        { "name": "mode", "flag": "<polite|silent>", "optional": false, "example": "silent" }
      ],
      "rbac": "gateway.manage",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["platform", "mode"]
    },
    {
      "intent": "permissions.status-recipients",
      "summary": "Manage status recipients (always get completion summaries)",
      "aliases": ["status recipients", "who gets the summary", "notify list", "add a status recipient"],
      "objective": "Contacts/groups that ALWAYS receive pipeline completion summaries",
      "command": "nuvira config gateway notify <add|remove|list> [target...]",
      "example": "nuvira config gateway notify add whatsapp:Alex slack:ops",
      "args": [
        { "name": "action", "flag": "<add|remove|list>", "optional": false, "example": "add" },
        { "name": "targets", "flag": "[target...]", "optional": true, "example": "whatsapp:Alex slack:ops" }
      ],
      "rbac": "gateway.manage",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "whatsapp.pair",
      "summary": "Pair WhatsApp (QR or phone code)",
      "aliases": ["pair whatsapp", "connect whatsapp", "link whatsapp", "scan the qr", "setup whatsapp bridge", "enable whatsapp", "enable whatsapp support", "activate whatsapp", "setup whatsapp", "turn on whatsapp", "start whatsapp support", "enable whatsapp bridge"],
      "objective": "Pair your personal WhatsApp number so the gateway can read/write messages",
      "command": "nuvira whatsapp pair [--phone <number>] [--timeout <seconds>]",
      "example": "nuvira whatsapp pair --phone 919876543210",
      "args": [
        { "name": "phone", "flag": "--phone", "optional": true, "example": "--phone 919876543210" },
        { "name": "timeout", "flag": "--timeout", "optional": true, "example": "--timeout 120" }
      ],
      "rbac": "gateway.manage",
      "confirmation": false,
      "platforms": ["whatsapp"]
    },
    {
      "intent": "whatsapp.status",
      "summary": "WhatsApp bridge status",
      "aliases": ["whatsapp status", "is whatsapp connected", "bridge status", "whatsapp paired"],
      "objective": "Check the bridge session path and pairing state",
      "command": "nuvira whatsapp status",
      "example": "nuvira whatsapp status",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["whatsapp"]
    },
    {
      "intent": "platform.setup",
      "summary": "Configure a platform transport (Telegram, Discord, Matrix, ...)",
      "aliases": ["set up telegram", "enable telegram", "add telegram", "configure telegram", "setup telegram bot", "enable telegram support", "setup telegram", "turn on telegram", "enable telegram bot", "add discord", "configure discord", "enable discord", "enable discord support", "setup discord", "setup a channel", "enable matrix", "enable sms", "setup sms", "enable email channel"],
      "objective": "Set the API token / env vars a platform needs (written to ~/.buff/.env). Interactive wizard by default; --set for non-interactive.",
      "command": "nuvira config gateway set <platform> [--set VAR=value]",
      "example": "nuvira config gateway set telegram --set BUFF_TELEGRAM_TOKEN=123456789:AAH...",
      "args": [
        { "name": "platform", "flag": "<platform>", "optional": false, "example": "telegram | discord | matrix | sms" },
        { "name": "set", "flag": "--set", "optional": true, "example": "--set BUFF_TELEGRAM_TOKEN=123:ABC", "repeatable": true }
      ],
      "rbac": "gateway.manage",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["platform"]
    },
    {
      "intent": "platform.remove",
      "summary": "Remove a platform transport",
      "aliases": ["remove telegram", "delete telegram", "unconfigure telegram", "disable telegram"],
      "objective": "Remove a platform transport from the env file",
      "command": "nuvira config gateway remove <platform> [--yes]",
      "example": "nuvira config gateway remove telegram --yes",
      "args": [{ "name": "platform", "flag": "<platform>", "optional": false, "example": "telegram" }],
      "rbac": "gateway.manage",
      "confirmation": true,
      "platforms": ["*"],
      "requires": ["platform"]
    },
    {
      "intent": "delivery.ledger",
      "summary": "Show the delivery ledger",
      "aliases": ["delivery ledger", "failed sends", "pending sends", "delivery status", "what failed to send"],
      "objective": "See pending/sent/failed sends awaiting retry",
      "command": "nuvira gateway delivery [--flush]",
      "example": "nuvira gateway delivery",
      "args": [{ "name": "flush", "flag": "--flush", "optional": true, "example": "--flush" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "doctor",
      "summary": "Diagnose the whole setup",
      "aliases": ["check my setup", "run diagnostics", "why is nothing working", "doctor", "health check everything", "check configuration"],
      "objective": "Run diagnostic checks on all provider configs and system health",
      "command": "nuvira doctor [--fix] [-p <provider>]",
      "example": "nuvira doctor --fix",
      "args": [
        { "name": "fix", "flag": "--fix", "optional": true, "example": "--fix" },
        { "name": "provider", "flag": "-p", "optional": true, "example": "-p groq" }
      ],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "health.check",
      "summary": "Run a full system health check",
      "aliases": ["check system health", "system health check", "is the system healthy", "overall system health", "run a health check", "check everything is ok"],
      "objective": "Run buff doctor to verify all provider configs, system health, and surface any issues",
      "command": "nuvira doctor",
      "example": "nuvira doctor",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "health.selfheal",
      "summary": "Auto-fix common setup/system issues",
      "aliases": ["fix my setup", "self heal", "repair the agent", "auto fix common issues", "make everything work again", "heal the agent", "doctor fix"],
      "objective": "Run buff doctor --fix to automatically resolve common configuration and system issues",
      "command": "nuvira doctor --fix",
      "example": "nuvira doctor --fix",
      "args": [],
      "rbac": "execute",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "health.providers",
      "summary": "Check inference provider health",
      "aliases": ["check provider health", "are my providers working", "provider health check", "is my llm provider up", "which providers are healthy"],
      "objective": "Run buff provider health to check every configured inference provider",
      "command": "nuvira provider health",
      "example": "nuvira provider health",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "health.memory",
      "summary": "Check memory store health and size",
      "aliases": ["is my memory healthy", "check memory usage", "how big is my memory store", "memory health check", "is my memory getting full"],
      "objective": "Inspect memory store statistics (size, counts, health) and, if flagged, suggest optimization",
      "command": "nuvira memory stats",
      "example": "nuvira memory stats",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "health.vector",
      "summary": "Check vector-search backend health",
      "aliases": ["check the vector store", "is my vector search healthy", "why is search slow", "vector store health check", "is faiss working"],
      "objective": "Inspect the active vector backend, corpus size, and native-FAISS availability",
      "command": "nuvira memory backend --check",
      "example": "nuvira memory backend --check",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "models.list",
      "summary": "List available models",
      "aliases": ["what models are available", "list models", "available models", "which models do i have"],
      "objective": "List available models from inference providers",
      "command": "nuvira models list [-p <provider>] [-s <search>]",
      "example": "nuvira models list -p groq",
      "args": [
        { "name": "provider", "flag": "-p", "optional": true, "example": "-p groq" },
        { "name": "search", "flag": "-s", "optional": true, "example": "-s llama" }
      ],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "models.switch",
      "summary": "Switch the active model/provider",
      "aliases": ["switch model", "use groq", "switch to <model>", "change the model", "use a different model", "set default model"],
      "objective": "Change the active provider/model; 'auto' enables smart routing",
      "command": "nuvira model switch [--provider <p>] [--model <m>]",
      "example": "nuvira model switch --provider groq --model llama-3.3-70b",
      "args": [
        { "name": "provider", "flag": "--provider", "optional": false, "example": "--provider groq" },
        { "name": "model", "flag": "--model", "optional": false, "example": "--model llama-3.3-70b" }
      ],
      "rbac": "model.manage",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["provider"]
    },
    {
      "intent": "config.get",
      "summary": "Read a configuration value",
      "aliases": ["what is my default provider", "show config", "get config", "config value"],
      "objective": "Read a configuration value from ~/.buff/buffconfig.json",
      "command": "nuvira config get <key>",
      "example": "nuvira config get defaultProvider",
      "args": [{ "name": "key", "flag": "<key>", "optional": false, "example": "defaultProvider" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "config.set",
      "summary": "Write a configuration value",
      "aliases": ["set the default provider", "change config", "set config value"],
      "objective": "Write a configuration value to ~/.buff/buffconfig.json",
      "command": "nuvira config set <key> <value>",
      "example": "nuvira config set defaultProvider groq",
      "args": [
        { "name": "key", "flag": "<key>", "optional": false, "example": "defaultProvider" },
        { "name": "value", "flag": "<value>", "optional": false, "example": "groq" }
      ],
      "rbac": "config.manage",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["key", "value"]
    },
    {
      "intent": "vault.status",
      "summary": "Secret vault status",
      "aliases": ["vault status", "is my vault set up", "secret vault"],
      "objective": "Show the active vault tier and migration state",
      "command": "nuvira config vault status",
      "example": "nuvira config vault status",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "chat",
      "summary": "Chat with the agent",
      "aliases": ["chat", "ask the agent", "talk to the agent", "ask a question", "have a conversation"],
      "objective": "Start an interactive chat session (or one-shot with followup selection)",
      "command": "nuvira chat \"<prompt>\" [-p <provider>] [-m <model>]",
      "example": "nuvira chat \"what's the state of this project?\"",
      "args": [
        { "name": "prompt", "flag": "\"<prompt>\"", "optional": false, "example": "\"fix the failing test\"" },
        { "name": "provider", "flag": "-p", "optional": true, "example": "-p groq" },
        { "name": "model", "flag": "-m", "optional": true, "example": "-m llama-3.3-70b" }
      ],
      "rbac": "chat",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "execute",
      "summary": "Run a multi-agent pipeline on a goal",
      "aliases": ["execute", "do this task", "accomplish this", "make it happen", "implement", "build this feature"],
      "objective": "Run the full planner→gatherer→writer→reviewer pipeline on a goal",
      "command": "nuvira execute \"<goal>\" [--dry-run] [--review] [--memory] [--checkpoint]",
      "example": "nuvira execute \"add a login page to the API\" --review",
      "args": [
        { "name": "goal", "flag": "\"<goal>\"", "optional": false, "example": "\"add a login page\"" },
        { "name": "dryRun", "flag": "--dry-run", "optional": true, "example": "--dry-run" },
        { "name": "review", "flag": "--review", "optional": true, "example": "--review" },
        { "name": "memory", "flag": "--memory", "optional": true, "example": "--memory" }
      ],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["goal"]
    },
    {
      "intent": "edit",
      "summary": "AI-assisted file edit",
      "aliases": ["edit this file", "change the file", "modify src/server.ts", "fix the code in", "update the file"],
      "objective": "Edit a file using AI assistance",
      "command": "nuvira edit <file> -i \"<instruction>\" [--dry-run]",
      "example": "nuvira edit src/server.ts -i \"add input validation\"",
      "args": [
        { "name": "file", "flag": "<file>", "optional": false, "example": "src/server.ts" },
        { "name": "instruction", "flag": "-i", "optional": false, "example": "-i \"add input validation\"" },
        { "name": "dryRun", "flag": "--dry-run", "optional": true, "example": "--dry-run" }
      ],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["file"]
    },
    {
      "intent": "plan",
      "summary": "Generate an implementation plan",
      "aliases": ["make a plan", "plan this task", "how would you implement", "implementation plan"],
      "objective": "Generate an implementation plan for a codebase task (no code changes)",
      "command": "nuvira plan -t \"<task>\"",
      "example": "nuvira plan -t \"add OAuth login\"",
      "args": [{ "name": "task", "flag": "-t", "optional": false, "example": "-t \"add OAuth login\"" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["task"]
    },
    {
      "intent": "run.shell",
      "summary": "Run a shell command",
      "aliases": ["run this command", "execute this shell command", "run npm test", "run the tests", "run build"],
      "objective": "Execute a shell command and show output (lightweight)",
      "command": "nuvira run \"<command>\" [-t <timeout>]",
      "example": "nuvira run \"npm test\" -t 120",
      "args": [
        { "name": "command", "flag": "\"<command>\"", "optional": false, "example": "\"npm test\"" },
        { "name": "timeout", "flag": "-t", "optional": true, "example": "-t 120" }
      ],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["command"]
    },
    {
      "intent": "skill.run",
      "summary": "Run a compiled skill",
      "aliases": ["run the skill", "execute skill", "use skill"],
      "objective": "Run a compiled skill — resolves parameters and invokes the pipeline",
      "command": "nuvira skill run <name> [--params k=v] [--dry-run]",
      "example": "nuvira skill run fix-lint --params \"file=src/server.ts\"",
      "args": [
        { "name": "name", "flag": "<name>", "optional": false, "example": "fix-lint" },
        { "name": "params", "flag": "--params", "optional": true, "example": "--params \"file=src/server.ts\"" }
      ],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["name"]
    },
    {
      "intent": "skill.list",
      "summary": "List compiled skills",
      "aliases": ["what skills exist", "list skills", "show skills"],
      "objective": "List all compiled skills",
      "command": "nuvira skill list [--quality]",
      "example": "nuvira skill list",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "memory.stats",
      "summary": "Memory store statistics",
      "aliases": ["memory stats", "what does the agent remember", "memory status", "show memory", "memory usage", "how much memory", "memory store stats"],
      "objective": "Show memory store statistics",
      "command": "nuvira memory stats",
      "example": "nuvira memory stats",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "memory.optimize",
      "summary": "Compress/prune memory",
      "aliases": ["optimize memory", "clean up memory", "compress memory"],
      "objective": "Run automatic memory compression and pruning",
      "command": "nuvira memory optimize [--dry-run] [--aggressive]",
      "example": "nuvira memory optimize --aggressive",
      "args": [{ "name": "dryRun", "flag": "--dry-run", "optional": true, "example": "--dry-run" }],
      "rbac": "memory.manage",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "memory.backend",
      "summary": "Show the vector backend (FAISS etc.)",
      "aliases": ["what vector backend", "faiss", "memory backend", "which vector store", "vector backend status", "search backend"],
      "objective": "Show the active vector-search backend and why it was chosen",
      "command": "nuvira memory backend [--check]",
      "example": "nuvira memory backend --check",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "eval.run",
      "summary": "Run the evaluation suite",
      "aliases": ["run evals", "run the eval suite", "evaluate the agent", "run eval"],
      "objective": "Measure whether the agent is actually improving",
      "command": "nuvira eval run [--tasks <t>] [--suite <s>] [-p <provider>] [--format <fmt>]",
      "example": "nuvira eval run --tasks quick --format text",
      "args": [
        { "name": "tasks", "flag": "--tasks", "optional": true, "example": "--tasks quick" },
        { "name": "suite", "flag": "--suite", "optional": true, "example": "--suite full" },
        { "name": "provider", "flag": "-p", "optional": true, "example": "-p groq" }
      ],
      "rbac": "eval.manage",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "benchmark.run",
      "summary": "Run model benchmarks",
      "aliases": ["run benchmarks", "benchmark the model", "compare models"],
      "objective": "Run standardized model benchmarks against coding tasks",
      "command": "nuvira benchmark run [-p <provider>] [-m <model>] [--tasks <t>]",
      "example": "nuvira benchmark run -p groq --tasks smoke",
      "args": [
        { "name": "provider", "flag": "-p", "optional": true, "example": "-p groq" },
        { "name": "tasks", "flag": "--tasks", "optional": true, "example": "--tasks smoke" }
      ],
      "rbac": "eval.manage",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "security.scan",
      "summary": "Scan for security issues",
      "aliases": ["scan for pii", "security scan", "scan this file", "check for injection", "is this safe"],
      "objective": "Scan code/prompts/files for PII, injection, or dangerous patterns",
      "command": "nuvira security scan [-f <file>] [--stdin] [--prompt <text>] [--json]",
      "example": "nuvira security scan -f src/server.ts --json",
      "args": [
        { "name": "file", "flag": "-f", "optional": false, "example": "-f src/server.ts" },
        { "name": "json", "flag": "--json", "optional": true, "example": "--json" }
      ],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "admin.policy",
      "summary": "Show governance policy",
      "aliases": ["governance policy", "admin policy", "what is allowed", "cost cap", "show policy"],
      "objective": "Show the current governance policy + enforcement status",
      "command": "nuvira admin policy [--json]",
      "example": "nuvira admin policy",
      "args": [],
      "rbac": "admin",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "team.init",
      "summary": "Initialize team workspace",
      "aliases": ["team setup", "init team", "set up team config", "create team workspace"],
      "objective": "Initialize team configuration in the working directory",
      "command": "nuvira team init [-r <repo>] [-b <branch>]",
      "example": "nuvira team init -r git@github.com:acme/team-config.git",
      "args": [{ "name": "repo", "flag": "-r", "optional": true, "example": "-r git@github.com:acme/team.git" }],
      "rbac": "team.manage",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "team.sync",
      "summary": "Sync team memory",
      "aliases": ["sync team", "push team memory", "pull team updates"],
      "objective": "Sync team memory with remote (pull latest + push local changes)",
      "command": "nuvira team sync",
      "example": "nuvira team sync",
      "args": [],
      "rbac": "team.manage",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "federation.status",
      "summary": "Federation status",
      "aliases": ["federation status", "remote agents", "are remote agents connected"],
      "objective": "Show federation connection status and configuration",
      "command": "nuvira federation status",
      "example": "nuvira federation status",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "federation.run",
      "summary": "Run a task on a remote agent",
      "aliases": ["run on remote", "delegate to remote agent", "run task on federation"],
      "objective": "Run a task on the remote federation server",
      "command": "nuvira federation run \"<task>\" [-a <agent>] [-m <model>]",
      "example": "nuvira federation run \"run the test suite\" -a builder",
      "args": [{ "name": "task", "flag": "\"<task>\"", "optional": false, "example": "\"run the tests\"" }],
      "rbac": "federation.run",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "mcp.list",
      "summary": "List MCP servers",
      "aliases": ["mcp servers", "list mcp", "what mcp tools"],
      "objective": "List all discovered MCP servers and their tools",
      "command": "nuvira mcp list",
      "example": "nuvira mcp list",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "mcp.call",
      "summary": "Call a tool on an MCP server",
      "aliases": ["call mcp tool", "use the mcp tool", "invoke mcp"],
      "objective": "Call a tool on an MCP server",
      "command": "nuvira mcp call <tool> [-s <server>] [-a '<json>']",
      "example": "nuvira mcp call fetch_webpage -s browser -a '{\"url\":\"https://example.com\"}'",
      "args": [
        { "name": "tool", "flag": "<tool>", "optional": false, "example": "fetch_webpage" },
        { "name": "args", "flag": "-a", "optional": true, "example": "-a '{\"url\":\"https://example.com\"}'" }
      ],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "mcp.serve",
      "summary": "Expose agent tools as an MCP server",
      "aliases": ["expose mcp", "serve mcp", "mcp server"],
      "objective": "Expose the agent's tools as an MCP server over stdio (MCP clients / IDEs / other agents)",
      "command": "nuvira mcp serve [--with <tool>]",
      "example": "nuvira mcp serve --with gateway_send",
      "args": [{ "name": "with", "flag": "--with", "optional": true, "example": "--with gateway_send" }],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "ci.execute",
      "summary": "Headless CI execution",
      "aliases": ["ci execute", "run in ci", "headless run", "json result"],
      "objective": "Execute a goal and emit JSON result (exit 0 = success, 1 = failure)",
      "command": "nuvira ci execute \"<goal>\" [--github-annotations] [--timeout <s>]",
      "example": "nuvira ci execute \"fix the failing build\" --github-annotations",
      "args": [{ "name": "goal", "flag": "\"<goal>\"", "optional": false, "example": "\"fix the failing build\"" }],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "publish",
      "summary": "Autonomous publish (npm + GitHub)",
      "aliases": ["publish", "release", "release a version", "publish to npm", "bump version", "patch release"],
      "objective": "Version, build, and publish to npm & GitHub",
      "command": "nuvira publish [--patch|--minor|--major] [--dry-run]",
      "example": "nuvira publish --patch",
      "args": [
        { "name": "version", "flag": "--patch|--minor|--major", "optional": false, "example": "--patch" },
        { "name": "dryRun", "flag": "--dry-run", "optional": true, "example": "--dry-run" }
      ],
      "rbac": "publish.manage",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "history.list",
      "summary": "Browse conversation history",
      "aliases": ["conversation history", "past conversations", "show history", "what did we discuss"],
      "objective": "Browse and search past conversations",
      "command": "nuvira history list [-l <n>] · buff history search \"<q>\" [-s]",
      "example": "nuvira history search \"deploy config\" --semantic",
      "args": [{ "name": "limit", "flag": "-l", "optional": true, "example": "-l 20" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "trace.list",
      "summary": "Inspect reasoning traces",
      "aliases": ["show traces", "traces", "what did the agent do", "replay trace"],
      "objective": "Inspect and replay per-step reasoning traces",
      "command": "nuvira trace list [-l <n>] · buff trace replay <id> [--full]",
      "example": "nuvira trace list -l 10",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "stats.cost",
      "summary": "Usage and cost stats",
      "aliases": ["how much have i spent", "cost stats", "usage stats", "api cost"],
      "objective": "Usage statistics and API cost tracking",
      "command": "nuvira stats cost",
      "example": "nuvira stats cost",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "cache.clear",
      "summary": "Clear inference cache",
      "aliases": ["clear cache", "clear the cache", "reset cache"],
      "objective": "Clear all cached inference responses",
      "command": "nuvira cache clear",
      "example": "nuvira cache clear",
      "args": [],
      "rbac": "cache.manage",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "sandbox.status",
      "summary": "Docker sandbox status",
      "aliases": ["sandbox status", "is docker available", "sandbox running"],
      "objective": "Check Docker availability and sandbox status",
      "command": "nuvira sandbox status",
      "example": "nuvira sandbox status",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "sandbox.run",
      "summary": "Run a command in a sandbox",
      "aliases": ["run in sandbox", "isolated run", "sandbox run"],
      "objective": "Run a command inside a new sandbox container",
      "command": "nuvira sandbox run \"<cmd>\" [--image <img>] [--project <p>]",
      "example": "nuvira sandbox run \"npm test\" --project my-app",
      "args": [{ "name": "cmd", "flag": "\"<cmd>\"", "optional": false, "example": "\"npm test\"" }],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "retrieval.query",
      "summary": "Semantic search over an indexed repo",
      "aliases": ["search the code", "retrieval query", "semantic search", "how is x handled"],
      "objective": "Semantic search over the indexed repo (top-k chunks)",
      "command": "nuvira retrieval query \"<q>\" [-k <n>]",
      "example": "nuvira retrieval query \"how is auth handled\" -k 5",
      "args": [{ "name": "query", "flag": "\"<q>\"", "optional": false, "example": "\"how is auth handled\"" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "tools.list",
      "summary": "Inspect the agent tool registry",
      "aliases": ["what tools does the agent have", "tool registry", "list tools"],
      "objective": "List every registered tool (the H1 tool-calling surface)",
      "command": "nuvira tools list",
      "example": "nuvira tools list",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "audit.verify",
      "summary": "Verify the audit trail",
      "aliases": ["audit verify", "verify audit trail", "tamper check"],
      "objective": "Verify hash-chain integrity of audit stores (tamper detection)",
      "command": "nuvira audit verify",
      "example": "nuvira audit verify",
      "args": [],
      "rbac": "admin",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "sbom.generate",
      "summary": "Generate the SBOM",
      "aliases": ["generate sbom", "bill of materials", "sbom"],
      "objective": "Generate the CycloneDX software bill of materials",
      "command": "nuvira sbom -o <out> --json",
      "example": "nuvira sbom -o sbom.json --json",
      "args": [{ "name": "out", "flag": "-o", "optional": true, "example": "-o sbom.json" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "init.project",
      "summary": "Scaffold a new project",
      "aliases": ["scaffold a project", "new project", "create a project from template", "init project"],
      "objective": "Generate a project from a template",
      "command": "nuvira init [-t <template>] [--list]",
      "example": "nuvira init -t cli-app my-new-project",
      "args": [{ "name": "template", "flag": "-t", "optional": true, "example": "-t cli-app" }],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "cron.list",
      "summary": "List scheduled jobs",
      "aliases": ["list cron jobs", "what cron jobs exist", "show scheduled jobs", "cron list"],
      "objective": "List cron jobs with schedule + next run",
      "command": "nuvira admin cron list",
      "example": "nuvira admin cron list",
      "args": [],
      "rbac": "admin",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "cron.add",
      "summary": "Schedule a job (cron)",
      "aliases": ["schedule a job", "add a cron job", "create a cron job", "run nightly", "schedule the build", "set up a scheduled task"],
      "objective": "Add a cron job that invokes a tool on a schedule",
      "command": "nuvira admin cron add <name> \"<schedule>\" <tool> [--channel <target>]",
      "example": "nuvira admin cron add nightly-build \"0 3 * * *\" build --channel slack:ops",
      "args": [
        { "name": "name", "flag": "<name>", "optional": false, "example": "nightly-build" },
        { "name": "schedule", "flag": "\"<schedule>\"", "optional": false, "example": "\"0 3 * * *\"" },
        { "name": "tool", "flag": "<tool>", "optional": false, "example": "build" }
      ],
      "rbac": "admin",
      "confirmation": false,
      "platforms": ["*"],
      "requires": ["name", "schedule", "tool"]
    },
    {
      "intent": "cron.run",
      "summary": "Run a scheduled job now",
      "aliases": ["run the cron job", "run the scheduled job now", "trigger the nightly build", "execute the cron job"],
      "objective": "Run a cron job NOW (invoke its tool immediately)",
      "command": "nuvira admin cron run <name>",
      "example": "nuvira admin cron run nightly-build",
      "args": [{ "name": "name", "flag": "<name>", "optional": false, "example": "nightly-build" }],
      "rbac": "admin",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "cron.remove",
      "summary": "Remove a scheduled job",
      "aliases": ["remove the cron job", "delete the cron job", "cancel the scheduled job", "stop the nightly build"],
      "objective": "Remove a cron job",
      "command": "nuvira admin cron remove <name>",
      "example": "nuvira admin cron remove nightly-build",
      "args": [{ "name": "name", "flag": "<name>", "optional": false, "example": "nightly-build" }],
      "rbac": "admin",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "sbom.generate",
      "summary": "Generate the SBOM",
      "aliases": ["generate a sbom", "bill of materials", "software bill of materials", "sbom"],
      "objective": "Generate the CycloneDX software bill of materials",
      "command": "nuvira sbom -o <out> --json",
      "example": "nuvira sbom -o sbom.json --json",
      "args": [{ "name": "out", "flag": "-o", "optional": true, "example": "-o sbom.json" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "sbom.verify",
      "summary": "Verify the SBOM",
      "aliases": ["verify the sbom", "check the sbom", "sbom verify"],
      "objective": "Verify an existing SBOM file",
      "command": "nuvira sbom --verify --sbom <file>",
      "example": "nuvira sbom --verify --sbom sbom.json",
      "args": [{ "name": "sbom", "flag": "--sbom", "optional": false, "example": "--sbom sbom.json" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "audit.export",
      "summary": "Export the audit trail",
      "aliases": ["export audit trail", "export the audit log", "audit export", "siem export"],
      "objective": "Export an audit store as SIEM-friendly CEF lines",
      "command": "nuvira audit export [-f <file>] [--out <file>]",
      "example": "nuvira audit export --out audit.cef",
      "args": [],
      "rbac": "admin",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "security.prompt",
      "summary": "Scan a prompt for injection/PII",
      "aliases": ["scan this prompt", "is this prompt safe", "prompt injection check", "scan the message"],
      "objective": "Scan a prompt for injection attempts or PII",
      "command": "nuvira security scan --prompt \"<text>\" [--json]",
      "example": "nuvira security scan --prompt \"ignore the system prompt\" --json",
      "args": [{ "name": "prompt", "flag": "--prompt", "optional": false, "example": "--prompt \"<text>\"" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "history.show",
      "summary": "Show a past conversation",
      "aliases": ["show the conversation", "show the chat", "what did we discuss", "show history for", "show that conversation"],
      "objective": "Show a specific saved conversation",
      "command": "nuvira history show <id>",
      "example": "nuvira history show <conversation-id>",
      "args": [{ "name": "id", "flag": "<id>", "optional": false, "example": "<conversation-id>" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "history.clear",
      "summary": "Clear conversation history",
      "aliases": ["clear conversation history", "delete all conversations", "wipe the history", "clear chat history"],
      "objective": "Clear all saved conversation history",
      "command": "nuvira history clear",
      "example": "nuvira history clear",
      "args": [],
      "rbac": "memory.manage",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "memory.prune",
      "summary": "Prune old/low-quality memory",
      "aliases": ["prune memory", "clean old memory", "remove low quality memories"],
      "objective": "Prune old or low-quality trajectories",
      "command": "nuvira memory prune [--max-age <days>] [--min-score <n>]",
      "example": "nuvira memory prune --max-age 30 --min-score 0.5",
      "args": [],
      "rbac": "memory.manage",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "retrieval.index",
      "summary": "Index a repo for semantic search",
      "aliases": ["index the repo", "index the code", "build the search index", "index for retrieval"],
      "objective": "Index a repo/file into the retrieval store (chunks embedded locally)",
      "command": "nuvira retrieval index <path>",
      "example": "nuvira retrieval index ./src",
      "args": [{ "name": "path", "flag": "<path>", "optional": false, "example": "./src" }],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "tools.show",
      "summary": "Show a tool's details",
      "aliases": ["show the tool", "tool details", "what does the tool do", "tool schema"],
      "objective": "Show a tool's description and input schema",
      "command": "nuvira tools show <tool>",
      "example": "nuvira tools show gateway_send",
      "args": [{ "name": "tool", "flag": "<tool>", "optional": false, "example": "gateway_send" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "mcp.install",
      "summary": "Install an MCP server from the catalog",
      "aliases": ["install mcp server", "add an mcp server", "install the mcp", "setup mcp"],
      "objective": "Install a vetted MCP server from the catalog",
      "command": "nuvira mcp install <name> [--env K=V]",
      "example": "nuvira mcp install github --env GITHUB_TOKEN=ghp_xxx",
      "args": [{ "name": "name", "flag": "<name>", "optional": false, "example": "github" }],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "sandbox.config",
      "summary": "Configure Docker sandbox isolation",
      "aliases": ["enable sandbox", "disable sandbox", "configure the sandbox", "turn on sandboxing", "enable sandboxing", "turn on the sandbox"],
      "objective": "Enable/disable Docker sandbox isolation for code execution",
      "command": "nuvira sandbox config [--enable|--disable] [--memory <m>] [--cpu <n>]",
      "example": "nuvira sandbox config --enable --memory 2g --cpu 2",
      "args": [],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "phase.status",
      "summary": "Show phase scope progress",
      "aliases": ["phase status", "progress on the roadmap", "how far along is the phase", "phase list", "show phase progress", "phase progress", "show progress on the phase"],
      "objective": "Show progress of a phase scope (multi-goal pipeline)",
      "command": "nuvira phase status",
      "example": "nuvira phase status",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "phase.execute",
      "summary": "Execute a phase scope",
      "aliases": ["execute the phase", "run the phase scope", "execute the roadmap", "run the phase"],
      "objective": "Execute a phase scope from start to finish",
      "command": "nuvira phase execute <scope> [--non-interactive]",
      "example": "nuvira phase execute roadmap.md --non-interactive",
      "args": [{ "name": "scope", "flag": "<scope>", "optional": false, "example": "roadmap.md" }],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "feedback.list",
      "summary": "Show feedback entries",
      "aliases": ["show feedback", "list feedback", "what feedback is there"],
      "objective": "Show recent feedback entries",
      "command": "nuvira feedback list [-n <limit>]",
      "example": "nuvira feedback list -n 10",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "learn.patterns",
      "summary": "Show extracted coding patterns",
      "aliases": ["show coding patterns", "what patterns has it learned", "learning patterns", "learn patterns"],
      "objective": "Show extracted coding patterns from past runs",
      "command": "nuvira learn patterns [--extract]",
      "example": "nuvira learn patterns",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "learn.lessons",
      "summary": "Show failure lessons",
      "aliases": ["what did it learn from mistakes", "show failure lessons", "learn lessons", "lessons learned"],
      "objective": "Show failure lessons — what past runs learned from mistakes",
      "command": "nuvira learn lessons [--extract]",
      "example": "nuvira learn lessons",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "stats.cost.clear",
      "summary": "Clear cost tracking",
      "aliases": ["reset cost tracking", "clear the cost stats", "reset usage costs"],
      "objective": "Clear API cost tracking details",
      "command": "nuvira stats cost --clear",
      "example": "nuvira stats cost --clear",
      "args": [],
      "rbac": "memory.manage",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "team.review.list",
      "summary": "List review bundles",
      "aliases": ["show review bundles", "list the reviews", "pending reviews", "review bundles"],
      "objective": "List all review bundles (agent PR → review → merge)",
      "command": "nuvira team review list [-l <limit>]",
      "example": "nuvira team review list",
      "args": [],
      "rbac": "team.manage",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "team.review.approve",
      "summary": "Approve a review bundle",
      "aliases": ["approve the review", "approve the bundle", "approve the pr"],
      "objective": "Approve a review bundle (sets status to approved)",
      "command": "nuvira team review approve <id>",
      "example": "nuvira team review approve bundle-123",
      "args": [{ "name": "id", "flag": "<id>", "optional": false, "example": "bundle-123" }],
      "rbac": "team.manage",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "skill.install",
      "summary": "Install a community skill",
      "aliases": ["install a skill", "install the skill", "add a skill from the registry", "get the git-release skill"],
      "objective": "Install a skill from the configured registries into .agents/skills/",
      "command": "nuvira skills install <owner/repo> --skill <name> --yes",
      "example": "nuvira skills install acme/skills --skill release --yes",
      "args": [{ "name": "repo", "flag": "<owner/repo>", "optional": false, "example": "acme/skills" }],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "skills.search",
      "summary": "Search the skills marketplace",
      "aliases": ["search skills", "find skills", "look for a skill", "search the skill registry"],
      "objective": "Search across all configured skill registries for skills matching a query",
      "command": "nuvira skills search <query>",
      "example": "nuvira skills search deploy",
      "args": [{ "name": "query", "flag": "<query>", "optional": false, "example": "deploy" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "skills.list",
      "summary": "List installed community skills",
      "aliases": ["list installed skills", "show installed skills", "what skills are installed"],
      "objective": "List all installed community skills with provenance",
      "command": "nuvira skills list [--origin registry|local]",
      "example": "nuvira skills list",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "skills.uninstall",
      "summary": "Uninstall a community skill",
      "aliases": ["uninstall skill", "remove a skill", "delete a skill"],
      "objective": "Remove an installed community skill from .agents/skills/",
      "command": "nuvira skills uninstall <name>",
      "example": "nuvira skills uninstall code-assessment",
      "args": [{ "name": "name", "flag": "<name>", "optional": false, "example": "code-assessment" }],
      "rbac": "execute",
      "confirmation": true,
      "platforms": ["*"]
    },
    {
      "intent": "skills.bundle",
      "summary": "Manage cross-skill bundles",
      "aliases": ["create a bundle", "group skills", "bundle skills together", "list bundles"],
      "objective": "Create, list, show, or delete cross-skill bundles (Hermes parity)",
      "command": "nuvira skills bundle <slug> --create --name <name> --description <desc> --skills <list>",
      "example": "nuvira skills bundle backend-dev --create --name \"Backend Dev\" --skills code-assessment,test-strategy",
      "args": [
        { "name": "slug", "flag": "<slug>", "optional": false, "example": "backend-dev" },
        { "name": "create", "flag": "--create", "optional": true, "example": "--create" },
        { "name": "list", "flag": "--list", "optional": true, "example": "--list" },
        { "name": "show", "flag": "--show", "optional": true, "example": "--show" },
        { "name": "skills", "flag": "--skills", "optional": true, "example": "--skills code-assessment,test-strategy" }
      ],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "marketplace.browse",
      "summary": "Browse the unified marketplace",
      "aliases": ["browse marketplace", "show marketplace", "what's in the marketplace"],
      "objective": "Browse all available workflow templates and plugins in the unified marketplace",
      "command": "nuvira marketplace browse [--type workflows|plugins]",
      "example": "nuvira marketplace browse",
      "args": [],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "marketplace.search",
      "summary": "Search the unified marketplace",
      "aliases": ["search marketplace", "find in marketplace", "search templates"],
      "objective": "Search across plugins and templates in the unified marketplace",
      "command": "nuvira marketplace search <query>",
      "example": "nuvira marketplace search deploy",
      "args": [{ "name": "query", "flag": "<query>", "optional": false, "example": "deploy" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "marketplace.install",
      "summary": "Install from the unified marketplace",
      "aliases": ["install from marketplace", "get marketplace item", "install template"],
      "objective": "Install a workflow template from the unified marketplace",
      "command": "nuvira marketplace install <name>",
      "example": "nuvira marketplace install security-audit",
      "args": [{ "name": "name", "flag": "<name>", "optional": false, "example": "security-audit" }],
      "rbac": "execute",
      "confirmation": false,
      "platforms": ["*"]
    },
    {
      "intent": "marketplace.info",
      "summary": "Show marketplace item details",
      "aliases": ["marketplace info", "show marketplace item", "details for marketplace item"],
      "objective": "Show detailed information for a marketplace item",
      "command": "nuvira marketplace info <name>",
      "example": "nuvira marketplace info quick-fix",
      "args": [{ "name": "name", "flag": "<name>", "optional": false, "example": "quick-fix" }],
      "rbac": "read",
      "confirmation": false,
      "platforms": ["*"]
    }
  ]
}