@fathippo/fathippo-context-engine 0.1.4 → 0.1.5

package/dist/profiler/import-analysis.js

@@ -0,0 +1,160 @@
+/**
+ * Import/require statement scanning across multiple languages.
+ * Counts import frequency per module to identify actual dependency usage.
+ */
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+// Regex patterns for import detection per language family
+const JS_TS_IMPORT = /(?:import\s+(?:[\w{},*\s]+\s+from\s+)?['"]([^'"]+)['"]|require\s*\(\s*['"]([^'"]+)['"]\s*\))/g;
+const PYTHON_IMPORT = /(?:^from\s+([\w.]+)\s+import|^import\s+([\w.]+))/gm;
+const GO_IMPORT = /(?:"([^"]+)")/g;
+const RUST_USE = /^use\s+([\w:]+)/gm;
+const C_INCLUDE = /^#include\s+[<"]([^>"]+)[>"]/gm;
+const JS_TS_EXTENSIONS = new Set(["ts", "tsx", "js", "jsx", "mjs", "cjs"]);
+const PYTHON_EXTENSIONS = new Set(["py"]);
+const GO_EXTENSIONS = new Set(["go"]);
+const RUST_EXTENSIONS = new Set(["rs"]);
+const C_EXTENSIONS = new Set(["c", "cpp", "h", "hpp"]);
+/** Max file size to scan (skip very large files). */
+const MAX_FILE_SIZE = 256 * 1024; // 256 KB
+/** Max files to scan for imports. */
+const MAX_FILES_TO_SCAN = 2000;
+export async function analyzeImports(workspaceRoot, files) {
+    const moduleCounts = new Map();
+    const fileImportCounts = new Map();
+    let scanned = 0;
+    for (const file of files) {
+        if (scanned >= MAX_FILES_TO_SCAN)
+            break;
+        const ext = file.split(".").pop()?.toLowerCase() ?? "";
+        if (!JS_TS_EXTENSIONS.has(ext) &&
+            !PYTHON_EXTENSIONS.has(ext) &&
+            !GO_EXTENSIONS.has(ext) &&
+            !RUST_EXTENSIONS.has(ext) &&
+            !C_EXTENSIONS.has(ext)) {
+            continue;
+        }
+        const fullPath = path.join(workspaceRoot, file);
+        let content;
+        try {
+            content = await readFile(fullPath, "utf-8");
+            if (content.length > MAX_FILE_SIZE)
+                continue;
+        }
+        catch {
+            continue;
+        }
+        scanned++;
+        const imports = extractImports(content, ext);
+        let importCount = 0;
+        for (const mod of imports) {
+            const normalized = normalizeModule(mod, ext);
+            if (!normalized)
+                continue;
+            moduleCounts.set(normalized, (moduleCounts.get(normalized) ?? 0) + 1);
+            importCount++;
+        }
+        if (importCount > 0) {
+            fileImportCounts.set(file, importCount);
+        }
+    }
+    // Top imports by frequency
+    const topImports = [...moduleCounts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 20)
+        .map(([module, count]) => ({ module, count }));
+    // Most imported files (files with most import statements referencing them)
+    // Count how many times each local file is imported by others
+    const localFileImports = new Map();
+    for (const [mod, count] of moduleCounts) {
+        if (mod.startsWith("./") || mod.startsWith("../") || mod.startsWith("@/")) {
+            localFileImports.set(mod, count);
+        }
+    }
+    const mostImportedFiles = [...localFileImports.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([filePath, importCount]) => ({ path: filePath, importCount }));
+    return {
+        topImports,
+        mostImportedFiles,
+    };
+}
+function extractImports(content, ext) {
+    const imports = [];
+    if (JS_TS_EXTENSIONS.has(ext)) {
+        for (const match of content.matchAll(JS_TS_IMPORT)) {
+            const mod = match[1] ?? match[2];
+            if (mod)
+                imports.push(mod);
+        }
+    }
+    else if (PYTHON_EXTENSIONS.has(ext)) {
+        for (const match of content.matchAll(PYTHON_IMPORT)) {
+            const mod = match[1] ?? match[2];
+            if (mod)
+                imports.push(mod);
+        }
+    }
+    else if (GO_EXTENSIONS.has(ext)) {
+        // Find import blocks
+        const importBlock = content.match(/import\s*\(([\s\S]*?)\)/);
+        if (importBlock) {
+            for (const match of importBlock[1].matchAll(GO_IMPORT)) {
+                if (match[1])
+                    imports.push(match[1]);
+            }
+        }
+        // Single imports
+        for (const match of content.matchAll(/^import\s+"([^"]+)"/gm)) {
+            if (match[1])
+                imports.push(match[1]);
+        }
+    }
+    else if (RUST_EXTENSIONS.has(ext)) {
+        for (const match of content.matchAll(RUST_USE)) {
+            if (match[1])
+                imports.push(match[1]);
+        }
+    }
+    else if (C_EXTENSIONS.has(ext)) {
+        for (const match of content.matchAll(C_INCLUDE)) {
+            if (match[1])
+                imports.push(match[1]);
+        }
+    }
+    return imports;
+}
+function normalizeModule(mod, ext) {
+    if (!mod || mod.length === 0)
+        return null;
+    if (JS_TS_EXTENSIONS.has(ext)) {
+        // For relative imports, keep as-is
+        if (mod.startsWith(".") || mod.startsWith("@/"))
+            return mod;
+        // For external deps, extract package name (handle scoped packages)
+        if (mod.startsWith("@")) {
+            const parts = mod.split("/");
+            return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : mod;
+        }
+        // Plain module name
+        return mod.split("/")[0] ?? mod;
+    }
+    if (PYTHON_EXTENSIONS.has(ext)) {
+        // Return top-level package
+        return mod.split(".")[0] ?? mod;
+    }
+    if (GO_EXTENSIONS.has(ext)) {
+        // Return full module path but trim to meaningful prefix
+        return mod;
+    }
+    if (RUST_EXTENSIONS.has(ext)) {
+        // Return crate name (first part before ::)
+        return mod.split("::")[0] ?? mod;
+    }
+    if (C_EXTENSIONS.has(ext)) {
+        return mod;
+    }
+    return mod;
+}
+//# sourceMappingURL=import-analysis.js.map

package/dist/profiler/import-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-analysis.js","sourceRoot":"","sources":["../../src/profiler/import-analysis.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,0DAA0D;AAC1D,MAAM,YAAY,GAAG,+FAA+F,CAAC;AACrH,MAAM,aAAa,GAAG,oDAAoD,CAAC;AAC3E,MAAM,SAAS,GAAG,gBAAgB,CAAC;AACnC,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AACrC,MAAM,SAAS,GAAG,gCAAgC,CAAC;AAEnD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAC3E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACtC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACxC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvD,qDAAqD;AACrD,MAAM,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,SAAS;AAE3C,qCAAqC;AACrC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,aAAqB,EACrB,KAAe;IAEf,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnD,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,iBAAiB;YAAE,MAAM;QAExC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACvD,IACE,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC;YAC1B,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC;YAC3B,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;YACvB,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;YACzB,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EACtB,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,aAAa;gBAAE,SAAS;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,OAAO,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7C,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC7C,IAAI,CAAC,UAAU;gBAAE,SAAS;YAC1B,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtE,WAAW,EAAE,CAAC;QAChB,CAAC;QAED,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,UAAU,GAAG,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC;SAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAEjD,2EAA2E;IAC3E,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACxC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1E,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,iBAAiB,GAAG,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,CAAC;SACtD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAEvE,OAAO;QACL,UAAU;QACV,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,GAAW;IAClD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACnD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YACjC,IAAI,GAAG;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;SAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACpD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YACjC,IAAI,GAAG;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;SAAM,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,qBAAqB;QACrB,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7D,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvD,IAAI,KAAK,CAAC,CAAC,CAAC;oBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,iBAAiB;QACjB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;YAC9D,IAAI,KAAK,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;SAAM,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,IAAI,KAAK,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;SAAM,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,GAAW,EAAE,GAAW;IAC/C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,mCAAmC;QACnC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC;QAC5D,mEAAmE;QACnE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7D,CAAC;QACD,oBAAoB;QACpB,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAClC,CAAC;IAED,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,2BAA2B;QAC3B,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAClC,CAAC;IAED,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,wDAAwD;QACxD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,2CAA2C;QAC3C,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACnC,CAAC;IAED,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/profiler/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Codebase Profiler — Main orchestrator.
+ *
+ * Profiles a workspace by scanning file tree, detecting frameworks,
+ * analyzing git history, and computing import frequency. Stores the
+ * result to `.fathippo/codebase-profile.json`.
+ */
+import type { CodebaseProfile, ProfileConfig } from "./types.js";
+export type { CodebaseProfile, ProfileConfig, TechStack, ScanResult, GitAnalysis, ImportAnalysis, ScanOptions } from "./types.js";
+export { scanFileTree } from "./scanner.js";
+export { detectTechStack } from "./framework-detection.js";
+export { analyzeGitHistory } from "./git-analysis.js";
+export { analyzeImports } from "./import-analysis.js";
+export { deriveWorkspaceId } from "./workspace-id.js";
+export { formatCodebaseProfileForInjection } from "./serializer.js";
+/**
+ * Profile a codebase. If a cached profile exists on disk and `force` is false,
+ * returns the cached version.
+ */
+export declare function profileCodebase(workspaceRoot: string, options?: ProfileConfig): Promise<CodebaseProfile>;
+/**
+ * Load a cached profile from disk.
+ */
+export declare function loadCodebaseProfile(workspaceRoot: string): Promise<CodebaseProfile | null>;
+/**
+ * Save a profile to disk at `.fathippo/codebase-profile.json`.
+ */
+export declare function saveCodebaseProfile(workspaceRoot: string, profile: CodebaseProfile): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/profiler/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQjE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClI,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AAKpE;;;GAGG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,eAAe,CAAC,CA8H1B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAYhG;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/profiler/index.js

@@ -0,0 +1,176 @@
+/**
+ * Codebase Profiler — Main orchestrator.
+ *
+ * Profiles a workspace by scanning file tree, detecting frameworks,
+ * analyzing git history, and computing import frequency. Stores the
+ * result to `.fathippo/codebase-profile.json`.
+ */
+import { existsSync } from "node:fs";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { scanFileTree } from "./scanner.js";
+import { detectTechStack } from "./framework-detection.js";
+import { analyzeGitHistory, getHeadCommit } from "./git-analysis.js";
+import { analyzeImports } from "./import-analysis.js";
+export { scanFileTree } from "./scanner.js";
+export { detectTechStack } from "./framework-detection.js";
+export { analyzeGitHistory } from "./git-analysis.js";
+export { analyzeImports } from "./import-analysis.js";
+export { deriveWorkspaceId } from "./workspace-id.js";
+export { formatCodebaseProfileForInjection } from "./serializer.js";
+const PROFILE_DIR = ".fathippo";
+const PROFILE_FILE = "codebase-profile.json";
+/**
+ * Profile a codebase. If a cached profile exists on disk and `force` is false,
+ * returns the cached version.
+ */
+export async function profileCodebase(workspaceRoot, options) {
+    // Check for cached profile unless force
+    if (!options?.force) {
+        const cached = await loadCodebaseProfile(workspaceRoot);
+        if (cached)
+            return cached;
+    }
+    // Run all analyses in parallel
+    const [scanResult, techStack, gitResult, headCommit] = await Promise.all([
+        scanFileTree(workspaceRoot, {
+            maxFiles: options?.maxFiles ?? 5000,
+            maxDepth: options?.maxDepth ?? 4,
+            extraIgnorePatterns: options?.extraIgnorePatterns,
+        }),
+        detectTechStack(workspaceRoot),
+        analyzeGitHistory(workspaceRoot).catch(() => ({
+            totalCommits: 0,
+            activeContributors: 0,
+            mostActiveDirectories: [],
+            branchingModel: "unknown",
+            hotspots: [],
+        })),
+        Promise.resolve(getHeadCommit(workspaceRoot)),
+    ]);
+    // Import analysis depends on scan result
+    const importResult = await analyzeImports(workspaceRoot, scanResult.allFiles).catch(() => ({
+        topImports: [],
+        mostImportedFiles: [],
+    }));
+    // Merge language breakdown into tech stack
+    techStack.languages = [...scanResult.languageBreakdown.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .filter(([, pct]) => pct >= 1)
+        .map(([name, percentage]) => ({ name, percentage }));
+    // Build hotspots
+    const hotspots = [];
+    // Git hotspots (most changed)
+    for (const hs of gitResult.hotspots.slice(0, 8)) {
+        hotspots.push({
+            path: hs.path,
+            reason: "most-changed",
+            metric: hs.commits,
+        });
+    }
+    // Size hotspots (largest files not already listed)
+    const hotspotPaths = new Set(hotspots.map((h) => h.path));
+    for (const file of scanResult.largestFiles.slice(0, 5)) {
+        if (!hotspotPaths.has(file.path)) {
+            hotspots.push({
+                path: file.path,
+                reason: "largest",
+                metric: file.loc,
+            });
+            hotspotPaths.add(file.path);
+        }
+    }
+    // Import hotspots (most imported local files)
+    for (const file of importResult.mostImportedFiles.slice(0, 3)) {
+        if (!hotspotPaths.has(file.path)) {
+            hotspots.push({
+                path: file.path,
+                reason: "most-imported",
+                metric: file.importCount,
+            });
+            hotspotPaths.add(file.path);
+        }
+    }
+    // Top direct dependencies by actual import usage
+    const topDirect = importResult.topImports
+        .filter((imp) => !imp.module.startsWith(".") && !imp.module.startsWith("@/") && !imp.module.startsWith("node:"))
+        .slice(0, 10)
+        .map((imp) => imp.module);
+    // Peer projects (monorepo cross-package deps)
+    const peerProjects = importResult.topImports
+        .filter((imp) => imp.module.startsWith("@") && scanResult.workspaces.some((ws) => imp.module.includes(path.basename(ws))))
+        .map((imp) => imp.module);
+    // Assemble profile
+    const profile = {
+        version: 1,
+        generatedAt: new Date().toISOString(),
+        generatedFromCommit: headCommit,
+        workspaceRoot,
+        techStack,
+        structure: {
+            type: scanResult.structureType,
+            entryPoints: scanResult.entryPoints,
+            workspaces: scanResult.workspaces.length > 0 ? scanResult.workspaces : undefined,
+            totalFiles: scanResult.totalFiles,
+            totalDirectories: scanResult.totalDirectories,
+            fileTreeSummary: scanResult.fileTreeSummary,
+        },
+        hotspots: hotspots.slice(0, 15),
+        dependencies: {
+            topDirect,
+            peerProjects: peerProjects.length > 0 ? peerProjects : undefined,
+        },
+        git: {
+            totalCommits: gitResult.totalCommits,
+            activeContributors: gitResult.activeContributors,
+            mostActiveDirectories: gitResult.mostActiveDirectories,
+            branchingModel: gitResult.branchingModel,
+        },
+        architecture: {
+            summary: "Profile generated with free-data analysis. Run with LLM summarization for architectural insights.",
+            patterns: [],
+            conventions: [],
+        },
+    };
+    // Save to disk
+    await saveCodebaseProfile(workspaceRoot, profile);
+    return profile;
+}
+/**
+ * Load a cached profile from disk.
+ */
+export async function loadCodebaseProfile(workspaceRoot) {
+    const profilePath = getProfilePath(workspaceRoot);
+    if (!existsSync(profilePath))
+        return null;
+    try {
+        const content = await readFile(profilePath, "utf-8");
+        const profile = JSON.parse(content);
+        if (profile.version !== 1)
+            return null;
+        return profile;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save a profile to disk at `.fathippo/codebase-profile.json`.
+ */
+export async function saveCodebaseProfile(workspaceRoot, profile) {
+    const dir = path.join(workspaceRoot, PROFILE_DIR);
+    try {
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true });
+        }
+        const profilePath = path.join(dir, PROFILE_FILE);
+        await writeFile(profilePath, JSON.stringify(profile, null, 2), "utf-8");
+    }
+    catch (error) {
+        console.error("[FatHippo Profiler] Failed to save profile:", error);
+    }
+}
+function getProfilePath(workspaceRoot) {
+    return path.join(workspaceRoot, PROFILE_DIR, PROFILE_FILE);
+}
+//# sourceMappingURL=index.js.map

package/dist/profiler/index.js.map

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

package/dist/profiler/scanner.d.ts

@@ -0,0 +1,6 @@
+/**
+ * File tree scanner with ignore patterns, LOC counting, and structure detection.
+ */
+import type { ScanOptions, ScanResult } from "./types.js";
+export declare function scanFileTree(workspaceRoot: string, options?: ScanOptions): Promise<ScanResult>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/profiler/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/profiler/scanner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAsG1D,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAyGrB"}