Skip to content

Expose inspectable signed claim-reference edges - #31

Open
nirmalhk7 wants to merge 2 commits into
NTARI-RAND:mainfrom
nirmalhk7:nirmal/cloudy-reference-discovery
Open

nirmalhk7 wants to merge 2 commits into
NTARI-RAND:mainfrom
nirmalhk7:nirmal/cloudy-reference-discovery

Conversation

@nirmalhk7

@nirmalhk7 nirmalhk7 commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

Adds public GET /api/v1/claims/{id}/references so readers can inspect the signed edges behind a claim's citation breakdown. Existing claim summaries and reference creation stay compatible.

The collection requires direction=inbound|outbound, optionally filters any existing reference kind, and returns accepted edges in append order. Pages default to 50 references and allow at most 100. Decimal append-position cursors remain stable across new appends. Each result includes its reference ID and every signed structural field; decimal-string nanoseconds preserve exact timestamps for independent verification. Invalid IDs, filters, cursors, and limits return 400; unknown claims return 404. The response excludes member-local narrative and introduces no truth ranking or privileged author status.

Adds bounded-copy traversal in the techtree, consumer API routing/export, regression tests, API documentation, and conformance notes. A sparse query can still scan the append history; pagination is live rather than a frozen snapshot. The existing single-writer stand-in remains explicit.

Validation: API tests failed on the missing route before implementation, then passed. Tests cover exact paged edge sets in both directions, all five kinds, complete signature verification, tamper rejection, nanosecond precision, empty results, append-stable pagination, page bounds, privacy, and malformed inputs. The full race-enabled Go suite, formatting, vet, and build passed. Current Janus document and invariant-ID binding checks passed; delegated gaps remain reported as such. Full Qlty scans introduced no new smells or check findings against the comparable uncapped baseline; existing findings remain.

Follows the Janus architecture.

Signed-off-by: Nirmal Khedkar <nirmalhk7@gmail.com>
Signed-off-by: Nirmal Khedkar <nirmalhk7@gmail.com>
@nirmalhk7
nirmalhk7 marked this pull request as ready for review November 11, 2026 23:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant