Skip to content

Make Codex and Claude Code subscriptions go further: a local model router that gives routine agent work to economical models and keeps your strongest model for the hard parts.

209 KB
Raw Blame
{
  "schema_version": {
    "major": 1,
    "minor": 0
  },
  "product_contract_revision": "487a807c8dc25cfb24e8b097882cd3bb9716a009",
  "proposal_map_revision": "ab4da93cc49c6ec56a01e046230411ff1ca82300",
  "descriptor_digest": "sha256:4c6ad98a122d461104603829802dcf3d90c09f469756cfb42eedac9a2615f507",
  "visibility": "release",
  "commands": [
    {
      "command_id": "console.open",
      "path": [
        "console",
        "open"
      ],
      "operation_id": "CreateConsoleLaunch",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "action",
      "request_schema": "hiroute.console-launch-request/v1",
      "response_schema": "hiroute.console-launch/v1",
      "effect": "typed_action",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Create a single-use owner console launch link.",
        "usage": "hiroute console open [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Application-owned typed operation; side effects are recorded by the Operation and external ledgers.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute console open --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id console.open"
        ]
      },
      "positive": {
        "scenario_id": "p0.console.open.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.console.open.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "console.token.create",
      "path": [
        "console",
        "token",
        "create"
      ],
      "operation_id": "CreateConsoleToken",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "action",
      "request_schema": "hiroute.console-token-create/v1",
      "response_schema": "hiroute.console-token-result/v1",
      "effect": "typed_action",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Create a named owner console access token, shown once.",
        "usage": "hiroute console token create [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Application-owned typed operation; side effects are recorded by the Operation and external ledgers.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute console token create --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id console.token.create"
        ]
      },
      "positive": {
        "scenario_id": "p0.console.token.create.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.console.token.create.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "console.token.list",
      "path": [
        "console",
        "token",
        "list"
      ],
      "operation_id": "ListConsoleTokens",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.console-token-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "List console token metadata without credential secrets.",
        "usage": "hiroute console token list [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute console token list --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id console.token.list"
        ]
      },
      "positive": {
        "scenario_id": "p0.console.token.list.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.console.token.list.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "console.token.revoke",
      "path": [
        "console",
        "token",
        "revoke"
      ],
      "operation_id": "RevokeConsoleToken",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "action",
      "request_schema": "hiroute.console-token-revoke/v1",
      "response_schema": "hiroute.console-token-result/v1",
      "effect": "typed_action",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Revoke a console access token and its sessions.",
        "usage": "hiroute console token revoke [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Application-owned typed operation; side effects are recorded by the Operation and external ledgers.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute console token revoke --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id console.token.revoke"
        ]
      },
      "positive": {
        "scenario_id": "p0.console.token.revoke.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.console.token.revoke.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "schema.list",
      "path": [
        "schema",
        "list"
      ],
      "operation_id": "ListSchemas",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "List the exact released CLI contract without exposing planned or reserved operations.",
        "usage": "hiroute schema list [typed options] --non-interactive --output json",
        "arguments_and_options": "Global --output json and --request-id options only.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute schema list --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id schema.list"
        ]
      },
      "positive": {
        "scenario_id": "p0.schema.list.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.schema.list.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "schema.show",
      "path": [
        "schema",
        "show"
      ],
      "operation_id": "ShowSchema",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Show one exact released command descriptor and its machine contract.",
        "usage": "hiroute schema show --command-id <stable-command-id> [--include-schema] --non-interactive --output json",
        "arguments_and_options": "Required: --command-id <stable-command-id>. --include-schema returns complete bundled request/response definitions and examples for management commands; omission retains the descriptor. Global --output json and --request-id options are supported.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute schema show --command-id schema.list --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id schema.show"
        ]
      },
      "positive": {
        "scenario_id": "p0.schema.show.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.schema.show.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "operations.find",
      "path": [
        "operations",
        "find"
      ],
      "operation_id": "FindOperationByIdempotency",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.operation-idempotency-lookup/v1",
      "response_schema": "hiroute.operation-idempotency-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Find the original Operation in one exact idempotency scope without submitting a write.",
        "usage": "hiroute operations find (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute operations find --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id operations.find"
        ]
      },
      "positive": {
        "scenario_id": "p0.operations.find.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.operations.find.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "system.status",
      "path": [
        "system",
        "status"
      ],
      "operation_id": "GetSystemStatus",
      "trace_ids": [
        "CLI-014",
        "APP-014"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.system-status/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read daemon, release, capability, and product readiness status.",
        "usage": "hiroute system status [OPTIONS] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute system status --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id system.status"
        ]
      },
      "positive": {
        "scenario_id": "p0.system.status.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.system.status.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agents.scan",
      "path": [
        "agents",
        "scan"
      ],
      "operation_id": "ScanAgents",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.agent-scan-request/v1",
      "response_schema": "hiroute.agent-discovery-list/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Discover exact supported Agent installations and profiles.",
        "usage": "hiroute agents scan [(--request-stdin | --request-file <PATH>) | --request-file <PATH>] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute agents scan --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id agents.scan"
        ]
      },
      "positive": {
        "scenario_id": "p0.agents.scan.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agents.scan.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agents.list",
      "path": [
        "agents",
        "list"
      ],
      "operation_id": "ListAgents",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.agent-discovery-list/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "List discovered Agent installations and connection state.",
        "usage": "hiroute agents list [OPTIONS] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute agents list --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id agents.list"
        ]
      },
      "positive": {
        "scenario_id": "p0.agents.list.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agents.list.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agents.previous-routing.preview",
      "path": [
        "agents",
        "previous-routing",
        "preview"
      ],
      "operation_id": "PreviewAgentPreviousRouting",
      "trace_ids": [
        "CLI-068",
        "APP-068"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.agent-previous-routing-query/v1",
      "response_schema": "hiroute.agent-previous-routing-preview/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Recover selected previous mappings as an ordinary Agent settings draft.",
        "usage": "hiroute agents previous-routing preview [typed options] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Accepts --request-stdin or --request-file with {agent,presets?}. Claude presets: opus, sonnet, haiku; Codex: default; additional-model Agents: models. Returns a draft for the ordinary settings Preview/Apply. Missing history never implies native routing.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute agents previous-routing preview --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id agents.previous-routing.preview"
        ]
      },
      "positive": {
        "scenario_id": "p0.agents.previous-routing.preview.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agents.previous-routing.preview.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agents.connect.preview",
      "path": [
        "agents",
        "connect",
        "preview"
      ],
      "operation_id": "PreviewAgentConnectionChange",
      "trace_ids": [
        "CLI-054",
        "APP-054"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "preview",
      "request_schema": "hiroute.agent-connection-preview-request/union",
      "response_schema": "hiroute.agent-connection-preview/union",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "preview_apply_pair": "agents.connect.apply",
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Preview Agent grant, catalog, Skill, overlay, and owned configuration changes.",
        "usage": "hiroute agents connect preview (--context ID [--hermes-root PATH] [--plan ID <native choices>] [--management enable|keep] [--collaboration explicit|delegate_by_default|keep] | --request-file PATH | --request-stdin) [--apply-file PATH] [--idempotency-key KEY]",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts only the strict v1 connection or v2 managed-settings request. Model, management_skill and collaboration each support independent keep/configure/restore, including both Skills in one request. Omitted facets keep their state. Apply uses local OS socket access and is revision-checked and idempotent; it and writes only owned Agent fields; restore refuses concurrent ownership drift.",
        "effects": "Stateless Preview: no ID, TTL, Operation, Secret, file, database, publication, or network write.",
        "network_and_model_use": "No model use and no non-fixture network access.",
        "automation": "Convenience flags and JSON input are alternatives. --apply-file creates a new private exact Apply request, never overwrites, and performs no Apply. Review effects, then submit that file with the matching Apply command. After uncertain submission, use submission.operation_lookup with operations find or resend the identical file. Core supported variants are compute save, Plan content v2 and Agent settings v2. Routing recovery: retain a successful private routing show response before changes; use routing preview --plan ID --restore-from BEFORE_JSON --apply-file NEW_FILE, review and routing apply --request-file NEW_FILE. This restores complete effective configuration with the current head revision, exclusively from the same Plan/workspace; do not mix with edit flags or typed request inputs. Compare all desired fields after recovery; revisions advance and native facet restoration is separate. Routing: repeat economy/primary flags to preserve order; select --decision local_rules or --decision-service ID@REVISION explicitly for a new smart Plan. Native choices: Hermes requires --protocol; Codex requires --native-models preserve_available|hiroute_only and --native-default preserve_native|plan; Claude requires explicit --preset opus|sonnet|haiku; Qoder/Pi/DSH require --protocol and add entries without claiming a native default. Missing choices remain unresolved. --facet may repeat to restore selected facets; other facets stay untouched. Desktop resident-service evidence must come from Desktop, never a fabricated CLI declaration.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute agents connect preview --request-file preview-request.json --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id agents.connect.preview"
        ]
      },
      "positive": {
        "scenario_id": "p0.agents.connect.preview.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agents.connect.preview.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agents.connect.apply",
      "path": [
        "agents",
        "connect",
        "apply"
      ],
      "operation_id": "ApplyAgentConnectionChange",
      "trace_ids": [
        "CLI-055",
        "APP-055"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.agent-connection-apply-request/union",
      "response_schema": "hiroute.operation-view/v1",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "preview_apply_pair": "agents.connect.preview",
      "idempotency": "required",
      "help": {
        "purpose": "Apply an exact AgentConnection change through the recoverable Application saga.",
        "usage": "hiroute agents connect apply (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts only the strict v1 connection or v2 managed-settings request. Model, management_skill and collaboration each support independent keep/configure/restore, including both Skills in one request. Omitted facets keep their state. Apply uses local OS socket access and is revision-checked and idempotent; it and writes only owned Agent fields; restore refuses concurrent ownership drift.",
        "effects": "Same-UID Application-owned journaled operation after exact spec, digest, revision, and idempotency checks.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute agents connect apply --request-file apply-request.json --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id agents.connect.apply"
        ]
      },
      "positive": {
        "scenario_id": "p0.agents.connect.apply.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agents.connect.apply.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agents.connect.status",
      "path": [
        "agents",
        "connect",
        "status"
      ],
      "operation_id": "GetAgentConnectionStatus",
      "trace_ids": [
        "CLI-056",
        "APP-056"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.agent-connection-status-request/union",
      "response_schema": "hiroute.agent-connection-status/union",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read AgentConnection and managed artifact convergence.",
        "usage": "hiroute agents connect status <CONNECTION_OR_CONTEXT_ID> | --effective --context <ID> --plan <ID> [--session-id <ID>] [--observed-request-id <ID>] | --request-file <PATH> --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use --effective --context ID --plan ID for separate saved, native-loading, selection and exact request evidence. Unknown loading stays unknown. This read-only query never restarts an Agent or calls a model; recorded outcomes apply only to the identified request/session.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute agents connect status --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id agents.connect.status"
        ]
      },
      "positive": {
        "scenario_id": "p0.agents.connect.status.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agents.connect.status.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agents.restore.preview",
      "path": [
        "agents",
        "restore",
        "preview"
      ],
      "operation_id": "PreviewAgentConnectionRestore",
      "trace_ids": [
        "CLI-009",
        "APP-009"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "preview",
      "request_schema": "hiroute.agent-connection-preview-request/union",
      "response_schema": "hiroute.agent-connection-preview/union",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "preview_apply_pair": "agents.restore.apply",
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Preview field-owned Agent configuration restoration without overwriting concurrent edits.",
        "usage": "hiroute agents restore preview (--context ID --facet model|management_skill|collaboration [--hermes-root PATH] [--restore-native-model ID] | --request-file PATH | --request-stdin) [--apply-file PATH] [--idempotency-key KEY]",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts only the strict v1 connection or v2 managed-settings request. Model, management_skill and collaboration each support independent keep/configure/restore, including both Skills in one request. Omitted facets keep their state. Apply uses local OS socket access and is revision-checked and idempotent; it and writes only owned Agent fields; restore refuses concurrent ownership drift.",
        "effects": "Stateless Preview: no ID, TTL, Operation, Secret, file, database, publication, or network write.",
        "network_and_model_use": "No model use and no non-fixture network access.",
        "automation": "Convenience flags and JSON input are alternatives. --apply-file creates a new private exact Apply request, never overwrites, and performs no Apply. Review effects, then submit that file with the matching Apply command. After uncertain submission, use submission.operation_lookup with operations find or resend the identical file. Core supported variants are compute save, Plan content v2 and Agent settings v2. Routing recovery: retain a successful private routing show response before changes; use routing preview --plan ID --restore-from BEFORE_JSON --apply-file NEW_FILE, review and routing apply --request-file NEW_FILE. This restores complete effective configuration with the current head revision, exclusively from the same Plan/workspace; do not mix with edit flags or typed request inputs. Compare all desired fields after recovery; revisions advance and native facet restoration is separate. Routing: repeat economy/primary flags to preserve order; select --decision local_rules or --decision-service ID@REVISION explicitly for a new smart Plan. Native choices: Hermes requires --protocol; Codex requires --native-models preserve_available|hiroute_only and --native-default preserve_native|plan; Claude requires explicit --preset opus|sonnet|haiku; Qoder/Pi/DSH require --protocol and add entries without claiming a native default. Missing choices remain unresolved. --facet may repeat to restore selected facets; other facets stay untouched. Desktop resident-service evidence must come from Desktop, never a fabricated CLI declaration.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute agents restore preview --request-file preview-request.json --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id agents.restore.preview"
        ]
      },
      "positive": {
        "scenario_id": "p0.agents.restore.preview.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agents.restore.preview.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agents.restore.apply",
      "path": [
        "agents",
        "restore",
        "apply"
      ],
      "operation_id": "ApplyAgentConnectionRestore",
      "trace_ids": [
        "CLI-019",
        "APP-019"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.agent-connection-apply-request/union",
      "response_schema": "hiroute.operation-view/v1",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "preview_apply_pair": "agents.restore.preview",
      "idempotency": "required",
      "help": {
        "purpose": "Restore only still-owned Agent fields from an exact restore point.",
        "usage": "hiroute agents restore apply (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts only the strict v1 connection or v2 managed-settings request. Model, management_skill and collaboration each support independent keep/configure/restore, including both Skills in one request. Omitted facets keep their state. Apply uses local OS socket access and is revision-checked and idempotent; it and writes only owned Agent fields; restore refuses concurrent ownership drift.",
        "effects": "Same-UID Application-owned journaled operation after exact spec, digest, revision, and idempotency checks.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute agents restore apply --request-file apply-request.json --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id agents.restore.apply"
        ]
      },
      "positive": {
        "scenario_id": "p0.agents.restore.apply.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agents.restore.apply.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agents.check",
      "path": [
        "agents",
        "check"
      ],
      "operation_id": "CheckAgentConnection",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "external_probe",
      "request_schema": "hiroute.agent-check-request/v1",
      "response_schema": "hiroute.agent-check/v1",
      "effect": "bounded_probe",
      "network": "local_control_then_registered_gateway",
      "model_call": "explicit_live_scope_only",
      "stdin_channels": [
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Drive the registered Agent profile through the formal product entrypoint.",
        "usage": "hiroute agents check <AGENT_ID> --scope <configuration|native-authentication|collaboration|live> --suite <quick|tool|conformance> [--target <JSON>] [--allow-model-call]; live requires an explicit context/surface/revision/model target and protected consent; local checks use same-UID trust and make no upstream model call",
        "arguments_and_options": "Configuration, native-authentication and collaboration are bounded local checks admitted by the owner-only same-UID transport and make no upstream model call. Live requires --target JSON containing context_id, surface, expected_applied_revision and client_model_ids, --allow-model-call and a separately delivered one-shot capability bound to that target. Targets are forbidden on local checks; provider, credential, prompt and URL overrides are forbidden.",
        "effects": "Configuration, native-authentication, and collaboration are bounded same-UID local checks. Live creates bounded connectivity-probe runtime state and may update real credential cooldown after authentic 401/429 responses; probe traffic is excluded from Session and Value.",
        "network_and_model_use": "Local checks make no provider call and require no second authorization channel. Live quick sends one fixed inference request, tool sends a fixed inference request with a built-in no-side-effect tool, and conformance may send a bounded protocol matrix; every live suite may consume real provider quota and requires explicit consent plus a protected probe grant.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute agents check --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id agents.check"
        ]
      },
      "positive": {
        "scenario_id": "p0.agents.check.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agents.check.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "agent.launch",
      "path": [
        "agent",
        "launch"
      ],
      "operation_id": "GetManagedAgentLaunchDescriptor",
      "trace_ids": [
        "CLI-057",
        "APP-057"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "action",
      "request_schema": "hiroute.agent-launch-descriptor-request/v1",
      "response_schema": "hiroute.managed-claude-launch-descriptor/v2",
      "effect": "managed_local_process",
      "network": "local_control_then_numeric_loopback_gateway",
      "model_call": "caller_controlled_via_managed_loopback_gateway",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Launch the managed Claude Code connection through the published three-slot snapshot.",
        "usage": "hiroute agent launch --agent claude-code --context <CONTEXT_ID> -- <CLAUDE_SESSION_ARGS...>",
        "arguments_and_options": "--agent claude-code and --context <CONTEXT_ID> are required, followed by the exact -- delimiter. Session arguments after -- are passed as native OsString values. The last --settings object or file supplies the managed overlay, matching native repeated-option precedence (unrelated fields survive; routing, authentication, and provider entries stay managed). --model, --setting-sources, and --fallback-model pass through unchanged. Cloud-provider, authentication, and routing override arguments are rejected before Local Control access or spawn.",
        "effects": "Creates one owner-only temporary launch overlay, directly spawns the exact managed Agent executable without a shell, and removes the overlay after child exit; no persistent user configuration is changed.",
        "network_and_model_use": "Local Control supplies a non-secret descriptor. The launched Claude process may send caller-requested model traffic only through the numeric-loopback HiRoute Gateway.",
        "automation": "Treat the exact -- delimiter as the child argv boundary. Before-spawn failures are typed machine envelopes; after spawn, consume the child streams and exit status directly.",
        "output": "On successful spawn, stdout and stderr are the launched Agent streams; the non-secret launch descriptor is not printed. Failures before spawn emit one hiroute.machine-envelope/v2 JSON object on stdout.",
        "exit_status": "Returns the launched Agent exit code, or 128 plus its terminating Unix signal. Before spawn: 2 usage; 3 auth/routing conflict; 5 connection not found; 6 unavailable. Launcher lifecycle failures return 6.",
        "examples": [
          "hiroute agent launch --agent claude-code --context agent-context/claude/example -- --print 'hello'"
        ],
        "see_also": [
          "hiroute schema show --command-id agent.launch"
        ]
      },
      "positive": {
        "scenario_id": "p0.agent.launch.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.agent.launch.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.scan",
      "path": [
        "compute",
        "scan"
      ],
      "operation_id": "ScanCompute",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.compute-scan-request/union",
      "response_schema": "hiroute.compute-scan-result/union",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Discover registered subscription, Native API, and free compute sources.",
        "usage": "hiroute compute scan (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "No input retains released V1 rows. Request hiroute.compute-scan-request/v2 explicitly for connection points, with the selected native_target for Hermes. No scan result is a saved source or account entitlement.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute scan --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.scan"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.scan.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.scan.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.list",
      "path": [
        "compute",
        "list"
      ],
      "operation_id": "ListCompute",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.compute-management-query/v2",
      "response_schema": "hiroute.compute-management-snapshot/v2",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "List compute sources, bindings, inventory, and redacted readiness.",
        "usage": "hiroute compute list --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute list --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.list"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.list.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.list.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.show",
      "path": [
        "compute",
        "show"
      ],
      "operation_id": "GetCompute",
      "trace_ids": [
        "CLI-010",
        "APP-010"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.compute-management-query/v2",
      "response_schema": "hiroute.compute-management-snapshot/v2",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Show exact source identity, binding, offering, and cooldown state.",
        "usage": "hiroute compute show <SOURCE_ID> --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute show source/example --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.show"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.show.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.show.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.connection.prepare",
      "path": [
        "compute",
        "connection",
        "prepare"
      ],
      "operation_id": "PrepareDiscoveredModelConnection",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.prepare-discovered-model-connection-request/v1",
      "response_schema": "hiroute.compute-candidate-view/v2",
      "effect": "local_candidate_preparation",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Prepare the current opaque native connection-point reference without an inference call.",
        "usage": "hiroute compute connection prepare (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Registers a private ephemeral candidate and protected credential reference after exact source reread. Does not save a source, mutate native files or call a model.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Reuse the opaque discovery reference and revision exactly. Prepare privately rereads native facts and returns selectable model refs. Save all currently selectable refs by default or the explicit requested subset through Preview/Apply; never omit selection or treat all as a wildcard.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute connection prepare --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.connection.prepare"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.connection.prepare.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.connection.prepare.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.connection.options",
      "path": [
        "compute",
        "connection",
        "options"
      ],
      "operation_id": "ListConnectionOptions",
      "trace_ids": [
        "CLI-048",
        "APP-048"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.compute-connection-options-request/v1",
      "response_schema": "hiroute.compute-connection-options/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "List trusted Release Connector Registry connection options.",
        "usage": "hiroute compute connection options [--request-file <PATH> | (--request-stdin | --request-file <PATH>)] --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute connection options --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.connection.options"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.connection.options.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.connection.options.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.connection.preview",
      "path": [
        "compute",
        "connection",
        "preview"
      ],
      "operation_id": "PreviewComputeConnectionChange",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "preview",
      "request_schema": "hiroute.compute-connection-preview-request/union",
      "response_schema": "hiroute.compute-connection-preview/union",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "preview_apply_pair": "compute.connection.apply",
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Preview a connection identity and registered endpoint change without accepting a Secret.",
        "usage": "hiroute compute connection preview (--candidate REF --candidate-revision REV (--all-selectable | --model-ref REF...) | --request-file PATH | --request-stdin) [--apply-file PATH] [--idempotency-key KEY]",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts exactly one registered v1 projection, compute-management v2 save/edit, or subscription-check v2 preview request. The optional edit action is rename (display_name), append_models (checked candidate; preserves existing models), remove_models (saved source; selected refs are removals), or delete (saved source; no selected refs). Omitting edit retains released save semantics. Referenced models, including disabled routes and retained versions, cannot be deleted. Preview has no durable side effect and returns the exact digest and revisions required by Apply.",
        "effects": "Stateless Preview: no ID, TTL, Operation, Secret, file, database, publication, or network write.",
        "network_and_model_use": "No model use and no non-fixture network access.",
        "automation": "Convenience flags and JSON input are alternatives. --apply-file creates a new private exact Apply request, never overwrites, and performs no Apply. Review effects, then submit that file with the matching Apply command. After uncertain submission, use submission.operation_lookup with operations find or resend the identical file. Core supported variants are compute save, Plan content v2 and Agent settings v2. Routing recovery: retain a successful private routing show response before changes; use routing preview --plan ID --restore-from BEFORE_JSON --apply-file NEW_FILE, review and routing apply --request-file NEW_FILE. This restores complete effective configuration with the current head revision, exclusively from the same Plan/workspace; do not mix with edit flags or typed request inputs. Compare all desired fields after recovery; revisions advance and native facet restoration is separate. Routing: repeat economy/primary flags to preserve order; select --decision local_rules or --decision-service ID@REVISION explicitly for a new smart Plan. Native choices: Hermes requires --protocol; Codex requires --native-models preserve_available|hiroute_only and --native-default preserve_native|plan; Claude requires explicit --preset opus|sonnet|haiku; Qoder/Pi/DSH require --protocol and add entries without claiming a native default. Missing choices remain unresolved. --facet may repeat to restore selected facets; other facets stay untouched. Desktop resident-service evidence must come from Desktop, never a fabricated CLI declaration.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute connection preview --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.connection.preview"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.connection.preview.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.connection.preview.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.connection.apply",
      "path": [
        "compute",
        "connection",
        "apply"
      ],
      "operation_id": "ApplyComputeConnectionChange",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.compute-connection-apply-request/v1",
      "response_schema": "hiroute.operation-view/v1",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "preview_apply_pair": "compute.connection.preview",
      "idempotency": "required",
      "help": {
        "purpose": "Apply an exact registered compute connection change.",
        "usage": "hiroute compute connection apply (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts only the exact preview spec, digest, revisions, and a non-empty idempotency key. Same-UID Local Control reproduces the plan; replay uses the original key and changed payloads are rejected.",
        "effects": "Same-UID Application-owned journaled operation after exact spec, digest, revision, and idempotency checks.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute connection apply --request-file apply-request.json --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.connection.apply"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.connection.apply.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.connection.apply.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.connection.authorize",
      "path": [
        "compute",
        "connection",
        "authorize"
      ],
      "operation_id": "AuthorizeComputeConnection",
      "trace_ids": [
        "CLI-011",
        "APP-011"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "action",
      "request_schema": "hiroute.compute-connection-authorization-request/v1",
      "response_schema": "hiroute.compute-subscription-check-result/v2",
      "effect": "typed_action",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Start or resume typed authorization for a registered connection option.",
        "usage": "hiroute compute connection authorize (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin reads one exact subscription result operation or releases one exact validation. Starting authorization still uses connection Preview/Apply, including revision, digest, and idempotency checks.",
        "effects": "Application-owned typed operation; side effects are recorded by the Operation and external ledgers.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute connection authorize --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.connection.authorize"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.connection.authorize.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.connection.authorize.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.connection.login",
      "path": [
        "compute",
        "connection",
        "login"
      ],
      "operation_id": "ManageSubscriptionLogin",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "action",
      "request_schema": "hiroute.subscription-login-request/v1",
      "response_schema": "hiroute.subscription-login-result/v1",
      "effect": "typed_action",
      "network": "local_control_then_provider_oauth",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Manage an independent Codex or Claude subscription sign-in without enabling routing.",
        "usage": "hiroute compute connection login (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts list/start with provider codex or claude; status/cancel/forget with an exact login_ref; callback with login_ref and input_candidate. Register callback text first with protected-input register --candidate <callback_input_candidate.candidate_ref> --secret-fd <FD>. OAuth codes, tokens, callback URLs and credential paths are rejected in ordinary request JSON. Start returns a browser URL; successful login still requires subscription check, model selection and save.",
        "effects": "Manages one independent provider login session and CPA-owned credentials. Login does not enable routing; use the existing subscription check and Preview/Apply save flow after choosing models. Forget targets exactly one local login.",
        "network_and_model_use": "May open the provider authorization flow and exchange or refresh independent OAuth credentials through CPA. No model inference is performed and native-client refresh tokens are never imported.",
        "automation": "Keep the returned login_ref for status, cancel and forget. After uncertain delivery, list/status the existing session before starting again or resubmitting a one-use callback. Never persist the authorization URL or put callback material in argv, environment, logs or ordinary request JSON.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "printf '%s' '{\"action\":\"start\",\"provider\":\"claude\"}' | hiroute compute connection login --request-stdin --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.connection.login"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.connection.login.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.connection.login.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.connection.test",
      "path": [
        "compute",
        "connection",
        "test"
      ],
      "operation_id": "TestComputeConnection",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "external_probe",
      "request_schema": "hiroute.compute-connection-test-request/v1",
      "response_schema": "hiroute.model-connection-check/union",
      "effect": "bounded_probe",
      "network": "local_control_then_registered_gateway",
      "model_call": "explicit_probe_may_call_model",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Run one explicit bounded connection probe, with inference only when requested.",
        "usage": "hiroute compute connection test (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. The top-level JSON wrapper is {kind, request}. Choose registered for a catalog option such as OpenRouter, with expected_catalog copied from compute connection options; native contains request.draft for a custom API. discovered and saved retain their own strict nested requests. schema show --command-id compute.connection.test --include-schema provides complete native/registered templates and prerequisite guidance. Credentials are referenced only through a protected-input candidate; plaintext credential fields are rejected. The explicit probe may contact the configured provider and may consume quota when an inference model is selected.",
        "effects": "Runs one explicit bounded source check. It keeps protected input in daemon memory and does not persist source state until the separate Preview/Apply flow.",
        "network_and_model_use": "Contacts only the explicitly selected, typed endpoint. Inventory checks make no inference call; selecting an inference model may send one bounded model request and consume provider quota.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute connection test --request-stdin --output json < native-request.json",
          "hiroute compute connection test --request-file registered-request.json --output json",
          "hiroute schema show --command-id compute.connection.test --include-schema --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.connection.test"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.connection.test.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.connection.test.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "routing.options",
      "path": [
        "routing",
        "options"
      ],
      "operation_id": "GetPlanEditorOptions",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.plan-editor-options-request/v1",
      "response_schema": "hiroute.plan-editor-options/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read connected candidates and exact-native plan rating suggestions.",
        "usage": "hiroute routing options (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "printf '%s' '{}' | hiroute routing options --request-stdin --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id routing.options"
        ]
      },
      "positive": {
        "scenario_id": "p0.routing.options.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.routing.options.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.executors",
      "path": [
        "worker",
        "executors"
      ],
      "operation_id": "WorkerExecutorAvailability",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.worker-executor-availability-list/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read configured Codex, Claude Code, Qoder, Pi, and DeepSeek Harness launch availability without requiring a Plan or Agent allowlist.",
        "usage": "hiroute worker executors [--output <json|text|quiet>]",
        "arguments_and_options": "No Agent, Plan, allowlist, capability FD, or request body is accepted. The query checks configured entry metadata and executability, not program contents or compatibility. Ready allows a launch attempt; it does not prove optional capabilities, install, configure, authorize, or admit a run.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Ready permits a managed launch attempt, not a promise of execution or authorization. Optional capabilities remain unknown until the actual ACP handshake; start, load and cancel report real outcomes.",
        "output": "Default text renders overall and scoped states for all six supported Harnesses. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints their stable wire names.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker executors --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.executors"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.executors.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.executors.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.dependencies.discover",
      "path": [
        "worker",
        "dependencies",
        "discover"
      ],
      "operation_id": "WorkerDependenciesDiscover",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.worker-dependencies-discover-request/v1",
      "response_schema": "hiroute.worker-dependencies-view/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Discover and validate local Worker CLI, adapter, and Node candidates.",
        "usage": "hiroute worker dependencies discover [--harness <codex_cli|claude_code|qoder_cli|pi|deepseek_harness|opencode>] [--output <json|text|quiet>]",
        "arguments_and_options": "Optionally restrict discovery to one Harness. The query checks the selected path, PATH, common locations, npm globals and npx cache without installing or selecting anything.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Automation must use --output json. For the chosen Harness, select only found candidates and copy that Harness's selection_revisions revision into expected_selection_revision; discovery never installs or selects anything.",
        "output": "Default text renders selected tuples and discovered candidates but omits the CAS revisions, so automation must use --output json. --output quiet prints only selected Harness wire names (codex_cli, claude_code, qoder_cli, pi, deepseek_harness, or opencode), one per line, and is empty when nothing is selected.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker dependencies discover --harness codex_cli --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.dependencies.discover"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.dependencies.discover.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.dependencies.discover.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.dependencies.select",
      "path": [
        "worker",
        "dependencies",
        "select"
      ],
      "operation_id": "SelectWorkerDependencies",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.worker-dependencies-select-request/v1",
      "response_schema": "hiroute.worker-dependencies-view/v1",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "deterministic_request_replay",
      "help": {
        "purpose": "Select one validated Worker dependency tuple through same-UID local management.",
        "usage": "hiroute worker dependencies select (--request-stdin | --request-file <PATH>) [--output <json|text|quiet>]",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Same-UID local management only. --request-stdin reads one strict JSON object with harness (codex_cli, claude_code, qoder_cli, pi, deepseek_harness, or opencode), absolute cli_path, and expected_selection_revision copied from the matching selection_revisions entry returned by worker dependencies discover --output json. codex_cli and claude_code require absolute adapter_path and accept optional absolute node_path. pi requires absolute node_path and forbids adapter_path. qoder_cli, deepseek_harness and opencode accept only cli_path and forbid adapter_path and node_path. All paths and the revision are validated again before an atomic selection update; the command never installs software or accepts an Apply capability.",
        "effects": "Application-owned journaled operation after exact spec, digest, selection-revision CAS, and idempotency checks on owner-only Local Control.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Preserve the submitted JSON document. If delivery may have succeeded but no response was received, replay that same document unchanged; its deterministic request identity returns the existing Operation instead of applying twice. Do not substitute paths or a newer revision until the server reports a conflict and discovery is run again.",
        "output": "Default text renders selected tuples and discovered candidates but omits the CAS revisions, so automation must use --output json. --output quiet prints only selected Harness wire names (codex_cli, claude_code, qoder_cli, pi, deepseek_harness, or opencode), one per line, and is empty when nothing is selected.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "printf '%s\\n' '{\"harness\":\"codex_cli\",\"adapter_path\":\"/ABSOLUTE/PATH/TO/codex-acp\",\"cli_path\":\"/ABSOLUTE/PATH/TO/codex\",\"node_path\":\"/ABSOLUTE/PATH/TO/node\",\"expected_selection_revision\":0}' | hiroute worker dependencies select --request-stdin --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.dependencies.select"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.dependencies.select.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.dependencies.select.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.plans",
      "path": [
        "worker",
        "plans"
      ],
      "operation_id": "WorkerPlans",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.worker-plans-request/v1",
      "response_schema": "hiroute.work-plan-list/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "List every published, delegation-enabled Worker Plan in this daemon instance.",
        "usage": "hiroute worker plans [--output <json|text|quiet>]",
        "arguments_and_options": "Lists every currently published and delegation-enabled Worker Plan in this daemon instance; no main-Agent selector or allowlist participates.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable submission keys and task/run locators. A bounded wait timing out is pending, never cancellation; query status or wait again, and read result only when available.",
        "output": "Default text renders the response for people. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints only a completed result and sends pending locators to stderr.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker plans"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.plans"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.plans.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.plans.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.list",
      "path": [
        "worker",
        "list"
      ],
      "operation_id": "WorkerList",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.worker-list-request/v1",
      "response_schema": "hiroute.delegation-list/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Page durable Worker tasks in this daemon instance without filtering accepted history by current Plan policy.",
        "usage": "hiroute worker list [--title <TITLE>] [--cursor <OPAQUE>] [--limit <1..200>] [--output <json|text|quiet>]",
        "arguments_and_options": "Pages the daemon instance's durable tasks newest-first. --title is normalized exact matching; the signed opaque cursor is bound to that filter. Default 50, maximum 200, and no total count.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable submission keys and task/run locators. A bounded wait timing out is pending, never cancellation; query status or wait again, and read result only when available.",
        "output": "Default text renders the instance task/state/title-or-ID/canonical-cwd page plus its next cursor. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints task IDs. A page length is never a total count.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker list --limit 50"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.list"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.list.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.list.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.exec",
      "path": [
        "worker",
        "exec"
      ],
      "operation_id": "WorkerExec",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.worker-exec-request/v1",
      "response_schema": "hiroute.worker-command-data/v1",
      "effect": "high_impact_write",
      "network": "local_control_then_managed_worker_and_loopback_gateway",
      "model_call": "caller_selected_worker_via_managed_loopback_gateway",
      "stdin_channels": [
        "prompt_stdin",
        "file"
      ],
      "idempotency": "required",
      "help": {
        "purpose": "Submit one local Worker task with an explicit cwd and run-scoped permission policy.",
        "usage": "hiroute worker exec --plan <ID> --cwd <PATH> [--title <TITLE>] [--permission-policy <approve-all|approve-reads|deny-all>] [--run-timeout <1..86400>] [--no-wait | --wait-timeout <1..30>] [--submission-key <KEY>] (-- <TEXT> | --file <PATH> | < stdin)",
        "arguments_and_options": "Plan, cwd, and exactly one text source are required. Permission policy defaults to approve-all; approve-reads and deny-all are explicit run restrictions and fail unavailable unless the exact Harness mapping proves them. cwd is scheduling context, not directory authorization. Submits directly to the daemon without a local receipt. Choose a unique --submission-key before sending; after uncertain delivery, query or retry with that original key and the identical request.",
        "effects": "Durably admits one bounded Worker run after current Plan eligibility, exact Plan, canonical cwd, idempotency, and resource checks.",
        "network_and_model_use": "The selected Worker may send model traffic only through its run-bound numeric-loopback Gateway route; native tools follow the run-scoped permission policy.",
        "automation": "The command durably admits a bounded Worker run; that Worker may make model requests only through its exact run-bound loopback Gateway route.",
        "output": "Default text renders the response for people. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints only a completed result and sends pending locators to stderr.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker exec --plan worker --cwd /workspace -- 'inspect the repository'"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.exec"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.exec.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.exec.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.status",
      "path": [
        "worker",
        "status"
      ],
      "operation_id": "WorkerStatus",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.worker-status-request/v1",
      "response_schema": "hiroute.worker-command-data/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read one Worker task/run or locate an exact exec/continue submission key.",
        "usage": "hiroute worker status (--run <ID> | --task <ID> [--run <ID>] | --submission <KEY> --operation <start|continue>)",
        "arguments_and_options": "Select exactly a run, a task (and optional historical run), or an original submission key plus start|continue. The daemon instance is the task namespace; no caller, Agent, grant, permit, or workspace-root identity is accepted.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable submission keys and task/run locators. A bounded wait timing out is pending, never cancellation; query status or wait again, and read result only when available.",
        "output": "Default text renders the response for people. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints only a completed result and sends pending locators to stderr.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker status --run run/one"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.status"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.status.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.status.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.wait",
      "path": [
        "worker",
        "wait"
      ],
      "operation_id": "WorkerWait",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "watch",
      "request_schema": "hiroute.worker-wait-request/v1",
      "response_schema": "hiroute.worker-command-data/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Wait up to thirty seconds for a Worker run revision without cancelling it.",
        "usage": "hiroute worker wait --run <ID> [--after-revision <N>] [--wait-timeout <1..30>]",
        "arguments_and_options": "Wait is bounded to 1..30 seconds and never cancels the run. A timeout is a pending observation with a reusable run locator.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable submission keys and task/run locators. A bounded wait timing out is pending, never cancellation; query status or wait again, and read result only when available.",
        "output": "Default text renders the response for people. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints only a completed result and sends pending locators to stderr.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker wait --run run/one"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.wait"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.wait.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.wait.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.result",
      "path": [
        "worker",
        "result"
      ],
      "operation_id": "WorkerResult",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.worker-result-request/v1",
      "response_schema": "hiroute.worker-command-data/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read the persisted result and honest completion state for one Worker run.",
        "usage": "hiroute worker result --run <ID> [--offset <N>] [--max-bytes <N>]",
        "arguments_and_options": "Reads the actual persisted result, optionally by UTF-8 byte page. Query success can honestly report a failed, cancelled, active, incomplete, or unavailable run.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable submission keys and task/run locators. A bounded wait timing out is pending, never cancellation; query status or wait again, and read result only when available.",
        "output": "Default text renders the response for people. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints only a completed result and sends pending locators to stderr.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker result --run run/one"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.result"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.result.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.result.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.read",
      "path": [
        "worker",
        "read"
      ],
      "operation_id": "WorkerRead",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.worker-read-request/v1",
      "response_schema": "hiroute.worker-read-data/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read one bounded best-effort public progress window for a Worker run.",
        "usage": "hiroute worker read --run <ID> [--cursor <OPAQUE>] [--max-bytes <1..32768>]",
        "arguments_and_options": "Reads a bounded best-effort public assistant-message progress window. It is not a complete log or completion proof; cursors are opaque, signed and run-bound.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable submission keys and task/run locators. A bounded wait timing out is pending, never cancellation; query status or wait again, and read result only when available.",
        "output": "Default text renders the response for people. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints only a completed result and sends pending locators to stderr.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker read --run run/one"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.read"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.read.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.read.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.continue",
      "path": [
        "worker",
        "continue"
      ],
      "operation_id": "WorkerContinue",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.worker-continue-request/v1",
      "response_schema": "hiroute.worker-command-data/v1",
      "effect": "high_impact_write",
      "network": "local_control_then_managed_worker_and_loopback_gateway",
      "model_call": "caller_selected_worker_via_managed_loopback_gateway",
      "stdin_channels": [
        "prompt_stdin",
        "file"
      ],
      "idempotency": "required",
      "help": {
        "purpose": "Continue one exact task/session with a run-scoped permission policy.",
        "usage": "hiroute worker continue --task <ID> --expected-latest-run <ID> [--cwd <PATH>] [--permission-policy <approve-all|approve-reads|deny-all>] [--run-timeout <1..86400>] [--no-wait | --wait-timeout <1..30>] [--submission-key <KEY>] (-- <TEXT> | --file <PATH> | < stdin)",
        "arguments_and_options": "Task and expected latest run are mandatory. cwd is optional but, when present, must canonicalize to the persisted task root. Permission policy defaults to approve-all and configures only this run; Continue never falls back to a new task, newest Plan, or session/new.",
        "effects": "Durably admits one bounded Worker run after current Plan eligibility, exact Plan, canonical cwd, idempotency, and resource checks.",
        "network_and_model_use": "The selected Worker may send model traffic only through its run-bound numeric-loopback Gateway route; native tools follow the run-scoped permission policy.",
        "automation": "The command durably admits a bounded Worker run; that Worker may make model requests only through its exact run-bound loopback Gateway route.",
        "output": "Default text renders the response for people. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints only a completed result and sends pending locators to stderr.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker continue --task task/one --expected-latest-run run/one -- 'continue the task'"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.continue"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.continue.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.continue.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.cancel",
      "path": [
        "worker",
        "cancel"
      ],
      "operation_id": "WorkerCancel",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "action",
      "request_schema": "hiroute.worker-cancel-request/v1",
      "response_schema": "hiroute.worker-command-data/v1",
      "effect": "typed_action",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "required",
      "help": {
        "purpose": "Persist cancellation for one exact Worker run and wake only its owned scope.",
        "usage": "hiroute worker cancel --run <ID> [--reason <REFERENCE>] [--idempotency-key <KEY>]",
        "arguments_and_options": "Cancellation is idempotent for one exact run. Omitting the idempotency key creates one; only the owned Worker scope is stopped.",
        "effects": "Application-owned typed operation; side effects are recorded by the Operation and external ledgers.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable submission keys and task/run locators. A bounded wait timing out is pending, never cancellation; query status or wait again, and read result only when available.",
        "output": "Default text renders the response for people. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints only a completed result and sends pending locators to stderr.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker cancel --run run/one"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.cancel"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.cancel.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.cancel.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "worker.cleanup.confirm",
      "path": [
        "worker",
        "cleanup",
        "confirm"
      ],
      "operation_id": "WorkerConfirmResidual",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "action",
      "request_schema": "hiroute.worker-residual-confirm-request/v1",
      "response_schema": "hiroute.worker-command-data/v1",
      "effect": "typed_action",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "required",
      "help": {
        "purpose": "Confirm user-handled residual resources for one exact terminal run without changing its result.",
        "usage": "hiroute worker cleanup confirm --run <ID> --expected-revision <REVISION> --handled [--idempotency-key <KEY>]",
        "arguments_and_options": "Use only after the user handles remaining processes/resources. Requires the observed revision and explicit --handled; known-live or stale runs are rejected. Exact retries reuse the idempotency key. Only the local occupied slot is released; task result and file changes remain.",
        "effects": "Application-owned typed operation; side effects are recorded by the Operation and external ledgers.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable submission keys and task/run locators. A bounded wait timing out is pending, never cancellation; query status or wait again, and read result only when available.",
        "output": "Default text renders the response for people. --output json emits the unchanged hiroute.machine-envelope/v2 object; --output quiet prints only a completed result and sends pending locators to stderr.",
        "exit_status": "0 accepted/query/pending; final exec/continue failure is nonzero; 2 usage; 3 conflict/busy; 4 denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention; 1 execution failure. A result query may exit 0 while honestly reporting a failed run.",
        "examples": [
          "hiroute worker cleanup confirm --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id worker.cleanup.confirm"
        ]
      },
      "positive": {
        "scenario_id": "p0.worker.cleanup.confirm.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.worker.cleanup.confirm.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "routing.list",
      "path": [
        "routing",
        "list"
      ],
      "operation_id": "ListAgentPlanCatalog",
      "trace_ids": [
        "CLI-053",
        "APP-053"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.agent-plan-catalog-query/v2",
      "response_schema": "hiroute.agent-plan-catalog/v2",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "List AgentPlans, optionally filtered by an AgentConnection grant.",
        "usage": "hiroute routing list [(--request-stdin | --request-file <PATH>)] --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute routing list --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id routing.list"
        ]
      },
      "positive": {
        "scenario_id": "p0.routing.list.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.routing.list.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "routing.show",
      "path": [
        "routing",
        "show"
      ],
      "operation_id": "GetAgentPlanStatus",
      "trace_ids": [
        "CLI-006",
        "APP-006"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.agent-plan-lookup/v1",
      "response_schema": "hiroute.agent-plan-status/v2",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Show one immutable AgentPlan revision and materialized routing contract.",
        "usage": "hiroute routing show <PLAN_ID> --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute routing show plan/example --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id routing.show"
        ]
      },
      "positive": {
        "scenario_id": "p0.routing.show.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.routing.show.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "routing.preview",
      "path": [
        "routing",
        "preview"
      ],
      "operation_id": "PreviewAgentPlanChange",
      "trace_ids": [
        "CLI-004",
        "APP-004"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "preview",
      "request_schema": "hiroute.agent-plan-preview-request/union",
      "response_schema": "hiroute.agent-plan-preview/union",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "preview_apply_pair": "routing.apply",
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Preview a complete materialized AgentPlan change.",
        "usage": "hiroute routing preview (--name NAME --purpose PURPOSE --mode fixed_model --model BINDING | --name NAME --purpose PURPOSE --mode smart_saving --economy BINDING --primary BINDING --decision local_rules | --plan ID <changes> | --request-file PATH | --request-stdin) [--apply-file PATH] [--idempotency-key KEY]",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts only the existing strict draft, content, or lifecycle schema. Apply must reproduce Preview and carry its exact revisions, digest, and idempotency key; publication remains one recoverable Operation.",
        "effects": "Stateless Preview: no ID, TTL, Operation, Secret, file, database, publication, or network write.",
        "network_and_model_use": "No model use and no non-fixture network access.",
        "automation": "Convenience flags and JSON input are alternatives. --apply-file creates a new private exact Apply request, never overwrites, and performs no Apply. Review effects, then submit that file with the matching Apply command. After uncertain submission, use submission.operation_lookup with operations find or resend the identical file. Core supported variants are compute save, Plan content v2 and Agent settings v2. Routing recovery: retain a successful private routing show response before changes; use routing preview --plan ID --restore-from BEFORE_JSON --apply-file NEW_FILE, review and routing apply --request-file NEW_FILE. This restores complete effective configuration with the current head revision, exclusively from the same Plan/workspace; do not mix with edit flags or typed request inputs. Compare all desired fields after recovery; revisions advance and native facet restoration is separate. Routing: repeat economy/primary flags to preserve order; select --decision local_rules or --decision-service ID@REVISION explicitly for a new smart Plan. Native choices: Hermes requires --protocol; Codex requires --native-models preserve_available|hiroute_only and --native-default preserve_native|plan; Claude requires explicit --preset opus|sonnet|haiku; Qoder/Pi/DSH require --protocol and add entries without claiming a native default. Missing choices remain unresolved. --facet may repeat to restore selected facets; other facets stay untouched. Desktop resident-service evidence must come from Desktop, never a fabricated CLI declaration.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute routing preview --request-file preview-request.json --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id routing.preview"
        ]
      },
      "positive": {
        "scenario_id": "p0.routing.preview.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.routing.preview.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "routing.apply",
      "path": [
        "routing",
        "apply"
      ],
      "operation_id": "ApplyAgentPlanChange",
      "trace_ids": [
        "CLI-005",
        "APP-005"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.agent-plan-apply-request/union",
      "response_schema": "hiroute.operation-view/v1",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "preview_apply_pair": "routing.preview",
      "idempotency": "required",
      "help": {
        "purpose": "Apply an exact AgentPlan change and closed publication revision.",
        "usage": "hiroute routing apply (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts only the existing strict draft, content, or lifecycle schema. Apply must reproduce Preview and carry its exact revisions, digest, and idempotency key; publication remains one recoverable Operation.",
        "effects": "Same-UID Application-owned journaled operation after exact spec, digest, revision, and idempotency checks.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute routing apply --request-file apply-request.json --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id routing.apply"
        ]
      },
      "positive": {
        "scenario_id": "p0.routing.apply.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.routing.apply.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "decision.services.list",
      "path": [
        "decision",
        "services",
        "list"
      ],
      "operation_id": "ListDecisionServices",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.decision-services/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "List saved decision services and their latest immutable connection versions.",
        "usage": "hiroute decision services list --output json",
        "arguments_and_options": "No request body or secret material. Returns the latest saved version of each service; published plans retain their exact immutable version.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute decision services list --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id decision.services.list"
        ]
      },
      "positive": {
        "scenario_id": "p0.decision.services.list.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.decision.services.list.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "decision.services.apply",
      "path": [
        "decision",
        "services",
        "apply"
      ],
      "operation_id": "ApplyDecisionService",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.change-preview-or-apply-request/v1",
      "response_schema": "hiroute.change-preview-or-operation/v1",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "required",
      "help": {
        "purpose": "Save a decision service version or delete an unreferenced service with revision checking.",
        "usage": "hiroute decision services apply (--id ID [--name NAME] [--provider bailian-token-plan|bailian-workspace|openrouter|typesafe|compatible|custom] [--endpoint URL] [--model MODEL] [--timeout-ms MS] [--candidate REF [--header NAME] | --no-auth] | --request-file PATH | --request-stdin) [--apply-file PATH] [--idempotency-key KEY]",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. --request-stdin accepts a ChangeSpec preview request first, then the exact ApplyRequest with accept_digest, expected_revisions and idempotency_key. spec.desired_state contains id, expected_revision, service (null to delete), and optional protected input_slot. Replacing a credential requires a new reference. A referenced service cannot be deleted.",
        "effects": "Same-UID Application-owned journaled operation after exact spec, digest, revision, and idempotency checks.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Read decision services options first; reuse an exact saved connection when suitable. Convenience flags prepare a Preview only. A new connection requires --id, --name, --provider and its required endpoint/model plus --candidate, or explicit --no-auth for custom only. --candidate refers to an existing protected registration; never pass a credential in flags/JSON/chat. The user can run protected-input register --candidate REF --prompt --format bearer|raw in their own terminal. System One uses Authorization and bearer; custom supports --header NAME or --no-auth. Updates by --id preserve omitted fields; changing endpoint/provider/header requires explicit new credentials or custom --no-auth. --timeout-ms defaults to 10000 for a new connection. --apply-file creates a new private exact Apply request, never overwrites or applies; submit it with the same decision services apply verb. Keep its Operation lookup and identical request for uncertain delivery. Typed Preview/Apply remain alternatives; --apply-file accepts Preview input only. No save proves connectivity, native loading or decision quality.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute decision services apply --request-file preview-request.json --output json  # Preview: schema_version and spec",
          "hiroute decision services apply --request-file apply-request.json --output json  # Apply: add exact accept_digest, expected_revisions and a stable idempotency_key",
          "hiroute schema show --command-id decision.services.apply --include-schema  # Complete wrappers; substitute current IDs and exact Preview values"
        ],
        "see_also": [
          "hiroute schema show --command-id decision.services.apply"
        ]
      },
      "positive": {
        "scenario_id": "p0.decision.services.apply.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.decision.services.apply.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "decision.services.test",
      "path": [
        "decision",
        "services",
        "test"
      ],
      "operation_id": "TestClassifierDecision",
      "trace_ids": [],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "external_probe",
      "request_schema": "hiroute.classifier-decision-test/v1",
      "response_schema": "hiroute.classifier-decision-test-result/v1",
      "effect": "bounded_probe",
      "network": "local_control_then_registered_gateway",
      "model_call": "explicit_probe_may_call_model",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Run one explicit synthetic decision through a configured decision service.",
        "usage": "hiroute decision services test (--service ID@REVISION | --request-file PATH | --request-stdin)",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Connectivity retains hiroute.classifier-decision-test/v1 with classifier and the original outcome result. A separate hiroute.historical-applicability-test/v1 request carries service_id, service_revision, actual frozen protocol and standard|max_branches shape, and returns capability state plus exact evidence identity. Each explicit test sends one synthetic request and may consume quota. Save/publication never test and no real session history is read; connectivity does not establish applicability support.",
        "effects": "Sends one fixed synthetic routing decision to the explicitly configured service; may consume provider quota. It reads no real session history and does not publish or edit a route.",
        "network_and_model_use": "Sends one fixed synthetic routing decision to the explicitly configured service; may consume provider quota. It reads no real session history and does not publish or edit a route.",
        "automation": "An explicit potentially billed probe. --service ID@REVISION resolves an exact current listed connection; historical pinned versions remain available through the typed request. Inspect data.outcome and failure_code even when the command itself succeeded. Passing establishes this synthetic connection test, not semantic decision quality, execution model availability or native loading. Never silently switch a selected service to local_rules after failure.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute decision services test --request-stdin --output json < request.json"
        ],
        "see_also": [
          "hiroute schema show --command-id decision.services.test"
        ]
      },
      "positive": {
        "scenario_id": "p0.decision.services.test.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.decision.services.test.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "models.feed.status",
      "path": [
        "models",
        "feed",
        "status"
      ],
      "operation_id": "GetModelFeedStatus",
      "trace_ids": [
        "CLI-059",
        "APP-059"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.model-feed-status/v2",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Show the verified model feed, retrieval setting and last attempt.",
        "usage": "hiroute models feed status [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute models feed status --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id models.feed.status"
        ]
      },
      "positive": {
        "scenario_id": "p0.models.feed.status.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.models.feed.status.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "models.feed.refresh",
      "path": [
        "models",
        "feed",
        "refresh"
      ],
      "operation_id": "RefreshModelFeed",
      "trace_ids": [
        "CLI-060",
        "APP-060"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.model-feed-status/v2",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Retrieve and verify the model feed now.",
        "usage": "hiroute models feed refresh [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Application-owned journaled operation after exact spec, digest, revision, capability, and idempotency checks.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute models feed refresh --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id models.feed.refresh"
        ]
      },
      "positive": {
        "scenario_id": "p0.models.feed.refresh.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.models.feed.refresh.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "models.feed.settings.apply",
      "path": [
        "models",
        "feed",
        "settings",
        "apply"
      ],
      "operation_id": "ApplyModelFeedSettings",
      "trace_ids": [
        "CLI-061",
        "APP-061"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.model-feed-settings/v1",
      "response_schema": "hiroute.model-feed-status/v2",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Change service-owned model feed retrieval and disclosure settings.",
        "usage": "hiroute models feed settings apply [typed options] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Application-owned journaled operation after exact spec, digest, revision, capability, and idempotency checks.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute models feed settings apply --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id models.feed.settings.apply"
        ]
      },
      "positive": {
        "scenario_id": "p0.models.feed.settings.apply.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.models.feed.settings.apply.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "models.feed.remove.preview",
      "path": [
        "models",
        "feed",
        "remove",
        "preview"
      ],
      "operation_id": "PreviewModelFeedRemoval",
      "trace_ids": [
        "CLI-062",
        "APP-062"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.model-feed-removal-preview/v2",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Preview saved sources affected by removing the held model feed.",
        "usage": "hiroute models feed remove preview [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute models feed remove preview --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id models.feed.remove.preview"
        ]
      },
      "positive": {
        "scenario_id": "p0.models.feed.remove.preview.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.models.feed.remove.preview.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "models.feed.remove.apply",
      "path": [
        "models",
        "feed",
        "remove",
        "apply"
      ],
      "operation_id": "ApplyModelFeedRemoval",
      "trace_ids": [
        "CLI-063",
        "APP-063"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.model-feed-remove/v1",
      "response_schema": "hiroute.model-feed-status/v2",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Remove the held feed while retaining its highest accepted sequence.",
        "usage": "hiroute models feed remove apply [typed options] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Application-owned journaled operation after exact spec, digest, revision, capability, and idempotency checks.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute models feed remove apply --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id models.feed.remove.apply"
        ]
      },
      "positive": {
        "scenario_id": "p0.models.feed.remove.apply.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.models.feed.remove.apply.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "models.availability",
      "path": [
        "models",
        "availability"
      ],
      "operation_id": "GetModelAvailability",
      "trace_ids": [
        "CLI-064",
        "APP-064"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.model-availability/v2",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Show model origins, announcements and current local availability.",
        "usage": "hiroute models availability [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute models availability --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id models.availability"
        ]
      },
      "positive": {
        "scenario_id": "p0.models.availability.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.models.availability.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.defaults.get",
      "path": [
        "compute",
        "defaults",
        "get"
      ],
      "operation_id": "GetComputeDefaults",
      "trace_ids": [
        "CLI-073",
        "APP-073"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read saved intent, effective capabilities and the exact official default locator.",
        "usage": "hiroute compute defaults get [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute defaults get --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.defaults.get"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.defaults.get.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.defaults.get.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "compute.defaults.preview",
      "path": [
        "compute",
        "defaults",
        "preview"
      ],
      "operation_id": "PreviewComputeSaveV3",
      "trace_ids": [
        "CLI-072",
        "APP-072"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "preview",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Preview a source save with explicit official-default or preserved-value intent.",
        "usage": "hiroute compute defaults preview [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Stateless Preview: no ID, TTL, Operation, Secret, file, database, publication, or network write.",
        "network_and_model_use": "No model use and no non-fixture network access.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute compute defaults preview --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id compute.defaults.preview"
        ]
      },
      "positive": {
        "scenario_id": "p0.compute.defaults.preview.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.compute.defaults.preview.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "models.metadata.list",
      "path": [
        "models",
        "metadata",
        "list"
      ],
      "operation_id": "ListModelMetadata",
      "trace_ids": [
        "CLI-070",
        "APP-070"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read a bounded page of complete official model metadata, including descriptive-only records.",
        "usage": "hiroute models metadata list [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute models metadata list --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id models.metadata.list"
        ]
      },
      "positive": {
        "scenario_id": "p0.models.metadata.list.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.models.metadata.list.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "models.metadata.get",
      "path": [
        "models",
        "metadata",
        "get"
      ],
      "operation_id": "GetModelMetadata",
      "trace_ids": [
        "CLI-071",
        "APP-071"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read an exact scoped metadata record from the selected snapshot.",
        "usage": "hiroute models metadata get [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute models metadata get --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id models.metadata.get"
        ]
      },
      "positive": {
        "scenario_id": "p0.models.metadata.get.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.models.metadata.get.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "models.show",
      "path": [
        "models",
        "show"
      ],
      "operation_id": "ShowModel",
      "trace_ids": [
        "CLI-026",
        "APP-026"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.model-catalog-query/v1",
      "response_schema": "hiroute.model-catalog-view/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Show exact model, capability, reasoning, rating, and source facts.",
        "usage": "hiroute models show (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute models show --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id models.show"
        ]
      },
      "positive": {
        "scenario_id": "p0.models.show.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.models.show.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "prices.effective",
      "path": [
        "prices",
        "effective"
      ],
      "operation_id": "GetEffectivePrices",
      "trace_ids": [
        "CLI-040",
        "APP-040"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read effective current-catalog price facts and local override revisions.",
        "usage": "hiroute prices effective (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute prices effective --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id prices.effective"
        ]
      },
      "positive": {
        "scenario_id": "p0.prices.effective.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.prices.effective.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "prices.override.preview",
      "path": [
        "prices",
        "override",
        "preview"
      ],
      "operation_id": "PreviewPriceOverrideChange",
      "trace_ids": [
        "CLI-041",
        "APP-041"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "preview",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Preview a typed local price override change.",
        "usage": "hiroute prices override preview (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Stateless Preview: no ID, TTL, Operation, Secret, file, database, publication, or network write.",
        "network_and_model_use": "No model use and no non-fixture network access.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute prices override preview --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id prices.override.preview"
        ]
      },
      "positive": {
        "scenario_id": "p0.prices.override.preview.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.prices.override.preview.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "prices.override.apply",
      "path": [
        "prices",
        "override",
        "apply"
      ],
      "operation_id": "ApplyPriceOverrideChange",
      "trace_ids": [
        "CLI-042",
        "APP-042"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "apply",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "high_impact_write",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Apply an exact local price override revision.",
        "usage": "hiroute prices override apply (--request-stdin | --request-file <PATH>) --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Application-owned journaled operation after exact spec, digest, revision, capability, and idempotency checks.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute prices override apply --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id prices.override.apply"
        ]
      },
      "positive": {
        "scenario_id": "p0.prices.override.apply.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.prices.override.apply.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "operations.get",
      "path": [
        "operations",
        "get"
      ],
      "operation_id": "GetOperation",
      "trace_ids": [
        "CLI-012",
        "APP-012"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.operation-lookup/v1",
      "response_schema": "hiroute.operation-view/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read one durable Operation and its terminal or recovery state.",
        "usage": "hiroute operations get <OPERATION_ID> [OPTIONS]",
        "arguments_and_options": "An exact typed resource ID is required; arbitrary storage keys and SQL are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute operations get --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id operations.get"
        ]
      },
      "positive": {
        "scenario_id": "p0.operations.get.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.operations.get.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "sessions.list",
      "path": [
        "sessions",
        "list"
      ],
      "operation_id": "ListSessions",
      "trace_ids": [
        "CLI-007",
        "APP-007"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.session-list-query/v1",
      "response_schema": "hiroute.session-list/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file",
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Search Session and Turn facts without returning content by default.",
        "usage": "hiroute sessions list ([OPTIONS] | (--request-stdin | --request-file <PATH>)) [--capability-fd <FD>] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Human options retain the v1 query. Fact-only listing is available to the same-UID Local Control peer; --query searches retained text and therefore still requires a separately delivered protected capability. --request-stdin accepts only a strict v2 sessions intent.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Same-OS-user Local Control reads retained message/tool content and searches without a separate GUI ticket. Supplied capability FDs remain validated; Gateway keys grant no management authority.\n\nAnalysis journey (opt in; legacy views/cursors keep their meanings):\n  hiroute sessions list --view conversations --period 7d --limit 50\n  hiroute sessions list --view switches --day 2026-10-16\n  hiroute sessions show SESSION --view routing --analysis-scope TOKEN\n  hiroute sessions show SESSION --view conversation --request REQUEST --analysis-scope TOKEN\n\nUse --period today|yesterday|7d|30d, --day YYYY-MM-DD, or --from-ms N --to-ms N; choose one mode. Civil days follow this service host's local day (actual offsets are returned); absolute bounds are UTC milliseconds, half-open. Default is 7d. Analysis scopes return requested/effective bounds, expiry and relation/numeric/price watermarks. Retention may clip their start so used evidence stays retained for the token lifetime. No stable interval and missing native evidence are explicit gaps, not empty-success claims.\n\nRetain analysis_scope for ranking/switch/content drill-down; follow next_cursor with the same view/filters/limit and no new time selection. Follow-ups can narrow --session/--request, never widen the original Plan/Agent/query scope. New requests or unrelated lineage do not change a pinned range. Expired scope/cursor, withdrawal/full deletion or changed authority require a fresh initial query; do not silently compare totals across refreshed scopes. A page can be shorter than limit; its length is not the total.\n\n--query searches retained content in the conversations list. Set it when creating a search scope; an existing scope rejects a new or different keyword. Start a separate search scope and retain the original comparison scope. Repeating its original keyword is allowed. Pending/unavailable index is marked partial. --model-switch is invalid for new views; its legacy any|only|exclude behavior is unchanged. Recorded selection/competence stages explain routing; stage boundaries and credential relay are not user-turn model changes. Compare actual accepted endpoints and explicit reasoning settings. continuation_boundary marks a verified native compression boundary, including mid-turn compression; turn_context_reset/unknown/pending never establish adjacent user turns. Missing proof leaves physical sessions separate. Member previews include exact counts and partial markers. Request content is bounded; reference_only/partial entries supply content_id/request_id for typed V2 content pagination, never expose provider private state. Use sessions receipt RECEIPT for immutable routing facts and observation plan-quality samples for stage details. Missing/deleted/expired capture does not prove wrong routing.\n\nLegacy sessions list --include-unlinked --query TEXT and sessions show SESSION --content messages-and-tools remain available. Typed V2 accepts sessions/search/session_search, timeline/catalog/ancestry/content, and family-specific analysis requests. Read schema show --command-id sessions.show --include-schema for complete contracts. Observation errors opt in to timeout, reader_busy, index_unavailable or storage_unavailable diagnostics; retry the same scope where still valid. No read performs a classifier call or changes routing.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute sessions list --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id sessions.list"
        ]
      },
      "positive": {
        "scenario_id": "p0.sessions.list.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.sessions.list.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "sessions.show",
      "path": [
        "sessions",
        "show"
      ],
      "operation_id": "GetSession",
      "trace_ids": [
        "CLI-008",
        "APP-008"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.session-lookup/v1",
      "response_schema": "hiroute.session-detail/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file",
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Show one Session timeline with content only under an explicit authorized mode.",
        "usage": "hiroute sessions show (<SESSION_ID> [--content <none|messages|messages-and-tools>] | (--request-stdin | --request-file <PATH>)) [--capability-fd <FD>] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Human options retain the v1 lookup and content defaults to none. Same-UID facts/timeline reads need no extra token; messages, tool content, catalog, ancestry, content pages, and search still require an exact protected capability.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Same-OS-user Local Control reads retained message/tool content and searches without a separate GUI ticket. Supplied capability FDs remain validated; Gateway keys grant no management authority.\n\nAnalysis journey (opt in; legacy views/cursors keep their meanings):\n  hiroute sessions list --view conversations --period 7d --limit 50\n  hiroute sessions list --view switches --day 2026-10-16\n  hiroute sessions show SESSION --view routing --analysis-scope TOKEN\n  hiroute sessions show SESSION --view conversation --request REQUEST --analysis-scope TOKEN\n\nUse --period today|yesterday|7d|30d, --day YYYY-MM-DD, or --from-ms N --to-ms N; choose one mode. Civil days follow this service host's local day (actual offsets are returned); absolute bounds are UTC milliseconds, half-open. Default is 7d. Analysis scopes return requested/effective bounds, expiry and relation/numeric/price watermarks. Retention may clip their start so used evidence stays retained for the token lifetime. No stable interval and missing native evidence are explicit gaps, not empty-success claims.\n\nRetain analysis_scope for ranking/switch/content drill-down; follow next_cursor with the same view/filters/limit and no new time selection. Follow-ups can narrow --session/--request, never widen the original Plan/Agent/query scope. New requests or unrelated lineage do not change a pinned range. Expired scope/cursor, withdrawal/full deletion or changed authority require a fresh initial query; do not silently compare totals across refreshed scopes. A page can be shorter than limit; its length is not the total.\n\n--query searches retained content in the conversations list. Set it when creating a search scope; an existing scope rejects a new or different keyword. Start a separate search scope and retain the original comparison scope. Repeating its original keyword is allowed. Pending/unavailable index is marked partial. --model-switch is invalid for new views; its legacy any|only|exclude behavior is unchanged. Recorded selection/competence stages explain routing; stage boundaries and credential relay are not user-turn model changes. Compare actual accepted endpoints and explicit reasoning settings. continuation_boundary marks a verified native compression boundary, including mid-turn compression; turn_context_reset/unknown/pending never establish adjacent user turns. Missing proof leaves physical sessions separate. Member previews include exact counts and partial markers. Request content is bounded; reference_only/partial entries supply content_id/request_id for typed V2 content pagination, never expose provider private state. Use sessions receipt RECEIPT for immutable routing facts and observation plan-quality samples for stage details. Missing/deleted/expired capture does not prove wrong routing.\n\nLegacy sessions list --include-unlinked --query TEXT and sessions show SESSION --content messages-and-tools remain available. Typed V2 accepts sessions/search/session_search, timeline/catalog/ancestry/content, and family-specific analysis requests. Read schema show --command-id sessions.show --include-schema for complete contracts. Observation errors opt in to timeout, reader_busy, index_unavailable or storage_unavailable diagnostics; retry the same scope where still valid. No read performs a classifier call or changes routing.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute sessions show session/example --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id sessions.show"
        ]
      },
      "positive": {
        "scenario_id": "p0.sessions.show.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.sessions.show.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "sessions.receipt",
      "path": [
        "sessions",
        "receipt"
      ],
      "operation_id": "GetRoutingReceipt",
      "trace_ids": [
        "CLI-021",
        "APP-021"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.session-receipt-request/union",
      "response_schema": "hiroute.session-receipt/union",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file",
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read an immutable structured RoutingReceipt without content or recomputation.",
        "usage": "hiroute sessions receipt (<RECEIPT_ID> | (--request-stdin | --request-file <PATH>)) [--capability-fd <FD>] --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. A positional RECEIPT_ID retains the released v1 RoutingReceipt lookup. JSON input accepts hiroute.observation.query/v2 with view facts, the exact logical request_id from the session timeline, limit and optional cursor. include_routing_observations:true adds bounded routing evidence; omission preserves released strict fields and cursor binding. Facts use same-UID Local Control; an explicitly supplied protected grant is still validated.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute sessions receipt receipt/example --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id sessions.receipt"
        ]
      },
      "positive": {
        "scenario_id": "p0.sessions.receipt.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.sessions.receipt.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "sessions.status",
      "path": [
        "sessions",
        "status"
      ],
      "operation_id": "GetObservationStatus",
      "trace_ids": [
        "CLI-022",
        "APP-022"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.session-store-status/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read fact and content completeness independently.",
        "usage": "hiroute sessions status [OPTIONS] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute sessions status --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id sessions.status"
        ]
      },
      "positive": {
        "scenario_id": "p0.sessions.status.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.sessions.status.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "value.show",
      "path": [
        "value",
        "show"
      ],
      "operation_id": "GetValue",
      "trace_ids": [
        "CLI-039",
        "APP-039"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.observation.query/v2",
      "response_schema": "hiroute.observation.value-report/v2",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file",
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read recorded token, cache and valuation totals with coverage.",
        "usage": "hiroute value show ([OPTIONS] | (--request-stdin | --request-file <PATH>)) [--capability-fd <FD>] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Human options use the current v2 value_report intent; defaults are the last seven days and separate totals for every currency. --group-by day returns UTC day buckets from the same snapshot. --request-stdin accepts strict v2 value, home_value or value_report intents. Same-UID reads retain known/unknown usage, amounts and coverage; missing values are never filled with zero.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Ordinary value show keeps frozen historical valuation. New analysis paths:\n  hiroute value show --view summary --period 7d\n  hiroute value show --group-by session --order-by cost-desc --period 7d\n  hiroute value show --group-by request --order-by cost-desc --analysis-scope TOKEN --session SESSION\n\nSummary defaults to current-price API-equivalent estimates and an unambiguous selected Plan's primary binding. Ambiguous reference/currency or missing prices returns choices; resolve actual binding IDs from routing options, never invent rates or exchange rates. Ranking needs no reference. Choose --basis recorded|api-equivalent; --currency USD|CNY and --valuation-kind usage-estimate|api-equivalent select one recorded currency/kind. Do not add different kinds or mix recorded estimates with current-price recalculation. Same time selectors, retention-safe bounds, analysis_scope, next_cursor and expiry rules as sessions --view apply; drill-downs inherit the pinned relation/numeric/price generations. Live traffic/new settlement/current price edits do not silently change them.\n\nThe complete selected scope is aggregated before cost-desc pagination. Failed/retried attempts are counted once and rounded once per attempt, using exact source/model identity matching. Missing amounts are unknown, never zero/free. An incomplete ranking is highest-known-only. Savings shows signed paired subtotals, compared/missing/excluded coverage and decision overhead as unmeasured; a zero reference denominator has no percentage. Subscription/Coding Plan API-equivalent savings proves neither cash savings nor equal output/quality. Recorded receipts remain unchanged.\n\nFor missing rates read prices effective, use its exact Binding locator/edit_context with prices override preview/apply, and valuation_kind=api_equivalent. Keep complete recovery material and exact retry requests. Scope/P capture capacity or reader contention is retryable within the same 500 ms budget; pending reconciliation reports target/progress and stalled state, never an empty total. Expired/deleted/withdrawn evidence requires an explicitly refreshed initial scope. Use sessions --help for related content/routing drill-downs.\n\nLegacy one-shot --basis api-equivalent --reference-binding BINDING --currency CNY with --routing PLAN or --session SESSION and an interval/period retains its original shape/time meaning and paired-coverage rules; it has no day grouping. New --view summary does not accept --group-by/--order-by. Read schema show --command-id value.show --include-schema for typed alternatives.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute value show --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id value.show"
        ]
      },
      "positive": {
        "scenario_id": "p0.value.show.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.value.show.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "sessions.timeline",
      "path": [
        "sessions",
        "timeline"
      ],
      "operation_id": "GetRoutingTimeline",
      "trace_ids": [
        "CLI-069",
        "APP-069"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.observation.query/v2",
      "response_schema": "hiroute.routing-timeline/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file",
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read agent turns with selection, historical protection, score, requests and costs; --follow streams changed turns.",
        "usage": "hiroute sessions timeline <SESSION_ID> [--follow] [--after-watermark <WATERMARK>] [--limit <1..200>] --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Required SESSION_ID; optional --after-watermark and --limit 1..200 (default 50). --follow streams one NDJSON change event per new or updated agent turn every two seconds, until interrupted. A watermark is opaque and scoped to this session and page size. No configuration is changed.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute sessions timeline --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id sessions.timeline"
        ]
      },
      "positive": {
        "scenario_id": "p0.sessions.timeline.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.sessions.timeline.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "observation.plan-trust",
      "path": [
        "observation",
        "plan-trust"
      ],
      "operation_id": "GetPlanTrust",
      "trace_ids": [
        "CLI-065",
        "APP-065"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.observation.query/v2",
      "response_schema": "hiroute.plan-trust/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file",
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read complete-scoring coverage and competence for a Plan revision.",
        "usage": "hiroute observation plan-trust ([OPTIONS] | (--request-stdin | --request-file <PATH>)) [--capability-fd <FD>] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Required --plan-id; optional --branch-id, --revision active|all|N, --from-ms, --to-ms, --group-by model|executor. Replay requires --thresholds-millis with 1–8 comma-separated values from 0 to 1000. A complete population above 50,000 stages or a query deadline returns retryable scope_too_large; reduce the scope where possible. Suggestions use the full retained active revision, with a post-announcement upward cohort. No settings change automatically.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute observation plan-trust --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id observation.plan-trust"
        ]
      },
      "positive": {
        "scenario_id": "p0.observation.plan-trust.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.observation.plan-trust.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "observation.plan-trust.replay",
      "path": [
        "observation",
        "plan-trust",
        "replay"
      ],
      "operation_id": "GetPlanTrustReplay",
      "trace_ids": [
        "CLI-066",
        "APP-066"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.observation.query/v2",
      "response_schema": "hiroute.plan-trust-replay/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file",
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Replay exact thresholds over a complete retained population; estimates are not predictions.",
        "usage": "hiroute observation plan-trust replay ([OPTIONS] | (--request-stdin | --request-file <PATH>)) [--capability-fd <FD>] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Required --plan-id; optional --branch-id, --revision active|all|N, --from-ms, --to-ms, --group-by model|executor. Replay requires --thresholds-millis with 1–8 comma-separated values from 0 to 1000. A complete population above 50,000 stages or a query deadline returns retryable scope_too_large; reduce the scope where possible. Suggestions use the full retained active revision, with a post-announcement upward cohort. No settings change automatically.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute observation plan-trust replay --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id observation.plan-trust.replay"
        ]
      },
      "positive": {
        "scenario_id": "p0.observation.plan-trust.replay.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.observation.plan-trust.replay.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "observation.plan-trust.suggestions",
      "path": [
        "observation",
        "plan-trust",
        "suggestions"
      ],
      "operation_id": "GetPlanTrustSuggestions",
      "trace_ids": [
        "CLI-067",
        "APP-067"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.observation.query/v2",
      "response_schema": "hiroute.plan-trust-suggestions/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file",
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read optional evidence-based trust suggestions without changing a Plan.",
        "usage": "hiroute observation plan-trust suggestions ([OPTIONS] | (--request-stdin | --request-file <PATH>)) [--capability-fd <FD>] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. No options. Returns suggestions and unavailable arrays for active published Plans. Per-Plan failures carry plan_id and scope_too_large, unavailable or stale while healthy suggestions remain usable. Suggested branches contain counts, cohort, protection_count, identity_stabilities and only the suggested-threshold replay; full report rows are omitted. A whole-query failure remains retryable, never an empty success. No configuration is changed.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute observation plan-trust suggestions --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id observation.plan-trust.suggestions"
        ]
      },
      "positive": {
        "scenario_id": "p0.observation.plan-trust.suggestions.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.observation.plan-trust.suggestions.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "observation.storage.show",
      "path": [
        "observation",
        "storage",
        "show"
      ],
      "operation_id": "GetObservationCapacity",
      "trace_ids": [
        "CLI-059",
        "APP-059"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Read the local observation capacity policy and measured reclamation status.",
        "usage": "hiroute observation storage show [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute observation storage show --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id observation.storage.show"
        ]
      },
      "positive": {
        "scenario_id": "p0.observation.storage.show.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.observation.storage.show.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "observation.storage.set",
      "path": [
        "observation",
        "storage",
        "set"
      ],
      "operation_id": "SetObservationCapacity",
      "trace_ids": [
        "CLI-060",
        "APP-060"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "action",
      "request_schema": "hiroute.empty-request/v1",
      "response_schema": "hiroute.command-result/v1",
      "effect": "typed_action",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "Save a positive byte threshold or disable early observation expiry.",
        "usage": "hiroute observation storage set [typed options] --non-interactive --output json",
        "arguments_and_options": "Only the typed options declared by the generated request schema are accepted; arbitrary patches, URLs, shell, or plaintext Secret argv are forbidden.",
        "effects": "Application-owned typed operation; side effects are recorded by the Operation and external ledgers.",
        "network_and_model_use": "No model inference; external access, when required, is limited to registered typed ports.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute observation storage set --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id observation.storage.set"
        ]
      },
      "positive": {
        "scenario_id": "p0.observation.storage.set.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.observation.storage.set.negative",
        "polarity": "negative",
        "state": "executable"
      }
    },
    {
      "command_id": "observation.plan-quality.samples",
      "path": [
        "observation",
        "plan-quality",
        "samples"
      ],
      "operation_id": "GetPlanQualitySamples",
      "trace_ids": [
        "CLI-058",
        "APP-058"
      ],
      "scope": "p0",
      "lifecycle": "released",
      "kind": "query",
      "request_schema": "hiroute.observation.query/v2",
      "response_schema": "hiroute.plan-quality-samples-page/v1",
      "effect": "none",
      "network": "local_control_only",
      "model_call": "never",
      "stdin_channels": [
        "request_stdin",
        "request_file",
        "capability_fd"
      ],
      "idempotency": "not_applicable",
      "help": {
        "purpose": "List the latest competence assessment for each persisted execution segment.",
        "usage": "hiroute observation plan-quality samples ([OPTIONS] | (--request-stdin | --request-file <PATH>)) [--capability-fd <FD>] --non-interactive --output json",
        "arguments_and_options": "JSON input: choose exactly one of --request-stdin or --request-file <PATH>. Both read one bounded UTF-8 JSON request with the same strict typed parser; unknown fields, duplicate members, trailing JSON, repeated/mixed sources and human-option mixtures are rejected before Local Control. A file must be regular; relative paths resolve from the current directory (prefix option-shaped filenames with ./). Existing command byte limits and separate protected-input/capability channels remain unchanged. Provide at least --plan-id or --session-id. Use --competence below-floor|meets-floor to compare the latest reliable score with the floor saved for that stage, or --unrated for missing/partial scores. Score bounds remain strict open bounds. Detail filters do not alter full-scope summaries. The existing v2 query may opt in with include_routing_observations:true for retained applicability statistics. Omitted/false preserves released strict fields, authorization and cursor bindings. Counts and rates state retained coverage and actual applicability-request denominators. Facts are same-UID reads; protected evidence content is never returned.",
        "effects": "Read-only; no product side effect.",
        "network_and_model_use": "No model use; any external dependency is declared by the typed Application operation.",
        "automation": "Use stable command_id, status, typed data, warnings[].code, and next_actions[].command_id; never parse display text.",
        "output": "One hiroute.machine-envelope/v2 JSON object on stdout; diagnostics belong on stderr.",
        "exit_status": "0 success/accepted; 2 usage; 3 conflict/blocker; 4 capability denied; 5 not found; 6 unavailable; 7 action required; 8 needs attention.",
        "examples": [
          "hiroute observation plan-quality samples --non-interactive --output json"
        ],
        "see_also": [
          "hiroute schema show --command-id observation.plan-quality.samples"
        ]
      },
      "positive": {
        "scenario_id": "p0.observation.plan-quality.samples.positive",
        "polarity": "positive",
        "state": "executable"
      },
      "negative": {
        "scenario_id": "p0.observation.plan-quality.samples.negative",
        "polarity": "negative",
        "state": "executable"
      }
    }
  ]
}