structx 1.0.0 → 2.1.0

package/dist/ingest/ingester.js

@@ -0,0 +1,217 @@
+"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.ingestDirectory = ingestDirectory;
+exports.printIngestResult = printIngestResult;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const queries_1 = require("../db/queries");
+const parser_1 = require("./parser");
+const relationships_1 = require("./relationships");
+const differ_1 = require("./differ");
+const scanner_1 = require("./scanner");
+const logger_1 = require("../utils/logger");
+function ingestDirectory(db, repoPath, diffThreshold) {
+    const project = (0, parser_1.createProject)(repoPath);
+    const files = (0, scanner_1.scanDirectory)(repoPath);
+    console.log(`Found ${files.length} TypeScript files.`);
+    const result = {
+        newFiles: 0,
+        changedFiles: 0,
+        unchangedFiles: 0,
+        totalFunctions: 0,
+        totalRelationships: 0,
+        totalTypes: 0,
+        totalRoutes: 0,
+        totalConstants: 0,
+        queued: 0,
+    };
+    for (const filePath of files) {
+        const relativePath = path.relative(repoPath, filePath);
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const contentHash = (0, parser_1.hashFileContent)(content);
+        const existingFile = (0, queries_1.getFileByPath)(db, relativePath);
+        if (existingFile && existingFile.content_hash === contentHash) {
+            result.unchangedFiles++;
+            continue;
+        }
+        const isNew = !existingFile;
+        if (isNew)
+            result.newFiles++;
+        else
+            result.changedFiles++;
+        // Wrap each file's ingest in a transaction for atomicity
+        db.transaction(() => {
+            const fileId = (0, queries_1.upsertFile)(db, relativePath, contentHash);
+            const oldFunctions = isNew ? [] : (0, queries_1.getFunctionsByFileId)(db, fileId);
+            const oldFunctionMap = new Map(oldFunctions.map(f => [f.name, f]));
+            if (!isNew) {
+                for (const oldFn of oldFunctions) {
+                    (0, queries_1.deleteRelationshipsByCallerFunctionId)(db, oldFn.id);
+                }
+                (0, queries_1.deleteFunctionsByFileId)(db, fileId);
+                (0, queries_1.deleteTypesByFileId)(db, fileId);
+                (0, queries_1.deleteRoutesByFileId)(db, fileId);
+                (0, queries_1.deleteConstantsByFileId)(db, fileId);
+            }
+            let parsed;
+            try {
+                parsed = (0, parser_1.parseFileComplete)(project, filePath);
+            }
+            catch (err) {
+                logger_1.logger.warn(`Failed to parse ${relativePath}: ${err.message}`);
+                return;
+            }
+            // Insert functions
+            const functionIdMap = new Map();
+            for (const fn of parsed.functions) {
+                const fnId = (0, queries_1.insertFunction)(db, {
+                    file_id: fileId,
+                    name: fn.name,
+                    signature: fn.signature,
+                    body: fn.body,
+                    code_hash: fn.codeHash,
+                    start_line: fn.startLine,
+                    end_line: fn.endLine,
+                    is_exported: fn.isExported,
+                    is_async: fn.isAsync,
+                });
+                functionIdMap.set(fn.name, fnId);
+                result.totalFunctions++;
+                const oldFn = oldFunctionMap.get(fn.name);
+                if (!oldFn) {
+                    (0, queries_1.enqueueForAnalysis)(db, fnId, 'new', (0, differ_1.getPriority)('new', fn.isExported));
+                    result.queued++;
+                }
+                else {
+                    const { reanalyze, reason } = (0, differ_1.shouldReanalyze)(oldFn, fn.signature, fn.codeHash, fn.body, diffThreshold);
+                    if (reanalyze) {
+                        (0, queries_1.enqueueForAnalysis)(db, fnId, reason, (0, differ_1.getPriority)(reason, fn.isExported));
+                        result.queued++;
+                    }
+                }
+            }
+            // Insert types
+            for (const t of parsed.types) {
+                (0, queries_1.insertType)(db, {
+                    file_id: fileId,
+                    name: t.name,
+                    kind: t.kind,
+                    full_text: t.fullText,
+                    is_exported: t.isExported,
+                    start_line: t.startLine,
+                    end_line: t.endLine,
+                });
+                result.totalTypes++;
+            }
+            // Insert routes
+            for (const r of parsed.routes) {
+                (0, queries_1.insertRoute)(db, {
+                    file_id: fileId,
+                    method: r.method,
+                    path: r.path,
+                    handler_name: r.handlerName,
+                    handler_body: r.handlerBody,
+                    middleware: r.middleware,
+                    start_line: r.startLine,
+                    end_line: r.endLine,
+                });
+                result.totalRoutes++;
+            }
+            // Insert constants
+            for (const c of parsed.constants) {
+                (0, queries_1.insertConstant)(db, {
+                    file_id: fileId,
+                    name: c.name,
+                    value_text: c.valueText,
+                    type_annotation: c.typeAnnotation,
+                    is_exported: c.isExported,
+                    start_line: c.startLine,
+                    end_line: c.endLine,
+                });
+                result.totalConstants++;
+            }
+            // Insert file summary
+            (0, queries_1.upsertFileSummary)(db, {
+                file_id: fileId,
+                import_count: parsed.fileMetadata.importCount,
+                export_count: parsed.fileMetadata.exportCount,
+                function_count: parsed.fileMetadata.functionCount,
+                type_count: parsed.fileMetadata.typeCount,
+                route_count: parsed.fileMetadata.routeCount,
+                loc: parsed.fileMetadata.loc,
+                imports_json: JSON.stringify(parsed.fileMetadata.imports),
+                exports_json: JSON.stringify(parsed.fileMetadata.exports),
+            });
+            // Extract and insert relationships
+            try {
+                const calls = (0, relationships_1.extractCallsFromFile)(project, filePath);
+                for (const call of calls) {
+                    if (call.callerName === '__file__')
+                        continue;
+                    const callerId = functionIdMap.get(call.callerName);
+                    if (!callerId)
+                        continue;
+                    const callee = (0, queries_1.getFunctionByName)(db, call.calleeName);
+                    (0, queries_1.insertRelationship)(db, callerId, call.calleeName, call.relationType, callee?.id);
+                    result.totalRelationships++;
+                }
+            }
+            catch (err) {
+                logger_1.logger.warn(`Failed to extract calls from ${relativePath}: ${err.message}`);
+            }
+        })();
+    }
+    // Second-pass: resolve NULL callee_function_ids and rebuild all FTS indexes
+    const resolvedCount = (0, queries_1.resolveNullCallees)(db);
+    if (resolvedCount > 0) {
+        logger_1.logger.info(`Resolved ${resolvedCount} NULL callee_function_id(s)`);
+    }
+    (0, queries_1.rebuildAllFtsIndexes)(db);
+    return result;
+}
+function printIngestResult(result) {
+    console.log(`\nIngestion complete:`);
+    console.log(`  New files:       ${result.newFiles}`);
+    console.log(`  Changed files:   ${result.changedFiles}`);
+    console.log(`  Unchanged:       ${result.unchangedFiles}`);
+    console.log(`  Functions:       ${result.totalFunctions}`);
+    console.log(`  Types:           ${result.totalTypes}`);
+    console.log(`  Routes:          ${result.totalRoutes}`);
+    console.log(`  Constants:       ${result.totalConstants}`);
+    console.log(`  Relationships:   ${result.totalRelationships}`);
+    console.log(`  Queued:          ${result.queued} functions for semantic analysis`);
+}
+//# sourceMappingURL=ingester.js.map

package/dist/ingest/ingester.js.map

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

package/dist/ingest/parser.d.ts

@@ -1,4 +1,8 @@
 import { Project } from 'ts-morph';
+import { type ExtractedType } from './type-extractor';
+import { type ExtractedRoute } from './route-extractor';
+import { type ExtractedConstant } from './constant-extractor';
+import { type ExtractedFileMetadata } from './file-metadata';
 export interface ExtractedFunction {
     name: string;
     signature: string;
@@ -11,5 +15,13 @@ export interface ExtractedFunction {
 }
 export declare function createProject(repoPath: string): Project;
 export declare function parseFile(project: Project, filePath: string): ExtractedFunction[];
+export interface ParseFileCompleteResult {
+    functions: ExtractedFunction[];
+    types: ExtractedType[];
+    routes: ExtractedRoute[];
+    constants: ExtractedConstant[];
+    fileMetadata: ExtractedFileMetadata;
+}
+export declare function parseFileComplete(project: Project, filePath: string): ParseFileCompleteResult;
 export declare function hashFileContent(content: string): string;
 //# sourceMappingURL=parser.d.ts.map

package/dist/ingest/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/ingest/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA4G,MAAM,UAAU,CAAC;AAG7I,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CASvD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAuCjF;AA2ED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/ingest/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA4G,MAAM,UAAU,CAAC;AAE7I,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CASvD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAuCjF;AA2ED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,YAAY,EAAE,qBAAqB,CAAC;CACrC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CA4C7F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/ingest/parser.js

@@ -35,9 +35,14 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createProject = createProject;
 exports.parseFile = parseFile;
+exports.parseFileComplete = parseFileComplete;
 exports.hashFileContent = hashFileContent;
 const ts_morph_1 = require("ts-morph");
 const crypto = __importStar(require("crypto"));
+const type_extractor_1 = require("./type-extractor");
+const route_extractor_1 = require("./route-extractor");
+const constant_extractor_1 = require("./constant-extractor");
+const file_metadata_1 = require("./file-metadata");
 function createProject(repoPath) {
     return new ts_morph_1.Project({
         tsConfigFilePath: undefined,
@@ -148,6 +153,49 @@ function buildSignature(fn) {
 function hashCode(code) {
     return crypto.createHash('sha256').update(code).digest('hex');
 }
+function parseFileComplete(project, filePath) {
+    const sourceFile = project.addSourceFileAtPath(filePath);
+    const functions = [];
+    // Extract top-level function declarations
+    for (const fn of sourceFile.getFunctions()) {
+        const extracted = extractFunctionDeclaration(fn);
+        if (extracted)
+            functions.push(extracted);
+    }
+    // Extract arrow functions assigned to variables
+    for (const varStmt of sourceFile.getVariableStatements()) {
+        for (const decl of varStmt.getDeclarations()) {
+            const initializer = decl.getInitializer();
+            if (initializer && ts_morph_1.Node.isArrowFunction(initializer)) {
+                const extracted = extractArrowFunction(decl, initializer, varStmt.isExported());
+                if (extracted)
+                    functions.push(extracted);
+            }
+            if (initializer && ts_morph_1.Node.isFunctionExpression(initializer)) {
+                const extracted = extractArrowFunction(decl, initializer, varStmt.isExported());
+                if (extracted)
+                    functions.push(extracted);
+            }
+        }
+    }
+    // Extract class methods
+    for (const cls of sourceFile.getClasses()) {
+        const className = cls.getName() || 'AnonymousClass';
+        for (const method of cls.getMethods()) {
+            const extracted = extractMethodDeclaration(method, className);
+            if (extracted)
+                functions.push(extracted);
+        }
+    }
+    // Extract new entity types
+    const types = (0, type_extractor_1.extractTypes)(sourceFile);
+    const routes = (0, route_extractor_1.extractRoutes)(sourceFile);
+    const constants = (0, constant_extractor_1.extractConstants)(sourceFile);
+    const fileMetadata = (0, file_metadata_1.extractFileMetadata)(sourceFile, functions.length, types.length, routes.length);
+    // Remove the source file from project to prevent memory bloat
+    project.removeSourceFile(sourceFile);
+    return { functions, types, routes, constants, fileMetadata };
+}
 function hashFileContent(content) {
     return crypto.createHash('sha256').update(content).digest('hex');
 }

package/dist/ingest/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/ingest/parser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,sCASC;AAED,8BAuCC;AA2ED,0CAEC;AA7ID,uCAA6I;AAC7I,+CAAiC;AAajC,SAAgB,aAAa,CAAC,QAAgB;IAC5C,OAAO,IAAI,kBAAO,CAAC;QACjB,gBAAgB,EAAE,SAAS;QAC3B,2BAA2B,EAAE,IAAI;QACjC,eAAe,EAAE;YACf,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,CAAC,EAAE,QAAQ;SACjB;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,SAAS,CAAC,OAAgB,EAAE,QAAgB;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,SAAS,GAAwB,EAAE,CAAC;IAE1C,0CAA0C;IAC1C,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,0BAA0B,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,SAAS;YAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,gDAAgD;IAChD,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,qBAAqB,EAAE,EAAE,CAAC;QACzD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;YAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,IAAI,WAAW,IAAI,eAAI,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;gBACrD,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;gBAChF,IAAI,SAAS;oBAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3C,CAAC;YACD,8DAA8D;YAC9D,IAAI,WAAW,IAAI,eAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1D,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,EAAE,WAAkB,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;gBACvF,IAAI,SAAS;oBAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,gBAAgB,CAAC;QACpD,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC9D,IAAI,SAAS;gBAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAErC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,0BAA0B,CAAC,EAAuB;IACzD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,2BAA2B;IAEnD,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAErC,OAAO;QACL,IAAI;QACJ,SAAS;QACT,IAAI;QACJ,SAAS,EAAE,EAAE,CAAC,kBAAkB,EAAE;QAClC,OAAO,EAAE,EAAE,CAAC,gBAAgB,EAAE;QAC9B,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE;QAC3B,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;QACrB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAyB,EACzB,KAAoB,EACpB,UAAmB;IAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,SAAS,CAAC;IAEjE,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,SAAS,IAAI,OAAO,MAAM,QAAQ,UAAU,EAAE;QACzD,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,kBAAkB,EAAE;QACpC,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE;QAChC,UAAU;QACV,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;QACxB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAyB,EAAE,SAAiB;IAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,SAAS,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,GAAG,SAAS,IAAI,IAAI,EAAE;QAC5B,SAAS,EAAE,GAAG,SAAS,IAAI,IAAI,IAAI,MAAM,MAAM,UAAU,EAAE;QAC3D,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,kBAAkB,EAAE;QACtC,OAAO,EAAE,MAAM,CAAC,gBAAgB,EAAE;QAClC,UAAU,EAAE,IAAI,EAAE,gDAAgD;QAClE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;QACzB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,EAAuB;IAC7C,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,WAAW,CAAC;IACzC,MAAM,MAAM,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,SAAS,CAAC;IAC9D,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,OAAO,GAAG,WAAW,YAAY,IAAI,IAAI,MAAM,MAAM,UAAU,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAgB,eAAe,CAAC,OAAe;IAC7C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/ingest/parser.ts"],"names":[],"mappings":"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"}

package/dist/ingest/route-extractor.d.ts

@@ -0,0 +1,12 @@
+import { SourceFile } from 'ts-morph';
+export interface ExtractedRoute {
+    method: string;
+    path: string;
+    handlerName: string | null;
+    handlerBody: string;
+    middleware: string | null;
+    startLine: number;
+    endLine: number;
+}
+export declare function extractRoutes(sourceFile: SourceFile): ExtractedRoute[];
+//# sourceMappingURL=route-extractor.d.ts.map

package/dist/ingest/route-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-extractor.d.ts","sourceRoot":"","sources":["../../src/ingest/route-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAoB,MAAM,UAAU,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,EAAE,CA+DtE"}

package/dist/ingest/route-extractor.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractRoutes = extractRoutes;
+const ts_morph_1 = require("ts-morph");
+const HTTP_METHODS = new Set(['get', 'post', 'put', 'delete', 'patch', 'all', 'use']);
+function extractRoutes(sourceFile) {
+    const routes = [];
+    const callExpressions = sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.CallExpression);
+    for (const callExpr of callExpressions) {
+        const expression = callExpr.getExpression();
+        // Match patterns like router.get(...), app.post(...), *.method('/path', ...)
+        if (!ts_morph_1.Node.isPropertyAccessExpression(expression))
+            continue;
+        const methodName = expression.getName().toLowerCase();
+        if (!HTTP_METHODS.has(methodName))
+            continue;
+        const args = callExpr.getArguments();
+        if (args.length < 1)
+            continue;
+        // First argument should be a string literal path starting with '/'
+        const firstArg = args[0];
+        let routePath = null;
+        if (ts_morph_1.Node.isStringLiteral(firstArg)) {
+            routePath = firstArg.getLiteralValue();
+        }
+        else {
+            // Could be a template literal or variable — skip non-literal paths
+            const text = firstArg.getText();
+            if (text.startsWith("'") || text.startsWith('"') || text.startsWith('`')) {
+                routePath = text.replace(/^['"`]|['"`]$/g, '');
+            }
+        }
+        if (!routePath || (!routePath.startsWith('/') && methodName !== 'use'))
+            continue;
+        // Last argument is the handler
+        const lastArg = args[args.length - 1];
+        const handlerBody = lastArg.getText().substring(0, 2000); // Truncate very large handlers
+        // Try to extract handler name
+        let handlerName = null;
+        if (ts_morph_1.Node.isIdentifier(lastArg)) {
+            handlerName = lastArg.getText();
+        }
+        else if (ts_morph_1.Node.isArrowFunction(lastArg) || ts_morph_1.Node.isFunctionExpression(lastArg)) {
+            handlerName = null; // Inline handler
+        }
+        // Middleware: arguments between path and handler
+        let middleware = null;
+        if (args.length > 2) {
+            const middlewareArgs = args.slice(1, -1).map(a => a.getText());
+            middleware = JSON.stringify(middlewareArgs);
+        }
+        routes.push({
+            method: methodName.toUpperCase(),
+            path: routePath,
+            handlerName,
+            handlerBody,
+            middleware,
+            startLine: callExpr.getStartLineNumber(),
+            endLine: callExpr.getEndLineNumber(),
+        });
+    }
+    return routes;
+}
+//# sourceMappingURL=route-extractor.js.map

package/dist/ingest/route-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-extractor.js","sourceRoot":"","sources":["../../src/ingest/route-extractor.ts"],"names":[],"mappings":";;AAcA,sCA+DC;AA7ED,uCAAwD;AAYxD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEtF,SAAgB,aAAa,CAAC,UAAsB;IAClD,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,MAAM,eAAe,GAAG,UAAU,CAAC,oBAAoB,CAAC,qBAAU,CAAC,cAAc,CAAC,CAAC;IAEnF,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;QAE5C,6EAA6E;QAC7E,IAAI,CAAC,eAAI,CAAC,0BAA0B,CAAC,UAAU,CAAC;YAAE,SAAS;QAE3D,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;QACtD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QAE5C,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAE9B,mEAAmE;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,SAAS,GAAkB,IAAI,CAAC;QAEpC,IAAI,eAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,SAAS,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzE,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,KAAK,KAAK,CAAC;YAAE,SAAS;QAEjF,+BAA+B;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,+BAA+B;QAEzF,8BAA8B;QAC9B,IAAI,WAAW,GAAkB,IAAI,CAAC;QACtC,IAAI,eAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC;aAAM,IAAI,eAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,eAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/E,WAAW,GAAG,IAAI,CAAC,CAAC,iBAAiB;QACvC,CAAC;QAED,iDAAiD;QACjD,IAAI,UAAU,GAAkB,IAAI,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,UAAU,CAAC,WAAW,EAAE;YAChC,IAAI,EAAE,SAAS;YACf,WAAW;YACX,WAAW;YACX,UAAU;YACV,SAAS,EAAE,QAAQ,CAAC,kBAAkB,EAAE;YACxC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/ingest/type-extractor.d.ts

@@ -0,0 +1,11 @@
+import { SourceFile } from 'ts-morph';
+export interface ExtractedType {
+    name: string;
+    kind: 'interface' | 'type_alias' | 'enum';
+    fullText: string;
+    isExported: boolean;
+    startLine: number;
+    endLine: number;
+}
+export declare function extractTypes(sourceFile: SourceFile): ExtractedType[];
+//# sourceMappingURL=type-extractor.d.ts.map

package/dist/ingest/type-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-extractor.d.ts","sourceRoot":"","sources":["../../src/ingest/type-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,MAAM,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,EAAE,CA2CpE"}

package/dist/ingest/type-extractor.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTypes = extractTypes;
+function extractTypes(sourceFile) {
+    const types = [];
+    for (const iface of sourceFile.getInterfaces()) {
+        const name = iface.getName();
+        if (!name)
+            continue;
+        types.push({
+            name,
+            kind: 'interface',
+            fullText: iface.getFullText().trim(),
+            isExported: iface.isExported(),
+            startLine: iface.getStartLineNumber(),
+            endLine: iface.getEndLineNumber(),
+        });
+    }
+    for (const alias of sourceFile.getTypeAliases()) {
+        const name = alias.getName();
+        if (!name)
+            continue;
+        types.push({
+            name,
+            kind: 'type_alias',
+            fullText: alias.getFullText().trim(),
+            isExported: alias.isExported(),
+            startLine: alias.getStartLineNumber(),
+            endLine: alias.getEndLineNumber(),
+        });
+    }
+    for (const enumDecl of sourceFile.getEnums()) {
+        const name = enumDecl.getName();
+        if (!name)
+            continue;
+        types.push({
+            name,
+            kind: 'enum',
+            fullText: enumDecl.getFullText().trim(),
+            isExported: enumDecl.isExported(),
+            startLine: enumDecl.getStartLineNumber(),
+            endLine: enumDecl.getEndLineNumber(),
+        });
+    }
+    return types;
+}
+//# sourceMappingURL=type-extractor.js.map

package/dist/ingest/type-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-extractor.js","sourceRoot":"","sources":["../../src/ingest/type-extractor.ts"],"names":[],"mappings":";;AAWA,oCA2CC;AA3CD,SAAgB,YAAY,CAAC,UAAsB;IACjD,MAAM,KAAK,GAAoB,EAAE,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,aAAa,EAAE,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI;YACJ,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE;YACpC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;YAC9B,SAAS,EAAE,KAAK,CAAC,kBAAkB,EAAE;YACrC,OAAO,EAAE,KAAK,CAAC,gBAAgB,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,cAAc,EAAE,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI;YACJ,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE;YACpC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;YAC9B,SAAS,EAAE,KAAK,CAAC,kBAAkB,EAAE;YACrC,OAAO,EAAE,KAAK,CAAC,gBAAgB,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI;YACJ,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE;YACvC,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE;YACjC,SAAS,EAAE,QAAQ,CAAC,kBAAkB,EAAE;YACxC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/instructions/claude.md

@@ -1,41 +1,70 @@
-# StructX — Code Intelligence Graph
+# StructX — Code Intelligence Graph (MANDATORY)
 
 This project uses **StructX**, a graph-powered code intelligence tool for TypeScript.
-StructX maintains a function-level knowledge graph of the codebase that you should use
-instead of reading raw source files when answering code questions.
+StructX maintains a knowledge graph of the codebase including functions, types, routes,
+constants, and file summaries. **You MUST use StructX as your primary source of codebase
+understanding. Do NOT read raw source files to learn about the codebase.**
 
-## Rules
+## Mandatory Workflow
 
-1. **On session start:** Run `npx structx status` to check if the graph is initialized.
-   If not initialized, run `npx structx setup .` to bootstrap (init + ingest + analyze).
+### Step 1: Initialize (ALWAYS do this first)
+Run `npx structx status` to check the graph state.
+- If it says "not initialized", run `npx structx setup .`
+- If Functions/Types/Routes counts are 0, run `npx structx setup .`
+- **Do NOT proceed to any code task until StructX is initialized and populated.**
 
-2. **Before answering code questions:** Run `npx structx ask "your question" --repo .`
-   instead of reading raw files. The graph provides function signatures, purposes,
-   relationships, and semantic metadata that raw file reads miss.
+### Step 2: Understand the codebase via StructX (NEVER skip this)
+Before writing ANY code, you MUST query StructX to understand the codebase:
+```
+npx structx overview --repo .
+npx structx ask "what types and interfaces exist?" --repo .
+npx structx ask "what routes/endpoints exist?" --repo .
+npx structx ask "how does <relevant feature> work?" --repo .
+```
+**You are FORBIDDEN from reading .ts source files to understand the codebase architecture,
+discover what functions exist, learn about types, or understand how features work.
+StructX provides all of this. Use it.**
 
-3. **After making code changes:** Run `npx structx ingest .` to update the function graph
-   with your changes.
+### Step 3: Read source files ONLY for editing
+You may ONLY use raw file reads (Read/cat) when you have ALREADY queried StructX and
+now need to see the exact code at a specific location to make an edit. The workflow is:
+1. Ask StructX what exists and where it is
+2. StructX tells you the file path and line numbers
+3. THEN read that specific file to make your edit
 
-4. **After ingestion queues new functions:** Run `npx structx analyze . --yes` to enrich
-   newly discovered or changed functions with semantic metadata.
+**Reading source files to "explore" or "understand" the codebase is PROHIBITED.
+That is what StructX is for.**
 
-5. **For impact analysis:** Before modifying a function, run
-   `npx structx ask "what breaks if I change <functionName>" --repo .`
-   to understand downstream effects.
+### Step 4: After making changes
+After editing any TypeScript files:
+```
+npx structx ingest .
+npx structx analyze . --yes
+```
+
+### Step 5: Impact analysis before modifying existing code
+Before changing any existing function, type, or route:
+```
+npx structx ask "what breaks if I change <name>?" --repo .
+```
 
 ## Available Commands
 
 | Command | Description |
 |---------|-------------|
-| `npx structx status` | Check if graph is initialized and view stats |
-| `npx structx setup .` | One-step bootstrap (init + ingest + analyze) |
+| `npx structx status` | Check graph state — ALWAYS run first |
+| `npx structx setup .` | Full bootstrap (init + ingest + analyze) |
+| `npx structx overview --repo .` | Full codebase summary in one shot |
+| `npx structx ask "<question>" --repo .` | Query the knowledge graph |
 | `npx structx ingest .` | Re-parse codebase after changes |
-| `npx structx analyze . --yes` | Run semantic analysis on new/changed functions |
-| `npx structx ask "question" --repo .` | Query the function graph |
+| `npx structx analyze . --yes` | Run semantic analysis on new/changed entities |
 
-## When to Use StructX vs Raw File Reads
+## Rules Summary
 
-- **Use StructX** for: understanding function purposes, finding callers/callees,
-  impact analysis, discovering related functions, understanding code architecture.
-- **Use raw file reads** for: viewing exact implementation details, making edits,
-  reading config files, non-TypeScript files.
+1. **ALWAYS** run `structx status` at session start
+2. **ALWAYS** run `structx setup .` if not initialized
+3. **ALWAYS** use `structx ask` or `structx overview` to understand the codebase
+4. **NEVER** read .ts files to explore/understand architecture — use StructX
+5. **ONLY** read .ts files when you know exactly what file+line to edit (from StructX output)
+6. **ALWAYS** run `structx ingest .` after making code changes
+7. **ALWAYS** run impact analysis before modifying existing functions