kirograph 0.28.0 → 0.28.1

package/dist/graph/refactor.d.ts

@@ -1,43 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/graph/traversal.d.ts

@@ -1,35 +0,0 @@
-/**
- * KiroGraph Graph Traversal Module
- * Provides BFS and DFS traversal over the knowledge graph.
- */
-import type { Node, EdgeKind, NodeKind } from '../types';
-import type { GraphDatabase } from '../db/database';
-export interface TraversalOptions {
-    maxDepth?: number;
-    edgeKinds?: EdgeKind[];
-    nodeKinds?: NodeKind[];
-    direction?: 'outgoing' | 'incoming' | 'both';
-    limit?: number;
-    includeStart?: boolean;
-}
-export declare class GraphTraverser {
-    private readonly db;
-    constructor(db: GraphDatabase);
-    /**
-     * Breadth-first traversal from startId.
-     * Visits all nodes at depth D before any node at depth D+1.
-     */
-    traverseBFS(startId: string, opts?: TraversalOptions): Promise<Node[]>;
-    /**
-     * Depth-first traversal from startId.
-     */
-    traverseDFS(startId: string, opts?: TraversalOptions): Promise<Node[]>;
-    /**
-     * Get neighbor node IDs from the database, filtered by direction and edge kinds.
-     */
-    private getNeighbors;
-    private getOutgoingEdges;
-    private getIncomingEdges;
-    private matchesNodeKinds;
-}
-//# sourceMappingURL=traversal.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"traversal.d.ts","sourceRoot":"","sources":["../../src/graph/traversal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,aAAa;IAE9C;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAoDhF;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IA+ChF;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/index.d.ts

@@ -1,134 +0,0 @@
-/**
- * KiroGraph — Semantic code knowledge graph for Kiro
- *
- * 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 { 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 {
-    private readonly db;
-    private readonly config;
-    private readonly projectRoot;
-    private readonly queryManager;
-    private readonly resolver;
-    private readonly vectors;
-    private readonly contextBuilder;
-    private readonly arch;
-    private readonly lock;
-    private readonly pipeline;
-    private readonly searcher;
-    private constructor();
-    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(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[]>;
-    getTypeHierarchy(nodeId: string, direction?: 'up' | 'down' | 'both'): Node[];
-    getNode(id: string): Node | null;
-    getNodeContext(nodeId: string): NodeContext | null;
-    getNodeMetrics(nodeId: string): NodeMetrics;
-    getNodeSource(node: Node): string | null;
-    buildContext(task: string, opts?: {
-        maxNodes?: number;
-        includeCode?: boolean;
-    }): Promise<TaskContext>;
-    getFiles(opts?: {
-        filterPath?: string;
-        pattern?: string;
-        maxDepth?: number;
-    }): FileTree;
-    getAffectedTests(changedFiles: string[], opts?: {
-        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;
-            packageDeps: number;
-        };
-        embeddingCount: number;
-        embeddableNodeCount: number;
-        embeddingsEnabled: boolean;
-        embeddingModel: string;
-        useVecIndex: boolean;
-        semanticEngine: "cosine" | "sqlite-vec" | "orama" | "pglite" | "lancedb" | "qdrant" | "typesense";
-        vecIndexCount: number;
-        engineFallback: string | null;
-        frameworks: string[];
-        architectureEnabled: boolean;
-        files: number;
-        nodes: number;
-        edges: number;
-        nodesByKind: Record<string, number>;
-        filesByLanguage: Record<string, number>;
-        dbSizeBytes: number;
-    }>;
-    getEngineFallback(): string | null;
-    getArchitecture(): ArchitectureResult & {
-        filePackages: Record<string, string[]>;
-        fileLayers: Record<string, Array<{
-            layerId: string;
-            confidence: number;
-            matchedPattern: string;
-        }>>;
-    };
-    isArchitectureEnabled(): boolean;
-    getProjectRoot(): string;
-    getDatabase(): GraphDatabase;
-    close(): void;
-}
-/** Walk up directories to find the nearest .kirograph/ folder. */
-export declare function findNearestKiroGraphRoot(startPath: string): string | null;
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/installer/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * KiroGraph Installer for Kiro
- *
- * Wires up:
- *  1. .kiro/settings/mcp.json  — registers the MCP server
- *  2. .kiro/hooks/*.json       — auto-sync on file save/create/delete (via mark-dirty + sync-if-dirty)
- *  3. .kiro/steering/kirograph.md — teaches Kiro to use the graph tools
- */
-export declare function runInstaller(): Promise<void>;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsaH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAwGlD"}