carto-md 2.0.9 → 2.1.1

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_receipts.md

@@ -0,0 +1,34 @@
+# `get_file_receipts`
+
+For one file, returns receipts — everything Carto knows: change history, blast radius, prior interventions and decisions touching this file, active gaps on this file, cross-domain deps. Read-only. Use before proposing a change to a file to understand what depends on it and what has been said about it before.
+
+## 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_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_gaps.md

@@ -0,0 +1,52 @@
+# `get_gaps`
+
+The current gap list for this repo — grounded findings from the rule engine ("SHOULD − IS"). Each gap ties to a file + rule_id + evidence. Ranked HIGH > MEDIUM > LOW. Dismissed gaps are excluded by default. Call this when the user asks "what should I fix?", when you enter a new repo for the first time, or before recommending changes to a file. If the response is empty and the project is unsupported, tell the user the rule engine only ships for Next.js + Supabase SaaS-with-auth today.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "rule_id": {
+      "type": "string",
+      "description": "Optional rule filter, e.g. \"money-as-float\"."
+    },
+    "file": {
+      "type": "string",
+      "description": "Optional file filter."
+    },
+    "severity": {
+      "type": "string",
+      "description": "Optional severity filter: HIGH | MEDIUM | LOW."
+    },
+    "include_dismissed": {
+      "type": "boolean",
+      "description": "Include gaps the user has already dismissed (default false)."
+    },
+    "refresh": {
+      "type": "boolean",
+      "description": "Re-run the rule engine before returning (default false — uses last cached run)."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `rule_id` | string | Optional rule filter, e.g. "money-as-float". |
+| `file` | string | Optional file filter. |
+| `severity` | string | Optional severity filter: HIGH \| MEDIUM \| LOW. |
+| `include_dismissed` | boolean | Include gaps the user has already dismissed (default false). |
+| `refresh` | boolean | Re-run the rule engine before returning (default false — uses last cached run). |
+
+## 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)

package/docs/api/get_hotspot_files.md

@@ -0,0 +1,39 @@
+# `get_hotspot_files`
+
+> ⚠️ **Deprecated (CF-7).** Use `history(view="hotspots")` instead. This name still resolves and returns byte-identical output for a deprecation window, but is no longer listed by default and emits a one-line notice.
+
+Top files by churn × blast_radius score over a window. The CodeHealth heuristic: high-churn files in high-blast-radius positions are where bugs cluster.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "time_range": {
+      "type": "string",
+      "description": "Window like \"30d\", \"90d\" (default \"90d\")."
+    },
+    "limit": {
+      "type": "number",
+      "description": "Max rows (default 20)."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `time_range` | string | Window like "30d", "90d" (default "90d"). |
+| `limit` | number | Max rows (default 20). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_iac_resources.md

@@ -0,0 +1,25 @@
+# `get_iac_resources`
+
+Surface Terraform / Helm / Pulumi / AWS CDK resources discovered in the repo. Returns kind, name, file, dependencies.
+
+## 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_intent.md

@@ -0,0 +1,25 @@
+# `get_intent`
+
+Return the currently stored intent — product type, stack, notes, updated_at. Use this at the start of a session to know which rules will apply to this project.
+
+## 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_interface_contract.md

@@ -0,0 +1,33 @@
+# `get_interface_contract`
+
+Exported symbols + models + routes the file exposes. Use to understand a module's public API before consuming it.
+
+## 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_intervention_history.md

@@ -0,0 +1,34 @@
+# `get_intervention_history`
+
+> ⚠️ **Deprecated (CF-7).** Use `memory(kind="interventions")` instead. This name still resolves and returns byte-identical output for a deprecation window, but is no longer listed by default and emits a one-line notice.
+
+List interventions (Carto-issued violations and suggestions) optionally filtered by file. Use to see prior warnings on a file before editing it.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string",
+      "description": "Optional file filter (relative path from project root)."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string | Optional file filter (relative path from project root). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_invariants.md

@@ -0,0 +1,39 @@
+# `get_invariants`
+
+> ⚠️ **Deprecated (CF-7).** Use `patterns(kind="invariants")` instead. This name still resolves and returns byte-identical output for a deprecation window, but is no longer listed by default and emits a one-line notice.
+
+Architectural invariants mined from the import graph: "Domain X never imports from Y", "Files in Z always export N symbols", etc. Confidence-scored.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "domain": {
+      "type": "string",
+      "description": "Optional domain filter."
+    },
+    "threshold": {
+      "type": "number",
+      "description": "Confidence threshold 0-1 (default 0.85)."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `domain` | string | Optional domain filter. |
+| `threshold` | number | Confidence threshold 0-1 (default 0.85). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_llm_enrichment.md

@@ -0,0 +1,33 @@
+# `get_llm_enrichment`
+
+Per-node summary via a local LLM. Opt-in only; returns disabled stub until `ai.llm` is wired in carto.config.json.
+
+## 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_microservice_cut_points.md

@@ -0,0 +1,32 @@
+# `get_microservice_cut_points`
+
+Natural microservice cut-points: domains with high cohesion (intra-edges) AND low external coupling. Use to plan extraction-style refactors.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "threshold": {
+      "type": "number",
+      "description": "Cohesion threshold 0-1 (default 0.7)."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `threshold` | number | Cohesion threshold 0-1 (default 0.7). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_microservices_migration_cut_points.md

@@ -0,0 +1,27 @@
+# `get_microservices_migration_cut_points`
+
+> ⚠️ **Deprecated (CF-7).** Use `org(view="migration")` instead. This name still resolves and returns byte-identical output for a deprecation window, but is no longer listed by default and emits a one-line notice.
+
+Suggested microservices extraction order. Repos with high stability (more incoming than outgoing edges) extract first.
+
+## 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_minimal_context_for_intent.md

@@ -0,0 +1,39 @@
+# `get_minimal_context_for_intent`
+
+Token-budgeted context picker. Given a natural-language intent + a budget (default 4000 tokens), returns the minimum file set needed via hybrid retrieval (structural + lexical + semantic) with RRF fusion and high-blast / same-domain / recent-changes boosts. Reports per-file token cost.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "intent": {
+      "type": "string",
+      "description": "Natural-language description of the change."
+    },
+    "budget_tokens": {
+      "type": "number",
+      "description": "Token budget (default 4000)."
+    }
+  },
+  "required": [
+    "intent"
+  ]
+}
+```
+
+## Required arguments
+
+- `intent`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `intent` | string | Natural-language description of the change. |
+| `budget_tokens` | number | Token budget (default 4000). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)