constraint-theory-distributed 0.1.0__py3-none-any.whl

constraint_theory_core/__init__.py

@@ -0,0 +1,96 @@
+"""
+constraint_theory_core — unified geometric constraint theory.
+
+The one package that brings together:
+- Eisenstein A₂ lattice quantization
+- Deadband temporal funnels
+- Laman rigidity for topology
+- Metronome consensus
+- Holonomy consistency verification
+
+All constants derived from first principles. Zero external dependencies.
+
+Example
+-------
+>>> from constraint_theory_core import snap, covering_radius, is_safe
+>>> pt, err = snap(0.5, 0.3)
+>>> is_safe(err)
+True
+"""
+
+from .exercises import (
+    generate_exercise,
+)
+from .genre_brain import (
+    GenreEpsilons,
+    custom_genre,
+    get_genre,
+    list_genres,
+    sweep_genre,
+)
+from .holonomy import (
+    cycle_holonomy,
+    fault_boundaries,
+    isolate_fault,
+    soft_verify_consistency,
+    verify_consistency,
+)
+from .lattice import (
+    COVERING_RADIUS,
+    DIRECTION_COUNT,
+    DODECET_DIRECTIONS,  # noqa: F401 — re-exported for external use
+    SAFE_THRESHOLD,
+    SQRT_3,
+    A2Point,
+    covering_radius,
+    decode_dodecet,
+    encode_dodecet,
+    holonomy_product,
+    is_consistent,
+    is_safe,
+    norm_sq,
+    snap,
+    soft_snap,
+    vector48_decode,
+    vector48_encode,
+)
+from .metronome import (
+    Metronome,
+    MetronomeState,
+)
+from .rigidity import (
+    algebraic_connectivity,
+    henneberg_construct,
+    is_laman,
+    optimal_coupling,
+    soft_rigidity,
+)
+from .temporal import (
+    FunnelPhase,
+    FunnelResult,
+    TemporalAgent,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # Lattice
+    "A2Point", "snap", "soft_snap", "covering_radius", "is_safe", "norm_sq",
+    "decode_dodecet", "encode_dodecet", "vector48_encode", "vector48_decode",
+    "holonomy_product", "is_consistent",
+    "COVERING_RADIUS", "SAFE_THRESHOLD", "SQRT_3", "DIRECTION_COUNT",
+    # Temporal
+    "TemporalAgent", "FunnelPhase", "FunnelResult",
+    # Rigidity
+    "is_laman", "henneberg_construct", "algebraic_connectivity", "optimal_coupling", "soft_rigidity",
+    # Metronome
+    "Metronome", "MetronomeState",
+    # Holonomy
+    "cycle_holonomy", "verify_consistency", "soft_verify_consistency", "isolate_fault", "fault_boundaries",
+    # Genre Brain
+    "GenreEpsilons", "get_genre", "list_genres", "custom_genre", "sweep_genre",
+    # Exercises
+    "generate_exercise",
+    # Meta
+    "__version__",
+]

constraint_theory_core/__main__.py

@@ -0,0 +1,27 @@
+"""CLI entry-point: ``python -m constraint_theory_core <subcommand>``."""
+
+from __future__ import annotations
+
+import sys
+
+
+def main() -> None:
+    if len(sys.argv) < 2:
+        print("Usage: python -m constraint_theory_core <subcommand> [options]")
+        print("Subcommands: exercise")
+        sys.exit(1)
+
+    subcommand = sys.argv[1]
+    rest = sys.argv[2:]
+
+    if subcommand == "exercise":
+        from .exercises import _cli_exercise
+        _cli_exercise(rest)
+    else:
+        print(f"Unknown subcommand: {subcommand!r}")
+        print("Available: exercise")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()