feat(oracle): export and apply evidence packets

2026-06-26 16:59:38 +08:00
parent 75ccede1cf
commit a523dac871
5 changed files with 226 additions and 3 deletions
@@ -32,3 +32,29 @@ inside external oracle evidence packets.
 Evidence packets remain `draft` until their target values are filled, their
 artifact is reviewed, and their status is explicitly promoted to
 `external_verified`.
+
+## Draft Packet Workflow
+
+Generate draft packets:
+
+```bash
+python3 scripts/oracle_collection_queue.py \
+  --oracle-file references/oracle/dasha_shadbala_oracle_cases.json \
+  --write-packet-dir references/oracle/artifacts/pending_packets \
+  --format json
+```
+
+Fill one `external_*.json` packet from JHora, PyJHora, VedAstro, or another
+documented external source. Then apply it back to the oracle file:
+
+```bash
+python3 scripts/oracle_collection_queue.py \
+  --oracle-file references/oracle/dasha_shadbala_oracle_cases.json \
+  --apply-packet references/oracle/artifacts/pending_packets/external_template_steve_jobs_dasha_lahiri.json \
+  --format json
+```
+
+Applying a packet does not make it trusted by itself. Rebuild the queue and run
+`scripts/oracle_evidence_validator.py`; only packets with complete metadata,
+filled targets, non-local artifacts, and `status: external_verified` can become
+`ready_for_calibration`.