_

Local Sovereignty Compute Kernel

Your history. You write it.

▼
 ▼▼▼
▼▼▼▼▼
scroll down
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

// Right to History

The Right to History means: an actor spends their own energy to initiate an action, writes the outcome into verifiable world state, and leaves an indelible trace. This right is inalienable, non-delegable, and irrevocable.

⚔

P — Actor

Human or Agent. Humans exist unconditionally; agents exist conditionally.

⚡

E — Energy

Universal cost metric for actions. Anchored to hardware INT8 TOPS, not arbitrary tokens.

▨

S — State

All persistent reality and verifiable history. S' = f(S, A, E).

S' = f(S, A, E)   where  E' = E - cost(A)

The system advances by action, not by time.

The system must have a single committer — a structural role, not a moral authority.

░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

// Architecture

Seven-Step Submit Pipeline

Validate Check actor status, boundary permissions, action format
>>>
Quote Compute energy cost of the action
>>>
Reserve Lock energy from actor balance
>>>
Execute Run action (process backend / sandbox)
>>>
Settle Finalize energy accounting incl. I/O overhead
>>>
Append Write to append-only log + cryptographic hash
>>>
Receipt Return verifiable receipt (event ID + hash)

Seven Invariants

01

Single Committer

One commit authority per history domain

02

Total Order Log

Committed events form a single total-order sequence

03

State Reconstructability

Current state derivable by replaying events

04

Semantic Append-Only

Committed events cannot be rewritten, only compensated

05

Provable Append-Only

Append-only property independently verifiable

06

Governance Auditable

Governance rules and changes enter event history

07

Evidence Independently Verifiable

Third parties can verify history integrity

░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

// Quick Start

Build & Test
# Clone the repo
$ git clone https://github.com/PunkGo/punkgo-kernel.git
$ cd punkgo-kernel
 
# Build
$ cargo build --workspace
 
# Run all tests
$ cargo test --workspace
Start Kernel
# Start the kernel daemon
$ cargo run --bin punkgo-kerneld
CLI Commands
# Check kernel health
$ cargo run --bin punkgo-cli -- read health
 
# Create a new actor
$ cargo run --bin punkgo-cli -- seed-actor alice --energy 5000
 
# Submit an action
$ cargo run --bin punkgo-cli -- submit '{
"actor_id": "root",
"action_type": "mutate",
"target": "workspace/hello",
"payload": {"msg": "world"}
}'
 
# View recent events
$ cargo run --bin punkgo-cli -- read events --limit 5
 
# Query audit trail
$ cargo run --bin punkgo-cli -- audit checkpoint
$ cargo run --bin punkgo-cli -- audit proof 0