acumatica-cli 0.15.4__tar.gz → 0.17.0__tar.gz

{acumatica_cli-0.15.4 → acumatica_cli-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acumatica-cli
-Version: 0.15.4
+Version: 0.17.0
 Summary: Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data
 Author: Konstantin Borovik
 Author-email: Konstantin Borovik <kb@lab5.ca>
@@ -88,6 +88,10 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 │                                     capture derived state into state/ (not seed)
 ├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
 │                                     inverse of apply into config/{bootstrap,baseline,setup,master}/
+├── inventory [--out DIR] [--force] [--dry-run] ARTIFACT
+│                                     offline snapshot artifact → inventory/ (not seed)
+├── reconcile [--inventory DIR] [--config DIR] [--out DIR] [--force] [--dry-run]
+│                                     inventory/ + optional config/ → findings/ only
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
 └── config                            configuration ops
@@ -101,9 +105,30 @@ A path like `config/` expands nested seed dirs in that fixed order.
 `run` without FILES defaults to `scenario/`.
 `state` without FILES defaults to `config/views/`; writes go to `state/` (`--out`).
 `extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
+`inventory` is offline (no REST/SSH/password): SM203520 Settings XML ZIP or `ac.exe export xml` folder writes to `inventory/`.
+`reconcile` is offline: compare `inventory/` to optional `config/` and write `findings/` only (never writes seed).
+Optional `snapshot_map.yaml` (data-repo root or package defaults) maps DAC tables to catalog entities and normalizes join (pad-trim, key/field aliases, Account/Sub FK CD resolve).
+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 <command> --help` for details on any command.
 
+### Dual readers, one writer
+
+Two read paths, one mutator (V35).
+Do not confuse them with each other or with `state`:
+
+| Command | Plane | Input | Writes | Role |
+| ------- | ----- | ----- | ------ | ---- |
+| `extract` | REST (live) | tenant via contract API | `config/{bootstrap,baseline,setup,master}/` | Inverse of `apply` — seed YAML |
+| `inventory` | Offline | SM203520 Settings XML ZIP or `ac.exe export xml` folder | `inventory/` (`summary.yaml` + `tables/`) | Full-table snapshot IR — not seed |
+| `reconcile` | Offline | `inventory/` + optional `config/` | `findings/` only | Cross-check gaps/deltas — never mutates seed or tenant |
+| `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) |
+
+`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.
@@ -119,6 +144,8 @@ There is no `--flavor`.
 | `scenario/` | lifecycle txns for `acu run`: once capital, then buy, build, sell |
 | `config/views/` | observer views for `acu state` (`inquire:` / `entity:` / `gi:`; not SEED_DIRS) |
 | `state/` | committed derived-state observations (evidence, not seed; money/qty fixed-point) |
+| `inventory/` | engagement: offline snapshot tables from `acu inventory` (not seed; not SEED_DIRS) |
+| `findings/` | engagement: `acu reconcile` cross-check output (never apply path) |
 | `target.yaml` | committed verified matrix: `erp` + `default_api` (what, not where) |
 | `.env` | where to apply and who signs in, every key an `ACU_*` variable |
 

{acumatica_cli-0.15.4 → acumatica_cli-0.17.0}/README.md

@@ -70,6 +70,10 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 │                                     capture derived state into state/ (not seed)
 ├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
 │                                     inverse of apply into config/{bootstrap,baseline,setup,master}/
+├── inventory [--out DIR] [--force] [--dry-run] ARTIFACT
+│                                     offline snapshot artifact → inventory/ (not seed)
+├── reconcile [--inventory DIR] [--config DIR] [--out DIR] [--force] [--dry-run]
+│                                     inventory/ + optional config/ → findings/ only
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
 └── config                            configuration ops
@@ -83,9 +87,30 @@ A path like `config/` expands nested seed dirs in that fixed order.
 `run` without FILES defaults to `scenario/`.
 `state` without FILES defaults to `config/views/`; writes go to `state/` (`--out`).
 `extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
+`inventory` is offline (no REST/SSH/password): SM203520 Settings XML ZIP or `ac.exe export xml` folder writes to `inventory/`.
+`reconcile` is offline: compare `inventory/` to optional `config/` and write `findings/` only (never writes seed).
+Optional `snapshot_map.yaml` (data-repo root or package defaults) maps DAC tables to catalog entities and normalizes join (pad-trim, key/field aliases, Account/Sub FK CD resolve).
+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 <command> --help` for details on any command.
 
+### Dual readers, one writer
+
+Two read paths, one mutator (V35).
+Do not confuse them with each other or with `state`:
+
+| Command | Plane | Input | Writes | Role |
+| ------- | ----- | ----- | ------ | ---- |
+| `extract` | REST (live) | tenant via contract API | `config/{bootstrap,baseline,setup,master}/` | Inverse of `apply` — seed YAML |
+| `inventory` | Offline | SM203520 Settings XML ZIP or `ac.exe export xml` folder | `inventory/` (`summary.yaml` + `tables/`) | Full-table snapshot IR — not seed |
+| `reconcile` | Offline | `inventory/` + optional `config/` | `findings/` only | Cross-check gaps/deltas — never mutates seed or tenant |
+| `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) |
+
+`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.
@@ -101,6 +126,8 @@ There is no `--flavor`.
 | `scenario/` | lifecycle txns for `acu run`: once capital, then buy, build, sell |
 | `config/views/` | observer views for `acu state` (`inquire:` / `entity:` / `gi:`; not SEED_DIRS) |
 | `state/` | committed derived-state observations (evidence, not seed; money/qty fixed-point) |
+| `inventory/` | engagement: offline snapshot tables from `acu inventory` (not seed; not SEED_DIRS) |
+| `findings/` | engagement: `acu reconcile` cross-check output (never apply path) |
 | `target.yaml` | committed verified matrix: `erp` + `default_api` (what, not where) |
 | `.env` | where to apply and who signs in, every key an `ACU_*` variable |
 

acumatica_cli-0.17.0/pyproject.toml

@@ -0,0 +1,109 @@
+[project]
+name = "acumatica-cli"
+version = "0.17.0"
+description = "Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data"
+license = "PolyForm-Noncommercial-1.0.0"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = [
+    "click>=8.1",
+    "httpx>=0.27",
+    "pydantic>=2.7",
+    "pydantic-settings>=2.5",
+    "pyyaml>=6.0",
+    "rich>=13",
+]
+
+[[project.authors]]
+name = "Konstantin Borovik"
+email = "kb@lab5.ca"
+
+[project.urls]
+Homepage = "https://lab5.ca"
+Repository = "https://github.com/kborovik/acumatica-cli"
+
+[project.scripts]
+acu = "acumatica_cli.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.11,<0.12"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "basedpyright>=1.37.0",
+    "pytest>=8",
+    "ruff>=0.13.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = '-q -m "not e2e"'
+markers = ["e2e: live end-to-end tests against a real Acumatica instance (make e2e)"]
+
+[tool.basedpyright]
+typeCheckingMode = "strict"
+pythonVersion = "3.14"
+include = [
+    "src/acumatica_cli/",
+    "tests/",
+]
+reportMissingTypeStubs = false
+reportUnknownVariableType = false
+reportUnknownMemberType = false
+reportUnknownArgumentType = false
+reportUnknownParameterType = false
+reportUnknownLambdaType = false
+reportUnusedFunction = "warning"
+
+[tool.ruff]
+target-version = "py314"
+src = ["src"]
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ruff.lint]
+fixable = ["ALL"]
+select = [
+    "B",
+    "C4",
+    "C90",
+    "COM",
+    "D",
+    "E",
+    "F",
+    "I",
+    "N",
+    "PL",
+    "PT",
+    "RUF",
+    "SIM",
+    "T20",
+    "TID",
+    "UP",
+    "W",
+]
+ignore = [
+    "PLR2004",
+    "PLC0415",
+    "D100",
+    "D104",
+    "D105",
+    "D107",
+    "COM812",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.isort]
+known-first-party = ["acumatica_cli"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/acumatica_cli/cli.py" = ["PLR0913"]
+"tests/*" = [
+    "D101",
+    "D102",
+    "D103",
+]

acumatica_cli-0.15.4/pyproject.toml → acumatica_cli-0.17.0/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.15.4"
+version = "0.17.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.15.4 → acumatica_cli-0.17.0}/src/acumatica_cli/cli.py

@@ -12,7 +12,17 @@ import click
 import httpx
 from click.shell_completion import get_completion_class
 
-from . import bootstrap, extract, firstlogin, output, run, seed, state
+from . import (
+    bootstrap,
+    extract,
+    firstlogin,
+    inventory,
+    output,
+    reconcile,
+    run,
+    seed,
+    state,
+)
 from .client import AcumaticaClient
 from .config import (
     Instance,
@@ -1000,6 +1010,126 @@ def _exit_on_drift(inst: Instance, drifts: list[str], files: int) -> None:
     output.success(f"no drift on {inst.tenant} ({inst.base_url}, {files} file(s))")
 
 
+@cli.command("inventory")
+@click.argument(
+    "artifact",
+    type=click.Path(exists=True, path_type=Path),
+)
+@click.option(
+    "--out",
+    "out_dir",
+    type=click.Path(file_okay=False, path_type=Path),
+    default=None,
+    help="Output directory (default: inventory/)",
+)
+@click.option("--force", is_flag=True, help="Overwrite existing files")
+@click.option(
+    "--dry-run",
+    is_flag=True,
+    help="Show what would be written without writing",
+)
+def inventory_cmd(
+    artifact: Path,
+    out_dir: Path | None,
+    force: bool,
+    dry_run: bool,
+) -> None:
+    """Parse a snapshot artifact into inventory/ (offline dual-reader).
+
+    ARTIFACT is an SM203520 Settings XML ZIP (manifest.xml + table XML) or
+    an ac.exe export xml folder. Both normalize to one IR (V37). Binary
+    .adb is rejected. No REST, no SSH, no password. Writes summary.yaml
+    and tables/<Table>.yaml under --out (default inventory/). Existing
+    files are skipped unless --force. When data-repo target.yaml is
+    present and the artifact reports a build, erp must match or the run
+    fails. Exit 0 clean, 1 parse/format/version fail; never 2 (drift is
+    not this command). Not extract (REST seed into config/), not state
+    (derived balances) — never writes config/ or state/ (V35).
+    """
+    art = inventory.parse_artifact(artifact)
+    target = load_target()
+    if target is not None:
+        inventory.assert_erp_matches(art, target.erp)
+    dest = out_dir if out_dir is not None else Path(inventory.DEFAULT_OUT)
+    output.data(
+        f"{artifact} -> {dest} ({len(art.tables)} table(s)"
+        f"{f', erp={art.erp}' if art.erp else ''})"
+    )
+    inventory.emit(art, dest, force=force, dry_run=dry_run)
+
+
+@cli.command("reconcile")
+@click.option(
+    "--inventory",
+    "inventory_dir",
+    type=click.Path(file_okay=False, path_type=Path),
+    default=None,
+    help="Inventory tree directory (default: inventory/)",
+)
+@click.option(
+    "--config",
+    "config_dir",
+    type=click.Path(file_okay=False, path_type=Path),
+    default=None,
+    help="Optional config/ seed tree (default: config/ when present)",
+)
+@click.option(
+    "--out",
+    "out_dir",
+    type=click.Path(file_okay=False, path_type=Path),
+    default=None,
+    help="Findings output directory (default: findings/)",
+)
+@click.option("--force", is_flag=True, help="Overwrite existing findings files")
+@click.option(
+    "--dry-run",
+    is_flag=True,
+    help="Show what would be written without writing",
+)
+def reconcile_cmd(
+    inventory_dir: Path | None,
+    config_dir: Path | None,
+    out_dir: Path | None,
+    force: bool,
+    dry_run: bool,
+) -> None:
+    """Compare inventory/ to optional config/ and write findings/ (offline).
+
+    Dual-reader cross-check (V35/V36): reads an inventory tree from
+    `acu inventory` plus an optional prior-extract config/ seed tree;
+    emits FindingsBundle under --out (default findings/). Never writes
+    config/ (not extract promote) and never captures state/ — unmapped
+    tables, REST gaps, rest-vs-snapshot field deltas, and Usr* custom
+    columns land in findings files only. No REST, no SSH, no password.
+    Exit 0 clean, 1 IO/parse fail; never 2 (conflicts are findings, not
+    drift). Optional snapshot_map.yaml maps DAC tables to catalog
+    entities (absent → identity match on entity name) and may declare
+    keys:/fields: seed→inv aliases plus resolvers:/resolves: for FK
+    int→CD compare (package defaults cover Sub, UnitOfMeasure,
+    ReasonCode/VendorClass Account+Sub). Compare always pad-trims strings.
+    """
+    inv = (
+        inventory_dir
+        if inventory_dir is not None
+        else Path(reconcile.DEFAULT_INVENTORY)
+    )
+    if config_dir is not None:
+        cfg: Path | None = config_dir
+    else:
+        default_cfg = Path(reconcile.DEFAULT_CONFIG)
+        cfg = default_cfg if default_cfg.is_dir() else None
+    dest = out_dir if out_dir is not None else Path(reconcile.DEFAULT_OUT)
+    cfg_label = str(cfg) if cfg is not None else "(none)"
+    output.data(f"{inv} + {cfg_label} -> {dest}")
+    reconcile.run(
+        inventory_dir=inv,
+        config_dir=cfg,
+        out_dir=dest,
+        force=force,
+        dry_run=dry_run,
+    )
+
+
 @cli.command("state")
 @click.argument(
     "files", nargs=-1, required=False, type=click.Path(exists=True, path_type=Path)