carto-md 1.0.18 → 1.1.0

package/.carto/config.json

@@ -0,0 +1,79 @@
+{
+  "version": "1",
+  "framework": "node-generic",
+  "language": "javascript",
+  "projectRoot": "/Users/anshsonkar/carto-ansh",
+  "watch": {
+    "routeFiles": [
+      "src/agents/domains.js",
+      "src/agents/formatter.js",
+      "src/agents/merger.js",
+      "src/agents/validator.js",
+      "src/cli/impact.js",
+      "src/cli/index.js",
+      "src/cli/init.js",
+      "src/cli/remove.js",
+      "src/cli/sync.js",
+      "src/cli/update-check.js",
+      "src/cli/watch.js",
+      "src/detector/files.js",
+      "src/detector/framework.js",
+      "src/extractors/dbtables.js",
+      "src/extractors/envvars.js",
+      "src/extractors/filemap.js",
+      "src/extractors/frontend.js",
+      "src/extractors/functions.js",
+      "src/extractors/imports.js",
+      "src/extractors/languages/html.js",
+      "src/extractors/languages/javascript.js",
+      "src/extractors/languages/prisma.js",
+      "src/extractors/languages/python.js",
+      "src/extractors/languages/r.js",
+      "src/extractors/languages/typescript.js",
+      "src/extractors/loader.js",
+      "src/extractors/models.js",
+      "src/extractors/routes.js",
+      "src/extractors/stack.js",
+      "src/security/ignore.js",
+      "src/sync.js",
+      "src/watcher/watch.js"
+    ],
+    "modelFiles": [
+      "src/agents/domains.js",
+      "src/agents/formatter.js",
+      "src/agents/merger.js",
+      "src/agents/validator.js",
+      "src/cli/impact.js",
+      "src/cli/index.js",
+      "src/cli/init.js",
+      "src/cli/remove.js",
+      "src/cli/sync.js",
+      "src/cli/update-check.js",
+      "src/cli/watch.js",
+      "src/detector/files.js",
+      "src/detector/framework.js",
+      "src/extractors/dbtables.js",
+      "src/extractors/envvars.js",
+      "src/extractors/filemap.js",
+      "src/extractors/frontend.js",
+      "src/extractors/functions.js",
+      "src/extractors/imports.js",
+      "src/extractors/languages/html.js",
+      "src/extractors/languages/javascript.js",
+      "src/extractors/languages/prisma.js",
+      "src/extractors/languages/python.js",
+      "src/extractors/languages/r.js",
+      "src/extractors/languages/typescript.js",
+      "src/extractors/loader.js",
+      "src/extractors/models.js",
+      "src/extractors/routes.js",
+      "src/extractors/stack.js",
+      "src/security/ignore.js",
+      "src/sync.js",
+      "src/watcher/watch.js"
+    ],
+    "frontendFiles": []
+  },
+  "output": "AGENTS.md",
+  "generated": "2026-05-23T05:17:08.168Z"
+}

package/.carto/context/CORE.md

@@ -0,0 +1,253 @@
+# CORE (auto-generated by Carto)
+
+> Read this when working on core features.
+
+## Functions
+
+### src/agents/domains.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| getDomainForFile | relPath | — |
+| buildFileAssignments | allFiles, importGraph | — |
+| clusterByDomain | data | — |
+
+### src/agents/formatter.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| formatSections | {...} | — |
+| formatDomainFile | domainName, cluster | — |
+
+### src/agents/merger.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| mergeIntoAgentsMd | agentsPath, autoContent | — |
+
+### src/agents/validator.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| validateExtracted | {...} | — |
+| validateRoutes | routes | — |
+| validateModels | models | — |
+| validateFunctions | functionsMap | — |
+| validateEnvVars | envVars | — |
+| validateDBTables | dbTables | — |
+
+### src/cli/impact.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| run | projectRoot, fileArg | — |
+| resolveFile | fileArg, imports | — |
+| collectDependents | targetFile, imports, maxHops | — |
+
+### src/cli/index.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| printUsage | — | — |
+
+### src/cli/init.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| run | projectRoot | — |
+| resolveConfig | projectRoot, config | — |
+| installGitHook | projectRoot | — |
+| wireIDEs | projectRoot | — |
+
+### src/cli/remove.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| run | projectRoot | — |
+
+### src/cli/sync.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| run | projectRoot | — |
+
+### src/cli/update-check.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| checkForUpdate | — | — |
+| isNewer | a, b | — |
+
+### src/cli/watch.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| run | projectRoot | — |
+
+### src/detector/files.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| discoverFiles | projectRoot, framework, isIgnored, secondaryFramework | — |
+| discoverForFramework | projectRoot, framework, ignoreFn | — |
+| smartSelect | allFiles, htmlFiles, projectRoot | — |
+| isRouteFile | filePath | — |
+| isModelFile | filePath | — |
+| scoreRoute | filePath | — |
+| scoreModel | filePath | — |
+| countImportReferences | allFiles, projectRoot | — |
+| tryResolve | importPath, fileDir, projectRoot, knownPaths | — |
+| findFilesRecursive | dir, extensions, ignoreDirs, isIgnored, results | — |
+
+### src/detector/framework.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| detectFramework | projectRoot | — |
+| findFile | dir, fileNames, maxDepth, currentDepth | — |
+| detectAllFromPythonDeps | filePath | — |
+| detectAllFromPackageJson | filePath | — |
+| detectAllFromRDescription | filePath | — |
+| detectAllFromRFiles | projectRoot | — |
+
+### src/extractors/dbtables.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| extractDBTables | content | — |
+| toSnakeCase | str | — |
+
+### src/extractors/envvars.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| extractEnvVars | content | — |
+
+### src/extractors/filemap.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| inferResponsibility | filename, functionCount, routeCount | — |
+
+### src/extractors/frontend.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| extractFrontend | content | — |
+
+### src/extractors/functions.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| extractFunctions | content, filename | — |
+| splitParams | rawParams | — |
+
+### src/extractors/imports.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| extractImports | content, filePath, projectRoot | — |
+| extractJSImports | content | — |
+| extractRImports | content, filePath, projectRoot | — |
+| extractPythonImports | content, filePath, projectRoot | — |
+| tryResolvePythonModule | modulePath, baseDir | — |
+| resolvePythonRelativeImport | importStr, fileDir | — |
+| resolveImportPath | importPath, fileDir, projectRoot, sourceExt | — |
+| buildImportGraph | fileContents, projectRoot | — |
+
+### src/extractors/languages/javascript.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| walk | node, visitor | — |
+| extractExpressRoutes | ast, filename | — |
+| extractNextJSPagesRoutes | ast, filename | — |
+| extractJSFunctions | ast | — |
+| shouldSkipJSFunction | name, params | — |
+| extractParams | params | — |
+| extractProcessEnv | ast | — |
+| extractJSFetches | ast | — |
+
+### src/extractors/languages/r.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| pathToIdentifier | routePath | — |
+| descToIdentifier | desc | — |
+| extractRoutes | content | — |
+| extractFunctions | content | — |
+| collapseParens | content | — |
+| findBalancedEnd | str, openPos | — |
+| extractModels | content | — |
+| extractEnvVars | content | — |
+
+### src/extractors/languages/typescript.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| extractNextJSPagesRoutes | ast, filename | — |
+| walk | node, visitor | — |
+| extractTSFunctions | ast | — |
+| extractFuncFromNode | node, functions | — |
+| shouldSkip | name, params | — |
+| extractTSParams | params | — |
+| extractReturnType | funcNode | — |
+| typeToString | typeNode | — |
+| extractTSInterfaces | ast | — |
+
+### src/extractors/loader.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| loadLanguagePlugins | — | — |
+| getPluginForFile | plugins, filePath | — |
+
+### src/extractors/models.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| extractModels | content | — |
+
+### src/extractors/routes.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| collapseMultilineDecorators | content | — |
+| extractRoutes | content | — |
+
+### src/extractors/stack.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| detectStackFromContent | content, filename | — |
+| detectStackFromPackageJson | projectRoot | — |
+| detectStackFromRequirements | projectRoot | — |
+| buildStackLine | fileContents, projectRoot | — |
+| escapeRegex | str | — |
+
+### src/security/ignore.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| parseCartoIgnore | projectRoot | — |
+| matchPattern | str, pattern | — |
+
+### src/sync.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| safeReadFile | filePath, warnings | — |
+| scanStructure | basePath | — |
+| runFullSync | config | — |
+
+### src/watcher/watch.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| startWatcher | filePaths, onChange | — |
+
+## Files
+
+| File | Responsibility |
+|------|----------------|
+| src/agents/domains.js | AI/LLM integration |
+| src/agents/formatter.js | 2 functions |
+| src/agents/merger.js | 1 functions |
+| src/agents/validator.js | 6 functions |
+| src/cli/impact.js | 3 functions |
+| src/cli/index.js | 1 functions |
+| src/cli/init.js | 4 functions |
+| src/cli/remove.js | 1 functions |
+| src/cli/sync.js | 1 functions |
+| src/cli/update-check.js | Rule checks (2 functions) |
+| src/cli/watch.js | 1 functions |
+| src/detector/files.js | 10 functions |
+| src/detector/framework.js | 6 functions |
+| src/extractors/dbtables.js | Database operations |
+| src/extractors/envvars.js | 1 functions |
+| src/extractors/filemap.js | 1 functions |
+| src/extractors/frontend.js | 1 functions |
+| src/extractors/functions.js | 2 functions |
+| src/extractors/imports.js | 8 functions |
+| src/extractors/languages/html.js | AI/LLM integration |
+| src/extractors/languages/javascript.js | 8 functions |
+| src/extractors/languages/r.js | 8 functions |
+| src/extractors/languages/typescript.js | 9 functions |
+| src/extractors/loader.js | 2 functions |
+| src/extractors/models.js | Data models |
+| src/extractors/routes.js | 2 functions |
+| src/extractors/stack.js | 5 functions |
+| src/security/ignore.js | 2 functions |
+| src/sync.js | 3 functions |
+| src/watcher/watch.js | 1 functions |

package/.carto/context/DATABASE.md

@@ -0,0 +1,19 @@
+# DATABASE (auto-generated by Carto)
+
+> Read this when working on database features.
+
+## Functions
+
+### src/extractors/languages/prisma.js
+| Function | Params | Returns |
+|----------|--------|---------|
+| extractPrismaModels | content | — |
+| extractPrismaDBTables | content | — |
+| extractModelBlocks | content | — |
+| toSnakeCase | str | — |
+
+## Files
+
+| File | Responsibility |
+|------|----------------|
+| src/extractors/languages/prisma.js | 4 functions |

package/.carto/map.json

@@ -0,0 +1,83 @@
+{
+  "version": "1",
+  "generated": "2026-05-23T05:28:54.807Z",
+  "imports": {
+    "src/cli/index.js": [
+      "package.json",
+      "src/cli/impact.js",
+      "src/cli/init.js",
+      "src/cli/remove.js",
+      "src/cli/serve.js",
+      "src/cli/sync.js",
+      "src/cli/watch.js"
+    ],
+    "src/cli/init.js": [
+      "src/detector/files.js",
+      "src/detector/framework.js",
+      "src/security/ignore.js",
+      "src/sync.js"
+    ],
+    "src/cli/sync.js": [
+      "src/cli/init.js",
+      "src/cli/update-check.js",
+      "src/sync.js"
+    ],
+    "src/cli/update-check.js": [
+      "package.json"
+    ],
+    "src/cli/watch.js": [
+      "src/cli/init.js",
+      "src/cli/update-check.js",
+      "src/sync.js",
+      "src/watcher/watch.js"
+    ],
+    "src/extractors/languages/html.js": [
+      "src/extractors/frontend.js"
+    ],
+    "src/extractors/languages/python.js": [
+      "src/extractors/dbtables.js",
+      "src/extractors/envvars.js",
+      "src/extractors/functions.js",
+      "src/extractors/models.js",
+      "src/extractors/routes.js"
+    ],
+    "src/extractors/languages/typescript.js": [
+      "src/extractors/languages/javascript.js"
+    ],
+    "src/sync.js": [
+      "src/agents/domains.js",
+      "src/agents/formatter.js",
+      "src/agents/merger.js",
+      "src/agents/validator.js",
+      "src/extractors/filemap.js",
+      "src/extractors/imports.js",
+      "src/extractors/loader.js",
+      "src/extractors/stack.js"
+    ]
+  },
+  "routes": [],
+  "routesByFile": {},
+  "highImpact": [
+    {
+      "file": "src/cli/init.js",
+      "dependents": 3
+    },
+    {
+      "file": "src/sync.js",
+      "dependents": 3
+    },
+    {
+      "file": "package.json",
+      "dependents": 2
+    },
+    {
+      "file": "src/cli/update-check.js",
+      "dependents": 2
+    }
+  ],
+  "entryPoints": [
+    "src/cli/index.js",
+    "src/extractors/languages/python.js"
+  ],
+  "stack": []
+}

package/AGENTS.md

@@ -0,0 +1,37 @@
+<!-- CARTO:AUTO:START -->
+## Project Structure (auto)
+
+- 📁 .kiro/
+- 📁 src/
+- 📁 test/
+- 📄 .cartoignore
+- 📄 .DS_Store
+- 📄 .gitignore
+- 📄 .npmignore
+- 📄 CARTO_BRAIN.md
+- 📄 CONTRIBUTING.md
+- 📄 LICENSE
+- 📄 mcp.md
+- 📄 package-lock.json
+- 📄 package.json
+- 📄 PROGRESS.md
+- 📄 README.md
+**Entry points:** src/cli/index.js, src/extractors/languages/python.js
+**High impact:** src/cli/init.js (3 dependents), src/sync.js (3 dependents), package.json (2 dependents), src/cli/update-check.js (2 dependents)
+
+## Context Files (auto)
+
+Carto generated domain-specific context files in `.carto/context/`.
+Read the relevant file before working on that area:
+
+| Domain | File | Read when... |
+|--------|------|--------------|
+| Auth | `.carto/context/AUTH.md` | Working on login, sessions, OAuth |
+| Payments | `.carto/context/PAYMENTS.md` | Working on billing, Stripe |
+| tRPC | `.carto/context/TRPC.md` | Working on API procedures |
+| Database | `.carto/context/DATABASE.md` | Working on models, schema |
+| Events | `.carto/context/EVENTS.md` | Working on webhooks, jobs |
+| Core | `.carto/context/CORE.md` | General utilities, shared code |
+
+> Run `carto serve` to enable live graph queries from Kiro, Cursor, and Claude.
+<!-- CARTO:AUTO:END -->

package/CONTRIBUTING.md

@@ -8,9 +8,9 @@ Carto is free, open source, and community-maintained. The core team owns the mer
 
 ### Tier 1 — Languages (safe to add, easy to review)
 
-New language support lives in `src/ast/languages/`. Each language is an isolated module.
+New language support lives in `src/extractors/languages/`. Each language is an isolated module.
 
-Currently supported: JavaScript/TypeScript, Python.
+Currently supported: JavaScript/TypeScript, Python, R.
 
 Wanted: Go, Rust, Ruby, Java, PHP, C#.
 
@@ -18,7 +18,7 @@ Wanted: Go, Rust, Ruby, Java, PHP, C#.
 
 Framework-specific route and model extraction lives in `src/extractors/`. Each framework is an isolated module.
 
-Currently supported: FastAPI, Express, Next.js App Router, Prisma, HTML fetch().
+Currently supported: FastAPI, Express, Next.js App Router, Prisma, HTML fetch(), Plumber, Shiny.
 
 Wanted: Django, Rails, Laravel, NestJS, Hono, Gin, Spring.
 
@@ -38,10 +38,10 @@ Wanted: Django, Rails, Laravel, NestJS, Hono, Gin, Spring.
 3. Return:
 ```js
 {
-  functions: [{ name, params, returns }],
-  classes: [{ name, fields }],
-  imports: [{ from, symbols }],
-  exports: [{ name }]
+  routes: [{ method, path, functionName }],
+  models: [{ className, fields: [{ name, type }] }],
+  functions: [{ name, params }],
+  envVars: ['VAR_NAME']
 }
 ```
 4. Add it to `src/extractors/loader.js` language map
@@ -81,7 +81,7 @@ Wanted: Django, Rails, Laravel, NestJS, Hono, Gin, Spring.
 
 ```bash
 git clone https://github.com/theanshsonkar/carto
-cd carto-ansh
+cd carto
 npm install
 node src/cli/index.js init   # test in any project
 ```

package/README.md

@@ -135,14 +135,13 @@ npx carto-md init
 # 1. Go to your project
 cd your-project
 
-# 2. Generate AGENTS.md (run once)
+# 2. Run once — like git init
 carto init
-
-# 3. Keep it live while you work
-carto watch
 ```
 
-Leave `carto watch` running in a background terminal. Every file save updates AGENTS.md automatically.
+That's it. Carto installs a git hook. Every `git commit` syncs AGENTS.md automatically — no watching, no manual runs, nothing to remember.
+
+Want live updates on every file save too? Run `carto watch` in a background terminal.
 
 ---
 
@@ -150,17 +149,17 @@ Leave `carto watch` running in a background terminal. Every file save updates AG
 
 | Command | What it does |
 |---------|-------------|
-| `carto init` | Detect stack, generate AGENTS.md, install git hook |
-| `carto watch` | Watch files, update AGENTS.md on every save |
-| `carto sync` | One-time refresh, no watcher |
+| `carto init` | Detect stack, generate AGENTS.md, install git hook — auto-syncs on every commit |
+| `carto watch` | Live updates on every file save — optional, for between commits |
+| `carto sync` | One-time manual refresh |
 | `carto impact <file>` | Show blast radius before touching a file |
 | `carto remove` | Remove AGENTS.md and .carto/ from this project |
 | `carto --version` | Show version |
 
 **When to use each:**
-- `init` — once, when you add Carto to a project
-- `watch` — every work session, leave it running
-- `sync` — skipped watch and need a fresh snapshot
+- `init` — once per project, sets everything up
+- `watch` — optional, if you want updates between commits
+- `sync` — if you skipped watch and need a fresh snapshot
 - `impact` — before editing anything critical
 
 ---
@@ -172,7 +171,7 @@ Leave `carto watch` running in a background terminal. Every file save updates AG
 | Python | FastAPI, Pydantic |
 | JavaScript | Express, Next.js |
 | TypeScript | Express, Next.js, Prisma |
-| R | Plumber, Shiny |
+| R | Plumber, Shiny, R6, S7 |
 | HTML | fetch() calls |
 
 More languages via community — open an issue or see [CONTRIBUTING.md](CONTRIBUTING.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carto-md",
-  "version": "1.0.18",
+  "version": "1.1.0",
   "description": "The context layer for AI-native development.",
   "bin": {
     "carto": "src/cli/index.js"
@@ -11,6 +11,7 @@
   },
   "dependencies": {
     "@babel/parser": "^7.29.3",
+    "@modelcontextprotocol/sdk": "^1.0.0",
     "chokidar": "^3.6.0"
   },
   "engines": {