acumatica-cli 0.4.0__tar.gz → 0.5.0__tar.gz

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acumatica-cli
-Version: 0.4.0
+Version: 0.5.0
 Summary: Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data
 Author: Konstantin Borovik
 Author-email: Konstantin Borovik <kb@lab5.ca>
@@ -15,23 +15,27 @@ Project-URL: Homepage, https://lab5.ca
 Project-URL: Repository, https://github.com/kborovik/acumatica-cli
 Description-Content-Type: text/markdown
 
-# Acumatica Config-as-Code
+# Acumatica GitOps (Config-as-Code)
 
-**`acu`** configures Acumatica ERP from YAML files in a git repo. 
+**`acu`** configures Acumatica ERP from YAML files in a git repo (GitOps). 
 
 **No UI clicks, no Configuration Wizard.**
 
 ## How it works
 
-1. **Read** the target Acumatica deployment and translate its configuration into YAML — config as code.
+1. **Extract** the target Acumatica deployment with `acu extract` — its configuration becomes YAML, config as code.
 2. **Develop** changes in the YAML, in git: edit, review, version.
 3. **Re-deploy** with `acu apply`, then prove the live tenant matches the code with `acu diff`.
 
-Three commands do the work, and every one is safe to re-run:
+Four commands do the work, and every one is safe to re-run:
 
-- **`acu tenant create`** — creates a tenant and bootstraps it in one step, ready for `apply`. Re-running it against an existing tenant republishes the bootstrap package instead of failing.
-- **`acu apply`** — pushes your YAML into the tenant as keyed upserts. Running it twice changes nothing.
+- **`acu tenant create`** — creates a tenant and bootstraps it in one step, ready for `apply`.
+  Re-running it against an existing tenant republishes the bootstrap package instead of failing.
+- **`acu apply`** — pushes your YAML into the tenant as keyed upserts.
+  Running it twice changes nothing.
 - **`acu diff`** — compares your YAML against the live tenant and exits with code 2 on drift.
+- **`acu extract`** — reads a configured tenant and writes the YAML file set back out, the inverse of `apply`.
+  Existing files are skipped unless `--force`.
 
 > **Tested against** Acumatica ERP **26.101.0225** on Windows Server 2025,
 > contract REST endpoint **25.200.001**. Other versions will likely work,
@@ -61,16 +65,18 @@ acu --tenant DEV diff                    # prove zero drift (exit 2 on drift)
 
 ```text
 acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
-    [--username U] [--password P]
+    [--username U] [--password P] [--version] [--completion [SHELL]]
 │
 ├── tenant                            tenant CRUD (ac.exe over SSH — control plane)
 │   ├── list                          CompanyID, sign-in name, internal CD, type
 │   ├── create --id N --login NAME    create + bootstrap; re-run to republish
-│   │          [--type SalesDemo] [--parent N] [--hidden] [--no-init]
+│   │          [--type SalesDemo|T100|U100] [--parent N] [--hidden] [--no-init]
 │   └── delete --id N [--yes]         delete the tenant and its data, recycle app pool
 │
 ├── apply [--dry-run] [FILES...]      push YAML via REST (idempotent PUT upserts)
 ├── diff  [FILES...]                  drift check vs the live tenant (exit 2 on drift)
+├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
+│                                     dump live tenant state as seed YAML (inverse of apply)
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
 └── config                            configuration ops
@@ -79,7 +85,9 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
     └── check                         read-only preflight: discovery, secrets, REST, SSH
 ```
 
-`apply` and `diff` called without FILES default to the scaffolded directories, in order: `bootstrap/`, then `baseline/`, then `setup/`. Run `acu <command> --help` for details on any command.
+`apply` and `diff` called without FILES default to the scaffolded directories, in order: `bootstrap/`, then `baseline/`, then `setup/`.
+`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
 
@@ -186,3 +194,32 @@ Then verify from your workstation — this one test proves both requirements at
 ```sh
 ssh -o BatchMode=yes Administrator@acu-dev1.vm.internal '$PSVersionTable.PSVersion'
 ```
+
+## Development
+
+```sh
+git clone https://github.com/kborovik/acumatica-cli.git
+cd acumatica-cli
+make install    # editable install as a global uv tool
+make 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.
+`make check` must pass before every commit.
+
+### Live end-to-end tier
+
+`make e2e` runs the opt-in live tier against a real Acumatica instance (pytest marker `e2e`, deselected by the default suite).
+
+Configuration is one file: a decrypted `.env` at the repo root names the instance — `ACU_BASE_URL`, `ACU_SSH`, `ACU_TENANT`, `ACU_PASSWORD`.
+`make e2e` refuses to start without it.
+
+The tier is self-contained.
+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`) are created on the way in and always deleted on the way out, so nothing persists.
+
+```sh
+make e2e                                # whole tier, about 20 minutes
+make e2e FILE=test_provision_lifecycle  # one file, by stem or path
+```

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/README.md

@@ -1,20 +1,24 @@
-# Acumatica Config-as-Code
+# Acumatica GitOps (Config-as-Code)
 
-**`acu`** configures Acumatica ERP from YAML files in a git repo. 
+**`acu`** configures Acumatica ERP from YAML files in a git repo (GitOps). 
 
 **No UI clicks, no Configuration Wizard.**
 
 ## How it works
 
-1. **Read** the target Acumatica deployment and translate its configuration into YAML — config as code.
+1. **Extract** the target Acumatica deployment with `acu extract` — its configuration becomes YAML, config as code.
 2. **Develop** changes in the YAML, in git: edit, review, version.
 3. **Re-deploy** with `acu apply`, then prove the live tenant matches the code with `acu diff`.
 
-Three commands do the work, and every one is safe to re-run:
+Four commands do the work, and every one is safe to re-run:
 
-- **`acu tenant create`** — creates a tenant and bootstraps it in one step, ready for `apply`. Re-running it against an existing tenant republishes the bootstrap package instead of failing.
-- **`acu apply`** — pushes your YAML into the tenant as keyed upserts. Running it twice changes nothing.
+- **`acu tenant create`** — creates a tenant and bootstraps it in one step, ready for `apply`.
+  Re-running it against an existing tenant republishes the bootstrap package instead of failing.
+- **`acu apply`** — pushes your YAML into the tenant as keyed upserts.
+  Running it twice changes nothing.
 - **`acu diff`** — compares your YAML against the live tenant and exits with code 2 on drift.
+- **`acu extract`** — reads a configured tenant and writes the YAML file set back out, the inverse of `apply`.
+  Existing files are skipped unless `--force`.
 
 > **Tested against** Acumatica ERP **26.101.0225** on Windows Server 2025,
 > contract REST endpoint **25.200.001**. Other versions will likely work,
@@ -44,16 +48,18 @@ acu --tenant DEV diff                    # prove zero drift (exit 2 on drift)
 
 ```text
 acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
-    [--username U] [--password P]
+    [--username U] [--password P] [--version] [--completion [SHELL]]
 │
 ├── tenant                            tenant CRUD (ac.exe over SSH — control plane)
 │   ├── list                          CompanyID, sign-in name, internal CD, type
 │   ├── create --id N --login NAME    create + bootstrap; re-run to republish
-│   │          [--type SalesDemo] [--parent N] [--hidden] [--no-init]
+│   │          [--type SalesDemo|T100|U100] [--parent N] [--hidden] [--no-init]
 │   └── delete --id N [--yes]         delete the tenant and its data, recycle app pool
 │
 ├── apply [--dry-run] [FILES...]      push YAML via REST (idempotent PUT upserts)
 ├── diff  [FILES...]                  drift check vs the live tenant (exit 2 on drift)
+├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
+│                                     dump live tenant state as seed YAML (inverse of apply)
 ├── schema [--out DIR]                dump the endpoint's OpenAPI schema (swagger.json)
 │
 └── config                            configuration ops
@@ -62,7 +68,9 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
     └── check                         read-only preflight: discovery, secrets, REST, SSH
 ```
 
-`apply` and `diff` called without FILES default to the scaffolded directories, in order: `bootstrap/`, then `baseline/`, then `setup/`. Run `acu <command> --help` for details on any command.
+`apply` and `diff` called without FILES default to the scaffolded directories, in order: `bootstrap/`, then `baseline/`, then `setup/`.
+`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
 
@@ -169,3 +177,32 @@ Then verify from your workstation — this one test proves both requirements at
 ```sh
 ssh -o BatchMode=yes Administrator@acu-dev1.vm.internal '$PSVersionTable.PSVersion'
 ```
+
+## Development
+
+```sh
+git clone https://github.com/kborovik/acumatica-cli.git
+cd acumatica-cli
+make install    # editable install as a global uv tool
+make 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.
+`make check` must pass before every commit.
+
+### Live end-to-end tier
+
+`make e2e` runs the opt-in live tier against a real Acumatica instance (pytest marker `e2e`, deselected by the default suite).
+
+Configuration is one file: a decrypted `.env` at the repo root names the instance — `ACU_BASE_URL`, `ACU_SSH`, `ACU_TENANT`, `ACU_PASSWORD`.
+`make e2e` refuses to start without it.
+
+The tier is self-contained.
+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`) are created on the way in and always deleted on the way out, so nothing persists.
+
+```sh
+make e2e                                # whole tier, about 20 minutes
+make e2e FILE=test_provision_lifecycle  # one file, by stem or path
+```

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.4.0"
+version = "0.5.0"
 description = "Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data"
 authors = [{ name = "Konstantin Borovik", email = "kb@lab5.ca" }]
 readme = "README.md"

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/bootstrap_project.xml

@@ -146,13 +146,64 @@
                 PXAction member on the graph; the name literal confirmed
                 in the PX.Data.dll string heap) and processes every grid
                 row matching the filter - no Selected flags involved.
+  T61 distribution setup chain (screen->graph->PrimaryView read off the
+  live box aspx files 2026-07-13; LAB5 probe evidence in gh issue #10 -
+  five prefs screens gate Vendor/Customer/Warehouse/SalesOrder/
+  PurchaseOrder/Bill/SalesInvoice/Payment/Shipment with
+  PXSetupNotEnteredException 500s until each singleton exists):
+  - INPreferences IN101000 -> INSetupMaint, PrimaryView setup (DAC
+                PX.Objects.IN.INSetup). Numbering fields default
+                (INREGISTER etc.), but the live insert 500 named six
+                fields with no server default (read off the LAB5 PUT
+                2026-07-13): INProgressAcctID/INProgressSubID (the WIP
+                account) + the four reason codes (Issues/Receipt/
+                Adjustment/PI) - all exposed; HoldEntry = the echo flag.
+  - ReasonCode  CS211000 -> ReasonCodeMaint, PrimaryView reasoncode
+                (PX.Objects.CS.ReasonCode) - no Default-endpoint entity,
+                and the INSetup reason-code fields above hard-require
+                rows. Usage takes the stored-word list; AccountID/SubID
+                = the code's GL posting target.
+  - APPreferences AP101000 -> APSetupMaint, PrimaryView Setup (APSetup);
+                HoldEntry echo field, same singleton pattern.
+  - ARPreferences AR101000 -> ARSetupMaint, PrimaryView ARSetupRecord
+                (ARSetup); HoldEntry echo field.
+  - SOPreferences SO101000 -> SOSetupMaint, PrimaryView sosetup (SOSetup);
+                DefaultOrderType doubles as the echo field and the R1
+                probe (does order type SO pre-exist on an empty tenant).
+  - POPreferences PO101000 -> POSetupMaint, PrimaryView Setup (POSetup);
+                HoldReceipts echo field + RCReturnReasonCodeID (the one
+                POSetup field the live insert named as required - a
+                Vendor Return usage reason code, 2026-07-13).
+  - AvailabilityCalculationRule IN201500 -> INAvailabilitySchemeMaint,
+                PrimaryView Schemes (INAvailabilityScheme) - an empty
+                tenant has zero scheme rows and ItemClass 422s
+                "'Availability Calculation Rule' cannot be empty"; the
+                Incl* booleans all carry defaults, so the entity exposes
+                the key + Description only.
+  - PostingClass IN206000 -> INPostClassMaint, PrimaryView postclass
+                (INPostClass) - no Default-endpoint entity; StockItem
+                posting resolution needs it. Exposes id + descr, the six
+                acct-source combos (stored-word lists), the six acct/sub
+                segment-mask pairs, and the six sub masks - grid/form
+                bindings read off IN206000.aspx.
+  - CAPreferences CA101000 -> CASetupMaint, PrimaryView CASetupRecord
+                (PX.Objects.CA.CASetup) - CashAccount answers 500
+                PXSetupNotEnteredException until the singleton exists
+                (live-read 2026-07-13). TransitAcctId (DAC spelling off
+                the aspx - lowercase d) + TransitSubID = the cash-in-
+                transit pair; HoldEntry = the echo flag.
+  - CashAccount CA202000 -> CashAccountMaint, PrimaryView CashAccount
+                (PX.Objects.CA.CashAccount) - Default endpoint answers
+                404. CuryID stays out (derived from the GL account,
+                B11 server-derived class); payment-method links are the
+                conditional PaymentMethodAccount follow-up, not here.
   Contract field names = DAC property names verbatim (no rename layer).
   Features (CS100000) stays OUT of the endpoint - writes through any
   contract endpoint do not persist (T3 verdict); the plugin owns features.
 -->
-<Customization level="" description="acu bootstrap: CustomizationPlugin enables features on publish; Bootstrap endpoint exposes company + credit terms + financial currency + GL preferences + ledger-company link + financial year + calendars + period activation" product-version="26.101">
+<Customization level="" description="acu bootstrap: CustomizationPlugin enables features on publish; Bootstrap endpoint exposes company + credit terms + financial currency + GL preferences + ledger-company link + financial year + calendars + period activation + module preferences (IN/AP/AR/SO/PO) + availability rule + posting class + cash account" product-version="26.101">
   <EntityEndpoint>
-    <Endpoint xmlns="http://www.acumatica.com/entity/maintenance/5.31" name="Bootstrap" version="1.4.0" systemContractVersion="4">
+    <Endpoint xmlns="http://www.acumatica.com/entity/maintenance/5.31" name="Bootstrap" version="1.5.0" systemContractVersion="4">
       <TopLevelEntity name="Company" screen="CS101500">
         <Fields>
           <Field name="AcctCD" type="StringValue" />
@@ -455,6 +506,282 @@
           </Mapping>
         </Mappings>
       </TopLevelEntity>
+      <TopLevelEntity name="INPreferences" screen="IN101000">
+        <Fields>
+          <Field name="HoldEntry" type="BooleanValue" />
+          <Field name="INProgressAcctID" type="StringValue" />
+          <Field name="INProgressSubID" type="StringValue" />
+          <Field name="IssuesReasonCode" type="StringValue" />
+          <Field name="ReceiptReasonCode" type="StringValue" />
+          <Field name="AdjustmentReasonCode" type="StringValue" />
+          <Field name="PIReasonCode" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="HoldEntry">
+            <To object="setup" field="HoldEntry" />
+          </Mapping>
+          <Mapping field="INProgressAcctID">
+            <To object="setup" field="INProgressAcctID" />
+          </Mapping>
+          <Mapping field="INProgressSubID">
+            <To object="setup" field="INProgressSubID" />
+          </Mapping>
+          <Mapping field="IssuesReasonCode">
+            <To object="setup" field="IssuesReasonCode" />
+          </Mapping>
+          <Mapping field="ReceiptReasonCode">
+            <To object="setup" field="ReceiptReasonCode" />
+          </Mapping>
+          <Mapping field="AdjustmentReasonCode">
+            <To object="setup" field="AdjustmentReasonCode" />
+          </Mapping>
+          <Mapping field="PIReasonCode">
+            <To object="setup" field="PIReasonCode" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="ReasonCode" screen="CS211000">
+        <Fields>
+          <Field name="ReasonCodeID" type="StringValue" />
+          <Field name="Descr" type="StringValue" />
+          <Field name="Usage" type="StringValue" />
+          <Field name="AccountID" type="StringValue" />
+          <Field name="SubID" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="ReasonCodeID">
+            <To object="reasoncode" field="ReasonCodeID" />
+          </Mapping>
+          <Mapping field="Descr">
+            <To object="reasoncode" field="Descr" />
+          </Mapping>
+          <Mapping field="Usage">
+            <To object="reasoncode" field="Usage" />
+          </Mapping>
+          <Mapping field="AccountID">
+            <To object="reasoncode" field="AccountID" />
+          </Mapping>
+          <Mapping field="SubID">
+            <To object="reasoncode" field="SubID" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="APPreferences" screen="AP101000">
+        <Fields>
+          <Field name="HoldEntry" type="BooleanValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="HoldEntry">
+            <To object="Setup" field="HoldEntry" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="ARPreferences" screen="AR101000">
+        <Fields>
+          <Field name="HoldEntry" type="BooleanValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="HoldEntry">
+            <To object="ARSetupRecord" field="HoldEntry" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="SOPreferences" screen="SO101000">
+        <Fields>
+          <Field name="DefaultOrderType" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="DefaultOrderType">
+            <To object="sosetup" field="DefaultOrderType" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="POPreferences" screen="PO101000">
+        <Fields>
+          <Field name="HoldReceipts" type="BooleanValue" />
+          <Field name="RCReturnReasonCodeID" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="HoldReceipts">
+            <To object="Setup" field="HoldReceipts" />
+          </Mapping>
+          <Mapping field="RCReturnReasonCodeID">
+            <To object="Setup" field="RCReturnReasonCodeID" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="AvailabilityCalculationRule" screen="IN201500">
+        <Fields>
+          <Field name="AvailabilitySchemeID" type="StringValue" />
+          <Field name="Description" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="AvailabilitySchemeID">
+            <To object="Schemes" field="AvailabilitySchemeID" />
+          </Mapping>
+          <Mapping field="Description">
+            <To object="Schemes" field="Description" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="PostingClass" screen="IN206000">
+        <Fields>
+          <Field name="PostClassID" type="StringValue" />
+          <Field name="Descr" type="StringValue" />
+          <Field name="InvtAcctDefault" type="StringValue" />
+          <Field name="SalesAcctDefault" type="StringValue" />
+          <Field name="COGSAcctDefault" type="StringValue" />
+          <Field name="POAccrualAcctDefault" type="StringValue" />
+          <Field name="PPVAcctDefault" type="StringValue" />
+          <Field name="LCVarianceAcctDefault" type="StringValue" />
+          <Field name="InvtSubMask" type="StringValue" />
+          <Field name="SalesSubMask" type="StringValue" />
+          <Field name="COGSSubMask" type="StringValue" />
+          <Field name="POAccrualSubMask" type="StringValue" />
+          <Field name="PPVSubMask" type="StringValue" />
+          <Field name="LCVarianceSubMask" type="StringValue" />
+          <Field name="InvtAcctID" type="StringValue" />
+          <Field name="InvtSubID" type="StringValue" />
+          <Field name="SalesAcctID" type="StringValue" />
+          <Field name="SalesSubID" type="StringValue" />
+          <Field name="COGSAcctID" type="StringValue" />
+          <Field name="COGSSubID" type="StringValue" />
+          <Field name="POAccrualAcctID" type="StringValue" />
+          <Field name="POAccrualSubID" type="StringValue" />
+          <Field name="PPVAcctID" type="StringValue" />
+          <Field name="PPVSubID" type="StringValue" />
+          <Field name="LCVarianceAcctID" type="StringValue" />
+          <Field name="LCVarianceSubID" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="PostClassID">
+            <To object="postclass" field="PostClassID" />
+          </Mapping>
+          <Mapping field="Descr">
+            <To object="postclass" field="Descr" />
+          </Mapping>
+          <Mapping field="InvtAcctDefault">
+            <To object="postclass" field="InvtAcctDefault" />
+          </Mapping>
+          <Mapping field="SalesAcctDefault">
+            <To object="postclass" field="SalesAcctDefault" />
+          </Mapping>
+          <Mapping field="COGSAcctDefault">
+            <To object="postclass" field="COGSAcctDefault" />
+          </Mapping>
+          <Mapping field="POAccrualAcctDefault">
+            <To object="postclass" field="POAccrualAcctDefault" />
+          </Mapping>
+          <Mapping field="PPVAcctDefault">
+            <To object="postclass" field="PPVAcctDefault" />
+          </Mapping>
+          <Mapping field="LCVarianceAcctDefault">
+            <To object="postclass" field="LCVarianceAcctDefault" />
+          </Mapping>
+          <Mapping field="InvtSubMask">
+            <To object="postclass" field="InvtSubMask" />
+          </Mapping>
+          <Mapping field="SalesSubMask">
+            <To object="postclass" field="SalesSubMask" />
+          </Mapping>
+          <Mapping field="COGSSubMask">
+            <To object="postclass" field="COGSSubMask" />
+          </Mapping>
+          <Mapping field="POAccrualSubMask">
+            <To object="postclass" field="POAccrualSubMask" />
+          </Mapping>
+          <Mapping field="PPVSubMask">
+            <To object="postclass" field="PPVSubMask" />
+          </Mapping>
+          <Mapping field="LCVarianceSubMask">
+            <To object="postclass" field="LCVarianceSubMask" />
+          </Mapping>
+          <Mapping field="InvtAcctID">
+            <To object="postclass" field="InvtAcctID" />
+          </Mapping>
+          <Mapping field="InvtSubID">
+            <To object="postclass" field="InvtSubID" />
+          </Mapping>
+          <Mapping field="SalesAcctID">
+            <To object="postclass" field="SalesAcctID" />
+          </Mapping>
+          <Mapping field="SalesSubID">
+            <To object="postclass" field="SalesSubID" />
+          </Mapping>
+          <Mapping field="COGSAcctID">
+            <To object="postclass" field="COGSAcctID" />
+          </Mapping>
+          <Mapping field="COGSSubID">
+            <To object="postclass" field="COGSSubID" />
+          </Mapping>
+          <Mapping field="POAccrualAcctID">
+            <To object="postclass" field="POAccrualAcctID" />
+          </Mapping>
+          <Mapping field="POAccrualSubID">
+            <To object="postclass" field="POAccrualSubID" />
+          </Mapping>
+          <Mapping field="PPVAcctID">
+            <To object="postclass" field="PPVAcctID" />
+          </Mapping>
+          <Mapping field="PPVSubID">
+            <To object="postclass" field="PPVSubID" />
+          </Mapping>
+          <Mapping field="LCVarianceAcctID">
+            <To object="postclass" field="LCVarianceAcctID" />
+          </Mapping>
+          <Mapping field="LCVarianceSubID">
+            <To object="postclass" field="LCVarianceSubID" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="CAPreferences" screen="CA101000">
+        <Fields>
+          <Field name="HoldEntry" type="BooleanValue" />
+          <Field name="TransitAcctId" type="StringValue" />
+          <Field name="TransitSubID" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="HoldEntry">
+            <To object="CASetupRecord" field="HoldEntry" />
+          </Mapping>
+          <Mapping field="TransitAcctId">
+            <To object="CASetupRecord" field="TransitAcctId" />
+          </Mapping>
+          <Mapping field="TransitSubID">
+            <To object="CASetupRecord" field="TransitSubID" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="CashAccount" screen="CA202000">
+        <Fields>
+          <Field name="CashAccountCD" type="StringValue" />
+          <Field name="Descr" type="StringValue" />
+          <Field name="AccountID" type="StringValue" />
+          <Field name="SubID" type="StringValue" />
+          <Field name="BranchID" type="StringValue" />
+          <Field name="Active" type="BooleanValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="CashAccountCD">
+            <To object="CashAccount" field="CashAccountCD" />
+          </Mapping>
+          <Mapping field="Descr">
+            <To object="CashAccount" field="Descr" />
+          </Mapping>
+          <Mapping field="AccountID">
+            <To object="CashAccount" field="AccountID" />
+          </Mapping>
+          <Mapping field="SubID">
+            <To object="CashAccount" field="SubID" />
+          </Mapping>
+          <Mapping field="BranchID">
+            <To object="CashAccount" field="BranchID" />
+          </Mapping>
+          <Mapping field="Active">
+            <To object="CashAccount" field="Active" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
     </Endpoint>
   </EntityEndpoint>
 </Customization>

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/client.py

@@ -14,15 +14,42 @@ from .config import Instance
 
 
 def wrap(record: dict[str, Any]) -> dict[str, Any]:
-    """Plain dict -> contract-API body: {"Field": {"value": ...}}."""
-    return {k: {"value": v} for k, v in record.items()}
+    """Plain dict -> contract-API body: {"Field": {"value": ...}}.
+
+    A list value is a detail array (T60): the list itself is NEVER
+    value-wrapped, each dict row wraps recursively — the shape the live
+    JournalTransaction PUT proved (T50/T37 e2e payload). The contract's
+    OWN control fields travel bare, never value-wrapped: `id` (row GUID —
+    the only handle that makes a detail-row PUT an update instead of an
+    insert) and `delete` (row-removal marker).
+    """
+
+    def _value(v: Any) -> Any:
+        if isinstance(v, list):
+            return [wrap(row) if isinstance(row, dict) else row for row in v]
+        return {"value": v}
+
+    return {k: v if k in ("id", "delete") else _value(v) for k, v in record.items()}
 
 
 def unwrap(entity: dict[str, Any]) -> dict[str, Any]:
-    """Contract-API entity -> plain dict (top-level value fields only)."""
-    return {
-        k: v["value"] for k, v in entity.items() if isinstance(v, dict) and "value" in v
-    }
+    """Contract-API entity -> plain dict (value fields + detail arrays).
+
+    Inverse of wrap (T60): a list of dicts unwraps row by row; lists that
+    are empty or whose rows carry no value fields are elided (a detail
+    array the source never claimed must not surface, and expanded `files`
+    descriptors are plain dicts that would unwrap to noise). Non-value
+    dicts (custom, _links, note) stay excluded as before.
+    """
+    out: dict[str, Any] = {}
+    for k, v in entity.items():
+        if isinstance(v, dict) and "value" in v:
+            out[k] = v["value"]
+        elif isinstance(v, list) and v and all(isinstance(row, dict) for row in v):
+            rows = [unwrap(row) for row in v]
+            if any(rows):
+                out[k] = rows
+    return out
 
 
 # The list GET's optimized-export failure (B9): the contract API's list GET
@@ -159,7 +186,11 @@ class AcumaticaClient:
         ).json()
 
     def get_record(
-        self, entity: str, keys: Sequence[Any], endpoint: str | None = None
+        self,
+        entity: str,
+        keys: Sequence[Any],
+        endpoint: str | None = None,
+        params: dict[str, str] | None = None,
     ) -> dict[str, Any] | None:
         """GET one record by key URL — the delegate-view-safe read (B9).
 
@@ -167,10 +198,12 @@ class AcumaticaClient:
         scope maps to a BQL-delegate view; the key-URL form skips the
         optimizer and returns the full record (verified vs 26.101.0225).
         Returns None when no record matches — the server answers that with
-        a 500 NoEntitySatisfiesTheConditionException, not a 404.
+        a 500 NoEntitySatisfiesTheConditionException, not a 404. Detail
+        arrays only travel under a $expand param (T60), same as the list
+        GET.
         """
         path = "/".join(quote(str(k), safe="") for k in keys)
-        r = self._http.get(f"{self._url(entity, endpoint)}/{path}")
+        r = self._http.get(f"{self._url(entity, endpoint)}/{path}", params=params)
         if r.status_code == 500:
             try:
                 missing = "NoEntitySatisfiesTheCondition" in r.json().get(

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/seed.py

@@ -7,18 +7,34 @@ Baseline file format:
 
     entity: Currency          # entity name in the contract endpoint
     key: CurrencyID           # key field(s), string or list
-    endpoint: Bootstrap/1.4.0 # optional: override the instance endpoint
+    endpoint: Bootstrap/1.5.0 # optional: override the instance endpoint
     records:
       - CurrencyID: "CAD"
         Description: Canadian Dollar
 
+A record field holding a LIST is a detail array (T60) - each row a field
+map, PUT with the whole record (the list itself never value-wrapped).
+Every list field needs a detail_keys entry naming the field that
+identifies its rows; diff matches rows by that key, order-insensitive,
+and unlike top-level records an extra live detail row IS drift - the
+record owns its list:
+
+    entity: KitSpecification
+    key: [KitInventoryID, RevisionID]
+    detail_keys: { StockComponents: ComponentID }
+    records:
+      - KitInventoryID: GW-EDGE
+        RevisionID: V1
+        StockComponents:
+          - { ComponentID: MB-CM4, ComponentQty: 1 }
+
 Action file format (setup/*.yaml) - desired state realized by a contract
 action plus a done_when live-state probe, for setup verbs a keyed PUT
 cannot express (calendar generation and the like):
 
     action: GenerateCalendar          # action name on the endpoint entity
     entity: MasterCalendar            # entity the action hangs off
-    endpoint: Bootstrap/1.4.0         # optional: override the instance endpoint
+    endpoint: Bootstrap/1.5.0         # optional: override the instance endpoint
     record:     { FinancialYear: 2026 }
     parameters: { FromYear: 2026, ToYear: 2026 }   # optional
     done_when:  { filter: "FinancialYear eq '2026'" }
@@ -85,6 +101,7 @@ class BaselineFile(Model):
     keys: list[str] = Field(alias="key")
     records: list[dict[str, Any]]
     endpoint: str | None = None  # bootstrap YAML targets the custom endpoint
+    detail_keys: dict[str, str] | None = None  # {ListField: RowKeyField} (T60)
 
     @field_validator("keys", mode="before")
     @classmethod
@@ -109,8 +126,40 @@ class BaselineFile(Model):
                     "identify each record"
                 )
             seen.add(ident)
+            self._check_details(i, record)
         return self
 
+    def _check_details(self, i: int, record: dict[str, Any]) -> None:
+        # T60, the V25 sibling for detail arrays: every list field needs a
+        # detail_keys entry (diff cannot match rows without one) and that
+        # key must identify each source row - a dup diffs as permanent
+        # false drift exactly like B21's top-level class
+        for field, value in record.items():
+            if not isinstance(value, list):
+                continue
+            key = (self.detail_keys or {}).get(field)
+            if key is None:
+                raise ValueError(
+                    f"entity '{self.entity}': records[{i}].{field} is a "
+                    "detail list but has no detail_keys entry - add "
+                    f"detail_keys: {{{field}: <RowKeyField>}}"
+                )
+            seen_rows: set[str] = set()
+            for j, row in enumerate(value):
+                if not isinstance(row, dict) or key not in row:
+                    raise ValueError(
+                        f"entity '{self.entity}': records[{i}].{field}[{j}] "
+                        f"missing detail key field '{key}'"
+                    )
+                ident = str(row[key])
+                if ident in seen_rows:
+                    raise ValueError(
+                        f"entity '{self.entity}': records[{i}].{field}[{j}] "
+                        f"duplicates detail key [{ident}] - the detail key "
+                        "must identify each row"
+                    )
+                seen_rows.add(ident)
+
 
 class DoneProbe(Model):
     """The done_when live-state probe: entity/endpoint default to the action's."""
@@ -169,8 +218,20 @@ def _norm(value: Any) -> str:
 def _filter_for(record: dict[str, Any], keys: list[str]) -> str:
     # callers pass single-view key sets only: a conjunction spanning the
     # entity's views answers 200 [] (B14), so _fetch filters on the first
-    # key alone and matches the rest client-side
-    return " and ".join(f"{k} eq '{record[k]}'" for k in keys)
+    # key alone and matches the rest client-side. Literal typing follows
+    # the YAML scalar type: bools and numbers travel bare - a quoted
+    # 'false' against Edm.Boolean answers 500 "binary operator with
+    # incompatible types" (T61 - INPreferences keyed on HoldEntry), and
+    # numeric Edm types are the same class. Strings stay quoted, so
+    # numeric-looking codes ('000000') are unaffected.
+    def literal(value: Any) -> str:
+        if isinstance(value, bool):
+            return str(value).lower()
+        if isinstance(value, int | float):
+            return str(value)
+        return f"'{value}'"
+
+    return " and ".join(f"{k} eq {literal(record[k])}" for k in keys)
 
 
 def _probe(client: AcumaticaClient, action: ActionFile) -> bool:
@@ -223,11 +284,50 @@ def apply(
         if dry_run:
             output.data(f"  would PUT {baseline.entity} [{label}]")
         else:
-            client.put(baseline.entity, record, endpoint=baseline.endpoint)
+            body = record
+            if any(isinstance(v, list) for v in record.values()):
+                body = _with_detail_ids(client, baseline, record)
+            client.put(baseline.entity, body, endpoint=baseline.endpoint)
             output.data(f"  PUT {baseline.entity} [{label}]")
     return len(baseline.records)
 
 
+def _with_detail_ids(
+    client: AcumaticaClient, baseline: BaselineFile, record: dict[str, Any]
+) -> dict[str, Any]:
+    """Source record + live detail-row ids — the detail upsert handle (T60).
+
+    The contract API matches detail rows by row GUID only: a re-PUT
+    without ids re-INSERTS every row (live-verified on KitSpecification —
+    500 "Component Item must be unique"). So apply pre-fetches the live
+    record, injects each matching live row's `id` (matched by the
+    detail_keys field), and appends `{id, delete: true}` rows for live
+    rows the source no longer claims — the record owns its list (V4
+    detail semantics), so apply converges exactly what diff would flag.
+    Record absent live → first PUT creates, rows travel id-less.
+    """
+    live = _fetch(client, baseline, record)
+    if live is None:
+        return record
+    out = dict(record)
+    for field, rows in record.items():
+        if not isinstance(rows, list):
+            continue
+        key = (baseline.detail_keys or {})[field]  # load-validated
+        live_ids: dict[str, Any] = {}
+        for live_row in live.get(field) or []:
+            value = live_row.get(key)
+            if isinstance(value, dict) and "value" in value and "id" in live_row:
+                live_ids[_norm(value["value"])] = live_row["id"]
+        merged: list[dict[str, Any]] = []
+        for row in rows:
+            row_id = live_ids.pop(_norm(row[key]), None)
+            merged.append({**row, "id": row_id} if row_id is not None else row)
+        merged.extend({"id": row_id, "delete": True} for row_id in live_ids.values())
+        out[field] = merged
+    return out
+
+
 def _fetch(
     client: AcumaticaClient, baseline: BaselineFile, record: dict[str, Any]
 ) -> dict[str, Any] | None:
@@ -244,18 +344,27 @@ def _fetch(
     CuryRecords, B9) 500 on that optimized export; the key-URL
     single-record GET skips the optimizer, so diff falls back to it on
     exactly that error (V4: read-back must survive delegate-view entities).
+
+    Detail arrays only travel under $expand (T60): without it every GET
+    answers top-level fields alone, diff would report each source detail
+    row missing and apply's id-injection would see nothing to match.
     """
+    params = {"$filter": _filter_for(record, baseline.keys[:1])}
+    detail_fields = [f for f in (baseline.detail_keys or {}) if f in record]
+    if detail_fields:
+        params["$expand"] = ",".join(sorted(detail_fields))
     try:
         live = client.get_list(
-            baseline.entity,
-            params={"$filter": _filter_for(record, baseline.keys[:1])},
-            endpoint=baseline.endpoint,
+            baseline.entity, params=params, endpoint=baseline.endpoint
         )
     except RuntimeError as err:
         if OPTIMIZATION_500 not in str(err):
             raise
         return client.get_record(
-            baseline.entity, [record[k] for k in baseline.keys], baseline.endpoint
+            baseline.entity,
+            [record[k] for k in baseline.keys],
+            baseline.endpoint,
+            params={"$expand": params["$expand"]} if detail_fields else None,
         )
     for row in live:
         actual = unwrap(row)
@@ -290,10 +399,51 @@ def diff(client: AcumaticaClient, baseline: BaselineFile | ActionFile) -> list[s
             continue
         actual = unwrap(live)
         for field, expected in record.items():
-            if field not in actual:
+            if isinstance(expected, list):
+                key = (baseline.detail_keys or {})[field]  # load-validated
+                live_rows = actual.get(field, [])
+                drifts.extend(_diff_details(label, field, key, expected, live_rows))
+            elif field not in actual:
                 drifts.append(f"{label}.{field}: not returned by endpoint")
             elif _norm(actual[field]) != _norm(expected):
                 drifts.append(
                     f"{label}.{field}: source={expected!r} live={actual[field]!r}"
                 )
     return drifts
+
+
+def _diff_details(
+    label: str,
+    field: str,
+    key: str,
+    expected: list[dict[str, Any]],
+    live_rows: list[dict[str, Any]],
+) -> list[str]:
+    """Detail-array drift (T60): rows matched by detail key, order-insensitive.
+
+    Unlike top-level records (V4 exemption), an extra live detail row IS
+    drift - the record owns its list, apply cannot converge a live row the
+    source never claimed. Within a matched row only source-side fields
+    compare (server-derived LineNbr and ids stay omitted from source).
+    """
+    drifts: list[str] = []
+    live_by_key = {_norm(row[key]): row for row in live_rows if key in row}
+    for row in expected:
+        ident = _norm(row[key])
+        live_row = live_by_key.pop(ident, None)
+        if live_row is None:
+            drifts.append(f"{label}.{field}[{row[key]}]: missing on tenant")
+            continue
+        for sub, want in row.items():
+            if sub not in live_row:
+                drifts.append(
+                    f"{label}.{field}[{row[key]}].{sub}: not returned by endpoint"
+                )
+            elif _norm(live_row[sub]) != _norm(want):
+                drifts.append(
+                    f"{label}.{field}[{row[key]}].{sub}: "
+                    f"source={want!r} live={live_row[sub]!r}"
+                )
+    for ident in live_by_key:
+        drifts.append(f"{label}.{field}[{ident}]: extra on tenant")
+    return drifts

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/templates/baseline/50-gl-preferences.yaml

@@ -1,4 +1,4 @@
-# General Ledger preferences (GL102000) via the custom Bootstrap/1.4.0
+# General Ledger preferences (GL102000) via the custom Bootstrap/1.5.0
 # endpoint (the per-file endpoint: override) - the Default endpoint has
 # no GL-setup entity, and every Finance screen throws
 # PXSetupNotEnteredException until the GLSetup singleton row exists. The
@@ -12,7 +12,7 @@
 # referenced here must exist.
 entity: GLPreferences
 key: RetEarnAccountID
-endpoint: Bootstrap/1.4.0
+endpoint: Bootstrap/1.5.0
 records:
 - RetEarnAccountID: '32000'
   YtdNetIncAccountID: '33000'

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/templates/baseline/60-ledger-company.yaml

@@ -1,4 +1,4 @@
-# Org-ledger link (GL201500) via the custom Bootstrap/1.4.0 endpoint (the
+# Org-ledger link (GL201500) via the custom Bootstrap/1.5.0 endpoint (the
 # per-file endpoint: override). The Default endpoint's Ledger.Companies
 # detail is write-tolerated then silently dropped (PUT answers 200 and
 # echoes the row, the link table stays empty), so the link writes through
@@ -21,7 +21,7 @@
 # (company.yaml).
 entity: LedgerCompany
 key: [LedgerCD, OrganizationID]
-endpoint: Bootstrap/1.4.0
+endpoint: Bootstrap/1.5.0
 records:
 - LedgerCD: ACTUAL
   OrganizationID: COMPANY

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/templates/bootstrap/company.yaml

@@ -1,11 +1,11 @@
-# Company (CS101500) via the custom Bootstrap/1.4.0 endpoint (the per-file
+# Company (CS101500) via the custom Bootstrap/1.5.0 endpoint (the per-file
 # endpoint: override) - built-in endpoints cannot create the first
 # organization on a virgin tenant. List values are the EXTERNAL labels
 # ('Without Branches', not the DAC's 'WithoutBranches'); CountryID feeds
 # the org's Main Address - required on first save.
 entity: Company
 key: AcctCD
-endpoint: Bootstrap/1.4.0
+endpoint: Bootstrap/1.5.0
 records:
 - AcctCD: COMPANY
   AcctName: Example Company

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/templates/bootstrap/credit-terms.yaml

@@ -1,11 +1,11 @@
-# Credit terms (CS206500) via the custom Bootstrap/1.4.0 endpoint (the
+# Credit terms (CS206500) via the custom Bootstrap/1.5.0 endpoint (the
 # per-file endpoint: override) - the Default endpoint has no credit-terms
 # entity. List values are the EXTERNAL labels: VisibleTo = All, Vendors,
 # Customers, Disabled; DueType/DiscType = Fixed Number of Days, Day of
 # Next Month, End of Month, ...
 entity: CreditTerms
 key: TermsID
-endpoint: Bootstrap/1.4.0
+endpoint: Bootstrap/1.5.0
 records:
 - TermsID: NET30
   Descr: Net 30 Days

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/templates/setup/10-financial-year.yaml

@@ -19,7 +19,7 @@
 # generation consumes this setup row.
 action: GeneratePeriods
 entity: FinancialYearSettings
-endpoint: Bootstrap/1.4.0
+endpoint: Bootstrap/1.5.0
 record:
   BegFinYear: "2026-01-01"
   FinPeriods: 12

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/templates/setup/20-master-calendar.yaml

@@ -17,7 +17,7 @@
 # consumes the FinYearSetup row it creates.
 action: GenerateCalendar
 entity: MasterCalendar
-endpoint: Bootstrap/1.4.0
+endpoint: Bootstrap/1.5.0
 record:
   FinancialYear: "2026"
 parameters:

{acumatica_cli-0.4.0 → acumatica_cli-0.5.0}/src/acumatica_cli/templates/setup/30-open-periods.yaml

@@ -22,7 +22,7 @@
 # consumes the periods generation creates.
 action: ProcessAll
 entity: ManagePeriods
-endpoint: Bootstrap/1.4.0
+endpoint: Bootstrap/1.5.0
 record:
   Action: Open
   FromYear: "2026"