pre-reasoning 2.5.0__tar.gz

pre_reasoning-2.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mia Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pre_reasoning-2.5.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include pre_reasoning/checkpoints/*.safetensors
+exclude checkpoints/*.pt
+prune __pycache__
+global-exclude *.py[cod]
+global-exclude .DS_Store

pre_reasoning-2.5.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: pre-reasoning
+Version: 2.5.0
+Summary: 3M-parameter neural pre-reasoning engine for grounding LLMs before they answer.
+Author: Luis Lozano, Dr. Shannon (Mia Labs AI co-researcher), Mia Labs
+License-Expression: MIT
+Project-URL: Repository, https://github.com/luislozanogmia/pre-reasoning
+Keywords: reasoning,llm,graph,deterministic
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: neural
+Requires-Dist: torch>=2.0.0; extra == "neural"
+Requires-Dist: safetensors>=0.4.0; extra == "neural"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Dynamic: license-file
+
+# Pre-Reasoning
+
+Pre-Reasoning is a Mia Labs structural analysis engine that grounds an LLM before it answers. It uses a 3M-parameter neural model (V3) to surface dependencies, root blockers, unlock order, parallel work, cycles, and conflicts from problem text.
+
+The engine ships with bundled safetensors weights -- install and run, no downloads needed.
+
+## What It Does
+
+Given natural-language problem text, the engine returns:
+
+- ROOT BLOCKERS: what must be resolved first
+- UNLOCK SEQUENCE: a dependency-aware resolution order
+- PARALLEL WORK: independent items that can proceed now
+- CYCLES: circular dependencies that cannot be solved sequentially
+- CONFLICTS: competing positions or incompatible entities
+- REQUIREMENTS: numeric or threshold requirements
+
+When `torch` is not installed, the engine falls back to deterministic heuristic graph reasoning. For the best experience, install the `[neural]` extra.
+
+## Install
+
+```bash
+pip install pre-reasoning              # base (deterministic fallback)
+pip install "pre-reasoning[neural]"    # full: 3M-param V3 neural model
+```
+
+For local development from this repo:
+
+```bash
+pip install -e .
+pip install -e ".[neural]"
+```
+
+## Python Usage
+
+```python
+from pre_reasoning import analyze, pulse
+
+result = analyze("Frontend depends on API. API depends on Auth.")
+print(result["trace"])
+
+check = pulse(
+    "Frontend depends on API. API depends on Auth.",
+    "Fix Auth first, then verify the API before frontend work."
+)
+print(check["status"])
+```
+
+## CLI Usage
+
+```bash
+pre-reasoning "A depends on B. B depends on C."
+pre-reasoning --json "CTO conflicts with senior dev."
+pre-reasoning --info
+```
+
+To use a different weights file, set `PRE_REASONING_CHECKPOINT=/path/to/weights.safetensors` or pass `--checkpoint`.
+
+## Results
+
+Early comparison table, illustrative, n=5 architectural decision problems:
+
+| Comparison | Illustrative result, n=5 |
+|---|---:|
+| 9B + trace vs 32B baseline | 3W 2T 0L |
+| 9B + trace vs 120B baseline | 4W 1T 0L |
+| 120B + trace vs 120B baseline | 3W 2T 0L |
+
+These are product-research notes, not benchmark claims.
+
+## Architecture
+
+```text
+Full install (recommended):
+User text
+  -> V3 neural perception (3M params, safetensors)
+  -> neural findings converted to structural blocks
+  -> heuristic graph analysis
+  -> structural trace
+
+Base install (fallback when torch is missing):
+User text
+  -> deterministic text-to-blocks adapter
+  -> heuristic graph analysis
+  -> structural trace
+```
+
+## File Map
+
+| Path | Purpose |
+|---|---|
+| `pre_reasoning/` | Installable Python package and CLI entry point |
+| `pre_reasoning/inference.py` | 3M-parameter V3 neural perception layer |
+| `pre_reasoning/heuristic.py` | Deterministic graph-reasoning core (fallback) |
+| `pre_reasoning/pre_reasoning_v2_5.py` | v2.5 orchestrator: V3 neural + heuristic |
+| `pre_reasoning/checkpoints/pre-reasoning-3m-v2.5.safetensors` | Bundled V3 weights (11MB) |
+| `examples/` | Runnable usage examples |
+| `tests/` | Pytest suite |
+| `skill/SKILL.md` | Agent skill descriptor for model adoption |
+| `CLAUDE.md` | Optional Claude Code hooks configuration |
+| `WHY_TRACES_WORK.md` | Literature connection, 9 cited papers |
+
+## Weights Policy
+
+The raw training checkpoint is not part of the release. The package bundles `pre_reasoning/checkpoints/pre-reasoning-3m-v2.5.safetensors`, a weights-only inference artifact. It ships no training metadata: no optimizer state, LR schedules, step counters, RNG state, training config, or raw checkpoint provenance.
+
+## License
+
+MIT License. See `LICENSE`.
+
+## Authors
+
+Luis Lozano and Dr. Shannon, Mia Labs' AI co-researcher, 2026.

pre_reasoning-2.5.0/README.md

@@ -0,0 +1,113 @@
+# Pre-Reasoning
+
+Pre-Reasoning is a Mia Labs structural analysis engine that grounds an LLM before it answers. It uses a 3M-parameter neural model (V3) to surface dependencies, root blockers, unlock order, parallel work, cycles, and conflicts from problem text.
+
+The engine ships with bundled safetensors weights -- install and run, no downloads needed.
+
+## What It Does
+
+Given natural-language problem text, the engine returns:
+
+- ROOT BLOCKERS: what must be resolved first
+- UNLOCK SEQUENCE: a dependency-aware resolution order
+- PARALLEL WORK: independent items that can proceed now
+- CYCLES: circular dependencies that cannot be solved sequentially
+- CONFLICTS: competing positions or incompatible entities
+- REQUIREMENTS: numeric or threshold requirements
+
+When `torch` is not installed, the engine falls back to deterministic heuristic graph reasoning. For the best experience, install the `[neural]` extra.
+
+## Install
+
+```bash
+pip install pre-reasoning              # base (deterministic fallback)
+pip install "pre-reasoning[neural]"    # full: 3M-param V3 neural model
+```
+
+For local development from this repo:
+
+```bash
+pip install -e .
+pip install -e ".[neural]"
+```
+
+## Python Usage
+
+```python
+from pre_reasoning import analyze, pulse
+
+result = analyze("Frontend depends on API. API depends on Auth.")
+print(result["trace"])
+
+check = pulse(
+    "Frontend depends on API. API depends on Auth.",
+    "Fix Auth first, then verify the API before frontend work."
+)
+print(check["status"])
+```
+
+## CLI Usage
+
+```bash
+pre-reasoning "A depends on B. B depends on C."
+pre-reasoning --json "CTO conflicts with senior dev."
+pre-reasoning --info
+```
+
+To use a different weights file, set `PRE_REASONING_CHECKPOINT=/path/to/weights.safetensors` or pass `--checkpoint`.
+
+## Results
+
+Early comparison table, illustrative, n=5 architectural decision problems:
+
+| Comparison | Illustrative result, n=5 |
+|---|---:|
+| 9B + trace vs 32B baseline | 3W 2T 0L |
+| 9B + trace vs 120B baseline | 4W 1T 0L |
+| 120B + trace vs 120B baseline | 3W 2T 0L |
+
+These are product-research notes, not benchmark claims.
+
+## Architecture
+
+```text
+Full install (recommended):
+User text
+  -> V3 neural perception (3M params, safetensors)
+  -> neural findings converted to structural blocks
+  -> heuristic graph analysis
+  -> structural trace
+
+Base install (fallback when torch is missing):
+User text
+  -> deterministic text-to-blocks adapter
+  -> heuristic graph analysis
+  -> structural trace
+```
+
+## File Map
+
+| Path | Purpose |
+|---|---|
+| `pre_reasoning/` | Installable Python package and CLI entry point |
+| `pre_reasoning/inference.py` | 3M-parameter V3 neural perception layer |
+| `pre_reasoning/heuristic.py` | Deterministic graph-reasoning core (fallback) |
+| `pre_reasoning/pre_reasoning_v2_5.py` | v2.5 orchestrator: V3 neural + heuristic |
+| `pre_reasoning/checkpoints/pre-reasoning-3m-v2.5.safetensors` | Bundled V3 weights (11MB) |
+| `examples/` | Runnable usage examples |
+| `tests/` | Pytest suite |
+| `skill/SKILL.md` | Agent skill descriptor for model adoption |
+| `CLAUDE.md` | Optional Claude Code hooks configuration |
+| `WHY_TRACES_WORK.md` | Literature connection, 9 cited papers |
+
+## Weights Policy
+
+The raw training checkpoint is not part of the release. The package bundles `pre_reasoning/checkpoints/pre-reasoning-3m-v2.5.safetensors`, a weights-only inference artifact. It ships no training metadata: no optimizer state, LR schedules, step counters, RNG state, training config, or raw checkpoint provenance.
+
+## License
+
+MIT License. See `LICENSE`.
+
+## Authors
+
+Luis Lozano and Dr. Shannon, Mia Labs' AI co-researcher, 2026.

pre_reasoning-2.5.0/pre_reasoning/__init__.py

@@ -0,0 +1,61 @@
+"""Public package API for Pre-Reasoning."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+from .pre_reasoning_v2_5 import ReasoningEngineV25
+
+ReasoningEngine = ReasoningEngineV25
+
+__all__ = [
+    "ReasoningEngineV25",
+    "ReasoningEngine",
+    "analyze",
+    "pulse",
+    "get_engine",
+]
+
+
+def get_engine(
+    *,
+    checkpoint_path: Optional[str] = None,
+    device: str = "auto",
+) -> ReasoningEngineV25:
+    """Create a reasoning engine.
+
+    The package-level default is auto mode: use neural perception when the
+    optional dependencies are installed, otherwise fall back to deterministic
+    graph reasoning without torch.
+    """
+    return ReasoningEngineV25(
+        checkpoint_path=checkpoint_path,
+        device=device,
+    )
+
+
+def analyze(
+    text: str,
+    *,
+    checkpoint_path: Optional[str] = None,
+    device: str = "auto",
+) -> dict:
+    """Analyze problem text and return a structural trace result."""
+    return get_engine(
+        checkpoint_path=checkpoint_path,
+        device=device,
+    ).analyze(text)
+
+
+def pulse(
+    original_problem: str,
+    response: str,
+    *,
+    checkpoint_path: Optional[str] = None,
+    device: str = "auto",
+) -> dict:
+    """Check whether a draft response addresses detected root blockers."""
+    return get_engine(
+        checkpoint_path=checkpoint_path,
+        device=device,
+    ).pulse(original_problem, response)

pre_reasoning-2.5.0/pre_reasoning/checkpoints/__init__.py

@@ -0,0 +1 @@
+"""Bundled weights for optional neural perception."""

pre_reasoning-2.5.0/pre_reasoning/cli.py

@@ -0,0 +1,9 @@
+"""Console entry point for Pre-Reasoning."""
+
+from .pre_reasoning_v2_5 import main
+
+__all__ = ["main"]
+
+
+if __name__ == "__main__":
+    main()