feat(protocol): BeaconV3 building-identity beacon#5
Merged
Conversation
V3 author per ADR-008 §D-11 (separate shape from V2 MCP-tenant declaration). is.scope: sovereign read-side inventory aggregator (ERC721+ERC1155); joins sonar ownership with codex metadata; ACVP completeness envelope; HTTP + MCP from one Hyper graph. is_not: 4 grounded entries (no mint/burn/transfer; no chain RPC proxy; no metadata ownership; no third-party indexers like Alchemy/Zapper/Dune). composes_with: - freeside-sonar (required, CONFIDENT — src/inventory.ts imports sonarClient) - storage REMOVED from canonical fixture (no actual storage imports in src/) tools: getHoldings, getNftsForOwner, getNftMetadata (the THREE actually registered in src/routes.ts → mcp.json — fixture's list_holder_inventory/ get_token_balance/resolve_collection_metadata names don't exist in code). acvp_invariants: ASPIRATIONAL — tests/acvp/ directory doesn't exist yet. event_completeness IS implemented in src/completeness.ts but proved by tests/live-smoke.test.ts not by a tests/acvp/ binding. Listed nonetheless to declare intended verifiability shape. cycle_state: candidate (matches README §Provenance verbatim). Placeholder hashes on composes_with.tag + sealed_schemas.hash — freeside-cli doctor recomputes at deploy. Dispatched from loa-freeside cluster coordinator (/coord beacon-v3 sweep). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced May 26, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
V3 building-identity beacon for inventory-api per ADR-008 §D-11. New file at
packages/protocol/beacon.yaml.Schema.decodeUnknown(BeaconV3Schema)— PASSDiverged from canonical fixture (deliberate)
The fixture at
loa-freeside/packages/beacon-schema/tests/fixtures/freeside-inventory-v3.yamlmodeled this cell speculatively. Real-code findings:freeside-storageimport insrc/— removed from composes_with. README §"Is not" line 18 names storage as the sovereign-target metadata successor (future), but todaysrc/codex-client.tsreads localfixtures/codex-tokens.json.getHoldings,getNftsForOwner,getNftMetadata(3 tools permcp.json+src/routes.ts). The fixture'slist_holder_inventory/get_token_balance/resolve_collection_metadatanames don't exist in code.a3f2c891d4e8b7c2-style hashes. Replaced with placeholder zeros forfreeside-cli doctorto recompute.Honest signals
acvp_invariants: ASPIRATIONAL —tests/acvp/directory does NOT exist.event_completenessIS implemented insrc/completeness.ts(proved bytests/live-smoke.test.ts) but not yet bound undertests/acvp/.sealed_schemas[0].path(packages/protocol/inventory-snapshot.schema.json) does NOT exist yet — declared so consumer surface is named.cycle_state: candidate(notactive) — honored README §Provenance verbatim.Substrate context
Part of cluster-wide BeaconV3 sweep dispatched from loa-freeside (
/coord beacon-v32026-05-26).Test plan
is/is_notevent_completenessinvariant undertests/acvp/(follow-up)packages/protocol/inventory-snapshot.schema.json(follow-up)🤖 Generated with Claude Code