carto-md 1.0.14 → 1.0.16

package/CONTRIBUTING.md

@@ -33,7 +33,7 @@ Wanted: Django, Rails, Laravel, NestJS, Hono, Gin, Spring.
 
 ## How to add a language
 
-1. Create `src/ast/languages/yourlanguage.js`
+1. Create `src/extractors/languages/yourlanguage.js`
 2. Export a single function: `extractFromFile(filePath, fileContent)`
 3. Return:
 ```js
@@ -44,7 +44,7 @@ Wanted: Django, Rails, Laravel, NestJS, Hono, Gin, Spring.
   exports: [{ name }]
 }
 ```
-4. Add it to `src/ast/parser.js` language map
+4. Add it to `src/extractors/loader.js` language map
 5. Test on at least 3 real open-source projects
 6. Open a PR with before/after AGENTS.md examples
 
@@ -80,7 +80,7 @@ Wanted: Django, Rails, Laravel, NestJS, Hono, Gin, Spring.
 ## Development setup
 
 ```bash
-git clone https://github.com/anshsonkar/carto-ansh
+git clone https://github.com/theanshsonkar/carto
 cd carto-ansh
 npm install
 node src/cli/index.js init   # test in any project
@@ -95,7 +95,7 @@ node src/cli/index.js init   # test in any project
 - [ ] No changes to merger logic (unless explicitly fixing a merger bug)
 - [ ] No network calls added
 - [ ] `carto --version` still works
-- [ ] Existing tests pass
+- [ ] `npm test` passes
 
 ---
 

package/README.md

@@ -52,6 +52,8 @@ Same task, two Claude sessions: *"Add a `notes` field to the booking model."*
 
 Not smarter AI. The same AI with accurate facts.
 
+*Stress tested on cal.com (5,018 files): 87% route coverage, 100% model field accuracy, import graph with zero phantom links.*
+
 ---
 
 ## Know what breaks before you break it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carto-md",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "The context layer for AI-native development.",
   "bin": {
     "carto": "src/cli/index.js"

package/src/cli/sync.js

@@ -2,8 +2,10 @@ const fs = require('fs');
 const path = require('path');
 const { runFullSync } = require('../sync');
 const { resolveConfig } = require('./init');
+const { checkForUpdate } = require('./update-check');
 
 async function run(projectRoot) {
+  checkForUpdate(); // fire and forget
   const configPath = path.join(projectRoot, '.carto', 'config.json');
 
   if (!fs.existsSync(configPath)) {

package/src/cli/update-check.js

@@ -0,0 +1,48 @@
+const https = require('https');
+const pkg = require('../../package.json');
+
+/**
+ * Fire-and-forget version check against the npm registry.
+ * Prints a one-liner to stderr if a newer version exists.
+ * Never throws, never blocks — safe to call without await.
+ */
+function checkForUpdate() {
+  const req = https.get('https://registry.npmjs.org/carto-md/latest', {
+    timeout: 3000,
+  }, (res) => {
+    let body = '';
+    res.on('data', (chunk) => { body += chunk; });
+    res.on('end', () => {
+      try {
+        const data = JSON.parse(body);
+        const latest = data.version;
+        if (latest && latest !== pkg.version && isNewer(latest, pkg.version)) {
+          process.stderr.write(
+            `[CARTO] Update available: ${pkg.version} → ${latest}  |  npm install -g carto-md\n`
+          );
+        }
+      } catch (_) {
+        // malformed JSON — ignore
+      }
+    });
+  });
+
+  req.on('timeout', () => { req.destroy(); });
+  req.on('error', () => { /* offline / DNS failure — ignore */ });
+}
+
+/**
+ * Returns true if `a` is a newer semver than `b`.
+ * Only handles numeric major.minor.patch — good enough for this use case.
+ */
+function isNewer(a, b) {
+  const pa = a.split('.').map(Number);
+  const pb = b.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) > (pb[i] || 0)) return true;
+    if ((pa[i] || 0) < (pb[i] || 0)) return false;
+  }
+  return false;
+}
+
+module.exports = { checkForUpdate };

package/src/cli/watch.js

@@ -3,8 +3,10 @@ const path = require('path');
 const { startWatcher } = require('../watcher/watch');
 const { runFullSync } = require('../sync');
 const { resolveConfig } = require('./init');
+const { checkForUpdate } = require('./update-check');
 
 async function run(projectRoot) {
+  checkForUpdate(); // fire and forget
   const configPath = path.join(projectRoot, '.carto', 'config.json');
 
   if (!fs.existsSync(configPath)) {

package/src/detector/files.js

@@ -1,10 +1,10 @@
 const fs = require('fs');
 const path = require('path');
 
-const MAX_FILES_TOTAL = 50;
-const ROUTE_BUDGET = 20;
+const MAX_FILES_TOTAL = 80;
+const BASE_ROUTE_BUDGET = 20;
 const MODEL_BUDGET = 10;
-const UTILITY_BUDGET = 20;
+const BASE_UTILITY_BUDGET = 20;
 
 const PYTHON_IGNORE = new Set(['__pycache__', '.venv', 'venv', 'migrations', 'node_modules', '.git', '.carto']);
 const JS_IGNORE = new Set(['node_modules', '.git', 'dist', 'build', '.carto', '.next', '.turbo', 'coverage', 'out', '.cache', 'generated', '__generated__', 'storybook-static', 'public', 'static']);
@@ -92,17 +92,19 @@ function smartSelect(allFiles, htmlFiles, projectRoot) {
     }
   }
 
-  // Sort routes by score (entry points first)
+  // Dynamic route budget — expand if many route files, compensate from utility budget
+  const routeBudget = routeCandidates.length > BASE_ROUTE_BUDGET
+    ? Math.min(routeCandidates.length, 40)
+    : BASE_ROUTE_BUDGET;
+  const utilityBudget = Math.max(10, MAX_FILES_TOTAL - routeBudget - MODEL_BUDGET);
+
   routeCandidates.sort((a, b) => scoreRoute(b) - scoreRoute(a));
-  const selectedRoutes = routeCandidates.slice(0, ROUTE_BUDGET);
+  const selectedRoutes = routeCandidates.slice(0, routeBudget);
 
-  // Sort models by score (schema files first)
   modelCandidates.sort((a, b) => scoreModel(b) - scoreModel(a));
   const selectedModels = modelCandidates.slice(0, MODEL_BUDGET);
 
-  // For utilities: scan all files for import statements, count how many times each is imported
   const importCounts = countImportReferences(allFiles, projectRoot);
-  // Rank other files by how often they're imported
   otherFiles.sort((a, b) => {
     const relA = path.relative(projectRoot, a);
     const relB = path.relative(projectRoot, b);
@@ -113,7 +115,7 @@ function smartSelect(allFiles, htmlFiles, projectRoot) {
   const remainingBudget = MAX_FILES_TOTAL - alreadySelected.size;
   const selectedUtilities = otherFiles
     .filter(f => !alreadySelected.has(f))
-    .slice(0, Math.min(UTILITY_BUDGET, remainingBudget));
+    .slice(0, Math.min(utilityBudget, remainingBudget));
 
   const allSelected = [...new Set([...selectedRoutes, ...selectedModels, ...selectedUtilities])];
 

package/src/extractors/imports.js

@@ -199,9 +199,14 @@ function buildImportGraph(fileContents, projectRoot) {
   const graph = {};
 
   for (const { filePath, content } of fileContents) {
+    const relPath = path.relative(projectRoot, filePath);
+    const base = path.basename(filePath);
+
+    // Skip generated files — they produce massive noisy edges
+    if (base.includes('.generated.') || relPath.includes('__generated__')) continue;
+
     const deps = extractImports(content, filePath, projectRoot);
     if (deps.length > 0) {
-      const relPath = path.relative(projectRoot, filePath);
       graph[relPath] = deps;
     }
   }

package/src/extractors/languages/prisma.js

@@ -27,18 +27,13 @@ module.exports = {
 
 function extractPrismaModels(content) {
   const models = [];
-  const modelPattern = /^model\s+(\w+)\s*\{([^}]+)\}/gm;
+  const blocks = extractModelBlocks(content);
 
-  let match;
-  while ((match = modelPattern.exec(content)) !== null) {
-    const className = match[1];
-    const body = match[2];
+  for (const { name, body } of blocks) {
     const fields = [];
-
     const lines = body.split('\n');
     for (const line of lines) {
       const trimmed = line.trim();
-      // Skip empty lines, comments, and @@directives
       if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('@@')) continue;
 
       const fieldMatch = trimmed.match(/^(\w+)\s+(\w+[\[\]?]*)/);
@@ -46,8 +41,7 @@ function extractPrismaModels(content) {
         fields.push({ name: fieldMatch[1], type: fieldMatch[2] });
       }
     }
-
-    models.push({ className, fields });
+    models.push({ className: name, fields });
   }
 
   return models;
@@ -55,21 +49,43 @@ function extractPrismaModels(content) {
 
 function extractPrismaDBTables(content) {
   const tables = [];
-  const modelPattern = /^model\s+(\w+)\s*\{([^}]+)\}/gm;
+  const blocks = extractModelBlocks(content);
+
+  for (const { name, body } of blocks) {
+    const mapMatch = body.match(/@@map\s*\(\s*['"]([^'"]+)['"]\s*\)/);
+    const tableName = mapMatch ? mapMatch[1] : toSnakeCase(name);
+    tables.push({ tableName, modelName: name });
+  }
 
+  return tables;
+}
+
+/**
+ * Brace-counting approach to extract model blocks.
+ * Handles } inside /// comments and @zod annotations.
+ */
+function extractModelBlocks(content) {
+  const blocks = [];
+  const modelStart = /^model\s+(\w+)\s*\{/gm;
   let match;
-  while ((match = modelPattern.exec(content)) !== null) {
-    const modelName = match[1];
-    const body = match[2];
 
-    // Check for @@map('table_name')
-    const mapMatch = body.match(/@@map\s*\(\s*['"]([^'"]+)['"]\s*\)/);
-    const tableName = mapMatch ? mapMatch[1] : toSnakeCase(modelName);
+  while ((match = modelStart.exec(content)) !== null) {
+    const name = match[1];
+    const startIdx = match.index + match[0].length;
+    let depth = 1;
+    let i = startIdx;
 
-    tables.push({ tableName, modelName });
+    while (i < content.length && depth > 0) {
+      if (content[i] === '{') depth++;
+      else if (content[i] === '}') depth--;
+      if (depth > 0) i++;
+    }
+
+    const body = content.substring(startIdx, i);
+    blocks.push({ name, body });
   }
 
-  return tables;
+  return blocks;
 }
 
 function toSnakeCase(str) {