Sovereign 8s.is mirror of standardgalactic/personalinks
  • TeX 94.6%
  • Python 4.7%
  • Shell 0.7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
standardgalactic 2637b8cbd3 Prototyping
2026-08-13 21:31:00 -03:00
admissibility Theory Development 2026-08-13 14:41:42 -03:00
analysis Prototyping 2026-08-13 21:31:00 -03:00
build/reports Theory Development 2026-08-13 14:41:42 -03:00
conjectures Theory Development 2026-08-13 14:41:42 -03:00
docs Theory Development 2026-08-13 14:41:42 -03:00
dynamics Theory Development 2026-08-13 14:41:42 -03:00
essay Theory Development 2026-08-13 14:41:42 -03:00
history Theory Development 2026-08-13 14:41:42 -03:00
monograph Theory Development 2026-08-13 14:41:42 -03:00
processing Theory Development 2026-08-13 14:41:42 -03:00
prototypes Theory Development 2026-08-13 14:41:42 -03:00
scripts Theory Development 2026-08-13 14:41:42 -03:00
spherepop Theory Development 2026-08-13 14:41:42 -03:00
tests Theory Development 2026-08-13 14:41:42 -03:00
textbook Theory Development 2026-08-13 14:41:42 -03:00
v01-analysis Prototyping 2026-08-13 21:31:00 -03:00
working Theory Development 2026-08-13 14:41:42 -03:00
.gitignore Prototyping 2026-08-13 21:31:00 -03:00
Active Geodesic Inference.tex Theory Development 2026-08-13 14:41:42 -03:00
analyze-spherepop.sh Prototyping 2026-08-13 21:31:00 -03:00
attention-as-minimal-relational-interaction.tex Theory Development 2026-08-13 14:41:42 -03:00
CHANGELOG.md Theory Development 2026-08-13 14:41:42 -03:00
code-tree.txt Prototyping 2026-08-13 21:31:00 -03:00
COMPLETION_REPORT.txt Theory Development 2026-08-13 14:41:42 -03:00
Computation After Storage.tex Theory Development 2026-08-13 14:41:42 -03:00
Computation as Semantic Maintenance.tex Theory Development 2026-08-13 14:41:42 -03:00
computing-with-spherepop.tex Theory Development 2026-08-13 14:41:42 -03:00
CONTRIBUTING.md Theory Development 2026-08-13 14:41:42 -03:00
CORPUS_ANALYSIS_REPORT.md Prototyping 2026-08-13 21:31:00 -03:00
coverage.json Theory Development 2026-08-13 14:41:42 -03:00
entropy_of_austerity.tex Theory Development 2026-08-13 14:41:42 -03:00
Event-historical Aggregation.tex Theory Development 2026-08-13 14:41:42 -03:00
file-list.txt Prototyping 2026-08-13 21:31:00 -03:00
FUTURE_DIRECTIONS.md Theory Development 2026-08-13 14:41:42 -03:00
History as Identity - v01.tex Theory Development 2026-08-13 14:41:42 -03:00
History as Identity - v02.tex Theory Development 2026-08-13 14:41:42 -03:00
History as Identity.tex Theory Development 2026-08-13 14:41:42 -03:00
history-of-spherepop.tex Theory Development 2026-08-13 14:41:42 -03:00
identity_as_event_history-v1.tex Theory Development 2026-08-13 14:41:42 -03:00
identity_as_event_history.tex Theory Development 2026-08-13 14:41:42 -03:00
IMPROVEMENT_PLAN.md Theory Development 2026-08-13 14:41:42 -03:00
intelligence-explosion.tex Theory Development 2026-08-13 14:41:42 -03:00
Introducción a Spherepop - v01.tex Theory Development 2026-08-13 14:41:42 -03:00
Introducción a Spherepop.tex Theory Development 2026-08-13 14:41:42 -03:00
Joy-of-Spherepop-draft-01.tex Theory Development 2026-08-13 14:41:42 -03:00
Joy-of-Spherepop.tex Theory Development 2026-08-13 14:41:42 -03:00
Makefile Theory Development 2026-08-13 14:41:42 -03:00
Operational-Mereology.tex Theory Development 2026-08-13 14:41:42 -03:00
pipeline_functions.py Prototyping 2026-08-13 21:31:00 -03:00
pyproject.toml Theory Development 2026-08-13 14:41:42 -03:00
README.md Theory Development 2026-08-13 14:41:42 -03:00
README.md.backup Theory Development 2026-08-13 14:41:42 -03:00
Scope as Geometry.tex Theory Development 2026-08-13 14:41:42 -03:00
Spherepop Trajectory Collapse.tex Theory Development 2026-08-13 14:41:42 -03:00
spherepop-foundations.tex Theory Development 2026-08-13 14:41:42 -03:00
Spherepop-OS.tex Theory Development 2026-08-13 14:41:42 -03:00
spherepop.enterprise.toml Theory Development 2026-08-13 14:41:42 -03:00
Spherepop_Specifications.tex Theory Development 2026-08-13 14:41:42 -03:00
Structured Irreversibility.tex Theory Development 2026-08-13 14:41:42 -03:00
The Calculus of Commitment.tex Theory Development 2026-08-13 14:41:42 -03:00
The Forkability of Time.tex Theory Development 2026-08-13 14:41:42 -03:00
the-autonomy-of-refusal.tex Theory Development 2026-08-13 14:41:42 -03:00
THEORY_STATUS.md Theory Development 2026-08-13 14:41:42 -03:00
Throwing-the-game.tex Theory Development 2026-08-13 14:41:42 -03:00
throwing_the_game_v2.tex Theory Development 2026-08-13 14:41:42 -03:00
v01-analyze-spherepop.sh Prototyping 2026-08-13 21:31:00 -03:00

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, Events
  • semantics.py — The four primitive transitions
  • observers.py — Read-only analysis (confluence, regret, admissibility)
  • views.py — Presentation functions (extensional, history rendering)
  • grammar.py — Appendix G concrete syntax parser
  • predicates.py — BIND predicate DSL
  • path_utils.py — Sphere tree navigation
  • validation.py — Advisory configuration invariant checking
  • serialization.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

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 --json to 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.