kirograph 0.19.0 → 0.20.1

package/dist/frameworks/docker.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Docker Compose Framework Resolver
+ *
+ * Extracts services, networks, volumes from docker-compose files.
+ * Maps depends_on relationships as edges.
+ */
+import type { FrameworkResolver } from './types';
+export declare const dockerComposeResolver: FrameworkResolver;
+//# sourceMappingURL=docker.d.ts.map

package/dist/frameworks/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/frameworks/docker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAEhG,eAAO,MAAM,qBAAqB,EAAE,iBA6GnC,CAAC"}

package/dist/frameworks/elixir.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Elixir / Phoenix Framework Resolver
+ */
+import type { FrameworkResolver } from './types';
+export declare const phoenixResolver: FrameworkResolver;
+//# sourceMappingURL=elixir.d.ts.map

package/dist/frameworks/elixir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elixir.d.ts","sourceRoot":"","sources":["../../src/frameworks/elixir.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAEhG,eAAO,MAAM,eAAe,EAAE,iBAgF7B,CAAC"}

package/dist/frameworks/flutter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Flutter Framework Resolver
+ *
+ * Detects Flutter projects and extracts route nodes from:
+ *   - MaterialApp(routes: {'/path': (ctx) => MyPage()})
+ *   - MaterialApp.router(routerConfig: GoRouter(...))
+ *   - GoRouter(routes: [GoRoute(path: '/path', builder: ...)])
+ *   - AutoRoute annotations: @RoutePage() on widget classes
+ */
+import type { FrameworkResolver } from './types';
+export declare const flutterResolver: FrameworkResolver;
+//# sourceMappingURL=flutter.d.ts.map

package/dist/frameworks/flutter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flutter.d.ts","sourceRoot":"","sources":["../../src/frameworks/flutter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAEhG,eAAO,MAAM,eAAe,EAAE,iBAoH7B,CAAC"}

package/dist/frameworks/iac.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Infrastructure-as-Code Framework Resolvers
+ * Supports: AWS CDK, SST, Serverless Framework, AWS SAM
+ */
+import type { FrameworkResolver } from './types';
+export declare const sstResolver: FrameworkResolver;
+export declare const cdkResolver: FrameworkResolver;
+export declare const serverlessResolver: FrameworkResolver;
+export declare const samResolver: FrameworkResolver;
+//# sourceMappingURL=iac.d.ts.map

package/dist/frameworks/iac.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iac.d.ts","sourceRoot":"","sources":["../../src/frameworks/iac.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAIhG,eAAO,MAAM,WAAW,EAAE,iBAsEzB,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,iBAuFzB,CAAC;AAIF,eAAO,MAAM,kBAAkB,EAAE,iBAoFhC,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,iBAiEzB,CAAC"}

package/dist/frameworks/index.d.ts

@@ -18,6 +18,20 @@ export { rustResolver } from './rust';
 export { aspnetResolver } from './csharp';
 export { swiftUIResolver, uikitResolver, vaporResolver } from './swift';
 export { laravelResolver, FACADE_MAPPINGS } from './laravel';
+export { phoenixResolver } from './elixir';
+export { playResolver } from './scala';
+export { nuxtResolver, vueResolver } from './vue';
+export { solidityResolver } from './solidity';
+export { sstResolver, cdkResolver, serverlessResolver, samResolver } from './iac';
+export { terraformResolver } from './terraform';
+export { pulumiResolver } from './pulumi';
+export { cloudformationResolver } from './cloudformation';
+export { kubernetesResolver } from './kubernetes';
+export { dockerComposeResolver } from './docker';
+export { ansibleResolver } from './ansible';
+export { angularResolver } from './angular';
+export { amplifyResolver } from './amplify';
+export { flutterResolver } from './flutter';
 export declare function getAllFrameworkResolvers(): FrameworkResolver[];
 export declare function getFrameworkResolver(name: string): FrameworkResolver | undefined;
 export declare function registerFrameworkResolver(resolver: FrameworkResolver): void;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/frameworks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,SAAS,CAAC;AAGpE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGhG,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA2C7D,wBAAgB,wBAAwB,IAAI,iBAAiB,EAAE,CAE9D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAI3E;AA8CD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyB5G"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/frameworks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,SAAS,CAAC;AAGpE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGhG,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAmF5C,wBAAgB,wBAAwB,IAAI,iBAAiB,EAAE,CAE9D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAI3E;AA8CD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyB5G"}

package/dist/frameworks/kubernetes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Kubernetes / Helm Framework Resolver
+ *
+ * Extracts Deployments, Services, ConfigMaps, Ingress routes from K8s manifests.
+ * Detects both raw manifests and Helm charts.
+ */
+import type { FrameworkResolver } from './types';
+export declare const kubernetesResolver: FrameworkResolver;
+//# sourceMappingURL=kubernetes.d.ts.map

package/dist/frameworks/kubernetes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kubernetes.d.ts","sourceRoot":"","sources":["../../src/frameworks/kubernetes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAEhG,eAAO,MAAM,kBAAkB,EAAE,iBA4GhC,CAAC"}

package/dist/frameworks/pulumi.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pulumi Framework Resolver
+ *
+ * Pulumi is already TypeScript/Python/Go code — tree-sitter handles parsing.
+ * This resolver adds detection, resource reference resolution, and route extraction.
+ */
+import type { FrameworkResolver } from './types';
+export declare const pulumiResolver: FrameworkResolver;
+//# sourceMappingURL=pulumi.d.ts.map

package/dist/frameworks/pulumi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulumi.d.ts","sourceRoot":"","sources":["../../src/frameworks/pulumi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAEhG,eAAO,MAAM,cAAc,EAAE,iBAuD5B,CAAC"}

package/dist/frameworks/scala.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Scala Framework Resolver (Play, Akka HTTP, http4s)
+ */
+import type { FrameworkResolver } from './types';
+export declare const playResolver: FrameworkResolver;
+//# sourceMappingURL=scala.d.ts.map

package/dist/frameworks/scala.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scala.d.ts","sourceRoot":"","sources":["../../src/frameworks/scala.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAEhG,eAAO,MAAM,YAAY,EAAE,iBAgF1B,CAAC"}

package/dist/frameworks/solidity.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Solidity Framework Resolver (OpenZeppelin, Hardhat, Foundry)
+ */
+import type { FrameworkResolver } from './types';
+export declare const solidityResolver: FrameworkResolver;
+//# sourceMappingURL=solidity.d.ts.map

package/dist/frameworks/solidity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solidity.d.ts","sourceRoot":"","sources":["../../src/frameworks/solidity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAEhG,eAAO,MAAM,gBAAgB,EAAE,iBA+B9B,CAAC"}

package/dist/frameworks/terraform.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Terraform / OpenTofu Framework Resolver
+ *
+ * Since HCL doesn't have a bundled WASM grammar, this resolver uses regex-based
+ * extraction to create nodes from .tf files. It extracts:
+ * - Resources as class-like nodes
+ * - Data sources as variable-like nodes
+ * - Modules as namespace-like nodes
+ * - Variables and outputs as variable/export nodes
+ * - API Gateway routes as route nodes
+ */
+import type { FrameworkResolver } from './types';
+export declare const terraformResolver: FrameworkResolver;
+//# sourceMappingURL=terraform.d.ts.map

package/dist/frameworks/terraform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terraform.d.ts","sourceRoot":"","sources":["../../src/frameworks/terraform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAEhG,eAAO,MAAM,iBAAiB,EAAE,iBAoL/B,CAAC"}

package/dist/frameworks/vue.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Vue / Nuxt Framework Resolver
+ */
+import type { FrameworkResolver } from './types';
+export declare const nuxtResolver: FrameworkResolver;
+export declare const vueResolver: FrameworkResolver;
+//# sourceMappingURL=vue.d.ts.map

package/dist/frameworks/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/frameworks/vue.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAEhG,eAAO,MAAM,YAAY,EAAE,iBA+E1B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,iBA0BzB,CAAC"}

package/dist/graph/communities.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Community Detection via Leiden Algorithm
+ *
+ * Clusters related code into communities based on edge connectivity.
+ * Oversized communities (>25% of graph) are recursively split with higher resolution.
+ *
+ * Leiden improves on Louvain by adding a refinement phase between the local-move phase
+ * and the aggregation phase. The refinement sub-partitions each community into
+ * well-connected sub-communities, guaranteeing that every community in the final
+ * partition is internally connected. This prevents the "disconnected community"
+ * artefact that Louvain is known to produce.
+ */
+import type { GraphDatabase } from '../db/database';
+export interface Community {
+    id: number;
+    label: string;
+    memberCount: number;
+    members: Array<{
+        id: string;
+        name: string;
+        kind: string;
+        filePath: string;
+    }>;
+    dominantDirectory: string;
+    dominantLanguage: string;
+    interCommunityEdges: number;
+}
+export interface CommunityResult {
+    communities: Community[];
+    modularity: number;
+    totalNodes: number;
+    totalEdges: number;
+    /** Algorithm used to detect communities. */
+    algorithm: 'leiden';
+}
+/**
+ * Run community detection on the graph using the Leiden algorithm.
+ */
+export declare function detectCommunities(db: GraphDatabase, opts?: {
+    resolution?: number;
+    maxCommunityPct?: number;
+}): CommunityResult;
+//# sourceMappingURL=communities.d.ts.map

package/dist/graph/communities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"communities.d.ts","sourceRoot":"","sources":["../../src/graph/communities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,QAAQ,CAAC;CACrB;AA4TD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAyJ9H"}

package/dist/graph/flows.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Execution Flow Tracing
+ *
+ * Traces call chains from entry points (functions with no incoming call edges,
+ * route handlers, main functions) through the graph, sorted by criticality.
+ */
+import type { GraphDatabase } from '../db/database';
+export interface FlowHop {
+    symbol: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    edgeKind?: string;
+    confidence?: string;
+}
+export interface ExecutionFlow {
+    entryPoint: string;
+    entryPointKind: string;
+    entryPointFile: string;
+    criticality: number;
+    hops: FlowHop[];
+}
+/**
+ * Detect entry points: symbols that are likely execution starting points.
+ * - Route nodes
+ * - Functions with zero incoming call edges
+ * - Symbols matching known entry patterns (main, handler, controller, etc.)
+ */
+export declare function detectEntryPoints(db: GraphDatabase, limit?: number): Array<{
+    id: string;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+}>;
+/**
+ * Trace a single execution flow from an entry point forward through call edges.
+ * Returns the chain of hops with criticality scoring.
+ */
+export declare function traceFlow(db: GraphDatabase, entryPointId: string, maxDepth?: number): FlowHop[];
+/**
+ * Compute criticality score for a flow based on:
+ * - Length (longer flows = more critical paths)
+ * - Fan-out of hops (more downstream = higher criticality)
+ * - Whether it touches I/O-like patterns (db, http, file)
+ */
+export declare function scoreCriticality(hops: FlowHop[]): number;
+/**
+ * Get execution flows from all detected entry points.
+ */
+export declare function getExecutionFlows(db: GraphDatabase, opts?: {
+    maxFlows?: number;
+    maxDepth?: number;
+}): ExecutionFlow[];
+//# sourceMappingURL=flows.d.ts.map

package/dist/graph/flows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/graph/flows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,SAAK,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA6ClJ;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,OAAO,EAAE,CA8C3F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAUxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,EAAE,CAwBrH"}

package/dist/graph/refactor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Refactoring Tools
+ *
+ * - rename: Preview all locations that reference a symbol (rename preview)
+ * - suggest: Community-driven refactoring suggestions
+ */
+import type { GraphDatabase } from '../db/database';
+export interface RenameLocation {
+    filePath: string;
+    line: number;
+    column?: number;
+    context: string;
+    edgeKind: string;
+}
+export interface RenamePreview {
+    symbol: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    references: RenameLocation[];
+    totalReferences: number;
+}
+export interface RefactorSuggestion {
+    type: 'move' | 'split' | 'extract' | 'group';
+    description: string;
+    symbols: string[];
+    rationale: string;
+    priority: 'high' | 'medium' | 'low';
+}
+/**
+ * Generate a rename preview: find all locations that reference a symbol.
+ * This shows what would need to change if the symbol is renamed.
+ */
+export declare function renamePreview(db: GraphDatabase, symbolName: string): RenamePreview | null;
+/**
+ * Generate refactoring suggestions based on graph structure.
+ * Looks for:
+ * - Symbols that are far from their most-connected peers (move candidates)
+ * - Files with too many symbols in different "clusters" (split candidates)
+ * - Groups of related symbols scattered across files (group candidates)
+ */
+export declare function suggestRefactorings(db: GraphDatabase, limit?: number): RefactorSuggestion[];
+//# sourceMappingURL=refactor.d.ts.map

package/dist/graph/refactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor.d.ts","sourceRoot":"","sources":["../../src/graph/refactor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqEzF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,SAAK,GAAG,kBAAkB,EAAE,CA6EvF"}

package/dist/index.d.ts

@@ -4,9 +4,13 @@
  * Pure facade. Every method delegates to a focused sub-system.
  * No business logic lives here.
  */
+import { GraphDatabase } from './db/database';
 import type { KiroGraphConfig } from './config';
+import { SnapshotManager } from './core/snapshot';
 import type { FileTreeNode, FileTree } from './core/file-tree';
-import type { Node, NodeKind, IndexResult, IndexProgress, SyncResult, TaskContext, SearchResult, SearchOptions, NodeContext, NodeMetrics } from './types';
+import type { GraphSnapshot, GraphDiff } from './core/snapshot';
+export type { GraphSnapshot, GraphDiff };
+import type { Node, Edge, NodeKind, IndexResult, IndexProgress, SyncResult, TaskContext, SearchResult, SearchOptions, NodeContext, NodeMetrics } from './types';
 import type { ArchitectureResult } from './architecture/types';
 export type { FileTreeNode, FileTree };
 export default class KiroGraph {
@@ -22,24 +26,36 @@ export default class KiroGraph {
     private readonly pipeline;
     private readonly searcher;
     private constructor();
-    static init(projectRoot: string, config?: Partial<KiroGraphConfig>): Promise<KiroGraph>;
-    static open(projectRoot: string): Promise<KiroGraph>;
+    static init(projectRoot: string, config?: Partial<KiroGraphConfig>, onModelProgress?: (file: string, loaded: number, total: number, done: boolean) => void): Promise<KiroGraph>;
+    static open(projectRoot: string, onModelProgress?: (file: string, loaded: number, total: number, done: boolean) => void): Promise<KiroGraph>;
     static isInitialized(projectRoot: string): boolean;
     unlockForce(): void;
     markDirty(): void;
     clearDirty(): void;
     isDirty(): boolean;
+    isIndexLocked(): boolean;
     syncIfDirty(): Promise<SyncResult | null>;
+    /**
+     * Returns the number of files that have changed on disk but are not yet
+     * reflected in the index. Used by the MCP status tool to warn the agent
+     * when the index may be stale.
+     */
+    getPendingSyncCount(): Promise<number>;
     indexAll(opts?: {
         onProgress?: (p: IndexProgress) => void;
         force?: boolean;
         signal?: AbortSignal;
     }): Promise<IndexResult>;
-    sync(changedFiles?: string[]): Promise<SyncResult>;
+    sync(changedFilesOrOpts?: string[] | {
+        files?: string[];
+        onProgress?: (p: IndexProgress) => void;
+    }): Promise<SyncResult>;
     searchNodes(query: string, kindOrOpts?: NodeKind | SearchOptions, limit?: number): SearchResult[];
     getCallers(nodeId: string, limit?: number): Promise<Node[]>;
     getCallees(nodeId: string, limit?: number): Promise<Node[]>;
     getImpactRadius(nodeId: string, depth?: number): Promise<Node[]>;
+    getAllNodes(): Node[];
+    getAllEdges(): Edge[];
     findDeadCode(limit?: number): Node[];
     findCircularDependencies(): string[][];
     findPath(fromId: string, toId: string, maxDepth?: number): Promise<Node[]>;
@@ -61,7 +77,22 @@ export default class KiroGraph {
         depth?: number;
         testPattern?: string;
     }): string[];
+    findHotspots(limit?: number): Array<Node & {
+        degree: number;
+        inDegree: number;
+        outDegree: number;
+    }>;
+    findSurprisingConnections(limit?: number): Array<{
+        source: Node;
+        target: Node;
+        kind: string;
+        score: number;
+    }>;
+    createSnapshotManager(): SnapshotManager;
     getStats(): Promise<{
+        pendingFiles: number;
+        syncRunning: boolean;
+        syncWarningThreshold: number;
         architectureStats?: {
             packages: number;
             layers: number;
@@ -95,6 +126,7 @@ export default class KiroGraph {
     };
     isArchitectureEnabled(): boolean;
     getProjectRoot(): string;
+    getDatabase(): GraphDatabase;
     close(): void;
 }
 /** Walk up directories to find the nearest .kirograph/ folder. */

package/dist/index.d.ts.map

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

package/dist/mcp/cache.d.ts

@@ -0,0 +1,69 @@
+/**
+ * KiroGraph File Read Cache
+ *
+ * In-memory, session-scoped file cache. First read returns full content,
+ * subsequent reads of unchanged files return a compact "cached" marker (~13 tokens).
+ * Uses content hashing (SHA-256) to detect changes.
+ */
+export interface CacheEntry {
+    contentHash: string;
+    content: string;
+    lastRead: number;
+    readCount: number;
+}
+export interface CacheStats {
+    entries: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+}
+export interface ReadResult {
+    content: string;
+    cached: boolean;
+    changed: boolean;
+    /** Previous content (for diff mode) */
+    previousContent?: string;
+}
+export declare class FileReadCache {
+    private cache;
+    private hits;
+    private misses;
+    /**
+     * Read a file with caching. Returns full content on first read or if changed,
+     * returns a compact marker if unchanged since last read.
+     */
+    read(filePath: string, noCache?: boolean): ReadResult;
+    /**
+     * Get the previously cached content for a file (used by diff mode).
+     */
+    getPreviousContent(filePath: string): string | undefined;
+    /**
+     * Check if a file is in the cache.
+     */
+    has(filePath: string): boolean;
+    /**
+     * Invalidate cache entries for specific files (e.g., after sync).
+     */
+    invalidate(filePaths: string[]): void;
+    /**
+     * Clear all cached entries.
+     */
+    clear(): void;
+    /**
+     * Get cache statistics.
+     */
+    getStats(): CacheStats;
+    /**
+     * List all cached file paths with their metadata.
+     */
+    listEntries(): Array<{
+        path: string;
+        readCount: number;
+        lastRead: number;
+    }>;
+    private hashContent;
+    private formatTimestamp;
+}
+export declare function getFileReadCache(): FileReadCache;
+export declare function resetFileReadCache(): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/mcp/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/mcp/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IAEnB;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,UAAU;IAuDnD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIxD;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAMrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI,UAAU;IAUtB;;OAEG;IACH,WAAW,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ3E,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;CASxB;AAKD,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/mcp/read-modes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * KiroGraph Read Modes
+ *
+ * Implements multiple read modes for the kirograph_read tool:
+ * - full: entire file content (default)
+ * - map: structure overview (symbols with line numbers)
+ * - signatures: function/class signatures only
+ * - diff: changes since last read
+ * - lines: specific line range
+ * - imports: import statements
+ * - exports: exported symbols
+ */
+import type KiroGraph from '../index';
+export type ReadMode = 'full' | 'map' | 'signatures' | 'diff' | 'lines' | 'imports' | 'exports';
+export interface ReadModeOptions {
+    mode: ReadMode;
+    filePath: string;
+    start?: number;
+    end?: number;
+    cg?: KiroGraph | null;
+}
+export interface ReadModeResult {
+    content: string;
+    mode: ReadMode;
+    tokenEstimate: number;
+}
+/**
+ * Execute a read mode against a file.
+ */
+export declare function executeReadMode(opts: ReadModeOptions): ReadModeResult;
+//# sourceMappingURL=read-modes.d.ts.map

package/dist/mcp/read-modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-modes.d.ts","sourceRoot":"","sources":["../../src/mcp/read-modes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,SAAS,MAAM,UAAU,CAAC;AAGtC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAqBrE"}

package/dist/mcp/server.d.ts

@@ -7,6 +7,7 @@ export declare class MCPServer {
     private cg;
     private toolHandler;
     private projectPath;
+    private config;
     constructor(projectPath?: string);
     start(): Promise<void>;
     private tryInit;

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAgB;gBAEvB,WAAW,CAAC,EAAE,MAAM;IAK1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,OAAO;YAYP,aAAa;IA4C3B,OAAO,CAAC,IAAI;CAKb"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAgB;IAEnC,OAAO,CAAC,MAAM,CAAoB;gBAEtB,WAAW,CAAC,EAAE,MAAM;IAM1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,OAAO;YAkBP,aAAa;IAiD3B,OAAO,CAAC,IAAI;CAKb"}

package/dist/mcp/server.js

@@ -35,12 +35,15 @@ var path = __toESM(require("path"));
 var import__ = __toESM(require("../index"));
 var import_transport = require("./transport");
 var import_tools = require("./tools");
+var import_runner = require("../patterns/runner");
 const SERVER_INFO = { name: "kirograph", version: "0.1.0" };
 const PROTOCOL_VERSION = "2024-11-05";
 class MCPServer {
   constructor(projectPath) {
     this.transport = new import_transport.StdioTransport();
     this.cg = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    this.config = null;
     this.projectPath = projectPath ? path.resolve(projectPath) : null;
     this.toolHandler = new import_tools.ToolHandler(null);
   }
@@ -65,6 +68,11 @@ class MCPServer {
       process.stderr.write(`[KiroGraph MCP] Failed to open ${root}: ${err}
 `);
     }
+    try {
+      const { loadConfig } = await Promise.resolve().then(() => require("../config.js"));
+      this.config = await loadConfig(root);
+    } catch {
+    }
   }
   async handleMessage(msg) {
     const req = msg;
@@ -83,8 +91,13 @@ class MCPServer {
           serverInfo: SERVER_INFO
         };
       }
-      case "tools/list":
-        return { tools: import_tools.tools };
+      case "tools/list": {
+        const dynamicTools = [...import_tools.tools];
+        if (this.config?.enablePatterns && new import_runner.PatternRunner().isAvailable()) {
+          dynamicTools.push(import_tools.LIVE_SEARCH_TOOL_DEFINITION);
+        }
+        return { tools: dynamicTools };
+      }
       case "tools/call": {
         const { name, arguments: args = {} } = req.params ?? {};
         try {