- TeX 94.6%
- Python 4.7%
- Shell 0.7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| admissibility | ||
| analysis | ||
| build/reports | ||
| conjectures | ||
| docs | ||
| dynamics | ||
| essay | ||
| history | ||
| monograph | ||
| processing | ||
| prototypes | ||
| scripts | ||
| spherepop | ||
| tests | ||
| textbook | ||
| v01-analysis | ||
| working | ||
| .gitignore | ||
| Active Geodesic Inference.tex | ||
| analyze-spherepop.sh | ||
| attention-as-minimal-relational-interaction.tex | ||
| CHANGELOG.md | ||
| code-tree.txt | ||
| COMPLETION_REPORT.txt | ||
| Computation After Storage.tex | ||
| Computation as Semantic Maintenance.tex | ||
| computing-with-spherepop.tex | ||
| CONTRIBUTING.md | ||
| CORPUS_ANALYSIS_REPORT.md | ||
| coverage.json | ||
| entropy_of_austerity.tex | ||
| Event-historical Aggregation.tex | ||
| file-list.txt | ||
| FUTURE_DIRECTIONS.md | ||
| History as Identity - v01.tex | ||
| History as Identity - v02.tex | ||
| History as Identity.tex | ||
| history-of-spherepop.tex | ||
| identity_as_event_history-v1.tex | ||
| identity_as_event_history.tex | ||
| IMPROVEMENT_PLAN.md | ||
| intelligence-explosion.tex | ||
| Introducción a Spherepop - v01.tex | ||
| Introducción a Spherepop.tex | ||
| Joy-of-Spherepop-draft-01.tex | ||
| Joy-of-Spherepop.tex | ||
| Makefile | ||
| Operational-Mereology.tex | ||
| pipeline_functions.py | ||
| pyproject.toml | ||
| README.md | ||
| README.md.backup | ||
| Scope as Geometry.tex | ||
| Spherepop Trajectory Collapse.tex | ||
| spherepop-foundations.tex | ||
| Spherepop-OS.tex | ||
| spherepop.enterprise.toml | ||
| Spherepop_Specifications.tex | ||
| Structured Irreversibility.tex | ||
| The Calculus of Commitment.tex | ||
| The Forkability of Time.tex | ||
| the-autonomy-of-refusal.tex | ||
| THEORY_STATUS.md | ||
| Throwing-the-game.tex | ||
| throwing_the_game_v2.tex | ||
| v01-analyze-spherepop.sh | ||
Spherepop
A formal calculus of configuration transitions under historical constraint.
Spherepop implements the four primitive operations from "The History of Spherepop" as an executable micro-lab. Configurations evolve through an immutable history, where each transition appends exactly one event:
(σ, h) → (σ', h · e)
The calculus is closed over four primitives:
- POP: Remove a nested scope, promoting its contents
- REFUSE: Contract the option space by eliminating unwanted choices
- BIND: Filter options through a stated predicate
- COLLAPSE: Identify previously distinct options into equivalence classes
Core Principle
Spherepop treats history as primary identity. Two configurations may exhibit identical extensional views while remaining intensionally distinct — the trajectory matters, not merely what it presently looks like.
Quick Start
# Install
pip install -e .
# Run tests
pytest
# Try an experiment
python spherepop/03-pop/run.py
# Use the lab runner
python -m spherepop.lab list
python -m spherepop.lab verify
Installation
Requirements: Python 3.12+
git clone https://github.com/standardgalactic/personalinks.git
cd personalinks
pip install -e ".[dev]"
Example Usage
from spherepop import make_config, parse_sphere, transition
from spherepop.model import RefuseOp, CollapseOp
from spherepop.serialization import from_json, to_json
# Create initial configuration
cfg = make_config(parse_sphere("(root: a b c)"), {"a", "b", "c"})
# Refuse unwanted options
cfg = transition(cfg, RefuseOp(refused=frozenset({"c"})))
# Collapse remaining options into equivalence class
cfg = transition(cfg, CollapseOp(classes=(frozenset({"a", "b"}),)))
# History records the full trajectory
print(f"Events: {len(cfg.history)}") # 2
# Persist and restore config state
payload = to_json(cfg)
cfg_restored = from_json(payload)
assert cfg_restored == cfg
Architecture
Stable Core (spherepop/):
model.py— Data structures for Config, Operations, Eventssemantics.py— The four primitive transitionsobservers.py— Read-only analysis (confluence, regret, admissibility)views.py— Presentation functions (extensional, history rendering)grammar.py— Appendix G concrete syntax parserpredicates.py— BIND predicate DSLpath_utils.py— Sphere tree navigationvalidation.py— Advisory configuration invariant checkingserialization.py— JSON roundtrip for Config persistence
Experiments (spherepop/NN-*/):
- 29 numbered experiments exploring confluence, divergence, regret, horizon equivalence, and intensional vs extensional identity
Research (spherepop/poset.py):
- Plan B: Labeled option-space preorder (Appendix B semantics, not yet integrated)
Documentation
- THEORY_STATUS.md — What's paper-licensed vs implementation choice vs open
- CONTRIBUTING.md — Development workflow and theory discipline
- docs/DEVELOPMENT.md — Architecture guide
- tests/COVERAGE.md — Test coverage gaps and action plan
- docs/RESEARCH_PROGRAM.md — Manifest-driven research workflow
- API Documentation: Generate with
./docs/generate.sh
Research Laboratory
Spherepop includes a manifest-driven experiment harness:
python -m spherepop.lab list
python -m spherepop.lab run 01..29
python -m spherepop.lab verify
python -m spherepop.lab compare 07 08
python -m spherepop.lab theory-map
python -m spherepop.lab export 07 --output build/exp07.json
python -m spherepop.lab inspect build/exp07.json
python -m spherepop.lab validate build/exp07.json
python -m spherepop.lab replay build/exp07.json
- Manifest:
spherepop/experiment_manifest.json - Claim registry:
spherepop/theory_claims.json - Conjecture registry:
conjectures/ - Add
--jsonto emit machine-readable records
Interchange Schema
spherepop.serialization defines the versioned spherepop.config.v1 interchange format.
config_to_dict()/config_from_dict()operate on structural representation only.to_json()/from_json()preserve deterministic ordering invariants for stable artifacts.- Structural deserialization rejects malformed payloads but does not normalize or repair semantically invalid configs.
- Semantic admissibility/invariant checks remain in
spherepop.validation.validate_config().
Testing
# Full suite (159 tests)
pytest
# With coverage
pytest --cov=spherepop
# Property tests only
pytest -m experimental
# Fast tests (exclude slow benchmarks)
pytest -m "not slow"
Test Categories:
- Unit tests for each module
- Property-based tests (Hypothesis)
- Regression tests from experiments 01-29
- Integration tests for operation sequences
- Validation tests for structural invariants
Theory Discipline
Spherepop maintains strict separation between:
- Paper-licensed semantics — Explicitly stated in the appendices
- Implementation choices — Selected from valid alternatives (documented as such)
- Open questions — Genuinely underdetermined by current theory
- Experimental — Plan B, collapse composition, horizon equivalence details
See THEORY_STATUS.md for the complete status of questions Q1-Q8.
Prime directive: Don't turn an unanswered semantic question into an implementation default and then later mistake the default for Spherepop theory.
Current Status
- Tests: 159 passing (unit, property, regression, validation)
- Coverage: 73.89% (on path to 85% target)
- Type safety: mypy strict mode
- Supported: Python 3.12, 3.13
Contributing
See CONTRIBUTING.md for:
- Development workflow
- Pre-commit hooks setup
- How to add tests for provisional semantics
- When to mark tests with
@pytest.mark.experimental
License
MIT
Citation
@software{spherepop2026,
title={Spherepop: A micro-lab for configuration transition calculi},
author={Standard Galactic},
year={2026},
url={https://github.com/standardgalactic/personalinks}
}
Status: Active research. The four primitives are stable. Plan B (labeled preorder) and collapse composition remain experimental.