@backendkit-labs/curator-codex-agent 0.2.0

package/dist/api/security.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * Security middleware for Curator-Codex HTTP API
+ * Handles authentication, rate limiting, and input validation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CuratorFileSchema = exports.KnowledgeReindexSchema = exports.KnowledgeSearchWithVaultSchema = exports.KnowledgeSearchSchema = exports.CuratorProcessSchema = exports.CuratorConfigSchema = void 0;
+exports.createAuthMiddleware = createAuthMiddleware;
+exports.createRateLimiter = createRateLimiter;
+exports.validateBody = validateBody;
+exports.createRequestLogger = createRequestLogger;
+exports.errorHandler = errorHandler;
+exports.createRequestContext = createRequestContext;
+const express_rate_limit_1 = __importDefault(require("express-rate-limit"));
+const zod_1 = require("zod");
+const crypto = __importStar(require("node:crypto"));
+/**
+ * Bearer token authentication middleware
+ * Validates API key from Authorization header
+ */
+function createAuthMiddleware(apiKeys = new Map()) {
+    return (req, res, next) => {
+        const authHeader = req.headers.authorization;
+        if (!authHeader || !authHeader.startsWith('Bearer ')) {
+            // No auth required for health/status endpoints
+            if (req.path === '/health' || req.path === '/status' || req.path === '/') {
+                return next();
+            }
+            return res.status(401).json({
+                error: 'Unauthorized',
+                message: 'Missing or invalid Authorization header',
+                expected: 'Authorization: Bearer sk-...',
+            });
+        }
+        const token = authHeader.slice(7); // Remove "Bearer "
+        // Validate token format
+        if (!token.startsWith('sk-') || token.length < 20) {
+            return res.status(401).json({
+                error: 'Unauthorized',
+                message: 'Invalid API key format',
+            });
+        }
+        // Check token (in production, verify against DB/KMS)
+        const keyInfo = apiKeys.get(token) || { rateLimit: 100 };
+        req.user = {
+            id: hashToken(token),
+            key: token.slice(0, 10) + '...',
+            rateLimit: keyInfo.rateLimit,
+        };
+        next();
+    };
+}
+function hashToken(token) {
+    return crypto.createHash('sha256').update(token).digest('hex').slice(0, 12);
+}
+// ── Rate Limiting ──────────────────────────────────────────────────────────
+function createRateLimiter(windowMs = 15 * 60 * 1000, max = 100) {
+    return (0, express_rate_limit_1.default)({
+        windowMs,
+        max,
+        message: {
+            error: 'Too many requests',
+            message: 'Rate limit exceeded. Please try again later.',
+            retryAfter: Math.ceil(windowMs / 1000),
+        },
+        standardHeaders: true, // Return rate limit info in headers
+        skip: (req) => {
+            // Skip rate limiting for health checks
+            return req.path === '/health';
+        },
+    });
+}
+// ── Input Validation ───────────────────────────────────────────────────────
+exports.CuratorConfigSchema = zod_1.z.object({
+    inputPath: zod_1.z.string().min(1).describe('Input directory path'),
+    outputPath: zod_1.z.string().min(1).describe('Output vault path'),
+});
+exports.CuratorProcessSchema = zod_1.z.object({
+    inputPath: zod_1.z.string().optional().describe('Optional input override'),
+    outputPath: zod_1.z.string().optional().describe('Optional output override'),
+});
+exports.KnowledgeSearchSchema = zod_1.z.object({
+    query: zod_1.z.string().min(3).max(500).describe('Search query'),
+    topK: zod_1.z.number().int().min(1).max(20).optional().describe('Top K results'),
+    autoSynthesize: zod_1.z.boolean().optional().describe('Auto-generate synthesis'),
+});
+exports.KnowledgeSearchWithVaultSchema = zod_1.z.object({
+    vaultPath: zod_1.z.string().min(1).describe('Absolute path to vault directory'),
+    query: zod_1.z.string().min(3).max(500).describe('Search query'),
+    topK: zod_1.z.number().int().min(1).max(20).optional().default(5),
+});
+exports.KnowledgeReindexSchema = zod_1.z.object({
+    vaultPath: zod_1.z.string().min(1).describe('Absolute path to vault directory'),
+});
+exports.CuratorFileSchema = zod_1.z.object({
+    vaultPath: zod_1.z.string().min(1).describe('Absolute path to vault directory'),
+    fileName: zod_1.z.string().min(1).max(255).describe('Original file name'),
+    content: zod_1.z.string().min(1).describe('File content to curate'),
+});
+/**
+ * Validate request body against schema
+ */
+function validateBody(schema) {
+    return (req, res, next) => {
+        try {
+            const validated = schema.parse(req.body);
+            req.validatedBody = validated;
+            next();
+        }
+        catch (err) {
+            if (err instanceof zod_1.z.ZodError) {
+                return res.status(400).json({
+                    error: 'Validation failed',
+                    details: err.errors.map(e => ({
+                        field: e.path.join('.'),
+                        message: e.message,
+                        code: e.code,
+                    })),
+                });
+            }
+            res.status(400).json({
+                error: 'Invalid request',
+                message: err.message,
+            });
+        }
+    };
+}
+// ── Request Logging ────────────────────────────────────────────────────────
+function createRequestLogger() {
+    return (req, res, next) => {
+        const start = Date.now();
+        // Log request
+        const userId = req.user?.id || 'anonymous';
+        console.log(`[${new Date().toISOString()}] ${req.method} ${req.path} (${userId})`);
+        // Intercept response
+        const originalJson = res.json.bind(res);
+        res.json = function (body) {
+            const duration = Date.now() - start;
+            console.log(`[${new Date().toISOString()}] ${req.method} ${req.path} → ${res.statusCode} (${duration}ms)`);
+            return originalJson(body);
+        };
+        next();
+    };
+}
+// ── Error Handler ──────────────────────────────────────────────────────────
+function errorHandler(err, req, res, next) {
+    const status = err.status || 500;
+    const message = err.message || 'Internal server error';
+    console.error(`[ERROR] ${req.method} ${req.path} → ${status}`, { error: message, stack: err.stack });
+    res.status(status).json({
+        error: status >= 500 ? 'Server error' : 'Client error',
+        message,
+        ...(process.env.NODE_ENV === 'development' && { stack: err.stack }),
+    });
+}
+function createRequestContext(req) {
+    return {
+        userId: req.user?.id || 'anonymous',
+        requestId: crypto.randomUUID(),
+        startTime: Date.now(),
+        ip: (req.ip || req.socket.remoteAddress || 'unknown'),
+    };
+}
+//# sourceMappingURL=security.js.map

package/dist/api/security.js.map

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

package/dist/checksum.d.ts

@@ -0,0 +1,56 @@
+export interface FileChecksum {
+    filename: string;
+    hash: string;
+    size: number;
+    modified: string;
+}
+export interface CodexManifest {
+    version: '1.0';
+    created: string;
+    lastUpdated: string;
+    inputPath: string;
+    outputPath: string;
+    files: Record<string, {
+        relativePath: string;
+        hash: string;
+        size: number;
+        modified: string;
+        analyzedAt: string;
+        status: 'success' | 'failed' | 'skipped';
+    }>;
+}
+/**
+ * Calculate SHA256 hash of a file
+ */
+export declare function calculateFileHash(filePath: string): Promise<string>;
+/**
+ * Load manifest from INPUT_PATH
+ */
+export declare function loadManifest(inputPath: string): Promise<CodexManifest | null>;
+/**
+ * Save manifest to INPUT_PATH
+ */
+export declare function saveManifest(inputPath: string, manifest: CodexManifest): Promise<void>;
+/**
+ * Check if file changed since last analysis
+ */
+export declare function hasFileChanged(filePath: string, relativePath: string, manifest: CodexManifest | null): Promise<boolean>;
+/**
+ * Create initial manifest
+ */
+export declare function createManifest(inputPath: string, outputPath: string): CodexManifest;
+/**
+ * Update manifest with file analysis result
+ */
+export declare function updateManifestEntry(manifest: CodexManifest, filePath: string, relativePath: string, status: 'success' | 'failed' | 'skipped'): Promise<void>;
+export declare function isCodeFile(filePath: string): boolean;
+export declare function isDocFile(filePath: string): boolean;
+export declare function findAllFiles(dirPath: string, relativePath?: string): Promise<Array<{
+    fullPath: string;
+    relativePath: string;
+}>>;
+/**
+ * Generate analysis report
+ */
+export declare function generateReport(manifest: CodexManifest): string;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../src/checksum.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;KAC5C,CAAC,CAAC;CACN;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGzE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQnF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,aAAa,GAAG,IAAI,GAC/B,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACnB,aAAa,CASf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GACzC,OAAO,CAAC,IAAI,CAAC,CAYf;AAWD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAsB,YAAY,CAC9B,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,MAAW,GAC1B,OAAO,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAqC5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAkB9D"}

package/dist/checksum.js

@@ -0,0 +1,186 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateFileHash = calculateFileHash;
+exports.loadManifest = loadManifest;
+exports.saveManifest = saveManifest;
+exports.hasFileChanged = hasFileChanged;
+exports.createManifest = createManifest;
+exports.updateManifestEntry = updateManifestEntry;
+exports.isCodeFile = isCodeFile;
+exports.isDocFile = isDocFile;
+exports.findAllFiles = findAllFiles;
+exports.generateReport = generateReport;
+const fs = __importStar(require("node:fs/promises"));
+const crypto = __importStar(require("node:crypto"));
+const path = __importStar(require("node:path"));
+/**
+ * Calculate SHA256 hash of a file
+ */
+async function calculateFileHash(filePath) {
+    const content = await fs.readFile(filePath);
+    return crypto.createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Load manifest from INPUT_PATH
+ */
+async function loadManifest(inputPath) {
+    const manifestPath = path.join(inputPath, '.codex-manifest.json');
+    try {
+        const content = await fs.readFile(manifestPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save manifest to INPUT_PATH
+ */
+async function saveManifest(inputPath, manifest) {
+    const manifestPath = path.join(inputPath, '.codex-manifest.json');
+    manifest.lastUpdated = new Date().toISOString();
+    await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+}
+/**
+ * Check if file changed since last analysis
+ */
+async function hasFileChanged(filePath, relativePath, manifest) {
+    if (!manifest)
+        return true;
+    const entry = manifest.files[relativePath];
+    if (!entry)
+        return true;
+    const currentHash = await calculateFileHash(filePath);
+    return currentHash !== entry.hash;
+}
+/**
+ * Create initial manifest
+ */
+function createManifest(inputPath, outputPath) {
+    return {
+        version: '1.0',
+        created: new Date().toISOString(),
+        lastUpdated: new Date().toISOString(),
+        inputPath,
+        outputPath,
+        files: {},
+    };
+}
+/**
+ * Update manifest with file analysis result
+ */
+async function updateManifestEntry(manifest, filePath, relativePath, status) {
+    const stat = await fs.stat(filePath);
+    const hash = await calculateFileHash(filePath);
+    manifest.files[relativePath] = {
+        relativePath,
+        hash,
+        size: stat.size,
+        modified: new Date(stat.mtime).toISOString(),
+        analyzedAt: new Date().toISOString(),
+        status,
+    };
+}
+/**
+ * Recursively find all code and documentation files
+ */
+const CODE_EXTENSIONS = [
+    '.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs', '.java', '.c', '.cpp', '.kt', '.swift',
+];
+const DOC_EXTENSIONS = ['.md', '.txt'];
+function isCodeFile(filePath) {
+    return CODE_EXTENSIONS.some(ext => filePath.toLowerCase().endsWith(ext));
+}
+function isDocFile(filePath) {
+    return DOC_EXTENSIONS.some(ext => filePath.toLowerCase().endsWith(ext));
+}
+async function findAllFiles(dirPath, relativePath = '') {
+    const results = [];
+    try {
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') ||
+                entry.name === 'node_modules' ||
+                entry.name === 'dist' ||
+                entry.name === 'build' ||
+                entry.name === '.git' ||
+                entry.name === '.venv' ||
+                entry.name === 'venv' ||
+                entry.name === '__pycache__') {
+                continue;
+            }
+            const fullPath = path.join(dirPath, entry.name);
+            const relPath = relativePath ? path.join(relativePath, entry.name) : entry.name;
+            if (entry.isDirectory()) {
+                const subResults = await findAllFiles(fullPath, relPath);
+                results.push(...subResults);
+            }
+            else if (entry.isFile()) {
+                const hasCodeExt = isCodeFile(entry.name);
+                const hasDocExt = isDocFile(entry.name);
+                if (hasCodeExt || hasDocExt) {
+                    results.push({ fullPath, relativePath: relPath });
+                }
+            }
+        }
+    }
+    catch (err) {
+        console.error(`Error reading directory ${dirPath}: ${err.message}`);
+    }
+    return results;
+}
+/**
+ * Generate analysis report
+ */
+function generateReport(manifest) {
+    const entries = Object.values(manifest.files);
+    const succeeded = entries.filter(e => e.status === 'success').length;
+    const failed = entries.filter(e => e.status === 'failed').length;
+    const skipped = entries.filter(e => e.status === 'skipped').length;
+    return `
+📊 Code Analysis Report
+───────────────────────
+Total Files:   ${entries.length}
+✓ Analyzed:    ${succeeded}
+✗ Failed:      ${failed}
+⊘ Skipped:     ${skipped}
+Processed:     ${succeeded + failed} / ${entries.length}
+Efficiency:    ${skipped > 0 ? `${Math.round((skipped / entries.length) * 100)}% of files unchanged` : 'All files processed'}
+
+Last Updated: ${new Date(manifest.lastUpdated).toLocaleString()}
+`;
+}
+//# sourceMappingURL=checksum.js.map

package/dist/checksum.js.map

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

package/dist/documentation-curator.d.ts

@@ -0,0 +1,18 @@
+import type { CuratorLLMProvider } from './providers/types.js';
+import type { CodeAnalysisResult } from './types.js';
+export interface DocumentationCuratorOptions {
+    provider: CuratorLLMProvider;
+    vaultPath: string;
+    maxInputChars?: number;
+}
+export declare class DocumentationCurator {
+    private readonly provider;
+    private readonly vaultPath;
+    private readonly maxInputChars;
+    constructor(opts: DocumentationCuratorOptions);
+    curateText(text: string, source: string, areaHint?: string): Promise<CodeAnalysisResult>;
+    curateFile(filePath: string, areaHint?: string): Promise<CodeAnalysisResult>;
+    private callLLM;
+    private writeNote;
+}
+//# sourceMappingURL=documentation-curator.d.ts.map

package/dist/documentation-curator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-curator.d.ts","sourceRoot":"","sources":["../src/documentation-curator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA2GrD,MAAM,WAAW,2BAA2B;IACxC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,IAAI,EAAE,2BAA2B;IAMvC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2CxF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAmBpE,OAAO;YAyBP,SAAS;CAiB1B"}