carto-md 2.0.8 → 2.1.0

package/docs/api/get_active_drift.md

@@ -0,0 +1,32 @@
+# `get_active_drift`
+
+Domains with active drift in the last 7d: growth, threshold breaches. Use to spot domains drifting before they reach a critical event.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "threshold": {
+      "type": "number",
+      "description": "Drift threshold 0-1 (default 0.2 = 20%)."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `threshold` | number | Drift threshold 0-1 (default 0.2 = 20%). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_active_suggestions.md

@@ -0,0 +1,25 @@
+# `get_active_suggestions`
+
+Active Suggestion Engine output. 4 triggers: cross-domain coupling jump, AI session conflict, convention violation mid-session, hotspot threshold crossed. Read periodically.
+
+## 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_ai_cost_attribution.md

@@ -0,0 +1,32 @@
+# `get_ai_cost_attribution`
+
+Per-AI-client decision counts + violation counts. Use to attribute cross-domain coupling cost to individual AI sessions / developers.
+
+## 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_arch_events.md

@@ -0,0 +1,42 @@
+# `get_arch_events`
+
+Architectural events (domain split, merge, growth, hotspot emergence). Severity filter: minor | major | critical.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "severity": {
+      "type": "string",
+      "description": "Filter: minor | major | critical."
+    },
+    "kind": {
+      "type": "string",
+      "description": "Optional kind filter (e.g. domain_growth, hotspot_active)."
+    },
+    "time_range": {
+      "type": "string",
+      "description": "Window like \"90d\" (default \"90d\")."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `severity` | string | Filter: minor \| major \| critical. |
+| `kind` | string | Optional kind filter (e.g. domain_growth, hotspot_active). |
+| `time_range` | string | Window like "90d" (default "90d"). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_architectural_drift.md

@@ -0,0 +1,37 @@
+# `get_architectural_drift`
+
+Per-domain growth/shrink and event count over a time window. Run `carto temporal init` first to backfill from git history.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "domain": {
+      "type": "string",
+      "description": "Optional domain filter (e.g. AUTH)."
+    },
+    "time_range": {
+      "type": "string",
+      "description": "Window like \"30d\", \"90d\", \"1y\" (default \"30d\")."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `domain` | string | Optional domain filter (e.g. AUTH). |
+| `time_range` | string | Window like "30d", "90d", "1y" (default "30d"). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_architecture.md

@@ -0,0 +1,25 @@
+# `get_architecture`
+
+Get a 500-word markdown summary of the project: domains, entry points, tech stack, key patterns, and size metrics. Use this as your first call when entering a new repo.
+
+## 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_blast_radius.md

@@ -0,0 +1,34 @@
+# `get_blast_radius`
+
+Get all files, routes, and domains affected by changing a specific file. Includes risk level per route.
+
+## 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_canonical_pattern.md

@@ -0,0 +1,39 @@
+# `get_canonical_pattern`
+
+Highest-quality example of a pattern in the codebase (e.g. canonical route handler). Use as a copy-paste template before writing similar code.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "pattern_type": {
+      "type": "string",
+      "description": "route_handler | model_definition"
+    },
+    "domain": {
+      "type": "string",
+      "description": "Optional domain filter."
+    }
+  },
+  "required": [
+    "pattern_type"
+  ]
+}
+```
+
+## Required arguments
+
+- `pattern_type`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `pattern_type` | string | route_handler \| model_definition |
+| `domain` | string | Optional domain filter. |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_change_plan.md

@@ -0,0 +1,34 @@
+# `get_change_plan`
+
+Given a natural-language intent (e.g. "add rate limiting to /api/users"), returns: files to touch, domains affected, blast radius, and similar patterns in the codebase.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "intent": {
+      "type": "string",
+      "description": "Natural language description of the change you want to make"
+    }
+  },
+  "required": [
+    "intent"
+  ]
+}
+```
+
+## Required arguments
+
+- `intent`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `intent` | string | Natural language description of the change you want to make |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_change_velocity.md

@@ -0,0 +1,32 @@
+# `get_change_velocity`
+
+Commits-per-day over a window (requires temporal store). Useful for spotting development tempo shifts.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "days": {
+      "type": "number",
+      "description": "Lookback days (default 30)."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `days` | number | Lookback days (default 30). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_churn_vs_blast_radius.md

@@ -0,0 +1,32 @@
+# `get_churn_vs_blast_radius`
+
+Scatter data of churn vs blast_radius for every changed file in a window. Use to find risk hotspots.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "time_range": {
+      "type": "string",
+      "description": "Window like \"90d\" (default \"90d\")."
+    }
+  },
+  "required": []
+}
+```
+
+## Required arguments
+
+_None._
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `time_range` | string | Window like "90d" (default "90d"). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

package/docs/api/get_complexity_trend.md

@@ -0,0 +1,39 @@
+# `get_complexity_trend`
+
+A single file's presence across snapshots + commit count + current blast_radius. Use to track how a file's footprint evolved.
+
+## Input schema
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "string",
+      "description": "Relative file path."
+    },
+    "time_range": {
+      "type": "string",
+      "description": "Window like \"90d\" (default \"90d\")."
+    }
+  },
+  "required": [
+    "file"
+  ]
+}
+```
+
+## Required arguments
+
+- `file`
+
+## Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `file` | string | Relative file path. |
+| `time_range` | string | Window like "90d" (default "90d"). |
+
+## See also
+
+- [Index of all MCP tools](./README.md)

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)