kirograph 0.17.0 → 0.19.0

package/dist/frameworks/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/frameworks/index.ts"],
-  "sourcesContent": ["/**\n * Framework Resolver Registry\n *\n * Mirrors CodeGraph src/resolution/frameworks/index.ts\n * Manages framework-specific resolvers and detection.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { logDebug, logWarn } from '../errors';\nimport { updateConfig } from '../config';\nimport type { Node } from '../types';\nimport type { GraphDatabase } from '../db/database';\nimport type { FrameworkResolver, ResolutionContext } from './types';\n\n// Re-export types\nexport type { FrameworkResolver, ResolutionContext, UnresolvedRef, ResolvedRef } from './types';\n\n// Re-export individual resolvers\nexport { reactResolver } from './react';\nexport { svelteResolver } from './svelte';\nexport { expressResolver } from './express';\nexport { djangoResolver, flaskResolver, fastapiResolver } from './python';\nexport { railsResolver } from './ruby';\nexport { springResolver } from './java';\nexport { goResolver } from './go';\nexport { rustResolver } from './rust';\nexport { aspnetResolver } from './csharp';\nexport { swiftUIResolver, uikitResolver, vaporResolver } from './swift';\nexport { laravelResolver, FACADE_MAPPINGS } from './laravel';\nexport { phoenixResolver } from './elixir';\nexport { playResolver } from './scala';\nexport { nuxtResolver, vueResolver } from './vue';\nexport { solidityResolver } from './solidity';\nexport { sstResolver, cdkResolver, serverlessResolver, samResolver } from './iac';\nexport { terraformResolver } from './terraform';\nexport { pulumiResolver } from './pulumi';\nexport { cloudformationResolver } from './cloudformation';\nexport { kubernetesResolver } from './kubernetes';\nexport { dockerComposeResolver } from './docker';\nexport { ansibleResolver } from './ansible';\nexport { angularResolver } from './angular';\nexport { amplifyResolver } from './amplify';\n\n// \u2500\u2500 Registry \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nimport { reactResolver } from './react';\nimport { svelteResolver } from './svelte';\nimport { expressResolver } from './express';\nimport { djangoResolver, flaskResolver, fastapiResolver } from './python';\nimport { railsResolver } from './ruby';\nimport { springResolver } from './java';\nimport { goResolver } from './go';\nimport { rustResolver } from './rust';\nimport { aspnetResolver } from './csharp';\nimport { swiftUIResolver, uikitResolver, vaporResolver } from './swift';\nimport { laravelResolver } from './laravel';\nimport { phoenixResolver } from './elixir';\nimport { playResolver } from './scala';\nimport { nuxtResolver, vueResolver } from './vue';\nimport { solidityResolver } from './solidity';\nimport { sstResolver, cdkResolver, serverlessResolver, samResolver } from './iac';\nimport { terraformResolver } from './terraform';\nimport { pulumiResolver } from './pulumi';\nimport { cloudformationResolver } from './cloudformation';\nimport { kubernetesResolver } from './kubernetes';\nimport { dockerComposeResolver } from './docker';\nimport { ansibleResolver } from './ansible';\nimport { angularResolver } from './angular';\nimport { amplifyResolver } from './amplify';\n\nconst FRAMEWORK_RESOLVERS: FrameworkResolver[] = [\n  // PHP\n  laravelResolver,\n  // JavaScript / TypeScript\n  expressResolver,\n  reactResolver,\n  svelteResolver,\n  angularResolver,\n  // Vue / Nuxt\n  nuxtResolver,\n  vueResolver,\n  // Python\n  djangoResolver,\n  flaskResolver,\n  fastapiResolver,\n  // Ruby\n  railsResolver,\n  // Java\n  springResolver,\n  // Go\n  goResolver,\n  // Rust\n  rustResolver,\n  // C#\n  aspnetResolver,\n  // Swift\n  swiftUIResolver,\n  uikitResolver,\n  vaporResolver,\n  // Elixir\n  phoenixResolver,\n  // Scala\n  playResolver,\n  // Solidity\n  solidityResolver,\n  // Infrastructure as Code\n  sstResolver,\n  cdkResolver,\n  serverlessResolver,\n  samResolver,\n  terraformResolver,\n  pulumiResolver,\n  cloudformationResolver,\n  amplifyResolver,\n  // Containers & Orchestration\n  kubernetesResolver,\n  dockerComposeResolver,\n  // Configuration Management\n  ansibleResolver,\n];\n\nexport function getAllFrameworkResolvers(): FrameworkResolver[] {\n  return FRAMEWORK_RESOLVERS;\n}\n\nexport function getFrameworkResolver(name: string): FrameworkResolver | undefined {\n  return FRAMEWORK_RESOLVERS.find(r => r.name === name);\n}\n\nexport function registerFrameworkResolver(resolver: FrameworkResolver): void {\n  const index = FRAMEWORK_RESOLVERS.findIndex(r => r.name === resolver.name);\n  if (index !== -1) FRAMEWORK_RESOLVERS.splice(index, 1);\n  FRAMEWORK_RESOLVERS.push(resolver);\n}\n\n// \u2500\u2500 Context builder \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction buildResolutionContext(projectRoot: string, db: GraphDatabase): ResolutionContext {\n  const fileCache = new Map<string, string | null>();\n  const nodeCache = new Map<string, Node[]>();\n\n  return {\n    getNodesInFile(filePath: string): Node[] {\n      if (!nodeCache.has(filePath)) {\n        nodeCache.set(filePath, db.getNodesByFile(filePath));\n      }\n      return nodeCache.get(filePath)!;\n    },\n    getNodesByName(name: string): Node[] {\n      return db.findNodesByExactName(name);\n    },\n    getNodesByKind(kind: Node['kind']): Node[] {\n      return db.getNodesByKind(kind);\n    },\n    fileExists(filePath: string): boolean {\n      return fs.existsSync(path.join(projectRoot, filePath));\n    },\n    readFile(filePath: string): string | null {\n      if (fileCache.has(filePath)) return fileCache.get(filePath)!;\n      try {\n        const content = fs.readFileSync(path.join(projectRoot, filePath), 'utf8');\n        fileCache.set(filePath, content);\n        return content;\n      } catch {\n        fileCache.set(filePath, null);\n        return null;\n      }\n    },\n    getProjectRoot(): string {\n      return projectRoot;\n    },\n    getAllFiles(): string[] {\n      return db.getAllFiles().map(f => f.path);\n    },\n  };\n}\n\n// \u2500\u2500 detectFrameworks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Detect which frameworks are used in a project.\n * Mirrors CodeGraph detectFrameworks() \u2014 uses ResolutionContext for file access.\n * Records detected framework names in config via updateConfig().\n */\nexport async function detectFrameworks(projectRoot: string, db?: GraphDatabase): Promise<FrameworkResolver[]> {\n  // If no db provided, fall back to package.json-only detection\n  if (!db) {\n    return detectFromPackageJson(projectRoot);\n  }\n\n  const context = buildResolutionContext(projectRoot, db);\n  const detected: FrameworkResolver[] = [];\n\n  for (const resolver of FRAMEWORK_RESOLVERS) {\n    try {\n      if (resolver.detect(context)) {\n        logDebug(`detectFrameworks: detected ${resolver.name}`);\n        detected.push(resolver);\n      }\n    } catch (err) {\n      logWarn(`detectFrameworks: error detecting ${resolver.name}`, { error: String(err) });\n    }\n  }\n\n  if (detected.length > 0) {\n    await updateConfig(projectRoot, { frameworkHints: detected.map(f => f.name) });\n  }\n\n  return detected;\n}\n\n/**\n * Lightweight fallback: detect frameworks from package.json only (no DB needed).\n */\nasync function detectFromPackageJson(projectRoot: string): Promise<FrameworkResolver[]> {\n  const pkgPath = path.join(projectRoot, 'package.json');\n  if (!fs.existsSync(pkgPath)) return [];\n\n  let pkg: Record<string, unknown>;\n  try {\n    pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8')) as Record<string, unknown>;\n  } catch {\n    return [];\n  }\n\n  const deps: Record<string, string> = {\n    ...((pkg.dependencies as Record<string, string>) ?? {}),\n    ...((pkg.devDependencies as Record<string, string>) ?? {}),\n  };\n\n  const PACKAGE_TO_RESOLVER: Record<string, string> = {\n    react: 'react', next: 'react', 'react-native': 'react',\n    svelte: 'svelte', '@sveltejs/kit': 'svelte',\n    express: 'express', fastify: 'express', koa: 'express',\n  };\n\n  const detectedNames = new Set<string>();\n  const detected: FrameworkResolver[] = [];\n\n  for (const [pkg, resolverName] of Object.entries(PACKAGE_TO_RESOLVER)) {\n    if (Object.prototype.hasOwnProperty.call(deps, pkg) && !detectedNames.has(resolverName)) {\n      const resolver = getFrameworkResolver(resolverName);\n      if (resolver) {\n        detectedNames.add(resolverName);\n        detected.push(resolver);\n      }\n    }\n  }\n\n  if (detected.length > 0) {\n    await updateConfig(projectRoot, { frameworkHints: detected.map(f => f.name) });\n  }\n\n  return detected;\n}\n"],
-  "mappings": "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",
-  "names": ["import_react", "import_svelte", "import_express", "import_python", "import_ruby", "import_java", "import_go", "import_rust", "import_csharp", "import_swift", "import_laravel", "import_elixir", "import_scala", "import_vue", "import_solidity", "import_iac", "import_terraform", "import_pulumi", "import_cloudformation", "import_kubernetes", "import_docker", "import_ansible", "import_angular", "import_amplify", "pkg"]
+  "sourcesContent": ["/**\n * Framework Resolver Registry\n *\n * Mirrors CodeGraph src/resolution/frameworks/index.ts\n * Manages framework-specific resolvers and detection.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { logDebug, logWarn } from '../errors';\nimport { updateConfig } from '../config';\nimport type { Node } from '../types';\nimport type { GraphDatabase } from '../db/database';\nimport type { FrameworkResolver, ResolutionContext } from './types';\n\n// Re-export types\nexport type { FrameworkResolver, ResolutionContext, UnresolvedRef, ResolvedRef } from './types';\n\n// Re-export individual resolvers\nexport { reactResolver } from './react';\nexport { svelteResolver } from './svelte';\nexport { expressResolver } from './express';\nexport { djangoResolver, flaskResolver, fastapiResolver } from './python';\nexport { railsResolver } from './ruby';\nexport { springResolver } from './java';\nexport { goResolver } from './go';\nexport { rustResolver } from './rust';\nexport { aspnetResolver } from './csharp';\nexport { swiftUIResolver, uikitResolver, vaporResolver } from './swift';\nexport { laravelResolver, FACADE_MAPPINGS } from './laravel';\nexport { phoenixResolver } from './elixir';\nexport { playResolver } from './scala';\nexport { nuxtResolver, vueResolver } from './vue';\nexport { solidityResolver } from './solidity';\nexport { sstResolver, cdkResolver, serverlessResolver, samResolver } from './iac';\nexport { terraformResolver } from './terraform';\nexport { pulumiResolver } from './pulumi';\nexport { cloudformationResolver } from './cloudformation';\nexport { kubernetesResolver } from './kubernetes';\nexport { dockerComposeResolver } from './docker';\nexport { ansibleResolver } from './ansible';\nexport { angularResolver } from './angular';\nexport { amplifyResolver } from './amplify';\nexport { flutterResolver } from './flutter';\n\n// \u2500\u2500 Registry \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nimport { reactResolver } from './react';\nimport { svelteResolver } from './svelte';\nimport { expressResolver } from './express';\nimport { djangoResolver, flaskResolver, fastapiResolver } from './python';\nimport { railsResolver } from './ruby';\nimport { springResolver } from './java';\nimport { goResolver } from './go';\nimport { rustResolver } from './rust';\nimport { aspnetResolver } from './csharp';\nimport { swiftUIResolver, uikitResolver, vaporResolver } from './swift';\nimport { laravelResolver } from './laravel';\nimport { phoenixResolver } from './elixir';\nimport { playResolver } from './scala';\nimport { nuxtResolver, vueResolver } from './vue';\nimport { solidityResolver } from './solidity';\nimport { sstResolver, cdkResolver, serverlessResolver, samResolver } from './iac';\nimport { terraformResolver } from './terraform';\nimport { pulumiResolver } from './pulumi';\nimport { cloudformationResolver } from './cloudformation';\nimport { kubernetesResolver } from './kubernetes';\nimport { dockerComposeResolver } from './docker';\nimport { ansibleResolver } from './ansible';\nimport { angularResolver } from './angular';\nimport { amplifyResolver } from './amplify';\nimport { flutterResolver } from './flutter';\n\nconst FRAMEWORK_RESOLVERS: FrameworkResolver[] = [\n  // PHP\n  laravelResolver,\n  // JavaScript / TypeScript\n  expressResolver,\n  reactResolver,\n  svelteResolver,\n  angularResolver,\n  // Vue / Nuxt\n  nuxtResolver,\n  vueResolver,\n  // Python\n  djangoResolver,\n  flaskResolver,\n  fastapiResolver,\n  // Ruby\n  railsResolver,\n  // Java\n  springResolver,\n  // Go\n  goResolver,\n  // Rust\n  rustResolver,\n  // C#\n  aspnetResolver,\n  // Swift\n  swiftUIResolver,\n  uikitResolver,\n  vaporResolver,\n  // Elixir\n  phoenixResolver,\n  // Scala\n  playResolver,\n  // Solidity\n  solidityResolver,\n  // Infrastructure as Code\n  sstResolver,\n  cdkResolver,\n  serverlessResolver,\n  samResolver,\n  terraformResolver,\n  pulumiResolver,\n  cloudformationResolver,\n  amplifyResolver,\n  // Containers & Orchestration\n  kubernetesResolver,\n  dockerComposeResolver,\n  // Configuration Management\n  ansibleResolver,\n  // Dart / Flutter\n  flutterResolver,\n];\n\nexport function getAllFrameworkResolvers(): FrameworkResolver[] {\n  return FRAMEWORK_RESOLVERS;\n}\n\nexport function getFrameworkResolver(name: string): FrameworkResolver | undefined {\n  return FRAMEWORK_RESOLVERS.find(r => r.name === name);\n}\n\nexport function registerFrameworkResolver(resolver: FrameworkResolver): void {\n  const index = FRAMEWORK_RESOLVERS.findIndex(r => r.name === resolver.name);\n  if (index !== -1) FRAMEWORK_RESOLVERS.splice(index, 1);\n  FRAMEWORK_RESOLVERS.push(resolver);\n}\n\n// \u2500\u2500 Context builder \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction buildResolutionContext(projectRoot: string, db: GraphDatabase): ResolutionContext {\n  const fileCache = new Map<string, string | null>();\n  const nodeCache = new Map<string, Node[]>();\n\n  return {\n    getNodesInFile(filePath: string): Node[] {\n      if (!nodeCache.has(filePath)) {\n        nodeCache.set(filePath, db.getNodesByFile(filePath));\n      }\n      return nodeCache.get(filePath)!;\n    },\n    getNodesByName(name: string): Node[] {\n      return db.findNodesByExactName(name);\n    },\n    getNodesByKind(kind: Node['kind']): Node[] {\n      return db.getNodesByKind(kind);\n    },\n    fileExists(filePath: string): boolean {\n      return fs.existsSync(path.join(projectRoot, filePath));\n    },\n    readFile(filePath: string): string | null {\n      if (fileCache.has(filePath)) return fileCache.get(filePath)!;\n      try {\n        const content = fs.readFileSync(path.join(projectRoot, filePath), 'utf8');\n        fileCache.set(filePath, content);\n        return content;\n      } catch {\n        fileCache.set(filePath, null);\n        return null;\n      }\n    },\n    getProjectRoot(): string {\n      return projectRoot;\n    },\n    getAllFiles(): string[] {\n      return db.getAllFiles().map(f => f.path);\n    },\n  };\n}\n\n// \u2500\u2500 detectFrameworks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Detect which frameworks are used in a project.\n * Mirrors CodeGraph detectFrameworks() \u2014 uses ResolutionContext for file access.\n * Records detected framework names in config via updateConfig().\n */\nexport async function detectFrameworks(projectRoot: string, db?: GraphDatabase): Promise<FrameworkResolver[]> {\n  // If no db provided, fall back to package.json-only detection\n  if (!db) {\n    return detectFromPackageJson(projectRoot);\n  }\n\n  const context = buildResolutionContext(projectRoot, db);\n  const detected: FrameworkResolver[] = [];\n\n  for (const resolver of FRAMEWORK_RESOLVERS) {\n    try {\n      if (resolver.detect(context)) {\n        logDebug(`detectFrameworks: detected ${resolver.name}`);\n        detected.push(resolver);\n      }\n    } catch (err) {\n      logWarn(`detectFrameworks: error detecting ${resolver.name}`, { error: String(err) });\n    }\n  }\n\n  if (detected.length > 0) {\n    await updateConfig(projectRoot, { frameworkHints: detected.map(f => f.name) });\n  }\n\n  return detected;\n}\n\n/**\n * Lightweight fallback: detect frameworks from package.json only (no DB needed).\n */\nasync function detectFromPackageJson(projectRoot: string): Promise<FrameworkResolver[]> {\n  const pkgPath = path.join(projectRoot, 'package.json');\n  if (!fs.existsSync(pkgPath)) return [];\n\n  let pkg: Record<string, unknown>;\n  try {\n    pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8')) as Record<string, unknown>;\n  } catch {\n    return [];\n  }\n\n  const deps: Record<string, string> = {\n    ...((pkg.dependencies as Record<string, string>) ?? {}),\n    ...((pkg.devDependencies as Record<string, string>) ?? {}),\n  };\n\n  const PACKAGE_TO_RESOLVER: Record<string, string> = {\n    react: 'react', next: 'react', 'react-native': 'react',\n    svelte: 'svelte', '@sveltejs/kit': 'svelte',\n    express: 'express', fastify: 'express', koa: 'express',\n  };\n\n  const detectedNames = new Set<string>();\n  const detected: FrameworkResolver[] = [];\n\n  for (const [pkg, resolverName] of Object.entries(PACKAGE_TO_RESOLVER)) {\n    if (Object.prototype.hasOwnProperty.call(deps, pkg) && !detectedNames.has(resolverName)) {\n      const resolver = getFrameworkResolver(resolverName);\n      if (resolver) {\n        detectedNames.add(resolverName);\n        detected.push(resolver);\n      }\n    }\n  }\n\n  if (detected.length > 0) {\n    await updateConfig(projectRoot, { frameworkHints: detected.map(f => f.name) });\n  }\n\n  return detected;\n}\n"],
+  "mappings": "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",
+  "names": ["import_react", "import_svelte", "import_express", "import_python", "import_ruby", "import_java", "import_go", "import_rust", "import_csharp", "import_swift", "import_laravel", "import_elixir", "import_scala", "import_vue", "import_solidity", "import_iac", "import_terraform", "import_pulumi", "import_cloudformation", "import_kubernetes", "import_docker", "import_ansible", "import_angular", "import_amplify", "import_flutter", "pkg"]
 }

package/dist/graph/communities.js

@@ -0,0 +1,317 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var communities_exports = {};
+__export(communities_exports, {
+  detectCommunities: () => detectCommunities
+});
+module.exports = __toCommonJS(communities_exports);
+function buildAdjacency(db) {
+  const rawDb = db.getRawDb();
+  const edges = rawDb.all(
+    `SELECT source, target FROM edges WHERE kind != 'contains'`
+  );
+  const nodes = /* @__PURE__ */ new Map();
+  const adj = /* @__PURE__ */ new Map();
+  let totalWeight = 0;
+  for (const e of edges) {
+    if (!nodes.has(e.source)) nodes.set(e.source, { id: e.source, community: 0, degree: 0 });
+    if (!nodes.has(e.target)) nodes.set(e.target, { id: e.target, community: 0, degree: 0 });
+    if (!adj.has(e.source)) adj.set(e.source, /* @__PURE__ */ new Map());
+    if (!adj.has(e.target)) adj.set(e.target, /* @__PURE__ */ new Map());
+    const w1 = adj.get(e.source).get(e.target) ?? 0;
+    adj.get(e.source).set(e.target, w1 + 1);
+    const w2 = adj.get(e.target).get(e.source) ?? 0;
+    adj.get(e.target).set(e.source, w2 + 1);
+    nodes.get(e.source).degree += 1;
+    nodes.get(e.target).degree += 1;
+    totalWeight += 1;
+  }
+  return { nodes, adj, totalWeight };
+}
+function localMovePhase(nodes, adj, totalWeight, resolution = 1) {
+  if (totalWeight === 0) return false;
+  const m2 = 2 * totalWeight;
+  let improved = false;
+  let changed = true;
+  let iterations = 0;
+  const maxIterations = 20;
+  const communityDegree = /* @__PURE__ */ new Map();
+  for (const node of nodes.values()) {
+    communityDegree.set(node.community, (communityDegree.get(node.community) ?? 0) + node.degree);
+  }
+  while (changed && iterations < maxIterations) {
+    changed = false;
+    iterations++;
+    for (const node of nodes.values()) {
+      const currentCommunity = node.community;
+      const ki = node.degree;
+      const neighborCommunities = /* @__PURE__ */ new Map();
+      const neighbors = adj.get(node.id);
+      if (!neighbors) continue;
+      for (const [neighborId, weight] of neighbors) {
+        const neighborNode = nodes.get(neighborId);
+        if (!neighborNode) continue;
+        const nc = neighborNode.community;
+        neighborCommunities.set(nc, (neighborCommunities.get(nc) ?? 0) + weight);
+      }
+      communityDegree.set(currentCommunity, (communityDegree.get(currentCommunity) ?? 0) - ki);
+      let bestCommunity = currentCommunity;
+      let bestGain = 0;
+      const kiIn = neighborCommunities.get(currentCommunity) ?? 0;
+      const sigmaCurrentWithout = communityDegree.get(currentCommunity) ?? 0;
+      for (const [community, edgesToCommunity] of neighborCommunities) {
+        if (community === currentCommunity) continue;
+        const sigmaCommunity = communityDegree.get(community) ?? 0;
+        const gain = resolution * (edgesToCommunity - kiIn) / m2 - resolution * ki * (sigmaCommunity - sigmaCurrentWithout) / (m2 * m2) * 2;
+        if (gain > bestGain) {
+          bestGain = gain;
+          bestCommunity = community;
+        }
+      }
+      if (bestCommunity !== currentCommunity) {
+        node.community = bestCommunity;
+        communityDegree.set(bestCommunity, (communityDegree.get(bestCommunity) ?? 0) + ki);
+        changed = true;
+        improved = true;
+      } else {
+        communityDegree.set(currentCommunity, (communityDegree.get(currentCommunity) ?? 0) + ki);
+      }
+    }
+  }
+  return improved;
+}
+function refinementPhase(nodes, adj, totalWeight, resolution = 1) {
+  const communityGroups = /* @__PURE__ */ new Map();
+  for (const node of nodes.values()) {
+    if (!communityGroups.has(node.community)) communityGroups.set(node.community, []);
+    communityGroups.get(node.community).push(node.id);
+  }
+  const m2 = 2 * totalWeight;
+  const refined = /* @__PURE__ */ new Map();
+  let nextSubId = 0;
+  for (const cId of communityGroups.keys()) {
+    if (cId >= nextSubId) nextSubId = cId + 1;
+  }
+  for (const [, members] of communityGroups) {
+    if (members.length === 1) {
+      refined.set(members[0], nextSubId++);
+      continue;
+    }
+    const memberSet = new Set(members);
+    const subCommunity = /* @__PURE__ */ new Map();
+    const subCommunityNodes = /* @__PURE__ */ new Map();
+    const subInternalEdges = /* @__PURE__ */ new Map();
+    const subDegree = /* @__PURE__ */ new Map();
+    for (const mId of members) {
+      const sid = nextSubId++;
+      subCommunity.set(mId, sid);
+      subCommunityNodes.set(sid, /* @__PURE__ */ new Set([mId]));
+      subInternalEdges.set(sid, 0);
+      subDegree.set(sid, nodes.get(mId).degree);
+    }
+    let mergedAny = true;
+    let subIterations = 0;
+    const maxSubIterations = 10;
+    while (mergedAny && subIterations < maxSubIterations) {
+      mergedAny = false;
+      subIterations++;
+      for (const mId of members) {
+        const currentSid = subCommunity.get(mId);
+        if (subCommunityNodes.get(currentSid).size !== 1) continue;
+        const ki = nodes.get(mId).degree;
+        const neighbors = adj.get(mId);
+        if (!neighbors) continue;
+        const edgesToSub = /* @__PURE__ */ new Map();
+        for (const [nId, w] of neighbors) {
+          if (!memberSet.has(nId)) continue;
+          const nSid = subCommunity.get(nId);
+          if (nSid === currentSid) continue;
+          edgesToSub.set(nSid, (edgesToSub.get(nSid) ?? 0) + w);
+        }
+        if (edgesToSub.size === 0) continue;
+        let bestSid = currentSid;
+        let bestGain = 0;
+        for (const [candidateSid, edgesToCandidate] of edgesToSub) {
+          const sigmaCandidate = subDegree.get(candidateSid) ?? 0;
+          const gain = resolution * edgesToCandidate / m2 - resolution * ki * sigmaCandidate / (m2 * m2) * 2;
+          if (gain <= bestGain) continue;
+          const newInternalEdges = (subInternalEdges.get(candidateSid) ?? 0) + edgesToCandidate;
+          const newDegreeSum = sigmaCandidate + ki;
+          const threshold = resolution * newDegreeSum / m2;
+          if (newInternalEdges < threshold) continue;
+          bestGain = gain;
+          bestSid = candidateSid;
+        }
+        if (bestSid !== currentSid) {
+          subCommunityNodes.get(currentSid).delete(mId);
+          subCommunityNodes.get(bestSid).add(mId);
+          subCommunity.set(mId, bestSid);
+          const edgesAdded = edgesToSub.get(bestSid) ?? 0;
+          subInternalEdges.set(bestSid, (subInternalEdges.get(bestSid) ?? 0) + edgesAdded);
+          subDegree.set(bestSid, (subDegree.get(bestSid) ?? 0) + ki);
+          mergedAny = true;
+        }
+      }
+    }
+    for (const mId of members) {
+      refined.set(mId, subCommunity.get(mId));
+    }
+  }
+  return refined;
+}
+function calculateModularity(nodes, adj, totalWeight) {
+  if (totalWeight === 0) return 0;
+  const m2 = 2 * totalWeight;
+  let q = 0;
+  for (const [nodeId, node] of nodes) {
+    const neighbors = adj.get(nodeId);
+    if (!neighbors) continue;
+    for (const [neighborId, weight] of neighbors) {
+      const neighborNode = nodes.get(neighborId);
+      if (!neighborNode) continue;
+      if (node.community === neighborNode.community) {
+        q += weight - node.degree * neighborNode.degree / m2;
+      }
+    }
+  }
+  return q / m2;
+}
+function detectCommunities(db, opts) {
+  const resolution = opts?.resolution ?? 1;
+  const maxCommunityPct = opts?.maxCommunityPct ?? 0.25;
+  const { nodes, adj, totalWeight } = buildAdjacency(db);
+  if (nodes.size === 0) {
+    return { communities: [], modularity: 0, totalNodes: 0, totalEdges: 0, algorithm: "leiden" };
+  }
+  let communityId = 0;
+  for (const node of nodes.values()) {
+    node.community = communityId++;
+  }
+  localMovePhase(nodes, adj, totalWeight, resolution);
+  const refinedPartition = refinementPhase(nodes, adj, totalWeight, resolution);
+  for (const [nodeId, refinedCommunityId] of refinedPartition) {
+    nodes.get(nodeId).community = refinedCommunityId;
+  }
+  const communityMembers = /* @__PURE__ */ new Map();
+  for (const node of nodes.values()) {
+    if (!communityMembers.has(node.community)) communityMembers.set(node.community, []);
+    communityMembers.get(node.community).push(node.id);
+  }
+  const maxSize = Math.floor(nodes.size * maxCommunityPct);
+  for (const [cId, members] of communityMembers) {
+    if (members.length > maxSize) {
+      const subNodes = /* @__PURE__ */ new Map();
+      let subCommunityId = communityId;
+      for (const mId of members) {
+        const original = nodes.get(mId);
+        subNodes.set(mId, { ...original, community: subCommunityId++ });
+      }
+      communityId = subCommunityId;
+      const subAdj = /* @__PURE__ */ new Map();
+      let subWeight = 0;
+      for (const mId of members) {
+        const neighbors = adj.get(mId);
+        if (!neighbors) continue;
+        for (const [nId, w] of neighbors) {
+          if (subNodes.has(nId)) {
+            if (!subAdj.has(mId)) subAdj.set(mId, /* @__PURE__ */ new Map());
+            subAdj.get(mId).set(nId, w);
+            subWeight += w;
+          }
+        }
+      }
+      localMovePhase(subNodes, subAdj, subWeight / 2, resolution * 2);
+      const subRefined = refinementPhase(subNodes, subAdj, subWeight / 2, resolution * 2);
+      for (const [mId, rId] of subRefined) {
+        subNodes.get(mId).community = rId;
+      }
+      for (const [mId, subNode] of subNodes) {
+        nodes.get(mId).community = subNode.community;
+      }
+    }
+  }
+  const rawDb = db.getRawDb();
+  const finalCommunities = /* @__PURE__ */ new Map();
+  for (const node of nodes.values()) {
+    if (!finalCommunities.has(node.community)) finalCommunities.set(node.community, []);
+    const nodeInfo = rawDb.get(
+      "SELECT name, kind, file_path as filePath FROM nodes WHERE id = ?",
+      [node.id]
+    );
+    if (nodeInfo) {
+      finalCommunities.get(node.community).push({
+        id: node.id,
+        name: nodeInfo.name,
+        kind: nodeInfo.kind,
+        filePath: nodeInfo.filePath
+      });
+    }
+  }
+  const interEdges = /* @__PURE__ */ new Map();
+  for (const [nodeId, node] of nodes) {
+    const neighbors = adj.get(nodeId);
+    if (!neighbors) continue;
+    for (const [neighborId] of neighbors) {
+      const neighborNode = nodes.get(neighborId);
+      if (neighborNode && neighborNode.community !== node.community) {
+        interEdges.set(node.community, (interEdges.get(node.community) ?? 0) + 1);
+      }
+    }
+  }
+  const communities = [];
+  let idx = 0;
+  for (const [cId, members] of finalCommunities) {
+    if (members.length === 0) continue;
+    const dirCounts = /* @__PURE__ */ new Map();
+    const langCounts = /* @__PURE__ */ new Map();
+    for (const m of members) {
+      const dir = m.filePath.split("/").slice(0, 2).join("/");
+      dirCounts.set(dir, (dirCounts.get(dir) ?? 0) + 1);
+      const ext = m.filePath.split(".").pop() ?? "";
+      langCounts.set(ext, (langCounts.get(ext) ?? 0) + 1);
+    }
+    const dominantDirectory = [...dirCounts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? "";
+    const dominantLanguage = [...langCounts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? "";
+    const label = dominantDirectory || members[0]?.name || `community-${idx}`;
+    communities.push({
+      id: idx++,
+      label,
+      memberCount: members.length,
+      members: members.slice(0, 30),
+      // Cap for output size
+      dominantDirectory,
+      dominantLanguage,
+      interCommunityEdges: interEdges.get(cId) ?? 0
+    });
+  }
+  communities.sort((a, b) => b.memberCount - a.memberCount);
+  const modularity = calculateModularity(nodes, adj, totalWeight);
+  return {
+    communities,
+    modularity,
+    totalNodes: nodes.size,
+    totalEdges: totalWeight,
+    algorithm: "leiden"
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  detectCommunities
+});
+//# sourceMappingURL=communities.js.map

package/dist/graph/communities.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/graph/communities.ts"],
+  "sourcesContent": ["/**\n * Community Detection via Leiden Algorithm\n *\n * Clusters related code into communities based on edge connectivity.\n * Oversized communities (>25% of graph) are recursively split with higher resolution.\n *\n * Leiden improves on Louvain by adding a refinement phase between the local-move phase\n * and the aggregation phase. The refinement sub-partitions each community into\n * well-connected sub-communities, guaranteeing that every community in the final\n * partition is internally connected. This prevents the \"disconnected community\"\n * artefact that Louvain is known to produce.\n */\n\nimport type { GraphDatabase } from '../db/database';\n\nexport interface Community {\n  id: number;\n  label: string;\n  memberCount: number;\n  members: Array<{ id: string; name: string; kind: string; filePath: string }>;\n  dominantDirectory: string;\n  dominantLanguage: string;\n  interCommunityEdges: number;\n}\n\nexport interface CommunityResult {\n  communities: Community[];\n  modularity: number;\n  totalNodes: number;\n  totalEdges: number;\n  /** Algorithm used to detect communities. */\n  algorithm: 'leiden';\n}\n\ninterface LouvainNode {\n  id: string;\n  community: number;\n  degree: number;\n}\n\n/**\n * Build an undirected weighted adjacency from the edges table.\n * Weight = number of edges between two nodes (calls + imports + references).\n * Excludes 'contains' edges as they're structural, not semantic.\n */\nfunction buildAdjacency(db: GraphDatabase): { nodes: Map<string, LouvainNode>; adj: Map<string, Map<string, number>>; totalWeight: number } {\n  const rawDb = db.getRawDb();\n\n  const edges = rawDb.all(\n    `SELECT source, target FROM edges WHERE kind != 'contains'`\n  ) as Array<{ source: string; target: string }>;\n\n  const nodes = new Map<string, LouvainNode>();\n  const adj = new Map<string, Map<string, number>>();\n  let totalWeight = 0;\n\n  for (const e of edges) {\n    // Ensure both nodes exist\n    if (!nodes.has(e.source)) nodes.set(e.source, { id: e.source, community: 0, degree: 0 });\n    if (!nodes.has(e.target)) nodes.set(e.target, { id: e.target, community: 0, degree: 0 });\n\n    // Undirected: add weight in both directions\n    if (!adj.has(e.source)) adj.set(e.source, new Map());\n    if (!adj.has(e.target)) adj.set(e.target, new Map());\n\n    const w1 = adj.get(e.source)!.get(e.target) ?? 0;\n    adj.get(e.source)!.set(e.target, w1 + 1);\n\n    const w2 = adj.get(e.target)!.get(e.source) ?? 0;\n    adj.get(e.target)!.set(e.source, w2 + 1);\n\n    nodes.get(e.source)!.degree += 1;\n    nodes.get(e.target)!.degree += 1;\n    totalWeight += 1;\n  }\n\n  return { nodes, adj, totalWeight };\n}\n\n/**\n * Leiden/Louvain Phase 1 \u2014 local moving.\n *\n * For each node, try moving it to the neighbouring community that yields the\n * largest positive modularity gain. Repeats until no improvement is found or\n * `maxIterations` is reached.\n */\nfunction localMovePhase(\n  nodes: Map<string, LouvainNode>,\n  adj: Map<string, Map<string, number>>,\n  totalWeight: number,\n  resolution: number = 1.0,\n): boolean {\n  if (totalWeight === 0) return false;\n\n  const m2 = 2 * totalWeight;\n  let improved = false;\n  let changed = true;\n  let iterations = 0;\n  const maxIterations = 20;\n\n  // Community totals: sum of degrees of nodes in each community\n  const communityDegree = new Map<number, number>();\n  for (const node of nodes.values()) {\n    communityDegree.set(node.community, (communityDegree.get(node.community) ?? 0) + node.degree);\n  }\n\n  while (changed && iterations < maxIterations) {\n    changed = false;\n    iterations++;\n\n    for (const node of nodes.values()) {\n      const currentCommunity = node.community;\n      const ki = node.degree;\n\n      // Calculate edges to each neighbouring community\n      const neighborCommunities = new Map<number, number>();\n      const neighbors = adj.get(node.id);\n      if (!neighbors) continue;\n\n      for (const [neighborId, weight] of neighbors) {\n        const neighborNode = nodes.get(neighborId);\n        if (!neighborNode) continue;\n        const nc = neighborNode.community;\n        neighborCommunities.set(nc, (neighborCommunities.get(nc) ?? 0) + weight);\n      }\n\n      // Remove node from its current community\n      communityDegree.set(currentCommunity, (communityDegree.get(currentCommunity) ?? 0) - ki);\n\n      // Find best community\n      let bestCommunity = currentCommunity;\n      let bestGain = 0;\n\n      const kiIn = neighborCommunities.get(currentCommunity) ?? 0;\n      const sigmaCurrentWithout = communityDegree.get(currentCommunity) ?? 0;\n\n      for (const [community, edgesToCommunity] of neighborCommunities) {\n        if (community === currentCommunity) continue;\n\n        const sigmaCommunity = communityDegree.get(community) ?? 0;\n\n        // Modularity gain formula\n        const gain = resolution * (edgesToCommunity - kiIn) / m2\n          - resolution * ki * (sigmaCommunity - sigmaCurrentWithout) / (m2 * m2) * 2;\n\n        if (gain > bestGain) {\n          bestGain = gain;\n          bestCommunity = community;\n        }\n      }\n\n      // Move node to best community\n      if (bestCommunity !== currentCommunity) {\n        node.community = bestCommunity;\n        communityDegree.set(bestCommunity, (communityDegree.get(bestCommunity) ?? 0) + ki);\n        changed = true;\n        improved = true;\n      } else {\n        communityDegree.set(currentCommunity, (communityDegree.get(currentCommunity) ?? 0) + ki);\n      }\n    }\n  }\n\n  return improved;\n}\n\n/**\n * Leiden Phase 2 \u2014 refinement.\n *\n * For each community produced by the local-move phase, attempt to split it into\n * smaller, well-connected sub-communities. This prevents the disconnected-community\n * artefact that plain Louvain can produce.\n *\n * The procedure:\n *   1. Collect the nodes that belong to community C.\n *   2. Start with every node in its own singleton sub-community.\n *   3. For each node, consider merging its singleton into an adjacent\n *      sub-community (within C) if the merge yields a positive modularity gain\n *      AND the resulting sub-community remains well-connected (internal edges \u2265\n *      a connectivity threshold derived from the sub-community's total degree).\n *   4. Write the refined sub-community ids back into a new partition map.\n *\n * Returns a map from original node id \u2192 refined community id.\n */\nfunction refinementPhase(\n  nodes: Map<string, LouvainNode>,\n  adj: Map<string, Map<string, number>>,\n  totalWeight: number,\n  resolution: number = 1.0,\n): Map<string, number> {\n  // Group nodes by their current (post-local-move) community\n  const communityGroups = new Map<number, string[]>();\n  for (const node of nodes.values()) {\n    if (!communityGroups.has(node.community)) communityGroups.set(node.community, []);\n    communityGroups.get(node.community)!.push(node.id);\n  }\n\n  const m2 = 2 * totalWeight;\n  // Output: node id \u2192 refined community id\n  const refined = new Map<string, number>();\n\n  // Use a globally incrementing id so refined sub-communities never collide\n  let nextSubId = 0;\n  // Initialise: reserve unique ids based on current community ids to avoid\n  // collisions even before we start assigning new ones\n  for (const cId of communityGroups.keys()) {\n    if (cId >= nextSubId) nextSubId = cId + 1;\n  }\n\n  for (const [, members] of communityGroups) {\n    if (members.length === 1) {\n      // Singleton community \u2014 nothing to refine\n      refined.set(members[0], nextSubId++);\n      continue;\n    }\n\n    const memberSet = new Set(members);\n\n    // Phase 2a: start with each node in its own singleton sub-community\n    const subCommunity = new Map<string, number>(); // node id \u2192 sub-community id\n    const subCommunityNodes = new Map<number, Set<string>>(); // sub-community id \u2192 node ids\n    // Internal edge weight for each sub-community\n    const subInternalEdges = new Map<number, number>();\n    // Total degree for each sub-community (within the full graph, not just sub-graph)\n    const subDegree = new Map<number, number>();\n\n    for (const mId of members) {\n      const sid = nextSubId++;\n      subCommunity.set(mId, sid);\n      subCommunityNodes.set(sid, new Set([mId]));\n      subInternalEdges.set(sid, 0);\n      subDegree.set(sid, nodes.get(mId)!.degree);\n    }\n\n    // Phase 2b: iteratively merge singletons into well-connected sub-communities\n    // We only allow merging a node if it is currently a singleton (size 1)\n    // \u2014 this keeps the procedure efficient and follows the Leiden paper's spirit.\n    let mergedAny = true;\n    let subIterations = 0;\n    const maxSubIterations = 10;\n\n    while (mergedAny && subIterations < maxSubIterations) {\n      mergedAny = false;\n      subIterations++;\n\n      for (const mId of members) {\n        const currentSid = subCommunity.get(mId)!;\n        // Only try to move nodes that are still singletons\n        if (subCommunityNodes.get(currentSid)!.size !== 1) continue;\n\n        const ki = nodes.get(mId)!.degree;\n        const neighbors = adj.get(mId);\n        if (!neighbors) continue;\n\n        // Count edges from this node to each sub-community (within the same community C)\n        const edgesToSub = new Map<number, number>();\n        for (const [nId, w] of neighbors) {\n          if (!memberSet.has(nId)) continue;\n          const nSid = subCommunity.get(nId)!;\n          if (nSid === currentSid) continue;\n          edgesToSub.set(nSid, (edgesToSub.get(nSid) ?? 0) + w);\n        }\n\n        if (edgesToSub.size === 0) continue;\n\n        let bestSid = currentSid;\n        let bestGain = 0;\n\n        for (const [candidateSid, edgesToCandidate] of edgesToSub) {\n          const sigmaCandidate = subDegree.get(candidateSid) ?? 0;\n\n          // Modularity gain of merging this singleton into candidateSid\n          const gain = resolution * edgesToCandidate / m2\n            - resolution * ki * sigmaCandidate / (m2 * m2) * 2;\n\n          if (gain <= bestGain) continue;\n\n          // Well-connectedness check:\n          // After the merge the sub-community's internal edges would be\n          // (current internal edges of candidate) + (edges from mId to candidate).\n          // The threshold is:  internalEdges >= \u03B3 * (degree_sum * (degree_sum - ki)) / (2m)\n          // We use a relaxed form: internal edges must be positive (at least one edge\n          // into the sub-community), which is already guaranteed by edgesToCandidate > 0.\n          // Additionally enforce that the density ratio doesn't drop below a floor.\n          const newInternalEdges = (subInternalEdges.get(candidateSid) ?? 0) + edgesToCandidate;\n          const newDegreeSum = sigmaCandidate + ki;\n          // Connectivity threshold: internal edge weight >= resolution * newDegreeSum / (2m)\n          const threshold = resolution * newDegreeSum / m2;\n          if (newInternalEdges < threshold) continue;\n\n          bestGain = gain;\n          bestSid = candidateSid;\n        }\n\n        if (bestSid !== currentSid) {\n          // Perform the merge\n          subCommunityNodes.get(currentSid)!.delete(mId);\n          subCommunityNodes.get(bestSid)!.add(mId);\n          subCommunity.set(mId, bestSid);\n\n          const edgesAdded = edgesToSub.get(bestSid) ?? 0;\n          subInternalEdges.set(bestSid, (subInternalEdges.get(bestSid) ?? 0) + edgesAdded);\n          subDegree.set(bestSid, (subDegree.get(bestSid) ?? 0) + ki);\n\n          mergedAny = true;\n        }\n      }\n    }\n\n    // Write refined assignments into the output map\n    for (const mId of members) {\n      refined.set(mId, subCommunity.get(mId)!);\n    }\n  }\n\n  return refined;\n}\n\n/**\n * Calculate modularity of the current partition.\n */\nfunction calculateModularity(\n  nodes: Map<string, LouvainNode>,\n  adj: Map<string, Map<string, number>>,\n  totalWeight: number,\n): number {\n  if (totalWeight === 0) return 0;\n\n  const m2 = 2 * totalWeight;\n  let q = 0;\n\n  for (const [nodeId, node] of nodes) {\n    const neighbors = adj.get(nodeId);\n    if (!neighbors) continue;\n\n    for (const [neighborId, weight] of neighbors) {\n      const neighborNode = nodes.get(neighborId);\n      if (!neighborNode) continue;\n\n      if (node.community === neighborNode.community) {\n        q += weight - (node.degree * neighborNode.degree) / m2;\n      }\n    }\n  }\n\n  return q / m2;\n}\n\n/**\n * Run community detection on the graph using the Leiden algorithm.\n */\nexport function detectCommunities(db: GraphDatabase, opts?: { resolution?: number; maxCommunityPct?: number }): CommunityResult {\n  const resolution = opts?.resolution ?? 1.0;\n  const maxCommunityPct = opts?.maxCommunityPct ?? 0.25;\n\n  const { nodes, adj, totalWeight } = buildAdjacency(db);\n\n  if (nodes.size === 0) {\n    return { communities: [], modularity: 0, totalNodes: 0, totalEdges: 0, algorithm: 'leiden' };\n  }\n\n  // Initialize: each node in its own community\n  let communityId = 0;\n  for (const node of nodes.values()) {\n    node.community = communityId++;\n  }\n\n  // --- Leiden: local-move phase ---\n  localMovePhase(nodes, adj, totalWeight, resolution);\n\n  // --- Leiden: refinement phase ---\n  // Sub-partition each community into well-connected sub-communities, then apply\n  // the refined assignments back to the nodes map before aggregation.\n  const refinedPartition = refinementPhase(nodes, adj, totalWeight, resolution);\n  for (const [nodeId, refinedCommunityId] of refinedPartition) {\n    nodes.get(nodeId)!.community = refinedCommunityId;\n  }\n\n  // Auto-split oversized communities\n  const communityMembers = new Map<number, string[]>();\n  for (const node of nodes.values()) {\n    if (!communityMembers.has(node.community)) communityMembers.set(node.community, []);\n    communityMembers.get(node.community)!.push(node.id);\n  }\n\n  const maxSize = Math.floor(nodes.size * maxCommunityPct);\n  for (const [cId, members] of communityMembers) {\n    if (members.length > maxSize) {\n      // Re-run with higher resolution on this subgraph\n      const subNodes = new Map<string, LouvainNode>();\n      let subCommunityId = communityId;\n      for (const mId of members) {\n        const original = nodes.get(mId)!;\n        subNodes.set(mId, { ...original, community: subCommunityId++ });\n      }\n      communityId = subCommunityId;\n\n      // Build sub-adjacency\n      const subAdj = new Map<string, Map<string, number>>();\n      let subWeight = 0;\n      for (const mId of members) {\n        const neighbors = adj.get(mId);\n        if (!neighbors) continue;\n        for (const [nId, w] of neighbors) {\n          if (subNodes.has(nId)) {\n            if (!subAdj.has(mId)) subAdj.set(mId, new Map());\n            subAdj.get(mId)!.set(nId, w);\n            subWeight += w;\n          }\n        }\n      }\n\n      // Leiden on the sub-graph: local move + refinement\n      localMovePhase(subNodes, subAdj, subWeight / 2, resolution * 2);\n      const subRefined = refinementPhase(subNodes, subAdj, subWeight / 2, resolution * 2);\n      for (const [mId, rId] of subRefined) {\n        subNodes.get(mId)!.community = rId;\n      }\n\n      // Apply sub-community assignments back\n      for (const [mId, subNode] of subNodes) {\n        nodes.get(mId)!.community = subNode.community;\n      }\n    }\n  }\n\n  // Build result\n  const rawDb = db.getRawDb();\n  const finalCommunities = new Map<number, Array<{ id: string; name: string; kind: string; filePath: string }>>();\n\n  for (const node of nodes.values()) {\n    if (!finalCommunities.has(node.community)) finalCommunities.set(node.community, []);\n    const nodeInfo = rawDb.get(\n      'SELECT name, kind, file_path as filePath FROM nodes WHERE id = ?',\n      [node.id]\n    ) as any;\n    if (nodeInfo) {\n      finalCommunities.get(node.community)!.push({\n        id: node.id,\n        name: nodeInfo.name,\n        kind: nodeInfo.kind,\n        filePath: nodeInfo.filePath,\n      });\n    }\n  }\n\n  // Calculate inter-community edges\n  const interEdges = new Map<number, number>();\n  for (const [nodeId, node] of nodes) {\n    const neighbors = adj.get(nodeId);\n    if (!neighbors) continue;\n    for (const [neighborId] of neighbors) {\n      const neighborNode = nodes.get(neighborId);\n      if (neighborNode && neighborNode.community !== node.community) {\n        interEdges.set(node.community, (interEdges.get(node.community) ?? 0) + 1);\n      }\n    }\n  }\n\n  // Build community objects\n  const communities: Community[] = [];\n  let idx = 0;\n  for (const [cId, members] of finalCommunities) {\n    if (members.length === 0) continue;\n\n    // Dominant directory\n    const dirCounts = new Map<string, number>();\n    const langCounts = new Map<string, number>();\n    for (const m of members) {\n      const dir = m.filePath.split('/').slice(0, 2).join('/');\n      dirCounts.set(dir, (dirCounts.get(dir) ?? 0) + 1);\n      const ext = m.filePath.split('.').pop() ?? '';\n      langCounts.set(ext, (langCounts.get(ext) ?? 0) + 1);\n    }\n\n    const dominantDirectory = [...dirCounts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? '';\n    const dominantLanguage = [...langCounts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? '';\n\n    // Generate label from dominant directory or top symbol\n    const label = dominantDirectory || members[0]?.name || `community-${idx}`;\n\n    communities.push({\n      id: idx++,\n      label,\n      memberCount: members.length,\n      members: members.slice(0, 30), // Cap for output size\n      dominantDirectory,\n      dominantLanguage,\n      interCommunityEdges: interEdges.get(cId) ?? 0,\n    });\n  }\n\n  // Sort by size descending\n  communities.sort((a, b) => b.memberCount - a.memberCount);\n\n  const modularity = calculateModularity(nodes, adj, totalWeight);\n\n  return {\n    communities,\n    modularity,\n    totalNodes: nodes.size,\n    totalEdges: totalWeight,\n    algorithm: 'leiden',\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/graph/flows.js

@@ -0,0 +1,138 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var flows_exports = {};
+__export(flows_exports, {
+  detectEntryPoints: () => detectEntryPoints,
+  getExecutionFlows: () => getExecutionFlows,
+  scoreCriticality: () => scoreCriticality,
+  traceFlow: () => traceFlow
+});
+module.exports = __toCommonJS(flows_exports);
+function detectEntryPoints(db, limit = 20) {
+  const rawDb = db.getRawDb();
+  const routes = rawDb.all(
+    `SELECT id, name, kind, file_path as filePath, start_line as line FROM nodes WHERE kind = 'route' LIMIT ?`,
+    [limit]
+  );
+  const roots = rawDb.all(
+    `SELECT n.id, n.name, n.kind, n.file_path as filePath, n.start_line as line
+     FROM nodes n
+     WHERE n.kind IN ('function', 'method')
+       AND n.is_exported = 1
+       AND NOT EXISTS (
+         SELECT 1 FROM edges e WHERE e.target = n.id AND e.kind = 'calls'
+       )
+     ORDER BY (SELECT COUNT(*) FROM edges e2 WHERE e2.source = n.id) DESC
+     LIMIT ?`,
+    [limit]
+  );
+  const patterns = rawDb.all(
+    `SELECT id, name, kind, file_path as filePath, start_line as line FROM nodes
+     WHERE (lower(name) LIKE '%handler%' OR lower(name) LIKE '%controller%'
+       OR lower(name) = 'main' OR lower(name) LIKE '%middleware%'
+       OR lower(name) LIKE '%endpoint%')
+       AND kind IN ('function', 'method', 'class')
+     LIMIT ?`,
+    [limit]
+  );
+  const seen = /* @__PURE__ */ new Set();
+  const results = [];
+  for (const entry of [...routes, ...roots, ...patterns]) {
+    if (!seen.has(entry.id)) {
+      seen.add(entry.id);
+      results.push(entry);
+    }
+  }
+  return results.slice(0, limit);
+}
+function traceFlow(db, entryPointId, maxDepth = 10) {
+  const rawDb = db.getRawDb();
+  const hops = [];
+  const visited = /* @__PURE__ */ new Set();
+  function walk(nodeId, depth) {
+    if (depth >= maxDepth || visited.has(nodeId)) return;
+    visited.add(nodeId);
+    const node = rawDb.get(
+      "SELECT name, kind, file_path as filePath, start_line as line FROM nodes WHERE id = ?",
+      [nodeId]
+    );
+    if (!node) return;
+    const edgeInfo = depth === 0 ? void 0 : rawDb.get(
+      `SELECT kind, confidence FROM edges WHERE target = ? AND source IN (${[...visited].map(() => "?").join(",")}) LIMIT 1`,
+      [nodeId, ...[...visited]]
+    );
+    hops.push({
+      symbol: node.name,
+      kind: node.kind,
+      filePath: node.filePath,
+      line: node.line,
+      edgeKind: edgeInfo?.kind,
+      confidence: edgeInfo?.confidence
+    });
+    const callees = rawDb.all(
+      `SELECT e.target, e.kind as edgeKind, e.confidence
+       FROM edges e
+       WHERE e.source = ? AND e.kind = 'calls'
+       ORDER BY (SELECT COUNT(*) FROM edges e2 WHERE e2.source = e.target) DESC
+       LIMIT 5`,
+      [nodeId]
+    );
+    for (const callee of callees) {
+      walk(callee.target, depth + 1);
+    }
+  }
+  walk(entryPointId, 0);
+  return hops;
+}
+function scoreCriticality(hops) {
+  if (hops.length === 0) return 0;
+  const lengthScore = Math.min(hops.length / 10, 1);
+  const ioPatterns = /db|database|query|http|fetch|request|file|write|read|socket|stream/i;
+  const touchesIO = hops.some((h) => ioPatterns.test(h.symbol));
+  const ioScore = touchesIO ? 0.3 : 0;
+  return Math.min(lengthScore * 0.7 + ioScore, 1);
+}
+function getExecutionFlows(db, opts) {
+  const maxFlows = opts?.maxFlows ?? 15;
+  const maxDepth = opts?.maxDepth ?? 10;
+  const entryPoints = detectEntryPoints(db, maxFlows * 2);
+  const flows = [];
+  for (const ep of entryPoints) {
+    const hops = traceFlow(db, ep.id, maxDepth);
+    if (hops.length < 2) continue;
+    const criticality = scoreCriticality(hops);
+    flows.push({
+      entryPoint: ep.name,
+      entryPointKind: ep.kind,
+      entryPointFile: ep.filePath,
+      criticality,
+      hops
+    });
+  }
+  flows.sort((a, b) => b.criticality - a.criticality);
+  return flows.slice(0, maxFlows);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  detectEntryPoints,
+  getExecutionFlows,
+  scoreCriticality,
+  traceFlow
+});
+//# sourceMappingURL=flows.js.map

package/dist/graph/flows.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/graph/flows.ts"],
+  "sourcesContent": ["/**\n * Execution Flow Tracing\n *\n * Traces call chains from entry points (functions with no incoming call edges,\n * route handlers, main functions) through the graph, sorted by criticality.\n */\n\nimport type { GraphDatabase } from '../db/database';\n\nexport interface FlowHop {\n  symbol: string;\n  kind: string;\n  filePath: string;\n  line: number;\n  edgeKind?: string;\n  confidence?: string;\n}\n\nexport interface ExecutionFlow {\n  entryPoint: string;\n  entryPointKind: string;\n  entryPointFile: string;\n  criticality: number;\n  hops: FlowHop[];\n}\n\n/**\n * Detect entry points: symbols that are likely execution starting points.\n * - Route nodes\n * - Functions with zero incoming call edges\n * - Symbols matching known entry patterns (main, handler, controller, etc.)\n */\nexport function detectEntryPoints(db: GraphDatabase, limit = 20): Array<{ id: string; name: string; kind: string; filePath: string; line: number }> {\n  const rawDb = db.getRawDb();\n\n  // 1. Route nodes are always entry points\n  const routes = rawDb.all(\n    `SELECT id, name, kind, file_path as filePath, start_line as line FROM nodes WHERE kind = 'route' LIMIT ?`,\n    [limit]\n  ) as any[];\n\n  // 2. Functions/methods with no incoming call edges (graph roots)\n  const roots = rawDb.all(\n    `SELECT n.id, n.name, n.kind, n.file_path as filePath, n.start_line as line\n     FROM nodes n\n     WHERE n.kind IN ('function', 'method')\n       AND n.is_exported = 1\n       AND NOT EXISTS (\n         SELECT 1 FROM edges e WHERE e.target = n.id AND e.kind = 'calls'\n       )\n     ORDER BY (SELECT COUNT(*) FROM edges e2 WHERE e2.source = n.id) DESC\n     LIMIT ?`,\n    [limit]\n  ) as any[];\n\n  // 3. Known entry point patterns\n  const patterns = rawDb.all(\n    `SELECT id, name, kind, file_path as filePath, start_line as line FROM nodes\n     WHERE (lower(name) LIKE '%handler%' OR lower(name) LIKE '%controller%'\n       OR lower(name) = 'main' OR lower(name) LIKE '%middleware%'\n       OR lower(name) LIKE '%endpoint%')\n       AND kind IN ('function', 'method', 'class')\n     LIMIT ?`,\n    [limit]\n  ) as any[];\n\n  // Deduplicate by id\n  const seen = new Set<string>();\n  const results: Array<{ id: string; name: string; kind: string; filePath: string; line: number }> = [];\n  for (const entry of [...routes, ...roots, ...patterns]) {\n    if (!seen.has(entry.id)) {\n      seen.add(entry.id);\n      results.push(entry);\n    }\n  }\n\n  return results.slice(0, limit);\n}\n\n/**\n * Trace a single execution flow from an entry point forward through call edges.\n * Returns the chain of hops with criticality scoring.\n */\nexport function traceFlow(db: GraphDatabase, entryPointId: string, maxDepth = 10): FlowHop[] {\n  const rawDb = db.getRawDb();\n  const hops: FlowHop[] = [];\n  const visited = new Set<string>();\n\n  function walk(nodeId: string, depth: number): void {\n    if (depth >= maxDepth || visited.has(nodeId)) return;\n    visited.add(nodeId);\n\n    const node = rawDb.get(\n      'SELECT name, kind, file_path as filePath, start_line as line FROM nodes WHERE id = ?',\n      [nodeId]\n    ) as any;\n    if (!node) return;\n\n    const edgeInfo = depth === 0 ? undefined : rawDb.get(\n      `SELECT kind, confidence FROM edges WHERE target = ? AND source IN (${[...visited].map(() => '?').join(',')}) LIMIT 1`,\n      [nodeId, ...[...visited]]\n    ) as any;\n\n    hops.push({\n      symbol: node.name,\n      kind: node.kind,\n      filePath: node.filePath,\n      line: node.line,\n      edgeKind: edgeInfo?.kind,\n      confidence: edgeInfo?.confidence,\n    });\n\n    // Follow outgoing call edges, ordered by target's fan-out (criticality)\n    const callees = rawDb.all(\n      `SELECT e.target, e.kind as edgeKind, e.confidence\n       FROM edges e\n       WHERE e.source = ? AND e.kind = 'calls'\n       ORDER BY (SELECT COUNT(*) FROM edges e2 WHERE e2.source = e.target) DESC\n       LIMIT 5`,\n      [nodeId]\n    ) as any[];\n\n    for (const callee of callees) {\n      walk(callee.target, depth + 1);\n    }\n  }\n\n  walk(entryPointId, 0);\n  return hops;\n}\n\n/**\n * Compute criticality score for a flow based on:\n * - Length (longer flows = more critical paths)\n * - Fan-out of hops (more downstream = higher criticality)\n * - Whether it touches I/O-like patterns (db, http, file)\n */\nexport function scoreCriticality(hops: FlowHop[]): number {\n  if (hops.length === 0) return 0;\n\n  const lengthScore = Math.min(hops.length / 10, 1.0); // normalize to 0-1\n\n  const ioPatterns = /db|database|query|http|fetch|request|file|write|read|socket|stream/i;\n  const touchesIO = hops.some(h => ioPatterns.test(h.symbol));\n  const ioScore = touchesIO ? 0.3 : 0;\n\n  return Math.min(lengthScore * 0.7 + ioScore, 1.0);\n}\n\n/**\n * Get execution flows from all detected entry points.\n */\nexport function getExecutionFlows(db: GraphDatabase, opts?: { maxFlows?: number; maxDepth?: number }): ExecutionFlow[] {\n  const maxFlows = opts?.maxFlows ?? 15;\n  const maxDepth = opts?.maxDepth ?? 10;\n\n  const entryPoints = detectEntryPoints(db, maxFlows * 2);\n  const flows: ExecutionFlow[] = [];\n\n  for (const ep of entryPoints) {\n    const hops = traceFlow(db, ep.id, maxDepth);\n    if (hops.length < 2) continue; // Skip trivial flows (single node)\n\n    const criticality = scoreCriticality(hops);\n    flows.push({\n      entryPoint: ep.name,\n      entryPointKind: ep.kind,\n      entryPointFile: ep.filePath,\n      criticality,\n      hops,\n    });\n  }\n\n  // Sort by criticality descending\n  flows.sort((a, b) => b.criticality - a.criticality);\n  return flows.slice(0, maxFlows);\n}\n"],
+  "mappings": "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",
+  "names": []
+}