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>

unraid_mcp/tools/docker.py

@@ -107,7 +107,7 @@ DOCKER_ACTIONS = Literal[
 ]
 
 # Docker container IDs: 64 hex chars + optional suffix (e.g., ":local")
-_DOCKER_ID_PATTERN = re.compile(r"^[a-f0-9]{64}(:[a-z0-9]+)?$", re.IGNORECASE)
+_DOCKER_ID_PATTERN = re.compile(r"^[a-f0-9]{64}(:[a-z0-9]+)?$")
 
 
 def find_container_by_identifier(
@@ -126,7 +126,7 @@ def find_container_by_identifier(
     id_lower = identifier.lower()
     for c in containers:
         for name in c.get("names", []):
-            if id_lower in name.lower() or name.lower() in id_lower:
+            if id_lower in name.lower():
                 logger.info(f"Fuzzy match: '{identifier}' -> '{name}'")
                 return c
 
@@ -273,7 +273,10 @@ def register_docker_tool(mcp: FastMCP) -> None:
                     MUTATIONS["start"], {"id": actual_id},
                     operation_context={"operation": "start"},
                 )
-                result = start_data.get("docker", {}).get("start", {})
+                if start_data.get("idempotent_success"):
+                    result = {}
+                else:
+                    result = start_data.get("docker", {}).get("start", {})
                 response: dict[str, Any] = {
                     "success": True, "action": "restart", "container": result,
                 }
@@ -312,7 +315,7 @@ def register_docker_tool(mcp: FastMCP) -> None:
                     "container": result,
                 }
 
-            return {}
+            raise ToolError(f"Unhandled action '{action}' — this is a bug")
 
         except ToolError:
             raise