Add downloaded-wheel acceptance manifest

README.md

@@ -36,6 +36,15 @@ environment used by your MCP client:
 python -m pip install dettools-0.9.0-py3-none-any.whl
 ```
 
+The base install provides Python-aware reads and whole-file fallback for other
+languages. For the C, C#, C++, Go, Java, JavaScript, Ruby, Rust, and TypeScript
+structure and exact-symbol reads used in the nine-language benchmark, install
+the wheel with its declared `treesitter` extra:
+
+```bash
+python -m pip install "dettools[treesitter] @ file:///absolute/path/to/dettools-0.9.0-py3-none-any.whl"
+```
+
 Configure the MCP server with a portable Python command:
 
 ```json
@@ -115,6 +124,11 @@ verification, checkpoints, and rollback when verification fails.
 No LLM was invoked in this benchmark. It measures serialized code-ingestion
 payloads after each requested target is fixed.
 
+The nine-language run installed the wheel's declared `treesitter` extra.
+Without that extra, non-Python inputs use whole-file fallback: requested source
+is still preserved, but those fallback reads are not represented by the
+multilingual token-reduction result below.
+
 The evaluation compared each serialized DETTOOLS MCP response with a
 deduplicated whole-file baseline that serialized every required source file
 exactly once. Token counts use the `cl100k_base` tokenizer.

SHA256SUMS.txt

@@ -1,4 +1,5 @@
-3fdf96cd2b80e182f7a27524ecc4e35b423698d44a8906cb451da73709bf4713  COMMERCIAL-LICENSE.md
-a176cea909d4b35c799f31be906602b19c2d5f767e5280255fe116cfec57f66e  LICENSE.md
-2fb3065d8a495487571153c9643802f9d0fbc0509cd7731021e1f9ea557d8688  README.md
-ae6c12f96a3d3b87ccaafc9c32040c0d32a0cfc073662f2c05db92db01dbb337  dettools-0.9.0-py3-none-any.whl
+3fdf96cd2b80e182f7a27524ecc4e35b423698d44a8906cb451da73709bf4713  COMMERCIAL-LICENSE.md
+a176cea909d4b35c799f31be906602b19c2d5f767e5280255fe116cfec57f66e  LICENSE.md
+a9f89b78338b30bc09c7bc186348dc045d09f89a7e9e42b01f717cfa6422682c  README.md
+08e0d339c4021afb639ff1c49d11e1e9a1122126acc4bfaf6f37000e871b799e  WHEEL-CONTENTS.md
+ae6c12f96a3d3b87ccaafc9c32040c0d32a0cfc073662f2c05db92db01dbb337  dettools-0.9.0-py3-none-any.whl

WHEEL-CONTENTS.md

@@ -0,0 +1,100 @@
+# DETTOOLS wheel contents
+
+This manifest describes the exact private release candidate before installation.
+
+- Wheel: `dettools-0.9.0-py3-none-any.whl`
+- Version: `0.9.0`
+- Size: `57541` bytes
+- SHA-256: `ae6c12f96a3d3b87ccaafc9c32040c0d32a0cfc073662f2c05db92db01dbb337`
+- Archive members: `30`
+
+## Console entry points
+
+- `dettools = dettools.cli:main`
+- `dettools-mcp = dettools.mcp_server:main`
+
+## Runtime dependencies
+
+Required by the base install:
+
+- `parso<0.9,>=0.8`
+- `mcp<2,>=1.0`
+
+Declared optional extras:
+
+- `tiktoken<1,>=0.7; extra == "tiktoken"`
+- `tree-sitter<0.22,>=0.21; extra == "treesitter"`
+- `tree-sitter-languages<2,>=1.10; extra == "treesitter"`
+
+The nine-language structure and exact-symbol benchmark requires the declared `treesitter` extra. Without it, non-Python files use whole-file fallback.
+
+## Public MCP tools
+
+- `ambiguity_detector`
+- `auto_read`
+- `change_impact`
+- `create_checkpoint`
+- `diff_guard`
+- `file_shape`
+- `generated_file_detector`
+- `import_check`
+- `interface_guard`
+- `parse_check`
+- `preflight_change_gate`
+- `read_symbol`
+- `read_symbols`
+- `read_symbols_multi`
+- `recommend_read_strategy`
+- `reference_aware_rename`
+- `reference_finder`
+- `repo_state`
+- `restore_checkpoint`
+- `scoped_patcher`
+- `symbol_locator`
+- `test_runner_compact`
+- `test_scope_mapper`
+- `tool_capabilities`
+- `workspace_health`
+
+## Exact archive member list
+
+```text
+dettools-0.9.0.dist-info/METADATA
+dettools-0.9.0.dist-info/RECORD
+dettools-0.9.0.dist-info/WHEEL
+dettools-0.9.0.dist-info/entry_points.txt
+dettools-0.9.0.dist-info/licenses/LICENSE.md
+dettools-0.9.0.dist-info/top_level.txt
+dettools/__init__.py
+dettools/actions_bundle.py
+dettools/actions_patch.py
+dettools/actions_read.py
+dettools/ast_tools.py
+dettools/cli.py
+dettools/common.py
+dettools/cst_tools.py
+dettools/inspect_tools.py
+dettools/mcp_server.py
+dettools/policy.py
+dettools/release_profile.py
+dettools/router_base.py
+dettools/tooling/artifacts.py
+dettools/tooling/base_tool.py
+dettools/tooling/registry.py
+dettools/tooling/schemas.py
+dettools/tooling/tool_loader.py
+dettools/tooling/tools/auto_read_tool.py
+dettools/tooling/tools/file_shape_tool.py
+dettools/tooling/tools/read_symbol_tool.py
+dettools/tooling/tools/scoped_patcher_tool.py
+dettools/tools.py
+dettools/ts_tools.py
+```
+
+## Downloaded-wheel acceptance
+
+The SHA-matched downloaded wheel was installed in a clean Python environment. The base install passed dependency checks, imported only from that environment, completed MCP initialization, exposed exactly the 25 tools listed above, exercised every public tool, applied and restored a checkpointed change exactly, passed the fixture tests, rejected an unlisted tool, and wrote no standalone usage log.
+
+With the declared `treesitter` extra installed, the frozen nine-language replay passed `27/27` scenarios and `81/81` sequential reads with exact requested source preserved. Mean serialized ingestion reduction was `95.75%`; the minimum scenario reduction was `91.47%`.
+
+The separate 20-task Azure coding-agent experiment in the README is frozen evidence and was not rerun during this wheel acceptance.