flywheel-verify 0.3.0__tar.gz

flywheel_verify-0.3.0/LICENSE

@@ -0,0 +1,110 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 Zain Dana Harper
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+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.

flywheel_verify-0.3.0/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: flywheel-verify
+Version: 0.3.0
+Summary: The one platform: routing, verification, the lane layer, memory/context/catalog, and the closed verified-inference loop.
+Author: Zain
+License: FSL-1.1-MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Flywheel
+
+> One platform: routing, verification, the lane layer, the closed loop, and the
+> projected world. The native desktop surface for accountable AI infrastructure.
+
+Flywheel is the engine and native client for a verified-inference loop: a model
+perceives only through witnessed organs, acts only through a gate it cannot
+talk past, journals everything, and verifies its own work by re-perceiving.
+
+The flagship tools (gather, crucible, index, forum, learn, telos) are lanes
+inside Flywheel, each a provisioned, health-checked organ reachable through one
+surface. Every agent tool call carries a sealed, chain-linked receipt a third
+party re-verifies offline.
+
+**Proof before trust.**
+
+## What is in this repo
+
+This is a monorepo containing both halves of the platform:
+
+- **`harness/`** is the Python engine: the gateway (localhost HTTP API), the
+  agent loop, the receipt discipline, the lane layer, the verified-inference
+  loop, the tool-call receipt system. Zero runtime dependencies (stdlib only).
+- **`desktop/`** is the Flutter native client: 24 views, 50 widgets, zero
+  webview embedding. Talks to the gateway over localhost. Launches a bundled
+  frozen engine by absolute path on a clean machine (no Python, no PATH, no
+  network).
+- **`site/`** is a dev/CI fallback browser shell (not the primary UI).
+
+## Run it now
+
+Start the gateway (the engine keeps the loop, receipts, lanes, and routing):
+
+```
+flywheel app --port 8799
+```
+
+The **native surface is Flywheel Desktop**. From a dev checkout:
+
+```
+cd desktop
+flutter run -d windows --release
+```
+
+The gateway also serves a `/site/index.html` shell as a dev/CI fallback.
+
+## The lane model
+
+Flywheel encompasses the tool family. Each flagship is a lane:
+
+| Lane | Repo | Role |
+| --- | --- | --- |
+| gather | [gather](https://github.com/HarperZ9/gather) | Research intake + provenance receipts |
+| crucible | [crucible](https://github.com/HarperZ9/crucible) | Falsifiable verification (MATCH / DRIFT / UNVERIFIABLE) |
+| index | [index](https://github.com/HarperZ9/index) | Workspace map + symbol graph + context envelopes |
+| forum | [forum](https://github.com/HarperZ9/forum) | Witnessed causal ledger + model-agnostic routing |
+| learn | [learn](https://github.com/HarperZ9/learn) | Accountable learning forge |
+| telos | [telos](https://github.com/HarperZ9/telos) | The reconciliation lane |
+
+Check their health through one surface:
+
+```
+flywheel lanes
+flywheel lanes --probe    # live MCP handshake per lane
+```
+
+## The receipt discipline
+
+Every agent tool invocation carries a sealed receipt binding:
+
+- **what the tool was** (capability class: read / write / exec / external-mcp)
+- **what it was allowed to do** (admission decision from the gate)
+- **what it actually did** (witnessed args + output sha256 digests, never raw content)
+- **whether a stranger can re-walk it** (offline-verifiable, chain-linked)
+
+Receipts compose into a transitive-witness DAG where a drifted action degrades
+exactly its downstream dependents. The five flagships emit organ-bundle entries
+on a shared proof-surface spine so cross-tool receipts compose end-to-end.
+
+## The organizational learning loop
+
+The layer above audit. The receipt discipline records what happened at machine
+resolution. The learning loop feeds forward: it derives lessons from witnessed
+divergences (an allowed action that rolled back, a memory whose source drifted,
+a graded failure), stores them in a durable, hash-chained, append-only memory,
+and surfaces recurring patterns as improvement candidates for human admission.
+A lesson is not a note an operator wrote; it is a claim bound by hash to its
+evidence, re-checkable offline, fail-closed when the evidence is gone. See
+[docs/LESSON-LOOP.md](docs/LESSON-LOOP.md).
+
+## Offline-first
+
+The Flutter desktop GUI launches a bundled engine by absolute path and serves
+its UI menu on localhost only. No external web address is contacted to show the
+GUI. The gateway serves `/api/*` and the UI on `http://127.0.0.1:8799`.
+
+## Install
+
+From source today (zero runtime dependencies, stdlib only):
+
+```
+git clone https://github.com/HarperZ9/flywheel.git
+cd flywheel
+pip install -e .
+python scripts/run_harness_cli.py app --port 8799
+```
+
+`pip install -e .` puts the `flywheel` command on your PATH, so you can also
+start the gateway with `flywheel up`.
+
+The PyPI distribution name is `flywheel-verify` (the bare `flywheel` name is an
+unrelated package); the installed command stays `flywheel`. After it is
+published to PyPI:
+
+```
+pip install flywheel-verify
+flywheel up
+```
+
+## Documentation
+
+- [QUICKSTART.md](QUICKSTART.md): first ten minutes
+- [WALKTHROUGH.md](WALKTHROUGH.md): guided tour
+- [docs/LESSON-LOOP.md](docs/LESSON-LOOP.md): the organizational learning loop (architecture)
+- [docs/GUIDE-LESSON-LOOP.md](docs/GUIDE-LESSON-LOOP.md): the organizational learning loop (full guide and spec)
+- [docs/ASSESSMENT-AGENTIC-SECURITY-2026-08.md](docs/ASSESSMENT-AGENTIC-SECURITY-2026-08.md): Flywheel against the July 2026 agentic security convergence
+- [CREDO.md](CREDO.md): the belief
+
+## License
+
+FSL-1.1-MIT (Functional Source License). See [LICENSE](LICENSE).

flywheel_verify-0.3.0/README.md

@@ -0,0 +1,131 @@
+# Flywheel
+
+> One platform: routing, verification, the lane layer, the closed loop, and the
+> projected world. The native desktop surface for accountable AI infrastructure.
+
+Flywheel is the engine and native client for a verified-inference loop: a model
+perceives only through witnessed organs, acts only through a gate it cannot
+talk past, journals everything, and verifies its own work by re-perceiving.
+
+The flagship tools (gather, crucible, index, forum, learn, telos) are lanes
+inside Flywheel, each a provisioned, health-checked organ reachable through one
+surface. Every agent tool call carries a sealed, chain-linked receipt a third
+party re-verifies offline.
+
+**Proof before trust.**
+
+## What is in this repo
+
+This is a monorepo containing both halves of the platform:
+
+- **`harness/`** is the Python engine: the gateway (localhost HTTP API), the
+  agent loop, the receipt discipline, the lane layer, the verified-inference
+  loop, the tool-call receipt system. Zero runtime dependencies (stdlib only).
+- **`desktop/`** is the Flutter native client: 24 views, 50 widgets, zero
+  webview embedding. Talks to the gateway over localhost. Launches a bundled
+  frozen engine by absolute path on a clean machine (no Python, no PATH, no
+  network).
+- **`site/`** is a dev/CI fallback browser shell (not the primary UI).
+
+## Run it now
+
+Start the gateway (the engine keeps the loop, receipts, lanes, and routing):
+
+```
+flywheel app --port 8799
+```
+
+The **native surface is Flywheel Desktop**. From a dev checkout:
+
+```
+cd desktop
+flutter run -d windows --release
+```
+
+The gateway also serves a `/site/index.html` shell as a dev/CI fallback.
+
+## The lane model
+
+Flywheel encompasses the tool family. Each flagship is a lane:
+
+| Lane | Repo | Role |
+| --- | --- | --- |
+| gather | [gather](https://github.com/HarperZ9/gather) | Research intake + provenance receipts |
+| crucible | [crucible](https://github.com/HarperZ9/crucible) | Falsifiable verification (MATCH / DRIFT / UNVERIFIABLE) |
+| index | [index](https://github.com/HarperZ9/index) | Workspace map + symbol graph + context envelopes |
+| forum | [forum](https://github.com/HarperZ9/forum) | Witnessed causal ledger + model-agnostic routing |
+| learn | [learn](https://github.com/HarperZ9/learn) | Accountable learning forge |
+| telos | [telos](https://github.com/HarperZ9/telos) | The reconciliation lane |
+
+Check their health through one surface:
+
+```
+flywheel lanes
+flywheel lanes --probe    # live MCP handshake per lane
+```
+
+## The receipt discipline
+
+Every agent tool invocation carries a sealed receipt binding:
+
+- **what the tool was** (capability class: read / write / exec / external-mcp)
+- **what it was allowed to do** (admission decision from the gate)
+- **what it actually did** (witnessed args + output sha256 digests, never raw content)
+- **whether a stranger can re-walk it** (offline-verifiable, chain-linked)
+
+Receipts compose into a transitive-witness DAG where a drifted action degrades
+exactly its downstream dependents. The five flagships emit organ-bundle entries
+on a shared proof-surface spine so cross-tool receipts compose end-to-end.
+
+## The organizational learning loop
+
+The layer above audit. The receipt discipline records what happened at machine
+resolution. The learning loop feeds forward: it derives lessons from witnessed
+divergences (an allowed action that rolled back, a memory whose source drifted,
+a graded failure), stores them in a durable, hash-chained, append-only memory,
+and surfaces recurring patterns as improvement candidates for human admission.
+A lesson is not a note an operator wrote; it is a claim bound by hash to its
+evidence, re-checkable offline, fail-closed when the evidence is gone. See
+[docs/LESSON-LOOP.md](docs/LESSON-LOOP.md).
+
+## Offline-first
+
+The Flutter desktop GUI launches a bundled engine by absolute path and serves
+its UI menu on localhost only. No external web address is contacted to show the
+GUI. The gateway serves `/api/*` and the UI on `http://127.0.0.1:8799`.
+
+## Install
+
+From source today (zero runtime dependencies, stdlib only):
+
+```
+git clone https://github.com/HarperZ9/flywheel.git
+cd flywheel
+pip install -e .
+python scripts/run_harness_cli.py app --port 8799
+```
+
+`pip install -e .` puts the `flywheel` command on your PATH, so you can also
+start the gateway with `flywheel up`.
+
+The PyPI distribution name is `flywheel-verify` (the bare `flywheel` name is an
+unrelated package); the installed command stays `flywheel`. After it is
+published to PyPI:
+
+```
+pip install flywheel-verify
+flywheel up
+```
+
+## Documentation
+
+- [QUICKSTART.md](QUICKSTART.md): first ten minutes
+- [WALKTHROUGH.md](WALKTHROUGH.md): guided tour
+- [docs/LESSON-LOOP.md](docs/LESSON-LOOP.md): the organizational learning loop (architecture)
+- [docs/GUIDE-LESSON-LOOP.md](docs/GUIDE-LESSON-LOOP.md): the organizational learning loop (full guide and spec)
+- [docs/ASSESSMENT-AGENTIC-SECURITY-2026-08.md](docs/ASSESSMENT-AGENTIC-SECURITY-2026-08.md): Flywheel against the July 2026 agentic security convergence
+- [CREDO.md](CREDO.md): the belief
+
+## License
+
+FSL-1.1-MIT (Functional Source License). See [LICENSE](LICENSE).

flywheel_verify-0.3.0/flywheel_verify.egg-info/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: flywheel-verify
+Version: 0.3.0
+Summary: The one platform: routing, verification, the lane layer, memory/context/catalog, and the closed verified-inference loop.
+Author: Zain
+License: FSL-1.1-MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Flywheel
+
+> One platform: routing, verification, the lane layer, the closed loop, and the
+> projected world. The native desktop surface for accountable AI infrastructure.
+
+Flywheel is the engine and native client for a verified-inference loop: a model
+perceives only through witnessed organs, acts only through a gate it cannot
+talk past, journals everything, and verifies its own work by re-perceiving.
+
+The flagship tools (gather, crucible, index, forum, learn, telos) are lanes
+inside Flywheel, each a provisioned, health-checked organ reachable through one
+surface. Every agent tool call carries a sealed, chain-linked receipt a third
+party re-verifies offline.
+
+**Proof before trust.**
+
+## What is in this repo
+
+This is a monorepo containing both halves of the platform:
+
+- **`harness/`** is the Python engine: the gateway (localhost HTTP API), the
+  agent loop, the receipt discipline, the lane layer, the verified-inference
+  loop, the tool-call receipt system. Zero runtime dependencies (stdlib only).
+- **`desktop/`** is the Flutter native client: 24 views, 50 widgets, zero
+  webview embedding. Talks to the gateway over localhost. Launches a bundled
+  frozen engine by absolute path on a clean machine (no Python, no PATH, no
+  network).
+- **`site/`** is a dev/CI fallback browser shell (not the primary UI).
+
+## Run it now
+
+Start the gateway (the engine keeps the loop, receipts, lanes, and routing):
+
+```
+flywheel app --port 8799
+```
+
+The **native surface is Flywheel Desktop**. From a dev checkout:
+
+```
+cd desktop
+flutter run -d windows --release
+```
+
+The gateway also serves a `/site/index.html` shell as a dev/CI fallback.
+
+## The lane model
+
+Flywheel encompasses the tool family. Each flagship is a lane:
+
+| Lane | Repo | Role |
+| --- | --- | --- |
+| gather | [gather](https://github.com/HarperZ9/gather) | Research intake + provenance receipts |
+| crucible | [crucible](https://github.com/HarperZ9/crucible) | Falsifiable verification (MATCH / DRIFT / UNVERIFIABLE) |
+| index | [index](https://github.com/HarperZ9/index) | Workspace map + symbol graph + context envelopes |
+| forum | [forum](https://github.com/HarperZ9/forum) | Witnessed causal ledger + model-agnostic routing |
+| learn | [learn](https://github.com/HarperZ9/learn) | Accountable learning forge |
+| telos | [telos](https://github.com/HarperZ9/telos) | The reconciliation lane |
+
+Check their health through one surface:
+
+```
+flywheel lanes
+flywheel lanes --probe    # live MCP handshake per lane
+```
+
+## The receipt discipline
+
+Every agent tool invocation carries a sealed receipt binding:
+
+- **what the tool was** (capability class: read / write / exec / external-mcp)
+- **what it was allowed to do** (admission decision from the gate)
+- **what it actually did** (witnessed args + output sha256 digests, never raw content)
+- **whether a stranger can re-walk it** (offline-verifiable, chain-linked)
+
+Receipts compose into a transitive-witness DAG where a drifted action degrades
+exactly its downstream dependents. The five flagships emit organ-bundle entries
+on a shared proof-surface spine so cross-tool receipts compose end-to-end.
+
+## The organizational learning loop
+
+The layer above audit. The receipt discipline records what happened at machine
+resolution. The learning loop feeds forward: it derives lessons from witnessed
+divergences (an allowed action that rolled back, a memory whose source drifted,
+a graded failure), stores them in a durable, hash-chained, append-only memory,
+and surfaces recurring patterns as improvement candidates for human admission.
+A lesson is not a note an operator wrote; it is a claim bound by hash to its
+evidence, re-checkable offline, fail-closed when the evidence is gone. See
+[docs/LESSON-LOOP.md](docs/LESSON-LOOP.md).
+
+## Offline-first
+
+The Flutter desktop GUI launches a bundled engine by absolute path and serves
+its UI menu on localhost only. No external web address is contacted to show the
+GUI. The gateway serves `/api/*` and the UI on `http://127.0.0.1:8799`.
+
+## Install
+
+From source today (zero runtime dependencies, stdlib only):
+
+```
+git clone https://github.com/HarperZ9/flywheel.git
+cd flywheel
+pip install -e .
+python scripts/run_harness_cli.py app --port 8799
+```
+
+`pip install -e .` puts the `flywheel` command on your PATH, so you can also
+start the gateway with `flywheel up`.
+
+The PyPI distribution name is `flywheel-verify` (the bare `flywheel` name is an
+unrelated package); the installed command stays `flywheel`. After it is
+published to PyPI:
+
+```
+pip install flywheel-verify
+flywheel up
+```
+
+## Documentation
+
+- [QUICKSTART.md](QUICKSTART.md): first ten minutes
+- [WALKTHROUGH.md](WALKTHROUGH.md): guided tour
+- [docs/LESSON-LOOP.md](docs/LESSON-LOOP.md): the organizational learning loop (architecture)
+- [docs/GUIDE-LESSON-LOOP.md](docs/GUIDE-LESSON-LOOP.md): the organizational learning loop (full guide and spec)
+- [docs/ASSESSMENT-AGENTIC-SECURITY-2026-08.md](docs/ASSESSMENT-AGENTIC-SECURITY-2026-08.md): Flywheel against the July 2026 agentic security convergence
+- [CREDO.md](CREDO.md): the belief
+
+## License
+
+FSL-1.1-MIT (Functional Source License). See [LICENSE](LICENSE).