KArtSell.Aegis/docs/CURRENT/AEG-X-038_BLOCKER.md

AEG-X-038 — Fee/Tax/FX Valid-Time Decision Readiness

• WBS ID: AEG-X-038
• Requirement / Test IDs: REQ-COST-001 / T-COST-PIT
• Gate: G1
• Selected on: 2026-08-08
• Status: BLOCKED — no cost policy, data model, or execution path was implemented.

Source

• docs/CURRENT/CATALOGS/WBS_MASTER.csv, row AEG-X-038, requires reconfirmation of Fee/Tax/FX valid-time schedule decisions and explicitly prohibits a current single-value model.
• Its dependency, AEG-X-009, is recorded as completed in docs/CURRENT/CATALOGS/WBS_PROGRESS_TRACKER.csv.
• docs/CURRENT/CATALOGS/DECISION_LOG.csv, the source catalog, and the VS-02 governance documents contain no approved Fee/Tax/FX source authority or decision record.
• A repository search of application and test source (excluding generated web assets) found no Fee, Tax, FX, commission, or exchange-rate implementation path. The only relevant contract is contracts/metrics/outcome-metrics.v2.json, which names costs as a metric input but does not define schedules, sources, or valid-time semantics.

Assumption

• Applicable fee, tax, and FX terms vary by account, venue, instrument, jurisdiction, effective interval, and source publication/correction time. A default rate or a client-supplied value would violate REQ-COST-001 and the constitution's source/PIT rules.

Unknown / Decision Required

1. Source authority: identify the approved provider or governing document for each fee, tax, and FX schedule, including licence/retention and owner.
2. Temporal contract: approve effective_from/to, published_at, revision and correction semantics; specify which instant determines a transaction's applicable schedule.
3. Precedence: approve deterministic account → venue → instrument → jurisdiction fallback order, including the explicit hold behaviour when no schedule applies.
4. Scope boundary: decide whether FX is market data, cost data, or an approved read-model dependency; a module must not directly read another module's source tables.
5. Operational control: assign J04C calendar, Owner/Secondary, DQ checks, alert and rollback/replay procedure.

Recommended Resolution

Ops/Tax supplies approved source documents and Compliance/Owner approves the five decisions above. The Data Architect then authors a versioned data contract and an append-only MIG-COST-001 design. Only after those artifacts are approved can the MaintainFeeTaxFxSchedule slice be unblocked.

Evidence Produced

• This source-gap and decision-required record.
• WBS_PROGRESS_TRACKER.csv state linked to this record.

No rates, thresholds, source URLs, API, migration, job, UI, or test results are asserted or invented. No build, test, migration, or Gate pass is claimed.