carto-md 1.0.15 → 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.15",
+  "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)) {