{
  "schemaVersion": 1,
  "commands": [
    {
      "id": "admin",
      "path": [
        "admin"
      ],
      "title": "leapview admin",
      "summary": "Administrative utilities",
      "description": "Administrative utilities",
      "usage": "leapview admin",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "admin-backup",
        "admin-initialize",
        "admin-maintenance",
        "admin-restore",
        "admin-storage"
      ]
    },
    {
      "id": "admin-backup",
      "path": [
        "admin",
        "backup"
      ],
      "title": "leapview admin backup",
      "summary": "Create a consistent LeapView instance backup",
      "description": "Create a consistent LeapView instance backup",
      "usage": "leapview admin backup [flags]",
      "runnable": true,
      "effect": "local-write",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "database-only",
          "type": "bool",
          "default": "false",
          "description": "backup only the platform SQLite database",
          "required": false
        },
        {
          "name": "out",
          "type": "string",
          "default": "",
          "description": "backup archive output path",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "admin-initialize",
      "path": [
        "admin",
        "initialize"
      ],
      "title": "leapview admin initialize",
      "summary": "Initialize one instance administrator and publisher credential",
      "description": "Initialize one instance administrator and publisher credential",
      "usage": "leapview admin initialize [flags]",
      "runnable": true,
      "effect": "write",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "acknowledge-credentials",
          "type": "bool",
          "default": "false",
          "description": "remove the recoverable initialization credential bundle after it has been stored safely",
          "required": false
        },
        {
          "name": "format",
          "type": "string",
          "default": "json",
          "description": "output format (json)",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "admin-maintenance",
      "path": [
        "admin",
        "maintenance"
      ],
      "title": "leapview admin maintenance",
      "summary": "Prune bounded operational history",
      "description": "Prune bounded operational history",
      "usage": "leapview admin maintenance [flags]",
      "runnable": true,
      "effect": "destructive",
      "confirmation": "conditional",
      "arguments": [],
      "options": [
        {
          "name": "apply",
          "type": "bool",
          "default": "false",
          "description": "delete rows instead of dry-run",
          "required": false
        },
        {
          "name": "archived-agent-days",
          "type": "int",
          "default": "180",
          "description": "archived agent conversation retention in days; 0 disables archived conversation pruning",
          "required": false
        },
        {
          "name": "audit-days",
          "type": "int",
          "default": "365",
          "description": "audit event retention in days; 0 disables audit pruning",
          "required": false
        },
        {
          "name": "auth-state-days",
          "type": "int",
          "default": "30",
          "description": "expired or revoked auth state retention in days; 0 disables auth-state pruning",
          "required": false
        },
        {
          "name": "query-days",
          "type": "int",
          "default": "90",
          "description": "query event retention in days; 0 disables query pruning",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "admin-restore",
      "path": [
        "admin",
        "restore"
      ],
      "title": "leapview admin restore",
      "summary": "Restore LeapView from a validated instance backup",
      "description": "Restore LeapView from a validated instance backup",
      "usage": "leapview admin restore [flags]",
      "runnable": true,
      "effect": "destructive",
      "confirmation": "required",
      "arguments": [],
      "options": [
        {
          "name": "confirm",
          "type": "bool",
          "default": "false",
          "description": "confirm replacement of the configured LeapView instance",
          "required": false
        },
        {
          "name": "current-out",
          "type": "string",
          "default": "",
          "description": "path for a backup of the current instance before replacement; - creates and discards a validated temporary checkpoint",
          "required": false
        },
        {
          "name": "database-only",
          "type": "bool",
          "default": "false",
          "description": "restore only the platform SQLite database",
          "required": false
        },
        {
          "name": "from",
          "type": "string",
          "default": "",
          "description": "backup archive path to restore",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "admin-storage",
      "path": [
        "admin",
        "storage"
      ],
      "title": "leapview admin storage",
      "summary": "Maintain analytical storage",
      "description": "Maintain analytical storage",
      "usage": "leapview admin storage",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "admin-storage-cleanup"
      ]
    },
    {
      "id": "admin-storage-cleanup",
      "path": [
        "admin",
        "storage",
        "cleanup"
      ],
      "title": "leapview admin storage cleanup",
      "summary": "Reconcile serving-state snapshots and clean DuckLake storage",
      "description": "Reconcile serving-state snapshots and clean DuckLake storage",
      "usage": "leapview admin storage cleanup [flags]",
      "runnable": true,
      "effect": "destructive",
      "confirmation": "conditional",
      "arguments": [],
      "options": [
        {
          "name": "apply",
          "type": "bool",
          "default": "false",
          "description": "perform destructive cleanup instead of dry-run",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "agent",
      "path": [
        "agent"
      ],
      "title": "leapview agent",
      "summary": "Use the LeapView read-only agent",
      "description": "Use the LeapView read-only agent",
      "usage": "leapview agent",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "agent-ask",
        "agent-conversations",
        "agent-tools"
      ]
    },
    {
      "id": "agent-ask",
      "path": [
        "agent",
        "ask"
      ],
      "title": "leapview agent ask",
      "summary": "Ask the LeapView read-only agent a question",
      "description": "Ask the LeapView read-only agent a question",
      "usage": "leapview agent ask [question] [flags]",
      "runnable": true,
      "effect": "write",
      "confirmation": "never",
      "arguments": [
        "question"
      ],
      "options": [
        {
          "name": "conversation",
          "type": "string",
          "default": "",
          "description": "existing agent conversation id",
          "required": false
        },
        {
          "name": "json",
          "type": "bool",
          "default": "false",
          "description": "print JSON response",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "agent-conversations",
      "path": [
        "agent",
        "conversations"
      ],
      "title": "leapview agent conversations",
      "summary": "List agent conversations",
      "description": "List agent conversations",
      "usage": "leapview agent conversations [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "json",
          "type": "bool",
          "default": "false",
          "description": "print JSON response",
          "required": false
        },
        {
          "name": "limit",
          "type": "int",
          "default": "0",
          "description": "maximum items to return",
          "required": false
        },
        {
          "name": "page-token",
          "type": "string",
          "default": "",
          "description": "opaque page token",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "agent-tools",
      "path": [
        "agent",
        "tools"
      ],
      "title": "leapview agent tools",
      "summary": "List the canonical agent tools",
      "description": "List the canonical agent tools exposed by built-in chat and deployment MCP, including each tool's privilege, effect, defaults, closed input schema, and backing operation.",
      "usage": "leapview agent tools",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "api",
      "path": [
        "api"
      ],
      "title": "leapview api",
      "summary": "Call any generated LeapView API operation",
      "description": "Call any generated LeapView API operation",
      "usage": "leapview api",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "api-call",
        "api-describe",
        "api-list"
      ]
    },
    {
      "id": "api-call",
      "path": [
        "api",
        "call"
      ],
      "title": "leapview api call",
      "summary": "Call a generated API operation",
      "description": "Call a generated API operation",
      "usage": "leapview api call \u003coperation\u003e [flags]",
      "runnable": true,
      "effect": "dynamic",
      "confirmation": "never",
      "arguments": [
        "operation"
      ],
      "options": [
        {
          "name": "body-file",
          "type": "string",
          "default": "",
          "description": "request body file",
          "required": false
        },
        {
          "name": "body-json",
          "type": "string",
          "default": "",
          "description": "request JSON body",
          "required": false
        },
        {
          "name": "content-type",
          "type": "string",
          "default": "",
          "description": "request body content type",
          "required": false
        },
        {
          "name": "path",
          "type": "stringArray",
          "default": "[]",
          "description": "path parameter as key=value; repeatable",
          "required": false
        },
        {
          "name": "query",
          "type": "stringArray",
          "default": "[]",
          "description": "query parameter as key=value; repeatable",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        },
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "default workspace path parameter",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "api-describe",
      "path": [
        "api",
        "describe"
      ],
      "title": "leapview api describe",
      "summary": "Describe a generated API operation",
      "description": "Describe a generated API operation",
      "usage": "leapview api describe \u003coperation\u003e",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "operation"
      ],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "api-list",
      "path": [
        "api",
        "list"
      ],
      "title": "leapview api list",
      "summary": "List generated API operations",
      "description": "List generated API operations",
      "usage": "leapview api list",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "config",
      "path": [
        "config"
      ],
      "title": "leapview config",
      "summary": "Inspect and validate process-global configuration",
      "description": "Inspect and validate process-global configuration",
      "usage": "leapview config",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "config-validate"
      ]
    },
    {
      "id": "config-validate",
      "path": [
        "config",
        "validate"
      ],
      "title": "leapview config validate",
      "summary": "Validate the active server environment",
      "description": "Validate the active server environment",
      "usage": "leapview config validate [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "production",
          "type": "bool",
          "default": "false",
          "description": "validate production requirements even when LEAPVIEW_PRODUCTION is unset",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "dashboards",
      "path": [
        "dashboards"
      ],
      "title": "leapview dashboards",
      "summary": "Inspect dashboards",
      "description": "Inspect dashboards",
      "usage": "leapview dashboards",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "dashboards-describe",
        "dashboards-filter",
        "dashboards-filter-options",
        "dashboards-list",
        "dashboards-page",
        "dashboards-query-page",
        "dashboards-visual",
        "dashboards-visual-data"
      ]
    },
    {
      "id": "dashboards-describe",
      "path": [
        "dashboards",
        "describe"
      ],
      "title": "leapview dashboards describe",
      "summary": "Describe a dashboard",
      "description": "Describe a dashboard",
      "usage": "leapview dashboards describe \u003cdashboard\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "dashboard"
      ],
      "options": [
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "dashboards-filter",
      "path": [
        "dashboards",
        "filter"
      ],
      "title": "leapview dashboards filter",
      "summary": "Describe a compiled dashboard filter binding",
      "description": "Describe a compiled dashboard filter binding",
      "usage": "leapview dashboards filter \u003cdashboard\u003e \u003cpage\u003e \u003cfilter\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "dashboard",
        "page",
        "filter"
      ],
      "options": [
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "dashboards-filter-options",
      "path": [
        "dashboards",
        "filter-options"
      ],
      "title": "leapview dashboards filter-options",
      "summary": "List dashboard filter options",
      "description": "List dashboard filter options",
      "usage": "leapview dashboards filter-options \u003cdashboard\u003e \u003cpage\u003e \u003cfilter\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "dashboard",
        "page",
        "filter"
      ],
      "options": [
        {
          "name": "filter-state-json",
          "type": "string",
          "default": "",
          "description": "versioned dashboard filter state JSON",
          "required": false
        },
        {
          "name": "limit",
          "type": "int",
          "default": "0",
          "description": "maximum items to return",
          "required": false
        },
        {
          "name": "page-token",
          "type": "string",
          "default": "",
          "description": "opaque page token",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "dashboards-list",
      "path": [
        "dashboards",
        "list"
      ],
      "title": "leapview dashboards list",
      "summary": "List dashboards",
      "description": "List dashboards",
      "usage": "leapview dashboards list [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "limit",
          "type": "int",
          "default": "0",
          "description": "maximum items to return",
          "required": false
        },
        {
          "name": "page-token",
          "type": "string",
          "default": "",
          "description": "opaque page token",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "dashboards-page",
      "path": [
        "dashboards",
        "page"
      ],
      "title": "leapview dashboards page",
      "summary": "Describe a dashboard page",
      "description": "Describe a dashboard page",
      "usage": "leapview dashboards page \u003cdashboard\u003e \u003cpage\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "dashboard",
        "page"
      ],
      "options": [
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "dashboards-query-page",
      "path": [
        "dashboards",
        "query-page"
      ],
      "title": "leapview dashboards query-page",
      "summary": "Query a dashboard page",
      "description": "Query a dashboard page",
      "usage": "leapview dashboards query-page \u003cdashboard\u003e \u003cpage\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "dashboard",
        "page"
      ],
      "options": [
        {
          "name": "filter-state-json",
          "type": "string",
          "default": "",
          "description": "versioned dashboard filter state JSON",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "dashboards-visual",
      "path": [
        "dashboards",
        "visual"
      ],
      "title": "leapview dashboards visual",
      "summary": "Describe a dashboard visual",
      "description": "Describe a dashboard visual",
      "usage": "leapview dashboards visual \u003cdashboard\u003e \u003cpage\u003e \u003cvisual\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "dashboard",
        "page",
        "visual"
      ],
      "options": [
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "dashboards-visual-data",
      "path": [
        "dashboards",
        "visual-data"
      ],
      "title": "leapview dashboards visual-data",
      "summary": "Query dashboard visual data",
      "description": "Query dashboard visual data",
      "usage": "leapview dashboards visual-data \u003cdashboard\u003e \u003cpage\u003e \u003cvisual\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "dashboard",
        "page",
        "visual"
      ],
      "options": [
        {
          "name": "count",
          "type": "int",
          "default": "0",
          "description": "row count for table, matrix, or pivot visuals",
          "required": false
        },
        {
          "name": "filter-state-json",
          "type": "string",
          "default": "",
          "description": "versioned dashboard filter state JSON",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "data",
      "path": [
        "data"
      ],
      "title": "leapview data",
      "summary": "Manage project-global data revisions",
      "description": "Manage project-global data revisions",
      "usage": "leapview data",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "data-plan",
        "data-revisions",
        "data-sync"
      ]
    },
    {
      "id": "data-plan",
      "path": [
        "data",
        "plan"
      ],
      "title": "leapview data plan",
      "summary": "Plan a local managed data revision",
      "description": "Plan a local managed data revision",
      "usage": "leapview data plan [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "connection",
          "type": "string",
          "default": "",
          "description": "project-global managed connection",
          "required": false
        },
        {
          "name": "from",
          "type": "string",
          "default": "",
          "description": "local filesystem root to ingest",
          "required": false
        },
        {
          "name": "previous-manifest",
          "type": "string",
          "default": "",
          "description": "prior managed data manifest path",
          "required": false
        },
        {
          "name": "project",
          "type": "string",
          "default": "dashboards/leapview.yaml",
          "description": "project path",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "data-revisions",
      "path": [
        "data",
        "revisions"
      ],
      "title": "leapview data revisions",
      "summary": "Inspect managed data revisions",
      "description": "Inspect managed data revisions",
      "usage": "leapview data revisions",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "data-revisions-current",
        "data-revisions-list"
      ]
    },
    {
      "id": "data-revisions-current",
      "path": [
        "data",
        "revisions",
        "current"
      ],
      "title": "leapview data revisions current",
      "summary": "Print the active managed data revision",
      "description": "Print the active managed data revision",
      "usage": "leapview data revisions current [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "connection",
          "type": "string",
          "default": "",
          "description": "project-global managed connection",
          "required": false
        },
        {
          "name": "environment",
          "type": "string",
          "default": "",
          "description": "assert the target instance environment",
          "required": false
        },
        {
          "name": "project",
          "type": "string",
          "default": "",
          "description": "server project id",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "data-revisions-list",
      "path": [
        "data",
        "revisions",
        "list"
      ],
      "title": "leapview data revisions list",
      "summary": "List staged managed data revisions",
      "description": "List staged managed data revisions",
      "usage": "leapview data revisions list [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "connection",
          "type": "string",
          "default": "",
          "description": "project-global managed connection",
          "required": false
        },
        {
          "name": "environment",
          "type": "string",
          "default": "",
          "description": "assert the target instance environment",
          "required": false
        },
        {
          "name": "limit",
          "type": "int",
          "default": "0",
          "description": "maximum revisions to return",
          "required": false
        },
        {
          "name": "page-token",
          "type": "string",
          "default": "",
          "description": "opaque page token",
          "required": false
        },
        {
          "name": "project",
          "type": "string",
          "default": "",
          "description": "server project id",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "data-sync",
      "path": [
        "data",
        "sync"
      ],
      "title": "leapview data sync",
      "summary": "Stage a managed data revision",
      "description": "Stage a managed data revision",
      "usage": "leapview data sync [flags]",
      "runnable": true,
      "effect": "write",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "connection",
          "type": "string",
          "default": "",
          "description": "project-global managed connection",
          "required": false
        },
        {
          "name": "environment",
          "type": "string",
          "default": "",
          "description": "assert the target instance environment",
          "required": false
        },
        {
          "name": "from",
          "type": "string",
          "default": "",
          "description": "local filesystem root to ingest",
          "required": false
        },
        {
          "name": "project",
          "type": "string",
          "default": "dashboards/leapview.yaml",
          "description": "project catalog path",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "deploy",
      "path": [
        "deploy"
      ],
      "title": "leapview deploy",
      "summary": "Atomically deploy a configuration-as-code project",
      "description": "Atomically deploy a configuration-as-code project",
      "usage": "leapview deploy [flags]",
      "runnable": true,
      "effect": "write",
      "confirmation": "conditional",
      "arguments": [],
      "options": [
        {
          "name": "auto-approve",
          "type": "bool",
          "default": "false",
          "description": "approve and activate the deployment without prompting",
          "required": false
        },
        {
          "name": "environment",
          "type": "string",
          "default": "",
          "description": "assert the target instance environment",
          "required": false
        },
        {
          "name": "project",
          "type": "string",
          "default": "dashboards/leapview.yaml",
          "description": "project path",
          "required": false
        },
        {
          "name": "revision",
          "type": "stringArray",
          "default": "[]",
          "description": "managed revision pin as connection=sha256:\u003cdigest\u003e (repeatable)",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "evaluate",
      "path": [
        "evaluate"
      ],
      "title": "leapview evaluate",
      "summary": "Run the self-contained local evaluation server",
      "description": "Run the self-contained local evaluation server",
      "usage": "leapview evaluate",
      "runnable": true,
      "effect": "local-write",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "evaluate-first-login"
      ]
    },
    {
      "id": "evaluate-first-login",
      "path": [
        "evaluate",
        "first-login"
      ],
      "title": "leapview evaluate first-login",
      "summary": "Print and consume the one-time local evaluation credentials",
      "description": "Print and consume the one-time local evaluation credentials",
      "usage": "leapview evaluate first-login",
      "runnable": true,
      "effect": "destructive",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "healthcheck",
      "path": [
        "healthcheck"
      ],
      "title": "leapview healthcheck",
      "summary": "Check the local LeapView readiness endpoint",
      "description": "Check the local LeapView readiness endpoint",
      "usage": "leapview healthcheck [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "timeout",
          "type": "duration",
          "default": "5s",
          "description": "healthcheck HTTP timeout",
          "required": false
        },
        {
          "name": "url",
          "type": "string",
          "default": "",
          "description": "readiness URL to check",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "login",
      "path": [
        "login"
      ],
      "title": "leapview login",
      "summary": "Store a LeapView API token for a target",
      "description": "Store a LeapView API token for a target",
      "usage": "leapview login [flags]",
      "runnable": true,
      "effect": "local-write",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "plan",
      "path": [
        "plan"
      ],
      "title": "leapview plan",
      "summary": "Emit a deterministic configuration-as-code plan",
      "description": "Emit a deterministic configuration-as-code plan",
      "usage": "leapview plan [project] [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "project"
      ],
      "options": [
        {
          "name": "environment",
          "type": "string",
          "default": "",
          "description": "assert the target instance environment for active diff",
          "required": false
        },
        {
          "name": "json",
          "type": "bool",
          "default": "false",
          "description": "emit JSON plan",
          "required": false
        },
        {
          "name": "project",
          "type": "string",
          "default": "dashboards/leapview.yaml",
          "description": "project path",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL for active deployment diff",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        },
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id for active diff",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "schema",
      "path": [
        "schema"
      ],
      "title": "leapview schema",
      "summary": "Inspect LeapView YAML schemas",
      "description": "Inspect LeapView YAML schemas",
      "usage": "leapview schema",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "schema-export"
      ]
    },
    {
      "id": "schema-export",
      "path": [
        "schema",
        "export"
      ],
      "title": "leapview schema export",
      "summary": "Export generated schema artifacts",
      "description": "Export generated schema artifacts",
      "usage": "leapview schema export [flags]",
      "runnable": true,
      "effect": "local-write",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "format",
          "type": "string",
          "default": "json-schema",
          "description": "schema output format",
          "required": false
        },
        {
          "name": "out",
          "type": "string",
          "default": "schemas/json",
          "description": "output directory",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "search",
      "path": [
        "search"
      ],
      "title": "leapview search",
      "summary": "Search accessible product objects",
      "description": "Search accessible product objects",
      "usage": "leapview search \u003cquery\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "query"
      ],
      "options": [
        {
          "name": "json",
          "type": "bool",
          "default": "false",
          "description": "print JSON response",
          "required": false
        },
        {
          "name": "limit",
          "type": "int",
          "default": "0",
          "description": "maximum items to return",
          "required": false
        },
        {
          "name": "page-token",
          "type": "string",
          "default": "",
          "description": "opaque page token",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        },
        {
          "name": "type",
          "type": "stringArray",
          "default": "[]",
          "description": "result type filter; repeatable or comma-separated",
          "required": false
        },
        {
          "name": "workspace",
          "type": "stringArray",
          "default": "[]",
          "description": "workspace filter; repeatable",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "semantic-models",
      "path": [
        "semantic-models"
      ],
      "title": "leapview semantic-models",
      "summary": "Inspect semantic models",
      "description": "Inspect semantic models",
      "usage": "leapview semantic-models",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "semantic-models-dataset",
        "semantic-models-datasets",
        "semantic-models-describe",
        "semantic-models-explain-preview",
        "semantic-models-explain-query",
        "semantic-models-fields",
        "semantic-models-list",
        "semantic-models-preview",
        "semantic-models-query"
      ]
    },
    {
      "id": "semantic-models-dataset",
      "path": [
        "semantic-models",
        "dataset"
      ],
      "title": "leapview semantic-models dataset",
      "summary": "Describe a semantic model dataset",
      "description": "Describe a semantic model dataset",
      "usage": "leapview semantic-models dataset \u003cmodel\u003e \u003cdataset\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "model",
        "dataset"
      ],
      "options": [
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "semantic-models-datasets",
      "path": [
        "semantic-models",
        "datasets"
      ],
      "title": "leapview semantic-models datasets",
      "summary": "List semantic model datasets",
      "description": "List semantic model datasets",
      "usage": "leapview semantic-models datasets \u003cmodel\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "model"
      ],
      "options": [
        {
          "name": "limit",
          "type": "int",
          "default": "0",
          "description": "maximum items to return",
          "required": false
        },
        {
          "name": "page-token",
          "type": "string",
          "default": "",
          "description": "opaque page token",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "semantic-models-describe",
      "path": [
        "semantic-models",
        "describe"
      ],
      "title": "leapview semantic-models describe",
      "summary": "Describe a semantic model",
      "description": "Describe a semantic model",
      "usage": "leapview semantic-models describe \u003cmodel\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "model"
      ],
      "options": [
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "semantic-models-explain-preview",
      "path": [
        "semantic-models",
        "explain-preview"
      ],
      "title": "leapview semantic-models explain-preview",
      "summary": "Explain a semantic model dataset row preview",
      "description": "Explain a semantic model dataset row preview",
      "usage": "leapview semantic-models explain-preview \u003cmodel\u003e \u003cdataset\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "model",
        "dataset"
      ],
      "options": [
        {
          "name": "body-json",
          "type": "string",
          "default": "",
          "description": "request JSON body",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "semantic-models-explain-query",
      "path": [
        "semantic-models",
        "explain-query"
      ],
      "title": "leapview semantic-models explain-query",
      "summary": "Explain a governed semantic query",
      "description": "Explain a governed semantic query",
      "usage": "leapview semantic-models explain-query \u003cmodel\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "model"
      ],
      "options": [
        {
          "name": "body-json",
          "type": "string",
          "default": "",
          "description": "request JSON body",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "semantic-models-fields",
      "path": [
        "semantic-models",
        "fields"
      ],
      "title": "leapview semantic-models fields",
      "summary": "List semantic model dataset fields",
      "description": "List semantic model dataset fields",
      "usage": "leapview semantic-models fields \u003cmodel\u003e \u003cdataset\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "model",
        "dataset"
      ],
      "options": [
        {
          "name": "limit",
          "type": "int",
          "default": "0",
          "description": "maximum items to return",
          "required": false
        },
        {
          "name": "page-token",
          "type": "string",
          "default": "",
          "description": "opaque page token",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "semantic-models-list",
      "path": [
        "semantic-models",
        "list"
      ],
      "title": "leapview semantic-models list",
      "summary": "List semantic models",
      "description": "List semantic models",
      "usage": "leapview semantic-models list [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "limit",
          "type": "int",
          "default": "0",
          "description": "maximum items to return",
          "required": false
        },
        {
          "name": "page-token",
          "type": "string",
          "default": "",
          "description": "opaque page token",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "semantic-models-preview",
      "path": [
        "semantic-models",
        "preview"
      ],
      "title": "leapview semantic-models preview",
      "summary": "Preview semantic model dataset rows",
      "description": "Preview semantic model dataset rows",
      "usage": "leapview semantic-models preview \u003cmodel\u003e \u003cdataset\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "model",
        "dataset"
      ],
      "options": [
        {
          "name": "body-json",
          "type": "string",
          "default": "",
          "description": "request JSON body",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "semantic-models-query",
      "path": [
        "semantic-models",
        "query"
      ],
      "title": "leapview semantic-models query",
      "summary": "Query governed semantic data",
      "description": "Query governed semantic data",
      "usage": "leapview semantic-models query \u003cmodel\u003e [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "model"
      ],
      "options": [
        {
          "name": "body-json",
          "type": "string",
          "default": "",
          "description": "request JSON body",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [
        {
          "name": "workspace",
          "type": "string",
          "default": "",
          "description": "workspace id",
          "required": false
        }
      ],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "serve",
      "path": [
        "serve"
      ],
      "title": "leapview serve",
      "summary": "Run the LeapView HTTP server",
      "description": "Run the LeapView HTTP server",
      "usage": "leapview serve [flags]",
      "runnable": true,
      "effect": "local-write",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "addr",
          "type": "string",
          "default": "",
          "description": "listen address; defaults to the configured address",
          "required": false
        },
        {
          "name": "environment",
          "type": "string",
          "default": "",
          "description": "instance environment; overrides LEAPVIEW_ENVIRONMENT, then defaults to prod in production and dev otherwise",
          "required": false
        },
        {
          "name": "production",
          "type": "bool",
          "default": "false",
          "description": "serve active serving state from the platform DB",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "validate",
      "path": [
        "validate"
      ],
      "title": "leapview validate",
      "summary": "Validate a configuration-as-code project",
      "description": "Validate a configuration-as-code project",
      "usage": "leapview validate [project] [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [
        "project"
      ],
      "options": [
        {
          "name": "json",
          "type": "bool",
          "default": "false",
          "description": "emit JSON diagnostics",
          "required": false
        },
        {
          "name": "project",
          "type": "string",
          "default": "dashboards/leapview.yaml",
          "description": "project path",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "version",
      "path": [
        "version"
      ],
      "title": "leapview version",
      "summary": "Report the LeapView build identity",
      "description": "Report the LeapView build identity",
      "usage": "leapview version [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "json",
          "type": "bool",
          "default": "false",
          "description": "emit machine-readable JSON",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    },
    {
      "id": "workspaces",
      "path": [
        "workspaces"
      ],
      "title": "leapview workspaces",
      "summary": "Inspect workspaces",
      "description": "Inspect workspaces",
      "usage": "leapview workspaces",
      "runnable": false,
      "effect": "none",
      "confirmation": "never",
      "arguments": [],
      "options": [],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": [
        "workspaces-list"
      ]
    },
    {
      "id": "workspaces-list",
      "path": [
        "workspaces",
        "list"
      ],
      "title": "leapview workspaces list",
      "summary": "List workspaces",
      "description": "List workspaces",
      "usage": "leapview workspaces list [flags]",
      "runnable": true,
      "effect": "read",
      "confirmation": "never",
      "arguments": [],
      "options": [
        {
          "name": "limit",
          "type": "int",
          "default": "0",
          "description": "maximum items to return",
          "required": false
        },
        {
          "name": "page-token",
          "type": "string",
          "default": "",
          "description": "opaque page token",
          "required": false
        },
        {
          "name": "target",
          "type": "string",
          "default": "",
          "description": "LeapView server URL",
          "required": false
        },
        {
          "name": "token",
          "type": "string",
          "default": "",
          "description": "API token",
          "required": false
        }
      ],
      "inheritedOptions": [],
      "examples": [],
      "subcommands": []
    }
  ]
}
