- Rust 98.4%
- C++ 1.2%
- Python 0.4%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Soul's pass found the suite claimed more than it proved: H1-H20 killed twenty mutations, and nineteen further permissivenesses could be restored with every test still green. A rule no test reaches is a rule the next pass may delete by accident. Two of them were about the receipt's atomicity and its reach, and needed new machinery. A store in `receipt.rs`'s tests records the replacement set of every swap it is asked for, which lets one test say what no assertion over the resulting image could: a commit is one compare-and-swap, and the documents and their receipt go in it together. Splitting the receipt into a second swap now fails. Separately, a batch citing three image documents is pinned against all three, so truncating the strong reads to the first of them fails. The rest are one fixture apiece, each closing a row the per-kind rules already held: stewardship looked up in image as well as batch; the cut report's repo as well as its branch; a promise measured by the claim that names that label; the invariant vocabulary taken from the in-force target and not a superseded one; a question that is answered or withdrawn but never superseded, and a target never answered; the derived stewardship dated by the hand-off; derived writes passing A3-A7, so a derived identity the batch already holds is A4's refusal and not a store error; A4 and A2 themselves; a question's two distinct options and its recommendation among them; unique labels on a question's options and a target's invariants; a finding's locations; and an `Answered` naming the ruling that actually answers its subject. `tools/eureka-cut8-mutations.psd1` grows to H1-H39. H21 and H22 pin the opener's epoch key and count, H23 `EmptyRepos`; the rest are Soul's own survivors, adopted as entries so the thing that found them is the thing that guards them. Harness: M0 green at 31 tests, H1-H39 all killed by their own test. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> |
||
| .voidbot | ||
| crates | ||
| tools | ||
| .gitignore | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| README.md | ||
Huginn
Huginn is the GameCult memory organ. It owns each agent instance's mind as typed state: what an instance remembers, which of that memory is admitted to steer its next action, and the provenance of every admitted claim.
Upstream: https://github.com/GameCult/Huginn.git
Authority
- An instance owns its mind; Huginn owns the state. Huginn is the single writer of an instance's memory documents. No other service, script, or agent writes them.
- Memory documents are CultCache state.
huginn-mind, the one live crate, persists them through CultLib's Rust CultCache into a redb store at<state_root>/minds/<instance>/mind.redb. Publishing them over CultNet ishuginn-daemon's, and that crate is a stub: nothing here publishes yet. - Retrieval is to depend on Qdrant directly, refusing loudly when Qdrant is unreachable rather than falling back to a second store or a second writer. No crate opens that connection yet.
- Mind state is not version-controlled. It lives in Huginn's store, not in any repository.
Generic .cc inspection is not Huginn's job. CultCache Studio inspects and
edits .cc state. Huginn reads and writes minds.
Layout
A Cargo workspace of three crates:
crates/huginn-mind: storage, identity, and admission of memory documents.crates/huginn-daemon: the CultNet surface and serve loop.crates/eureka-state: typed state for the Eureka pipeline.
huginn-mind is live: it opens one instance's store (an owned redb CultCache
at <state_root>/minds/<instance>/mind.redb, locked for the mind's lifetime),
and refuses a store whose instance document names another instance, whose
epoch record is foreign, or whose types are not a mind's. It admits batches
of pipeline documents through one commit path: the leaf's bounds, formats and
keys, then the organ's cross-document rules (references, in-force status,
the resolution matrix, derived resolutions and stewardships), then one
compare-and-swap that lands the batch whole with a receipt naming the exact
bytes it read and wrote. An exact replay answers with the stored receipt.
Document shape and keys come from epiphany-pipeline; the store is CultLib's
Rust CultCache.
huginn-daemon and eureka-state are stubs; the
campaign's cut map in Epiphany/notes/eureka-pipeline-state-cut.md owns what
each crate must do next.
cargo check --workspace
Persona
Huginn's legacy repo Persona lives under .voidbot/. Its state/huginn.cc
holds legacy void.* documents and its voice/identity.json names the
Persona. The two disagree about jurisdiction; that migration belongs to the
portable-Persona work, not to this workspace, and nothing here reads or writes
.voidbot/.