acumatica-cli 0.33.1__tar.gz → 0.35.0__tar.gz

{acumatica_cli-0.33.1 → acumatica_cli-0.35.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acumatica-cli
-Version: 0.33.1
+Version: 0.35.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,14 +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.
-See [docs/demo-seed.md](docs/demo-seed.md) for the entity map, once-guard, apply-order notes, NumberingSequence vs prefs `*NumberingID`, curated *Preferences field depth (V41), and Role/User + password seed rules.
+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.
@@ -89,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
 ```
@@ -111,50 +110,46 @@ 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 — see [docs/demo-seed.md](docs/demo-seed.md#period-token-current_period-vs-pinned-views).
+`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.
 It normalizes the join: pad-trim, key/field aliases, Account/Sub FK CD resolve, enum label to code.
 
-See [docs/demo-seed.md](docs/demo-seed.md).
-
 `acu --completion` emits a completion script for bash, zsh, or fish — source it from your shell profile.
 
 Run `acu --help` for the full mental model (workflow, planes, exit codes, command map).
@@ -169,21 +164,21 @@ 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).
 
-See [docs/ac-exe.md](docs/ac-exe.md) for export / SM203520 notes and [docs/demo-seed.md](docs/demo-seed.md) for the extract/state/inventory map.
-
 ## 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).
@@ -192,39 +187,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).
-The demo entity map in [docs/demo-seed.md](docs/demo-seed.md) mirrors those catalog paths.
 
-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 +260,7 @@ Secrets, REST where, and the Default contract pin live in one `.env` file (`ACU_
 Leftover `matrix.yaml` is ignored and never loaded.
 
 ```sh
-ACU_BASE_URL=http://acu-dev1.vm.internal/AcumaticaERP   # REST where (required)
+ACU_BASE_URL=http://erp.example.com/AcumaticaERP        # REST where (required)
 ACU_API_VERSION=25.200.001                              # Default contract half
 ACU_TENANT=LAB5                                         # sign-in name of the tenant API sessions use
 # ACU_SSH omitted → defaults to Administrator@ + resolved base_url host
@@ -292,7 +284,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 |
@@ -300,21 +292,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,16 +377,36 @@ GitHub Actions on tag `v*` re-runs CI, builds sdist+wheel, publishes to PyPI via
 Configuration is one file: a decrypted `.env` at the repo root names the instance — `ACU_BASE_URL`, `ACU_TENANT`, `ACU_PASSWORD` (and optional `ACU_SSH`; omitted defaults to `Administrator@` + base-url host).
 `gmake e2e` refuses to start without it.
 
-The tier is self-contained.
+The tier is three pipeline files: provision (apply/diff), scenario (run/state), and extract round-trip.
+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
+gmake e2e FILE=test_provision_lifecycle  # apply/diff + folded probes
+gmake e2e FILE=test_scenario_lifecycle   # scenario + state + kit alloc
+gmake e2e FILE=test_extract_roundtrip    # extract inverse
+```
+
+### CLI test-seed soak
+
+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.
+
+`gmake e2e` still scaffolds from packaged `config init` templates into a tmp dir.
+That path is not the soak.
 
 ```sh
-gmake e2e                                # whole tier, about 20 minutes
-gmake e2e FILE=test_provision_lifecycle  # apply/diff focus
-gmake e2e FILE=test_scenario_lifecycle   # scenario + state focus
+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.33.1 → acumatica_cli-0.35.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,14 +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.
-See [docs/demo-seed.md](docs/demo-seed.md) for the entity map, once-guard, apply-order notes, NumberingSequence vs prefs `*NumberingID`, curated *Preferences field depth (V41), and Role/User + password seed rules.
+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.
@@ -71,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
 ```
@@ -93,50 +92,46 @@ 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 — see [docs/demo-seed.md](docs/demo-seed.md#period-token-current_period-vs-pinned-views).
+`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.
 It normalizes the join: pad-trim, key/field aliases, Account/Sub FK CD resolve, enum label to code.
 
-See [docs/demo-seed.md](docs/demo-seed.md).
-
 `acu --completion` emits a completion script for bash, zsh, or fish — source it from your shell profile.
 
 Run `acu --help` for the full mental model (workflow, planes, exit codes, command map).
@@ -151,21 +146,21 @@ 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).
 
-See [docs/ac-exe.md](docs/ac-exe.md) for export / SM203520 notes and [docs/demo-seed.md](docs/demo-seed.md) for the extract/state/inventory map.
-
 ## 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).
@@ -174,39 +169,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).
-The demo entity map in [docs/demo-seed.md](docs/demo-seed.md) mirrors those catalog paths.
 
-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
 
@@ -250,7 +242,7 @@ Secrets, REST where, and the Default contract pin live in one `.env` file (`ACU_
 Leftover `matrix.yaml` is ignored and never loaded.
 
 ```sh
-ACU_BASE_URL=http://acu-dev1.vm.internal/AcumaticaERP   # REST where (required)
+ACU_BASE_URL=http://erp.example.com/AcumaticaERP        # REST where (required)
 ACU_API_VERSION=25.200.001                              # Default contract half
 ACU_TENANT=LAB5                                         # sign-in name of the tenant API sessions use
 # ACU_SSH omitted → defaults to Administrator@ + resolved base_url host
@@ -274,7 +266,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 |
@@ -282,21 +274,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,16 +359,36 @@ GitHub Actions on tag `v*` re-runs CI, builds sdist+wheel, publishes to PyPI via
 Configuration is one file: a decrypted `.env` at the repo root names the instance — `ACU_BASE_URL`, `ACU_TENANT`, `ACU_PASSWORD` (and optional `ACU_SSH`; omitted defaults to `Administrator@` + base-url host).
 `gmake e2e` refuses to start without it.
 
-The tier is self-contained.
+The tier is three pipeline files: provision (apply/diff), scenario (run/state), and extract round-trip.
+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
+gmake e2e FILE=test_provision_lifecycle  # apply/diff + folded probes
+gmake e2e FILE=test_scenario_lifecycle   # scenario + state + kit alloc
+gmake e2e FILE=test_extract_roundtrip    # extract inverse
+```
+
+### CLI test-seed soak
+
+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.
+
+`gmake e2e` still scaffolds from packaged `config init` templates into a tmp dir.
+That path is not the soak.
 
 ```sh
-gmake e2e                                # whole tier, about 20 minutes
-gmake e2e FILE=test_provision_lifecycle  # apply/diff focus
-gmake e2e FILE=test_scenario_lifecycle   # scenario + state focus
+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.33.1 → acumatica_cli-0.35.0}/pyproject.toml

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

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