The OCTO-ENGINE Carbon Census V1.4.0

OCTO-ENGINE SUITE v1.4: Executable Verification of the Octomorphic Carbon Singularity

This repository contains the source code for the OCTO-ENGINE (v1.4), a constraint-based geometric verification suite designed to falsify or confirm structural predictions within the Octomorphic Framework.

The suite operates on the 84-seat "Booty Flow" Registry (the geometric substrate) to strictly enumerate all admissible closed loops in the Carbon Block (Seats 10–15) under the "Constitutional Gates" of the framework. It does not simulate dynamics; it derives the exhaustive set of lawful geometric ground states.

Version v1.4 represents the corrected, canonical release, incorporating the Octave Scaling Factor (S=8) for Travel Budget validation and robust cyclic deduplication.

Key Findings

The execution of this suite verifies the Carbon Singularity by demonstrating that the Carbon Block uniquely admits exactly 10 lawful closures:

 * 1 Core Mode: Class C-II (Triangle) – The structural nucleus.

 * 9 Valence Modes: Class C-I (Square) – The bonding geometry.

 * 0 Anomalies: No other geometries satisfy the Constitutional Gates.

Additionally, the suite calculates the Internal Geometric Mass Ratio between the Core and Valence modes using the fixed Compactness Functional derived from the Standard Model text (W \propto TB^{1.5}\dots).

Repository Contents

 * export_shard.py: Installer utility. Freezes the Registry CSV data into a portable Python shard (carbon_data.py) for independent verification.

 * registry_core.py: The immutable substrate definition. Supports hybrid loading (CSV or Shard).

 * gatekeeper.py: The "Constitution." Implements the physical constraints:

   * Gate 1: Alignment (\Delta L \le 0.25)

   * Gate 2: Balance (Travel Budget \ge 0.60, scaled by Octave)

   * Gate 3: Geometry (Curvature Tension \lambda^2 < 25.0)

 * routing_solver.py: The constraint solver engine (Depth-First Search).

 * run_carbon_census.py: Experiment 001. Performs the structural enumeration and rotation-invariant deduplication.

 * particle_weigher.py: Diagnostic module implementing the Compactness Functional (W).

 * run_mass_audit.py: Experiment 002. Measures the geometric mass split of the discovered knots.

Methodology

The engine utilizes a "Constraint-First" architecture. It treats the geometric registry as a fixed graph and applies the Constitutional Gates as Boolean filters.

 * Topology: Defined strictly by the triangle_registry_with_booty_flow.csv adjacency.

 * Search: Recursive DFS with "look-ahead" pruning based on path legality.

 * Verification: Results are deduplicated via lexicographical rotation analysis to ensure unique geometric identity.

Usage

To replicate the findings:

 * Run python run_carbon_census.py to verify the 10-knot structure.

 * Run python run_mass_audit.py to obtain the geometric mass ratio.

   (Note: Requires carbon_data.py or the source CSV files in the working directory.)

License

Octomorphic Open License v1.1