carto-md 1.1.1 → 1.1.3

package/CONTRIBUTING.md

@@ -10,23 +10,32 @@ Carto is free, open source, and community-maintained. The core team owns the mer
 
 New language support lives in `src/extractors/languages/`. Each language is an isolated module.
 
-Currently supported: JavaScript/TypeScript, Python, R.
+Currently supported: JavaScript/TypeScript, Python, Go, R.
 
-Wanted: Go, Rust, Ruby, Java, PHP, C#.
+Wanted: Rust, Ruby, Java, PHP, C#, Swift, Kotlin.
 
 ### Tier 2 — Framework extractors (safe to add, easy to review)
 
 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, tRPC, HTML fetch(), Plumber, Shiny.
+Currently supported:
+- **JS/TS**: Express, Next.js (App + Pages Router), tRPC, Drizzle, Zod
+- **Python**: FastAPI, Pydantic, SQLAlchemy, Django (models + URLs)
+- **Go**: Gin, Echo, Chi, net/http
+- **Schema**: Prisma
+- **Frontend**: HTML fetch()
+- **R**: Plumber, Shiny, R6, S7
 
-Wanted: Django, Rails, Laravel, NestJS, Hono, Gin, Spring.
+Wanted: Rails, Laravel, NestJS, Hono, Spring, Flask, Fastify.
 
 ### Tier 3 — Core (review carefully before merging)
 
 - `src/agents/merger.js` — merger logic. One bad merge = developer loses manual notes = project dies.
 - `src/agents/domains.js` — graph-based domain clustering. Wrong clusters = wrong context files.
+- `src/engine/carto.js` — programmatic module API. Breaking changes affect tools that import Carto.
 - `src/mcp/server.js` — MCP server tools. Breaking changes affect Kiro/Cursor/Claude integration.
+- `src/engine/incremental.js` — incremental graph update engine. Bugs here cause stale graphs.
+- `src/cache/` — file hash + graph cache. Bugs here cause wrong re-index behavior.
 - `src/detector/` — framework detection logic.
 - `src/cli/` — CLI commands.
 
@@ -36,23 +45,27 @@ Wanted: Django, Rails, Laravel, NestJS, Hono, Gin, Spring.
 
 1. Create `src/extractors/languages/yourlanguage.js`
 2. Export a plugin object:
+
 ```js
 module.exports = {
   name: 'yourlanguage',
   extensions: ['.ext'],
   extract(content, relPath) {
     return {
-      routes: [{ method, path, functionName }],
-      models: [{ className, fields: [{ name, type }] }],
-      functions: [{ name, params, returnType }],
-      envVars: ['VAR_NAME'],
-      dbTables: [{ tableName, modelName }],
-      fetches: [],
-      storageKeys: []
+      routes:      [{ method, path, functionName }],
+      models:      [{ className, fields: [{ name, type }], kind: 'yourlanguage' }],
+      functions:   [{ name, params, returnType }],
+      envVars:     ['VAR_NAME'],
+      dbTables:    [{ tableName, modelName }],
+      fetches:     [],
+      storageKeys: [],
+      events:      [{ type: 'listener'|'emitter', event: 'event.name' }],
+      jobs:        [{ type: 'cron'|'queue'|'interval', expression?: '* * * * *', name?: 'job-name' }],
     };
   }
 };
 ```
+
 3. The loader auto-discovers it — no changes to `loader.js` needed
 4. Test on at least 3 real open-source projects
 5. Open a PR with before/after AGENTS.md examples
@@ -96,7 +109,7 @@ cd carto
 npm install
 node src/cli/index.js init   # test in any project
 node src/cli/index.js serve  # test MCP server
-npm test                     # run test suite
+npm test                     # run test suite (30 tests)
 ```
 
 ---
@@ -105,6 +118,7 @@ npm test                     # run test suite
 
 - [ ] Tested on at least 2-3 real open-source projects
 - [ ] Before/after AGENTS.md included in PR description
+- [ ] Plugin returns all fields including `events` and `jobs` (can be empty arrays)
 - [ ] No changes to merger logic (unless explicitly fixing a merger bug)
 - [ ] No network calls added
 - [ ] `carto --version` still works