circle-ir 3.31.0 → 3.33.0

package/dist/core/extractors/runtime-registrations.js

@@ -0,0 +1,555 @@
+/**
+ * Runtime-registration extractor (issue #15 — Phases 1 + 2).
+ *
+ * Recognises framework registration patterns where a handler is wired into a
+ * dispatch table at module-load time. Static call extraction sees the
+ * registration call/decorator but not the edge from registrar → handler.
+ *
+ * Downstream consumers (e.g. dead-code reachability) read
+ * `ir.runtime_registrations` and add each resolved handler as a virtual entry
+ * root, eliminating "unreachable" false positives for framework handlers.
+ *
+ * Phase 1 — JS/TS Express-family (shipped 3.32.0):
+ *   - HTTP routes: `app.METHOD(path?, ...handlers)` for METHOD ∈ HTTP_VERBS
+ *   - Middleware: `app.use(...handlers)`
+ *   - Event listeners: `emitter.on('event', handler)` on express-shaped receivers
+ *
+ * Phase 2 — Python decorators (3.33.0):
+ *   - Every `@decorator` on a function emits a registration with handler =
+ *     decorated function. Known frameworks are tagged (flask, fastapi,
+ *     django, click, pytest, celery, numba); built-in (property,
+ *     staticmethod, etc.) is tagged `stdlib`. Routing-style decorators
+ *     (`@app.route`, `@app.get`, `@router.post`) are classified as
+ *     `kind: 'http_route'` so downstream consumers can treat JS routes and
+ *     Python routes uniformly.
+ *
+ * Out of scope (Phase 3):
+ *   - Rust trait dispatch (`impl Trait for Type`, `Box<dyn Trait>`,
+ *     `inventory::submit!`, `linkme::distributed_slice`).
+ *   - Subapp mounting (`app.use('/api', subApp)`) handler resolution.
+ */
+import { getNodeText, getNodesFromCache } from '../parser.js';
+/** HTTP verb methods recognised on Express-family routers. */
+const HTTP_VERB_METHODS = new Set([
+    'get', 'post', 'put', 'patch', 'delete',
+    'head', 'options', 'all',
+]);
+/** Middleware registration methods. */
+const MIDDLEWARE_METHODS = new Set(['use']);
+/** Event-listener methods (Node EventEmitter / WebSocket-style). */
+const EVENT_LISTENER_METHODS = new Set(['on', 'once', 'ws']);
+/** Receivers heuristically treated as express-family routers. */
+const EXPRESS_RECEIVER_NAMES = new Set([
+    'app', 'router', 'server', 'apiRouter',
+    // common framework instances
+    'fastify', 'koa', 'express',
+]);
+/** Module specifiers that, when imported, signal an Express-family framework. */
+const FRAMEWORK_MODULE_PATTERNS = [
+    /^express$/, /^@?fastify(\/.*)?$/, /^koa$/, /^restify$/, /^hapi$/,
+    /^@nestjs\/common$/, /^@nestjs\/core$/,
+];
+/**
+ * Extract runtime-registration patterns from a parsed file.
+ *
+ * Phase 1 covers JavaScript/TypeScript. Phase 2 adds Python decorators.
+ * Returns `[]` for any other language.
+ */
+export function extractRuntimeRegistrations(tree, cache, language, imports) {
+    if (language === 'javascript' || language === 'typescript') {
+        return extractJSRuntimeRegistrations(tree, cache, imports);
+    }
+    if (language === 'python') {
+        return extractPythonRuntimeRegistrations(tree, cache, imports);
+    }
+    return [];
+}
+function buildHandlerIndex(tree, cache, imports) {
+    const decls = new Map();
+    const recordDeclaration = (name, node) => {
+        if (!decls.has(name)) {
+            decls.set(name, {
+                line: node.startPosition.row + 1,
+                column: node.startPosition.column,
+            });
+        }
+    };
+    // function foo() {...}
+    for (const fn of getNodesFromCache(tree.rootNode, 'function_declaration', cache)) {
+        const nameNode = fn.childForFieldName('name');
+        if (nameNode)
+            recordDeclaration(getNodeText(nameNode), fn);
+    }
+    // const foo = (...) => ... ; const foo = function () { ... }
+    const collectVarDeclarators = (parentType) => {
+        for (const decl of getNodesFromCache(tree.rootNode, parentType, cache)) {
+            for (let i = 0; i < decl.childCount; i++) {
+                const child = decl.child(i);
+                if (!child || child.type !== 'variable_declarator')
+                    continue;
+                const nameNode = child.childForFieldName('name');
+                const valueNode = child.childForFieldName('value');
+                if (!nameNode || !valueNode)
+                    continue;
+                if (valueNode.type === 'arrow_function' ||
+                    valueNode.type === 'function_expression' ||
+                    valueNode.type === 'function') {
+                    recordDeclaration(getNodeText(nameNode), child);
+                }
+            }
+        }
+    };
+    collectVarDeclarators('lexical_declaration');
+    collectVarDeclarators('variable_declaration');
+    let hasFrameworkImport = false;
+    if (imports) {
+        for (const imp of imports) {
+            const mod = imp.from_package ?? '';
+            if (mod && FRAMEWORK_MODULE_PATTERNS.some(re => re.test(mod))) {
+                hasFrameworkImport = true;
+                break;
+            }
+        }
+    }
+    return { declarations: decls, hasFrameworkImport };
+}
+function extractJSRuntimeRegistrations(tree, cache, imports) {
+    const out = [];
+    const index = buildHandlerIndex(tree, cache, imports);
+    const callExpressions = getNodesFromCache(tree.rootNode, 'call_expression', cache);
+    for (const call of callExpressions) {
+        const fnNode = call.childForFieldName('function');
+        if (!fnNode || fnNode.type !== 'member_expression')
+            continue;
+        const objectNode = fnNode.childForFieldName('object');
+        const propertyNode = fnNode.childForFieldName('property');
+        if (!objectNode || !propertyNode)
+            continue;
+        const method = getNodeText(propertyNode);
+        const receiver = getNodeText(objectNode);
+        const kind = classifyMethod(method);
+        if (!kind)
+            continue;
+        // Receiver filtering: keep noise out. Either:
+        //  - the receiver name is a known router-ish identifier, OR
+        //  - a framework module is imported (relaxed: any member call with the
+        //    right method shape is considered).
+        if (!isExpressShapedReceiver(receiver) && !index.hasFrameworkImport) {
+            continue;
+        }
+        const argsNode = call.childForFieldName('arguments');
+        if (!argsNode)
+            continue;
+        const argNodes = getRealArgs(argsNode);
+        if (argNodes.length === 0)
+            continue;
+        // Path (literal first argument) is optional. Determine arg slice for handlers.
+        let path;
+        let handlerStart = 0;
+        const first = argNodes[0];
+        if (first.type === 'string') {
+            path = stripQuotes(getNodeText(first));
+            handlerStart = 1;
+        }
+        else if (first.type === 'template_string' && !hasTemplateSubstitution(first)) {
+            path = stripBackticks(getNodeText(first));
+            handlerStart = 1;
+        }
+        // For `.use(handler)` / `.on('event', handler)` / `.get('/p', h1, h2)` etc.
+        // Every remaining positional argument that is a function-like is a handler.
+        for (let i = handlerStart; i < argNodes.length; i++) {
+            const handlerNode = argNodes[i];
+            const handler = resolveHandler(handlerNode, index);
+            if (!handler)
+                continue;
+            out.push({
+                kind,
+                framework: inferFramework(receiver, index.hasFrameworkImport),
+                registrar: {
+                    method,
+                    receiver,
+                    line: call.startPosition.row + 1,
+                    column: call.startPosition.column,
+                },
+                ...(path !== undefined ? { path } : {}),
+                handler,
+            });
+        }
+    }
+    return out;
+}
+function classifyMethod(method) {
+    if (HTTP_VERB_METHODS.has(method))
+        return 'http_route';
+    if (MIDDLEWARE_METHODS.has(method))
+        return 'middleware';
+    if (EVENT_LISTENER_METHODS.has(method))
+        return 'event_listener';
+    return null;
+}
+function isExpressShapedReceiver(receiver) {
+    if (EXPRESS_RECEIVER_NAMES.has(receiver))
+        return true;
+    // Common naming: `apiRouter`, `userRouter`, `<x>Router`, `<x>App`
+    if (/(?:Router|App|Server)$/.test(receiver))
+        return true;
+    return false;
+}
+function inferFramework(receiver, hasFrameworkImport) {
+    if (receiver === 'fastify')
+        return 'fastify';
+    if (receiver === 'koa')
+        return 'koa';
+    if (receiver === 'express')
+        return 'express';
+    // Default heuristic: known express-shaped receivers default to express when
+    // a framework import is present; otherwise unknown.
+    return hasFrameworkImport ? 'express' : 'unknown';
+}
+/** Skip punctuation children inside `arguments` */
+function getRealArgs(argsNode) {
+    const out = [];
+    for (let i = 0; i < argsNode.childCount; i++) {
+        const child = argsNode.child(i);
+        if (!child)
+            continue;
+        if (child.type === '(' || child.type === ')' || child.type === ',')
+            continue;
+        out.push(child);
+    }
+    return out;
+}
+function stripQuotes(s) {
+    if (s.length >= 2 && (s[0] === '"' || s[0] === "'") && s[s.length - 1] === s[0]) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+function stripBackticks(s) {
+    if (s.length >= 2 && s[0] === '`' && s[s.length - 1] === '`') {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+function hasTemplateSubstitution(node) {
+    for (let i = 0; i < node.childCount; i++) {
+        const child = node.child(i);
+        if (child && child.type === 'template_substitution')
+            return true;
+    }
+    return false;
+}
+function resolveHandler(node, index) {
+    // Inline arrow / function expression — name=null, location is the lambda site.
+    if (node.type === 'arrow_function' ||
+        node.type === 'function_expression' ||
+        node.type === 'function') {
+        return {
+            name: null,
+            line: node.startPosition.row + 1,
+            column: node.startPosition.column,
+        };
+    }
+    // Named identifier — look up declaration site if available, else use call site.
+    if (node.type === 'identifier') {
+        const name = getNodeText(node);
+        const decl = index.declarations.get(name);
+        if (decl) {
+            return { name, line: decl.line, column: decl.column };
+        }
+        return {
+            name,
+            line: node.startPosition.row + 1,
+            column: node.startPosition.column,
+        };
+    }
+    // Member expression (e.g. controller.handle) — record the textual reference.
+    if (node.type === 'member_expression') {
+        return {
+            name: getNodeText(node),
+            line: node.startPosition.row + 1,
+            column: node.startPosition.column,
+        };
+    }
+    // Anything else (object literals, complex expressions): not a handler.
+    return null;
+}
+// =============================================================================
+// Python — Phase 2
+// =============================================================================
+/** HTTP-route decorator method names (after the dotted prefix). */
+const PY_HTTP_ROUTE_METHODS = new Set([
+    // Flask/Blueprint: app.route, blueprint.route, api.route
+    'route',
+    // FastAPI / Starlette / DRF method-specific
+    'get', 'post', 'put', 'patch', 'delete', 'head', 'options',
+    // Flask aliases (Flask 2.x): app.get/post/...
+]);
+/** Flask middleware-style decorators. */
+const PY_MIDDLEWARE_METHODS = new Set([
+    'before_request', 'after_request', 'teardown_request',
+    'before_first_request', 'teardown_appcontext',
+    // Starlette / FastAPI
+    'middleware',
+]);
+/** Event/lifecycle-style decorators. */
+const PY_EVENT_METHODS = new Set([
+    'errorhandler', 'on_event', 'exception_handler',
+    // Celery beat etc — not strictly events but lifecycle
+]);
+/** Python stdlib / built-in decorators that don't register externally. */
+const PY_STDLIB_DECORATORS = new Set([
+    'property', 'staticmethod', 'classmethod', 'abstractmethod', 'cached_property',
+    'dataclass', 'cache', 'lru_cache', 'singledispatch', 'singledispatchmethod',
+    'contextmanager', 'asynccontextmanager', 'final', 'override',
+    'wraps',
+]);
+function summarisePythonImports(imports) {
+    const s = {
+        hasFlask: false, hasFastApi: false, hasCelery: false,
+        hasNumba: false, hasClick: false, hasPytest: false,
+    };
+    if (!imports)
+        return s;
+    for (const imp of imports) {
+        const mod = imp.from_package ?? '';
+        if (!mod)
+            continue;
+        if (/^flask(\b|\.)/.test(mod))
+            s.hasFlask = true;
+        if (/^fastapi(\b|\.)/.test(mod) || /^starlette(\b|\.)/.test(mod))
+            s.hasFastApi = true;
+        if (/^celery(\b|\.)/.test(mod))
+            s.hasCelery = true;
+        if (/^numba(\b|\.)/.test(mod))
+            s.hasNumba = true;
+        if (/^click(\b|\.)/.test(mod))
+            s.hasClick = true;
+        if (/^pytest(\b|\.)/.test(mod))
+            s.hasPytest = true;
+    }
+    return s;
+}
+function extractPythonRuntimeRegistrations(tree, cache, imports) {
+    const out = [];
+    const importSummary = summarisePythonImports(imports);
+    const decoratedDefs = getNodesFromCache(tree.rootNode, 'decorated_definition', cache);
+    for (const dd of decoratedDefs) {
+        // Find the function_definition child (skip class_definition for now —
+        // class-level decorators are not the dead-code use case).
+        let fnNode = null;
+        const decorators = [];
+        for (let i = 0; i < dd.childCount; i++) {
+            const child = dd.child(i);
+            if (!child)
+                continue;
+            if (child.type === 'decorator') {
+                decorators.push(child);
+            }
+            else if (child.type === 'function_definition' || child.type === 'async_function_definition') {
+                fnNode = child;
+            }
+        }
+        if (!fnNode || decorators.length === 0)
+            continue;
+        const handler = pythonHandlerFromFunctionDef(fnNode);
+        if (!handler)
+            continue;
+        for (const dec of decorators) {
+            const parsed = parsePythonDecorator(dec);
+            if (!parsed)
+                continue;
+            const { receiver, method, path, line, column } = parsed;
+            const { kind, framework } = classifyPythonDecorator(receiver, method, importSummary);
+            out.push({
+                kind,
+                framework,
+                registrar: { method, receiver, line, column },
+                ...(path !== undefined ? { path } : {}),
+                handler,
+            });
+        }
+    }
+    return out;
+}
+function pythonHandlerFromFunctionDef(fn) {
+    const nameNode = fn.childForFieldName('name');
+    if (!nameNode)
+        return null;
+    return {
+        name: getNodeText(nameNode),
+        line: fn.startPosition.row + 1,
+        column: fn.startPosition.column,
+    };
+}
+/**
+ * Parse a `decorator` node into receiver/method/path components.
+ * The decorator wraps one of: `identifier`, `attribute`, or `call`.
+ */
+function parsePythonDecorator(dec) {
+    // Skip the leading `@` token; take the first non-trivial child.
+    let target = null;
+    for (let i = 0; i < dec.childCount; i++) {
+        const child = dec.child(i);
+        if (!child || child.type === '@')
+            continue;
+        target = child;
+        break;
+    }
+    if (!target)
+        return null;
+    const line = dec.startPosition.row + 1;
+    const column = dec.startPosition.column;
+    // @bare_decorator
+    if (target.type === 'identifier') {
+        return { receiver: '', method: getNodeText(target), line, column };
+    }
+    // @pkg.attr  (no call)
+    if (target.type === 'attribute') {
+        const { receiver, method } = splitDottedAttribute(target);
+        return { receiver, method, line, column };
+    }
+    // @pkg.attr(...) or @bare_decorator(...)
+    if (target.type === 'call') {
+        const fnNode = target.childForFieldName('function');
+        if (!fnNode)
+            return null;
+        let receiver = '';
+        let method = '';
+        if (fnNode.type === 'identifier') {
+            method = getNodeText(fnNode);
+        }
+        else if (fnNode.type === 'attribute') {
+            const split = splitDottedAttribute(fnNode);
+            receiver = split.receiver;
+            method = split.method;
+        }
+        else {
+            // Complex expression like `make_decorator()(...)` — record textual.
+            method = getNodeText(fnNode);
+        }
+        // Look at first positional arg for a literal string path.
+        const path = extractFirstStringArg(target);
+        return { receiver, method, path, line, column };
+    }
+    return null;
+}
+/** Split `a.b.c` into receiver=`a.b`, method=`c`. */
+function splitDottedAttribute(attr) {
+    const objectNode = attr.childForFieldName('object');
+    const attrNode = attr.childForFieldName('attribute');
+    const method = attrNode ? getNodeText(attrNode) : '';
+    const receiver = objectNode ? getNodeText(objectNode) : '';
+    return { receiver, method };
+}
+/** Extract first positional argument as a literal string if present. */
+function extractFirstStringArg(call) {
+    const argsNode = call.childForFieldName('arguments');
+    if (!argsNode)
+        return undefined;
+    for (let i = 0; i < argsNode.childCount; i++) {
+        const child = argsNode.child(i);
+        if (!child)
+            continue;
+        if (child.type === '(' || child.type === ')' || child.type === ',')
+            continue;
+        // First real argument
+        if (child.type === 'string') {
+            return stripPythonStringQuotes(getNodeText(child));
+        }
+        // Anything else as first positional arg → no path
+        return undefined;
+    }
+    return undefined;
+}
+function stripPythonStringQuotes(s) {
+    // Handle prefixes like b'', r'', u'', f'' — we don't need their semantics here.
+    const m = s.match(/^[bBrRuUfF]{0,2}(['"])(.*)\1$/s);
+    if (m)
+        return m[2];
+    if (s.length >= 2 && (s[0] === '"' || s[0] === "'") && s[s.length - 1] === s[0]) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+/**
+ * Classify a Python decorator into kind + framework.
+ *
+ * The classification cascade:
+ *   1. stdlib built-in (property, staticmethod, ...) → kind=decorator, framework=stdlib
+ *   2. `@<framework>.<method>` where framework is recognised
+ *   3. `@app.<http_verb>` / `@router.<http_verb>` / `@app.route` → http_route
+ *   4. Middleware / event hooks on Flask-like receivers
+ *   5. Generic decorator → kind=decorator, framework=unknown
+ */
+function classifyPythonDecorator(receiver, method, imp) {
+    // 1. stdlib built-ins (bare decorators, e.g. @property)
+    if (!receiver && PY_STDLIB_DECORATORS.has(method)) {
+        return { kind: 'decorator', framework: 'stdlib' };
+    }
+    // 2. Framework-prefixed decorators
+    if (receiver) {
+        const head = receiver.split('.')[0];
+        // pytest.fixture / pytest.mark.parametrize
+        if (head === 'pytest') {
+            return { kind: 'decorator', framework: 'pytest' };
+        }
+        if (head === 'click') {
+            return { kind: 'decorator', framework: 'click' };
+        }
+        if (head === 'numba' || head === 'nb') {
+            return { kind: 'decorator', framework: 'numba' };
+        }
+        if (head === 'celery') {
+            return { kind: 'decorator', framework: 'celery' };
+        }
+    }
+    // 3. HTTP-route decorators on app/router/blueprint/api receivers
+    if (receiver && PY_HTTP_ROUTE_METHODS.has(method)) {
+        const isRoutey = isPyRouterReceiver(receiver);
+        if (isRoutey) {
+            // Framework inference: import-driven
+            let framework = 'unknown';
+            if (imp.hasFlask)
+                framework = 'flask';
+            else if (imp.hasFastApi)
+                framework = 'fastapi';
+            else if (method === 'route')
+                framework = 'flask'; // Flask hallmark
+            else
+                framework = 'fastapi'; // verbs alone bias to FastAPI
+            return { kind: 'http_route', framework };
+        }
+    }
+    // 4. Middleware-style decorators
+    if (receiver && PY_MIDDLEWARE_METHODS.has(method)) {
+        return { kind: 'middleware', framework: imp.hasFlask ? 'flask' : (imp.hasFastApi ? 'fastapi' : 'unknown') };
+    }
+    // 5. Event-style decorators
+    if (receiver && PY_EVENT_METHODS.has(method)) {
+        return { kind: 'event_listener', framework: imp.hasFlask ? 'flask' : (imp.hasFastApi ? 'fastapi' : 'unknown') };
+    }
+    // 6. app.task / @<x>.task — celery if celery imported
+    if (method === 'task' && imp.hasCelery) {
+        return { kind: 'decorator', framework: 'celery' };
+    }
+    // 7. Django auth/method decorators (bare)
+    if (!receiver && (method === 'login_required' || method === 'require_http_methods' || method === 'api_view')) {
+        return { kind: 'decorator', framework: 'django' };
+    }
+    // Fallthrough
+    return { kind: 'decorator', framework: 'unknown' };
+}
+/** Names commonly used for Flask/FastAPI app/router/blueprint instances. */
+function isPyRouterReceiver(receiver) {
+    const head = receiver.split('.')[0];
+    if (!head)
+        return false;
+    if (['app', 'router', 'blueprint', 'bp', 'api', 'application'].includes(head))
+        return true;
+    // Suffix conventions: my_router, user_bp, etc.
+    if (/_(router|bp|blueprint|app|api)$/.test(head))
+        return true;
+    return false;
+}
+//# sourceMappingURL=runtime-registrations.js.map

package/dist/core/extractors/runtime-registrations.js.map

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

package/dist/core/index.d.ts

@@ -2,5 +2,5 @@
  * Core module index - re-exports parser and extractors
  */
 export { initParser, loadLanguage, createParser, createFreshParser, parse, disposeTree, walkTree, findNodes, findAncestor, getNodeText, collectAllNodes, getNodesFromCache, isInitialized, isLanguageLoaded, resetParser, type SupportedLanguage, type SyntaxNode, type Node, type NodeCache, type Language, type Tree, } from './parser.js';
-export { extractMeta, extractTypes, extractCalls, extractImports, extractExports, buildCFG, buildDFG, } from './extractors/index.js';
+export { extractMeta, extractTypes, extractCalls, extractImports, extractExports, buildCFG, buildDFG, extractRuntimeRegistrations, } from './extractors/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,IAAI,GACV,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,GACT,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,IAAI,GACV,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC"}

package/dist/core/index.js

@@ -4,5 +4,5 @@
 // Parser
 export { initParser, loadLanguage, createParser, createFreshParser, parse, disposeTree, walkTree, findNodes, findAncestor, getNodeText, collectAllNodes, getNodesFromCache, isInitialized, isLanguageLoaded, resetParser, } from './parser.js';
 // Extractors
-export { extractMeta, extractTypes, extractCalls, extractImports, extractExports, buildCFG, buildDFG, } from './extractors/index.js';
+export { extractMeta, extractTypes, extractCalls, extractImports, extractExports, buildCFG, buildDFG, extractRuntimeRegistrations, } from './extractors/index.js';
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS;AACT,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,WAAW,GAOZ,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,GACT,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS;AACT,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,WAAW,GAOZ,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC"}

package/dist/types/index.d.ts

@@ -513,6 +513,45 @@ export interface CircleIR {
     findings?: SastFinding[];
     /** Software metrics computed by metric passes (CK suite, Halstead, etc.). */
     metrics?: FileMetrics;
+    /**
+     * Runtime registration patterns (HTTP routes, middlewares, event listeners)
+     * that establish call-graph edges not visible in the static AST.
+     *
+     * Phase 1 (issue #15) covers JS/TS Express-family route registration.
+     * Consumers (e.g. cognium-ai dead-code) treat `handler` targets as virtual
+     * entry roots when computing reachability.
+     */
+    runtime_registrations?: RuntimeRegistration[];
+}
+/**
+ * A runtime registration recording that a handler is wired into a framework
+ * dispatch table at module-load time. See issue #15.
+ */
+export interface RuntimeRegistration {
+    kind: 'http_route' | 'middleware' | 'event_listener' | 'decorator';
+    framework?: 'express' | 'fastify' | 'koa' | 'nestjs' | 'flask' | 'fastapi' | 'django' | 'click' | 'pytest' | 'celery' | 'numba' | 'stdlib' | 'unknown';
+    /**
+     * The registration call site itself.
+     *  - JS Phase 1: `app.get(...)`, `router.use(...)`, `server.on(...)` — receiver
+     *    is the runtime object, method is the verb.
+     *  - Python Phase 2: a `@receiver.method` decorator — receiver is everything
+     *    before the last dotted segment (empty string for bare `@name`),
+     *    method is the last segment.
+     */
+    registrar: {
+        method: string;
+        receiver: string;
+        line: number;
+        column: number;
+    };
+    /** Literal route path or event name when the leading argument is a string literal. */
+    path?: string;
+    /** Resolved handler. `name === null` for inline arrow / function expression. */
+    handler: {
+        name: string | null;
+        line: number;
+        column: number;
+    };
 }
 export interface AnalysisResponse {
     success: boolean;