code-kg 0.1.0

package/dist/indexer/metrics.d.ts

@@ -0,0 +1,39 @@
+export interface DependencyEdge {
+    from: string;
+    to: string;
+    source: string;
+    specifiers: string[];
+}
+export interface ImportUsageEntry {
+    filePath: string;
+    source: string;
+    specifiers: string[];
+    resolvedPath?: string;
+}
+export interface ExportUsageEntry {
+    filePath: string;
+    name: string;
+    kind: string;
+}
+export interface SccCycle {
+    files: string[];
+    size: number;
+}
+export interface UnusedExport {
+    filePath: string;
+    name: string;
+    kind: string;
+}
+export interface DerivedMetrics {
+    cycles: SccCycle[];
+    fanIn: Record<string, number>;
+    fanOut: Record<string, number>;
+    unusedExports: UnusedExport[];
+}
+export interface MetricsInput {
+    files: string[];
+    dependencies: DependencyEdge[];
+    imports: ImportUsageEntry[];
+    exports: ExportUsageEntry[];
+}
+export declare function computeDerivedMetrics(input: MetricsInput): DerivedMetrics;

package/dist/indexer/metrics.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeDerivedMetrics = computeDerivedMetrics;
+function tarjan(nodes, adjacency) {
+    let index = 0;
+    const stack = [];
+    const onStack = new Set();
+    const indices = new Map();
+    const lowLink = new Map();
+    const components = [];
+    const strongConnect = (node) => {
+        indices.set(node, index);
+        lowLink.set(node, index);
+        index += 1;
+        stack.push(node);
+        onStack.add(node);
+        for (const neighbor of adjacency.get(node) ?? []) {
+            if (!indices.has(neighbor)) {
+                strongConnect(neighbor);
+                lowLink.set(node, Math.min(lowLink.get(node) ?? 0, lowLink.get(neighbor) ?? 0));
+            }
+            else if (onStack.has(neighbor)) {
+                lowLink.set(node, Math.min(lowLink.get(node) ?? 0, indices.get(neighbor) ?? 0));
+            }
+        }
+        if ((lowLink.get(node) ?? -1) === (indices.get(node) ?? -2)) {
+            const component = [];
+            while (stack.length > 0) {
+                const popped = stack.pop();
+                if (!popped) {
+                    break;
+                }
+                onStack.delete(popped);
+                component.push(popped);
+                if (popped === node) {
+                    break;
+                }
+            }
+            components.push(component.sort());
+        }
+    };
+    for (const node of nodes) {
+        if (!indices.has(node)) {
+            strongConnect(node);
+        }
+    }
+    return components;
+}
+function buildAdjacency(nodes, dependencies) {
+    const adjacency = new Map();
+    for (const node of nodes) {
+        adjacency.set(node, new Set());
+    }
+    for (const dependency of dependencies) {
+        if (!adjacency.has(dependency.from) || !adjacency.has(dependency.to)) {
+            continue;
+        }
+        adjacency.get(dependency.from)?.add(dependency.to);
+    }
+    return adjacency;
+}
+function computeFanMetrics(nodes, dependencies) {
+    const fanIn = {};
+    const fanOut = {};
+    for (const node of nodes) {
+        fanIn[node] = 0;
+        fanOut[node] = 0;
+    }
+    const uniqueEdges = new Set();
+    for (const dependency of dependencies) {
+        if (!(dependency.from in fanOut) || !(dependency.to in fanIn)) {
+            continue;
+        }
+        const edgeKey = `${dependency.from}::${dependency.to}`;
+        if (uniqueEdges.has(edgeKey)) {
+            continue;
+        }
+        uniqueEdges.add(edgeKey);
+        fanOut[dependency.from] += 1;
+        fanIn[dependency.to] += 1;
+    }
+    return { fanIn, fanOut };
+}
+function computeUnusedExports(exportsList, importsList) {
+    const usageByTarget = new Map();
+    for (const item of importsList) {
+        if (!item.resolvedPath) {
+            continue;
+        }
+        const existing = usageByTarget.get(item.resolvedPath) ?? new Set();
+        if (!item.specifiers || item.specifiers.length === 0) {
+            existing.add("*");
+        }
+        else {
+            for (const specifier of item.specifiers) {
+                existing.add(specifier);
+            }
+        }
+        usageByTarget.set(item.resolvedPath, existing);
+    }
+    const unused = [];
+    for (const item of exportsList) {
+        if (item.kind === "reexport" || item.kind === "all" || item.name === "*") {
+            continue;
+        }
+        const used = usageByTarget.get(item.filePath);
+        const isUsed = Boolean(used?.has("*")) ||
+            Boolean(used?.has(item.name)) ||
+            (item.kind === "default" && Boolean(used?.has("default")));
+        if (!isUsed) {
+            unused.push({
+                filePath: item.filePath,
+                name: item.name,
+                kind: item.kind,
+            });
+        }
+    }
+    return unused.sort((a, b) => a.filePath === b.filePath
+        ? a.name.localeCompare(b.name)
+        : a.filePath.localeCompare(b.filePath));
+}
+function computeDerivedMetrics(input) {
+    const files = [...new Set(input.files)].sort();
+    const adjacency = buildAdjacency(files, input.dependencies);
+    const components = tarjan(files, adjacency);
+    const cycles = components
+        .filter((component) => {
+        if (component.length > 1) {
+            return true;
+        }
+        const file = component[0];
+        return Boolean(file && adjacency.get(file)?.has(file));
+    })
+        .map((component) => ({
+        files: component,
+        size: component.length,
+    }))
+        .sort((a, b) => b.size - a.size || a.files[0].localeCompare(b.files[0]));
+    const { fanIn, fanOut } = computeFanMetrics(files, input.dependencies);
+    return {
+        cycles,
+        fanIn,
+        fanOut,
+        unusedExports: computeUnusedExports(input.exports, input.imports),
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/indexer/metrics.js.map

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

package/dist/indexer/structure-detector.d.ts

@@ -0,0 +1,16 @@
+export interface FrameworkDetection {
+    next: boolean;
+    express: boolean;
+}
+export interface ProjectStructure {
+    rootPath: string;
+    hasPackageJson: boolean;
+    hasTsConfig: boolean;
+    packageJsonPath?: string;
+    tsconfigPath?: string;
+    packageName?: string;
+    frameworks: FrameworkDetection;
+    sourceDirectories: string[];
+    entryPoints: string[];
+}
+export declare function detectProjectStructure(rootPath: string): ProjectStructure;

package/dist/indexer/structure-detector.js

@@ -0,0 +1,159 @@
+"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.detectProjectStructure = detectProjectStructure;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const SOURCE_DIRECTORY_CANDIDATES = [
+    "src",
+    "app",
+    "pages",
+    "server",
+    "lib",
+    "api",
+];
+const ENTRYPOINT_CANDIDATES = [
+    "src/index.ts",
+    "src/index.tsx",
+    "src/index.js",
+    "src/index.jsx",
+    "src/main.ts",
+    "src/main.tsx",
+    "src/main.js",
+    "src/main.jsx",
+    "index.ts",
+    "index.js",
+    "server.ts",
+    "server.js",
+    "app.ts",
+    "app.js",
+];
+function readJsonFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function hasDependency(pkg, depName) {
+    if (!pkg) {
+        return false;
+    }
+    return Boolean(pkg.dependencies?.[depName] ??
+        pkg.devDependencies?.[depName] ??
+        pkg.peerDependencies?.[depName]);
+}
+function detectFrameworks(rootPath, pkg) {
+    const nextFromDeps = hasDependency(pkg, "next");
+    const expressFromDeps = hasDependency(pkg, "express");
+    const scripts = Object.values(pkg?.scripts ?? {});
+    const nextFromScripts = scripts.some((script) => /\bnext\b/.test(script));
+    const nextFromFolders = fs.existsSync(path.join(rootPath, "app")) ||
+        fs.existsSync(path.join(rootPath, "pages")) ||
+        fs.existsSync(path.join(rootPath, "src", "app")) ||
+        fs.existsSync(path.join(rootPath, "src", "pages"));
+    return {
+        next: nextFromDeps || nextFromScripts || nextFromFolders,
+        express: expressFromDeps,
+    };
+}
+function detectSourceDirectories(rootPath, frameworks) {
+    const candidates = new Set(SOURCE_DIRECTORY_CANDIDATES.map((dirPath) => path.join(rootPath, dirPath)));
+    if (frameworks.next) {
+        candidates.add(path.join(rootPath, "src", "app"));
+        candidates.add(path.join(rootPath, "src", "pages"));
+        candidates.add(path.join(rootPath, "pages"));
+        candidates.add(path.join(rootPath, "app"));
+    }
+    const existing = [...candidates].filter((dirPath) => {
+        if (!fs.existsSync(dirPath)) {
+            return false;
+        }
+        try {
+            return fs.statSync(dirPath).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+    if (existing.length === 0) {
+        return [rootPath];
+    }
+    return existing.sort();
+}
+function detectEntryPoints(rootPath) {
+    return ENTRYPOINT_CANDIDATES.map((candidate) => path.join(rootPath, candidate))
+        .filter((absolutePath) => {
+        if (!fs.existsSync(absolutePath)) {
+            return false;
+        }
+        try {
+            return fs.statSync(absolutePath).isFile();
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort();
+}
+function detectProjectStructure(rootPath) {
+    const normalizedRoot = path.resolve(rootPath);
+    if (!fs.existsSync(normalizedRoot)) {
+        throw new Error(`Invalid root path: ${rootPath}`);
+    }
+    if (!fs.statSync(normalizedRoot).isDirectory()) {
+        throw new Error(`Root path is not a directory: ${rootPath}`);
+    }
+    const packageJsonPath = path.join(normalizedRoot, "package.json");
+    const tsconfigPath = path.join(normalizedRoot, "tsconfig.json");
+    const packageJson = readJsonFile(packageJsonPath);
+    const frameworks = detectFrameworks(normalizedRoot, packageJson);
+    return {
+        rootPath: normalizedRoot,
+        hasPackageJson: Boolean(packageJson),
+        hasTsConfig: fs.existsSync(tsconfigPath),
+        packageJsonPath: fs.existsSync(packageJsonPath) ? packageJsonPath : undefined,
+        tsconfigPath: fs.existsSync(tsconfigPath) ? tsconfigPath : undefined,
+        packageName: packageJson?.name,
+        frameworks,
+        sourceDirectories: detectSourceDirectories(normalizedRoot, frameworks),
+        entryPoints: detectEntryPoints(normalizedRoot),
+    };
+}
+//# sourceMappingURL=structure-detector.js.map

package/dist/indexer/structure-detector.js.map

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

package/dist/indexer/ts-parser.d.ts

@@ -0,0 +1,86 @@
+export type ParserKind = "typescript" | "babel";
+export interface SourceLocation {
+    line: number;
+    column: number;
+    endLine?: number;
+    endColumn?: number;
+}
+export interface ImportRecord {
+    source: string;
+    specifiers: string[];
+    isTypeOnly?: boolean;
+    resolvedPath?: string;
+    loc?: SourceLocation;
+}
+export interface ExportRecord {
+    name: string;
+    kind: "named" | "default" | "reexport" | "all";
+    from?: string;
+    isTypeOnly?: boolean;
+    localName?: string;
+    loc?: SourceLocation;
+}
+export interface FunctionRecord {
+    name: string;
+    exported: boolean;
+    async: boolean;
+    generator: boolean;
+    loc?: SourceLocation;
+}
+export interface ClassRecord {
+    name: string;
+    exported: boolean;
+    extends?: string;
+    implements?: string[];
+    loc?: SourceLocation;
+}
+export interface InterfaceRecord {
+    name: string;
+    exported: boolean;
+    loc?: SourceLocation;
+}
+export interface VariableRecord {
+    name: string;
+    kind: "const" | "let" | "var" | "unknown";
+    exported: boolean;
+    loc?: SourceLocation;
+}
+export interface ReferenceRecord {
+    name: string;
+    kind?: "identifier";
+    loc?: SourceLocation;
+}
+export interface CallRecord {
+    callee: string;
+    loc?: SourceLocation;
+}
+export interface RouteRecord {
+    framework: "express" | "next";
+    method?: string;
+    path: string;
+    kind: "handler" | "file";
+    filePath: string;
+    handlerName?: string;
+    loc?: SourceLocation;
+}
+export interface ParseExtraction {
+    filePath: string;
+    parser: ParserKind;
+    imports: ImportRecord[];
+    exports: ExportRecord[];
+    functions: FunctionRecord[];
+    classes: ClassRecord[];
+    interfaces: InterfaceRecord[];
+    variables: VariableRecord[];
+    references: ReferenceRecord[];
+    calls: CallRecord[];
+    routes: RouteRecord[];
+    parseError?: string;
+}
+export interface TypeScriptParseResult {
+    success: boolean;
+    diagnosticsCount: number;
+    extraction?: ParseExtraction;
+    error?: string;
+}
+export declare function parseWithTypeScript(filePath: string, fileContent: string): TypeScriptParseResult;