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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acumatica-cli
-Version: 0.32.0
+Version: 0.34.0
 Summary: Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data
 Author: Konstantin Borovik
 Author-email: Konstantin Borovik <kb@lab5.ca>
@@ -79,7 +79,6 @@ acu --tenant DEV state                   # 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.
 
 **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.
@@ -140,7 +139,7 @@ When you omit FILES:
 - `state` defaults to `config/views/`; writes go to `state/` (`--out`).
 
 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).
+`config/views` and `state` keep Period pinned.
 
 `survey extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
 
@@ -153,8 +152,6 @@ 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).
@@ -178,8 +175,6 @@ Do not confuse them with each other or with `state`:
 `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.
@@ -212,7 +207,6 @@ 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).
 
 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`.
 Existing files skip unless `--force`; empty live sets skip.
@@ -257,10 +251,10 @@ Or clone and install editable for development:
 ```sh
 git clone https://github.com/kborovik/acumatica-cli.git
 cd acumatica-cli
-gmake install    # editable install as a global uv tool
+gmake install    # uv sync; does not replace the PyPI tool
 ```
 
-Verify with `acu --version`.
+Verify with `uv run acu --version` (`+dev`).
 
 ## Configuration
 
@@ -268,7 +262,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
@@ -351,7 +345,7 @@ Elsewhere plain `make` is fine when it is GNU Make.
 ```sh
 git clone https://github.com/kborovik/acumatica-cli.git
 cd acumatica-cli
-gmake install    # editable install as a global uv tool
+gmake install    # uv sync; does not replace the PyPI tool
 gmake check      # offline gate: ruff, basedpyright strict, pytest
 ```
 
@@ -391,16 +385,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.
 
 ```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
+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 `config/` and `scenario/` (no `config/qms/`).
+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
+uv run acu --tenant ACUCLI apply
+uv run acu --tenant ACUCLI run
+uv run acu --tenant ACUCLI diff
+uv run acu --tenant ACUCLI state
 ```
 
 ## License

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

@@ -61,7 +61,6 @@ acu --tenant DEV state                   # 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.
 
 **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.
@@ -122,7 +121,7 @@ When you omit FILES:
 - `state` defaults to `config/views/`; writes go to `state/` (`--out`).
 
 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).
+`config/views` and `state` keep Period pinned.
 
 `survey extract` always writes under `config/{bootstrap,baseline,setup,master}/` (catalog-driven; never root SEED_DIRS).
 
@@ -135,8 +134,6 @@ 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).
@@ -160,8 +157,6 @@ Do not confuse them with each other or with `state`:
 `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.
@@ -194,7 +189,6 @@ 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).
 
 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`.
 Existing files skip unless `--force`; empty live sets skip.
@@ -239,10 +233,10 @@ Or clone and install editable for development:
 ```sh
 git clone https://github.com/kborovik/acumatica-cli.git
 cd acumatica-cli
-gmake install    # editable install as a global uv tool
+gmake install    # uv sync; does not replace the PyPI tool
 ```
 
-Verify with `acu --version`.
+Verify with `uv run acu --version` (`+dev`).
 
 ## Configuration
 
@@ -250,7 +244,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
@@ -333,7 +327,7 @@ Elsewhere plain `make` is fine when it is GNU Make.
 ```sh
 git clone https://github.com/kborovik/acumatica-cli.git
 cd acumatica-cli
-gmake install    # editable install as a global uv tool
+gmake install    # uv sync; does not replace the PyPI tool
 gmake check      # offline gate: ruff, basedpyright strict, pytest
 ```
 
@@ -373,16 +367,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.
 
 ```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
+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 `config/` and `scenario/` (no `config/qms/`).
+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
+uv run acu --tenant ACUCLI apply
+uv run acu --tenant ACUCLI run
+uv run acu --tenant ACUCLI diff
+uv run acu --tenant ACUCLI state
 ```
 
 ## License

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

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

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.32.0"
+version = "0.34.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.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/bootstrap.py

@@ -1,15 +1,15 @@
 """Bootstrap customization package: build the zip, publish via /CustomizationApi.
 
 An unconfigured tenant cannot be configured through the Default endpoint
-(features are off, no company/branch exists, credit terms have no entity —
-docs/rest-api.md). The CustomizationApi is the one door that works on a
+(features are off, no company/branch exists, credit terms have no entity).
+The CustomizationApi is the one door that works on a
 virgin tenant, so bootstrap = publish a package whose CustomizationPlugin
 (`bootstrap_plugin.cs`) enables features on publish — the contract API
 cannot write CS100000 at all (T3 verdict) — and whose Bootstrap contract
 endpoint exposes the seeding surface (serialization verified T12).
 
 Bootstrap endpoint contract is package SoT (V2/V21/T178): always the
-packaged full company ``bootstrap_project.xml`` (``Bootstrap/1.10.0``).
+packaged full company ``bootstrap_project.xml`` (``Bootstrap/1.11.0``).
 Data-repo ``config/bootstrap/project.xml`` or ``bootstrap/project.xml`` is
 not a seed — present → hard error naming package SoT (no dual contract line).
 
@@ -68,7 +68,7 @@ def _bootstrap_file(root: Path, name: str) -> Path | None:
 
 
 def packaged_contract_xml() -> bytes:
-    """The CLI-shipped full company Bootstrap contract (``Bootstrap/1.10.0``)."""
+    """The CLI-shipped full company Bootstrap contract (``Bootstrap/1.11.0``)."""
     return (resources.files("acumatica_cli") / "bootstrap_project.xml").read_bytes()
 
 

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/bootstrap_plugin.cs

@@ -2,7 +2,7 @@
 //
 // Runs in-process on customization publish - the one write path to
 // FeaturesSet that works: the contract API cannot persist features no
-// matter what endpoint fronts CS100000 (T3 verdict, docs/rest-api.md).
+// matter what endpoint fronts CS100000 (T3 verdict).
 //
 // Deliberately writes through PXDatabase, not FeaturesMaint: the graph
 // save collides with the publish pipeline's concurrent plugin invocations

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/bootstrap_project.xml

@@ -13,11 +13,14 @@
   and drops Selected (AllowedRoles was EPLoginTypeAllowsRole / EP202500);
   T228 bumps 1.8.0 -> 1.9.0 for Role.Users -> UsersByRole (SM201005
   Users tab; mapped-detail PUT is a no-op — B33) and 1.9.0 -> 1.10.0
-  for Role AssignUser action (PXDatabase UsersInRoles persist).
+  for Role AssignUser action (PXDatabase UsersInRoles persist);
+  T251 bumps 1.10.0 -> 1.11.0 for NumberingSequence Header NewSymbol
+  (CS201010 insert requires New Number Symbol or Manual Numbering;
+  gh #44 / V58).
 
-  package_zip() (bootstrap.py) prefers data-repo bootstrap/project.xml when
-  present; otherwise this packaged template is the fallback so config init,
-  offline tests, and package-only installs still bootstrap the full surface.
+  package_zip() always loads this packaged contract. Data-repo
+  config/bootstrap/project.xml or bootstrap/project.xml is forbidden (V21);
+  present -> hard error naming package SoT.
 
   package_zip() injects a
   <Graph ClassName="AcuBootstrapPlugin" FileType="NewFile" Source="..."/>
@@ -64,16 +67,22 @@
   T150 NumberingSequence (gh #25) - Default endpoint has no numbering
   surface; CS201010 Numbering Sequences (NumberingMaint — NOT the
   misnamed NumberingSequenceMaint):
-  - PrimaryView Header (DAC Numbering): key NumberingID + Descr.
+  - PrimaryView Header (DAC Numbering): key NumberingID + Descr +
+    NewSymbol (T251/V58; CS201010 "New Number Symbol"). UserNumbering
+    is the OR alternative (manual numbering), not a required pair.
+    Mapped GET returns NewSymbol (seed; GET-omit is mapping-miss drift).
   - Detail view Sequence (DAC NumberingSequence): bounds StartNbr,
     EndNbr, WarnNbr, NbrStep, StartDate. LastNbr is runtime counter —
     omitted from contract (V40/T152 strip/ignore if ever present).
-  - Flat entity (Currency multi-view idiom): NumberingID/Descr on Header,
-    bounds on Sequence. Single sequence row per NumberingID is the
-    demo/LAB5 shape; multi-segment / branch-scoped rows are out of v1.
+  - Flat entity (Currency multi-view idiom): NumberingID/Descr/NewSymbol
+    on Header, bounds on Sequence. Single sequence row per NumberingID
+    is the demo/LAB5 shape; multi-segment / branch-scoped rows are out
+    of v1.
   T159: view names were wrong in 1.2.0/1.3.0 (Sequence/SequenceDetail);
   live aspx + NumberingMaint reflection = Header/Sequence. Bump 1.3.0
   -> 1.4.0 (V21). Wrong maps made every PUT 422 on NewSymbol mask.
+  T251: map NewSymbol to Header (not Sequence). Insert of a new
+  NumberingID without it 422s (B38).
 
   T204 SegmentedKey (gh #30 / V50) - Default endpoint has no CS202000
   surface; DimensionMaint Segmented Keys:
@@ -121,7 +130,7 @@
 -->
 <Customization level="" description="acu bootstrap: CustomizationPlugin enables features on publish; Bootstrap endpoint exposes full company surface (company + credit terms + financial currency + GL chain + module preferences + vendor class + statement cycle + warehouse + order type + cash account + role + user + membership + numbering sequence + segmented key)" product-version="26.101">
   <EntityEndpoint>
-    <Endpoint xmlns="http://www.acumatica.com/entity/maintenance/5.31" name="Bootstrap" version="1.10.0" systemContractVersion="4">
+    <Endpoint xmlns="http://www.acumatica.com/entity/maintenance/5.31" name="Bootstrap" version="1.11.0" systemContractVersion="4">
       <TopLevelEntity name="Company" screen="CS101500">
         <Fields>
           <Field name="AcctCD" type="StringValue" />
@@ -1120,6 +1129,7 @@
         <Fields>
           <Field name="NumberingID" type="StringValue" />
           <Field name="Descr" type="StringValue" />
+          <Field name="NewSymbol" type="StringValue" />
           <Field name="StartNbr" type="StringValue" />
           <Field name="EndNbr" type="StringValue" />
           <Field name="WarnNbr" type="StringValue" />
@@ -1133,6 +1143,9 @@
           <Mapping field="Descr">
             <To object="Header" field="Descr" />
           </Mapping>
+          <Mapping field="NewSymbol">
+            <To object="Header" field="NewSymbol" />
+          </Mapping>
           <Mapping field="StartNbr">
             <To object="Sequence" field="StartNbr" />
           </Mapping>

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/cli.py

@@ -76,7 +76,7 @@ DEFAULT PATHS (when FILES omitted)
   survey extract -> always writes config/{bootstrap,baseline,setup,master}/
 
 Run `acu <command> --help` for flags, examples, and prerequisites.
-See package README and docs/demo-seed.md for seed YAML shape.
+See package README for seed YAML shape.
 """
 
 import functools
@@ -382,7 +382,7 @@ def tenant_list(inst: Instance) -> None:
 @click.option(
     "--type",
     "company_type",
-    # the V12-verified dataset folders on the box (docs/ac-exe.md); System
+    # the V12-verified dataset folders on the box; System
     # is the system-tenant dataset, deliberately not offered
     type=click.Choice(["SalesDemo", "T100", "U100"]),
     default=None,
@@ -466,7 +466,7 @@ def tenant_create(
         output.data(raw.splitlines()[-1] if raw.strip() else "created")
     # ac.exe only sets CompanyKey from LoginName; CompanyCD stays auto-generated
     # (Company2/Company3/…). Align CD → login so list shows matching columns.
-    # Idempotent on re-run / exists-skip (docs/ac-exe.md).
+    # Idempotent on re-run / exists-skip.
     with output.step(f"aligning CompanyCD to login ({login_name})"):
         if mgr.set_company_cd(company_id, login_name):
             output.data(f"CompanyCD set to {login_name}")

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/client.py

@@ -1,4 +1,4 @@
-"""Contract-based REST API session (see docs/rest-api.md for verified quirks)."""
+"""Contract-based REST API session."""
 
 import base64
 import html
@@ -162,7 +162,7 @@ OPTIMIZATION_500 = "Optimization cannot be performed"
 # tenant answers PXSetupNotEnteredException on most entities until bootstrap
 # lands, and the exceptionMessage names the missing form — "The required
 # configuration data is not entered on the <Form> form." (verified vs
-# 26.101.0225, docs/rest-api.md).
+# 26.101.0225).
 SETUP_NOT_ENTERED_500 = "configuration data is not entered"
 
 
@@ -188,7 +188,7 @@ class AcumaticaClient:
         self._refreshed_after_company = False
 
     def __enter__(self) -> AcumaticaClient:
-        # tenant guard (V5, docs/rest-api.md): an omitted or empty tenant is
+        # tenant guard (V5): an omitted or empty tenant is
         # the one login the server still routes silently — to the default
         # tenant. Defense-in-depth vs wrong-tenant writes: every data-plane
         # session must name its tenant, so refuse before any HTTP happens.
@@ -219,7 +219,7 @@ class AcumaticaClient:
 
         Login accepting the name proves nothing - a stale tenant map
         reroutes named logins to the default tenant, and a single-tenant
-        instance accepts ANY name (both verified live, docs/rest-api.md).
+        instance accepts ANY name (both verified live).
         """
         creds: dict[str, str] = {
             "name": self.instance.user,
@@ -261,7 +261,7 @@ class AcumaticaClient:
     def _landed_tenant(self) -> str:
         """The tenant this session actually landed on (login name).
 
-        Verified vs 26.101.0225 (docs/rest-api.md): the contract API exposes
+        Verified vs 26.101.0225: the contract API exposes
         nothing tenant-identifying, but an authenticated GET of the sign-in
         page renders a hidden ``txtSingleCompany`` input whose value is the
         session tenant's login name in every observed state - multi-tenant,

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/extract.py

@@ -465,8 +465,11 @@ def _synth_open_periods(client: AcumaticaClient) -> dict[str, Any] | None:
     years = _years(live)
     # OrganizationID = the extracted Company's AcctCD: the reference
     # resolves inside the emitted set (V22 - config/bootstrap/company.yaml
-    # creates the organization the action names)
-    companies = client.get_list("Company", endpoint=ep)
+    # creates the organization the action names).
+    # Company list GET 500s once DecPlQty/WeightUOM/VolumeUOM map
+    # commonsetup (V52; BQL-delegate view, B9). $select keeps AcctCD
+    # only so the synth does not pull those fields.
+    companies = client.get_list("Company", params={"$select": "AcctCD"}, endpoint=ep)
     if not companies:
         raise RuntimeError("open-periods: no Company on tenant")
     org = sorted(str(unwrap(c)["AcctCD"]) for c in companies)[0]

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/firstlogin.py

@@ -1,8 +1,8 @@
 """First-login admin password initialization via the Login.aspx screen flow.
 
 A freshly created tenant seeds ``admin``/``setup`` with a
-must-change-on-first-login flag the contract REST API cannot clear (verified —
-see docs/rest-api.md). The sign-in screen's WebForms flow can, with plain
+must-change-on-first-login flag the contract REST API cannot clear (verified
+live). The sign-in screen's WebForms flow can, with plain
 HTTP: GET the page for the hidden fields, POST the seed credentials, then
 POST again with the new password into the change view the server renders.
 """

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/inventory.py

@@ -13,7 +13,7 @@ Accepted artifacts (V37):
 Rejected: binary ``.adb`` (and ZIPs that only carry ``.adb``) — named
 error, fail-closed.
 
-Table XML shape (verified ac-exe export / dataset format, docs/ac-exe.md):
+Table XML shape (verified ac-exe export / dataset format):
 
     <data>
       <table name="Account">

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/seed.py

@@ -83,24 +83,31 @@ _BRANCH_EMPTY = "'Branch' cannot be empty"
 # YAML; extract always strips; diff never compares (GET returns hashes
 # or nothing — never a re-seedable value).
 PASSWORD_FIELDS = frozenset({"Password", "b64__Password"})
-# NumberingSequence runtime counters (V40/gh #25): bounds-only seed;
-# LastNbr (+ advanced counter if ever exposed) = issued progress, not
-# desired config. Extract hard-strips; diff never compares; apply never
-# PUTs them (re-apply must not reset live counters).
+# NumberingSequence runtime counters (V40/gh #25): LastNbr (+ advanced
+# counter if ever exposed) = issued progress, not desired config. Extract
+# hard-strips; diff never compares; apply never PUTs them (re-apply must
+# not reset live counters).
 NUMBERING_RUNTIME_FIELDS = frozenset({"LastNbr"})
 # Fields omitted from source↔live compare (V39 write-only + V40 runtime).
-# Field-name deny at every nesting level. Do not add bare ``Value`` here —
-# that would hide real drift on unrelated fields (V56).
+# Field-name deny at every nesting level.
 _DIFF_IGNORE_FIELDS = PASSWORD_FIELDS | NUMBERING_RUNTIME_FIELDS
 # Path-qualified write-only GET-omit (V56): (entity, detail, field).
 # Diff ignores; extract strips; apply still PUTs when present in YAML.
+# Do not add bare ``Value`` to _DIFF_IGNORE_FIELDS — that would hide
+# real drift on unrelated fields.
 _DIFF_IGNORE_PATHS = frozenset({("LotSerialClass", "Segments", "Value")})
+# Whole-detail skip (V57/B37): mapped GET Role.Users / User.Roles may be
+# empty while UsersInRoles has session-company rows. Extra live members
+# are not drift (AssignUser is additive-only).
+_DIFF_SKIP_DETAILS = frozenset({("Role", "Users"), ("User", "Roles")})
 
 
 def _diff_ignored(entity: str, *path: str) -> bool:
-    """True when source↔live compare skips this field (V39/V40/V56)."""
+    """True when source↔live compare skips this field (V39/V40/V56/V57)."""
     if path and path[-1] in _DIFF_IGNORE_FIELDS:
         return True
+    if len(path) == 1 and (entity, path[0]) in _DIFF_SKIP_DETAILS:
+        return True
     return (entity, *path) in _DIFF_IGNORE_PATHS
 
 
@@ -679,7 +686,8 @@ def diff(client: AcumaticaClient, baseline: BaselineFile | ActionFile) -> list[s
             drifts.append(f"{label}: missing on tenant")
             continue
         actual = unwrap(live)
-        # V39/V40/V56: never compare write-only, runtime, or GET-omit paths
+        # V39/V40/V56/V57: never compare write-only, runtime, GET-omit,
+        # or membership details whose mapped GET may stay empty.
         fields = {
             k: v for k, v in record.items() if not _diff_ignored(baseline.entity, k)
         }

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/seed_catalog.yaml

@@ -6,7 +6,7 @@
 #   entity    contract entity name (the GET source and the emitted `entity:`)
 #   endpoint  omitted = the instance Default endpoint; the symbolic name
 #             `bootstrap` stays symbolic in emitted files and resolves to
-#             the packaged full company Bootstrap/1.10.0 at HTTP/load time
+#             the packaged full company Bootstrap/1.11.0 at HTTP/load time
 #             (package SoT - V20/V21/T178; data-repo project.xml forbidden)
 #   keys      key fields: the emitted `key:`, the record sort order, and
 #             the B9 fallback's $select projection; the tuple must
@@ -181,10 +181,10 @@ entities:
 # include field-partition (same live warehouse row, three apply phases).
 # Multi-file StockItem uses OData filter-split on ItemClass.
 #
-# NumberingSequence (T151/gh #25): V22 prefix 05- sorts before every prefs
-# file that may reference *NumberingID (IN/SO/PO/AR/AP/CA/GL setup). Bootstrap
-# only — Default has no numbering surface. Bounds-only include (no LastNbr;
-# runtime counter is V40/T152).
+# NumberingSequence (T151/gh #25, T252/gh #44): V22 prefix 05- sorts before
+# every prefs file that may reference *NumberingID (IN/SO/PO/AR/AP/CA/GL
+# setup). Bootstrap only — Default has no numbering surface. Include bounds
+# + NewSymbol (insert-required, V58); no LastNbr (runtime counter is V40).
 
 - entity: NumberingSequence
   endpoint: bootstrap
@@ -192,6 +192,7 @@ entities:
   file: config/master/05-numbering-sequences.yaml
   include:
   - Descr
+  - NewSymbol
   - StartNbr
   - EndNbr
   - WarnNbr
@@ -535,9 +536,10 @@ entities:
 # config/master/ Role then User then Role.Users (V22 prefixes 90/91/92;
 # T145/T146/T148/T228). Bootstrap only — Default has no Role/User surface.
 # Persist = Role action AssignUser (PXDatabase UsersInRoles; T228/B33).
-# User detail Roles is GET/diff shape (PUT never writes UsersInRoles —
-# B31/B32/B33). Package 90-roles = full pre-build CompanyID=1
-# Roles dump; 91-users demo soadmin identity; 92-role-users membership.
+# User detail Roles = GET/extract; diff skips Users/Roles (V57).
+# PUT never writes UsersInRoles (B31/B32/B33).
+# Package 90-roles = full pre-build CompanyID=1 Roles dump;
+# 91-users demo soadmin identity; 92-role-users membership.
 # Password is write-only on apply (V39/T147): include omits Password so
 # extract never emits hashes (b64__Password also out of include).
 

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/templates/config/master/05-numbering-sequences.yaml

@@ -3,78 +3,91 @@ key: NumberingID
 endpoint: bootstrap
 records:
 - NumberingID: APBILL
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: APPAYMENT
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: ARINVOICE
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: ARPAYMENT
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: BATCH
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: INADJUST
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: INISSUE
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: INKITASSY
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: INRECEIPT
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: POORDER
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: PORECEIPT
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: SOORDER
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'
   NbrStep: 1
   StartDate: '1900-01-01'
 - NumberingID: SOSHIPMENT
+  NewSymbol: '<NEW>'
   StartNbr: '000000'
   EndNbr: '999999'
   WarnNbr: '999990'

{acumatica_cli-0.32.0 → acumatica_cli-0.34.0}/src/acumatica_cli/tenant.py

@@ -1,7 +1,7 @@
 """Tenant CRUD on the instance.
 
-Thin SSH wrapper around ac.exe CompanyConfig (the only supported CLI route,
-see docs/ac-exe.md) plus a sqlcmd read side.
+Thin SSH wrapper around ac.exe CompanyConfig (the only supported CLI route)
+plus a sqlcmd read side.
 """
 
 import subprocess
@@ -15,8 +15,8 @@ class Tenant(Model):
 
     login_name is dbo.Company.CompanyKey — the name on the sign-in page and
     the REST login's tenant value. company_cd is dbo.Company.CompanyCD; ac.exe
-    auto-generates it (Company2, Company3, …) and ignores LoginName for it
-    (docs/ac-exe.md). ``acu tenant create`` aligns CompanyCD to the login
+    auto-generates it (Company2, Company3, …) and ignores LoginName for it.
+    ``acu tenant create`` aligns CompanyCD to the login
     after CompanyConfig so list Login and CD match.
     """
 
@@ -97,8 +97,8 @@ class TenantManager:
 
         The tenant map loads at app start; without this, tenants created or
         deleted by CompanyConfig stay invisible to the sign-in page and REST
-        routing silently falls back to the default tenant (docs/rest-api.md).
-        The pool is named after the instance (how acumatica-infra builds it).
+        routing silently falls back to the default tenant.
+        The pool is named after the instance.
         """
         self._ssh(
             "Import-Module WebAdministration; "
@@ -108,7 +108,7 @@ class TenantManager:
     def _company_config(self, company: str, extra: str = "") -> str:
         # -iname AND -h are both required: without -iname CompanyConfig can't
         # find the site; without -h its web.config step dies on a null path
-        # (verified 2026-07-08, docs/ac-exe.md).
+        # (verified 2026-07-08).
         return self._ssh(
             f"& '{AC_EXE}' "
             f'-configmode:"CompanyConfig" -output:"Forced" '
@@ -132,7 +132,7 @@ class TenantManager:
         company_type: '' = clean tenant, 'SalesDemo' = demo data. The admin
         flags preset the tenant's admin to the instance credentials with no
         must-change flag, so the tenant is REST-loginable right after the
-        app-pool recycle — no first-login dance (verified, docs/ac-exe.md).
+        app-pool recycle — no first-login dance (verified live).
 
         Does not set CompanyCD (ac.exe auto-generates it). Call
         :meth:`set_company_cd` after create to align CD with the login.
@@ -199,7 +199,7 @@ class TenantManager:
         Identify by ``company_id`` or ``login_name`` (exactly one). Login is
         the sign-in name / REST tenant value (``CompanyKey``).
 
-        Two verified gotchas (docs/ac-exe.md):
+        Two verified gotchas:
 
         - The sub-key is ``Deleted``, not the officially documented
           ``Delete`` — an unknown key is silently ignored and the run degrades