@zipbul/gildash 0.5.1 → 0.6.0

package/dist/migrations/meta/0004_snapshot.json

@@ -0,0 +1,429 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "4792483b-0af0-4775-a2df-c04b8066770e",
+  "prevId": "5b9c3951-b14d-4b77-b125-ca1e30793c73",
+  "tables": {
+    "files": {
+      "name": "files",
+      "columns": {
+        "project": {
+          "name": "project",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "file_path": {
+          "name": "file_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "mtime_ms": {
+          "name": "mtime_ms",
+          "type": "real",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "size": {
+          "name": "size",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content_hash": {
+          "name": "content_hash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "line_count": {
+          "name": "line_count",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "files_project_file_path_pk": {
+          "columns": [
+            "project",
+            "file_path"
+          ],
+          "name": "files_project_file_path_pk"
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "relations": {
+      "name": "relations",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "project": {
+          "name": "project",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "type": {
+          "name": "type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "src_file_path": {
+          "name": "src_file_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "src_symbol_name": {
+          "name": "src_symbol_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "dst_project": {
+          "name": "dst_project",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "dst_file_path": {
+          "name": "dst_file_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "dst_symbol_name": {
+          "name": "dst_symbol_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "meta_json": {
+          "name": "meta_json",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "idx_relations_src": {
+          "name": "idx_relations_src",
+          "columns": [
+            "project",
+            "src_file_path"
+          ],
+          "isUnique": false
+        },
+        "idx_relations_dst": {
+          "name": "idx_relations_dst",
+          "columns": [
+            "dst_project",
+            "dst_file_path"
+          ],
+          "isUnique": false
+        },
+        "idx_relations_type": {
+          "name": "idx_relations_type",
+          "columns": [
+            "project",
+            "type"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "relations_project_src_file_path_files_project_file_path_fk": {
+          "name": "relations_project_src_file_path_files_project_file_path_fk",
+          "tableFrom": "relations",
+          "tableTo": "files",
+          "columnsFrom": [
+            "project",
+            "src_file_path"
+          ],
+          "columnsTo": [
+            "project",
+            "file_path"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "relations_dst_project_dst_file_path_files_project_file_path_fk": {
+          "name": "relations_dst_project_dst_file_path_files_project_file_path_fk",
+          "tableFrom": "relations",
+          "tableTo": "files",
+          "columnsFrom": [
+            "dst_project",
+            "dst_file_path"
+          ],
+          "columnsTo": [
+            "project",
+            "file_path"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "symbols": {
+      "name": "symbols",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "project": {
+          "name": "project",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "file_path": {
+          "name": "file_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "kind": {
+          "name": "kind",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "start_line": {
+          "name": "start_line",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "start_column": {
+          "name": "start_column",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "end_line": {
+          "name": "end_line",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "end_column": {
+          "name": "end_column",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_exported": {
+          "name": "is_exported",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "signature": {
+          "name": "signature",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "fingerprint": {
+          "name": "fingerprint",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "detail_json": {
+          "name": "detail_json",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content_hash": {
+          "name": "content_hash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "indexed_at": {
+          "name": "indexed_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "resolved_type": {
+          "name": "resolved_type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "idx_symbols_project_file": {
+          "name": "idx_symbols_project_file",
+          "columns": [
+            "project",
+            "file_path"
+          ],
+          "isUnique": false
+        },
+        "idx_symbols_project_kind": {
+          "name": "idx_symbols_project_kind",
+          "columns": [
+            "project",
+            "kind"
+          ],
+          "isUnique": false
+        },
+        "idx_symbols_project_name": {
+          "name": "idx_symbols_project_name",
+          "columns": [
+            "project",
+            "name"
+          ],
+          "isUnique": false
+        },
+        "idx_symbols_fingerprint": {
+          "name": "idx_symbols_fingerprint",
+          "columns": [
+            "project",
+            "fingerprint"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "symbols_project_file_path_files_project_file_path_fk": {
+          "name": "symbols_project_file_path_files_project_file_path_fk",
+          "tableFrom": "symbols",
+          "tableTo": "files",
+          "columnsFrom": [
+            "project",
+            "file_path"
+          ],
+          "columnsTo": [
+            "project",
+            "file_path"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "watcher_owner": {
+      "name": "watcher_owner",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "pid": {
+          "name": "pid",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "started_at": {
+          "name": "started_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "heartbeat_at": {
+          "name": "heartbeat_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {
+        "watcher_owner_singleton": {
+          "name": "watcher_owner_singleton",
+          "value": "\"watcher_owner\".\"id\" = 1"
+        }
+      }
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/dist/migrations/meta/_journal.json

@@ -22,6 +22,20 @@
       "when": 1771900800000,
       "tag": "0002_fts_setup",
       "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "6",
+      "when": 1771949593329,
+      "tag": "0003_majestic_mongu",
+      "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "6",
+      "when": 1772043335425,
+      "tag": "0004_cool_firestar",
+      "breakpoints": true
     }
   ]
 }

package/dist/src/errors.d.ts

@@ -1,7 +1,7 @@
 /**
  * Discriminated union type representing all possible error categories in Gildash.
  */
-export type GildashErrorType = 'watcher' | 'parse' | 'extract' | 'index' | 'store' | 'search' | 'closed' | 'validation' | 'close';
+export type GildashErrorType = 'watcher' | 'parse' | 'extract' | 'index' | 'store' | 'search' | 'closed' | 'validation' | 'close' | 'semantic';
 /**
  * Plain-object error value used throughout Gildash's Result-based error handling.
  * Produced by {@link gildashError} and carried as the `data` field of an `Err<GildashError>`.

package/dist/src/extractor/relation-extractor.d.ts

@@ -1,4 +1,5 @@
 import type { Program } from 'oxc-parser';
 import type { TsconfigPaths } from '../common/tsconfig-resolver';
 import type { CodeRelation } from './types';
-export declare function extractRelations(ast: Program, filePath: string, tsconfigPaths?: TsconfigPaths): CodeRelation[];
+export type ResolveImportFn = (currentFilePath: string, importPath: string, tsconfigPaths?: TsconfigPaths) => string[];
+export declare function extractRelations(ast: Program, filePath: string, tsconfigPaths?: TsconfigPaths, resolveImportFn?: ResolveImportFn): CodeRelation[];

package/dist/src/gildash/context.d.ts

@@ -0,0 +1,91 @@
+import type { Result } from '@zipbul/result';
+import type { ParsedFile } from '../parser/types';
+import type { ParserOptions, Program } from 'oxc-parser';
+import type { ExtractedSymbol, CodeRelation } from '../extractor/types';
+import type { DbConnection } from '../store/connection';
+import type { FileRepository } from '../store/repositories/file.repository';
+import type { SymbolRepository } from '../store/repositories/symbol.repository';
+import type { RelationRepository } from '../store/repositories/relation.repository';
+import type { ProjectWatcher } from '../watcher/project-watcher';
+import type { IndexCoordinator, IndexResult } from '../indexer/index-coordinator';
+import type { FileChangeEvent } from '../watcher/types';
+import type { WatcherOwnerStore } from '../watcher/ownership';
+import type { WatcherRole } from '../watcher/types';
+import type { ProjectBoundary } from '../common/project-discovery';
+import type { TsconfigPaths } from '../common/tsconfig-resolver';
+import type { SymbolSearchQuery, SymbolSearchResult, ISymbolRepo } from '../search/symbol-search';
+import type { RelationSearchQuery, IRelationRepo } from '../search/relation-search';
+import type { PatternMatch } from '../search/pattern-search';
+import type { DependencyGraph } from '../search/dependency-graph';
+import type { SemanticLayer } from '../semantic/index';
+import type { ParseCache } from '../parser/parse-cache';
+import type { GildashError } from '../errors';
+import type { Logger } from './types';
+export type ParseSourceFn = (filePath: string, sourceText: string, options?: ParserOptions) => Result<ParsedFile, GildashError>;
+export type ExtractSymbolsFn = (parsed: ParsedFile) => ExtractedSymbol[];
+export type ExtractRelationsFn = (ast: Program, filePath: string, tsconfigPaths?: TsconfigPaths) => CodeRelation[];
+export type SymbolSearchFn = (options: {
+    symbolRepo: ISymbolRepo;
+    project?: string;
+    query: SymbolSearchQuery;
+}) => SymbolSearchResult[];
+export type RelationSearchFn = (options: {
+    relationRepo: IRelationRepo;
+    project?: string;
+    query: RelationSearchQuery;
+}) => CodeRelation[];
+export type PatternSearchFn = (opts: {
+    pattern: string;
+    filePaths: string[];
+}) => Promise<PatternMatch[]>;
+export type AcquireWatcherRoleFn = (db: WatcherOwnerStore, pid: number, options?: object) => WatcherRole | Promise<WatcherRole>;
+export type ReleaseWatcherRoleFn = (db: WatcherOwnerStore, pid: number) => void;
+export type UpdateHeartbeatFn = (db: WatcherOwnerStore, pid: number) => void;
+export type DbStore = Pick<DbConnection, 'open' | 'close' | 'transaction'> & WatcherOwnerStore;
+export type FileRepoLike = Pick<FileRepository, 'upsertFile' | 'getAllFiles' | 'getFilesMap' | 'deleteFile' | 'getFile'>;
+export type ParseCacheLike = Pick<ParseCache, 'set' | 'get' | 'invalidate'>;
+export type CoordinatorLike = Pick<IndexCoordinator, 'fullIndex' | 'shutdown' | 'onIndexed'> & {
+    tsconfigPaths?: Promise<TsconfigPaths | null>;
+    handleWatcherEvent?(event: FileChangeEvent): void;
+};
+export type WatcherLike = Pick<ProjectWatcher, 'start' | 'close'>;
+export type SemanticLayerLike = Pick<SemanticLayer, 'collectTypeAt' | 'collectFileTypes' | 'findReferences' | 'findImplementations' | 'getModuleInterface' | 'getSymbolNode' | 'notifyFileChanged' | 'notifyFileDeleted' | 'dispose' | 'isDisposed' | 'lineColumnToPosition' | 'findNamePosition'>;
+/** Internal shared state for all Gildash API modules. */
+export interface GildashContext {
+    readonly projectRoot: string;
+    readonly extensions: string[];
+    readonly ignorePatterns: string[];
+    readonly logger: Logger;
+    readonly defaultProject: string;
+    readonly role: 'owner' | 'reader';
+    readonly db: DbStore;
+    readonly symbolRepo: SymbolRepository;
+    readonly relationRepo: RelationRepository;
+    readonly fileRepo: FileRepoLike;
+    readonly parseCache: ParseCacheLike;
+    readonly releaseWatcherRoleFn: ReleaseWatcherRoleFn;
+    readonly parseSourceFn: ParseSourceFn;
+    readonly extractSymbolsFn: ExtractSymbolsFn;
+    readonly extractRelationsFn: ExtractRelationsFn;
+    readonly symbolSearchFn: SymbolSearchFn;
+    readonly relationSearchFn: RelationSearchFn;
+    readonly patternSearchFn: PatternSearchFn;
+    readonly readFileFn: (filePath: string) => Promise<string>;
+    readonly unlinkFn: (filePath: string) => Promise<void>;
+    readonly existsSyncFn: (p: string) => boolean;
+    readonly acquireWatcherRoleFn: AcquireWatcherRoleFn;
+    readonly updateHeartbeatFn: UpdateHeartbeatFn;
+    readonly watcherFactory?: () => WatcherLike;
+    readonly coordinatorFactory?: () => CoordinatorLike;
+    closed: boolean;
+    coordinator: CoordinatorLike | null;
+    watcher: WatcherLike | null;
+    timer: ReturnType<typeof setInterval> | null;
+    signalHandlers: Array<[string, () => void]>;
+    tsconfigPaths: TsconfigPaths | null;
+    boundaries: ProjectBoundary[];
+    onIndexedCallbacks: Set<(result: IndexResult) => void>;
+    graphCache: DependencyGraph | null;
+    graphCacheKey: string | null;
+    semanticLayer: SemanticLayerLike | null;
+}

package/dist/src/gildash/extract-api.d.ts

@@ -0,0 +1,9 @@
+import { type Result } from '@zipbul/result';
+import type { ParsedFile } from '../parser/types';
+import type { ExtractedSymbol, CodeRelation } from '../extractor/types';
+import type { GildashError } from '../errors';
+import type { GildashContext } from './context';
+/** Extract all symbol declarations from a previously parsed file. */
+export declare function extractSymbols(ctx: GildashContext, parsed: ParsedFile): Result<ExtractedSymbol[], GildashError>;
+/** Extract inter-file relationships from a previously parsed file. */
+export declare function extractRelations(ctx: GildashContext, parsed: ParsedFile): Result<CodeRelation[], GildashError>;

package/dist/src/gildash/graph-api.d.ts

@@ -0,0 +1,30 @@
+import { type Result } from '@zipbul/result';
+import type { GildashError } from '../errors';
+import { DependencyGraph } from '../search/dependency-graph';
+import type { GildashContext } from './context';
+import type { FanMetrics } from './types';
+/** Invalidate the cached DependencyGraph (called after every index run). */
+export declare function invalidateGraphCache(ctx: GildashContext): void;
+/**
+ * Return a cached or freshly-built DependencyGraph for the given project.
+ * Builds once per key; subsequent calls with the same key return the cached instance.
+ */
+export declare function getOrBuildGraph(ctx: GildashContext, project?: string): DependencyGraph;
+/** List the files that a given file directly imports. */
+export declare function getDependencies(ctx: GildashContext, filePath: string, project?: string, limit?: number): Result<string[], GildashError>;
+/** List the files that directly import a given file. */
+export declare function getDependents(ctx: GildashContext, filePath: string, project?: string, limit?: number): Result<string[], GildashError>;
+/** Compute the full set of files transitively affected by changes. */
+export declare function getAffected(ctx: GildashContext, changedFiles: string[], project?: string): Promise<Result<string[], GildashError>>;
+/** Check whether the import graph contains a circular dependency. */
+export declare function hasCycle(ctx: GildashContext, project?: string): Promise<Result<boolean, GildashError>>;
+/** Return the full import graph as an adjacency list. */
+export declare function getImportGraph(ctx: GildashContext, project?: string): Promise<Result<Map<string, string[]>, GildashError>>;
+/** Return all files that `filePath` transitively imports (forward BFS). */
+export declare function getTransitiveDependencies(ctx: GildashContext, filePath: string, project?: string): Promise<Result<string[], GildashError>>;
+/** Return all cycle paths in the import graph. */
+export declare function getCyclePaths(ctx: GildashContext, project?: string, options?: {
+    maxCycles?: number;
+}): Promise<Result<string[][], GildashError>>;
+/** Compute import-graph fan metrics (fan-in / fan-out) for a single file. */
+export declare function getFanMetrics(ctx: GildashContext, filePath: string, project?: string): Promise<Result<FanMetrics, GildashError>>;