Cognition-OS/kernel/supervisor-go/README.md

supervisor-go

Runnable stub demonstrating CognitiveOS control-plane concepts without an actual LLM.

This directory now contains a small ledger package (ledger/) with Append and Read APIs and unit tests, plus a tiny CLI demo (main.go) that appends route/session/output events to a JSONL ledger.

Run (demo)

Build or run the CLI:

go run . -ledger ./ledger.jsonl

Then type requests and observe the deterministic route decision, spawn/output events, and final output. The ledger file will be created as JSONL at the path you provide.

Tests

Run the unit tests for the ledger package:

go test ./ledger

The tests create a temporary ledger file, append events, and validate read-back and hash chaining.

Notes

• This is intentionally minimal and deterministic.
• Replace childWorkerStub with real model calls later.