# Agent command inventory

This page is generated from the canonical agent command registration
surface in `oduit.cli.app`.

Command tiers:

- `stable_for_agents`: Recommended machine-facing surface for agents.
- `beta_for_agents`: Useful for agents, but still evolving in shape or behavior.
- `human_oriented`: Supported CLI surface, but documented primarily for humans.
- `compatibility_only`: Retained for migration or import compatibility only.

```{list-table} Canonical `oduit agent` commands
:header-rows: 1

* - Command
  - Stability tier
  - Safety level
  - Summary
* - `context`
  - `stable_for_agents`
  - `safe_read_only`
  - Return a structured environment snapshot for automation.
* - `inspect-addon`
  - `stable_for_agents`
  - `safe_read_only`
  - Return a one-shot addon inspection payload.
* - `addon-info`
  - `stable_for_agents`
  - `safe_read_only`
  - Return a combined manifest, source, and runtime addon summary.
* - `addon-doc`
  - `stable_for_agents`
  - `safe_read_only`
  - Return a structured addon documentation bundle.
* - `technical-doc`
  - `beta_for_agents`
  - `controlled_source_mutation`
  - Create or preview addon-local arc42 technical documentation.
* - `technical-evidence`
  - `beta_for_agents`
  - `controlled_source_mutation`
  - Create or preview split deterministic technical evidence.
* - `technical-report`
  - `beta_for_agents`
  - `controlled_source_mutation`
  - Create or preview split LLM/human architecture report seed.
* - `technical-doc-diff`
  - `beta_for_agents`
  - `safe_read_only`
  - Diff report snapshots against current deterministic evidence.
* - `technical-doc-refresh`
  - `beta_for_agents`
  - `controlled_source_mutation`
  - Refresh managed blocks inside addon-local arc42 technical documentation.
* - `technical-doc-accept`
  - `beta_for_agents`
  - `controlled_source_mutation`
  - Accept a manually reviewed architecture document snapshot.
* - `technical-doc-status`
  - `beta_for_agents`
  - `safe_read_only`
  - Return tracking and freshness status for addon technical docs.
* - `technical-doc-check`
  - `beta_for_agents`
  - `safe_read_only`
  - Return freshness information for one technical-documentation target.
* - `technical-doc-next`
  - `beta_for_agents`
  - `safe_read_only`
  - Return the next addon that needs technical-documentation work.
* - `plan-update`
  - `stable_for_agents`
  - `safe_read_only`
  - Return a structured, read-only update plan for a module.
* - `prepare-addon-change`
  - `beta_for_agents`
  - `safe_read_only`
  - Bundle the common read-only planning steps for one addon change.
* - `locate-model`
  - `beta_for_agents`
  - `safe_read_only`
  - Locate likely source files for a model extension inside one addon.
* - `locate-field`
  - `beta_for_agents`
  - `safe_read_only`
  - Locate an existing field or suggest the best insertion point.
* - `list-addon-tests`
  - `beta_for_agents`
  - `safe_read_only`
  - List likely tests for an addon, optionally ranked by hints.
* - `recommend-tests`
  - `beta_for_agents`
  - `safe_read_only`
  - Map changed addon files to recommended tests and test tags.
* - `list-addon-models`
  - `beta_for_agents`
  - `safe_read_only`
  - List the models declared or extended by one addon.
* - `find-model-extensions`
  - `beta_for_agents`
  - `safe_read_only`
  - Find where a model is declared, extended, and installed.
* - `get-model-views`
  - `beta_for_agents`
  - `safe_read_only`
  - Fetch database-backed primary and extension views for a model.
* - `doctor`
  - `stable_for_agents`
  - `safe_read_only`
  - Return doctor diagnostics through the standard agent envelope.
* - `list-addons`
  - `stable_for_agents`
  - `safe_read_only`
  - Return structured addon inventory for the active environment.
* - `list-installed-addons`
  - `stable_for_agents`
  - `safe_read_only`
  - Return structured runtime installed-addon inventory.
* - `dependency-graph`
  - `stable_for_agents`
  - `safe_read_only`
  - Return a structured dependency and reverse-dependency graph.
* - `explain-install-order`
  - `stable_for_agents`
  - `safe_read_only`
  - Explain dependency cycles blocking install-order for automation.
* - `inspect-addons`
  - `stable_for_agents`
  - `safe_read_only`
  - Inspect multiple addons through the stable agent envelope.
* - `resolve-config`
  - `stable_for_agents`
  - `safe_read_only`
  - Return the resolved configuration with sensitive values redacted.
* - `resolve-addon-root`
  - `stable_for_agents`
  - `safe_read_only`
  - Resolve addon root paths for one module name.
* - `get-addon-files`
  - `stable_for_agents`
  - `safe_read_only`
  - Return a deterministic file inventory for one addon.
* - `check-addons-installed`
  - `stable_for_agents`
  - `safe_read_only`
  - Return runtime installed-state checks for one or more addons.
* - `check-model-exists`
  - `beta_for_agents`
  - `safe_read_only`
  - Check whether a model exists in source discovery and runtime metadata.
* - `check-field-exists`
  - `beta_for_agents`
  - `safe_read_only`
  - Check whether a field exists in runtime metadata and source.
* - `list-duplicates`
  - `stable_for_agents`
  - `safe_read_only`
  - Return duplicate addon names through the standard agent envelope.
* - `inspect-ref`
  - `stable_for_agents`
  - `safe_read_only`
  - Resolve one XMLID through the embedded Odoo runtime.
* - `inspect-cron`
  - `stable_for_agents`
  - `controlled_runtime_mutation`
  - Inspect one cron job and optionally trigger it.
* - `inspect-modules`
  - `stable_for_agents`
  - `safe_read_only`
  - Inspect module records from ir.module.module.
* - `inspect-subtypes`
  - `stable_for_agents`
  - `safe_read_only`
  - List message subtypes registered for one model.
* - `inspect-model`
  - `stable_for_agents`
  - `safe_read_only`
  - Inspect runtime model registration metadata.
* - `inspect-field`
  - `stable_for_agents`
  - `safe_read_only`
  - Inspect runtime field metadata.
* - `db-table`
  - `stable_for_agents`
  - `safe_read_only`
  - Describe one PostgreSQL table through the live Odoo connection.
* - `db-column`
  - `stable_for_agents`
  - `safe_read_only`
  - Describe one PostgreSQL column through the live Odoo connection.
* - `db-constraints`
  - `stable_for_agents`
  - `safe_read_only`
  - List PostgreSQL constraints for one table.
* - `db-tables`
  - `stable_for_agents`
  - `safe_read_only`
  - List PostgreSQL tables through the live Odoo connection.
* - `db-m2m`
  - `stable_for_agents`
  - `safe_read_only`
  - Inspect the relation table behind a Many2many field.
* - `performance-slow-queries`
  - `stable_for_agents`
  - `safe_read_only`
  - Read pg_stat_statements when the extension is available.
* - `performance-table-scans`
  - `stable_for_agents`
  - `safe_read_only`
  - Show tables with high sequential scan counts.
* - `performance-indexes`
  - `stable_for_agents`
  - `safe_read_only`
  - Show basic table index-usage metrics.
* - `manifest-check`
  - `stable_for_agents`
  - `safe_read_only`
  - Validate a manifest file and report structural warnings.
* - `manifest-show`
  - `stable_for_agents`
  - `safe_read_only`
  - Show manifest metadata for an addon or addon path.
* - `install-module`
  - `stable_for_agents`
  - `controlled_runtime_mutation`
  - Install a module with an explicit mutation gate.
* - `update-module`
  - `stable_for_agents`
  - `controlled_runtime_mutation`
  - Update a module with an explicit mutation gate.
* - `uninstall-module`
  - `stable_for_agents`
  - `controlled_runtime_mutation`
  - Uninstall a module with explicit runtime and destructive gates.
* - `create-addon`
  - `stable_for_agents`
  - `controlled_source_mutation`
  - Create a new addon with an explicit mutation gate.
* - `i18n-export`
  - `stable_for_agents`
  - `controlled_source_mutation`
  - Export translations with a structured agent payload.
* - `i18n-import`
  - `stable_for_agents`
  - `controlled_runtime_mutation`
  - Import translations with a structured agent payload.
* - `i18n-loadlang`
  - `stable_for_agents`
  - `controlled_runtime_mutation`
  - Load languages with a structured agent payload.
* - `export-lang`
  - `compatibility_only`
  - `controlled_source_mutation`
  - Export language files with an explicit mutation gate.
* - `test-summary`
  - `stable_for_agents`
  - `controlled_runtime_mutation`
  - Run tests and emit a normalized summary payload.
* - `validate-addon-change`
  - `beta_for_agents`
  - `controlled_runtime_mutation`
  - Validate an addon change with one aggregate structured payload.
* - `preflight-addon-change`
  - `beta_for_agents`
  - `safe_read_only`
  - Run a cheap read-only addon-change preflight.
* - `query-model`
  - `stable_for_agents`
  - `safe_read_only`
  - Run a structured read-only model query.
* - `read-record`
  - `stable_for_agents`
  - `safe_read_only`
  - Read a single record by id via OdooQuery.
* - `search-count`
  - `stable_for_agents`
  - `safe_read_only`
  - Count records matching a domain via OdooQuery.
* - `get-model-fields`
  - `stable_for_agents`
  - `safe_read_only`
  - Inspect model field metadata via OdooQuery.
```