nicweyand/argand-site-registry
1
0
Fork 0
Code Issues Pull requests Projects Releases 7 Packages Wiki Activity Actions

release: implement site registry v0.5
All checks were successful
Standalone registry checks / check (push) Successful in 5m58s
Details

Browse source
This commit is contained in:
Nic Weyand 2026-09-13 14:42:39 -04:00
commit 557ba7cd69
Signed by: nicweyand
SSH key fingerprint: SHA256:2te+ycJIQON/Wo/dH6+ZkFSQ4HnHWpetV2azx9E65dQ
40 changed files with 3331 additions and 158 deletions
Download patch file Download diff file Expand all files Collapse all files

15
docs/ARCHITECTURE.md
View file

@ -11,7 +11,9 @@ flowchart LR
I --> W[(Writer store)]
O[Bounded candidate observer] --> B[Immutable observation batches]
B --> W
W --> G[Candidate generation]
W --> A[Content-addressed cold audit bundles]
W --> G[Compact candidate generation]
A -. digest references .-> G
G --> Q[Evidence bundles and review queue]
Q --> V[Signed reviewer votes]
V --> W
@ -24,12 +26,19 @@ flowchart LR
## Data boundaries
`sources`, `records`, and `facts` preserve provider-native evidence. Typed
The writer's `sources`, `records`, and `facts` preserve provider-native evidence. Typed
coverage selects a coherent active set without deleting older snapshots.
`selected_sources` and `active_records` record that derivation. Names, entities,
web properties, edges, popularity, and rejected facts are deterministic
projections.
A compact build packages every completed source into a content-addressed cold
JSONL bundle before removing superseded records and unprojected fact history from
the runtime copy. `COMPLETE.json` binds every bundle and the runtime database.
Normal queries need only the compact generation. Audit export, verification and
retention checkpoints stream the external bundle store and fail on absence,
substitution, truncation, malformed order, or mismatched source/attribution.
Names, website edges, and entity equivalences have separate material
fingerprints. Adding an alias therefore cannot inherit an approved destination,
and changing unrelated entity metadata does not invalidate an unchanged website
@ -72,7 +81,7 @@ unlinked snapshot before opening them.
| `source`, `store`, adapters | Manifest validation and streaming source-specific import |
| `coverage` | Full/partition/delta graph validation and active-record masking |
| `normalize` | Deterministic URL, hostname, registrable-domain, suffix, and name normalization |
| `build` | Canonical immutable generation and receipt creation |
| `build`, `audit` | Canonical compact generation, cold history, verification and retention |
| `bundle`, `policy`, `vote` | Review evidence, policy epochs, authenticated quorum, revocation |
| `observer`, `observation`, `queue` | Candidate-only collection, replay/import, reverse lookup, drift and queues |
| `query`, `resolution`, `identity`, `catalog` | Audit lookup, equivalence, resolution, statistics |