feat: implement get_dependencies MCP tool (include_tree) (#67)

Phase 1: Exposes include dependencies between AsciiDoc files as a new
MCP tool. Adds get_dependencies() to StructureIndex that extracts
include relationships from parsed AsciidocDocument.includes.

Cross-references are reserved for future implementation (empty list).
Bumps version to 0.4.29.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: raifdmueller

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dacli"
-version = "0.4.28"
+version = "0.4.29"
 description = "Documentation Access CLI - Navigate and query large documentation projects"
 readme = "README.md"
 license = { text = "MIT" }

src/dacli/__init__.py

@@ -5,4 +5,4 @@
 """
 
 
-__version__ = "0.4.28"
+__version__ = "0.4.29"

src/dacli/mcp_app.py

@@ -602,6 +602,19 @@ def get_metadata(path: str | None = None) -> dict:
         else:
             return get_section_metadata(index, path)
 
+    @mcp.tool()
+    def get_dependencies() -> dict:
+        """Get include dependencies between documentation files.
+
+        Use this tool to understand which files include other files.
+        Returns an include tree showing the relationships.
+
+        Returns:
+            'include_tree': Mapping of source file to list of included files.
+            'cross_references': Reserved for future use (currently empty).
+        """
+        return index.get_dependencies()
+
     @mcp.tool()
     def validate_structure() -> dict:
         """Validate the document structure.

src/dacli/structure_index.py

@@ -15,6 +15,7 @@
 from dataclasses import dataclass
 from pathlib import Path
 
+from dacli.asciidoc_parser import AsciidocDocument
 from dacli.models import Document, Element, Section
 
 logger = logging.getLogger(__name__)
@@ -517,6 +518,41 @@ def stats(self) -> dict:
             },
         }
 
+    def get_dependencies(self) -> dict:
+        """Get include dependencies across all documents.
+
+        Builds an include tree showing which files include which other files.
+        Only AsciiDoc documents contribute (Markdown has no includes).
+
+        Returns:
+            Dictionary with 'include_tree' (file → list of included files,
+            paths relative to docs root) and 'cross_references' (empty list,
+            reserved for future use).
+        """
+        include_tree: dict[str, list[str]] = {}
+
+        for doc in self._documents:
+            if not isinstance(doc, AsciidocDocument) or not doc.includes:
+                continue
+
+            # Use the document's parent directory as base for relative paths
+            docs_root = doc.file_path.parent
+            source_key = doc.file_path.name
+
+            targets = []
+            for inc in doc.includes:
+                try:
+                    rel_target = inc.target_path.relative_to(docs_root)
+                except ValueError:
+                    # Target outside docs_root — use filename only
+                    rel_target = inc.target_path.name
+                targets.append(str(rel_target))
+
+            if targets:
+                include_tree[source_key] = targets
+
+        return {"include_tree": include_tree, "cross_references": []}
+
     def _index_section(self, section: Section) -> list[str]:
         """Index a section and its children recursively.
 

src/docs/50-user-manual/20-mcp-tools.adoc

@@ -4,7 +4,7 @@
 
 == Overview
 
-dacli provides 9 MCP tools for interacting with documentation projects via the Model Context Protocol. These tools enable LLMs to navigate, read, search, and modify documentation.
+dacli provides 10 MCP tools for interacting with documentation projects via the Model Context Protocol. These tools enable LLMs to navigate, read, search, and modify documentation.
 
 == Navigation Tools
 
@@ -307,6 +307,29 @@ Get project or section metadata.
 }
 ----
 
+=== get_dependencies
+
+Get include dependencies between documentation files.
+
+.Parameters
+None
+
+.Returns
+[source,json]
+----
+{
+  "include_tree": {
+    "arc42.adoc": [
+      "chapters/01_introduction.adoc",
+      "chapters/02_constraints.adoc"
+    ]
+  },
+  "cross_references": []
+}
+----
+
+NOTE: `cross_references` is reserved for future use and currently returns an empty list.
+
 === validate_structure
 
 Validate the documentation structure.

src/docs/spec/02_api_specification.adoc

@@ -639,17 +639,28 @@ Retrieves metadata about the project or a specific section.
 
 '''
 
-==== get_dependencies (planned)
+==== get_dependencies
 
-[NOTE]
-====
-This tool is planned but not yet implemented.
-====
-
-Retrieves include dependencies and cross-references.
+Retrieves include dependencies between documentation files.
 
 **Use Case:** UC-06 (Extension)
 
+**Response 200:**
+[source,json]
+----
+{
+  "include_tree": {
+    "arc42.adoc": [
+      "chapters/01_introduction.adoc",
+      "chapters/02_constraints.adoc"
+    ]
+  },
+  "cross_references": []
+}
+----
+
+NOTE: `cross_references` is reserved for future use and currently returns an empty list.
+
 '''
 
 ==== validate_structure
@@ -749,6 +760,7 @@ Error responses are returned as dictionaries with an `error` key:
 | `validate_structure` | Validate document structure
 | `update_section` | Update section content
 | `insert_content` | Insert content before/after sections
+| `get_dependencies` | Get include dependencies
 |===
 
 .Planned Tools
@@ -757,7 +769,6 @@ Error responses are returned as dictionaries with an `error` key:
 | Tool | Description
 
 | `update_element` | Replace a specific element (code, table)
-| `get_dependencies` | Get include dependencies
 | `get_health` | Server health status
 | `reindex` | Trigger manual reindexing
 |===