Asteria Hub Reconciliation
Required Workflow
- Read the task prompt,
payloads/case_scope.json,payloads/answer_template.json, andenvironment_access.md. Useenvironment_access.mdonly for the base URL, credentials, and query-interface details needed to access the running hub. - Read the hub catalog, schema, source snapshots, and the domain records named by the prompt. Use
/api/querywhen endpoint pages are large, when joins are needed, or when source rows must be filtered by collection and cutoff. - Build a local working table with every in-scope raw row. Keep public stable IDs, source system, snapshot ID, business time, update time, status, aliases, units, currency, and all evidence fields needed for the answer contract.
- Select the authoritative snapshot as of the business cutoff, then collapse overlapping rows by their logical business ID or identity cluster. Retain the authoritative/certified occurrence when duplicates cross snapshots, and report all duplicate groups required by the contract.
- Apply the domain rules in references/reconciliation_playbook.md. Compute all counts from the retained logical records, excluding quarantined records only where the prompt says normalized totals must exclude them.
- Fill every scoped focus, ranking, watchlist, and decision-panel entry from live hub evidence. Do not reuse example IDs, counts, names, or answer rows from prior tasks.
- Emit exactly one JSON object matching the supplied answer contract. Sort arrays and round numbers exactly as the contract or case scope requires. Run
scripts/contract_lint.pyas a final shape check when possible.
Helper Scripts
scripts/hub_dump.py: fetch paginated hub endpoints or submit a read-only query with credentials supplied fromenvironment_access.md.scripts/contract_lint.py: lightweight stdlib-only JSON contract checker for required keys, extra keys, enums, basic types, array bounds, uniqueness, and simple patterns.
Use the scripts as helpers, not as substitutes for reading the schema and reasoning from the records. If a script's generic pagination or contract checks do not match the live hub or custom template, inspect the response manually and adapt the solve in the workspace, not inside this skill.