acumatica-cli 0.8.3__tar.gz → 0.9.0__tar.gz

{acumatica_cli-0.8.3 → acumatica_cli-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acumatica-cli
-Version: 0.8.3
+Version: 0.9.0
 Summary: Acumatica ERP Config-as-Code: tenant provisioning, baseline config, and reference data
 Author: Konstantin Borovik
 Author-email: Konstantin Borovik <kb@lab5.ca>

{acumatica_cli-0.8.3 → acumatica_cli-0.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acumatica-cli"
-version = "0.8.3"
+version = "0.9.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.8.3 → acumatica_cli-0.9.0}/src/acumatica_cli/bootstrap.py

@@ -6,10 +6,12 @@ docs/rest-api.md). 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 CS101500 company + CS206500 credit terms + CM202000
-financial currency for seeding (`bootstrap_project.xml`, serialization
-verified T12; the Default endpoint's Currency entity is the CM201000 list
-only — B8).
+endpoint exposes the seeding surface (serialization verified T12).
+
+Contract ownership is hybrid (T69/V2): the data repo's
+``bootstrap/project.xml`` is preferred when present (full company surface);
+else the packaged minimal ``bootstrap_project.xml`` covers config-init +
+the GL chain so PyPI-only and offline virgin paths still bootstrap.
 
 Customization publishes are tenant-scoped, so the package must be published
 per tenant; publish() is idempotent on content — the skip gate compares the
@@ -38,13 +40,8 @@ from .client import AcumaticaClient
 # Alphanumeric only: CstDbStorage.ValidatePackageName rejects '-' and '_'
 # (verified vs 26.101.0225 — "Invalid project name")
 PACKAGE_NAME = "AcuBootstrap"
-# Authored once, in the template's root description attribute — read it
-# here rather than hand-syncing a second copy: the XML is digest input,
-# so a divergent XML-only edit would fire a spurious republish (V4).
-PACKAGE_DESCRIPTION = ET.fromstring(
-    (resources.files("acumatica_cli") / "bootstrap_project.xml").read_bytes()
-).get("description", "")
 PLUGIN_CLASS = "AcuBootstrapPlugin"
+_ENDPOINT_NS = "{http://www.acumatica.com/entity/maintenance/5.31}"
 
 # Code default when the data repo carries no bootstrap/features.yaml
 # (SPEC I.data) — the minimum for company/branch + baseline seeding.
@@ -62,6 +59,43 @@ DEFAULT_FEATURES = (
 FEATURES_SENTINEL = "/*ACU_FEATURES*/"
 
 
+def packaged_contract_xml() -> bytes:
+    """The CLI-shipped minimal Bootstrap contract (config-init surface)."""
+    return (resources.files("acumatica_cli") / "bootstrap_project.xml").read_bytes()
+
+
+def load_contract_xml(root: Path | None = None) -> bytes:
+    """Active contract bytes: data-repo override when present, else packaged.
+
+    ``root`` is the data-repo discovery root (the dir holding ``.env``).
+    Absent root or absent ``bootstrap/project.xml`` falls back to the
+    packaged minimal contract (V2, same absence pattern as features.yaml).
+    """
+    if root is not None:
+        path = root / "bootstrap" / "project.xml"
+        if path.is_file():
+            return path.read_bytes()
+    return packaged_contract_xml()
+
+
+def parse_endpoint(xml: bytes) -> tuple[str, frozenset[str]]:
+    """Endpoint ``Name/version`` + entity names from a contract project.xml."""
+    root = ET.fromstring(xml)
+    endpoint = root.find(f"EntityEndpoint/{_ENDPOINT_NS}Endpoint")
+    if endpoint is None:
+        raise RuntimeError("bootstrap contract: no EntityEndpoint/Endpoint item")
+    name = f"{endpoint.get('name')}/{endpoint.get('version')}"
+    entities = frozenset(
+        e.get("name", "") for e in endpoint.findall(f"{_ENDPOINT_NS}TopLevelEntity")
+    )
+    return name, entities
+
+
+# Authored once on the packaged template's root description — kept for
+# tests that pin a pre-digest stale description (V4 republish path).
+PACKAGE_DESCRIPTION = ET.fromstring(packaged_contract_xml()).get("description", "")
+
+
 def load_features(root: Path) -> list[str]:
     """The FeaturesSet property names from <root>/bootstrap/features.yaml.
 
@@ -85,7 +119,12 @@ def load_features(root: Path) -> list[str]:
     return list(data)
 
 
-def package_zip(features: Sequence[str] | None = None) -> bytes:
+def package_zip(
+    features: Sequence[str] | None = None,
+    *,
+    root: Path | None = None,
+    contract: bytes | None = None,
+) -> bytes:
     """Build the customization package: a zip holding project.xml.
 
     The C# plugin travels as a <Graph> item whose Source ATTRIBUTE holds the
@@ -96,9 +135,21 @@ def package_zip(features: Sequence[str] | None = None) -> bytes:
     ``features`` (default: the built-in six) is spliced into the plugin's
     ``Enabled`` set at the ACU_FEATURES sentinel — the one point where the
     data repo's feature list enters the package (V2).
+
+    Contract XML (V2/T69): ``contract`` when given; else
+    ``bootstrap/project.xml`` under ``root`` when present; else the
+    packaged minimal template.
     """
     pkg = resources.files("acumatica_cli")
-    root = ET.fromstring((pkg / "bootstrap_project.xml").read_bytes())
+    if contract is None:
+        if root is None:
+            from .config import find_data_root
+
+            root = find_data_root()
+        xml = load_contract_xml(root)
+    else:
+        xml = contract
+    root_el = ET.fromstring(xml)
     source = (pkg / "bootstrap_plugin.cs").read_text(encoding="utf-8")
     if FEATURES_SENTINEL not in source:
         raise RuntimeError(f"bootstrap_plugin.cs: {FEATURES_SENTINEL} sentinel missing")
@@ -106,13 +157,13 @@ def package_zip(features: Sequence[str] | None = None) -> bytes:
     source = source.replace(
         FEATURES_SENTINEL, ", ".join(f'"{name}"' for name in enabled)
     )
-    graph = ET.SubElement(root, "Graph")
+    graph = ET.SubElement(root_el, "Graph")
     graph.set("ClassName", PLUGIN_CLASS)
     graph.set("FileType", "NewFile")
     graph.set("Source", source)
     buf = io.BytesIO()
     with zipfile.ZipFile(buf, "w", zipfile.ZIP_DEFLATED) as zf:
-        zf.writestr("project.xml", ET.tostring(root, encoding="utf-8"))
+        zf.writestr("project.xml", ET.tostring(root_el, encoding="utf-8"))
     return buf.getvalue()
 
 
@@ -134,8 +185,12 @@ def package_description(zip_bytes: bytes) -> str:
     offers (verified live vs 26.101.0225): the import's projectDescription
     comes back only in the root description attribute of getProject's
     re-serialized project.xml — getPublished rows hold names alone.
+    Root description is read from the package's own project.xml so a
+    data-repo contract carries its own prose (V2).
     """
-    return f"{PACKAGE_DESCRIPTION} [sha256:{content_digest(zip_bytes)}]"
+    with zipfile.ZipFile(io.BytesIO(zip_bytes)) as zf:
+        desc = ET.fromstring(zf.read("project.xml")).get("description", "")
+    return f"{desc} [sha256:{content_digest(zip_bytes)}]"
 
 
 def _published_description(client: AcumaticaClient) -> str | None:
@@ -169,6 +224,8 @@ def _log_tail(status: dict[str, object], limit: int = 5) -> str:
 def publish(
     client: AcumaticaClient,
     features: Sequence[str] | None = None,
+    *,
+    root: Path | None = None,
     timeout: float = 600.0,
     poll: float = 5.0,
 ) -> str:
@@ -187,7 +244,7 @@ def publish(
     site may briefly drop connections mid-publish. Raises RuntimeError on a
     failed publish or on timeout.
     """
-    zip_bytes = package_zip(features)
+    zip_bytes = package_zip(features, root=root)
     description = package_description(zip_bytes)
     if PACKAGE_NAME in client.customization_published() and (
         _published_description(client) == description

acumatica_cli-0.9.0/src/acumatica_cli/bootstrap_project.xml

@@ -0,0 +1,238 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  acu bootstrap customization package template - minimal config-init surface
+  (SPEC T69 hybrid A).
+
+  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 PyPI-only installs still bootstrap.
+
+  package_zip() injects a
+  <Graph ClassName="AcuBootstrapPlugin" FileType="NewFile" Source="..."/>
+  item carrying bootstrap_plugin.cs - the CustomizationPlugin that enables
+  features on publish (CS100000 is un-writable through the contract API;
+  T3 verdict). Item shape verified vs 26.101.0225: Customization.CstCodeFile
+  Tag=Graph, source rides in the Source ATTRIBUTE (XML-escaped), not CDATA.
+
+  Root element shape verified vs the training packages shipped on the live
+  box (HelpAndTraining/T*/PhoneRepairShop.zip, same 26.101.0225 build):
+  project.xml's root is <Customization level description product-version>;
+  the project NAME comes from the import call, not the XML.
+
+  The <EntityEndpoint> item (T12, verified vs 26.101.0225 by import
+  round-trip 2026-07-08): the <Endpoint> child is the XmlSerializer form of
+  PX.Api.ContractBased.Common.Model.Endpoint - namespace
+  http://www.acumatica.com/entity/maintenance/5.31, systemContractVersion 4.
+
+  Minimal entity payload (config-init + GL chain only; full company surface
+  lives in the data repo's bootstrap/project.xml per T69):
+  - Company    CS101500 -> OrganizationMaint, PrimaryView BAccount
+  - CreditTerms CS206500 -> TermsMaint, PrimaryView TermsDef
+  - LedgerCompany GL201500 -> GeneralLedgerMaint (org-ledger link, B12)
+  - FinancialYearSettings GL101000 + GeneratePeriods (AutoFill)
+  - MasterCalendar GL201000 + GenerateCalendar (GenerateYears)
+  - CompanyCalendar / CompanyPeriod GL201100 (done_when probes)
+  - ManagePeriods GL503000 + ProcessAll (period activation, B13)
+  - GLPreferences GL102000 (YtdNetIncAccountID + RetEarnAccountID)
+
+  Contract field names = DAC property names verbatim (no rename layer).
+  Features (CS100000) stays OUT of the endpoint - the plugin owns features.
+-->
+<Customization level="" description="acu bootstrap: CustomizationPlugin enables features on publish; Bootstrap endpoint exposes company + credit terms + GL preferences + ledger-company link + financial year + calendars + period activation (config-init surface; full company contract lives in data-repo bootstrap/project.xml)" product-version="26.101">
+  <EntityEndpoint>
+    <Endpoint xmlns="http://www.acumatica.com/entity/maintenance/5.31" name="Bootstrap" version="1.9.0" systemContractVersion="4">
+      <TopLevelEntity name="Company" screen="CS101500">
+        <Fields>
+          <Field name="AcctCD" type="StringValue" />
+          <Field name="AcctName" type="StringValue" />
+          <Field name="OrganizationType" type="StringValue" />
+          <Field name="BaseCuryID" type="StringValue" />
+          <Field name="CountryID" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="AcctCD">
+            <To object="BAccount" field="AcctCD" />
+          </Mapping>
+          <Mapping field="AcctName">
+            <To object="BAccount" field="AcctName" />
+          </Mapping>
+          <Mapping field="OrganizationType">
+            <To object="OrganizationView" field="OrganizationType" />
+          </Mapping>
+          <Mapping field="BaseCuryID">
+            <To object="OrganizationView" field="BaseCuryID" />
+          </Mapping>
+          <Mapping field="CountryID">
+            <To object="AddressDummy" field="CountryID" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="CreditTerms" screen="CS206500">
+        <Fields>
+          <Field name="TermsID" type="StringValue" />
+          <Field name="Descr" type="StringValue" />
+          <Field name="VisibleTo" type="StringValue" />
+          <Field name="DueType" type="StringValue" />
+          <Field name="DayDue00" type="ShortValue" />
+          <Field name="DiscType" type="StringValue" />
+          <Field name="DiscPercent" type="DecimalValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="TermsID">
+            <To object="TermsDef" field="TermsID" />
+          </Mapping>
+          <Mapping field="Descr">
+            <To object="TermsDef" field="Descr" />
+          </Mapping>
+          <Mapping field="VisibleTo">
+            <To object="TermsDef" field="VisibleTo" />
+          </Mapping>
+          <Mapping field="DueType">
+            <To object="TermsDef" field="DueType" />
+          </Mapping>
+          <Mapping field="DayDue00">
+            <To object="TermsDef" field="DayDue00" />
+          </Mapping>
+          <Mapping field="DiscType">
+            <To object="TermsDef" field="DiscType" />
+          </Mapping>
+          <Mapping field="DiscPercent">
+            <To object="TermsDef" field="DiscPercent" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="LedgerCompany" screen="GL201500">
+        <Fields>
+          <Field name="LedgerCD" type="StringValue" />
+          <Field name="OrganizationID" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="LedgerCD">
+            <To object="LedgerRecords" field="LedgerCD" />
+          </Mapping>
+          <Mapping field="OrganizationID">
+            <To object="OrganizationLedgerLinkWithOrganizationSelect" field="OrganizationID" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="FinancialYearSettings" screen="GL101000">
+        <Fields>
+          <Field name="BegFinYear" type="DateTimeValue" />
+          <Field name="FinPeriods" type="ShortValue" />
+          <Field name="PeriodType" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="BegFinYear">
+            <To object="FiscalYearSetup" field="BegFinYear" />
+          </Mapping>
+          <Mapping field="FinPeriods">
+            <To object="FiscalYearSetup" field="FinPeriods" />
+          </Mapping>
+          <Mapping field="PeriodType">
+            <To object="FiscalYearSetup" field="PeriodType" />
+          </Mapping>
+        </Mappings>
+        <Actions>
+          <Action name="GeneratePeriods" mappedTo="AutoFill" isDefault="false" />
+        </Actions>
+      </TopLevelEntity>
+      <TopLevelEntity name="MasterCalendar" screen="GL201000">
+        <Fields>
+          <Field name="FinancialYear" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="FinancialYear">
+            <To object="FiscalYear" field="Year" />
+          </Mapping>
+        </Mappings>
+        <Actions>
+          <Action name="GenerateCalendar" mappedTo="GenerateYears" isDefault="false">
+            <Fields>
+              <Field name="FromYear" type="StringValue" />
+              <Field name="ToYear" type="StringValue" />
+            </Fields>
+            <Mappings>
+              <Mapping field="FromYear">
+                <To object="GenerateParams" field="FromYear" />
+              </Mapping>
+              <Mapping field="ToYear">
+                <To object="GenerateParams" field="ToYear" />
+              </Mapping>
+            </Mappings>
+          </Action>
+        </Actions>
+      </TopLevelEntity>
+      <TopLevelEntity name="CompanyCalendar" screen="GL201100">
+        <Fields>
+          <Field name="FinancialYear" type="StringValue" />
+          <Field name="OrganizationID" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="FinancialYear">
+            <To object="OrgFinYear" field="Year" />
+          </Mapping>
+          <Mapping field="OrganizationID">
+            <To object="OrgFinYear" field="OrganizationID" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="CompanyPeriod" screen="GL201100">
+        <Fields>
+          <Field name="FinancialYear" type="StringValue" />
+          <Field name="FinPeriodID" type="StringValue" />
+          <Field name="Status" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="FinancialYear">
+            <To object="OrgFinPeriods" field="FinYear" />
+          </Mapping>
+          <Mapping field="FinPeriodID">
+            <To object="OrgFinPeriods" field="FinPeriodID" />
+          </Mapping>
+          <Mapping field="Status">
+            <To object="OrgFinPeriods" field="Status" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+      <TopLevelEntity name="ManagePeriods" screen="GL503000">
+        <Fields>
+          <Field name="Action" type="StringValue" />
+          <Field name="FromYear" type="StringValue" />
+          <Field name="ToYear" type="StringValue" />
+          <Field name="OrganizationID" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="Action">
+            <To object="Filter" field="Action" />
+          </Mapping>
+          <Mapping field="FromYear">
+            <To object="Filter" field="FromYear" />
+          </Mapping>
+          <Mapping field="ToYear">
+            <To object="Filter" field="ToYear" />
+          </Mapping>
+          <Mapping field="OrganizationID">
+            <To object="Filter" field="OrganizationID" />
+          </Mapping>
+        </Mappings>
+        <Actions>
+          <Action name="ProcessAll" mappedTo="ProcessAll" isDefault="false" />
+        </Actions>
+      </TopLevelEntity>
+      <TopLevelEntity name="GLPreferences" screen="GL102000">
+        <Fields>
+          <Field name="YtdNetIncAccountID" type="StringValue" />
+          <Field name="RetEarnAccountID" type="StringValue" />
+        </Fields>
+        <Mappings>
+          <Mapping field="YtdNetIncAccountID">
+            <To object="GLSetupRecord" field="YtdNetIncAccountID" />
+          </Mapping>
+          <Mapping field="RetEarnAccountID">
+            <To object="GLSetupRecord" field="RetEarnAccountID" />
+          </Mapping>
+        </Mappings>
+      </TopLevelEntity>
+    </Endpoint>
+  </EntityEndpoint>
+</Customization>

{acumatica_cli-0.8.3 → acumatica_cli-0.9.0}/src/acumatica_cli/extract.py

@@ -40,10 +40,11 @@ from .client import (
     unwrap,
 )
 from .models import Model, validation_summary
-from .seed import BOOTSTRAP_ENDPOINT, BOOTSTRAP_ENTITIES
+from .seed import active_bootstrap, resolve_endpoint
 
 # The one non-manifest destination: the feature-closure file (V22/B15).
 FEATURES_FILE = "bootstrap/features.yaml"
+_SYMBOLIC_BOOTSTRAP = "bootstrap"
 
 
 class EntitySpec(Model):
@@ -52,19 +53,15 @@ class EntitySpec(Model):
     entity: str
     keys: list[str] = Field(min_length=1)
     file: str
+    # Symbolic `bootstrap` stays symbolic until HTTP time (V20/V21): the
+    # emitted file carries the symbol so a version bump never rewrites
+    # extract output; resolve_endpoint maps it to Bootstrap/<ver>.
     endpoint: str | None = None
     filter: str | None = None
     strip: list[str] = Field(default_factory=list)
     include: list[str] = Field(default_factory=list)
     features: list[str] = Field(default_factory=list)
 
-    @field_validator("endpoint")
-    @classmethod
-    def _resolve_symbolic(cls, v: str | None) -> str | None:
-        # `bootstrap` resolves to the packaged endpoint at load, so the
-        # manifest never carries a literal version to go stale (V21)
-        return BOOTSTRAP_ENDPOINT if v == "bootstrap" else v
-
     @model_validator(mode="after")
     def _strip_include_exclusive(self) -> EntitySpec:
         if self.strip and self.include:
@@ -97,13 +94,15 @@ class Manifest(Model):
 
     @model_validator(mode="after")
     def _self_consistent(self) -> Manifest:
-        # V20 by construction: an emitted file for an entity both endpoints
-        # serve must carry an endpoint, or load_baseline rejects it
+        # V20 by construction: an emitted file for an entity the active
+        # Bootstrap contract serves must carry an endpoint (literal or
+        # symbolic bootstrap), or load_baseline rejects it
+        _name, entities = active_bootstrap()
         for spec in self.entities:
-            if spec.entity in BOOTSTRAP_ENTITIES and spec.endpoint is None:
+            if spec.entity in entities and spec.endpoint is None:
                 raise ValueError(
-                    f"entity '{spec.entity}' is served by the packaged "
-                    f"{BOOTSTRAP_ENDPOINT} and must carry an endpoint"
+                    f"entity '{spec.entity}' is served by the active "
+                    f"{_name} and must carry an endpoint"
                 )
         # FEATURES_FILE is claimed by the feature-closure render, never a row
         files = (
@@ -142,24 +141,23 @@ def _fetch(client: AcumaticaClient, spec: EntitySpec) -> list[dict[str, Any]]:
     A manifest filter rides both list reads, so the two paths serve the
     same record set and the per-key walk only visits filtered keys.
     """
+    endpoint = resolve_endpoint(spec.endpoint)
     narrowed = {"$filter": spec.filter} if spec.filter else {}
     try:
-        return client.get_list(
-            spec.entity, params=narrowed or None, endpoint=spec.endpoint
-        )
+        return client.get_list(spec.entity, params=narrowed or None, endpoint=endpoint)
     except RuntimeError as err:
         if OPTIMIZATION_500 not in str(err):
             raise
     key_rows = client.get_list(
         spec.entity,
         params={"$select": ",".join(spec.keys)} | narrowed,
-        endpoint=spec.endpoint,
+        endpoint=endpoint,
     )
     records: list[dict[str, Any]] = []
     for row in key_rows:
         values = unwrap(row)
         record = client.get_record(
-            spec.entity, [values[k] for k in spec.keys], spec.endpoint
+            spec.entity, [values[k] for k in spec.keys], endpoint
         )
         if record is not None:
             records.append(record)
@@ -234,14 +232,15 @@ def _years(rows: list[dict[str, Any]]) -> list[str]:
 
 def _synth_financial_year(client: AcumaticaClient) -> dict[str, Any] | None:
     """The FinYearSetup singleton back as its GeneratePeriods action file."""
-    live = client.get_list("FinancialYearSettings", endpoint=BOOTSTRAP_ENDPOINT)
+    ep = resolve_endpoint(_SYMBOLIC_BOOTSTRAP)
+    live = client.get_list("FinancialYearSettings", endpoint=ep)
     if not live:
         return None
     settings = unwrap(live[0])
     return {
         "action": "GeneratePeriods",
         "entity": "FinancialYearSettings",
-        "endpoint": BOOTSTRAP_ENDPOINT,
+        "endpoint": _SYMBOLIC_BOOTSTRAP,
         "record": {
             # DateTimeValue comes back as a full ISO datetime; the action
             # record wants the date, quoted (the seed pipeline ships YAML
@@ -257,14 +256,15 @@ def _synth_financial_year(client: AcumaticaClient) -> dict[str, Any] | None:
 
 def _synth_master_calendar(client: AcumaticaClient) -> dict[str, Any] | None:
     """The master-calendar year range back as its GenerateCalendar action file."""
-    live = client.get_list("MasterCalendar", endpoint=BOOTSTRAP_ENDPOINT)
+    ep = resolve_endpoint(_SYMBOLIC_BOOTSTRAP)
+    live = client.get_list("MasterCalendar", endpoint=ep)
     if not live:
         return None
     years = _years(live)
     return {
         "action": "GenerateCalendar",
         "entity": "MasterCalendar",
-        "endpoint": BOOTSTRAP_ENDPOINT,
+        "endpoint": _SYMBOLIC_BOOTSTRAP,
         "record": {"FinancialYear": years[0]},
         "parameters": {"FromYear": years[0], "ToYear": years[-1]},
         # the company calendar derives from the master, so it is the
@@ -279,10 +279,11 @@ def _synth_master_calendar(client: AcumaticaClient) -> dict[str, Any] | None:
 
 def _synth_open_periods(client: AcumaticaClient) -> dict[str, Any] | None:
     """The open-period range back as its GL503000 ProcessAll action file."""
+    ep = resolve_endpoint(_SYMBOLIC_BOOTSTRAP)
     live = client.get_list(
         "CompanyPeriod",
         params={"$filter": "Status eq 'Open'"},
-        endpoint=BOOTSTRAP_ENDPOINT,
+        endpoint=ep,
     )
     if not live:
         return None
@@ -290,14 +291,14 @@ def _synth_open_periods(client: AcumaticaClient) -> dict[str, Any] | None:
     # OrganizationID = the extracted Company's AcctCD: the reference
     # resolves inside the emitted set (V22 - bootstrap/company.yaml
     # creates the organization the action names)
-    companies = client.get_list("Company", endpoint=BOOTSTRAP_ENDPOINT)
+    companies = client.get_list("Company", endpoint=ep)
     if not companies:
         raise RuntimeError("open-periods: no Company on tenant")
     org = sorted(str(unwrap(c)["AcctCD"]) for c in companies)[0]
     return {
         "action": "ProcessAll",
         "entity": "ManagePeriods",
-        "endpoint": BOOTSTRAP_ENDPOINT,
+        "endpoint": _SYMBOLIC_BOOTSTRAP,
         "record": {
             "Action": "Open",
             "FromYear": years[0],
@@ -406,12 +407,21 @@ class _Extraction:
     def entities(self) -> set[str]:
         """The entity pass; returns destination files written (or would be)."""
         produced: set[str] = set()
+        active_name, active_entities = active_bootstrap()
         for spec in self.manifest.entities:
             if not self._selected(spec.entity, spec.file):
                 continue
             target = self.out_dir / spec.file
             if self._skip_existing(target):
                 continue
+            # Hybrid contract (T69): a bootstrap-endpoint row for an entity
+            # the active package does not serve cannot be read - skip clean
+            # rather than 404 (full company surface lives in the data-repo
+            # contract; minimal packaged fallback has config-init only).
+            resolved = resolve_endpoint(spec.endpoint)
+            if resolved == active_name and spec.entity not in active_entities:
+                self._skip(target, "entity not in active Bootstrap contract")
+                continue
             try:
                 live = _fetch(self.client, spec)
                 records = _shape(spec, live)

{acumatica_cli-0.8.3 → acumatica_cli-0.9.0}/src/acumatica_cli/extract_manifest.yaml

@@ -4,9 +4,10 @@
 # Per entity row:
 #   entity    contract entity name (the GET source and the emitted `entity:`)
 #   endpoint  omitted = the instance Default endpoint; the symbolic name
-#             `bootstrap` resolves to the packaged Bootstrap endpoint at
-#             load (seed.BOOTSTRAP_ENDPOINT), so a version bump never
-#             leaves a stale ref here (V21)
+#             `bootstrap` stays symbolic in emitted files and resolves to
+#             the active Bootstrap package version at HTTP/load time
+#             (data-repo bootstrap/project.xml when present, else
+#             packaged minimal - V20/V21)
 #   keys      key fields: the emitted `key:`, the record sort order, and
 #             the B9 fallback's $select projection; the tuple must
 #             identify each record (V25 - a dup tuple is a row failure)