How leojeshua/reader works
READER attributes black-box LLM responses to enrolled sources. Its main workflow loads response records, forms query-plus-response or response-only inputs, extracts frozen-proxy hidden-state fingerprints, trains a linear source probe, and accumulates evidence across query budgets. Separate branches support relationship benchmarks, stress and diagnostic experiments, and reporting. Some links reflect README descriptions or SOURCE INDEX references rather than inspected implementations; those evidence limits are noted by citing the README or the referencing source.
Main entry points: runners.py Experiment runner · closed_set.py Closed-set task · reader.py Frozen proxy reader · grouped.py Budget accumulation
Components 23
Data and release
- Dataset release
src/llm_api_provenance/data/release.py - Response records
src/llm_api_provenance/data/records.py
Attribution pipeline
- Run configuration
src/llm_api_provenance/framework/config.py - Experiment runner
src/llm_api_provenance/framework/runners.py - Input formatting
src/llm_api_provenance/inputs.py - Frozen proxy reader
src/llm_api_provenance/methods/reader.py - DCT fingerprints
src/llm_api_provenance/features/dct.py - Feature archives
src/llm_api_provenance/features/io.py - Linear source probe
src/llm_api_provenance/training/probe.py
Evaluation
- Closed-set task
src/llm_api_provenance/tasks/closed_set.py - Prompt-grouped folds
src/llm_api_provenance/evaluation/protocol.py - Budget accumulation
src/llm_api_provenance/evaluation/grouped.py - Bayesian evidence
src/llm_api_provenance/evaluation/evidence.py - Relationship benchmark
src/llm_api_provenance/tasks/relationship.py - Bench-A experiment
src/llm_api_provenance/experiments/bench_a.py
Diagnostics
- Stress tests
src/llm_api_provenance/experiments/stress.py - Temporal controls
src/llm_api_provenance/experiments/temporal.py - Layer scans
src/llm_api_provenance/experiments/layers.py - Source geometry
src/llm_api_provenance/experiments/geometry.py
Reporting
- Run reports
src/llm_api_provenance/reporting/runs.py - Figures and tables
src/llm_api_provenance/reporting/figures.py - Statistical analysis
src/llm_api_provenance/reporting/statistics.py
Other components
- Researcher
Connections 24
- Researcher → Run configuration: configures runs
README.md - Dataset release → Response records: provides responses
- Experiment runner → Run configuration: uses configuration
src/llm_api_provenance/framework/runners.py - Experiment runner → Response records: loads dataset
src/llm_api_provenance/framework/runners.py - Experiment runner → Input formatting: selects input
src/llm_api_provenance/framework/runners.py - Experiment runner → Frozen proxy reader: invokes extraction
src/llm_api_provenance/framework/runners.py - Frozen proxy reader → Input formatting: formats interaction
src/llm_api_provenance/methods/reader.py - Frozen proxy reader → DCT fingerprints: extracts fingerprint
src/llm_api_provenance/methods/reader.py - Experiment runner → Feature archives: saves features
src/llm_api_provenance/framework/runners.py - Experiment runner → Closed-set task: runs task
src/llm_api_provenance/framework/runners.py - Closed-set task → Feature archives: loads features
src/llm_api_provenance/tasks/closed_set.py - Closed-set task → Prompt-grouped folds: builds folds
src/llm_api_provenance/tasks/closed_set.py - Closed-set task → Linear source probe: trains probe
src/llm_api_provenance/tasks/closed_set.py - Closed-set task → Budget accumulation: scores budgets
src/llm_api_provenance/tasks/closed_set.py - Budget accumulation → Bayesian evidence: accumulates evidence
src/llm_api_provenance/evaluation/grouped.py - Experiment runner → Relationship benchmark: dispatches benchmark
src/llm_api_provenance/framework/runners.py - Experiment runner → Bench-A experiment: dispatches Bench-A
src/llm_api_provenance/framework/runners.py - Researcher → Stress tests: runs diagnostics
README.md - Researcher → Temporal controls: runs controls
README.md - Researcher → Layer scans: scans layers
README.md - Researcher → Source geometry: inspects geometry
README.md - Researcher → Figures and tables: generates reports
README.md - Figures and tables → Run reports: reads completed runs
src/llm_api_provenance/reporting/figures.py - Researcher → Statistical analysis: requests statistics
README.md