acumatica-cli 0.34.0__tar.gz → 0.36.0__tar.gz

{acumatica_cli-0.34.0 → acumatica_cli-0.36.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acumatica-cli
-Version: 0.34.0
+Version: 0.36.0
 Summary: Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data
 Author: Konstantin Borovik
 Author-email: Konstantin Borovik <kb@lab5.ca>
@@ -38,18 +38,18 @@ YAML in git is the source of truth; the live tenant is the target. `apply` is th
 
 | You can | Command | Effect |
 | ------- | ------- | ------ |
-| Seed a tenant from YAML | `apply` | Idempotent PUT of `config/` into the live tenant |
+| Seed a tenant from YAML | `apply` | Idempotent PUT of `acu-config/` into the live tenant |
 | Detect drift | `diff` | Compare seed YAML to live (exit 2 when they diverge) |
-| 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) |
+| Pull live config into YAML | `survey extract` | Inverse of `apply` — GET into `acu-config/{bootstrap,baseline,setup,master}/` |
+| Run transaction scripts | `run` | Forward documents from `acu-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 | `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 |
+| 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 |
+| Scaffold a data repo | `config init` | Full `acu-config/`, `acu-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.
@@ -72,13 +72,13 @@ cd my-erp                                # edit .env: ACU_PASSWORD, ACU_TENANT
 acu config check                         # read-only preflight
 acu tenant create --login DEV            # create + bootstrap (SSH; --id optional)
 # or hosted: acu --tenant DEV bootstrap
-acu --tenant DEV apply config/           # seed config/{bootstrap,baseline,setup,master}/
-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 --tenant DEV apply acu-config        # seed acu-config/{bootstrap,baseline,setup,master}/
+acu --tenant DEV run acu-scenario        # once capital → buy → build → sell
+acu --tenant DEV diff acu-config         # prove zero drift (exit 2 on drift)
+acu --tenant DEV state acu-config/views  # capture state/ trial-balance
 ```
 
-Bare `apply` / `diff` (no path args) also prefer `config/` when those trees exist.
+apply / diff / run / state require an explicit data path.
 
 **Hosted Acumatica (no SSH):** the tenant already exists; set a blank `ACU_SSH=` in `.env`.
 The scaffold omits the key — without it, acu defaults to `Administrator@<ACU_BASE_URL host>` for SSH boxes.
@@ -88,8 +88,8 @@ acu config init --host customer.acumatica.com my-erp
 cd my-erp                                # edit .env: ACU_TENANT, ACU_PASSWORD; add ACU_SSH=
 acu config check                         # REST preflight; ssh probe is skipped
 acu --tenant DEV bootstrap               # publish AcuBootstrap via REST only
-acu --tenant DEV apply config/
-acu --tenant DEV diff config/
+acu --tenant DEV apply acu-config
+acu --tenant DEV diff acu-config
 # offline UI fallback when REST publish is blocked:
 acu bootstrap --export AcuBootstrap.zip  # import + publish on SM204505
 ```
@@ -110,43 +110,41 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 │   └── recycle [--yes]               restart site app pool (tenant map + free API slots)
 │
 ├── bootstrap [--export PATH]         publish AcuBootstrap (REST); --export = offline zip
-├── 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)
-├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
+├── 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)
+├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] <FILES...>
 │                                     capture derived state into state/ (not seed)
 ├── 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}/
+│   │                                 inverse of apply into acu-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
+│                                     inventory/ + optional --config DIR → findings/ only
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
 └── config                            configuration ops
-    ├── init [--host HOST] [DIR]      scaffold full data repo (config/, scenario/, .env)
+    ├── init [--host HOST] [DIR]      scaffold full data repo (acu-config/, acu-scenario/, .env)
     ├── show                          print the resolved config as a complete .env
     └── check                         preflight: discovery, secrets, REST, endpoints, SSH
 ```
 
-When you omit FILES:
+`apply` / `diff` / `run` / `state` require an explicit data path. Zero args print that command's help and do not call HTTP.
 
-- `apply` / `diff` prefer `config/<name>/` if any seed child exists under `config/`.
-  Otherwise they walk root `bootstrap/`, `baseline/`, `setup/`, then `master/` when present.
-  A path like `config/` expands those nested seed dirs in the same order.
-- `run` defaults to `scenario/`.
-- `state` defaults to `config/views/`; writes go to `state/` (`--out`).
+A dir with SEED_DIRS children (`bootstrap|baseline|setup|master`) expands those subdirs in that order. Typed path is used as given (`acu apply acu-config`, or `acu apply config/` if that dir exists).
+
+`--out` defaults: `state` → `state/`; `survey extract` → `acu-config/` (SEED_DIRS into that root); `survey inventory` → `inventory/`; `survey reconcile` → `findings/`; `schema` → `schemas/`.
 
 Scenario YAML may use `${current_period}` (host-local `MMyyyy`) on steps, expect params, and `once.present` params.
-`config/views` and `state` keep Period pinned.
+`acu-config/views` and `state` keep Period pinned.
 
-`survey extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
+`survey extract` writes SEED_DIRS into `--out` (default `acu-config/`).
 
 `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/`.
 
-`survey reconcile` compares `inventory/` to optional `config/` and writes `findings/` only.
+`survey reconcile` compares `inventory/` to optional `--config DIR` and writes `findings/` only.
 It never writes seed.
 
 Optional `snapshot_map.yaml` (data-repo root, or package defaults) maps DAC tables to catalog entities.
@@ -166,19 +164,52 @@ Do not confuse them with each other or with `state`:
 
 | Command | Plane | Input | Writes | Role |
 | ------- | ----- | ----- | ------ | ---- |
-| `survey extract` | REST (live) | tenant via contract API | `config/{bootstrap,baseline,setup,master}/` | Inverse of `apply` — seed YAML |
+| `survey extract` | REST (live) | tenant via contract API | `acu-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) |
+| `survey reconcile` | Offline | `inventory/` + optional `--config DIR` | `findings/` only | Cross-check gaps/deltas — never mutates seed or tenant |
+| `state` | REST (live) | `acu-config/views/` | `state/` | Derived balances/totals — not seed, not inventory |
+| `apply` | REST (live) | seed YAML under `acu-config/` | tenant | **Sole** tenant writer (keyed PUT) |
 
 `inventory/` and `findings/` are engagement outputs: not SEED_DIRS, never loaded by `apply`/`diff`, not scaffolded by `config init`.
 Binary `.adb` snapshots are rejected (XML only).
 
+### Machine-readable output (`--output json`)
+
+`acu --output json <diff|apply|run|state> ...` prints one JSON document on stdout; progress and result lines move to stderr.
+Exit codes do not change (`diff` still exits 2 on drift), and other commands ignore the flag.
+
+`diff`:
+
+```json
+{
+  "command": "diff", "tenant": "DEV", "base_url": "https://...", "drift": 1,
+  "files": [{
+    "file": "acu-config/baseline/10-uoms.yaml", "entity": "UnitsOfMeasure",
+    "records": 2,
+    "drifts": [{
+      "file": "acu-config/baseline/10-uoms.yaml", "entity": "UnitsOfMeasure",
+      "keys": {"UOM": "KG"}, "field": "Description", "kind": "changed",
+      "source": "Kilogram", "live": "kg",
+      "text": "UnitsOfMeasure [KG].Description: source='Kilogram' live='kg'"
+    }]
+  }]
+}
+```
+
+- `kind`: `changed`, `missing`, `extra` (detail row), `not_returned` or `not_applied` (setup action).
+- `field`: path below the record (e.g. `Details[A].Qty`); `""` when the record itself is missing.
+- `source` / `live`: set only for `changed`.
+
+- `apply`: `{command, tenant, mode (all|plan|changed|dry_run), ok, failed, counts, errors, stopped, not_applied, files: [{file, entity, ok, errors}]}`; `counts` keys `create`, `update`, `unchanged`, `invoke`, `put`.
+- `run`: `{command, tenant, counts: {passed, failed, skipped, not_run}, scenarios: [{file, outcome, misses, error?}], not_run}`; `misses` = failed expectation lines.
+- `state`: `{command, tenant, mode (write|diff|assert), exit, changed, views: [{view, file, rows, status (wrote|changed|unchanged), differences}]}`.
+
 ## The data repo
 
 Your configuration lives in its own git repo.
-`acu config init` scaffolds a **single full seed** under `config/` (features, company, credit terms, expanded COA, masters) plus lifecycle `scenario/`, observer `config/views/`, and README.
+`acu config init` scaffolds a **single full seed** under `acu-config/` (features, company, credit terms, expanded COA, masters) plus lifecycle `acu-scenario/`, observer `acu-config/views/`, and README.
+
+It does not write a customization tree.
 
 The Bootstrap endpoint contract is package SoT (`bootstrap_project.xml` inside the CLI — `Bootstrap/1.4.0`).
 `config init` never writes `project.xml`, and data repos must not keep one (a present file hard-errors on bootstrap/publish).
@@ -187,38 +218,36 @@ There is no `--flavor`.
 
 | Path | What it holds |
 | ---- | ------------- |
-| `config/bootstrap/` | virgin-tenant config: features, company, credit terms (no `project.xml`) |
-| `config/baseline/` | reference data: subaccounts, COA, ledger, UOMs |
-| `config/setup/` | one-time actions: financial year, master calendar, open periods |
-| `config/master/` | inventory/distribution masters: numbering (`05-…`) before prefs, warehouse, items, parties + Role/User (`90-roles` then `91-users` then `92-role-users`) |
-| `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) |
+| `acu-config/bootstrap/` | virgin-tenant config: features, company, credit terms (no `project.xml`) |
+| `acu-config/baseline/` | reference data: subaccounts, COA, ledger, UOMs |
+| `acu-config/setup/` | one-time actions: financial year, master calendar, open periods |
+| `acu-config/master/` | inventory/distribution masters: numbering (`05-…`) before prefs, warehouse, items, parties + Role/User (`90-roles` then `91-users` then `92-role-users`) |
+| `acu-scenario/` | lifecycle txns for `acu run`: once capital, then buy, build, sell |
+| `acu-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 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.
-
 Files in each directory apply alphabetically; the numbered prefixes (`10-`, `20-`, and so on) encode dependency order.
 Commit seed YAML; keep `.env` out of git (scaffold `.gitignore` already lists it).
 
 Seed YAML is state: `apply` upserts it, `diff` proves it.
-`acu survey 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 `acu-config/{bootstrap,baseline,setup,master}/` (hard-cut).
 
 Packaged `seed_catalog.yaml` is the sole extract registry (entity, endpoint, keys, file, strip/include, filter-split).
 
-Features synthesize to `config/bootstrap/features.yaml`.
+Features synthesize to `acu-config/bootstrap/features.yaml`.
 Existing files skip unless `--force`; empty live sets skip.
 
 Row failures continue (exit 1 only if any row failed).
 Drift stays with `diff`.
 
 ```sh
-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
+acu --tenant DEV survey extract --force           # refresh acu-config/** from live tenant
+git diff acu-config/                           # review extract delta before commit
+acu --tenant DEV apply acu-config             # replay extracted seed
+acu --tenant DEV diff acu-config              # expect exit 0
 ```
 ### Seed `endpoint:` symbols
 
@@ -286,7 +315,7 @@ Version fan-out is **not** long-running product branches (`acu-25r1`, `acu-26r1`
 
 | Piece | Role |
 | ----- | ---- |
-| Trunk seed | Canonical `config/` + `scenario/` (newest supported Default half) |
+| Trunk seed | Canonical `acu-config/` + `acu-scenario/` (newest supported Default half) |
 | `.env` pin | Per-checkout `ACU_BASE_URL` + `ACU_API_VERSION` |
 | Optional overlays | Surgical seed deltas keyed by Default half (e.g. `overlays/default-24.200.001/`) |
 | OpenAPI | Live `acu schema` dump only (gitignored); never multi-version swagger trees in package or data repo |
@@ -294,21 +323,15 @@ Version fan-out is **not** long-running product branches (`acu-25r1`, `acu-26r1`
 **Overlays** live under `overlays/default-<api_version>/` (scaffolded by `acu config init`).
 No `--overlay` flag.
 
-**Bare compose (pin auto):** when path args are omitted, `acu apply` / `acu diff` append overlay config seed dirs when present.
-`acu run` replaces same-basename scenario files from the pin overlay.
+Pass overlay trees as extra explicit paths when you need them.
 
 Pin = resolved `api_version` (`--api-version`, else `ACU_API_VERSION`, else code default).
-Explicit path args disable auto-compose.
 
 ```sh
-# ACU_API_VERSION=24.200.001 → uses overlays/default-24.200.001/
-acu apply
-acu run
-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/
+# ACU_API_VERSION=24.200.001 — this overlay is scenario-only
+acu apply acu-config
+acu diff acu-config
+acu run acu-scenario overlays/default-24.200.001/acu-scenario/
 ```
 
 Add a future half by creating `overlays/default-<new-half>/` with the
@@ -391,7 +414,7 @@ Per-bug contract probes fold onto those tenants.
 Each run scaffolds a synthetic single-org company from the packaged `acu config init` templates into a temporary directory, copies the real `.env` into it, and runs the installed `acu` binary from there — no data repo, no pre-existing fixtures on the instance.
 
 Scratch tenants (`E2E`, `E2EA`, `E2EB`, `E2ESCEN`) are created on the way in and always deleted on the way out, so nothing persists.
-The packaged full `config init` seed (under `config/`) is the only scaffold.
+The packaged full `config init` seed (under `acu-config/`) is the only scaffold.
 
 ```sh
 gmake e2e                                # whole tier, three files
@@ -402,7 +425,7 @@ gmake e2e FILE=test_extract_roundtrip    # extract inverse
 
 ### CLI test-seed soak
 
-This checkout carries a CLI test seed at repo-root `config/` and `scenario/` (no `config/qms/`).
+This checkout carries a CLI test seed at repo-root `acu-config/` and `acu-scenario/` (no customization YAML under `acu-config/`).
 Soak the live CLI tenant from here with `--tenant ACUCLI`.
 
 Never use tenant `CNBN`. Never `cd` the sibling GitOps repo for CLI soak.
@@ -411,10 +434,10 @@ Never use tenant `CNBN`. Never `cd` the sibling GitOps repo for CLI soak.
 That path is not the soak.
 
 ```sh
-uv run acu --tenant ACUCLI apply
-uv run acu --tenant ACUCLI run
-uv run acu --tenant ACUCLI diff
-uv run acu --tenant ACUCLI state
+uv run acu --tenant ACUCLI apply acu-config
+uv run acu --tenant ACUCLI run acu-scenario
+uv run acu --tenant ACUCLI diff acu-config
+uv run acu --tenant ACUCLI state acu-config/views
 ```
 
 ## License

{acumatica_cli-0.34.0 → acumatica_cli-0.36.0}/README.md

@@ -20,18 +20,18 @@ YAML in git is the source of truth; the live tenant is the target. `apply` is th
 
 | You can | Command | Effect |
 | ------- | ------- | ------ |
-| Seed a tenant from YAML | `apply` | Idempotent PUT of `config/` into the live tenant |
+| Seed a tenant from YAML | `apply` | Idempotent PUT of `acu-config/` into the live tenant |
 | Detect drift | `diff` | Compare seed YAML to live (exit 2 when they diverge) |
-| 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) |
+| Pull live config into YAML | `survey extract` | Inverse of `apply` — GET into `acu-config/{bootstrap,baseline,setup,master}/` |
+| Run transaction scripts | `run` | Forward documents from `acu-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 | `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 |
+| 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 |
+| Scaffold a data repo | `config init` | Full `acu-config/`, `acu-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.
@@ -54,13 +54,13 @@ cd my-erp                                # edit .env: ACU_PASSWORD, ACU_TENANT
 acu config check                         # read-only preflight
 acu tenant create --login DEV            # create + bootstrap (SSH; --id optional)
 # or hosted: acu --tenant DEV bootstrap
-acu --tenant DEV apply config/           # seed config/{bootstrap,baseline,setup,master}/
-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 --tenant DEV apply acu-config        # seed acu-config/{bootstrap,baseline,setup,master}/
+acu --tenant DEV run acu-scenario        # once capital → buy → build → sell
+acu --tenant DEV diff acu-config         # prove zero drift (exit 2 on drift)
+acu --tenant DEV state acu-config/views  # capture state/ trial-balance
 ```
 
-Bare `apply` / `diff` (no path args) also prefer `config/` when those trees exist.
+apply / diff / run / state require an explicit data path.
 
 **Hosted Acumatica (no SSH):** the tenant already exists; set a blank `ACU_SSH=` in `.env`.
 The scaffold omits the key — without it, acu defaults to `Administrator@<ACU_BASE_URL host>` for SSH boxes.
@@ -70,8 +70,8 @@ acu config init --host customer.acumatica.com my-erp
 cd my-erp                                # edit .env: ACU_TENANT, ACU_PASSWORD; add ACU_SSH=
 acu config check                         # REST preflight; ssh probe is skipped
 acu --tenant DEV bootstrap               # publish AcuBootstrap via REST only
-acu --tenant DEV apply config/
-acu --tenant DEV diff config/
+acu --tenant DEV apply acu-config
+acu --tenant DEV diff acu-config
 # offline UI fallback when REST publish is blocked:
 acu bootstrap --export AcuBootstrap.zip  # import + publish on SM204505
 ```
@@ -92,43 +92,41 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 │   └── recycle [--yes]               restart site app pool (tenant map + free API slots)
 │
 ├── bootstrap [--export PATH]         publish AcuBootstrap (REST); --export = offline zip
-├── 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)
-├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
+├── 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)
+├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] <FILES...>
 │                                     capture derived state into state/ (not seed)
 ├── 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}/
+│   │                                 inverse of apply into acu-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
+│                                     inventory/ + optional --config DIR → findings/ only
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
 └── config                            configuration ops
-    ├── init [--host HOST] [DIR]      scaffold full data repo (config/, scenario/, .env)
+    ├── init [--host HOST] [DIR]      scaffold full data repo (acu-config/, acu-scenario/, .env)
     ├── show                          print the resolved config as a complete .env
     └── check                         preflight: discovery, secrets, REST, endpoints, SSH
 ```
 
-When you omit FILES:
+`apply` / `diff` / `run` / `state` require an explicit data path. Zero args print that command's help and do not call HTTP.
 
-- `apply` / `diff` prefer `config/<name>/` if any seed child exists under `config/`.
-  Otherwise they walk root `bootstrap/`, `baseline/`, `setup/`, then `master/` when present.
-  A path like `config/` expands those nested seed dirs in the same order.
-- `run` defaults to `scenario/`.
-- `state` defaults to `config/views/`; writes go to `state/` (`--out`).
+A dir with SEED_DIRS children (`bootstrap|baseline|setup|master`) expands those subdirs in that order. Typed path is used as given (`acu apply acu-config`, or `acu apply config/` if that dir exists).
+
+`--out` defaults: `state` → `state/`; `survey extract` → `acu-config/` (SEED_DIRS into that root); `survey inventory` → `inventory/`; `survey reconcile` → `findings/`; `schema` → `schemas/`.
 
 Scenario YAML may use `${current_period}` (host-local `MMyyyy`) on steps, expect params, and `once.present` params.
-`config/views` and `state` keep Period pinned.
+`acu-config/views` and `state` keep Period pinned.
 
-`survey extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
+`survey extract` writes SEED_DIRS into `--out` (default `acu-config/`).
 
 `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/`.
 
-`survey reconcile` compares `inventory/` to optional `config/` and writes `findings/` only.
+`survey reconcile` compares `inventory/` to optional `--config DIR` and writes `findings/` only.
 It never writes seed.
 
 Optional `snapshot_map.yaml` (data-repo root, or package defaults) maps DAC tables to catalog entities.
@@ -148,19 +146,52 @@ Do not confuse them with each other or with `state`:
 
 | Command | Plane | Input | Writes | Role |
 | ------- | ----- | ----- | ------ | ---- |
-| `survey extract` | REST (live) | tenant via contract API | `config/{bootstrap,baseline,setup,master}/` | Inverse of `apply` — seed YAML |
+| `survey extract` | REST (live) | tenant via contract API | `acu-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) |
+| `survey reconcile` | Offline | `inventory/` + optional `--config DIR` | `findings/` only | Cross-check gaps/deltas — never mutates seed or tenant |
+| `state` | REST (live) | `acu-config/views/` | `state/` | Derived balances/totals — not seed, not inventory |
+| `apply` | REST (live) | seed YAML under `acu-config/` | tenant | **Sole** tenant writer (keyed PUT) |
 
 `inventory/` and `findings/` are engagement outputs: not SEED_DIRS, never loaded by `apply`/`diff`, not scaffolded by `config init`.
 Binary `.adb` snapshots are rejected (XML only).
 
+### Machine-readable output (`--output json`)
+
+`acu --output json <diff|apply|run|state> ...` prints one JSON document on stdout; progress and result lines move to stderr.
+Exit codes do not change (`diff` still exits 2 on drift), and other commands ignore the flag.
+
+`diff`:
+
+```json
+{
+  "command": "diff", "tenant": "DEV", "base_url": "https://...", "drift": 1,
+  "files": [{
+    "file": "acu-config/baseline/10-uoms.yaml", "entity": "UnitsOfMeasure",
+    "records": 2,
+    "drifts": [{
+      "file": "acu-config/baseline/10-uoms.yaml", "entity": "UnitsOfMeasure",
+      "keys": {"UOM": "KG"}, "field": "Description", "kind": "changed",
+      "source": "Kilogram", "live": "kg",
+      "text": "UnitsOfMeasure [KG].Description: source='Kilogram' live='kg'"
+    }]
+  }]
+}
+```
+
+- `kind`: `changed`, `missing`, `extra` (detail row), `not_returned` or `not_applied` (setup action).
+- `field`: path below the record (e.g. `Details[A].Qty`); `""` when the record itself is missing.
+- `source` / `live`: set only for `changed`.
+
+- `apply`: `{command, tenant, mode (all|plan|changed|dry_run), ok, failed, counts, errors, stopped, not_applied, files: [{file, entity, ok, errors}]}`; `counts` keys `create`, `update`, `unchanged`, `invoke`, `put`.
+- `run`: `{command, tenant, counts: {passed, failed, skipped, not_run}, scenarios: [{file, outcome, misses, error?}], not_run}`; `misses` = failed expectation lines.
+- `state`: `{command, tenant, mode (write|diff|assert), exit, changed, views: [{view, file, rows, status (wrote|changed|unchanged), differences}]}`.
+
 ## The data repo
 
 Your configuration lives in its own git repo.
-`acu config init` scaffolds a **single full seed** under `config/` (features, company, credit terms, expanded COA, masters) plus lifecycle `scenario/`, observer `config/views/`, and README.
+`acu config init` scaffolds a **single full seed** under `acu-config/` (features, company, credit terms, expanded COA, masters) plus lifecycle `acu-scenario/`, observer `acu-config/views/`, and README.
+
+It does not write a customization tree.
 
 The Bootstrap endpoint contract is package SoT (`bootstrap_project.xml` inside the CLI — `Bootstrap/1.4.0`).
 `config init` never writes `project.xml`, and data repos must not keep one (a present file hard-errors on bootstrap/publish).
@@ -169,38 +200,36 @@ There is no `--flavor`.
 
 | Path | What it holds |
 | ---- | ------------- |
-| `config/bootstrap/` | virgin-tenant config: features, company, credit terms (no `project.xml`) |
-| `config/baseline/` | reference data: subaccounts, COA, ledger, UOMs |
-| `config/setup/` | one-time actions: financial year, master calendar, open periods |
-| `config/master/` | inventory/distribution masters: numbering (`05-…`) before prefs, warehouse, items, parties + Role/User (`90-roles` then `91-users` then `92-role-users`) |
-| `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) |
+| `acu-config/bootstrap/` | virgin-tenant config: features, company, credit terms (no `project.xml`) |
+| `acu-config/baseline/` | reference data: subaccounts, COA, ledger, UOMs |
+| `acu-config/setup/` | one-time actions: financial year, master calendar, open periods |
+| `acu-config/master/` | inventory/distribution masters: numbering (`05-…`) before prefs, warehouse, items, parties + Role/User (`90-roles` then `91-users` then `92-role-users`) |
+| `acu-scenario/` | lifecycle txns for `acu run`: once capital, then buy, build, sell |
+| `acu-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 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.
-
 Files in each directory apply alphabetically; the numbered prefixes (`10-`, `20-`, and so on) encode dependency order.
 Commit seed YAML; keep `.env` out of git (scaffold `.gitignore` already lists it).
 
 Seed YAML is state: `apply` upserts it, `diff` proves it.
-`acu survey 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 `acu-config/{bootstrap,baseline,setup,master}/` (hard-cut).
 
 Packaged `seed_catalog.yaml` is the sole extract registry (entity, endpoint, keys, file, strip/include, filter-split).
 
-Features synthesize to `config/bootstrap/features.yaml`.
+Features synthesize to `acu-config/bootstrap/features.yaml`.
 Existing files skip unless `--force`; empty live sets skip.
 
 Row failures continue (exit 1 only if any row failed).
 Drift stays with `diff`.
 
 ```sh
-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
+acu --tenant DEV survey extract --force           # refresh acu-config/** from live tenant
+git diff acu-config/                           # review extract delta before commit
+acu --tenant DEV apply acu-config             # replay extracted seed
+acu --tenant DEV diff acu-config              # expect exit 0
 ```
 ### Seed `endpoint:` symbols
 
@@ -268,7 +297,7 @@ Version fan-out is **not** long-running product branches (`acu-25r1`, `acu-26r1`
 
 | Piece | Role |
 | ----- | ---- |
-| Trunk seed | Canonical `config/` + `scenario/` (newest supported Default half) |
+| Trunk seed | Canonical `acu-config/` + `acu-scenario/` (newest supported Default half) |
 | `.env` pin | Per-checkout `ACU_BASE_URL` + `ACU_API_VERSION` |
 | Optional overlays | Surgical seed deltas keyed by Default half (e.g. `overlays/default-24.200.001/`) |
 | OpenAPI | Live `acu schema` dump only (gitignored); never multi-version swagger trees in package or data repo |
@@ -276,21 +305,15 @@ Version fan-out is **not** long-running product branches (`acu-25r1`, `acu-26r1`
 **Overlays** live under `overlays/default-<api_version>/` (scaffolded by `acu config init`).
 No `--overlay` flag.
 
-**Bare compose (pin auto):** when path args are omitted, `acu apply` / `acu diff` append overlay config seed dirs when present.
-`acu run` replaces same-basename scenario files from the pin overlay.
+Pass overlay trees as extra explicit paths when you need them.
 
 Pin = resolved `api_version` (`--api-version`, else `ACU_API_VERSION`, else code default).
-Explicit path args disable auto-compose.
 
 ```sh
-# ACU_API_VERSION=24.200.001 → uses overlays/default-24.200.001/
-acu apply
-acu run
-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/
+# ACU_API_VERSION=24.200.001 — this overlay is scenario-only
+acu apply acu-config
+acu diff acu-config
+acu run acu-scenario overlays/default-24.200.001/acu-scenario/
 ```
 
 Add a future half by creating `overlays/default-<new-half>/` with the
@@ -373,7 +396,7 @@ Per-bug contract probes fold onto those tenants.
 Each run scaffolds a synthetic single-org company from the packaged `acu config init` templates into a temporary directory, copies the real `.env` into it, and runs the installed `acu` binary from there — no data repo, no pre-existing fixtures on the instance.
 
 Scratch tenants (`E2E`, `E2EA`, `E2EB`, `E2ESCEN`) are created on the way in and always deleted on the way out, so nothing persists.
-The packaged full `config init` seed (under `config/`) is the only scaffold.
+The packaged full `config init` seed (under `acu-config/`) is the only scaffold.
 
 ```sh
 gmake e2e                                # whole tier, three files
@@ -384,7 +407,7 @@ gmake e2e FILE=test_extract_roundtrip    # extract inverse
 
 ### CLI test-seed soak
 
-This checkout carries a CLI test seed at repo-root `config/` and `scenario/` (no `config/qms/`).
+This checkout carries a CLI test seed at repo-root `acu-config/` and `acu-scenario/` (no customization YAML under `acu-config/`).
 Soak the live CLI tenant from here with `--tenant ACUCLI`.
 
 Never use tenant `CNBN`. Never `cd` the sibling GitOps repo for CLI soak.
@@ -393,10 +416,10 @@ Never use tenant `CNBN`. Never `cd` the sibling GitOps repo for CLI soak.
 That path is not the soak.
 
 ```sh
-uv run acu --tenant ACUCLI apply
-uv run acu --tenant ACUCLI run
-uv run acu --tenant ACUCLI diff
-uv run acu --tenant ACUCLI state
+uv run acu --tenant ACUCLI apply acu-config
+uv run acu --tenant ACUCLI run acu-scenario
+uv run acu --tenant ACUCLI diff acu-config
+uv run acu --tenant ACUCLI state acu-config/views
 ```
 
 ## License

{acumatica_cli-0.34.0 → acumatica_cli-0.36.0}/pyproject.toml

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

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.34.0"
+version = "0.36.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"