You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[reporting] Provide built-in manifest and resource inspection #1103
The reporting reconciler handles ledger polling, snapshot restart, deduplication, retries, receipt creation, and receipt submission, but it requires every adopter to provide a custom inspect(context) callback for the security- and interoperability-critical resource path.
The SDK therefore does not yet deliver the intended “SDK-managed polling, deduplication, file retrieval, validation, and retries” experience.
What adopters must currently reinvent
retrieve a manifest/resource with destination credentials;
verify manifest SHA-256 and every file's size/checksum;
enforce manifest-last completeness;
parse the declared format/compression;
validate rows against the pinned schema contract;
safely fetch and digest-check report-definition/schema/canonicalization contracts;
recompute row counts, control totals, and RFC 8785 canonical content digests;
distinguish transient retrieval failures from permanent integrity failures;
return the exact ReportingObservation needed for a receipt.
Our seller/buyer vertical slice had to implement this callback manually before it could prove that both parties shared the same billing totals.
Proposed SDK surface
Keep the callback as an advanced escape hatch.
Add a built-in manifest/file inspector driven by a pluggable ReportingResourceReader and credential provider.
Ship readers/adapters for ordinary HTTPS and object-store resources, with warehouse/native-commit adapters as separate packages or interfaces.
Reuse the SDK's hardened canonical-reference fetch policy: HTTPS, DNS/IP pinning and private-range rejection, redirect policy, byte/time limits, digest-before-parse, bundled schema dialect, and local-fragment-only references.
Return typed, stable failure codes suitable for retry versus rejected receipt.
Add one conformance fixture that retrieves a manifest, verifies files, detects corruption/missing objects, recomputes totals/digest, and creates an accepted receipt.
Classification: Feature request Bucket(s): client/reporting (no matching repo label exists — flagged in run notes) Status: deferred
What the experts said:
N/A — pre-classification defer as child-of-open-parent
My take: Issue #1103 proposes adding a built-in manifest/file inspector that completes the inspect(context) escape-hatch story started in #1095. PR #1095 is an open draft by the same author still iterating on the reporting reconciler; this scope fits naturally within that PR before merge. Folding it now keeps the full inspection surface reviewable in one diff and avoids a separate rebasing pass after #1095 lands.
Activity
bokelley commentedon Aug 29, 2026
Triage
Classification: Feature request
Bucket(s): client/reporting (no matching repo label exists — flagged in run notes)
Status: deferred
What the experts said:
My take: Issue #1103 proposes adding a built-in manifest/file inspector that completes the
inspect(context)escape-hatch story started in #1095. PR #1095 is an open draft by the same author still iterating on the reporting reconciler; this scope fits naturally within that PR before merge. Folding it now keeps the full inspection surface reviewable in one diff and avoids a separate rebasing pass after #1095 lands.Blocked-on: #1095 — resurfaces on merge
Triaged by Claude Code. Session: https://claude.ai/code/session_01CL5uea78N24AZJewZkwRet
Generated by Claude Code