doc: update draft

Author: observerw

docs/schemas/draft/call_hierarchy.md

@@ -158,3 +158,7 @@ The Call Hierarchy API allows tracing the relationships between functions, showi
 > [!NOTE]
 > Tree is truncated at depth 3. Use `depth` parameter to explore further.
 ```
+
+## Pending Issues
+
+- **TBD**: Cycle detection and performance for extremely deep call hierarchies.

docs/schemas/draft/diagnostics.md

@@ -179,3 +179,11 @@ Total issues: 15 | Showing: 10 (Offset: 0, Limit: 10)
 > More issues available.
 > To see the rest, specify a `max_items` and use: `start_index=10`
 ```
+
+## Pending Issues
+
+- **Interface Design**: Diagnostics are split into workspace-wide and document-specific types. Designing an interface that elegantly handles both (e.g., how to unify the request/response models while maintaining performance) is a major design hurdle.
+
+## Pending Issues
+
+- **Interface Design**: Diagnostics are split into workspace-wide and document-specific types. Designing an interface that elegantly handles both (e.g., how to unify the request/response models while maintaining performance) is a major design hurdle.

docs/schemas/draft/implementation.md

@@ -201,3 +201,7 @@ def query(self, sql, params=None):
 > More implementations available.
 > To see more, specify a `max_items` and use: `start_index=3`
 ````
+
+## Pending Issues
+
+- **TBD**: Performance considerations when searching for implementations in extremely large workspaces.

docs/schemas/draft/inlay_hints.md

@@ -184,3 +184,7 @@ class DataService:
 > Annotations like `/* :type */` or `/* param:= */` are injected for clarity.
 > Runtime values (if any) are shown as `// value: x=42`.
 ````
+
+## Pending Issues
+
+- **Debugger Integration**: The difficulty of `Inline Values` lies in the need to interface with a debugger. This involves the Debug Adapter Protocol (DAP) to retrieve runtime states, which introduces complexities regarding debug session management and synchronization.

docs/schemas/draft/relation.md

@@ -79,3 +79,7 @@ Found 2 call chain(s):
 3. **SessionManager.get_session** (`Method`) - `src/services/session.py`
 4. **db.query** (`Function`) - `src/db.py`
 ```
+
+## Pending Issues
+
+- **TBD**: Search algorithm efficiency for large-scale dependency graphs and path filtering criteria.

docs/schemas/draft/rename.md

@@ -200,3 +200,7 @@ Summary: Affects 5 files and 12 occurrences.
 > This is a permanent workspace-wide change.
 > Please verify the diffs above before proceeding with further edits.
 ```
+
+## Pending Issues
+
+- **TBD**: Handling of dynamic references (e.g., `getattr`, reflection) and safe rollback mechanisms.

docs/schemas/draft/test_relation.md

@@ -120,3 +120,7 @@ Found 1 related item(s):
   - Line: 42
   - Strategy: `reference`
 ```
+
+## Pending Issues
+
+- **TBD**: Improving heuristic accuracy and supporting more language-specific test patterns (e.g., nested test classes).

docs/schemas/draft/type_hierarchy.md

@@ -120,22 +120,10 @@ The Type Hierarchy API allows exploring the inheritance relationships of a class
 > Tree is truncated at depth 2. Increase `depth` parameter to explore further if needed.
 ```
 
-### Scenario 3: Exploring complete hierarchy (both directions)
+## Pending Issues
 
-#### Request
+- **TBD**: Handling of multiple inheritance and integration with external types not defined in the workspace.
 
-```json
-{
-  "locate": {
-    "file_path": "src/controllers.py",
-    "scope": {
-      "symbol_path": ["AuthController"]
-    }
-  },
-  "direction": "both",
-  "depth": 2
-}
-```
 
 #### Markdown Rendered for LLM