Sovereign 8s.is mirror of standardgalactic/clio-machine
- Python 50.9%
- TeX 47.9%
- Shell 0.9%
- Makefile 0.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .github/workflows | ||
| agents | ||
| appendices | ||
| backmatter | ||
| benchmarks | ||
| bibliography | ||
| bin | ||
| blender | ||
| book | ||
| common | ||
| datasets | ||
| docs | ||
| examples | ||
| experiments | ||
| figures | ||
| forth | ||
| frontmatter | ||
| lectures | ||
| notes | ||
| papers | ||
| parts | ||
| python | ||
| rust | ||
| scenes | ||
| scripts | ||
| simulations | ||
| slides | ||
| spherepop | ||
| spherepop_blender | ||
| styles | ||
| tests | ||
| videos | ||
| website | ||
| .gitignore | ||
| .latexmkrc | ||
| clio.sh | ||
| clio.tex | ||
| COPILOT.md | ||
| Makefile | ||
| README.md | ||
| SPHEREPOP.md | ||
| SPHEREPOP_BLENDER_SUITE.md | ||
clio-machine
Constraint-Linked Inference Optimizer (CLIO)
This repository implements the bottom of the CLIO experimental ladder:
Spherepop primitives
-> history machine
-> Forth machine
The current implementation is intentionally small and append-only:
spherepop/definesPop,Refuse,Bind, andCollapseover persistent history.bin/spherepopprovides a Bash-friendly CLI for recording and inspecting history.forth/provides a tiny Forth compiler + VM whose execution is realized through Spherepop events.spherepop_blender/+scenes/provide a Blender visualization suite for persistent Spherepop event histories.
The manuscript now follows a standardized modular chapter scaffold with shared
common/ reusable content, chapter metadata, and a generated prerequisite graph.
Research protocol docs
/home/runner/work/clio-machine/clio-machine/COPILOT.mddefines contributor context for coding agents./home/runner/work/clio-machine/clio-machine/docs/INVARIANTS.mddefines semantic contracts./home/runner/work/clio-machine/clio-machine/docs/ARCHITECTURE.mddescribes repository layers./home/runner/work/clio-machine/clio-machine/docs/ROADMAP.mdseparates foundation, active focus, and experiments./home/runner/work/clio-machine/clio-machine/docs/GLOSSARY.mddefines project terms./home/runner/work/clio-machine/clio-machine/docs/CONTRIBUTING.mddefines human and AI contribution rules./home/runner/work/clio-machine/clio-machine/agents/project_context.mdprovides a concise machine-oriented prompt./home/runner/work/clio-machine/clio-machine/SPHEREPOP_BLENDER_SUITE.mddocuments the Blender scene suite and headless render scripts.
Quick start
bin/spherepop pop 5
bin/spherepop pop 8
bin/spherepop bind 0 1
bin/spherepop collapse 2
bin/spherepop trace
bin/forth "2 3 + ."
Use SPHEREPOP_STATE_PATH to control where history is persisted.
Manuscript scaffold checks
make check
This validates labels, chapter scaffold consistency, and dependency graph drift.
Tests
Run all tests:
python -m unittest discover -s tests -p "test_*.py"
Invariant-focused regression coverage lives in:
/home/runner/work/clio-machine/clio-machine/tests/test_semantic_invariants.py
Canonical local verification (matches CI)
Run the same verification sequence used by the CI workflow before opening a pull request:
python -m unittest discover -s tests -p "test_*.py"
make check