@backendkit-labs/curator-codex-agent 0.2.0 → 1.0.0

package/dist/providers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChG"}

package/dist/providers/types.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=types.js.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,cAAc,GAAG,aAAa,CAAC;IACpF,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,iBAAiB,CAAC;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,cAAc,GAAG,aAAa,CAAC;IACpF,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,iBAAiB,CAAC;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types.js

@@ -1,4 +1,2 @@
-"use strict";
-// Code analysis types
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,sBAAsB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/vault-dedup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Normaliza una ruta de origen a una forma canónica estable:
+ * absoluta y con `/` como separador (evita problemas de comparación
+ * entre Windows y POSIX, y de escapes YAML al guardarla en frontmatter).
+ */
+export declare function normalizeSourcePath(p: string): string;
+/** Extrae el valor de `source_path` del frontmatter de una nota, o null. */
+export declare function readSourcePath(content: string): string | null;
+/**
+ * Elimina del vault todas las notas previamente generadas desde el mismo
+ * archivo de origen (match por `source_path`). Devuelve cuántas borró.
+ *
+ * Permite re-curar un archivo sin acumular duplicados cuando el LLM genera
+ * un título distinto en cada corrida (el dedup por nombre de archivo fallaba
+ * porque el slug del título cambiaba).
+ */
+export declare function removeNotesForSource(vaultPath: string, sourcePath: string): Promise<number>;
+export interface OrphanedNote {
+    /** Absolute path to the orphaned note file. */
+    notePath: string;
+    /** The source_path recorded in its frontmatter — the file that no longer exists. */
+    sourcePath: string;
+}
+/**
+ * Finds notes whose `source_path` frontmatter points at a file that no longer
+ * exists on disk. Read-only — never deletes anything.
+ *
+ * removeNotesForSource() only fires when a file gets *re-curated*; a file that's
+ * simply deleted from the repo is never re-curated again, so its old note is
+ * never automatically cleaned up. This is the check for that gap.
+ */
+export declare function findOrphanedNotes(vaultPath: string): Promise<OrphanedNote[]>;
+/** Deletes the given note files by absolute path. Returns how many were actually removed. */
+export declare function deleteNotes(notePaths: string[]): Promise<number>;
+//# sourceMappingURL=vault-dedup.d.ts.map

package/dist/vault-dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-dedup.d.ts","sourceRoot":"","sources":["../src/vault-dedup.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK7D;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqCjG;AAED,MAAM,WAAW,YAAY;IACzB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAoClF;AAED,6FAA6F;AAC7F,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAWtE"}

package/dist/vault-dedup.js

@@ -0,0 +1,130 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * Normaliza una ruta de origen a una forma canónica estable:
+ * absoluta y con `/` como separador (evita problemas de comparación
+ * entre Windows y POSIX, y de escapes YAML al guardarla en frontmatter).
+ */
+export function normalizeSourcePath(p) {
+    return path.resolve(p).replace(/\\/g, '/');
+}
+/** Extrae el valor de `source_path` del frontmatter de una nota, o null. */
+export function readSourcePath(content) {
+    const fm = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!fm)
+        return null;
+    const m = fm[1].match(/^source_path:\s*"?(.+?)"?\s*$/m);
+    return m ? m[1].trim() : null;
+}
+/**
+ * Elimina del vault todas las notas previamente generadas desde el mismo
+ * archivo de origen (match por `source_path`). Devuelve cuántas borró.
+ *
+ * Permite re-curar un archivo sin acumular duplicados cuando el LLM genera
+ * un título distinto en cada corrida (el dedup por nombre de archivo fallaba
+ * porque el slug del título cambiaba).
+ */
+export async function removeNotesForSource(vaultPath, sourcePath) {
+    const target = normalizeSourcePath(sourcePath);
+    let removed = 0;
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true, encoding: 'utf8' });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!entry.name.startsWith('.'))
+                    await walk(full);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                let content;
+                try {
+                    content = await fs.readFile(full, 'utf-8');
+                }
+                catch {
+                    continue;
+                }
+                const sp = readSourcePath(content);
+                if (sp && normalizeSourcePath(sp) === target) {
+                    try {
+                        await fs.unlink(full);
+                        removed++;
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                }
+            }
+        }
+    }
+    await walk(vaultPath);
+    return removed;
+}
+/**
+ * Finds notes whose `source_path` frontmatter points at a file that no longer
+ * exists on disk. Read-only — never deletes anything.
+ *
+ * removeNotesForSource() only fires when a file gets *re-curated*; a file that's
+ * simply deleted from the repo is never re-curated again, so its old note is
+ * never automatically cleaned up. This is the check for that gap.
+ */
+export async function findOrphanedNotes(vaultPath) {
+    const orphans = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true, encoding: 'utf8' });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!entry.name.startsWith('.'))
+                    await walk(full);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                let content;
+                try {
+                    content = await fs.readFile(full, 'utf-8');
+                }
+                catch {
+                    continue;
+                }
+                const sp = readSourcePath(content);
+                // Notes without a source_path (hand-written, or curated from a URL rather
+                // than a local file) aren't in scope — there's no local file to check.
+                if (!sp)
+                    continue;
+                const normalized = normalizeSourcePath(sp);
+                const exists = await fs.access(normalized).then(() => true).catch(() => false);
+                if (!exists) {
+                    orphans.push({ notePath: full, sourcePath: normalized });
+                }
+            }
+        }
+    }
+    await walk(vaultPath);
+    return orphans;
+}
+/** Deletes the given note files by absolute path. Returns how many were actually removed. */
+export async function deleteNotes(notePaths) {
+    let removed = 0;
+    for (const p of notePaths) {
+        try {
+            await fs.unlink(p);
+            removed++;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=vault-dedup.js.map

package/dist/vault-dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-dedup.js","sourceRoot":"","sources":["../src/vault-dedup.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,58 +1,45 @@
 {
-  "name": "@backendkit-labs/curator-codex-agent",
-  "version": "0.2.0",
-  "description": "Codex Curator — intelligent source code analysis and knowledge extraction into enterprise vaults using LLM reasoning.",
-  "main": "dist/server.js",
-  "bin": {
-    "curator-codex-agent": "./dist/server.js",
-    "curator-codex-watcher": "./dist/watcher.js",
-    "curator-codex-http": "./dist/http-server-main.js"
-  },
-  "files": [
-    "dist/",
-    "AGENT.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/BackendKit-labs/backendkit-agents.git",
-    "directory": "packages/curator-codex-agent"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "exports": {
-    ".": "./dist/index.js",
-    "./providers": "./dist/providers/index.js"
-  },
-  "scripts": {
-    "build": "tsc --noCheck",
-    "dev": "tsx src/analyzer.ts",
-    "start": "node -r dotenv/config dist/server.js",
-    "watch-code": "node -r dotenv/config dist/watcher.js",
-    "http-server": "node -r dotenv/config dist/http-server-main.js",
-    "http-dev": "tsx src/http-server-main.ts",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.55.0",
-    "@backendkit-labs/agent-core": "^0.20.2",
-    "@backendkit-labs/agent-enterprise": "^0.3.6",
-    "@backendkit-labs/console-animations": "^0.1.3",
-    "@modelcontextprotocol/sdk": "^1.12.0",
-    "dotenv": "^16.4.5",
-    "express": "^4.18.0",
-    "express-rate-limit": "^7.1.0",
-    "openai": "^4.0.0",
-    "winston": "^3.11.0",
-    "zod": "^3.25.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.4.0"
-  }
+    "name": "@backendkit-labs/curator-codex-agent",
+    "version": "1.0.0",
+    "description": "Codex Curator — intelligent source code and documentation analysis, vault deduplication, and RAG knowledge extraction, as a reusable library.",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" }
+    },
+    "files": [
+        "dist/"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/BackendKit-labs/backendkit-agents.git",
+        "directory": "packages/curator-codex-agent"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "license": "MIT",
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "scripts": {
+        "build": "tsc --noCheck",
+        "typecheck": "tsc --noEmit",
+        "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+        "@backendkit-labs/agent-enterprise": "*",
+        "@backendkit-labs/infra": "*",
+        "@anthropic-ai/sdk": "^0.55.0",
+        "@xenova/transformers": "^2.17.2",
+        "openai": "^4.0.0",
+        "pdf-parse": "^2.4.5",
+        "zod": "^3.25.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "@types/pdf-parse": "^1.1.5",
+        "typescript": "^5.4.0"
+    }
 }

package/AGENT.md

@@ -1,187 +0,0 @@
-# curator-codex-agent
-
-**Unified Code + Documentation Curator**. Recursively analyzes both source code files AND documentation (.md, .txt), discovers associated files, and extracts structured knowledge into enterprise vaults using LLM reasoning.
-
-## Quick Start
-
-```bash
-# Analyze entire project (code + docs)
-CURATOR_INPUT_PATH=/project \
-CURATOR_OUTPUT_PATH=/vault \
-CURATOR_API_KEY=sk-... \
-npm run watch-code
-```
-
-## Core Capabilities
-
-1. **Unified Processing** — Analyzes both code (.ts, .js, .py, etc) AND docs (.md, .txt) in single pass
-2. **Multi-language Code Analysis** — TypeScript, JavaScript, Python, Go, Rust, Java, C/C++, Kotlin, Swift
-3. **Documentation Analysis** — Extracts policies, procedures, decisions, lessons from .md/.txt
-4. **Smart Documentation Discovery** — Finds and combines associated .md files, README.md, project context
-5. **Automatic Type Detection** — Routes files to appropriate analyzer (CodeAnalyzer or DocumentationCurator)
-6. **Reasoning-based Extraction** — Uses deepseek-reasoner for deep understanding
-7. **Change Detection** — Manifest-based tracking; only reanalyzes changed files
-8. **Vault Integration** — Outputs semantic markdown notes with metadata
-9. **MCP Server** — Runs as stdio or HTTP MCP server
-
-## Key Features
-
-- ✅ Recursive directory scanning
-- ✅ Public API extraction (types, functions, classes, interfaces)
-- ✅ Pattern & architecture detection
-- ✅ Dependency mapping
-- ✅ Documentation association (code.ts + code.md → combined analysis)
-- ✅ Change tracking via SHA256 manifest
-- ✅ Efficient reprocessing (skip unchanged files)
-- ✅ Multi-provider support (DeepSeek, OpenAI, Anthropic, Ollama)
-
-## Environment Variables
-
-**Required:**
-- `CURATOR_API_KEY` — LLM API key
-- `CURATOR_OUTPUT_PATH` — Vault output directory
-
-**Optional:**
-- `CURATOR_INPUT_PATH` — Code directory to analyze once (default: watch mode)
-- `CURATOR_PROVIDER` — LLM provider (default: deepseek)
-- `CURATOR_MODEL` — Model ID (default: deepseek-reasoner)
-- `CURATOR_PORT` — HTTP port for MCP (default: stdio transport)
-
-See `.env.example` for all options.
-
-## Architecture
-
-```
-CodeAnalyzer
-├── findAssociatedDocs()     — Discovers code.md, README.md, etc
-├── analyzeFile()            — Analyzes single file + combined docs
-├── callLLM()                — Sends to reasoning model
-└── writeNote()              — Outputs to vault
-
-Manifest System
-├── calculateFileHash()      — SHA256 tracking
-├── loadManifest()           — Read .codex-manifest.json
-├── hasFileChanged()         — Detect changes
-└── saveManifest()           — Update tracking
-```
-
-## Vault Output
-
-Generates markdown files with frontmatter per analyzed module:
-
-```markdown
----
-title: "AuthService: JWT-based Authentication"
-area: general
-tipo: componente
-language: typescript
-resumen: "NestJS service for JWT-based authentication..."
-source_ref: "src/services/auth.service.ts"
-sources_combined: ["src/services/auth.service.ts", "src/services/auth.service.md"]
-depends_on: ["@nestjs/jwt", "@backendkit-labs/result"]
-exports: ["AuthService", "login", "validateToken"]
----
-
-## Overview
-...
-```
-
-## Usage Modes
-
-1. **Direct Analysis** (single run):
-   ```bash
-   CURATOR_INPUT_PATH=/project npm run watch-code
-   # Analyzes once, exits
-   ```
-
-2. **Watch Mode** (continuous):
-   ```bash
-   npm start
-   # Polls vault/incoming/ every 30s
-   ```
-
-3. **MCP Server**:
-   ```bash
-   CURATOR_PORT=3101 npm start
-   # HTTP MCP server
-   ```
-
-## Performance
-
-- 3-8 seconds per file (reasoning model)
-- Skipped files: < 100ms
-- 500 files, 1st run: ~40-60 min
-- 500 files, 2nd run (1% changed): ~2-3 min
-
-## Integration
-
-### Claude Desktop
-Add to `claude_desktop_config.json`:
-```json
-{
-  "mcpServers": {
-    "codex": {
-      "command": "npx",
-      "args": ["-y", "@backendkit-labs/curator-codex-agent"],
-      "env": {"CURATOR_API_KEY": "sk-...", "CURATOR_OUTPUT_PATH": "/vault"}
-    }
-  }
-}
-```
-
-### bk-agent
-Register as MCP skill in bk-agent manifest.
-
-### knowledge-agent
-Query vault generated by curator-codex for RAG-powered code questions.
-
-## Architecture
-
-```
-CodeAnalyzer
-├── analyzeFile()          — Dispatcher
-├── analyzeCode()          — Route to CodeAnalyzer
-├── analyzeDocumentation() — Route to DocumentationCurator
-├── isDocFile()            — File type detection
-└── findAssociatedDocs()   — Discover code.md, README.md
-
-DocumentationCurator (embedded)
-├── curateFile()
-├── curateText()
-└── callLLM()              — Extract policies, procedures
-
-Manifest System
-├── findAllFiles()         — Find code + docs (recursive)
-├── isCodeFile()           — Detect .ts, .js, .py, etc
-├── isDocFile()            — Detect .md, .txt
-└── Change tracking        — .codex-manifest.json
-```
-
-## Comparison
-
-| Feature | curator-agent | curator-codex-agent |
-|---------|---|---|
-| **Input** | .md, .txt docs only | Code + Docs (.ts, .js, .py, .md, .txt) |
-| **Code Analysis** | ❌ No | ✅ Yes (extract APIs, components) |
-| **Doc Analysis** | ✅ Yes | ✅ Yes (extract policies, procedures) |
-| **File Detection** | Manual separation | Automatic file routing |
-| **Associated Docs** | N/A | ✅ Finds code.md, README.md |
-| **Use Case** | Docs-only projects | Projects with code + docs |
-| **Workflow** | Sequential | Unified (one pass) |
-
-## When to Use Each
-
-| Scenario | Use |
-|----------|-----|
-| I have code + docs (mixed project) | **curator-codex-agent** ← unified |
-| I ONLY have documentation files | curator-agent |
-| I ONLY have code (no docs) | curator-codex-agent |
-| I want code analysis only | curator-codex-agent (will skip .md) |
-| I want docs analysis only | curator-agent |
-
-## See Also
-
-- **curator-agent** — Specialized documentation curator (if you prefer separate concerns)
-- **bk-agent** — Multi-agent framework
-- **knowledge-agent** — RAG retrieval on curated vaults
-- **curator-codex-agent** ← **You are here** (unified code + doc curator)