chore: enhance project metadata, tooling, and documentation

**Project Configuration:**
- Enhance pyproject.toml with comprehensive metadata, keywords, and classifiers
- Add LICENSE file (MIT) for proper open-source distribution
- Add PUBLISHING.md with comprehensive publishing guidelines
- Update .gitignore to exclude tool artifacts (.cache, .pytest_cache, .ruff_cache, .ty_cache)
- Ignore documentation working directories (.docs, .full-review, docs/plans, docs/sessions)

**Documentation:**
- Add extensive Unraid API research documentation
  - API source code analysis and resolver mapping
  - Competitive analysis and feature gap assessment
  - Release notes analysis (7.0.0, 7.1.0, 7.2.0)
  - Connect platform overview and remote access documentation
- Document known API patterns, limitations, and edge cases

**Testing & Code Quality:**
- Expand test coverage across all tool modules
- Add destructive action confirmation tests
- Improve test assertions and error case validation
- Refine type annotations for better static analysis

**Tool Improvements:**
- Enhance error handling consistency across all tools
- Improve type safety with explicit type annotations
- Refine GraphQL query construction patterns
- Better handling of optional parameters and edge cases

This commit prepares the project for v0.2.0 release with improved
metadata, comprehensive documentation, and enhanced code quality.

Co-authored-by: Claude <noreply@anthropic.com>

tests/test_vm.py

@@ -32,9 +32,9 @@ class TestVmValidation:
                 await tool_fn(action=action, vm_id="uuid-1")
 
     async def test_destructive_vm_id_check_before_confirm(self, _mock_graphql: AsyncMock) -> None:
-        """Destructive actions without vm_id should fail on confirm first."""
+        """Destructive actions without vm_id should fail on vm_id first (validated before confirm)."""
         tool_fn = _make_tool()
-        with pytest.raises(ToolError, match="destructive"):
+        with pytest.raises(ToolError, match="vm_id"):
             await tool_fn(action="force_stop")
 
 
@@ -102,6 +102,27 @@ class TestVmActions:
         assert result["success"] is True
         assert result["action"] == "force_stop"
 
+    async def test_stop_vm(self, _mock_graphql: AsyncMock) -> None:
+        _mock_graphql.return_value = {"vm": {"stop": True}}
+        tool_fn = _make_tool()
+        result = await tool_fn(action="stop", vm_id="uuid-1")
+        assert result["success"] is True
+        assert result["action"] == "stop"
+
+    async def test_pause_vm(self, _mock_graphql: AsyncMock) -> None:
+        _mock_graphql.return_value = {"vm": {"pause": True}}
+        tool_fn = _make_tool()
+        result = await tool_fn(action="pause", vm_id="uuid-1")
+        assert result["success"] is True
+        assert result["action"] == "pause"
+
+    async def test_resume_vm(self, _mock_graphql: AsyncMock) -> None:
+        _mock_graphql.return_value = {"vm": {"resume": True}}
+        tool_fn = _make_tool()
+        result = await tool_fn(action="resume", vm_id="uuid-1")
+        assert result["success"] is True
+        assert result["action"] == "resume"
+
     async def test_mutation_unexpected_response(self, _mock_graphql: AsyncMock) -> None:
         _mock_graphql.return_value = {"vm": {}}
         tool_fn = _make_tool()