quantum-reasoning-skill 1.0.0__py3-none-any.whl

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.
@@ -0,0 +1 @@
1
+
@@ -0,0 +1,151 @@
1
+ Metadata-Version: 2.5
2
+ Name: quantum-reasoning-skill
3
+ Version: 1.0.0
4
+ Summary: Quantum-inspired reasoning skill for exploring multiple solution paths
5
+ Project-URL: Homepage, https://github.com/Furox-Art/quantum-reasoning-skill
6
+ Project-URL: Repository, https://github.com/Furox-Art/quantum-reasoning-skill
7
+ Project-URL: Issues, https://github.com/Furox-Art/quantum-reasoning-skill/issues
8
+ Author: Furox-Art
9
+ License-Expression: MIT
10
+ License-File: LICENSE
11
+ Keywords: ai-agents,multi-branch,quantum-inspired,reasoning
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Programming Language :: Python :: 3
16
+ Requires-Python: >=3.10
17
+ Description-Content-Type: text/markdown
18
+
19
+ # Quantum Reasoning Skill
20
+ > **Superseded:** this standalone skill was merged into **Axiomize 2.0** and now lives as
21
+ > `axiomize.reasoning` in **[Furox-Art/axiomize-quantum-skills-2.0](https://github.com/Furox-Art/axiomize-quantum-skills-2.0)**,
22
+ > where it ships next to the scientific modeling engine as `skills/quantum-reasoning/`.
23
+ > New work, issues, and contributions should go to the Axiomize repo. This repository is kept
24
+ > for historical reference and will be archived.
25
+
26
+ A **model-agnostic reasoning skill** that keeps multiple genuinely different possibilities alive, verifies and compares them, suppresses weak paths, revives useful alternatives when evidence changes, and selects the best-supported result only at the end.
27
+
28
+ > This is quantum-inspired classical reasoning, not quantum computation.
29
+
30
+ ## Main artifact
31
+
32
+ The project is centered on [`SKILL.md`](./SKILL.md). The skill changes the model's reasoning procedure without retraining the model.
33
+
34
+ ```text
35
+ problem
36
+ -> open diverse possibilities
37
+ -> verify independently
38
+ -> compare contradictions and shared assumptions
39
+ -> score / classify branches
40
+ -> allocate compute dynamically
41
+ -> suspend or reject weak branches
42
+ -> revive branches when evidence changes
43
+ -> verify collapse criteria
44
+ -> select the best-supported answer
45
+ ```
46
+
47
+ ## Design goals
48
+
49
+ - Reduce early lock-in to the first plausible answer.
50
+ - Maintain genuinely independent hypotheses or solution strategies.
51
+ - Prefer falsification and tool-based verification over self-confidence.
52
+ - Expand search when uncertainty is high and concentrate compute when evidence is strong.
53
+ - Detect correlated branches so repeated assumptions are not counted as independent evidence.
54
+ - Keep high-information alternatives recoverable instead of deleting them too early.
55
+ - Work across hosts that can preserve the skill instruction contract.
56
+ - Make reasoning-control decisions measurable without exposing private chain-of-thought.
57
+
58
+ ## Repository contents
59
+
60
+ - [`SKILL.md`](./SKILL.md) — model-facing protocol
61
+ - [`reference/branch_controller.py`](./reference/branch_controller.py) — deterministic reference scoring, state transition, revival, uncertainty and collapse logic
62
+ - [`docs/MEASUREMENT.md`](./docs/MEASUREMENT.md) — explicit formulas, thresholds and calibration requirements
63
+ - [`docs/COMPATIBILITY.md`](./docs/COMPATIBILITY.md) — capability-based host compatibility contract
64
+ - [`examples/usage.md`](./examples/usage.md) — task examples
65
+ - [`examples/host-integration.md`](./examples/host-integration.md) — generic host integration patterns
66
+ - [`benchmark/cases.jsonl`](./benchmark/cases.jsonl) — deterministic seed cases
67
+ - [`benchmark/evaluate.py`](./benchmark/evaluate.py) — baseline-vs-skill evaluator
68
+ - [`benchmark/validate_submission.py`](./benchmark/validate_submission.py) — reproducible community-result bundle validator
69
+ - [`benchmark/schemas/`](./benchmark/schemas/) — JSON Schema contracts for cases, metadata, result rows and comparison output
70
+ - [`benchmark/README.md`](./benchmark/README.md) — reproducible benchmark protocol
71
+ - [`CONTRIBUTING.md`](./CONTRIBUTING.md) — contribution and independent benchmark-submission policy
72
+ - [`SECURITY.md`](./SECURITY.md) — vulnerability-reporting policy
73
+ - [`CITATION.cff`](./CITATION.cff) — citation metadata
74
+ - [`tests/`](./tests/) — behavioral and validation tests
75
+ - GitHub Actions validation on pushes and pull requests
76
+ - CI-gated automated tag and GitHub Release publishing
77
+
78
+ ## Core capabilities
79
+
80
+ - Adaptive multi-branch reasoning
81
+ - Semantic diversity requirements
82
+ - Active / dormant / rejected branch states
83
+ - Independent verification rules
84
+ - Contradiction and shared-assumption checks
85
+ - Correlation penalty for duplicated/shared-assumption branches
86
+ - Interference-like cross-branch comparison
87
+ - Dynamic compute allocation from uncertainty
88
+ - Measurable branch revival rules
89
+ - Explicit stopping / collapse criteria
90
+ - Baseline-vs-skill benchmark telemetry
91
+ - Final requirement and contradiction check
92
+
93
+ ## Usage
94
+
95
+ Install or provide `SKILL.md` to a compatible agent/skill system, then invoke it for difficult reasoning tasks. No Python package or model fine-tuning is required to use the skill itself.
96
+
97
+ See [`docs/COMPATIBILITY.md`](./docs/COMPATIBILITY.md) before integrating a new host and [`examples/host-integration.md`](./examples/host-integration.md) for generic installation patterns.
98
+
99
+ The Python reference implementation is optional. It exists to make the qualitative policy auditable and testable:
100
+
101
+ ```python
102
+ from reference.branch_controller import Branch, BranchMetrics, collapse_decision
103
+ ```
104
+
105
+ ## Benchmarking
106
+
107
+ The repository provides the **protocol, cases, schemas, evaluator and submission validator** needed to test the skill. Real model evaluations are intentionally **community-run**: users test the models/providers they have access to and may submit reproducible results back to the project.
108
+
109
+ The project does not require the maintainer to run every commercial or local model, and it does not treat the absence of maintainer-run model tests as a missing implementation feature.
110
+
111
+ A valid comparison uses the **same model, model version, task set, tool access, temperature/sampling settings and token-budget policy** with and without `SKILL.md`.
112
+
113
+ ```bash
114
+ python benchmark/evaluate.py \
115
+ --cases benchmark/cases.jsonl \
116
+ --baseline path/to/baseline-results.jsonl \
117
+ --skill path/to/skill-results.jsonl \
118
+ --output comparison.json
119
+ ```
120
+
121
+ Community PR bundles are machine-checked. They must contain their own `cases.jsonl`, raw baseline and skill JSONL files, metadata, the generated comparison output and a short README. CI recomputes the comparison and rejects tampered or incomplete bundles.
122
+
123
+ ```bash
124
+ python benchmark/validate_submission.py \
125
+ --root benchmark/results/community \
126
+ --allow-empty
127
+ ```
128
+
129
+ Third-party results remain measurements from their submitters, not automatic project endorsements or universal performance claims. A single positive run is not enough to claim general improvement.
130
+
131
+ Users can submit results through the **Benchmark result** issue template or as a reproducible benchmark-result pull request. See [`benchmark/README.md`](./benchmark/README.md) and [`CONTRIBUTING.md`](./CONTRIBUTING.md).
132
+
133
+ ## Validation
134
+
135
+ Run the repository checks locally with:
136
+
137
+ ```bash
138
+ python -m unittest discover -s tests -v
139
+ python benchmark/evaluate.py --help
140
+ python benchmark/validate_submission.py --root benchmark/results/community --allow-empty
141
+ ```
142
+
143
+ CI validates the skill contract, local links, Python syntax, benchmark seed data, JSON Schema files, community benchmark bundles and behavioral tests. Third-party GitHub Actions are pinned to exact commit SHAs.
144
+
145
+ ## Releases
146
+
147
+ Release publishing is repository-native and CI-gated. Update `CHANGELOG.md`, then change the root `VERSION` file to a semantic version. A release is considered only after the `validate-skill` workflow succeeds on `main`; the `publish-release` workflow then creates the corresponding `v<version>` tag and GitHub Release if it does not already exist.
148
+
149
+ ## Status
150
+
151
+ **v0.3.1 — hardened measurable prototype.** The branch-control mechanism, benchmark infrastructure, host compatibility contract, community-result validation, repository security/citation metadata and CI-gated release controls are implemented. Real-model evaluation is intentionally delegated to independent users and contributors, and the project makes no universal performance claim without reproducible external evidence.
@@ -0,0 +1,5 @@
1
+ quantum_reasoning_skill/__init__.py,sha256=a99mtb8qROZYvqLuhmlasVCgbmAL9nzVzOJFrVSWLGE,3
2
+ quantum_reasoning_skill-1.0.0.dist-info/METADATA,sha256=svWXG399Nid6lzsVHIeb4EygOLN7uJUmn4A918SrX7g,8235
3
+ quantum_reasoning_skill-1.0.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
4
+ quantum_reasoning_skill-1.0.0.dist-info/licenses/LICENSE,sha256=gDVDTfjTCLgU8EMSsLmyV2wZpOvMJOgWksi1FEmfZ_w,1083
5
+ quantum_reasoning_skill-1.0.0.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.32.4
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Furox
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.