carto-md 2.0.9 → 2.1.0

package/docs/api/get_context.md

@@ -0,0 +1,34 @@
+# `get_context`
+
+Get full structural context for a file: domain, blast radius, import neighbors, routes, models, env vars, and cross-domain dependencies. Single call for everything.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string",
+      "description": "Relative file path from project root"
+    }
+  },
+  "required": [
+    "file"
+  ]
+}
+```
+
+## Required arguments
+
+- `file`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string | Relative file path from project root |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_conventions.md

@@ -0,0 +1,32 @@
+# `get_conventions`
+
+Naming + export + directory conventions that apply to a given file or directory. Confidence-scored. Use before writing new code in this location.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string",
+      "description": "Relative file path or directory."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string | Relative file path or directory. |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_cross_domain.md

@@ -0,0 +1,25 @@
+# `get_cross_domain`
+
+Get all import edges that cross domain boundaries — e.g. AUTH importing PAYMENTS. Use to detect unexpected coupling.
+
+## 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_cross_language_call_graph.md

@@ -0,0 +1,25 @@
+# `get_cross_language_call_graph`
+
+Match frontend HTTP fetches (fetch / axios / jQuery) to backend route handlers. Returns caller→callee pairs across language boundaries.
+
+## 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_cross_repo_blast_radius.md

@@ -0,0 +1,34 @@
+# `get_cross_repo_blast_radius`
+
+Direct downstream consumers of a producer repo. "If I break repo X, who notices?"
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "repo": {
+      "type": "string",
+      "description": "Producer repo name"
+    }
+  },
+  "required": [
+    "repo"
+  ]
+}
+```
+
+## Required arguments
+
+- `repo`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `repo` | string | Producer repo name |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_cross_team_coupling.md

@@ -0,0 +1,25 @@
+# `get_cross_team_coupling`
+
+Cross-domain edges where the source-file owner differs from the target-file owner — surface for coordination warnings.
+
+## 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_data_flow.md

@@ -0,0 +1,33 @@
+# `get_data_flow`
+
+Per-file data-flow snapshot: upstream imports + downstream importers + routes + models + env vars in the file. The AI-friendly view, not full taint analysis.
+
+## 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_dead_code_with_confidence.md

@@ -0,0 +1,32 @@
+# `get_dead_code_with_confidence`
+
+Files with zero static dependents AND (when runtime data is supplied) zero observed runtime hits. The "safe to delete" list.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "otlp_path": {
+      "type": "string",
+      "description": "Optional OTLP file for runtime confirmation."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `otlp_path` | string | Optional OTLP file for runtime confirmation. |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_decision_log.md

@@ -0,0 +1,32 @@
+# `get_decision_log`
+
+Recent decisions from the episodic-memory log, optionally annotated with concurrent architectural events from the temporal store.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "hours": {
+      "type": "number",
+      "description": "Lookback hours (default 168 = 7d)."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `hours` | number | Lookback hours (default 168 = 7d). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_dependency_surface.md

@@ -0,0 +1,25 @@
+# `get_dependency_surface`
+
+Deduped external dependencies + pinned versions across package.json, pyproject.toml, go.mod, etc. The "what does this project depend on" view.
+
+## 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_domain.md

@@ -0,0 +1,34 @@
+# `get_domain`
+
+Get all routes, models, functions, and context for a specific domain (AUTH, PAYMENTS, TRPC, DATABASE, EVENTS, NOTIFICATIONS, CORE).
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "domain": {
+      "type": "string",
+      "description": "Domain name e.g. AUTH, PAYMENTS, DATABASE"
+    }
+  },
+  "required": [
+    "domain"
+  ]
+}
+```
+
+## Required arguments
+
+- `domain`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `domain` | string | Domain name e.g. AUTH, PAYMENTS, DATABASE |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_domain_evolution.md

@@ -0,0 +1,39 @@
+# `get_domain_evolution`
+
+Time-series of a single domain's file count, by snapshot. Use to chart a domain's growth over the last quarter.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "domain": {
+      "type": "string",
+      "description": "Domain name (e.g. AUTH)."
+    },
+    "time_range": {
+      "type": "string",
+      "description": "Window like \"30d\", \"90d\" (default \"90d\")."
+    }
+  },
+  "required": [
+    "domain"
+  ]
+}
+```
+
+## Required arguments
+
+- `domain`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `domain` | string | Domain name (e.g. AUTH). |
+| `time_range` | string | Window like "30d", "90d" (default "90d"). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_domain_health.md

@@ -0,0 +1,32 @@
+# `get_domain_health`
+
+Per-domain growth rate, instability, recent events, and hotspot files. Use to spot domains drifting out of bounds.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "domain": {
+      "type": "string",
+      "description": "Optional domain filter."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `domain` | string | Optional domain filter. |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_domains_list.md

@@ -0,0 +1,25 @@
+# `get_domains_list`
+
+Get all detected domains with file counts, route counts, and model counts.
+
+## 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_drift_digest.md

@@ -0,0 +1,32 @@
+# `get_drift_digest`
+
+Weekly architectural digest: domain drift, hotspots, events, predicted-risk top 10. CLI-renderable markdown.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "time_range": {
+      "type": "string",
+      "description": "Window like \"7d\", \"30d\" (default \"7d\")."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `time_range` | string | Window like "7d", "30d" (default "7d"). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_env_vars.md

@@ -0,0 +1,32 @@
+# `get_env_vars`
+
+Get all environment variables used in this project, with which files use them and which domains they belong to.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "domain": {
+      "type": "string",
+      "description": "Optional domain filter e.g. AUTH, PAYMENTS"
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `domain` | string | Optional domain filter e.g. AUTH, PAYMENTS |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_evolution_delta.md

@@ -0,0 +1,36 @@
+# `get_evolution_delta`
+
+Architectural delta across a time window (requires temporal store). Returns per-domain before/after file counts + event count.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "domain": {
+      "type": "string"
+    },
+    "time_range": {
+      "type": "string",
+      "description": "Window like \"30d\", \"90d\" (default \"30d\")."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `domain` | string |  |
+| `time_range` | string | Window like "30d", "90d" (default "30d"). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_file_ownership.md

@@ -0,0 +1,33 @@
+# `get_file_ownership`
+
+Implicit ownership detection via `git blame`. Returns top author + per-author line counts. Fails soft if git is unavailable.
+
+## 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_file_summary.md

@@ -0,0 +1,34 @@
+# `get_file_summary`
+
+Get a 3-sentence description of what a file does, its role in the project, and its key dependencies and dependents.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string",
+      "description": "Relative file path from project root"
+    }
+  },
+  "required": [
+    "file"
+  ]
+}
+```
+
+## Required arguments
+
+- `file`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string | Relative file path from project root |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_high_impact_files.md

@@ -0,0 +1,32 @@
+# `get_high_impact_files`
+
+Get the files with the highest blast radius — most other files depend on them. Changing these files is highest risk.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "limit": {
+      "type": "number",
+      "description": "Number of files to return (default 10)"
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `limit` | number | Number of files to return (default 10) |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_hot_in_prod_no_tests.md

@@ -0,0 +1,34 @@
+# `get_hot_in_prod_no_tests`
+
+Files whose routes receive >0 runtime hits but have no detected test file. The "ship a test here first" list.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "otlp_path": {
+      "type": "string",
+      "description": "Path to OTLP file (required)."
+    }
+  },
+  "required": [
+    "otlp_path"
+  ]
+}
+```
+
+## Required arguments
+
+- `otlp_path`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `otlp_path` | string | Path to OTLP file (required). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)