carto-md 2.0.8 → 2.1.0

package/docs/api/get_models.md

@@ -0,0 +1,32 @@
+# `get_models`
+
+Get all data models (Prisma, Pydantic, TypeScript interfaces, Zod schemas) across the project, optionally filtered by domain.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "domain": {
+      "type": "string",
+      "description": "Optional domain filter e.g. AUTH, DATABASE"
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `domain` | string | Optional domain filter e.g. AUTH, DATABASE |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_neighbors.md

@@ -0,0 +1,39 @@
+# `get_neighbors`
+
+Get import graph neighbors of a file — files it imports and files that import it. Returns nodes and edges for visualization.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string",
+      "description": "Relative file path from project root"
+    },
+    "hops": {
+      "type": "number",
+      "description": "How many hops to traverse (default 1, max 3)"
+    }
+  },
+  "required": [
+    "file"
+  ]
+}
+```
+
+## Required arguments
+
+- `file`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string | Relative file path from project root |
+| `hops` | number | How many hops to traverse (default 1, max 3) |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_org_architecture.md

@@ -0,0 +1,25 @@
+# `get_org_architecture`
+
+Org-wide summary: registered repos + total cross-repo edge count + edges by kind. Requires `carto org init` + `carto org sync`.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_org_domain_mapping.md

@@ -0,0 +1,25 @@
+# `get_org_domain_mapping`
+
+Per-repo domain list across all org repos (reads each repo's carto.db if registered).
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_pending_decisions.md

@@ -0,0 +1,32 @@
+# `get_pending_decisions`
+
+Recent decisions with pending/unresolved/HIGH-risk flags in their payload. Surfaces unfinished AI work from the episodic log.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "hours": {
+      "type": "number",
+      "description": "Lookback window in hours (default 6)."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `hours` | number | Lookback window in hours (default 6). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_predictive_risk.md

@@ -0,0 +1,32 @@
+# `get_predictive_risk`
+
+Predictive risk score per file: P(this file causes the next incident). Combines blast radius, churn, cross-domain coupling, intervention history, test presence into a 0-1 score.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string",
+      "description": "Optional single-file filter; otherwise scores all files."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string | Optional single-file filter; otherwise scores all files. |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_progressive_disclosure_tree.md

@@ -0,0 +1,25 @@
+# `get_progressive_disclosure_tree`
+
+Pre-computed hierarchy: domain → top files per domain → per-file exports. Use as a structured table-of-contents for the codebase before drilling in.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_recent_decisions.md

@@ -0,0 +1,37 @@
+# `get_recent_decisions`
+
+List recent validation decisions and architectural choices the AI has made in this project. Returns time-descending rows.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "time_range": {
+      "type": "string",
+      "description": "Time window like \"7d\", \"24h\", \"1h\" (default \"7d\")."
+    },
+    "kind": {
+      "type": "string",
+      "description": "Optional filter — e.g. \"validation\"."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `time_range` | string | Time window like "7d", "24h", "1h" (default "7d"). |
+| `kind` | string | Optional filter — e.g. "validation". |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_risk_weighted_blast_radius.md

@@ -0,0 +1,32 @@
+# `get_risk_weighted_blast_radius`
+
+Combine static dependents with runtime call counts (from ingest_otlp_traces or similar) to rank routes by real-world risk. `risk = dependents × runtime_calls + dependents`.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "otlp_path": {
+      "type": "string",
+      "description": "Optional OTLP file for runtime data."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `otlp_path` | string | Optional OTLP file for runtime data. |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_routes.md

@@ -0,0 +1,25 @@
+# `get_routes`
+
+Get all API routes in this project including REST, tRPC, and webhooks.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_safety_checklist.md

@@ -0,0 +1,33 @@
+# `get_safety_checklist`
+
+Per-file safety checklist: blast radius, cross-domain coupling, missing tests, temporal hotspot, unresolved interventions. Run before writing a high-impact change.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "file"
+  ]
+}
+```
+
+## Required arguments
+
+- `file`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string |  |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_semantic_diff.md

@@ -0,0 +1,34 @@
+# `get_semantic_diff`
+
+Beyond line-by-line: detect renames, symbol relocations across files, and new-domain introductions from a unified diff.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "diff": {
+      "type": "string",
+      "description": "Unified diff text."
+    }
+  },
+  "required": [
+    "diff"
+  ]
+}
+```
+
+## Required arguments
+
+- `diff`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `diff` | string | Unified diff text. |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_service_boundary_violations.md

@@ -0,0 +1,25 @@
+# `get_service_boundary_violations`
+
+Cross-repo edges that import private/internal surface (heuristic: target path contains internal / private / _lib).
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_service_dependency_graph.md

@@ -0,0 +1,25 @@
+# `get_service_dependency_graph`
+
+Aggregated cross-repo graph: each repo is a node, edges grouped by (from_repo, to_repo, edge_kind).
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_session_context.md

@@ -0,0 +1,32 @@
+# `get_session_context`
+
+Full context for an AI session: every decision and every intervention, ordered chronologically. Use to recap what happened in a long-running session.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "session_id": {
+      "type": "number",
+      "description": "Session id. Defaults to the most recent active session."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `session_id` | number | Session id. Defaults to the most recent active session. |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_similar_patterns.md

@@ -0,0 +1,39 @@
+# `get_similar_patterns`
+
+Given a file, find structurally similar files — same import pattern, same route shape, or same domain. Use to find conventions to follow before writing new code.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string",
+      "description": "Relative file path from project root"
+    },
+    "limit": {
+      "type": "number",
+      "description": "Max results to return (default 5)"
+    }
+  },
+  "required": [
+    "file"
+  ]
+}
+```
+
+## Required arguments
+
+- `file`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string | Relative file path from project root |
+| `limit` | number | Max results to return (default 5) |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_stale_docs.md

@@ -0,0 +1,25 @@
+# `get_stale_docs`
+
+Docs/markdown files older than 30 days. Heuristic surface for documentation that probably needs refresh.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_structure.md

@@ -0,0 +1,25 @@
+# `get_structure`
+
+Get project structure: import graph, entry points, high impact files, tech stack, and domains.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_temporal_context.md

@@ -0,0 +1,34 @@
+# `get_temporal_context`
+
+A file's full temporal context: first_seen_ts, last_modified_ts, commit_count, blast_radius, recent events, age in days.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string",
+      "description": "Relative file path."
+    }
+  },
+  "required": [
+    "file"
+  ]
+}
+```
+
+## Required arguments
+
+- `file`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string | Relative file path. |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_test_coverage_map.md

@@ -0,0 +1,25 @@
+# `get_test_coverage_map`
+
+Surfaces files with no detected test alongside their blast radius. High-blast untested files are the riskiest.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_token_budget_report.md

@@ -0,0 +1,36 @@
+# `get_token_budget_report`
+
+Diagnostic complement to get_minimal_context_for_intent. Returns context efficiency as a fraction of repo size (used / total tokens approx).
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "intent": {
+      "type": "string",
+      "description": "Intent to budget for."
+    },
+    "budget_tokens": {
+      "type": "number"
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `intent` | string | Intent to budget for. |
+| `budget_tokens` | number |  |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_upgrade_risk.md

@@ -0,0 +1,25 @@
+# `get_upgrade_risk`
+
+Cross-references each external dep against the import graph. Returns usage count + domain count + LOW/MEDIUM/HIGH risk per dep. Use before bumping a dep version.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {},
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+_None._
+
+## See also
+
+- [Index of all MCP tools](./README.md)