eventgraph 0.6.0

Hash-chained, append-only, causal event graph
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

# eventgraph

A hash-chained, append-only, causal event graph. The foundation for building systems where every action is signed, auditable, and causally linked.

## Install

```bash
cargo add eventgraph
```

## Quick Start

```rust
use std::collections::BTreeMap;
use serde_json::Value;
use eventgraph::{
    event::{create_bootstrap, create_event, NoopSigner},
    store::{InMemoryStore, Store},
    types::{ActorId, ConversationId, EventType},
};

// Create store and bootstrap
let mut store = InMemoryStore::new();
let source = ActorId::new("actor_alice").unwrap();
let boot = create_bootstrap(source.clone(), &NoopSigner, 1);
let boot = store.append(boot).unwrap();

// Record an event — hash-chained and causally linked
let mut content = BTreeMap::new();
content.insert("score".into(), Value::Number(serde_json::Number::from_f64(0.85).unwrap()));
content.insert("domain".into(), Value::String("code_review".into()));

let ev = create_event(
    EventType::new("trust.updated").unwrap(),
    ActorId::new("actor_alice").unwrap(),
    content,
    vec![boot.id.clone()],
    ConversationId::new("conv_1").unwrap(),
    boot.hash.clone(),
    &NoopSigner,
    1,
);
store.append(ev).unwrap();

// Verify chain integrity
let result = store.verify_chain();
assert!(result.valid);
```

## What's Included

- **Types** — Always-valid domain models: Score [0,1], Weight [-1,1], Activation [0,1], Layer [0,13], Cadence [1,+inf), typed IDs (EventId, ActorId, Hash, etc.)
- **Event** — Immutable events with canonical form, SHA-256 hash chain, and causal links
- **Store** — Store trait and InMemoryStore with chain integrity enforcement
- **Bus** — Pub/sub event bus with pattern-based subscriptions
- **Primitive** — Primitive trait, lifecycle state machine, and registry
- **Tick Engine** — Ripple-wave processor with cadence control and quiescence detection

## Conformance

This crate produces identical SHA-256 hashes to the Go reference implementation for the same canonical form inputs. 79 tests including conformance hash vectors.

## Links

- [GitHub](https://github.com/lovyou-ai/eventgraph)
- [Documentation](https://github.com/lovyou-ai/eventgraph/tree/main/docs)
- [Go reference implementation](https://github.com/lovyou-ai/eventgraph/tree/main/go)

## License

[BSL 1.1](https://github.com/lovyou-ai/eventgraph/blob/main/LICENSE) converting to Apache 2.0 on 26 February 2030.