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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acumatica-cli
-Version: 0.29.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 | `check` | create, then apply, then run, then diff on a fresh tenant |
-| 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 |
+| Prove a cold rebuild | `tenant create` then `apply` then `run` then `diff` | Compose on a fresh tenant. No wrap command. |
+| 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.
@@ -76,7 +76,6 @@ acu --tenant DEV apply config/           # seed config/{bootstrap,baseline,setup
 acu --tenant DEV run scenario/           # once capital → buy → build → sell
 acu --tenant DEV diff config/            # prove zero drift (exit 2 on drift)
 acu --tenant DEV state                   # capture state/ trial-balance
-acu check --yes --tenant DEV             # cold lifecycle create→apply→run→diff (leave tenant)
 ```
 
 Bare `apply` / `diff` (no path args) also prefer `config/` when those trees exist.
@@ -115,14 +114,14 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 ├── apply [--dry-run] [FILES...]      push YAML via REST (idempotent PUT upserts)
 ├── diff  [FILES...]                  drift check vs the live tenant (exit 2 on drift)
 ├── run   [--dry-run] [FILES...]      execute transaction scenario YAML (exit 1 on any miss)
-├── check [--yes] [--tenant L]        cold lifecycle create→apply→run→diff; leave tenant (V47)
 ├── 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)
 │
@@ -143,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.
@@ -170,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) |
 
@@ -200,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.
@@ -210,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.
@@ -222,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
@@ -285,7 +284,6 @@ Ad-hoc override: `acu --api-version 24.200.001 …` (version half only, never
 `base_url` resolves as `--url`, else `ACU_BASE_URL`, else a hard error naming sources.
 
 `acu config show` prints the resolved `.env` (password excluded; includes `ACU_API_VERSION`).
-`acu check` (lifecycle) uses the same resolved instance.
 
 ### Multi-host overlays (V44)
 
@@ -317,9 +315,6 @@ acu diff
 # explicit path args (no auto) — later path wins same keys
 acu apply config/ overlays/default-24.200.001/
 acu diff config/ overlays/default-24.200.001/
-
-# cold lifecycle vs the resolved .env instance (SSH + tenant required)
-acu check --yes --tenant LAB5
 ```
 
 Add a future half by creating `overlays/default-<new-half>/` with the
@@ -335,7 +330,7 @@ Worth knowing:
 - Without a `.env`, global flags plus the process environment supply the configuration.
 - When `ACU_SSH` is **absent**, acu defaults to `Administrator@` + the resolved base_url hostname.
   A **present blank** `ACU_SSH=` is the hosted opt-out.
-  Only `acu tenant` / `acu check` require a non-empty value post-default.
+  Only `acu tenant` requires a non-empty value post-default.
 - `acu config show` prints the resolved `.env` (password excluded).
 - Redirect it to turn resolved state into a working config: `acu config show > .env`.
 
@@ -383,7 +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`, push
+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.29.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 | `check` | create, then apply, then run, then diff on a fresh tenant |
-| 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 |
+| Prove a cold rebuild | `tenant create` then `apply` then `run` then `diff` | Compose on a fresh tenant. No wrap command. |
+| 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.
@@ -58,7 +58,6 @@ acu --tenant DEV apply config/           # seed config/{bootstrap,baseline,setup
 acu --tenant DEV run scenario/           # once capital → buy → build → sell
 acu --tenant DEV diff config/            # prove zero drift (exit 2 on drift)
 acu --tenant DEV state                   # capture state/ trial-balance
-acu check --yes --tenant DEV             # cold lifecycle create→apply→run→diff (leave tenant)
 ```
 
 Bare `apply` / `diff` (no path args) also prefer `config/` when those trees exist.
@@ -97,14 +96,14 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 ├── apply [--dry-run] [FILES...]      push YAML via REST (idempotent PUT upserts)
 ├── diff  [FILES...]                  drift check vs the live tenant (exit 2 on drift)
 ├── run   [--dry-run] [FILES...]      execute transaction scenario YAML (exit 1 on any miss)
-├── check [--yes] [--tenant L]        cold lifecycle create→apply→run→diff; leave tenant (V47)
 ├── 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)
 │
@@ -125,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.
@@ -152,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) |
 
@@ -182,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.
@@ -192,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.
@@ -204,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
@@ -267,7 +266,6 @@ Ad-hoc override: `acu --api-version 24.200.001 …` (version half only, never
 `base_url` resolves as `--url`, else `ACU_BASE_URL`, else a hard error naming sources.
 
 `acu config show` prints the resolved `.env` (password excluded; includes `ACU_API_VERSION`).
-`acu check` (lifecycle) uses the same resolved instance.
 
 ### Multi-host overlays (V44)
 
@@ -299,9 +297,6 @@ acu diff
 # explicit path args (no auto) — later path wins same keys
 acu apply config/ overlays/default-24.200.001/
 acu diff config/ overlays/default-24.200.001/
-
-# cold lifecycle vs the resolved .env instance (SSH + tenant required)
-acu check --yes --tenant LAB5
 ```
 
 Add a future half by creating `overlays/default-<new-half>/` with the
@@ -317,7 +312,7 @@ Worth knowing:
 - Without a `.env`, global flags plus the process environment supply the configuration.
 - When `ACU_SSH` is **absent**, acu defaults to `Administrator@` + the resolved base_url hostname.
   A **present blank** `ACU_SSH=` is the hosted opt-out.
-  Only `acu tenant` / `acu check` require a non-empty value post-default.
+  Only `acu tenant` requires a non-empty value post-default.
 - `acu config show` prints the resolved `.env` (password excluded).
 - Redirect it to turn resolved state into a working config: `acu config show > .env`.
 
@@ -365,7 +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`, push
+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.29.0 → acumatica_cli-0.31.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.29.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.29.0 → acumatica_cli-0.31.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.29.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.29.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)
@@ -55,10 +55,10 @@ COMMAND MAP (pick by intent)
   seed write   apply [--dry-run] [FILES...]              (sole mutator)
   seed check   diff [FILES...]                           (exit 2 on drift)
   txns         run [--dry-run] [FILES...]
-  cold CI      check [--tenant LOGIN]                    (!= config check)
-  pull seed    extract [--only ENTITY]...                (inverse of apply)
+  cold rebuild tenant create then apply then run then diff (no wrap cmd)
+  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
@@ -66,7 +66,6 @@ EXIT CODES (common)
   0  success
   1  operational / parse / expectation failure
   2  seed drift (diff) or state moved (state --assert-unchanged)
-  check (lifecycle) never exits 2 — drift fails the run as exit 1
 
 \b
 DEFAULT PATHS (when FILES omitted)
@@ -74,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.
@@ -674,8 +673,8 @@ def config_group() -> None:
       show           print resolved config as a complete .env (password redacted)
       check          read-only live preflight (REST + optional SSH)
 
-    Not the same as `acu check` (cold lifecycle rebuild). Start here on a
-    new machine: init → edit .env → config check → tenant create / bootstrap.
+    Start here on a new machine: init → edit .env → config check →
+    tenant create / bootstrap.
     """
 
 
@@ -721,7 +720,6 @@ def config_init(host: str | None, directory: Path | None) -> None:
     output.data("  5. acu run scenario/")
     output.data("  6. acu diff config/")
     output.data("  7. acu state")
-    output.data("  8. acu check              # cold lifecycle (SSH + tenant)")
 
 
 @config_group.command("show")
@@ -751,7 +749,7 @@ def config_check(ctx: click.Context) -> None:
     """Read-only preflight of the resolved target (ok/fail/warn/skip lines).
 
     Proves connectivity before apply/run. Writes nothing (no PUT, no tenant
-    CRUD). Not `acu check` (that is a destructive cold lifecycle rebuild).
+    CRUD).
 
     \b
     Probe order
@@ -875,192 +873,6 @@ def _probe_endpoints(endpoints: list[tuple[str, str]], inst: Instance) -> bool:
     return False
 
 
-@cli.command("check")
-@click.option(
-    "--yes",
-    is_flag=True,
-    help="Accepted for muscle-memory (pre-clean delete is always unattended)",
-)
-@click.option(
-    "--tenant",
-    "tenant_login",
-    default=None,
-    help="Tenant login for pre-clean create (else ACU_TENANT / global --tenant)",
-)
-@click.pass_context
-def check_cmd(ctx: click.Context, yes: bool, tenant_login: str | None) -> None:
-    """Cold lifecycle: delete → create → apply → run → diff (leave tenant).
-
-    Destructive rebuild for CI against the resolved .env instance. Not
-    `acu config check` (read-only preflight). Requires non-empty ACU_SSH
-    and a tenant login (--tenant / ACU_TENANT). Pre-clean delete is
-    always unattended; rebuilt tenant is left on the host for inspect /
-    state. --yes is accepted for muscle-memory only.
-
-    \b
-    Flow
-      delete tenant (if present) → create+bootstrap → apply → run → diff
-      Diff drift fails the run as exit 1 (never exit 2 from this command).
-
-    \b
-    Examples
-      acu check --tenant DEV
-      acu check --yes --tenant DEV
-
-    Prefer `config check` for "can I connect?" Prefer this for "rebuild
-    green from empty."
-    """
-    _ = yes
-    overrides: dict[str, str] = dict(ctx.obj or {})
-    tenant = _resolve_check_tenant(tenant_login, overrides)
-    try:
-        inst = load_instance({**overrides, "tenant": tenant})
-    except SystemExit as exc:
-        raise SystemExit(str(exc)) from exc
-    if not inst.ssh:
-        raise SystemExit(
-            "ACU_SSH not set (pass --ssh, or put ACU_SSH in .env or the environment)"
-        )
-    output.data(f"check {inst.base_url} (api={inst.api_version})")
-    if _run_lifecycle(inst, tenant) != 0:
-        raise SystemExit(1)
-    output.success("check: green")
-
-
-def _resolve_check_tenant(tenant_login: str | None, overrides: dict[str, str]) -> str:
-    """Tenant login from flag, global, env, or .env; hard-error if unset."""
-    tenant = tenant_login or overrides.get("tenant") or os.environ.get("ACU_TENANT")
-    if not tenant and (root := find_data_root()) is not None:
-        tenant = read_env_values(root / ".env").get("tenant") or None
-    if not tenant:
-        raise SystemExit(
-            "tenant not set (pass --tenant, "
-            "or put ACU_TENANT in .env or the environment)"
-        )
-    return tenant
-
-
-def _run_lifecycle(inst: Instance, tenant: str) -> int:
-    """pre-clean→create→apply→run→diff; leave tenant (V47); return 0 or 1."""
-    mgr = TenantManager(inst)
-    _lifecycle_delete_best_effort(mgr, tenant, label="pre-clean")
-    try:
-        _lifecycle_create_and_bootstrap(inst, mgr, tenant)
-        data_inst = inst.model_copy(update={"tenant": tenant})
-        _lifecycle_apply(data_inst)
-        _lifecycle_run(data_inst)
-        _lifecycle_diff(data_inst)
-    except SystemExit as exc:
-        code = exc.code if isinstance(exc.code, int) else 1
-        if code == 2:
-            code = 1  # V47: check never exits 2
-        output.error(f"lifecycle: {exc}")
-        # Leave tenant for manual inspect (no post-clean — V47).
-        return 1 if code != 0 else 0
-    except (RuntimeError, httpx.HTTPError) as exc:
-        output.error(f"lifecycle: {_format_failure(exc, target=inst.base_url)}")
-        # Leave tenant for manual inspect (no post-clean — V47).
-        return 1
-    output.success(
-        f"lifecycle green on {inst.base_url} tenant {tenant} (left for inspection)"
-    )
-    return 0
-
-
-def _lifecycle_create_and_bootstrap(
-    inst: Instance, mgr: TenantManager, tenant: str
-) -> None:
-    """Create (or exists-skip) tenant + init + bootstrap chain."""
-    tenants = mgr.list()
-    existing = next((t for t in tenants if t.login_name == tenant), None)
-    if existing is not None:
-        company_id = existing.company_id
-        output.data(f"skip create: tenant {tenant} exists (id {company_id})")
-    else:
-        company_id = max((t.company_id for t in tenants), default=0) + 1
-        with output.step(f"creating tenant {company_id} ({tenant}) on {inst.base_url}"):
-            mgr.create(company_id, tenant, 1, True, "")
-        output.data("created")
-    with output.step(f"aligning CompanyCD to login ({tenant})"):
-        if mgr.set_company_cd(company_id, tenant):
-            output.data(f"CompanyCD set to {tenant}")
-        else:
-            output.data(f"CompanyCD already {tenant}")
-    _init_tenant(inst, mgr, tenant)
-    _bootstrap_tenant(inst, mgr, tenant)
-
-
-def _lifecycle_delete_best_effort(
-    mgr: TenantManager, tenant: str, *, label: str
-) -> None:
-    try:
-        tenants = mgr.list()
-        if any(t.login_name == tenant for t in tenants):
-            with output.step(f"{label} delete tenant {tenant}"):
-                mgr.delete(login_name=tenant)
-            with output.step(f"recycling app pool after {label}"):
-                mgr.recycle_app_pool()
-            output.data(f"{label}: deleted {tenant}")
-        else:
-            output.data(f"{label}: tenant {tenant} absent")
-    except (RuntimeError, SystemExit) as exc:
-        output.warn(f"{label}: {exc}")
-
-
-def _lifecycle_apply(inst: Instance) -> None:
-    """Bare apply (pin overlay auto-compose); SystemExit 1 on failure."""
-    total_ok = 0
-    all_errors: list[str] = []
-    with AcumaticaClient(inst) as client:
-        for path in expand_files(default_apply_dirs(inst)):
-            baseline = seed.load_baseline(path)
-            output.data(
-                f"{path} -> {inst.tenant} on {inst.base_url} ({baseline.entity})"
-            )
-            n, errors = seed.apply(client, baseline, dry_run=False)
-            total_ok += n
-            all_errors.extend(f"{path}: {e}" for e in errors)
-            output.data(f"  {n} record(s)")
-    if all_errors:
-        output.error(f"apply: {len(all_errors)} error(s), {total_ok} record(s) applied")
-        for err in all_errors:
-            output.error(err)
-        raise SystemExit(1)
-
-
-def _lifecycle_run(inst: Instance) -> None:
-    """Bare run (pin overlay); SystemExit 1 on failure."""
-    paths = list(default_scenario_files(inst))
-    scenarios = [run.load_scenario(path) for path in paths]
-    ok = True
-    with AcumaticaClient(inst) as client:
-        for scenario in scenarios:
-            ok = run.run(client, scenario) and ok
-    if not ok:
-        raise SystemExit(1)
-    output.success(f"{len(scenarios)} scenario(s) passed on {inst.tenant}")
-
-
-def _lifecycle_diff(inst: Instance) -> None:
-    """Bare diff; SystemExit 2 on drift (caller maps to 1 for check)."""
-    paths = expand_files(default_apply_dirs(inst))
-    drifts: list[str] = []
-    with AcumaticaClient(inst) as client:
-        for path in paths:
-            baseline = seed.load_baseline(path)
-            output.data(
-                f"{path} -> {inst.tenant} on {inst.base_url} ({baseline.entity})"
-            )
-            file_drifts = seed.diff(client, baseline)
-            drifts += file_drifts
-            n = 1 if isinstance(baseline, seed.ActionFile) else len(baseline.records)
-            if file_drifts:
-                output.data(f"  {n} record(s), {len(file_drifts)} drift(s)")
-            else:
-                output.data(f"  {n} record(s) ok")
-    _exit_on_drift(inst, drifts, len(paths))
-
-
 SEED_DIRS = ("bootstrap", "baseline", "setup", "master")
 
 
@@ -1215,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] = []
@@ -1294,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] = []
@@ -1377,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",
@@ -1418,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(
@@ -1446,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),
@@ -1478,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.
@@ -1500,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",
@@ -1549,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
@@ -1628,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.29.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.29.0 → acumatica_cli-0.31.0}/src/acumatica_cli/templates/README.md

@@ -30,15 +30,14 @@ acu state
 # warm gate: once-capital only — additive buy/sell moves numeric observations
 acu run scenario/10-seed-capital.yaml && acu state --assert-unchanged
 
-# 7. Cold lifecycle (SSH + tenant)
-# acu check --yes
+# 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