attune-harness 0.1.0__tar.gz

attune_harness-0.1.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Deep Study AI, LLC
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

attune_harness-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+# The test suite depends on tests/fixtures and the experiments/ tree, neither of
+# which ships in the source distribution. Exclude the tests rather than publish
+# a partial suite that cannot run. Run tests from a repository checkout.
+prune tests

attune_harness-0.1.0/PKG-INFO

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: attune-harness
+Version: 0.1.0
+Summary: Portable execution contracts for multi-model agent work
+Author-email: Patrick Roebuck <admin@smartaimemory.com>
+Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/Smart-AI-Memory/attune-harness
+Project-URL: Repository, https://github.com/Smart-AI-Memory/attune-harness
+Project-URL: Issues, https://github.com/Smart-AI-Memory/attune-harness/issues
+Keywords: ai-agent,multi-agent,agent-harness,llm,mcp,developer-tools,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Environment :: Console
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: tokens
+Requires-Dist: tiktoken==0.12.0; extra == "tokens"
+Provides-Extra: verify
+Requires-Dist: attune-verify==0.6.0; extra == "verify"
+Provides-Extra: rag
+Requires-Dist: attune-rag==1.2.0; extra == "rag"
+Provides-Extra: voyage
+Requires-Dist: voyageai==0.5.0; extra == "voyage"
+Requires-Dist: lancedb==0.38.0; extra == "voyage"
+Requires-Dist: pyarrow==25.0.1; extra == "voyage"
+Requires-Dist: jsonschema==4.26.0; extra == "voyage"
+Provides-Extra: review
+Requires-Dist: attune-forms==0.17.0; extra == "review"
+Requires-Dist: attune-verify==0.6.0; extra == "review"
+Requires-Dist: attune-rag==1.2.0; extra == "review"
+Provides-Extra: mcp
+Requires-Dist: mcp==2.2.0; extra == "mcp"
+Requires-Dist: attune-forms==0.17.0; extra == "mcp"
+Requires-Dist: attune-verify==0.6.0; extra == "mcp"
+Requires-Dist: attune-rag==1.2.0; extra == "mcp"
+Provides-Extra: memory-native
+Requires-Dist: anthropic==1.6.0; extra == "memory-native"
+Requires-Dist: httpx2==2.13.0; extra == "memory-native"
+Dynamic: license-file
+
+# Attune Harness
+
+**Run an agent's work, check it independently, and keep a receipt of which happened.**
+
+> **Status: 0.1.0, alpha.** Interfaces, configuration formats and CLI commands may
+> change before 1.0. What is and is not qualified is
+> [listed below](#what-is-qualified-and-what-is-not), not implied.
+
+On September 18, 2026 I ran twelve model-written implementations of a small JSONL
+exporter through Harness. Nine behaved correctly under the full check. The other three passed when their serializer
+was tested directly, and failed when run through the real command line, which is the
+only way anyone would ever use them
+([results](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/plan-build-native-results.md)).
+
+That gap is what Harness is for. A participant produces output: a model, a command,
+or your own code. A check you supply, separate from the participant, decides whether
+the output counts. You get back a receipt that says which. The participant's account
+of its own work is recorded. It is never the evidence.
+
+## A wrong answer comes back rejected
+
+```sh
+pip install attune-harness
+```
+
+The core has no dependencies and needs Python 3.10 or later. No provider SDK, no
+API key, and no attune-ai installation.
+
+```python
+from attune_harness import Check, Output, Task, run
+
+class Worker:
+    def run(self, task: Task) -> Output:
+        return Output("4")
+
+receipt = run(
+    Task("addition", "Compute 2 + 2", ("Return the integer result",)),
+    "example-worker",
+    Worker(),
+    lambda task, output: Check(output.text == "4", "Compared with independent arithmetic"),
+)
+print(receipt.status.value)  # verified
+```
+
+Change the worker to return `"5"` and the same call returns `rejected`, with the
+output and the check's evidence still attached. If the participant or the check
+raises, the status is `failed` and the receipt names the stage and the error. `run`
+executes once. It never retries on its own.
+
+`python -m attune_harness` runs the installed demonstration and prints a JSON receipt.
+
+## The CLI applies the same contract to larger work
+
+```text
+attune-harness --help
+
+Task execution
+  plan         Define intent and accept its scope
+  build        Execute accepted tasks and protected checks
+  review       Assess a document against project evidence
+  fix          Repair scoped files and check the result
+  test         Test a captured change and retain the evidence
+
+Task controls
+  status       Inspect a saved task
+  resume       Continue a saved task
+
+AI tools and integration
+  --help-all   Browse operational tools and compatibility commands
+```
+
+Every verb follows one pattern. You accept a scope before anything runs, the host
+applies the effects, and checks fixed in advance decide the outcome. `fix` is the
+clearest example: it freezes an acceptance probe before the worker starts, applies
+the worker's proposed replacement itself, and keeps the failed-before and
+passed-after probe evidence. A saved task can be inspected with `status` and
+continued with `resume`; completed operations replay from saved evidence instead of
+running again.
+
+Reaching outside the process takes explicit permission. External command
+participants need `--allow-external`, and native model participants also need
+`--allow-native`. **Approving a plan does not authorize paid calls.**
+
+Many of these commands are there for the agent and its integrations to call.
+Learning their syntax is not the price of entry, and `attune-harness COMMAND --help`
+covers direct use. Full usage, exit codes and recovery controls are in the
+[CLI guide](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/cli-guide.md).
+
+## Install only what you use
+
+| You want | Install |
+| --- | --- |
+| The core contracts and CLI, with no dependencies | `pip install attune-harness` |
+| Document claim verification (`attune-verify` 0.6.0) | `pip install 'attune-harness[verify]'` |
+| Local Markdown retrieval with source hashes, no model calls (`attune-rag` 1.2.0) | `pip install 'attune-harness[rag]'` |
+| The evidence-review and test journeys: forms, retrieval and verification together | `pip install 'attune-harness[review]'` |
+| Accepted retrieval grants served over MCP stdio (`mcp` 2.2.0) | `pip install 'attune-harness[mcp]'` |
+| Repository-first retrieval on Voyage embeddings | `pip install 'attune-harness[voyage]'` |
+| Token counting (`tiktoken` 0.12.0) | `pip install 'attune-harness[tokens]'` |
+| Experimental: memory proposals from a Claude model over a pinned, data-only Anthropic API transport (`anthropic` 1.6.0, `httpx2` 2.13.0). POSIX only, needs `ANTHROPIC_API_KEY`, makes paid calls | `pip install 'attune-harness[memory-native]'` |
+
+Extras pin exact versions as of 0.1.0. Keep the quotes: zsh and bash treat square
+brackets as glob characters. When an extra is missing, the command that needs it
+returns an actionable unavailable report instead of a traceback.
+
+## What is qualified and what is not
+
+I would rather you find the limits here than in your own checkout. Green software
+tests and model quality are different claims, and this project keeps them apart.
+
+| Area | Qualified | Not qualified |
+| --- | --- | --- |
+| Platforms | CI builds and installs the wheel on macOS, Ubuntu and Windows with Python 3.10 and 3.12, and exercises timeouts, cancellation, bounded output, crash-released locks and recovery ([guide](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/qualification.md)) | Other Python versions are outside the matrix. On Windows, a process that holds a run's `record.json` open for more than about two seconds still fails that run closed |
+| Models | CI calls no model provider. Native Claude and Codex adapters have recorded comparisons | Native planning and building are experimental. In the September 18, 2026 comparison the original reply contract accepted 1 of 24 replies; after the contract was corrected it accepted 12 of 12. Two repetitions per role do not establish a reliability rate |
+| `fix` and `test` | Local POSIX Git checkouts, regular files, default pytest discovery | Windows repair effects, file creation, deletion and renames, linked worktrees, custom pytest collectors, committed revision ranges |
+| Isolation | Commands and probes run as supervised processes with deadlines and bounded output | **This is not a security sandbox.** Use a dedicated checkout and commands you trust |
+| Receipts | Receipts retain the task, output and check evidence locally | They are local values, not signed attestations. Constructing a `Receipt` directly certifies nothing |
+| Plan acceptance | Core imports, help and the library run standalone | `plan --accept` needs the optional Attune AI Spec runtime in the same environment |
+| Protocols | MCP (2025-11-25 and 2026-07-28 profiles) and A2A 1.0 have local independent-client receipts | Remote authentication, arbitrary executable plugins and automatic host installation |
+| Memory | A read-only integration plan is accepted and qualified in a temporary install | The memory modules and the `memory-native` extra ship in the wheel but are experimental and not activated for live memories. The native transport is POSIX only, accepts two exact model IDs, refuses any other SDK version, and is never exercised in CI |
+| Roadmap | | `ship` and `reflect` are planned routes and do not exist yet |
+
+## Harness and attune-ai
+
+Harness is the successor I am building to
+[attune-ai](https://pypi.org/project/attune-ai/). It starts from a constraint
+attune-ai never had: the core must run with no provider SDK and nothing else from
+the Attune family installed. The Attune libraries come in as extras, where you can
+see exactly what each one adds.
+
+attune-ai is still where cross-session memory, the Claude Code plugin and the
+multi-agent workflows live. Harness does not replace those today. If that is what
+you need, install attune-ai.
+
+## Links
+
+- [Qualification guide](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/qualification.md)
+- [CLI guide](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/cli-guide.md)
+- [Portable contract](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/portable-contract.md)
+- [Repository](https://github.com/Smart-AI-Memory/attune-harness) and
+  [issues](https://github.com/Smart-AI-Memory/attune-harness/issues)
+
+**Apache License 2.0.**
+
+Built by Patrick Roebuck, working with Codex and Claude.

attune_harness-0.1.0/README.md

@@ -0,0 +1,145 @@
+# Attune Harness
+
+**Run an agent's work, check it independently, and keep a receipt of which happened.**
+
+> **Status: 0.1.0, alpha.** Interfaces, configuration formats and CLI commands may
+> change before 1.0. What is and is not qualified is
+> [listed below](#what-is-qualified-and-what-is-not), not implied.
+
+On September 18, 2026 I ran twelve model-written implementations of a small JSONL
+exporter through Harness. Nine behaved correctly under the full check. The other three passed when their serializer
+was tested directly, and failed when run through the real command line, which is the
+only way anyone would ever use them
+([results](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/plan-build-native-results.md)).
+
+That gap is what Harness is for. A participant produces output: a model, a command,
+or your own code. A check you supply, separate from the participant, decides whether
+the output counts. You get back a receipt that says which. The participant's account
+of its own work is recorded. It is never the evidence.
+
+## A wrong answer comes back rejected
+
+```sh
+pip install attune-harness
+```
+
+The core has no dependencies and needs Python 3.10 or later. No provider SDK, no
+API key, and no attune-ai installation.
+
+```python
+from attune_harness import Check, Output, Task, run
+
+class Worker:
+    def run(self, task: Task) -> Output:
+        return Output("4")
+
+receipt = run(
+    Task("addition", "Compute 2 + 2", ("Return the integer result",)),
+    "example-worker",
+    Worker(),
+    lambda task, output: Check(output.text == "4", "Compared with independent arithmetic"),
+)
+print(receipt.status.value)  # verified
+```
+
+Change the worker to return `"5"` and the same call returns `rejected`, with the
+output and the check's evidence still attached. If the participant or the check
+raises, the status is `failed` and the receipt names the stage and the error. `run`
+executes once. It never retries on its own.
+
+`python -m attune_harness` runs the installed demonstration and prints a JSON receipt.
+
+## The CLI applies the same contract to larger work
+
+```text
+attune-harness --help
+
+Task execution
+  plan         Define intent and accept its scope
+  build        Execute accepted tasks and protected checks
+  review       Assess a document against project evidence
+  fix          Repair scoped files and check the result
+  test         Test a captured change and retain the evidence
+
+Task controls
+  status       Inspect a saved task
+  resume       Continue a saved task
+
+AI tools and integration
+  --help-all   Browse operational tools and compatibility commands
+```
+
+Every verb follows one pattern. You accept a scope before anything runs, the host
+applies the effects, and checks fixed in advance decide the outcome. `fix` is the
+clearest example: it freezes an acceptance probe before the worker starts, applies
+the worker's proposed replacement itself, and keeps the failed-before and
+passed-after probe evidence. A saved task can be inspected with `status` and
+continued with `resume`; completed operations replay from saved evidence instead of
+running again.
+
+Reaching outside the process takes explicit permission. External command
+participants need `--allow-external`, and native model participants also need
+`--allow-native`. **Approving a plan does not authorize paid calls.**
+
+Many of these commands are there for the agent and its integrations to call.
+Learning their syntax is not the price of entry, and `attune-harness COMMAND --help`
+covers direct use. Full usage, exit codes and recovery controls are in the
+[CLI guide](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/cli-guide.md).
+
+## Install only what you use
+
+| You want | Install |
+| --- | --- |
+| The core contracts and CLI, with no dependencies | `pip install attune-harness` |
+| Document claim verification (`attune-verify` 0.6.0) | `pip install 'attune-harness[verify]'` |
+| Local Markdown retrieval with source hashes, no model calls (`attune-rag` 1.2.0) | `pip install 'attune-harness[rag]'` |
+| The evidence-review and test journeys: forms, retrieval and verification together | `pip install 'attune-harness[review]'` |
+| Accepted retrieval grants served over MCP stdio (`mcp` 2.2.0) | `pip install 'attune-harness[mcp]'` |
+| Repository-first retrieval on Voyage embeddings | `pip install 'attune-harness[voyage]'` |
+| Token counting (`tiktoken` 0.12.0) | `pip install 'attune-harness[tokens]'` |
+| Experimental: memory proposals from a Claude model over a pinned, data-only Anthropic API transport (`anthropic` 1.6.0, `httpx2` 2.13.0). POSIX only, needs `ANTHROPIC_API_KEY`, makes paid calls | `pip install 'attune-harness[memory-native]'` |
+
+Extras pin exact versions as of 0.1.0. Keep the quotes: zsh and bash treat square
+brackets as glob characters. When an extra is missing, the command that needs it
+returns an actionable unavailable report instead of a traceback.
+
+## What is qualified and what is not
+
+I would rather you find the limits here than in your own checkout. Green software
+tests and model quality are different claims, and this project keeps them apart.
+
+| Area | Qualified | Not qualified |
+| --- | --- | --- |
+| Platforms | CI builds and installs the wheel on macOS, Ubuntu and Windows with Python 3.10 and 3.12, and exercises timeouts, cancellation, bounded output, crash-released locks and recovery ([guide](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/qualification.md)) | Other Python versions are outside the matrix. On Windows, a process that holds a run's `record.json` open for more than about two seconds still fails that run closed |
+| Models | CI calls no model provider. Native Claude and Codex adapters have recorded comparisons | Native planning and building are experimental. In the September 18, 2026 comparison the original reply contract accepted 1 of 24 replies; after the contract was corrected it accepted 12 of 12. Two repetitions per role do not establish a reliability rate |
+| `fix` and `test` | Local POSIX Git checkouts, regular files, default pytest discovery | Windows repair effects, file creation, deletion and renames, linked worktrees, custom pytest collectors, committed revision ranges |
+| Isolation | Commands and probes run as supervised processes with deadlines and bounded output | **This is not a security sandbox.** Use a dedicated checkout and commands you trust |
+| Receipts | Receipts retain the task, output and check evidence locally | They are local values, not signed attestations. Constructing a `Receipt` directly certifies nothing |
+| Plan acceptance | Core imports, help and the library run standalone | `plan --accept` needs the optional Attune AI Spec runtime in the same environment |
+| Protocols | MCP (2025-11-25 and 2026-07-28 profiles) and A2A 1.0 have local independent-client receipts | Remote authentication, arbitrary executable plugins and automatic host installation |
+| Memory | A read-only integration plan is accepted and qualified in a temporary install | The memory modules and the `memory-native` extra ship in the wheel but are experimental and not activated for live memories. The native transport is POSIX only, accepts two exact model IDs, refuses any other SDK version, and is never exercised in CI |
+| Roadmap | | `ship` and `reflect` are planned routes and do not exist yet |
+
+## Harness and attune-ai
+
+Harness is the successor I am building to
+[attune-ai](https://pypi.org/project/attune-ai/). It starts from a constraint
+attune-ai never had: the core must run with no provider SDK and nothing else from
+the Attune family installed. The Attune libraries come in as extras, where you can
+see exactly what each one adds.
+
+attune-ai is still where cross-session memory, the Claude Code plugin and the
+multi-agent workflows live. Harness does not replace those today. If that is what
+you need, install attune-ai.
+
+## Links
+
+- [Qualification guide](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/qualification.md)
+- [CLI guide](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/cli-guide.md)
+- [Portable contract](https://github.com/Smart-AI-Memory/attune-harness/blob/v0.1.0/docs/portable-contract.md)
+- [Repository](https://github.com/Smart-AI-Memory/attune-harness) and
+  [issues](https://github.com/Smart-AI-Memory/attune-harness/issues)
+
+**Apache License 2.0.**
+
+Built by Patrick Roebuck, working with Codex and Claude.

attune_harness-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "attune-harness"
+version = "0.1.0"
+description = "Portable execution contracts for multi-model agent work"
+requires-python = ">=3.10"
+readme = "README.md"
+license = "Apache-2.0"
+license-files = ["LICENSE"]
+authors = [
+    {name = "Patrick Roebuck", email = "admin@smartaimemory.com"}
+]
+maintainers = [
+    {name = "Smart-AI-Memory", email = "admin@smartaimemory.com"}
+]
+keywords = ["ai-agent", "multi-agent", "agent-harness", "llm", "mcp", "developer-tools", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.12",
+    "Environment :: Console",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/Smart-AI-Memory/attune-harness"
+Repository = "https://github.com/Smart-AI-Memory/attune-harness"
+Issues = "https://github.com/Smart-AI-Memory/attune-harness/issues"
+
+[project.optional-dependencies]
+tokens = ["tiktoken==0.12.0"]
+verify = ["attune-verify==0.6.0"]
+rag = ["attune-rag==1.2.0"]
+voyage = ["voyageai==0.5.0", "lancedb==0.38.0", "pyarrow==25.0.1", "jsonschema==4.26.0"]
+review = ["attune-forms==0.17.0", "attune-verify==0.6.0", "attune-rag==1.2.0"]
+mcp = ["mcp==2.2.0", "attune-forms==0.17.0", "attune-verify==0.6.0", "attune-rag==1.2.0"]
+memory-native = ["anthropic==1.6.0", "httpx2==2.13.0"]
+
+[project.scripts]
+attune-harness = "attune_harness.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

attune_harness-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+