acumatica-cli 0.10.2__tar.gz → 0.11.0__tar.gz

{acumatica_cli-0.10.2 → acumatica_cli-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acumatica-cli
-Version: 0.10.2
+Version: 0.11.0
 Summary: Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data
 Author: Konstantin Borovik
 Author-email: Konstantin Borovik <kb@lab5.ca>
@@ -16,7 +16,7 @@ Project-URL: Homepage, https://lab5.ca
 Project-URL: Repository, https://github.com/kborovik/acumatica-cli
 Description-Content-Type: text/markdown
 
-# Acumatica GitOps (Config-as-Code)
+# Acumatica ERP - GitOps CLI
 
 **`acu`** configures Acumatica ERP from YAML files in a git repo (GitOps). 
 
@@ -43,10 +43,20 @@ cd my-erp                                # edit .env: set ACU_PASSWORD
 
 acu config check                         # read-only preflight (incl. target.yaml)
 acu tenant create --id 3 --login DEV     # create the tenant + bootstrap it (needs SSH)
-acu --tenant DEV apply                   # seed bootstrap/, baseline/, setup/
+acu --tenant DEV apply                   # seed bootstrap/, baseline/, setup/ (, master/)
 acu --tenant DEV diff                    # prove zero drift (exit 2 on drift)
 ```
 
+**Distribution demo seed** (inventory, warehouse, items, vendors/customers, golden scenario):
+
+```sh
+acu config init --flavor distribution --host erp.example.com my-dist
+cd my-dist                               # edit .env; start from an empty tenant
+acu config check && acu bootstrap && acu apply && acu run scenario/ && acu diff
+```
+
+See [docs/distribution.md](docs/distribution.md) for the entity map and apply-order notes.
+
 **Hosted Acumatica (no SSH):** the tenant already exists; leave `ACU_SSH` blank.
 
 ```sh
@@ -81,25 +91,29 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
 └── config                            configuration ops
-    ├── init [--host HOST] [DIR]      scaffold a data repo (.env, target.yaml, example YAML)
+    ├── init [--host HOST] [--flavor distribution] [DIR]
+    │                                 scaffold a data repo (.env, target.yaml, example YAML)
     ├── show                          print the resolved config as a complete .env
     └── check [--strict]              preflight: discovery, secrets, target, REST, endpoints, SSH
 ```
 
-`apply` and `diff` called without FILES default to the scaffolded directories, in order: `bootstrap/`, then `baseline/`, then `setup/`.
+`apply` and `diff` called without FILES default to existing scaffolded directories, in order: `bootstrap/`, `baseline/`, `setup/`, then `master/` when present.
 `run` called without FILES defaults to `scenario/`.
 `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 everything except `scenario/`, which you author by hand:
+Your configuration lives in its own git repo.
+`acu config init` scaffolds finance-minimal seeds (Bootstrap `project.xml` at `Bootstrap/1.0.0`, no `master/`).
+`acu config init --flavor distribution` adds the full demo set (same contract identity, expanded COA, `master/`, golden `scenario/`, README).
 
 | Path          | What it holds                                                              |
 | ------------- | -------------------------------------------------------------------------- |
 | `bootstrap/`  | what makes a virgin tenant configurable: features, company, credit terms   |
 | `baseline/`   | reference data: subaccounts, chart of accounts, ledger, units of measure   |
 | `setup/`      | one-time actions: financial year, master calendar, open periods            |
+| `master/`     | distribution masters (prefs, warehouse, items, vendors, customers); flavor only |
 | `scenario/`   | transaction scenarios for `acu run`: purchase, build, sell flows            |
 | `target.yaml` | committed verified matrix: `erp` + `default_api` (what, not where)         |
 | `.env`        | where to apply and who signs in, every key an `ACU_*` variable             |
@@ -121,7 +135,7 @@ Dual-served entities (on both Bootstrap and Default) need an explicit `endpoint:
 | omitted | `Default/<ACU_API_VERSION>` for Default-only entities |
 | `bootstrap` | active `Bootstrap/<ver>` from `bootstrap/project.xml` or the packaged contract |
 | `default` | `Default/<ACU_API_VERSION>` — tracks the operator API version |
-| `Bootstrap/1.9.0` or `Default/25.200.001` | literal pin (ignores `ACU_API_VERSION` for Default) |
+| `Bootstrap/1.0.0` or `Default/25.200.001` | literal pin (ignores `ACU_API_VERSION` for Default) |
 
 Prefer symbolic `default` over a pinned `Default/25.200.001` so the seed tree travels with the configured API generation.
 
@@ -258,6 +272,16 @@ gmake check      # offline gate: ruff, basedpyright strict, pytest
 The default test suite is fully offline.
 REST is faked with `httpx.MockTransport`, SSH with a monkeypatched `subprocess.run` — no live instance is needed.
 `gmake check` must pass before every commit.
+GitHub Actions runs the same gate on every push and pull request to `main`.
+
+### Release
+
+```sh
+gmake release patch   # or minor | major
+```
+
+Local release runs `gmake check`, bumps the version, commits, tags `v<version>`, and pushes.
+GitHub Actions re-runs the check on the tag, then publishes the GitHub release and PyPI package only if that check passes.
 
 ### Live end-to-end tier
 

{acumatica_cli-0.10.2 → acumatica_cli-0.11.0}/README.md

@@ -1,4 +1,4 @@
-# Acumatica GitOps (Config-as-Code)
+# Acumatica ERP - GitOps CLI
 
 **`acu`** configures Acumatica ERP from YAML files in a git repo (GitOps). 
 
@@ -25,10 +25,20 @@ cd my-erp                                # edit .env: set ACU_PASSWORD
 
 acu config check                         # read-only preflight (incl. target.yaml)
 acu tenant create --id 3 --login DEV     # create the tenant + bootstrap it (needs SSH)
-acu --tenant DEV apply                   # seed bootstrap/, baseline/, setup/
+acu --tenant DEV apply                   # seed bootstrap/, baseline/, setup/ (, master/)
 acu --tenant DEV diff                    # prove zero drift (exit 2 on drift)
 ```
 
+**Distribution demo seed** (inventory, warehouse, items, vendors/customers, golden scenario):
+
+```sh
+acu config init --flavor distribution --host erp.example.com my-dist
+cd my-dist                               # edit .env; start from an empty tenant
+acu config check && acu bootstrap && acu apply && acu run scenario/ && acu diff
+```
+
+See [docs/distribution.md](docs/distribution.md) for the entity map and apply-order notes.
+
 **Hosted Acumatica (no SSH):** the tenant already exists; leave `ACU_SSH` blank.
 
 ```sh
@@ -63,25 +73,29 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
 └── config                            configuration ops
-    ├── init [--host HOST] [DIR]      scaffold a data repo (.env, target.yaml, example YAML)
+    ├── init [--host HOST] [--flavor distribution] [DIR]
+    │                                 scaffold a data repo (.env, target.yaml, example YAML)
     ├── show                          print the resolved config as a complete .env
     └── check [--strict]              preflight: discovery, secrets, target, REST, endpoints, SSH
 ```
 
-`apply` and `diff` called without FILES default to the scaffolded directories, in order: `bootstrap/`, then `baseline/`, then `setup/`.
+`apply` and `diff` called without FILES default to existing scaffolded directories, in order: `bootstrap/`, `baseline/`, `setup/`, then `master/` when present.
 `run` called without FILES defaults to `scenario/`.
 `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 everything except `scenario/`, which you author by hand:
+Your configuration lives in its own git repo.
+`acu config init` scaffolds finance-minimal seeds (Bootstrap `project.xml` at `Bootstrap/1.0.0`, no `master/`).
+`acu config init --flavor distribution` adds the full demo set (same contract identity, expanded COA, `master/`, golden `scenario/`, README).
 
 | Path          | What it holds                                                              |
 | ------------- | -------------------------------------------------------------------------- |
 | `bootstrap/`  | what makes a virgin tenant configurable: features, company, credit terms   |
 | `baseline/`   | reference data: subaccounts, chart of accounts, ledger, units of measure   |
 | `setup/`      | one-time actions: financial year, master calendar, open periods            |
+| `master/`     | distribution masters (prefs, warehouse, items, vendors, customers); flavor only |
 | `scenario/`   | transaction scenarios for `acu run`: purchase, build, sell flows            |
 | `target.yaml` | committed verified matrix: `erp` + `default_api` (what, not where)         |
 | `.env`        | where to apply and who signs in, every key an `ACU_*` variable             |
@@ -103,7 +117,7 @@ Dual-served entities (on both Bootstrap and Default) need an explicit `endpoint:
 | omitted | `Default/<ACU_API_VERSION>` for Default-only entities |
 | `bootstrap` | active `Bootstrap/<ver>` from `bootstrap/project.xml` or the packaged contract |
 | `default` | `Default/<ACU_API_VERSION>` — tracks the operator API version |
-| `Bootstrap/1.9.0` or `Default/25.200.001` | literal pin (ignores `ACU_API_VERSION` for Default) |
+| `Bootstrap/1.0.0` or `Default/25.200.001` | literal pin (ignores `ACU_API_VERSION` for Default) |
 
 Prefer symbolic `default` over a pinned `Default/25.200.001` so the seed tree travels with the configured API generation.
 
@@ -240,6 +254,16 @@ gmake check      # offline gate: ruff, basedpyright strict, pytest
 The default test suite is fully offline.
 REST is faked with `httpx.MockTransport`, SSH with a monkeypatched `subprocess.run` — no live instance is needed.
 `gmake check` must pass before every commit.
+GitHub Actions runs the same gate on every push and pull request to `main`.
+
+### Release
+
+```sh
+gmake release patch   # or minor | major
+```
+
+Local release runs `gmake check`, bumps the version, commits, tags `v<version>`, and pushes.
+GitHub Actions re-runs the check on the tag, then publishes the GitHub release and PyPI package only if that check passes.
 
 ### Live end-to-end tier
 

{acumatica_cli-0.10.2 → acumatica_cli-0.11.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.10.2"
+version = "0.11.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.10.2 → acumatica_cli-0.11.0}/src/acumatica_cli/bootstrap.py

@@ -8,10 +8,10 @@ virgin tenant, so bootstrap = publish a package whose CustomizationPlugin
 cannot write CS100000 at all (T3 verdict) — and whose Bootstrap contract
 endpoint exposes the seeding surface (serialization verified T12).
 
-Contract ownership is hybrid (T69/V2): the data repo's
-``bootstrap/project.xml`` is preferred when present (full company surface);
-else the packaged minimal ``bootstrap_project.xml`` covers config-init +
-the GL chain so PyPI-only and offline virgin paths still bootstrap.
+Contract ownership is hybrid (T69/V2/T81): the data repo's
+``bootstrap/project.xml`` is preferred when present; else the packaged
+full company ``bootstrap_project.xml`` (``Bootstrap/1.0.0``) so PyPI-only
+and offline virgin paths still bootstrap the full surface.
 
 Customization publishes are tenant-scoped, so the package must be published
 per tenant; publish() is idempotent on content — the skip gate compares the
@@ -60,7 +60,7 @@ FEATURES_SENTINEL = "/*ACU_FEATURES*/"
 
 
 def packaged_contract_xml() -> bytes:
-    """The CLI-shipped minimal Bootstrap contract (config-init surface)."""
+    """The CLI-shipped full company Bootstrap contract (``Bootstrap/1.0.0``)."""
     return (resources.files("acumatica_cli") / "bootstrap_project.xml").read_bytes()
 
 
@@ -69,7 +69,7 @@ def load_contract_xml(root: Path | None = None) -> bytes:
 
     ``root`` is the data-repo discovery root (the dir holding ``.env``).
     Absent root or absent ``bootstrap/project.xml`` falls back to the
-    packaged minimal contract (V2, same absence pattern as features.yaml).
+    packaged full company contract (V2/T81, same absence pattern as features.yaml).
     """
     if root is not None:
         path = root / "bootstrap" / "project.xml"
@@ -136,9 +136,9 @@ def package_zip(
     ``Enabled`` set at the ACU_FEATURES sentinel — the one point where the
     data repo's feature list enters the package (V2).
 
-    Contract XML (V2/T69): ``contract`` when given; else
+    Contract XML (V2/T69/T81): ``contract`` when given; else
     ``bootstrap/project.xml`` under ``root`` when present; else the
-    packaged minimal template.
+    packaged full company template.
     """
     pkg = resources.files("acumatica_cli")
     if contract is None: