Cleromancy

Cleromancy is a local-first divination journal (Tarot, dice, astrology context) built as a Graphshell product cut over Mere. Every reading is deterministic, securely cast, or derived from a public seed, and every result keeps a replayable receipt that separates context, qualification, selection, and interpretation.

Status (2026-08-13)

• The A0-A25 proof ledger is complete (2026-08-02 through 2026-08-07): single readings, sealed receipts with replay, field provenance, a 22-card Major Arcana pack, a fixed three-card spread, reading sessions and reflections, astrology chart and facts nodes, cross-system "consulted together" occasions, a resident multi-session authority, explicit persistence, and opt-in selected personal sync with durable local consent.
• The active phase is the headed local consultation: a journal window that authors contexts with extra name: value facts, makes calculated, cast, or derived readings and three-card casts, compares saved receipts, and appends immutable reflections.
• Derived readings replay byte-equal on independent engines from a public seed and domain (2026-08-08 contract).
• Authored spread templates (1-12 positions, reusable, content-addressed) with selected sync and explicit astrology chart input are the newest landed slice.
• The optional ephemeris feature now calculates source-qualified Sun, Moon, and planetary positions through the MPL-2.0 merely-made/anise fork. The native chart surface explicitly downloads and checksum-verifies NASA/JPL DE440s, then saves calculated facts into the normal consultation catalog. Its first three complete charts agree with NASA/JPL Horizons within the stored millidegree precision.
• The optional sky-timeline feature is the first daily astronomy consumer. It normalizes Turquet's New Moon and caller-threshold airless solar twilight facts for a UTC civil day and WGS84 observer. Numerical facts keep their policy and provenance; authored interpretation packs remain a separate, replayable layer. Refraction, limb, horizon-dip, weather, and general visibility policy remain caller-owned.

Plans live in design_docs/, one dated doc per slice. The current ephemeris stop rules keep houses, topocentric positions, generated interpretation, and automatic sync out of this proof.

Use

Building requires access to the merely-made mere, genet, and netrender repos (git dependencies).

cargo run --bin cleromancy         # the local consultation window
cargo run --features ephemeris --bin cleromancy # verified install and chart calculation
cargo test --features sky-timeline --test sky_timeline # daily timeline consumer
cargo test                         # the proof wall

# Per-slice receipt binaries, e.g.
cargo run --bin cleromancy_receipt -- receipts/a0.html

# Sync consent (off by default, local to this installation)
cargo run --features personal-sync --bin cleromancy -- sync-consent show

CLEROMANCY_ROOT overrides the data directory.

License

Cleromancy is MIT OR Apache-2.0. The optional ephemeris and sky-timeline features link third-party dependencies; see THIRD_PARTY_LICENSES.md.

---

This README was generated by AI and will be edited by the author upon release.