carto-md 1.0.15 → 1.0.17

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

@@ -4,7 +4,7 @@
 [![MIT License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 [![npm downloads](https://img.shields.io/npm/dm/carto-md)](https://www.npmjs.com/package/carto-md)
 
-**Your code changes. AGENTS.md updates. Every AI always knows.**
+**Maps your codebase so AI stops guessing. Your code changes. AGENTS.md updates. Every AI always knows.**
 
 ```bash
 npm install -g carto-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.15",
+  "version": "1.0.17",
   "description": "The context layer for AI-native development.",
   "bin": {
     "carto": "src/cli/index.js"

package/src/cli/index.js

@@ -12,6 +12,7 @@ Commands:
   watch         Read .carto/config.json, start file watcher
   sync          Read .carto/config.json, run one sync, exit
   impact <file> Show which files and routes are affected by changing a file
+  remove        Remove AGENTS.md and .carto/ from this project
 
 Options:
   --help, -h   Show this help message
@@ -46,6 +47,8 @@ if (command === 'init') {
 } else if (command === 'impact') {
   const fileArg = process.argv[3];
   require('./impact').run(process.cwd(), fileArg);
+} else if (command === 'remove') {
+  require('./remove').run(process.cwd());
 } else {
   console.error(`[CARTO] Unknown command: ${command}`);
   printUsage();

package/src/cli/remove.js

@@ -0,0 +1,37 @@
+const fs = require('fs');
+const path = require('path');
+
+function run(projectRoot) {
+  const agentsPath = path.join(projectRoot, 'AGENTS.md');
+  const cartoDir = path.join(projectRoot, '.carto');
+
+  const agentsExists = fs.existsSync(agentsPath);
+  const cartoDirExists = fs.existsSync(cartoDir);
+
+  if (!agentsExists && !cartoDirExists) {
+    console.log('[CARTO] Nothing to remove — Carto is not initialized in this project.');
+    return;
+  }
+
+  if (agentsExists) {
+    try {
+      fs.unlinkSync(agentsPath);
+      console.log('[CARTO] Removed AGENTS.md');
+    } catch (err) {
+      console.error(`[CARTO] Failed to remove AGENTS.md: ${err.message}`);
+    }
+  }
+
+  if (cartoDirExists) {
+    try {
+      fs.rmSync(cartoDir, { recursive: true, force: true });
+      console.log('[CARTO] Removed .carto/');
+    } catch (err) {
+      console.error(`[CARTO] Failed to remove .carto/: ${err.message}`);
+    }
+  }
+
+  console.log('[CARTO] Carto removed from this project.');
+}
+
+module.exports = { run };

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)) {