acumatica-cli 0.30.0__tar.gz → 0.31.0__tar.gz

{acumatica_cli-0.30.0 → acumatica_cli-0.31.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acumatica-cli
-Version: 0.30.0
+Version: 0.31.0
 Summary: Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data
 Author: Konstantin Borovik
 Author-email: Konstantin Borovik <kb@lab5.ca>
@@ -40,21 +40,21 @@ YAML in git is the source of truth; the live tenant is the target. `apply` is th
 | ------- | ------- | ------ |
 | Seed a tenant from YAML | `apply` | Idempotent PUT of `config/` into the live tenant |
 | Detect drift | `diff` | Compare seed YAML to live (exit 2 when they diverge) |
-| Pull live config into YAML | `extract` | Inverse of `apply` — GET into `config/{bootstrap,baseline,setup,master}/` |
+| Pull live config into YAML | `survey extract` | Inverse of `apply` — GET into `config/{bootstrap,baseline,setup,master}/` |
 | Run transaction scripts | `run` | Forward documents from `scenario/` (capital, buy, build, sell) |
 | Capture derived balances | `state` | Inquire trial-balance etc. into `state/` (not seed) |
 | Create and destroy tenants | `tenant` | SSH control plane: list / create / delete / recycle |
 | Publish the Bootstrap contract | `bootstrap` | REST publish of AcuBootstrap (or `--export` zip for the UI) |
 | Prove a cold rebuild | `tenant create` then `apply` then `run` then `diff` | Compose on a fresh tenant. No wrap command. |
-| Snapshot a site offline | `inventory` | SM203520 XML ZIP or `ac.exe export xml` writes `inventory/` |
-| Cross-check snapshot vs seed | `reconcile` | `inventory/` plus optional `config/` writes `findings/` only |
+| Snapshot a site offline | `survey inventory` | SM203520 XML ZIP or `ac.exe export xml` writes `inventory/` |
+| Cross-check snapshot vs seed | `survey reconcile` | `inventory/` plus optional `config/` writes `findings/` only |
 | Dump the contract schema | `schema` | OpenAPI `swagger.json` for the pinned endpoint |
 | Scaffold a data repo | `config init` | Full `config/`, `scenario/`, `.env` tree |
 | Preflight a target | `config check` | Discovery, secrets, REST, endpoints, SSH |
 
 Seed YAML covers features, company, credit terms, subaccounts, chart of accounts, ledger, UOMs, financial year / calendar / periods, numbering sequences, inventory and distribution masters, roles, and users.
 
-REST is the data plane (`apply`, `diff`, `run`, `extract`, `state`, `bootstrap`, `schema`).
+REST is the data plane (`apply`, `diff`, `run`, `survey extract`, `state`, `bootstrap`, `schema`).
 SSH is the control plane (`tenant *`).
 
 Hosted sites skip SSH.
@@ -116,11 +116,12 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 ├── run   [--dry-run] [FILES...]      execute transaction scenario YAML (exit 1 on any miss)
 ├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
 │                                     capture derived state into state/ (not seed)
-├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
-│                                     inverse of apply into config/{bootstrap,baseline,setup,master}/
-├── inventory [--out DIR] [--force] [--dry-run] ARTIFACT
-│                                     offline snapshot artifact → inventory/ (not seed)
-├── reconcile [--inventory DIR] [--config DIR] [--out DIR] [--force] [--dry-run]
+├── survey                            existing-tenant dual-reader (never L1 extract/inventory/reconcile)
+│   ├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
+│   │                                 inverse of apply into config/{bootstrap,baseline,setup,master}/
+│   ├── inventory [--out DIR] [--force] [--dry-run] ARTIFACT
+│   │                                 offline snapshot artifact → inventory/ (not seed)
+│   └── reconcile [--inventory DIR] [--config DIR] [--out DIR] [--force] [--dry-run]
 │                                     inventory/ + optional config/ → findings/ only
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
@@ -141,12 +142,12 @@ When you omit FILES:
 Scenario YAML may use `${current_period}` (host-local `MMyyyy`) on steps, expect params, and `once.present` params.
 `config/views` and `state` keep Period pinned — see [docs/demo-seed.md](docs/demo-seed.md#period-token-current_period-vs-pinned-views).
 
-`extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
+`survey extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
 
-`inventory` and `reconcile` are offline (no REST, SSH, or password).
-`inventory` turns an SM203520 Settings XML ZIP or `ac.exe export xml` folder into `inventory/`.
+`survey inventory` and `survey reconcile` are offline (no REST, SSH, or password).
+`survey inventory` turns an SM203520 Settings XML ZIP or `ac.exe export xml` folder into `inventory/`.
 
-`reconcile` compares `inventory/` to optional `config/` and writes `findings/` only.
+`survey reconcile` compares `inventory/` to optional `config/` and writes `findings/` only.
 It never writes seed.
 
 Optional `snapshot_map.yaml` (data-repo root, or package defaults) maps DAC tables to catalog entities.
@@ -168,9 +169,9 @@ Do not confuse them with each other or with `state`:
 
 | Command | Plane | Input | Writes | Role |
 | ------- | ----- | ----- | ------ | ---- |
-| `extract` | REST (live) | tenant via contract API | `config/{bootstrap,baseline,setup,master}/` | Inverse of `apply` — seed YAML |
-| `inventory` | Offline | SM203520 Settings XML ZIP or `ac.exe export xml` folder | `inventory/` (`summary.yaml` + `tables/`) | Full-table snapshot IR — not seed |
-| `reconcile` | Offline | `inventory/` + optional `config/` | `findings/` only | Cross-check gaps/deltas — never mutates seed or tenant |
+| `survey extract` | REST (live) | tenant via contract API | `config/{bootstrap,baseline,setup,master}/` | Inverse of `apply` — seed YAML |
+| `survey inventory` | Offline | SM203520 Settings XML ZIP or `ac.exe export xml` folder | `inventory/` (`summary.yaml` + `tables/`) | Full-table snapshot IR — not seed |
+| `survey reconcile` | Offline | `inventory/` + optional `config/` | `findings/` only | Cross-check gaps/deltas — never mutates seed or tenant |
 | `state` | REST (live) | `config/views/` | `state/` | Derived balances/totals — not seed, not inventory |
 | `apply` | REST (live) | seed YAML under `config/` | tenant | **Sole** tenant writer (keyed PUT) |
 
@@ -198,8 +199,8 @@ There is no `--flavor`.
 | `scenario/` | lifecycle txns for `acu run`: once capital, then buy, build, sell |
 | `config/views/` | observer views for `acu state` (`inquire:` / `entity:` / `gi:`; not SEED_DIRS) |
 | `state/` | committed derived-state observations (evidence, not seed; money/qty fixed-point) |
-| `inventory/` | engagement: offline snapshot tables from `acu inventory` (not seed; not SEED_DIRS) |
-| `findings/` | engagement: `acu reconcile` cross-check output (never apply path) |
+| `inventory/` | engagement: offline snapshot tables from `acu survey inventory` (not seed; not SEED_DIRS) |
+| `findings/` | engagement: `acu survey reconcile` cross-check output (never apply path) |
 | `.env` | secrets + where (`ACU_BASE_URL`) + pin (`ACU_API_VERSION`) |
 
 Legacy data repos may still keep root `bootstrap/`…`master/`; bare `apply`/`diff` prefer `config/` when present and never merge both trees.
@@ -208,7 +209,7 @@ Files in each directory apply alphabetically; the numbered prefixes (`10-`, `20-
 Commit seed YAML; keep `.env` out of git (scaffold `.gitignore` already lists it).
 
 Seed YAML is state: `apply` upserts it, `diff` proves it.
-`acu extract` is the inverse of `apply`: GET live tenant rows into seed YAML under `config/{bootstrap,baseline,setup,master}/` (hard-cut).
+`acu survey extract` is the inverse of `apply`: GET live tenant rows into seed YAML under `config/{bootstrap,baseline,setup,master}/` (hard-cut).
 
 Packaged `seed_catalog.yaml` is the sole extract registry (entity, endpoint, keys, file, strip/include, filter-split).
 The demo entity map in [docs/demo-seed.md](docs/demo-seed.md) mirrors those catalog paths.
@@ -220,7 +221,7 @@ Row failures continue (exit 1 only if any row failed).
 Drift stays with `diff`.
 
 ```sh
-acu --tenant DEV extract --out . --force   # refresh config/** from live tenant
+acu --tenant DEV survey extract --out . --force   # refresh config/** from live tenant
 git diff config/                           # review extract delta before commit
 acu --tenant DEV apply config/             # replay extracted seed
 acu --tenant DEV diff config/              # expect exit 0
@@ -377,9 +378,9 @@ gmake release patch   # or minor | major
 2. Fail if `## Unreleased` has no bullets
 3. Bump `pyproject.toml` version (`major` | `minor` | `patch`)
 4. Promote Unreleased body to `## [vX.Y.Z] - YYYY-MM-DD`, leave an empty `## Unreleased`
-5. Commit `CHANGELOG.md` + `pyproject.toml` (+ lock if bumped) together, tag `vX.Y.Z`
-6. `gmake check` again on the promoted tree
-7. Push tag + branch — GitHub Actions publishes
+5. Commit `CHANGELOG.md` + `pyproject.toml` (+ lock if bumped) together
+6. `gmake check` again on the promoted tree — fail keeps the commit, creates no tag, pushes nothing
+7. Tag `vX.Y.Z` and push branch + that tag — GitHub Actions publishes
 
 GitHub Actions on tag `v*` re-runs CI, builds sdist+wheel, publishes to PyPI via OIDC trusted publishing, and creates a GitHub Release whose notes are the promoted CHANGELOG section for that tag (plus the artifacts).
 

{acumatica_cli-0.30.0 → acumatica_cli-0.31.0}/README.md

@@ -22,21 +22,21 @@ YAML in git is the source of truth; the live tenant is the target. `apply` is th
 | ------- | ------- | ------ |
 | Seed a tenant from YAML | `apply` | Idempotent PUT of `config/` into the live tenant |
 | Detect drift | `diff` | Compare seed YAML to live (exit 2 when they diverge) |
-| Pull live config into YAML | `extract` | Inverse of `apply` — GET into `config/{bootstrap,baseline,setup,master}/` |
+| Pull live config into YAML | `survey extract` | Inverse of `apply` — GET into `config/{bootstrap,baseline,setup,master}/` |
 | Run transaction scripts | `run` | Forward documents from `scenario/` (capital, buy, build, sell) |
 | Capture derived balances | `state` | Inquire trial-balance etc. into `state/` (not seed) |
 | Create and destroy tenants | `tenant` | SSH control plane: list / create / delete / recycle |
 | Publish the Bootstrap contract | `bootstrap` | REST publish of AcuBootstrap (or `--export` zip for the UI) |
 | Prove a cold rebuild | `tenant create` then `apply` then `run` then `diff` | Compose on a fresh tenant. No wrap command. |
-| Snapshot a site offline | `inventory` | SM203520 XML ZIP or `ac.exe export xml` writes `inventory/` |
-| Cross-check snapshot vs seed | `reconcile` | `inventory/` plus optional `config/` writes `findings/` only |
+| Snapshot a site offline | `survey inventory` | SM203520 XML ZIP or `ac.exe export xml` writes `inventory/` |
+| Cross-check snapshot vs seed | `survey reconcile` | `inventory/` plus optional `config/` writes `findings/` only |
 | Dump the contract schema | `schema` | OpenAPI `swagger.json` for the pinned endpoint |
 | Scaffold a data repo | `config init` | Full `config/`, `scenario/`, `.env` tree |
 | Preflight a target | `config check` | Discovery, secrets, REST, endpoints, SSH |
 
 Seed YAML covers features, company, credit terms, subaccounts, chart of accounts, ledger, UOMs, financial year / calendar / periods, numbering sequences, inventory and distribution masters, roles, and users.
 
-REST is the data plane (`apply`, `diff`, `run`, `extract`, `state`, `bootstrap`, `schema`).
+REST is the data plane (`apply`, `diff`, `run`, `survey extract`, `state`, `bootstrap`, `schema`).
 SSH is the control plane (`tenant *`).
 
 Hosted sites skip SSH.
@@ -98,11 +98,12 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 ├── run   [--dry-run] [FILES...]      execute transaction scenario YAML (exit 1 on any miss)
 ├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
 │                                     capture derived state into state/ (not seed)
-├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
-│                                     inverse of apply into config/{bootstrap,baseline,setup,master}/
-├── inventory [--out DIR] [--force] [--dry-run] ARTIFACT
-│                                     offline snapshot artifact → inventory/ (not seed)
-├── reconcile [--inventory DIR] [--config DIR] [--out DIR] [--force] [--dry-run]
+├── survey                            existing-tenant dual-reader (never L1 extract/inventory/reconcile)
+│   ├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
+│   │                                 inverse of apply into config/{bootstrap,baseline,setup,master}/
+│   ├── inventory [--out DIR] [--force] [--dry-run] ARTIFACT
+│   │                                 offline snapshot artifact → inventory/ (not seed)
+│   └── reconcile [--inventory DIR] [--config DIR] [--out DIR] [--force] [--dry-run]
 │                                     inventory/ + optional config/ → findings/ only
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
@@ -123,12 +124,12 @@ When you omit FILES:
 Scenario YAML may use `${current_period}` (host-local `MMyyyy`) on steps, expect params, and `once.present` params.
 `config/views` and `state` keep Period pinned — see [docs/demo-seed.md](docs/demo-seed.md#period-token-current_period-vs-pinned-views).
 
-`extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
+`survey extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
 
-`inventory` and `reconcile` are offline (no REST, SSH, or password).
-`inventory` turns an SM203520 Settings XML ZIP or `ac.exe export xml` folder into `inventory/`.
+`survey inventory` and `survey reconcile` are offline (no REST, SSH, or password).
+`survey inventory` turns an SM203520 Settings XML ZIP or `ac.exe export xml` folder into `inventory/`.
 
-`reconcile` compares `inventory/` to optional `config/` and writes `findings/` only.
+`survey reconcile` compares `inventory/` to optional `config/` and writes `findings/` only.
 It never writes seed.
 
 Optional `snapshot_map.yaml` (data-repo root, or package defaults) maps DAC tables to catalog entities.
@@ -150,9 +151,9 @@ Do not confuse them with each other or with `state`:
 
 | Command | Plane | Input | Writes | Role |
 | ------- | ----- | ----- | ------ | ---- |
-| `extract` | REST (live) | tenant via contract API | `config/{bootstrap,baseline,setup,master}/` | Inverse of `apply` — seed YAML |
-| `inventory` | Offline | SM203520 Settings XML ZIP or `ac.exe export xml` folder | `inventory/` (`summary.yaml` + `tables/`) | Full-table snapshot IR — not seed |
-| `reconcile` | Offline | `inventory/` + optional `config/` | `findings/` only | Cross-check gaps/deltas — never mutates seed or tenant |
+| `survey extract` | REST (live) | tenant via contract API | `config/{bootstrap,baseline,setup,master}/` | Inverse of `apply` — seed YAML |
+| `survey inventory` | Offline | SM203520 Settings XML ZIP or `ac.exe export xml` folder | `inventory/` (`summary.yaml` + `tables/`) | Full-table snapshot IR — not seed |
+| `survey reconcile` | Offline | `inventory/` + optional `config/` | `findings/` only | Cross-check gaps/deltas — never mutates seed or tenant |
 | `state` | REST (live) | `config/views/` | `state/` | Derived balances/totals — not seed, not inventory |
 | `apply` | REST (live) | seed YAML under `config/` | tenant | **Sole** tenant writer (keyed PUT) |
 
@@ -180,8 +181,8 @@ There is no `--flavor`.
 | `scenario/` | lifecycle txns for `acu run`: once capital, then buy, build, sell |
 | `config/views/` | observer views for `acu state` (`inquire:` / `entity:` / `gi:`; not SEED_DIRS) |
 | `state/` | committed derived-state observations (evidence, not seed; money/qty fixed-point) |
-| `inventory/` | engagement: offline snapshot tables from `acu inventory` (not seed; not SEED_DIRS) |
-| `findings/` | engagement: `acu reconcile` cross-check output (never apply path) |
+| `inventory/` | engagement: offline snapshot tables from `acu survey inventory` (not seed; not SEED_DIRS) |
+| `findings/` | engagement: `acu survey reconcile` cross-check output (never apply path) |
 | `.env` | secrets + where (`ACU_BASE_URL`) + pin (`ACU_API_VERSION`) |
 
 Legacy data repos may still keep root `bootstrap/`…`master/`; bare `apply`/`diff` prefer `config/` when present and never merge both trees.
@@ -190,7 +191,7 @@ Files in each directory apply alphabetically; the numbered prefixes (`10-`, `20-
 Commit seed YAML; keep `.env` out of git (scaffold `.gitignore` already lists it).
 
 Seed YAML is state: `apply` upserts it, `diff` proves it.
-`acu extract` is the inverse of `apply`: GET live tenant rows into seed YAML under `config/{bootstrap,baseline,setup,master}/` (hard-cut).
+`acu survey extract` is the inverse of `apply`: GET live tenant rows into seed YAML under `config/{bootstrap,baseline,setup,master}/` (hard-cut).
 
 Packaged `seed_catalog.yaml` is the sole extract registry (entity, endpoint, keys, file, strip/include, filter-split).
 The demo entity map in [docs/demo-seed.md](docs/demo-seed.md) mirrors those catalog paths.
@@ -202,7 +203,7 @@ Row failures continue (exit 1 only if any row failed).
 Drift stays with `diff`.
 
 ```sh
-acu --tenant DEV extract --out . --force   # refresh config/** from live tenant
+acu --tenant DEV survey extract --out . --force   # refresh config/** from live tenant
 git diff config/                           # review extract delta before commit
 acu --tenant DEV apply config/             # replay extracted seed
 acu --tenant DEV diff config/              # expect exit 0
@@ -359,9 +360,9 @@ gmake release patch   # or minor | major
 2. Fail if `## Unreleased` has no bullets
 3. Bump `pyproject.toml` version (`major` | `minor` | `patch`)
 4. Promote Unreleased body to `## [vX.Y.Z] - YYYY-MM-DD`, leave an empty `## Unreleased`
-5. Commit `CHANGELOG.md` + `pyproject.toml` (+ lock if bumped) together, tag `vX.Y.Z`
-6. `gmake check` again on the promoted tree
-7. Push tag + branch — GitHub Actions publishes
+5. Commit `CHANGELOG.md` + `pyproject.toml` (+ lock if bumped) together
+6. `gmake check` again on the promoted tree — fail keeps the commit, creates no tag, pushes nothing
+7. Tag `vX.Y.Z` and push branch + that tag — GitHub Actions publishes
 
 GitHub Actions on tag `v*` re-runs CI, builds sdist+wheel, publishes to PyPI via OIDC trusted publishing, and creates a GitHub Release whose notes are the promoted CHANGELOG section for that tag (plus the artifacts).
 

{acumatica_cli-0.30.0 → acumatica_cli-0.31.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.30.0"
+version = "0.31.0"
 description = "Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data"
 license = "PolyForm-Noncommercial-1.0.0"
 readme = "README.md"

{acumatica_cli-0.30.0 → acumatica_cli-0.31.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.30.0"
+version = "0.31.0"
 description = "Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data"
 authors = [{ name = "Konstantin Borovik", email = "kb@lab5.ca" }]
 license = "PolyForm-Noncommercial-1.0.0"

{acumatica_cli-0.30.0 → acumatica_cli-0.31.0}/src/acumatica_cli/cli.py

@@ -5,13 +5,13 @@ Configure Acumatica ERP from YAML in a git data repo. No UI wizards.
 \b
 MENTAL MODEL
   Data repo = directory with .env (walk-up from cwd). Holds:
-    config/{bootstrap,baseline,setup,master}/  seed YAML (apply/diff/extract)
+    config/{bootstrap,baseline,setup,master}/  seed YAML (apply/diff/survey extract)
     config/views/                              observer views (state)
     scenario/                                  transaction scripts (run)
     .env                                       secrets + where + API pin
     state/ inventory/ findings/ schemas/       command outputs (not seed)
   Two planes (do not mix):
-    REST data plane — apply diff run bootstrap extract state schema
+    REST data plane — apply diff run bootstrap survey extract state schema
       needs: base_url, tenant, password (SSH optional)
     SSH control plane — tenant list|create|delete|recycle
       needs: non-empty ACU_SSH (user@host)
@@ -56,9 +56,9 @@ COMMAND MAP (pick by intent)
   seed check   diff [FILES...]                           (exit 2 on drift)
   txns         run [--dry-run] [FILES...]
   cold rebuild tenant create then apply then run then diff (no wrap cmd)
-  pull seed    extract [--only ENTITY]...                (inverse of apply)
+  pull seed    survey extract [--only ENTITY]...         (inverse of apply)
   observe      state [--diff|--assert-unchanged]
-  offline      inventory ARTIFACT | reconcile
+  offline      survey inventory ARTIFACT | survey reconcile
   reference    schema
 
 \b
@@ -73,7 +73,7 @@ DEFAULT PATHS (when FILES omitted)
                 then overlays/default-<api>/ when present
   run         -> scenario/ (overlay same-basename wins)
   state       -> config/views/ -> writes state/
-  extract     -> always writes config/{bootstrap,baseline,setup,master}/
+  survey extract -> always writes config/{bootstrap,baseline,setup,master}/
 
 Run `acu <command> --help` for flags, examples, and prerequisites.
 See package README and docs/demo-seed.md for seed YAML shape.
@@ -1027,7 +1027,7 @@ def apply_cmd(inst: Instance, files: tuple[Path, ...], dry_run: bool) -> None:
       acu --tenant DEV apply --dry-run config/master/
       acu --tenant DEV apply config/baseline/20-accounts.yaml
 
-    Related: `diff` (drift) · `extract` (inverse pull) · `run` (txns).
+    Related: `diff` (drift) · `survey extract` (inverse pull) · `run` (txns).
     """
     total_ok = 0
     all_errors: list[str] = []
@@ -1106,7 +1106,7 @@ def diff_cmd(inst: Instance, files: tuple[Path, ...]) -> None:
       acu --tenant DEV diff config/
       acu --tenant DEV diff config/master/90-roles.yaml
 
-    Related: `apply` (fix) · `extract` (pull) · `state` (balances).
+    Related: `apply` (fix) · `survey extract` (pull) · `state` (balances).
     """
     paths = expand_files(files or default_apply_dirs(inst))
     drifts: list[str] = []
@@ -1189,7 +1189,27 @@ def _complete_only(
     ]
 
 
-@cli.command("extract")
+@cli.group("survey", context_settings=_HELP_CTX)
+def survey_group() -> None:
+    """Existing-tenant dual-reader (REST extract + offline inventory/reconcile).
+
+    Noun owns extract|inventory|reconcile. Never L1 those verbs. No aliases.
+
+    \b
+    Subcommands
+      extract [--only ENTITY]...   live GET -> config/ SEED_DIRS (REST)
+      inventory ARTIFACT           snapshot ZIP/folder -> inventory/ (offline)
+      reconcile                    inventory/ + optional config/ -> findings/ (offline)
+
+    \b
+    Examples
+      acu --tenant DEV survey extract
+      acu survey inventory ./export-xml/
+      acu survey reconcile
+    """
+
+
+@survey_group.command("extract")
 @click.option(
     "--out",
     "out_dir",
@@ -1230,11 +1250,11 @@ def extract_cmd(
 
     \b
     Examples
-      acu --tenant DEV extract
-      acu --tenant DEV extract --only Account --only Vendor
-      acu --tenant DEV extract --force --dry-run
+      acu --tenant DEV survey extract
+      acu --tenant DEV survey extract --only Account --only Vendor
+      acu --tenant DEV survey extract --force --dry-run
 
-    Related: `apply` · `diff` · `inventory` · `state`.
+    Related: `apply` · `diff` · `survey inventory` · `state`.
     """
     with AcumaticaClient(inst) as client:
         failed = extract.run(
@@ -1258,7 +1278,7 @@ def _exit_on_drift(inst: Instance, drifts: list[str], files: int) -> None:
     output.success(f"no drift on {inst.tenant} ({inst.base_url}, {files} file(s))")
 
 
-@cli.command("inventory")
+@survey_group.command("inventory")
 @click.argument(
     "artifact",
     type=click.Path(exists=True, path_type=Path),
@@ -1290,15 +1310,15 @@ def inventory_cmd(
     Existing files skip unless --force.
 
     Not extract (REST → config/ seed). Not state (balances). Never writes
-    config/ or state/. Feed inventory/ into `acu reconcile`.
+    config/ or state/. Feed inventory/ into `acu survey reconcile`.
 
     \b
     Exit  0 = clean · 1 = parse/format/version fail · never 2
 
     \b
     Examples
-      acu inventory ./export-xml/
-      acu inventory Settings.zip --out inventory/ --force
+      acu survey inventory ./export-xml/
+      acu survey inventory Settings.zip --out inventory/ --force
     """
     # V9 long single-op: artifact parse (ZIP/folder IR) via step; banner +
     # per-table write/skip emit stay multi-unit stdout after.
@@ -1312,13 +1332,13 @@ def inventory_cmd(
     inventory.emit(art, dest, force=force, dry_run=dry_run)
 
 
-@cli.command("reconcile")
+@survey_group.command("reconcile")
 @click.option(
     "--inventory",
     "inventory_dir",
     type=click.Path(file_okay=False, path_type=Path),
     default=None,
-    help="Inventory tree from `acu inventory` (default: inventory/)",
+    help="Inventory tree from `acu survey inventory` (default: inventory/)",
 )
 @click.option(
     "--config",
@@ -1361,8 +1381,8 @@ def reconcile_cmd(
 
     \b
     Examples
-      acu inventory export.zip && acu reconcile
-      acu reconcile --inventory inv/ --config config/ --out findings/
+      acu survey inventory export.zip && acu survey reconcile
+      acu survey reconcile --inventory inv/ --config config/ --out findings/
     """
     inv = (
         inventory_dir
@@ -1440,7 +1460,7 @@ def state_cmd(
       acu --tenant DEV state --assert-unchanged
       acu --tenant DEV state config/views/10-trial-balance.yaml
 
-    Related: `run` (moves balances) · `diff` (seed drift) · `extract`.
+    Related: `run` (moves balances) · `diff` (seed drift) · `survey extract`.
     """
     if not files:
         default = data_root() / "config" / "views"

{acumatica_cli-0.30.0 → acumatica_cli-0.31.0}/src/acumatica_cli/reconcile.py

@@ -287,7 +287,7 @@ class FindingsBundle(Model):
 
 
 def load_inventory_tree(path: Path | str) -> InventoryTree:
-    """Load an ``inventory/`` tree written by ``acu inventory`` (I.data)."""
+    """Load an ``inventory/`` tree written by ``acu survey inventory`` (I.data)."""
     root = Path(path)
     if not root.is_dir():
         raise SystemExit(f"{root}: inventory directory not found")
@@ -295,7 +295,7 @@ def load_inventory_tree(path: Path | str) -> InventoryTree:
     if not summary_path.is_file():
         raise SystemExit(
             f"{root}: missing {inventory.SUMMARY_NAME} "
-            "(run `acu inventory` first, or pass --inventory DIR)"
+            "(run `acu survey inventory` first, or pass --inventory DIR)"
         )
     try:
         raw = yaml.safe_load(summary_path.read_text(encoding="utf-8"))

{acumatica_cli-0.30.0 → acumatica_cli-0.31.0}/src/acumatica_cli/templates/README.md

@@ -33,11 +33,11 @@ acu run scenario/10-seed-capital.yaml && acu state --assert-unchanged
 # SSH cold rebuild: acu tenant create --login NAME, then apply, run, diff
 
 # Optional: re-seed from live (inverse of apply; always under config/)
-# acu extract --out . --force
+# acu survey extract --out . --force
 ```
 
 Bare `acu apply` / `acu diff` also prefer `config/` when those trees exist.
-`acu extract` hard-cuts emit to `config/{bootstrap,baseline,setup,master}/` (never root SEED_DIRS).
+`acu survey extract` hard-cuts emit to `config/{bootstrap,baseline,setup,master}/` (never root SEED_DIRS).
 
 ## Layout