rhombic 0.1.0__tar.gz

rhombic-0.1.0/.editorconfig

@@ -0,0 +1,21 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 4
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.{json,js,ts}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

rhombic-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,8 @@
+# rhombic Code Owners
+* @timm156
+
+# Security-critical files
+SECURITY.md @timm156
+.pre-commit-config.yaml @timm156
+.gitignore @timm156
+.github/CODEOWNERS @timm156

rhombic-0.1.0/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [timm156]

rhombic-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,37 @@
+name: Bug Report
+description: Something isn't working as expected
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Describe the bug clearly and concisely.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. pip install rhombic
+        2. python -m rhombic.benchmark
+        3. ...
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      placeholder: e.g. 3.12.1
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: e.g. macOS 15.2, Windows 11, Ubuntu 24.04

rhombic-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

rhombic-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,22 @@
+name: Feature Request
+description: Suggest a new topology, metric, or benchmark rung
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: Describe the use case or research question.
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed approach
+      description: How would you implement this? What topology, metric, or experiment?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered

rhombic-0.1.0/.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5

rhombic-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,15 @@
+## Summary
+
+<!-- What does this change? -->
+
+## Results
+
+<!-- If this adds or modifies benchmarks, include the numbers. -->
+
+## Checklist
+
+- [ ] No secrets, API keys, tokens, or passwords
+- [ ] Pre-commit hooks pass (`pre-commit run --all-files`)
+- [ ] Tests pass (`pytest -v`)
+- [ ] Cost reported alongside benefit (if adding benchmarks)
+- [ ] Existing results still reproducible

rhombic-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on: [push, pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[all]"
+
+      - name: Run tests
+        run: pytest -v
+
+  benchmark:
+    name: Reproduce Results
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -e ".[all]"
+
+      - name: Run benchmark suite
+        run: python -m rhombic.benchmark

rhombic-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,50 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write  # Required for Trusted Publisher (OIDC)
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: pypi
+      url: https://pypi.org/p/rhombic
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

rhombic-0.1.0/.github/workflows/security.yml

@@ -0,0 +1,28 @@
+name: Security Scan
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  gitleaks:
+    name: Secret Detection
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Install gitleaks
+        run: |
+          curl -sSfL https://github.com/gitleaks/gitleaks/releases/download/v8.30.0/gitleaks_8.30.0_linux_x64.tar.gz -o /tmp/gitleaks.tar.gz
+          tar xzf /tmp/gitleaks.tar.gz -C /tmp
+          chmod +x /tmp/gitleaks
+
+      - name: Run gitleaks
+        run: /tmp/gitleaks detect --source . --verbose --redact

rhombic-0.1.0/.gitignore

@@ -0,0 +1,43 @@
+# --- Secrets & Credentials ---
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+*.p12
+id_rsa*
+id_ed25519*
+credentials.json
+service-account*.json
+
+# --- Claude Code ---
+CLAUDE.local.md
+
+# --- Python ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+*.whl
+.eggs/
+venv/
+.venv/
+*.so
+
+# --- Testing ---
+.pytest_cache/
+.coverage
+htmlcov/
+
+# --- OS & Editor ---
+.DS_Store
+Thumbs.db
+desktop.ini
+*.swp
+*.swo
+*~
+.vscode/
+.idea/

rhombic-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,23 @@
+# rhombic pre-commit configuration
+# Install: pip install pre-commit && pre-commit install
+# Run manually: pre-commit run --all-files
+
+repos:
+  # Gitleaks — secret detection
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.30.0
+    hooks:
+      - id: gitleaks
+
+  # Standard pre-commit hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-added-large-files
+        args: ['--maxkb=500']
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: check-yaml
+      - id: detect-private-key
+      - id: end-of-file-fixer
+      - id: trailing-whitespace

rhombic-0.1.0/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-03-04
+
+### Added
+
+- **Rung 0: Lattice Library** — `CubicLattice` and `FCCLattice` classes with
+  matched node counts, interior degree verification, and NetworkX export
+- **Rung 1: Graph Theory** — average shortest path, diameter, algebraic
+  connectivity, and clustering coefficient benchmarks across three scales
+- **Rung 2: Spatial Operations** — flood fill, nearest-neighbor queries,
+  range queries, and locality-sensitive hashing benchmarks
+- **Rung 3: Signal Processing** — 3D bandlimited signal reconstruction MSE
+  and directional isotropy analysis (Petersen-Middleton confirmation)
+- **Rung 4: Context Architecture** — embedding neighbor recall, information
+  diffusion rate, and consensus convergence benchmarks
+- **Rung 5: Synthesis** — "The Shape of the Cell" complete synthesis document
+  with cultural genealogy, cybernetic interpretation, and recommendations
+- Visualization module with Vadrashinetal color palette
+- Banner generation from library code (`scripts/generate_banner.py`)
+- CI workflow (Python 3.10, 3.11, 3.12) with benchmark reproduction
+- Security scanning (gitleaks)
+- Full community health files (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY)
+
+### Key Results
+
+| Metric | FCC vs Cubic |
+|--------|-------------|
+| Average shortest path | 30% shorter |
+| Graph diameter | 40% smaller |
+| Algebraic connectivity | 2.4x higher |
+| Flood fill reach | 55% more nodes |
+| Signal reconstruction MSE | 5-10x lower |
+| Embedding neighbor recall | +15-26pp at 1-hop |
+| Edge cost | ~2x more edges |
+
+[0.1.0]: https://github.com/promptcrafted/rhombic/releases/tag/v0.1.0

rhombic-0.1.0/CLAUDE.md

@@ -0,0 +1,73 @@
+# rhombic — Project Identity
+
+You are assisting with **rhombic**, a lattice topology benchmarking library
+that compares cubic (6-connected) and FCC/rhombic dodecahedral (12-connected)
+lattice topologies. Built by Promptcrafted.
+
+## The Thesis
+
+The cubic lattice is the unexamined default of computation. This library
+measures the alternative and publishes reproducible results showing that
+the FCC lattice provides 30% shorter paths, 40% smaller diameter, and
+2.4x algebraic connectivity — at the cost of ~2x more edges.
+
+See `docs/THESIS.md` for the full argument.
+See `docs/EXPERIMENTAL_LADDER.md` for the 5-rung experimental plan.
+
+## Experimental Ladder
+
+| Rung | Topic | Status |
+|------|-------|--------|
+| 0 | Lattice Library | Complete |
+| 1 | Graph Theory Benchmarks | Complete |
+| 2 | Spatial Operations | Complete |
+| 3 | Signal Processing | Complete |
+| 4 | Context Architecture | Complete |
+
+## How to Add a New Rung
+
+1. Create `rhombic/your_module.py` with benchmarks
+2. Add tests in `tests/test_your_module.py`
+3. Run benchmarks and save results to `results/rung-N/`
+4. Write `RESULTS.md` and `INTERPRETATION.md` in the results directory
+5. Update `README.md` with key findings
+6. Ensure `python -m rhombic.benchmark` still reproduces all results
+
+## How to Add a New Topology
+
+The library compares cubic and FCC. To add another lattice topology
+(BCC, HCP, diamond cubic, etc.):
+
+1. Add a class in `rhombic/lattice.py` following the CubicLattice/FCCLattice pattern
+2. Must implement: `__init__(n)`, `to_networkx()`, `stats()`
+3. Add to `matched_lattices()` in `benchmark.py`
+4. Add unit tests verifying node count, interior degree, and connectivity
+
+## Principles
+
+- **Reproducible by default.** Every result has code that generates it.
+- **The geometry is the argument.** The numbers are the evidence.
+- **Cost is always reported alongside benefit.** The edge count ratio matters.
+- **Sparse results are data, not failure.** If a rung shows no advantage, publish that.
+- **Examine every default.** The project's thesis should inform how it's built.
+
+## Color Palette
+
+The visualization palette derives from the 8-Law Weave:
+
+```python
+CUBIC_COLOR = '#3D3D6B'    # Fall of Neutral Events (prime 11)
+FCC_COLOR = '#B34444'      # Geometric Essence (prime 67)
+```
+
+Do not change these without understanding their derivation. See
+`rhombic/visualize.py` for the full palette.
+
+## Technical
+
+- Python 3.10+
+- Dependencies: numpy, networkx (core); matplotlib (visualization); pytest (dev)
+- License: MPL-2.0
+- Tests: `pytest -v`
+- Benchmark: `python -m rhombic.benchmark`
+- Banner: `python scripts/generate_banner.py` (generates from library code)

rhombic-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,38 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainers at **security@promptcrafted.com**. All
+complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

rhombic-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Contributing to rhombic
+
+## Security First
+
+Before contributing, install the pre-commit hooks:
+
+```bash
+pip install pre-commit
+pre-commit install
+```
+
+Every commit is scanned for accidentally included secrets.
+
+## How to Contribute
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/your-feature`)
+3. Install pre-commit hooks (`pre-commit install`)
+4. Install dev dependencies: `pip install -e ".[all]"`
+5. Make your changes
+6. Run tests: `pytest`
+7. Commit with a descriptive message
+8. Push to your fork and open a Pull Request
+
+## What We're Looking For
+
+- **New lattice topologies.** BCC, hexagonal close-packed, diamond cubic — any tessellation with a clear mathematical characterization.
+- **New benchmark metrics.** Betweenness centrality, spectral gap, random walk cover time — anything that measures structural properties.
+- **New rungs on the experimental ladder.** Spatial operations, signal processing, context architecture — see `docs/EXPERIMENTAL_LADDER.md`.
+- **Performance improvements.** Faster lattice construction, GPU-accelerated metrics.
+- **Bug fixes and documentation improvements.**
+
+## What We're Not Looking For
+
+- Benchmarks that don't report cost alongside benefit. The edge count ratio matters.
+- Topologies without clear mathematical definition.
+- Changes that break reproducibility of existing results.
+
+## Philosophy
+
+- Reproducible by default. Every result has code that generates it.
+- The geometry is the argument. The numbers are the evidence.
+- Cost is always reported alongside benefit.
+- Sparse results are data, not failure.
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant](CODE_OF_CONDUCT.md).