pre-reasoning 2.5.1__tar.gz → 2.5.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/LICENSE +21 -21
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/MANIFEST.in +5 -5
- {pre_reasoning-2.5.1/pre_reasoning.egg-info → pre_reasoning-2.5.2}/PKG-INFO +127 -127
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/README.md +102 -102
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning/__init__.py +56 -56
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning/checkpoints/__init__.py +1 -1
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning/cli.py +9 -9
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning/heuristic.py +764 -744
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning/inference.py +1326 -1326
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning/pre_reasoning_v2_5.py +519 -519
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2/pre_reasoning.egg-info}/PKG-INFO +127 -127
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pyproject.toml +51 -51
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/setup.cfg +4 -4
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/tests/test_engine.py +51 -51
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning/checkpoints/pre-reasoning-3m-v2.5.safetensors +0 -0
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning.egg-info/SOURCES.txt +0 -0
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning.egg-info/dependency_links.txt +0 -0
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning.egg-info/entry_points.txt +0 -0
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning.egg-info/requires.txt +0 -0
- {pre_reasoning-2.5.1 → pre_reasoning-2.5.2}/pre_reasoning.egg-info/top_level.txt +0 -0
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 Mia Labs
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Mia Labs
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
include pre_reasoning/checkpoints/*.safetensors
|
|
2
|
-
exclude checkpoints/*.pt
|
|
3
|
-
prune __pycache__
|
|
4
|
-
global-exclude *.py[cod]
|
|
5
|
-
global-exclude .DS_Store
|
|
1
|
+
include pre_reasoning/checkpoints/*.safetensors
|
|
2
|
+
exclude checkpoints/*.pt
|
|
3
|
+
prune __pycache__
|
|
4
|
+
global-exclude *.py[cod]
|
|
5
|
+
global-exclude .DS_Store
|
|
@@ -1,127 +1,127 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: pre-reasoning
|
|
3
|
-
Version: 2.5.
|
|
4
|
-
Summary: 3M-parameter neural pre-reasoning engine for grounding LLMs before they answer.
|
|
5
|
-
Author: Luis Lozano, Dr. Shannon (Mia Labs AI co-researcher), Mia Labs
|
|
6
|
-
License-Expression: MIT
|
|
7
|
-
Project-URL: Repository, https://github.com/luislozanogmia/pre-reasoning
|
|
8
|
-
Keywords: reasoning,llm,graph,deterministic
|
|
9
|
-
Classifier: Development Status :: 4 - Beta
|
|
10
|
-
Classifier: Intended Audience :: Developers
|
|
11
|
-
Classifier: Programming Language :: Python :: 3
|
|
12
|
-
Classifier: Programming Language :: Python :: 3.9
|
|
13
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
14
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
15
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
16
|
-
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
17
|
-
Requires-Python: >=3.9
|
|
18
|
-
Description-Content-Type: text/markdown
|
|
19
|
-
License-File: LICENSE
|
|
20
|
-
Requires-Dist: torch>=2.0.0
|
|
21
|
-
Requires-Dist: safetensors>=0.4.0
|
|
22
|
-
Provides-Extra: dev
|
|
23
|
-
Requires-Dist: pytest>=8.0.0; extra == "dev"
|
|
24
|
-
Dynamic: license-file
|
|
25
|
-
|
|
26
|
-
# Pre-Reasoning
|
|
27
|
-
|
|
28
|
-
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.
|
|
29
|
-
|
|
30
|
-
The engine ships with bundled safetensors weights and torch -- install and run, no downloads needed.
|
|
31
|
-
|
|
32
|
-
## What It Does
|
|
33
|
-
|
|
34
|
-
Given natural-language problem text, the engine returns:
|
|
35
|
-
|
|
36
|
-
- ROOT BLOCKERS: what must be resolved first
|
|
37
|
-
- UNLOCK SEQUENCE: a dependency-aware resolution order
|
|
38
|
-
- PARALLEL WORK: independent items that can proceed now
|
|
39
|
-
- CYCLES: circular dependencies that cannot be solved sequentially
|
|
40
|
-
- CONFLICTS: competing positions or incompatible entities
|
|
41
|
-
- REQUIREMENTS: numeric or threshold requirements
|
|
42
|
-
|
|
43
|
-
## Install
|
|
44
|
-
|
|
45
|
-
```bash
|
|
46
|
-
pip install pre-reasoning
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
For local development from this repo:
|
|
50
|
-
|
|
51
|
-
```bash
|
|
52
|
-
pip install -e .
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
## Python Usage
|
|
56
|
-
|
|
57
|
-
```python
|
|
58
|
-
from pre_reasoning import analyze, pulse
|
|
59
|
-
|
|
60
|
-
result = analyze("Frontend depends on API. API depends on Auth.")
|
|
61
|
-
print(result["trace"])
|
|
62
|
-
|
|
63
|
-
check = pulse(
|
|
64
|
-
"Frontend depends on API. API depends on Auth.",
|
|
65
|
-
"Fix Auth first, then verify the API before frontend work."
|
|
66
|
-
)
|
|
67
|
-
print(check["status"])
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
## CLI Usage
|
|
71
|
-
|
|
72
|
-
```bash
|
|
73
|
-
pre-reasoning "A depends on B. B depends on C."
|
|
74
|
-
pre-reasoning --json "CTO conflicts with senior dev."
|
|
75
|
-
pre-reasoning --info
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
To use a different weights file, set `PRE_REASONING_CHECKPOINT=/path/to/weights.safetensors` or pass `--checkpoint`.
|
|
79
|
-
|
|
80
|
-
## Results
|
|
81
|
-
|
|
82
|
-
Early comparison table, illustrative, n=5 architectural decision problems:
|
|
83
|
-
|
|
84
|
-
| Comparison | Illustrative result, n=5 |
|
|
85
|
-
|---|---:|
|
|
86
|
-
| 9B + trace vs 32B baseline | 3W 2T 0L |
|
|
87
|
-
| 9B + trace vs 120B baseline | 4W 1T 0L |
|
|
88
|
-
| 120B + trace vs 120B baseline | 3W 2T 0L |
|
|
89
|
-
|
|
90
|
-
These are product-research notes, not benchmark claims.
|
|
91
|
-
|
|
92
|
-
## Architecture
|
|
93
|
-
|
|
94
|
-
```text
|
|
95
|
-
User text
|
|
96
|
-
-> V3 neural perception (3M params, safetensors)
|
|
97
|
-
-> neural findings converted to structural blocks
|
|
98
|
-
-> V2 heuristic graph analysis
|
|
99
|
-
-> structural trace
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
## File Map
|
|
103
|
-
|
|
104
|
-
| Path | Purpose |
|
|
105
|
-
|---|---|
|
|
106
|
-
| `pre_reasoning/` | Installable Python package and CLI entry point |
|
|
107
|
-
| `pre_reasoning/inference.py` | 3M-parameter V3 neural perception layer |
|
|
108
|
-
| `pre_reasoning/heuristic.py` | Deterministic graph-reasoning core (fallback) |
|
|
109
|
-
| `pre_reasoning/pre_reasoning_v2_5.py` | v2.5 orchestrator: V3 neural + heuristic |
|
|
110
|
-
| `pre_reasoning/checkpoints/pre-reasoning-3m-v2.5.safetensors` | Bundled V3 weights (11MB) |
|
|
111
|
-
| `examples/` | Runnable usage examples |
|
|
112
|
-
| `tests/` | Pytest suite |
|
|
113
|
-
| `skill/SKILL.md` | Agent skill descriptor for model adoption |
|
|
114
|
-
| `CLAUDE.md` | Optional Claude Code hooks configuration |
|
|
115
|
-
| `WHY_TRACES_WORK.md` | Literature connection, 9 cited papers |
|
|
116
|
-
|
|
117
|
-
## Weights Policy
|
|
118
|
-
|
|
119
|
-
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.
|
|
120
|
-
|
|
121
|
-
## License
|
|
122
|
-
|
|
123
|
-
MIT License. See `LICENSE`.
|
|
124
|
-
|
|
125
|
-
## Authors
|
|
126
|
-
|
|
127
|
-
Luis Lozano and Dr. Shannon, Mia Labs' AI co-researcher, 2026.
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: pre-reasoning
|
|
3
|
+
Version: 2.5.2
|
|
4
|
+
Summary: 3M-parameter neural pre-reasoning engine for grounding LLMs before they answer.
|
|
5
|
+
Author: Luis Lozano, Dr. Shannon (Mia Labs AI co-researcher), Mia Labs
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Repository, https://github.com/luislozanogmia/pre-reasoning
|
|
8
|
+
Keywords: reasoning,llm,graph,deterministic
|
|
9
|
+
Classifier: Development Status :: 4 - Beta
|
|
10
|
+
Classifier: Intended Audience :: Developers
|
|
11
|
+
Classifier: Programming Language :: Python :: 3
|
|
12
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
13
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
16
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
17
|
+
Requires-Python: >=3.9
|
|
18
|
+
Description-Content-Type: text/markdown
|
|
19
|
+
License-File: LICENSE
|
|
20
|
+
Requires-Dist: torch>=2.0.0
|
|
21
|
+
Requires-Dist: safetensors>=0.4.0
|
|
22
|
+
Provides-Extra: dev
|
|
23
|
+
Requires-Dist: pytest>=8.0.0; extra == "dev"
|
|
24
|
+
Dynamic: license-file
|
|
25
|
+
|
|
26
|
+
# Pre-Reasoning
|
|
27
|
+
|
|
28
|
+
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.
|
|
29
|
+
|
|
30
|
+
The engine ships with bundled safetensors weights and torch -- install and run, no downloads needed.
|
|
31
|
+
|
|
32
|
+
## What It Does
|
|
33
|
+
|
|
34
|
+
Given natural-language problem text, the engine returns:
|
|
35
|
+
|
|
36
|
+
- ROOT BLOCKERS: what must be resolved first
|
|
37
|
+
- UNLOCK SEQUENCE: a dependency-aware resolution order
|
|
38
|
+
- PARALLEL WORK: independent items that can proceed now
|
|
39
|
+
- CYCLES: circular dependencies that cannot be solved sequentially
|
|
40
|
+
- CONFLICTS: competing positions or incompatible entities
|
|
41
|
+
- REQUIREMENTS: numeric or threshold requirements
|
|
42
|
+
|
|
43
|
+
## Install
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
pip install pre-reasoning
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
For local development from this repo:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
pip install -e .
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## Python Usage
|
|
56
|
+
|
|
57
|
+
```python
|
|
58
|
+
from pre_reasoning import analyze, pulse
|
|
59
|
+
|
|
60
|
+
result = analyze("Frontend depends on API. API depends on Auth.")
|
|
61
|
+
print(result["trace"])
|
|
62
|
+
|
|
63
|
+
check = pulse(
|
|
64
|
+
"Frontend depends on API. API depends on Auth.",
|
|
65
|
+
"Fix Auth first, then verify the API before frontend work."
|
|
66
|
+
)
|
|
67
|
+
print(check["status"])
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## CLI Usage
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
pre-reasoning "A depends on B. B depends on C."
|
|
74
|
+
pre-reasoning --json "CTO conflicts with senior dev."
|
|
75
|
+
pre-reasoning --info
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
To use a different weights file, set `PRE_REASONING_CHECKPOINT=/path/to/weights.safetensors` or pass `--checkpoint`.
|
|
79
|
+
|
|
80
|
+
## Results
|
|
81
|
+
|
|
82
|
+
Early comparison table, illustrative, n=5 architectural decision problems:
|
|
83
|
+
|
|
84
|
+
| Comparison | Illustrative result, n=5 |
|
|
85
|
+
|---|---:|
|
|
86
|
+
| 9B + trace vs 32B baseline | 3W 2T 0L |
|
|
87
|
+
| 9B + trace vs 120B baseline | 4W 1T 0L |
|
|
88
|
+
| 120B + trace vs 120B baseline | 3W 2T 0L |
|
|
89
|
+
|
|
90
|
+
These are product-research notes, not benchmark claims.
|
|
91
|
+
|
|
92
|
+
## Architecture
|
|
93
|
+
|
|
94
|
+
```text
|
|
95
|
+
User text
|
|
96
|
+
-> V3 neural perception (3M params, safetensors)
|
|
97
|
+
-> neural findings converted to structural blocks
|
|
98
|
+
-> V2 heuristic graph analysis
|
|
99
|
+
-> structural trace
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## File Map
|
|
103
|
+
|
|
104
|
+
| Path | Purpose |
|
|
105
|
+
|---|---|
|
|
106
|
+
| `pre_reasoning/` | Installable Python package and CLI entry point |
|
|
107
|
+
| `pre_reasoning/inference.py` | 3M-parameter V3 neural perception layer |
|
|
108
|
+
| `pre_reasoning/heuristic.py` | Deterministic graph-reasoning core (fallback) |
|
|
109
|
+
| `pre_reasoning/pre_reasoning_v2_5.py` | v2.5 orchestrator: V3 neural + heuristic |
|
|
110
|
+
| `pre_reasoning/checkpoints/pre-reasoning-3m-v2.5.safetensors` | Bundled V3 weights (11MB) |
|
|
111
|
+
| `examples/` | Runnable usage examples |
|
|
112
|
+
| `tests/` | Pytest suite |
|
|
113
|
+
| `skill/SKILL.md` | Agent skill descriptor for model adoption |
|
|
114
|
+
| `CLAUDE.md` | Optional Claude Code hooks configuration |
|
|
115
|
+
| `WHY_TRACES_WORK.md` | Literature connection, 9 cited papers |
|
|
116
|
+
|
|
117
|
+
## Weights Policy
|
|
118
|
+
|
|
119
|
+
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.
|
|
120
|
+
|
|
121
|
+
## License
|
|
122
|
+
|
|
123
|
+
MIT License. See `LICENSE`.
|
|
124
|
+
|
|
125
|
+
## Authors
|
|
126
|
+
|
|
127
|
+
Luis Lozano and Dr. Shannon, Mia Labs' AI co-researcher, 2026.
|
|
@@ -1,102 +1,102 @@
|
|
|
1
|
-
# Pre-Reasoning
|
|
2
|
-
|
|
3
|
-
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.
|
|
4
|
-
|
|
5
|
-
The engine ships with bundled safetensors weights and torch -- install and run, no downloads needed.
|
|
6
|
-
|
|
7
|
-
## What It Does
|
|
8
|
-
|
|
9
|
-
Given natural-language problem text, the engine returns:
|
|
10
|
-
|
|
11
|
-
- ROOT BLOCKERS: what must be resolved first
|
|
12
|
-
- UNLOCK SEQUENCE: a dependency-aware resolution order
|
|
13
|
-
- PARALLEL WORK: independent items that can proceed now
|
|
14
|
-
- CYCLES: circular dependencies that cannot be solved sequentially
|
|
15
|
-
- CONFLICTS: competing positions or incompatible entities
|
|
16
|
-
- REQUIREMENTS: numeric or threshold requirements
|
|
17
|
-
|
|
18
|
-
## Install
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
pip install pre-reasoning
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
For local development from this repo:
|
|
25
|
-
|
|
26
|
-
```bash
|
|
27
|
-
pip install -e .
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
## Python Usage
|
|
31
|
-
|
|
32
|
-
```python
|
|
33
|
-
from pre_reasoning import analyze, pulse
|
|
34
|
-
|
|
35
|
-
result = analyze("Frontend depends on API. API depends on Auth.")
|
|
36
|
-
print(result["trace"])
|
|
37
|
-
|
|
38
|
-
check = pulse(
|
|
39
|
-
"Frontend depends on API. API depends on Auth.",
|
|
40
|
-
"Fix Auth first, then verify the API before frontend work."
|
|
41
|
-
)
|
|
42
|
-
print(check["status"])
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
## CLI Usage
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
|
-
pre-reasoning "A depends on B. B depends on C."
|
|
49
|
-
pre-reasoning --json "CTO conflicts with senior dev."
|
|
50
|
-
pre-reasoning --info
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
To use a different weights file, set `PRE_REASONING_CHECKPOINT=/path/to/weights.safetensors` or pass `--checkpoint`.
|
|
54
|
-
|
|
55
|
-
## Results
|
|
56
|
-
|
|
57
|
-
Early comparison table, illustrative, n=5 architectural decision problems:
|
|
58
|
-
|
|
59
|
-
| Comparison | Illustrative result, n=5 |
|
|
60
|
-
|---|---:|
|
|
61
|
-
| 9B + trace vs 32B baseline | 3W 2T 0L |
|
|
62
|
-
| 9B + trace vs 120B baseline | 4W 1T 0L |
|
|
63
|
-
| 120B + trace vs 120B baseline | 3W 2T 0L |
|
|
64
|
-
|
|
65
|
-
These are product-research notes, not benchmark claims.
|
|
66
|
-
|
|
67
|
-
## Architecture
|
|
68
|
-
|
|
69
|
-
```text
|
|
70
|
-
User text
|
|
71
|
-
-> V3 neural perception (3M params, safetensors)
|
|
72
|
-
-> neural findings converted to structural blocks
|
|
73
|
-
-> V2 heuristic graph analysis
|
|
74
|
-
-> structural trace
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
## File Map
|
|
78
|
-
|
|
79
|
-
| Path | Purpose |
|
|
80
|
-
|---|---|
|
|
81
|
-
| `pre_reasoning/` | Installable Python package and CLI entry point |
|
|
82
|
-
| `pre_reasoning/inference.py` | 3M-parameter V3 neural perception layer |
|
|
83
|
-
| `pre_reasoning/heuristic.py` | Deterministic graph-reasoning core (fallback) |
|
|
84
|
-
| `pre_reasoning/pre_reasoning_v2_5.py` | v2.5 orchestrator: V3 neural + heuristic |
|
|
85
|
-
| `pre_reasoning/checkpoints/pre-reasoning-3m-v2.5.safetensors` | Bundled V3 weights (11MB) |
|
|
86
|
-
| `examples/` | Runnable usage examples |
|
|
87
|
-
| `tests/` | Pytest suite |
|
|
88
|
-
| `skill/SKILL.md` | Agent skill descriptor for model adoption |
|
|
89
|
-
| `CLAUDE.md` | Optional Claude Code hooks configuration |
|
|
90
|
-
| `WHY_TRACES_WORK.md` | Literature connection, 9 cited papers |
|
|
91
|
-
|
|
92
|
-
## Weights Policy
|
|
93
|
-
|
|
94
|
-
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.
|
|
95
|
-
|
|
96
|
-
## License
|
|
97
|
-
|
|
98
|
-
MIT License. See `LICENSE`.
|
|
99
|
-
|
|
100
|
-
## Authors
|
|
101
|
-
|
|
102
|
-
Luis Lozano and Dr. Shannon, Mia Labs' AI co-researcher, 2026.
|
|
1
|
+
# Pre-Reasoning
|
|
2
|
+
|
|
3
|
+
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.
|
|
4
|
+
|
|
5
|
+
The engine ships with bundled safetensors weights and torch -- install and run, no downloads needed.
|
|
6
|
+
|
|
7
|
+
## What It Does
|
|
8
|
+
|
|
9
|
+
Given natural-language problem text, the engine returns:
|
|
10
|
+
|
|
11
|
+
- ROOT BLOCKERS: what must be resolved first
|
|
12
|
+
- UNLOCK SEQUENCE: a dependency-aware resolution order
|
|
13
|
+
- PARALLEL WORK: independent items that can proceed now
|
|
14
|
+
- CYCLES: circular dependencies that cannot be solved sequentially
|
|
15
|
+
- CONFLICTS: competing positions or incompatible entities
|
|
16
|
+
- REQUIREMENTS: numeric or threshold requirements
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
pip install pre-reasoning
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
For local development from this repo:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
pip install -e .
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Python Usage
|
|
31
|
+
|
|
32
|
+
```python
|
|
33
|
+
from pre_reasoning import analyze, pulse
|
|
34
|
+
|
|
35
|
+
result = analyze("Frontend depends on API. API depends on Auth.")
|
|
36
|
+
print(result["trace"])
|
|
37
|
+
|
|
38
|
+
check = pulse(
|
|
39
|
+
"Frontend depends on API. API depends on Auth.",
|
|
40
|
+
"Fix Auth first, then verify the API before frontend work."
|
|
41
|
+
)
|
|
42
|
+
print(check["status"])
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## CLI Usage
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
pre-reasoning "A depends on B. B depends on C."
|
|
49
|
+
pre-reasoning --json "CTO conflicts with senior dev."
|
|
50
|
+
pre-reasoning --info
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
To use a different weights file, set `PRE_REASONING_CHECKPOINT=/path/to/weights.safetensors` or pass `--checkpoint`.
|
|
54
|
+
|
|
55
|
+
## Results
|
|
56
|
+
|
|
57
|
+
Early comparison table, illustrative, n=5 architectural decision problems:
|
|
58
|
+
|
|
59
|
+
| Comparison | Illustrative result, n=5 |
|
|
60
|
+
|---|---:|
|
|
61
|
+
| 9B + trace vs 32B baseline | 3W 2T 0L |
|
|
62
|
+
| 9B + trace vs 120B baseline | 4W 1T 0L |
|
|
63
|
+
| 120B + trace vs 120B baseline | 3W 2T 0L |
|
|
64
|
+
|
|
65
|
+
These are product-research notes, not benchmark claims.
|
|
66
|
+
|
|
67
|
+
## Architecture
|
|
68
|
+
|
|
69
|
+
```text
|
|
70
|
+
User text
|
|
71
|
+
-> V3 neural perception (3M params, safetensors)
|
|
72
|
+
-> neural findings converted to structural blocks
|
|
73
|
+
-> V2 heuristic graph analysis
|
|
74
|
+
-> structural trace
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## File Map
|
|
78
|
+
|
|
79
|
+
| Path | Purpose |
|
|
80
|
+
|---|---|
|
|
81
|
+
| `pre_reasoning/` | Installable Python package and CLI entry point |
|
|
82
|
+
| `pre_reasoning/inference.py` | 3M-parameter V3 neural perception layer |
|
|
83
|
+
| `pre_reasoning/heuristic.py` | Deterministic graph-reasoning core (fallback) |
|
|
84
|
+
| `pre_reasoning/pre_reasoning_v2_5.py` | v2.5 orchestrator: V3 neural + heuristic |
|
|
85
|
+
| `pre_reasoning/checkpoints/pre-reasoning-3m-v2.5.safetensors` | Bundled V3 weights (11MB) |
|
|
86
|
+
| `examples/` | Runnable usage examples |
|
|
87
|
+
| `tests/` | Pytest suite |
|
|
88
|
+
| `skill/SKILL.md` | Agent skill descriptor for model adoption |
|
|
89
|
+
| `CLAUDE.md` | Optional Claude Code hooks configuration |
|
|
90
|
+
| `WHY_TRACES_WORK.md` | Literature connection, 9 cited papers |
|
|
91
|
+
|
|
92
|
+
## Weights Policy
|
|
93
|
+
|
|
94
|
+
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.
|
|
95
|
+
|
|
96
|
+
## License
|
|
97
|
+
|
|
98
|
+
MIT License. See `LICENSE`.
|
|
99
|
+
|
|
100
|
+
## Authors
|
|
101
|
+
|
|
102
|
+
Luis Lozano and Dr. Shannon, Mia Labs' AI co-researcher, 2026.
|
|
@@ -1,56 +1,56 @@
|
|
|
1
|
-
"""Public package API for Pre-Reasoning."""
|
|
2
|
-
|
|
3
|
-
from __future__ import annotations
|
|
4
|
-
|
|
5
|
-
from typing import Optional
|
|
6
|
-
|
|
7
|
-
from .pre_reasoning_v2_5 import ReasoningEngineV25
|
|
8
|
-
|
|
9
|
-
ReasoningEngine = ReasoningEngineV25
|
|
10
|
-
|
|
11
|
-
__all__ = [
|
|
12
|
-
"ReasoningEngineV25",
|
|
13
|
-
"ReasoningEngine",
|
|
14
|
-
"analyze",
|
|
15
|
-
"pulse",
|
|
16
|
-
"get_engine",
|
|
17
|
-
]
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
def get_engine(
|
|
21
|
-
*,
|
|
22
|
-
checkpoint_path: Optional[str] = None,
|
|
23
|
-
device: str = "auto",
|
|
24
|
-
) -> ReasoningEngineV25:
|
|
25
|
-
"""Create a reasoning engine (V3 neural perception + V2 heuristic graph analysis)."""
|
|
26
|
-
return ReasoningEngineV25(
|
|
27
|
-
checkpoint_path=checkpoint_path,
|
|
28
|
-
device=device,
|
|
29
|
-
)
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
def analyze(
|
|
33
|
-
text: str,
|
|
34
|
-
*,
|
|
35
|
-
checkpoint_path: Optional[str] = None,
|
|
36
|
-
device: str = "auto",
|
|
37
|
-
) -> dict:
|
|
38
|
-
"""Analyze problem text and return a structural trace result."""
|
|
39
|
-
return get_engine(
|
|
40
|
-
checkpoint_path=checkpoint_path,
|
|
41
|
-
device=device,
|
|
42
|
-
).analyze(text)
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
def pulse(
|
|
46
|
-
original_problem: str,
|
|
47
|
-
response: str,
|
|
48
|
-
*,
|
|
49
|
-
checkpoint_path: Optional[str] = None,
|
|
50
|
-
device: str = "auto",
|
|
51
|
-
) -> dict:
|
|
52
|
-
"""Check whether a draft response addresses detected root blockers."""
|
|
53
|
-
return get_engine(
|
|
54
|
-
checkpoint_path=checkpoint_path,
|
|
55
|
-
device=device,
|
|
56
|
-
).pulse(original_problem, response)
|
|
1
|
+
"""Public package API for Pre-Reasoning."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
from typing import Optional
|
|
6
|
+
|
|
7
|
+
from .pre_reasoning_v2_5 import ReasoningEngineV25
|
|
8
|
+
|
|
9
|
+
ReasoningEngine = ReasoningEngineV25
|
|
10
|
+
|
|
11
|
+
__all__ = [
|
|
12
|
+
"ReasoningEngineV25",
|
|
13
|
+
"ReasoningEngine",
|
|
14
|
+
"analyze",
|
|
15
|
+
"pulse",
|
|
16
|
+
"get_engine",
|
|
17
|
+
]
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
def get_engine(
|
|
21
|
+
*,
|
|
22
|
+
checkpoint_path: Optional[str] = None,
|
|
23
|
+
device: str = "auto",
|
|
24
|
+
) -> ReasoningEngineV25:
|
|
25
|
+
"""Create a reasoning engine (V3 neural perception + V2 heuristic graph analysis)."""
|
|
26
|
+
return ReasoningEngineV25(
|
|
27
|
+
checkpoint_path=checkpoint_path,
|
|
28
|
+
device=device,
|
|
29
|
+
)
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def analyze(
|
|
33
|
+
text: str,
|
|
34
|
+
*,
|
|
35
|
+
checkpoint_path: Optional[str] = None,
|
|
36
|
+
device: str = "auto",
|
|
37
|
+
) -> dict:
|
|
38
|
+
"""Analyze problem text and return a structural trace result."""
|
|
39
|
+
return get_engine(
|
|
40
|
+
checkpoint_path=checkpoint_path,
|
|
41
|
+
device=device,
|
|
42
|
+
).analyze(text)
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
def pulse(
|
|
46
|
+
original_problem: str,
|
|
47
|
+
response: str,
|
|
48
|
+
*,
|
|
49
|
+
checkpoint_path: Optional[str] = None,
|
|
50
|
+
device: str = "auto",
|
|
51
|
+
) -> dict:
|
|
52
|
+
"""Check whether a draft response addresses detected root blockers."""
|
|
53
|
+
return get_engine(
|
|
54
|
+
checkpoint_path=checkpoint_path,
|
|
55
|
+
device=device,
|
|
56
|
+
).pulse(original_problem, response)
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"""Bundled weights for optional neural perception."""
|
|
1
|
+
"""Bundled weights for optional neural perception."""
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
"""Console entry point for Pre-Reasoning."""
|
|
2
|
-
|
|
3
|
-
from .pre_reasoning_v2_5 import main
|
|
4
|
-
|
|
5
|
-
__all__ = ["main"]
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
if __name__ == "__main__":
|
|
9
|
-
main()
|
|
1
|
+
"""Console entry point for Pre-Reasoning."""
|
|
2
|
+
|
|
3
|
+
from .pre_reasoning_v2_5 import main
|
|
4
|
+
|
|
5
|
+
__all__ = ["main"]
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
if __name__ == "__main__":
|
|
9
|
+
main()
|