acumatica-cli 0.29.0__tar.gz → 0.30.0__tar.gz

{acumatica_cli-0.29.0 → acumatica_cli-0.30.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acumatica-cli
-Version: 0.29.0
+Version: 0.30.0
 Summary: Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data
 Author: Konstantin Borovik
 Author-email: Konstantin Borovik <kb@lab5.ca>
@@ -45,7 +45,7 @@ YAML in git is the source of truth; the live tenant is the target. `apply` is th
 | Capture derived balances | `state` | Inquire trial-balance etc. into `state/` (not seed) |
 | Create and destroy tenants | `tenant` | SSH control plane: list / create / delete / recycle |
 | Publish the Bootstrap contract | `bootstrap` | REST publish of AcuBootstrap (or `--export` zip for the UI) |
-| Prove a cold rebuild | `check` | create, then apply, then run, then diff on a fresh tenant |
+| Prove a cold rebuild | `tenant create` then `apply` then `run` then `diff` | Compose on a fresh tenant. No wrap command. |
 | Snapshot a site offline | `inventory` | SM203520 XML ZIP or `ac.exe export xml` writes `inventory/` |
 | Cross-check snapshot vs seed | `reconcile` | `inventory/` plus optional `config/` writes `findings/` only |
 | Dump the contract schema | `schema` | OpenAPI `swagger.json` for the pinned endpoint |
@@ -76,7 +76,6 @@ acu --tenant DEV apply config/           # seed config/{bootstrap,baseline,setup
 acu --tenant DEV run scenario/           # once capital → buy → build → sell
 acu --tenant DEV diff config/            # prove zero drift (exit 2 on drift)
 acu --tenant DEV state                   # capture state/ trial-balance
-acu check --yes --tenant DEV             # cold lifecycle create→apply→run→diff (leave tenant)
 ```
 
 Bare `apply` / `diff` (no path args) also prefer `config/` when those trees exist.
@@ -115,7 +114,6 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 ├── apply [--dry-run] [FILES...]      push YAML via REST (idempotent PUT upserts)
 ├── diff  [FILES...]                  drift check vs the live tenant (exit 2 on drift)
 ├── run   [--dry-run] [FILES...]      execute transaction scenario YAML (exit 1 on any miss)
-├── check [--yes] [--tenant L]        cold lifecycle create→apply→run→diff; leave tenant (V47)
 ├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
 │                                     capture derived state into state/ (not seed)
 ├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
@@ -285,7 +283,6 @@ Ad-hoc override: `acu --api-version 24.200.001 …` (version half only, never
 `base_url` resolves as `--url`, else `ACU_BASE_URL`, else a hard error naming sources.
 
 `acu config show` prints the resolved `.env` (password excluded; includes `ACU_API_VERSION`).
-`acu check` (lifecycle) uses the same resolved instance.
 
 ### Multi-host overlays (V44)
 
@@ -317,9 +314,6 @@ acu diff
 # explicit path args (no auto) — later path wins same keys
 acu apply config/ overlays/default-24.200.001/
 acu diff config/ overlays/default-24.200.001/
-
-# cold lifecycle vs the resolved .env instance (SSH + tenant required)
-acu check --yes --tenant LAB5
 ```
 
 Add a future half by creating `overlays/default-<new-half>/` with the
@@ -335,7 +329,7 @@ Worth knowing:
 - Without a `.env`, global flags plus the process environment supply the configuration.
 - When `ACU_SSH` is **absent**, acu defaults to `Administrator@` + the resolved base_url hostname.
   A **present blank** `ACU_SSH=` is the hosted opt-out.
-  Only `acu tenant` / `acu check` require a non-empty value post-default.
+  Only `acu tenant` requires a non-empty value post-default.
 - `acu config show` prints the resolved `.env` (password excluded).
 - Redirect it to turn resolved state into a working config: `acu config show > .env`.
 
@@ -383,7 +377,9 @@ gmake release patch   # or minor | major
 2. Fail if `## Unreleased` has no bullets
 3. Bump `pyproject.toml` version (`major` | `minor` | `patch`)
 4. Promote Unreleased body to `## [vX.Y.Z] - YYYY-MM-DD`, leave an empty `## Unreleased`
-5. Commit `CHANGELOG.md` + `pyproject.toml` (+ lock if bumped) together, tag `vX.Y.Z`, push
+5. Commit `CHANGELOG.md` + `pyproject.toml` (+ lock if bumped) together, tag `vX.Y.Z`
+6. `gmake check` again on the promoted tree
+7. Push tag + branch — GitHub Actions publishes
 
 GitHub Actions on tag `v*` re-runs CI, builds sdist+wheel, publishes to PyPI via OIDC trusted publishing, and creates a GitHub Release whose notes are the promoted CHANGELOG section for that tag (plus the artifacts).
 

{acumatica_cli-0.29.0 → acumatica_cli-0.30.0}/README.md

@@ -27,7 +27,7 @@ YAML in git is the source of truth; the live tenant is the target. `apply` is th
 | Capture derived balances | `state` | Inquire trial-balance etc. into `state/` (not seed) |
 | Create and destroy tenants | `tenant` | SSH control plane: list / create / delete / recycle |
 | Publish the Bootstrap contract | `bootstrap` | REST publish of AcuBootstrap (or `--export` zip for the UI) |
-| Prove a cold rebuild | `check` | create, then apply, then run, then diff on a fresh tenant |
+| Prove a cold rebuild | `tenant create` then `apply` then `run` then `diff` | Compose on a fresh tenant. No wrap command. |
 | Snapshot a site offline | `inventory` | SM203520 XML ZIP or `ac.exe export xml` writes `inventory/` |
 | Cross-check snapshot vs seed | `reconcile` | `inventory/` plus optional `config/` writes `findings/` only |
 | Dump the contract schema | `schema` | OpenAPI `swagger.json` for the pinned endpoint |
@@ -58,7 +58,6 @@ acu --tenant DEV apply config/           # seed config/{bootstrap,baseline,setup
 acu --tenant DEV run scenario/           # once capital → buy → build → sell
 acu --tenant DEV diff config/            # prove zero drift (exit 2 on drift)
 acu --tenant DEV state                   # capture state/ trial-balance
-acu check --yes --tenant DEV             # cold lifecycle create→apply→run→diff (leave tenant)
 ```
 
 Bare `apply` / `diff` (no path args) also prefer `config/` when those trees exist.
@@ -97,7 +96,6 @@ acu [--tenant NAME] [--url URL] [--ssh USER@HOST] [--api-version V]
 ├── apply [--dry-run] [FILES...]      push YAML via REST (idempotent PUT upserts)
 ├── diff  [FILES...]                  drift check vs the live tenant (exit 2 on drift)
 ├── run   [--dry-run] [FILES...]      execute transaction scenario YAML (exit 1 on any miss)
-├── check [--yes] [--tenant L]        cold lifecycle create→apply→run→diff; leave tenant (V47)
 ├── state [--out DIR] [--diff] [--assert-unchanged] [--dry-run] [FILES...]
 │                                     capture derived state into state/ (not seed)
 ├── extract [--out DIR] [--only NAME]... [--force] [--dry-run]
@@ -267,7 +265,6 @@ Ad-hoc override: `acu --api-version 24.200.001 …` (version half only, never
 `base_url` resolves as `--url`, else `ACU_BASE_URL`, else a hard error naming sources.
 
 `acu config show` prints the resolved `.env` (password excluded; includes `ACU_API_VERSION`).
-`acu check` (lifecycle) uses the same resolved instance.
 
 ### Multi-host overlays (V44)
 
@@ -299,9 +296,6 @@ acu diff
 # explicit path args (no auto) — later path wins same keys
 acu apply config/ overlays/default-24.200.001/
 acu diff config/ overlays/default-24.200.001/
-
-# cold lifecycle vs the resolved .env instance (SSH + tenant required)
-acu check --yes --tenant LAB5
 ```
 
 Add a future half by creating `overlays/default-<new-half>/` with the
@@ -317,7 +311,7 @@ Worth knowing:
 - Without a `.env`, global flags plus the process environment supply the configuration.
 - When `ACU_SSH` is **absent**, acu defaults to `Administrator@` + the resolved base_url hostname.
   A **present blank** `ACU_SSH=` is the hosted opt-out.
-  Only `acu tenant` / `acu check` require a non-empty value post-default.
+  Only `acu tenant` requires a non-empty value post-default.
 - `acu config show` prints the resolved `.env` (password excluded).
 - Redirect it to turn resolved state into a working config: `acu config show > .env`.
 
@@ -365,7 +359,9 @@ gmake release patch   # or minor | major
 2. Fail if `## Unreleased` has no bullets
 3. Bump `pyproject.toml` version (`major` | `minor` | `patch`)
 4. Promote Unreleased body to `## [vX.Y.Z] - YYYY-MM-DD`, leave an empty `## Unreleased`
-5. Commit `CHANGELOG.md` + `pyproject.toml` (+ lock if bumped) together, tag `vX.Y.Z`, push
+5. Commit `CHANGELOG.md` + `pyproject.toml` (+ lock if bumped) together, tag `vX.Y.Z`
+6. `gmake check` again on the promoted tree
+7. Push tag + branch — GitHub Actions publishes
 
 GitHub Actions on tag `v*` re-runs CI, builds sdist+wheel, publishes to PyPI via OIDC trusted publishing, and creates a GitHub Release whose notes are the promoted CHANGELOG section for that tag (plus the artifacts).
 

{acumatica_cli-0.29.0 → acumatica_cli-0.30.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.29.0"
+version = "0.30.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.29.0 → acumatica_cli-0.30.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.29.0"
+version = "0.30.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.29.0 → acumatica_cli-0.30.0}/src/acumatica_cli/cli.py

@@ -55,7 +55,7 @@ COMMAND MAP (pick by intent)
   seed write   apply [--dry-run] [FILES...]              (sole mutator)
   seed check   diff [FILES...]                           (exit 2 on drift)
   txns         run [--dry-run] [FILES...]
-  cold CI      check [--tenant LOGIN]                    (!= config check)
+  cold rebuild tenant create then apply then run then diff (no wrap cmd)
   pull seed    extract [--only ENTITY]...                (inverse of apply)
   observe      state [--diff|--assert-unchanged]
   offline      inventory ARTIFACT | reconcile
@@ -66,7 +66,6 @@ EXIT CODES (common)
   0  success
   1  operational / parse / expectation failure
   2  seed drift (diff) or state moved (state --assert-unchanged)
-  check (lifecycle) never exits 2 — drift fails the run as exit 1
 
 \b
 DEFAULT PATHS (when FILES omitted)
@@ -674,8 +673,8 @@ def config_group() -> None:
       show           print resolved config as a complete .env (password redacted)
       check          read-only live preflight (REST + optional SSH)
 
-    Not the same as `acu check` (cold lifecycle rebuild). Start here on a
-    new machine: init → edit .env → config check → tenant create / bootstrap.
+    Start here on a new machine: init → edit .env → config check →
+    tenant create / bootstrap.
     """
 
 
@@ -721,7 +720,6 @@ def config_init(host: str | None, directory: Path | None) -> None:
     output.data("  5. acu run scenario/")
     output.data("  6. acu diff config/")
     output.data("  7. acu state")
-    output.data("  8. acu check              # cold lifecycle (SSH + tenant)")
 
 
 @config_group.command("show")
@@ -751,7 +749,7 @@ def config_check(ctx: click.Context) -> None:
     """Read-only preflight of the resolved target (ok/fail/warn/skip lines).
 
     Proves connectivity before apply/run. Writes nothing (no PUT, no tenant
-    CRUD). Not `acu check` (that is a destructive cold lifecycle rebuild).
+    CRUD).
 
     \b
     Probe order
@@ -875,192 +873,6 @@ def _probe_endpoints(endpoints: list[tuple[str, str]], inst: Instance) -> bool:
     return False
 
 
-@cli.command("check")
-@click.option(
-    "--yes",
-    is_flag=True,
-    help="Accepted for muscle-memory (pre-clean delete is always unattended)",
-)
-@click.option(
-    "--tenant",
-    "tenant_login",
-    default=None,
-    help="Tenant login for pre-clean create (else ACU_TENANT / global --tenant)",
-)
-@click.pass_context
-def check_cmd(ctx: click.Context, yes: bool, tenant_login: str | None) -> None:
-    """Cold lifecycle: delete → create → apply → run → diff (leave tenant).
-
-    Destructive rebuild for CI against the resolved .env instance. Not
-    `acu config check` (read-only preflight). Requires non-empty ACU_SSH
-    and a tenant login (--tenant / ACU_TENANT). Pre-clean delete is
-    always unattended; rebuilt tenant is left on the host for inspect /
-    state. --yes is accepted for muscle-memory only.
-
-    \b
-    Flow
-      delete tenant (if present) → create+bootstrap → apply → run → diff
-      Diff drift fails the run as exit 1 (never exit 2 from this command).
-
-    \b
-    Examples
-      acu check --tenant DEV
-      acu check --yes --tenant DEV
-
-    Prefer `config check` for "can I connect?" Prefer this for "rebuild
-    green from empty."
-    """
-    _ = yes
-    overrides: dict[str, str] = dict(ctx.obj or {})
-    tenant = _resolve_check_tenant(tenant_login, overrides)
-    try:
-        inst = load_instance({**overrides, "tenant": tenant})
-    except SystemExit as exc:
-        raise SystemExit(str(exc)) from exc
-    if not inst.ssh:
-        raise SystemExit(
-            "ACU_SSH not set (pass --ssh, or put ACU_SSH in .env or the environment)"
-        )
-    output.data(f"check {inst.base_url} (api={inst.api_version})")
-    if _run_lifecycle(inst, tenant) != 0:
-        raise SystemExit(1)
-    output.success("check: green")
-
-
-def _resolve_check_tenant(tenant_login: str | None, overrides: dict[str, str]) -> str:
-    """Tenant login from flag, global, env, or .env; hard-error if unset."""
-    tenant = tenant_login or overrides.get("tenant") or os.environ.get("ACU_TENANT")
-    if not tenant and (root := find_data_root()) is not None:
-        tenant = read_env_values(root / ".env").get("tenant") or None
-    if not tenant:
-        raise SystemExit(
-            "tenant not set (pass --tenant, "
-            "or put ACU_TENANT in .env or the environment)"
-        )
-    return tenant
-
-
-def _run_lifecycle(inst: Instance, tenant: str) -> int:
-    """pre-clean→create→apply→run→diff; leave tenant (V47); return 0 or 1."""
-    mgr = TenantManager(inst)
-    _lifecycle_delete_best_effort(mgr, tenant, label="pre-clean")
-    try:
-        _lifecycle_create_and_bootstrap(inst, mgr, tenant)
-        data_inst = inst.model_copy(update={"tenant": tenant})
-        _lifecycle_apply(data_inst)
-        _lifecycle_run(data_inst)
-        _lifecycle_diff(data_inst)
-    except SystemExit as exc:
-        code = exc.code if isinstance(exc.code, int) else 1
-        if code == 2:
-            code = 1  # V47: check never exits 2
-        output.error(f"lifecycle: {exc}")
-        # Leave tenant for manual inspect (no post-clean — V47).
-        return 1 if code != 0 else 0
-    except (RuntimeError, httpx.HTTPError) as exc:
-        output.error(f"lifecycle: {_format_failure(exc, target=inst.base_url)}")
-        # Leave tenant for manual inspect (no post-clean — V47).
-        return 1
-    output.success(
-        f"lifecycle green on {inst.base_url} tenant {tenant} (left for inspection)"
-    )
-    return 0
-
-
-def _lifecycle_create_and_bootstrap(
-    inst: Instance, mgr: TenantManager, tenant: str
-) -> None:
-    """Create (or exists-skip) tenant + init + bootstrap chain."""
-    tenants = mgr.list()
-    existing = next((t for t in tenants if t.login_name == tenant), None)
-    if existing is not None:
-        company_id = existing.company_id
-        output.data(f"skip create: tenant {tenant} exists (id {company_id})")
-    else:
-        company_id = max((t.company_id for t in tenants), default=0) + 1
-        with output.step(f"creating tenant {company_id} ({tenant}) on {inst.base_url}"):
-            mgr.create(company_id, tenant, 1, True, "")
-        output.data("created")
-    with output.step(f"aligning CompanyCD to login ({tenant})"):
-        if mgr.set_company_cd(company_id, tenant):
-            output.data(f"CompanyCD set to {tenant}")
-        else:
-            output.data(f"CompanyCD already {tenant}")
-    _init_tenant(inst, mgr, tenant)
-    _bootstrap_tenant(inst, mgr, tenant)
-
-
-def _lifecycle_delete_best_effort(
-    mgr: TenantManager, tenant: str, *, label: str
-) -> None:
-    try:
-        tenants = mgr.list()
-        if any(t.login_name == tenant for t in tenants):
-            with output.step(f"{label} delete tenant {tenant}"):
-                mgr.delete(login_name=tenant)
-            with output.step(f"recycling app pool after {label}"):
-                mgr.recycle_app_pool()
-            output.data(f"{label}: deleted {tenant}")
-        else:
-            output.data(f"{label}: tenant {tenant} absent")
-    except (RuntimeError, SystemExit) as exc:
-        output.warn(f"{label}: {exc}")
-
-
-def _lifecycle_apply(inst: Instance) -> None:
-    """Bare apply (pin overlay auto-compose); SystemExit 1 on failure."""
-    total_ok = 0
-    all_errors: list[str] = []
-    with AcumaticaClient(inst) as client:
-        for path in expand_files(default_apply_dirs(inst)):
-            baseline = seed.load_baseline(path)
-            output.data(
-                f"{path} -> {inst.tenant} on {inst.base_url} ({baseline.entity})"
-            )
-            n, errors = seed.apply(client, baseline, dry_run=False)
-            total_ok += n
-            all_errors.extend(f"{path}: {e}" for e in errors)
-            output.data(f"  {n} record(s)")
-    if all_errors:
-        output.error(f"apply: {len(all_errors)} error(s), {total_ok} record(s) applied")
-        for err in all_errors:
-            output.error(err)
-        raise SystemExit(1)
-
-
-def _lifecycle_run(inst: Instance) -> None:
-    """Bare run (pin overlay); SystemExit 1 on failure."""
-    paths = list(default_scenario_files(inst))
-    scenarios = [run.load_scenario(path) for path in paths]
-    ok = True
-    with AcumaticaClient(inst) as client:
-        for scenario in scenarios:
-            ok = run.run(client, scenario) and ok
-    if not ok:
-        raise SystemExit(1)
-    output.success(f"{len(scenarios)} scenario(s) passed on {inst.tenant}")
-
-
-def _lifecycle_diff(inst: Instance) -> None:
-    """Bare diff; SystemExit 2 on drift (caller maps to 1 for check)."""
-    paths = expand_files(default_apply_dirs(inst))
-    drifts: list[str] = []
-    with AcumaticaClient(inst) as client:
-        for path in paths:
-            baseline = seed.load_baseline(path)
-            output.data(
-                f"{path} -> {inst.tenant} on {inst.base_url} ({baseline.entity})"
-            )
-            file_drifts = seed.diff(client, baseline)
-            drifts += file_drifts
-            n = 1 if isinstance(baseline, seed.ActionFile) else len(baseline.records)
-            if file_drifts:
-                output.data(f"  {n} record(s), {len(file_drifts)} drift(s)")
-            else:
-                output.data(f"  {n} record(s) ok")
-    _exit_on_drift(inst, drifts, len(paths))
-
-
 SEED_DIRS = ("bootstrap", "baseline", "setup", "master")
 
 

{acumatica_cli-0.29.0 → acumatica_cli-0.30.0}/src/acumatica_cli/templates/README.md

@@ -30,8 +30,7 @@ acu state
 # warm gate: once-capital only — additive buy/sell moves numeric observations
 acu run scenario/10-seed-capital.yaml && acu state --assert-unchanged
 
-# 7. Cold lifecycle (SSH + tenant)
-# acu check --yes
+# SSH cold rebuild: acu tenant create --login NAME, then apply, run, diff
 
 # Optional: re-seed from live (inverse of apply; always under config/)
 # acu extract --out . --force