How bryanmatthewsimonson/xray works
X-Ray is a browser extension for capturing web sources, turning them into structured knowledge, reviewing and judging that knowledge, and publishing it to NOSTR. The main workflow starts with a user viewing or importing a source; the reader extracts it, then the user can structure claims and entities, run optional analyses, and publish signed events. Cases and the Network surface support broader investigation and discovery. The graph reflects README capabilities and indexed module references; unsampled implementation details and some runtime dispatch links are not inferred.
Main entry points: index.js Reader capture · entity-model.js Entity model · event-builder.js Event builder · claim-model.js Claim model
Components 24
Capture
- Reader capture
src/reader/index.js - Platform handlers
src/shared/platforms - PDF capture
src/reader/pdf-engine.js - Transcript & batch imports
src/portal/import-panel.js
Structure
- Entity model
src/shared/entity-model.js - Claim model
src/shared/claim-model.js - Case workspace
src/shared/case-membership.js - Archive & case portal
src/portal/index.js
Review
- Epistemic audits
src/shared/audit/run-orchestrator.js - Forensic findings
src/shared/forensic-corpus.js - Truth adjudication
src/shared/truth-adjudication-model.js - Moral lens
src/shared/lens-engine.js - LLM assistance
src/shared/llm-client.js
Publish & Network
- Event builder
src/shared/event-builder.js - Network client
src/network/index.js
Extension Core
- Local archive
src/shared/archive-cache.js - NOSTR crypto
src/shared/crypto.js - Local key manager
src/shared/local-key-manager.js - Extension storage
src/shared/storage.js - Background service
src/background/index.js
Other components
- User
- Web sources
- NOSTR relays
- Anthropic API
Connections 29
- User → Web sources: views or imports
README.md - Web sources → Reader capture: captured in
README.md - Reader capture → Platform handlers: extracts via
README.md - Reader capture → PDF capture: routes PDFs
README.md - User → Transcript & batch imports: starts import
README.md - Reader capture → Local archive: checks cache
src/shared/archive-cache.js - Reader capture → Entity model: tags entities
src/reader/index.js - Reader capture → Claim model: structures claims
src/reader/index.js - Reader capture → Epistemic audits: runs audit
README.md - Reader capture → Forensic findings: runs findings
README.md - Reader capture → Truth adjudication: records verdicts
README.md - Reader capture → Moral lens: shows readings
README.md - Reader capture → LLM assistance: requests assistance
README.md - Case workspace → Entity model: references entities
src/shared/case-membership.js - Case workspace → Claim model: references claims
src/shared/case-membership.js - Archive & case portal → Case workspace: opens workspace
src/portal/index.js - Archive & case portal → Local archive: reads archive
src/portal/index.js - LLM assistance → Anthropic API: sends analysis
README.md - Reader capture → Event builder: builds article events
src/reader/index.js - Event builder → Entity model: resolves entity tags
src/shared/event-builder.js - Background service → NOSTR relays: publishes events
README.md - Event builder → Background service: hands off events
src/background/index.js - Local key manager → NOSTR crypto: signs locally
src/shared/local-key-manager.js - Entity model → Local key manager: loads entity keys
src/shared/entity-model.js - Entity model → Extension storage: reads and writes
src/shared/entity-model.js - Claim model → Extension storage: reads and writes
src/shared/claim-model.js - Local archive → Event builder: assembles article
src/shared/archive-cache.js - Network client → NOSTR relays: fetches published work
README.md - Network client → Claim model: incorporates proposals
README.md