Sovereign 8s.is mirror of standardgalactic/clio-machine
  • Python 50.9%
  • TeX 47.9%
  • Shell 0.9%
  • Makefile 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Cogito Ergo Sum e013eaa406
Some checks failed
CI / validate (push) Has been cancelled
Fix typo in project description from 'Organiser' to 'Optimizer'
2026-08-07 12:41:03 -03:00
.github/workflows Harden CI token permissions for CodeQL compliance 2026-08-07 15:36:43 +00:00
agents Add research protocol documentation scaffold 2026-08-07 13:34:16 +00:00
appendices Add cumulative formal backbone and chapter prefaces 2026-08-07 14:12:51 +00:00
backmatter Add initial CLIO LaTeX scaffold skeleton 2026-08-07 14:08:41 +00:00
benchmarks Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
bibliography Add initial CLIO LaTeX scaffold skeleton 2026-08-07 14:08:41 +00:00
bin feat: add spherepop primitives and tiny forth machine 2026-08-07 13:18:30 +00:00
blender Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
book Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
common Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
datasets Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
docs Add CI, semantic tests, and contributor verification/docs hardening 2026-08-07 15:35:28 +00:00
examples Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
experiments Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
figures Add generated manuscript figure artifact 2026-08-07 14:13:59 +00:00
forth feat: add spherepop primitives and tiny forth machine 2026-08-07 13:18:30 +00:00
frontmatter Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
lectures Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
notes Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
papers Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
parts Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
python Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
rust Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
scenes feat: add spherepop blender suite with 10 scenes and headless runners 2026-08-07 13:53:31 +00:00
scripts Fix scaffold validator chapter directory discovery 2026-08-07 14:30:43 +00:00
simulations Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
slides Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
spherepop feat: add spherepop primitives and tiny forth machine 2026-08-07 13:18:30 +00:00
spherepop_blender feat: add spherepop blender suite with 10 scenes and headless runners 2026-08-07 13:53:31 +00:00
styles Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
tests Add CI, semantic tests, and contributor verification/docs hardening 2026-08-07 15:35:28 +00:00
videos Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
website Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
.gitignore feat: add spherepop primitives and tiny forth machine 2026-08-07 13:18:30 +00:00
.latexmkrc Add initial CLIO LaTeX scaffold skeleton 2026-08-07 14:08:41 +00:00
clio.sh feat: add spherepop primitives and tiny forth machine 2026-08-07 13:18:30 +00:00
clio.tex Add initial CLIO LaTeX scaffold skeleton 2026-08-07 14:08:41 +00:00
COPILOT.md Add research protocol documentation scaffold 2026-08-07 13:34:16 +00:00
Makefile Standardize chapter scaffold and metadata model 2026-08-07 14:29:59 +00:00
README.md Fix typo in project description from 'Organiser' to 'Optimizer' 2026-08-07 12:41:03 -03:00
SPHEREPOP.md Add CI, semantic tests, and contributor verification/docs hardening 2026-08-07 15:35:28 +00:00
SPHEREPOP_BLENDER_SUITE.md feat: add spherepop blender suite with 10 scenes and headless runners 2026-08-07 13:53:31 +00:00

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/ defines Pop, Refuse, Bind, and Collapse over persistent history.
  • bin/spherepop provides 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.md defines contributor context for coding agents.
  • /home/runner/work/clio-machine/clio-machine/docs/INVARIANTS.md defines semantic contracts.
  • /home/runner/work/clio-machine/clio-machine/docs/ARCHITECTURE.md describes repository layers.
  • /home/runner/work/clio-machine/clio-machine/docs/ROADMAP.md separates foundation, active focus, and experiments.
  • /home/runner/work/clio-machine/clio-machine/docs/GLOSSARY.md defines project terms.
  • /home/runner/work/clio-machine/clio-machine/docs/CONTRIBUTING.md defines human and AI contribution rules.
  • /home/runner/work/clio-machine/clio-machine/agents/project_context.md provides a concise machine-oriented prompt.
  • /home/runner/work/clio-machine/clio-machine/SPHEREPOP_BLENDER_SUITE.md documents 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