docs: update human and LLM docs and enhance tool/list schemas with actionable next steps

README.md

@@ -25,6 +25,27 @@ To prevent graph fragmentation and ensure optimal LLM tokenization and retrieval
 
 ---
 
+---
+
+## 🛠️ Consolidated Smart MCP Tools
+
+The server consolidates granular single-purpose tools into 12 concise, action-oriented smart domain handlers with zero prefix clutter:
+
+* **`tasks`**: Complete task lifecycle management (`add`, `update`, `delete`, `list`, `set_criteria`, `verify`).
+* **`milestones`**: Milestone tracking (`add`, `update`, `list`).
+* **`sticky_notes`**: Ephemeral scratchpad notes with TTL (`add`, `read`, `delete`, `clear`).
+* **`handoff_memos`**: Cross-session handoff notes (`leave`, `read`, `clear`).
+* **`pinned_files`**: Working set file focus management (`pin`, `unpin`, `list`).
+* **`context_workspaces`**: Workspace context state snapshots (`save`, `load`, `list`, `delete`, `diff`).
+* **`pr_checklist`**: Pre-commit and PR checklist management (`add`, `get`, `clear`).
+* **`snippets`**: Reusable code snippet vault with BM25+Vector search (`store`, `search`, `delete`, `tag`).
+* **`decisions`**: Architectural Decision Records (ADRs) (`log`, `query`, `delete`).
+* **`tech_debt`**: Engineering technical debt backlog (`log`, `resolve`, `list`).
+* **`environment`**: Infrastructure & tool fingerprints tracking (`update_fingerprint`, `read_fingerprint`, `log_requirement`, `register`, `get_details`).
+* **`clipboard`**: Cross-OS clipboard management (`read`, `write`, `toggle_watch`).
+
+---
+
 ## Key Features & Capabilities
 
 ### 🕸️ Multi-Hop Subgraph Expansion (`get_subgraph`)
@@ -37,11 +58,11 @@ Compares build and test stack traces against historical error resolutions using
 Saves point-in-time snapshots of graph entities, active tasks, and tech debt backlogs before risky operations, enabling seamless state restoration.
 
 ### 📊 Token Budgeting & RRF Search
-* **Token Budgeting**: Supports `summary_level` (`compact` | `detailed` | `full`) and `max_tokens` parameters on `list_active_tasks` and `list_tech_debt`.
+* **Token Budgeting**: Supports `summary_level` (`compact` | `detailed` | `full`) and `max_tokens` parameters on `tasks` (list) and `tech_debt` (list).
 * **Hybrid RRF Search**: `omni_search` combines Tantivy BM25 keyword matching with Dense Vector embeddings using Reciprocal Rank Fusion.
 * **Session Delta Resource (`memory://session/delta`)**: Delivers recent session changes in a compact context resource.
 
-### 🏷️ Domain Tagging for Code Snippets (`tag_snippet`)
+### 🏷️ Domain Tagging for Code Snippets (`snippets`)
 Supports categorization tags (`tags: Vec<String>`) on code snippets for category-filtered searches and domain organization.
 
 ### 🧹 Self-Healing Graph Sweeper (`sweep_graph_health`)
@@ -56,7 +77,7 @@ Evaluates task dependency graphs and returns unblocked, ready-to-run tasks for s
 ### 🧠 Chain-of-Thought & Diagnostic Hypothesis Memory (`log_hypothesis` / `query_hypotheses`)
 Records structured diagnostic hypotheses, test evidence, and verification statuses to preserve reasoning across sessions.
 
-### 🔀 Context Workspace Diffing (`diff_context_workspaces`)
+### 🔀 Context Workspace Diffing (`context_workspaces`)
 Computes structured diffs of pinned files and active task IDs between two saved context workspaces.
 
 ### 📡 Real-time WebSocket Memory Sync (`ws://127.0.0.1:3000/ws`)