acumatica-cli 0.13.1__tar.gz → 0.14.0__tar.gz

{acumatica_cli-0.13.1 → acumatica_cli-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acumatica-cli
-Version: 0.13.1
+Version: 0.14.0
 Summary: Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data
 Author: Konstantin Borovik
 Author-email: Konstantin Borovik <kb@lab5.ca>
@@ -48,7 +48,7 @@ acu tenant create --id 3 --login DEV     # create the tenant + bootstrap it (nee
 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 snapshot                # capture state/ trial-balance
+acu --tenant DEV state                   # capture state/ trial-balance
 # warm: capital once-skips; Owner Capital stays 50000 (not 100000)
 acu --tenant DEV run scenario/
 ```
@@ -85,7 +85,7 @@ 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)
-├── snapshot [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
+├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
 │                                     capture derived state into state/ (not seed)
 ├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
 │                                     dump live tenant state as seed YAML (inverse of apply)
@@ -100,14 +100,14 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 `apply` and `diff` without FILES prefer `config/<name>/` when any seed child exists under `config/`; otherwise root `bootstrap/`, `baseline/`, `setup/`, then `master/` when present.
 A path like `config/` expands nested seed dirs in that fixed order.
 `run` without FILES defaults to `scenario/`.
-`snapshot` without FILES defaults to `config/snapshot/`; writes go to `state/` (`--out`).
+`state` without FILES defaults to `config/views/`; writes go to `state/` (`--out`).
 `acu --completion` emits a completion script for bash, zsh, or fish — source it from your shell profile.
 Run `acu <command> --help` for details on any command.
 
 ## The data repo
 
 Your configuration lives in its own git repo.
-`acu config init` scaffolds a **single full seed** under `config/` (Bootstrap `project.xml` at `Bootstrap/1.0.0`, expanded COA, masters) plus lifecycle `scenario/`, observer `config/snapshot/`, and README. There is no `--flavor`.
+`acu config init` scaffolds a **single full seed** under `config/` (Bootstrap `project.xml` at `Bootstrap/1.0.0`, expanded COA, masters) plus lifecycle `scenario/`, observer `config/views/`, and README. There is no `--flavor`.
 
 | Path | What it holds |
 | ---- | ------------- |
@@ -116,7 +116,7 @@ Your configuration lives in its own git repo.
 | `config/setup/` | one-time actions: financial year, master calendar, open periods |
 | `config/master/` | inventory/distribution masters (prefs, warehouse, items, parties) |
 | `scenario/` | lifecycle txns for `acu run`: once capital, then buy, build, sell |
-| `config/snapshot/` | observer views for `acu snapshot` (`inquire:` / `entity:` / `gi:`; not SEED_DIRS) |
+| `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) |
 | `target.yaml` | committed verified matrix: `erp` + `default_api` (what, not where) |
 | `.env` | where to apply and who signs in, every key an `ACU_*` variable |
@@ -132,9 +132,9 @@ Scenario YAML is different — it describes transactions that flow forward.
 `acu run` executes each step in order (`put`, `action`, `wait`, `get`), captures server-assigned document numbers into `${var}` references for later steps, and checks `expect:` assertions as deltas against a pre-run snapshot, so additive scenarios re-run safely on a warm tenant.
 `once: true` scenarios declare a `present` inquire-absolute gate; when the probe already holds, the CLI prints `skip <path> (once: already present)` and runs neither steps nor expects (Owner Capital does not restack).
 
-`acu snapshot` is the third observation path: it captures live derived state (balances) into `state/` for git review. It is not `extract` (config seed) and not `diff` (desired vs actual config). Packaged golden is trial-balance via contract `inquire:` (`EndingBalance` fixed-point); inventory-summary is not golden this pass. `gi:` stays optional when a GI is V12-verified and **Expose via OData** is on (`params` fail-closed vs `$metadata`). After a cold `acu run scenario/ && acu snapshot`, warm `acu run scenario/10-seed-capital.yaml && acu snapshot --assert-unchanged` is the once-class gate (full scenario re-run is additive and moves cash observations on the TB).
+`acu state` is the third observation path: it captures live derived state (balances) into `state/` for git review. It is not `extract` (config seed) and not `diff` (desired vs actual config). Packaged golden is trial-balance via contract `inquire:` (`EndingBalance` fixed-point); inventory-summary is not golden this pass. `gi:` stays optional when a GI is V12-verified and **Expose via OData** is on (`params` fail-closed vs `$metadata`). After a cold `acu run scenario/ && acu state`, warm `acu run scenario/10-seed-capital.yaml && acu state --assert-unchanged` is the once-class gate (full scenario re-run is additive and moves cash observations on the TB).
 
-**Migration (path hard-cut):** bare defaults are `config/snapshot/` (views) and `state/` (observations). Root `snapshot/` and `snapshots/` are no longer defaulted — move files or pass explicit path args.
+**Migration (T112–T114 hard-cut):** CLI verb is `state` only (no `snapshot` alias). Bare defaults are `config/views/` (views) and `state/` (observations). Prior `config/snapshot/` and root `snapshot/` / `snapshots/` are not fallbacks — move views to `config/views/` or pass explicit path args.
 
 ### Seed `endpoint:` symbols
 
@@ -308,7 +308,7 @@ The packaged full `config init` seed (under `config/`) is the only scaffold.
 ```sh
 gmake e2e                                # whole tier, about 20 minutes
 gmake e2e FILE=test_provision_lifecycle  # apply/diff focus
-gmake e2e FILE=test_scenario_lifecycle   # scenario + snapshot focus
+gmake e2e FILE=test_scenario_lifecycle   # scenario + state focus
 ```
 
 ## License

{acumatica_cli-0.13.1 → acumatica_cli-0.14.0}/README.md

@@ -30,7 +30,7 @@ acu tenant create --id 3 --login DEV     # create the tenant + bootstrap it (nee
 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 snapshot                # capture state/ trial-balance
+acu --tenant DEV state                   # capture state/ trial-balance
 # warm: capital once-skips; Owner Capital stays 50000 (not 100000)
 acu --tenant DEV run scenario/
 ```
@@ -67,7 +67,7 @@ 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)
-├── snapshot [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
+├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
 │                                     capture derived state into state/ (not seed)
 ├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
 │                                     dump live tenant state as seed YAML (inverse of apply)
@@ -82,14 +82,14 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 `apply` and `diff` without FILES prefer `config/<name>/` when any seed child exists under `config/`; otherwise root `bootstrap/`, `baseline/`, `setup/`, then `master/` when present.
 A path like `config/` expands nested seed dirs in that fixed order.
 `run` without FILES defaults to `scenario/`.
-`snapshot` without FILES defaults to `config/snapshot/`; writes go to `state/` (`--out`).
+`state` without FILES defaults to `config/views/`; writes go to `state/` (`--out`).
 `acu --completion` emits a completion script for bash, zsh, or fish — source it from your shell profile.
 Run `acu <command> --help` for details on any command.
 
 ## The data repo
 
 Your configuration lives in its own git repo.
-`acu config init` scaffolds a **single full seed** under `config/` (Bootstrap `project.xml` at `Bootstrap/1.0.0`, expanded COA, masters) plus lifecycle `scenario/`, observer `config/snapshot/`, and README. There is no `--flavor`.
+`acu config init` scaffolds a **single full seed** under `config/` (Bootstrap `project.xml` at `Bootstrap/1.0.0`, expanded COA, masters) plus lifecycle `scenario/`, observer `config/views/`, and README. There is no `--flavor`.
 
 | Path | What it holds |
 | ---- | ------------- |
@@ -98,7 +98,7 @@ Your configuration lives in its own git repo.
 | `config/setup/` | one-time actions: financial year, master calendar, open periods |
 | `config/master/` | inventory/distribution masters (prefs, warehouse, items, parties) |
 | `scenario/` | lifecycle txns for `acu run`: once capital, then buy, build, sell |
-| `config/snapshot/` | observer views for `acu snapshot` (`inquire:` / `entity:` / `gi:`; not SEED_DIRS) |
+| `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) |
 | `target.yaml` | committed verified matrix: `erp` + `default_api` (what, not where) |
 | `.env` | where to apply and who signs in, every key an `ACU_*` variable |
@@ -114,9 +114,9 @@ Scenario YAML is different — it describes transactions that flow forward.
 `acu run` executes each step in order (`put`, `action`, `wait`, `get`), captures server-assigned document numbers into `${var}` references for later steps, and checks `expect:` assertions as deltas against a pre-run snapshot, so additive scenarios re-run safely on a warm tenant.
 `once: true` scenarios declare a `present` inquire-absolute gate; when the probe already holds, the CLI prints `skip <path> (once: already present)` and runs neither steps nor expects (Owner Capital does not restack).
 
-`acu snapshot` is the third observation path: it captures live derived state (balances) into `state/` for git review. It is not `extract` (config seed) and not `diff` (desired vs actual config). Packaged golden is trial-balance via contract `inquire:` (`EndingBalance` fixed-point); inventory-summary is not golden this pass. `gi:` stays optional when a GI is V12-verified and **Expose via OData** is on (`params` fail-closed vs `$metadata`). After a cold `acu run scenario/ && acu snapshot`, warm `acu run scenario/10-seed-capital.yaml && acu snapshot --assert-unchanged` is the once-class gate (full scenario re-run is additive and moves cash observations on the TB).
+`acu state` is the third observation path: it captures live derived state (balances) into `state/` for git review. It is not `extract` (config seed) and not `diff` (desired vs actual config). Packaged golden is trial-balance via contract `inquire:` (`EndingBalance` fixed-point); inventory-summary is not golden this pass. `gi:` stays optional when a GI is V12-verified and **Expose via OData** is on (`params` fail-closed vs `$metadata`). After a cold `acu run scenario/ && acu state`, warm `acu run scenario/10-seed-capital.yaml && acu state --assert-unchanged` is the once-class gate (full scenario re-run is additive and moves cash observations on the TB).
 
-**Migration (path hard-cut):** bare defaults are `config/snapshot/` (views) and `state/` (observations). Root `snapshot/` and `snapshots/` are no longer defaulted — move files or pass explicit path args.
+**Migration (T112–T114 hard-cut):** CLI verb is `state` only (no `snapshot` alias). Bare defaults are `config/views/` (views) and `state/` (observations). Prior `config/snapshot/` and root `snapshot/` / `snapshots/` are not fallbacks — move views to `config/views/` or pass explicit path args.
 
 ### Seed `endpoint:` symbols
 
@@ -290,7 +290,7 @@ The packaged full `config init` seed (under `config/`) is the only scaffold.
 ```sh
 gmake e2e                                # whole tier, about 20 minutes
 gmake e2e FILE=test_provision_lifecycle  # apply/diff focus
-gmake e2e FILE=test_scenario_lifecycle   # scenario + snapshot focus
+gmake e2e FILE=test_scenario_lifecycle   # scenario + state focus
 ```
 
 ## License

{acumatica_cli-0.13.1 → acumatica_cli-0.14.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.13.1"
+version = "0.14.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.13.1 → acumatica_cli-0.14.0}/src/acumatica_cli/cli.py

@@ -12,7 +12,7 @@ import click
 import httpx
 from click.shell_completion import get_completion_class
 
-from . import bootstrap, extract, firstlogin, output, run, seed, snapshot
+from . import bootstrap, extract, firstlogin, output, run, seed, state
 from .client import AcumaticaClient
 from .config import (
     Instance,
@@ -419,7 +419,7 @@ def config_init(host: str | None, directory: Path | None) -> None:
     Templates ship with the package; every value is a placeholder or a
     verified example - no secrets. Single full seed under ``config/``
     (bootstrap/baseline/setup/master) + lifecycle ``scenario/`` +
-    ``config/snapshot/`` + README; full company ``project.xml``
+    ``config/views/`` + README; full company ``project.xml``
     (Bootstrap/1.0.0). No ``--flavor`` (V28/T108). Existing files are
     never overwritten (reported as skipped). DIRECTORY defaults to the
     current directory and is created if absent. No git init, no gpg.
@@ -437,6 +437,7 @@ def config_init(host: str | None, directory: Path | None) -> None:
     output.data("  4. acu apply config/")
     output.data("  5. acu run scenario/")
     output.data("  6. acu diff config/")
+    output.data("  7. acu state")
 
 
 @config_group.command("show")
@@ -935,7 +936,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("snapshot")
+@cli.command("state")
 @click.argument(
     "files", nargs=-1, required=False, type=click.Path(exists=True, path_type=Path)
 )
@@ -963,7 +964,7 @@ def _exit_on_drift(inst: Instance, drifts: list[str], files: int) -> None:
     help="Resolve views and validate sources without HTTP",
 )
 @pass_instance
-def snapshot_cmd(
+def state_cmd(
     inst: Instance,
     files: tuple[Path, ...],
     out_dir: Path | None,
@@ -973,39 +974,36 @@ def snapshot_cmd(
 ) -> None:
     """Capture live derived state into committed observation files.
 
-    FILES are snapshot view YAML files or directories. Omitted, they default
-    to the data repo's config/snapshot/ directory (hard-cut; no root
-    snapshot/ fallback). Default write target is state/ (--out; no
-    snapshots/ fallback). Bare capture writes observations (change is
-    fine). --diff compares live to disk without writing.
-    --assert-unchanged is the warm-run idempotence gate (exit 2 when
-    moved). Never writes seed trees or endpoint: symbols (V32). Exit 0
+    FILES are view YAML files or directories. Omitted, they default to the
+    data repo's config/views/ directory (hard-cut; no config/snapshot/
+    fallback). Default write target is state/ (--out). Bare capture writes
+    observations (change is fine). --diff compares live to disk without
+    writing. --assert-unchanged is the warm-run idempotence gate (exit 2
+    when moved). Never writes seed trees or endpoint: symbols (V32). Exit 0
     ok, 1 op fail, 2 only under --assert-unchanged when state moved.
     """
     assert_target_compatible(inst)
     if not files:
-        default = data_root() / "config" / "snapshot"
+        default = data_root() / "config" / "views"
         if not default.is_dir():
-            raise SystemExit(f"{default}: snapshot directory does not exist")
+            raise SystemExit(f"{default}: views directory does not exist")
         files = (Path(os.path.relpath(default)),)
-    paths = snapshot.expand_view_files(files)
-    views = [snapshot.load_view(path) for path in paths]
+    paths = state.expand_view_files(files)
+    views = [state.load_view(path) for path in paths]
     dest = out_dir if out_dir is not None else Path("state")
     if dry_run:
-        code = snapshot.run_views(None, views, out_dir=dest, mode="dry")
+        code = state.run_views(None, views, out_dir=dest, mode="dry")
     else:
         mode = "assert" if assert_unchanged else "diff" if do_diff else "write"
         with AcumaticaClient(inst) as client:
-            code = snapshot.run_views(client, views, out_dir=dest, mode=mode)
+            code = state.run_views(client, views, out_dir=dest, mode=mode)
     if code:
         raise SystemExit(code)
     if dry_run:
         return
     if assert_unchanged:
-        output.success(f"{len(views)} snapshot(s) unchanged on {inst.tenant}")
+        output.success(f"{len(views)} view(s) unchanged on {inst.tenant}")
     elif do_diff:
-        output.success(f"{len(views)} snapshot(s) compared on {inst.tenant}")
+        output.success(f"{len(views)} view(s) compared on {inst.tenant}")
     else:
-        output.success(
-            f"{len(views)} snapshot(s) written under {dest} on {inst.tenant}"
-        )
+        output.success(f"{len(views)} view(s) written under {dest} on {inst.tenant}")

{acumatica_cli-0.13.1 → acumatica_cli-0.14.0}/src/acumatica_cli/client.py

@@ -539,7 +539,7 @@ class AcumaticaClient:
             self._http.post("/CustomizationApi/publishEnd", json={})
         ).json()
 
-    # -- OData Generic Inquiry (snapshot gi: source; V33) --
+    # -- OData Generic Inquiry (state gi: source; V33) --
 
     def _odata_gi_root(self) -> str:
         """24R2+ OData GI service root ``/t/<tenant>/api/odata/gi`` (V33)."""

{acumatica_cli-0.13.1 → acumatica_cli-0.14.0}/src/acumatica_cli/config.py

@@ -118,8 +118,8 @@ INIT_TEMPLATES = (
         "config/master/85-kit-specifications.yaml",
     ),
     (
-        "config/snapshot/10-trial-balance.yaml",
-        "config/snapshot/10-trial-balance.yaml",
+        "config/views/10-trial-balance.yaml",
+        "config/views/10-trial-balance.yaml",
     ),
     ("scenario/10-seed-capital.yaml", "scenario/10-seed-capital.yaml"),
     ("scenario/20-buy.yaml", "scenario/20-buy.yaml"),

acumatica_cli-0.13.1/src/acumatica_cli/snapshot.py → acumatica_cli-0.14.0/src/acumatica_cli/state.py

@@ -1,13 +1,13 @@
-"""Derived-state observations: config/snapshot/*.yaml views -> state/*.yaml.
+"""Derived-state observations: config/views/*.yaml views -> state/*.yaml.
 
-`acu snapshot` captures live balances, quantities, and totals as committed
+`acu state` captures live balances, quantities, and totals as committed
 evidence (SPEC I.cmd / V32). Not a seed inverse: never writes seed trees,
 never carries endpoint: symbols, never participates in apply/diff. Views
-configure the observer under config/snapshot/ (not SEED_DIRS); observations
+configure the observer under config/views/ (not SEED_DIRS); observations
 are git-diffable flow-style YAML under state/. Bare defaults hard-cut those
-paths (no root snapshot/ or snapshots/ fallback).
+paths (no config/snapshot/ fallback).
 
-View file format (I.data config/snapshot/*):
+View file format (I.data config/views/*):
 
     name: trial-balance
     source:
@@ -89,7 +89,7 @@ class SourceSpec(Model):
 
 
 class ViewDef(Model):
-    """Observer config for one capture (I.data config/snapshot/*; V32/V33)."""
+    """Observer config for one capture (I.data config/views/*; V32/V33)."""
 
     name: str
     source: SourceSpec
@@ -132,7 +132,7 @@ class Observation(Model):
 
 
 def load_view(path: Path) -> ViewDef:
-    """Parse one snapshot view definition; hard error on invalid shape."""
+    """Parse one view definition; hard error on invalid shape."""
     try:
         raw = yaml.safe_load(path.read_text(encoding="utf-8"))
     except yaml.YAMLError as exc:
@@ -333,7 +333,7 @@ def expand_view_files(files: tuple[Path, ...]) -> list[Path]:
         if path.is_dir():
             found = sorted(path.glob("*.yaml"))
             if not found:
-                raise SystemExit(f"{path}: no snapshot *.yaml files in directory")
+                raise SystemExit(f"{path}: no view *.yaml files in directory")
             paths += found
         else:
             paths.append(path)
@@ -547,7 +547,7 @@ def run_views(
     out_dir: Path,
     mode: Literal["write", "diff", "assert", "dry"] = "write",
 ) -> int:
-    """Execute snapshot for views; return process exit code (V32 exit matrix).
+    """Execute state capture for views; return process exit code (V32 exit matrix).
 
     0 = ok (write or compare; change fine unless assert)
     1 = operational failure

{acumatica_cli-0.13.1 → acumatica_cli-0.14.0}/src/acumatica_cli/templates/README.md

@@ -24,9 +24,9 @@ acu run scenario/
 acu diff config/
 
 # 6. Capture derived-state observations (EndingBalance trial-balance)
-acu snapshot
+acu state
 # warm gate: once-capital only — additive buy/sell moves numeric observations
-acu run scenario/10-seed-capital.yaml && acu snapshot --assert-unchanged
+acu run scenario/10-seed-capital.yaml && acu state --assert-unchanged
 ```
 
 Bare `acu apply` / `acu diff` also prefer `config/` when those trees exist.
@@ -43,7 +43,7 @@ Bare `acu apply` / `acu diff` also prefer `config/` when those trees exist.
 | `scenario/20-buy.yaml` | Additive component PO → receipt → bill → AP pay |
 | `scenario/30-build.yaml` | Additive kit assembly |
 | `scenario/40-sell.yaml` | Additive SO → ship → invoice → AR pay |
-| `config/snapshot/10-trial-balance.yaml` | Observer view (EndingBalance inquire; not SEED_DIRS) |
-| `state/` | Written by `acu snapshot` (derived-state observations) |
+| `config/views/10-trial-balance.yaml` | Observer view (EndingBalance inquire; not SEED_DIRS) |
+| `state/` | Written by `acu state` (derived-state observations) |
 
 Monoscenario `buy-sell` is not part of this package.

{acumatica_cli-0.13.1/src/acumatica_cli/templates/config/snapshot → acumatica_cli-0.14.0/src/acumatica_cli/templates/config/views}/10-trial-balance.yaml

@@ -1,8 +1,8 @@
-# Snapshot view: GL trial balance (EndingBalance-class, V33).
+# State view: GL trial balance (EndingBalance-class, V33).
 # inquire: AccountSummaryInquiry — same contract inquiry as run expect/present
 # (Ledger + Period pinned; Results projected by Account). gi: LAB5-TrialBalance
 # remains optional when GenericInquiry is V12-verified and Expose via OData is on.
-# After scenario/, `acu snapshot --assert-unchanged` is the idempotence gate (V32).
+# After scenario/, `acu state --assert-unchanged` is the idempotence gate (V32).
 name: trial-balance
 source:
   inquire: AccountSummaryInquiry