arkhe-forge-core 0.13.0

L1 primitives for ArkheForge Runtime: Core 5 (User / Actor / Space / Entry / Activity) + ShellBrand invariant-lifetime isolation + deterministic entity-id derivation. Pure compute, no I/O.
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

# arkhe-forge-core

**L1 primitives for [ArkheForge Runtime](../arkhe-forge).**

Core 5 primitive types (User / Actor / Space / Entry / Activity), sealed
`ArkheComponent` / `ArkheAction` / `ArkheEvent` traits, `ShellBrand<'s>`
invariant-lifetime isolation, deterministic entity-id derivation. Pure compute —
no I/O, no time, no randomness.

## Layer

L1 of the Arkhe stack. Depends on `arkhe-kernel` (L0) and
`arkhe-macros` (derive provider). Does not depend on L2 `arkhe-forge-platform`
(layer-independence directive). Shell authors typically consume it through the
[`arkhe-forge`](../arkhe-forge) umbrella crate rather than directly.

## Core 5 primitives

- `User` — end-user identity (ActivityPub-hybrid).
- `Actor<'s, S>` — addressable runtime actor, tagged by `ShellBrand<'s>`.
- `Space` — bounded region with policy / membership.
- `Entry` — content-addressed post / object.
- `Activity` — verb record in the Activity pipeline.

## Quick start

```rust
use arkhe_forge_core::{derive_entity_id, MAX_ID_DERIVE_RETRIES};
use arkhe_kernel::abi::{InstanceId, Tick, TypeCode};

let world_seed = [0x42u8; 32];
let instance = InstanceId::new(1).unwrap();
let id = derive_entity_id(
    &world_seed,
    instance,
    TypeCode(0x0001_0001),
    Tick(42),
    0,
)
.expect("non-zero digest within MAX_ID_DERIVE_RETRIES");
```

## Key concepts

- **3-band determinism** — Core (L0 bit-identical) / Projection (eventually
  consistent) / Protocol-Correctness (shell-level).
- **Invariant-lifetime shell brand** — `Actor<'s, S>` types of two shells never
  unify; cross-shell contamination fails to compile.
- **TypeCode allocation** — 32-bit range partitioned into Core / Shell / Debug
  scopes; shell ranges isolated from upstream churn.
- **Axioms** — E1–E13 plus 30 per-primitive invariants enforced by
  `arkhe-runtime-testkit` property tests.
- **Sealed derives** — `#[derive(ArkheAction | ArkheComponent | ArkheEvent)]`
  from [`arkhe-forge-macros`](../arkhe-forge-macros); re-exported here.

## Documentation

- Runtime book: <https://aceamro.github.io/ArkheForge/>
- Repository: <https://github.com/aceamro/ArkheForge>

## License

Dual-licensed under MIT OR Apache-2.0 at your option.