fix(tools): correct PyPI long_description metadata + stale tool-count tests

Packaging metadata (twine check was PASSED-with-warnings -> clean PASS):
- config/llm/mcp/vector: add missing 'readme = README.md' ([project] key);
  README files existed but were never wired into the dist metadata.
- net/plan/vcs: fill empty (0-byte) README.md files referenced by the
  readme key, so long_description is no longer missing.

Tests (hanzo-tools-core/test_all_tools.py drifted from current sources):
- browser: 1 -> 3 tools (browser, cdp, playwright after the zapd split)
- mcp_tools: 4 -> 5 tools
- required-tool total: 21 -> 23

pkg/hanzo-tools-config/pyproject.toml

@@ -6,6 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "hanzo-tools-config"
 version = "0.2.1"
 description = "Configuration tools for Hanzo AI - mode, settings management"
+readme = "README.md"
 requires-python = ">=3.12"
 license = { text = "MIT" }
 authors = [{ name = "Hanzo Industries Inc", email = "[email protected]" }]

pkg/hanzo-tools-core/tests/test_all_tools.py

@@ -119,10 +119,10 @@ class TestToolPackages:
         assert len(TOOLS) == 3
 
     def test_browser_tools(self):
-        """Test hanzo-tools-browser has 1 tool."""
+        """Test hanzo-tools-browser has 3 tools (browser, cdp, playwright)."""
         from hanzo_tools.browser import TOOLS
 
-        assert len(TOOLS) == 1
+        assert len(TOOLS) == 3
 
     @pytest.mark.skipif(
         not _module_installed("hanzo_tools.config"),
@@ -139,10 +139,10 @@ class TestToolPackages:
         reason="hanzo-tools-mcp not installed",
     )
     def test_mcp_tools(self):
-        """Test hanzo-tools-mcp has 4 tools."""
+        """Test hanzo-tools-mcp has 5 tools."""
         from hanzo_tools.mcp_tools import TOOLS
 
-        assert len(TOOLS) == 4
+        assert len(TOOLS) == 5
 
     @pytest.mark.skipif(
         not _module_installed("hanzo_tools.llm"),
@@ -283,7 +283,7 @@ class TestTotalToolCount:
         required_packages = [
             ("hanzo_tools.fs", 1),
             ("hanzo_tools.shell", 9),
-            ("hanzo_tools.browser", 1),
+            ("hanzo_tools.browser", 3),
             ("hanzo_tools.memory", 1),  # unified memory tool
             ("hanzo_tools.todo", 1),
             ("hanzo_tools.reasoning", 2),
@@ -306,5 +306,5 @@ class TestTotalToolCount:
             ), f"{pkg_name}: expected {expected_count} tools, got {actual}"
             total += actual
 
-        # Required tools: 21 (1+9+1+1+1+2+1+1+1+3)
-        assert total == 21, f"Expected 21 required tools, got {total}"
+        # Required tools: 23 (1+9+3+1+1+2+1+1+1+3)
+        assert total == 23, f"Expected 23 required tools, got {total}"

pkg/hanzo-tools-llm/pyproject.toml

@@ -6,6 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "hanzo-tools-llm"
 version = "0.2.0"
 description = "LLM tools for Hanzo AI - model management, consensus, providers"
+readme = "README.md"
 requires-python = ">=3.12"
 license = { text = "MIT" }
 authors = [{ name = "Hanzo Industries Inc", email = "[email protected]" }]

pkg/hanzo-tools-mcp/pyproject.toml

@@ -6,6 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "hanzo-tools-mcp"
 version = "0.3.0"
 description = "MCP management tools for Hanzo AI - server management, dynamic proxy for external MCPs"
+readme = "README.md"
 requires-python = ">=3.12"
 license = { text = "MIT" }
 authors = [{ name = "Hanzo Industries Inc", email = "[email protected]" }]

pkg/hanzo-tools-net/README.md

@@ -0,0 +1,26 @@
+# hanzo-tools-net
+
+Network tools for Hanzo AI MCP (HIP-0300).
+
+## Tools
+
+- `fetch` - HTTP fetch with content extraction (HTML/JSON/text)
+
+## Installation
+
+```bash
+pip install hanzo-tools-net
+```
+
+## Usage
+
+```python
+from hanzo_tools.net import TOOLS, register_tools
+
+# Register with MCP server
+register_tools(mcp_server)
+```
+
+## Part of hanzo-tools
+
+This package is part of the modular [hanzo-tools](../hanzo-tools) ecosystem.

pkg/hanzo-tools-plan/README.md

@@ -0,0 +1,26 @@
+# hanzo-tools-plan
+
+Plan orchestration tools for Hanzo AI MCP (HIP-0300).
+
+## Tools
+
+- `plan` - Structured task planning and orchestration
+
+## Installation
+
+```bash
+pip install hanzo-tools-plan
+```
+
+## Usage
+
+```python
+from hanzo_tools.plan import TOOLS, register_tools
+
+# Register with MCP server
+register_tools(mcp_server)
+```
+
+## Part of hanzo-tools
+
+This package is part of the modular [hanzo-tools](../hanzo-tools) ecosystem.

pkg/hanzo-tools-vcs/README.md

@@ -0,0 +1,26 @@
+# hanzo-tools-vcs
+
+Unified version control tool for Hanzo AI MCP (HIP-0300).
+
+## Tools
+
+- `git` - Unified version control (status, diff, commit, branch, log, …)
+
+## Installation
+
+```bash
+pip install hanzo-tools-vcs
+```
+
+## Usage
+
+```python
+from hanzo_tools.vcs import TOOLS, register_tools
+
+# Register with MCP server
+register_tools(mcp_server)
+```
+
+## Part of hanzo-tools
+
+This package is part of the modular [hanzo-tools](../hanzo-tools) ecosystem.

pkg/hanzo-tools-vector/pyproject.toml

@@ -6,6 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "hanzo-tools-vector"
 version = "0.2.0"
 description = "Vector/embedding tools for Hanzo AI - indexing, search, RAG"
+readme = "README.md"
 requires-python = ">=3.12"
 license = { text = "MIT" }
 authors = [{ name = "Hanzo Industries Inc", email = "[email protected]" }]