@zipbul/gildash 0.8.2 → 0.9.0

package/dist/src/extractor/types.d.ts

@@ -163,4 +163,12 @@ export interface CodeRelation {
     /** Parsed metadata object derived from `metaJson`. */
     meta?: Record<string, unknown>;
 }
+export type AnnotationSource = 'jsdoc' | 'line' | 'block';
+export interface ExtractedAnnotation {
+    tag: string;
+    value: string;
+    source: AnnotationSource;
+    span: SourceSpan;
+    symbolName: string | null;
+}
 export type { SourcePosition, SourceSpan };

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

@@ -0,0 +1,3 @@
+import type { GildashContext } from './context';
+import type { AnnotationSearchQuery, AnnotationSearchResult } from '../search/annotation-search';
+export declare function searchAnnotations(ctx: GildashContext, query: AnnotationSearchQuery): AnnotationSearchResult[];

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

@@ -0,0 +1,4 @@
+import type { GildashContext } from './context';
+import type { SymbolChange, SymbolChangeQueryOptions } from './types';
+export declare function getSymbolChanges(ctx: GildashContext, since: Date | string, options?: SymbolChangeQueryOptions): SymbolChange[];
+export declare function pruneChangelog(ctx: GildashContext, before: Date | string): number;

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

@@ -16,7 +16,9 @@ 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 { AnnotationSearchQuery, AnnotationSearchResult, IAnnotationRepo } from '../search/annotation-search';
 import type { DependencyGraph } from '../search/dependency-graph';
+import type { ChangelogRepository } from '../store/repositories/changelog.repository';
 import type { SemanticLayer } from '../semantic/index';
 import type { ParseCache } from '../parser/parse-cache';
 import type { GildashError } from '../errors';
@@ -38,6 +40,11 @@ export type PatternSearchFn = (opts: {
     pattern: string;
     filePaths: string[];
 }) => Promise<PatternMatch[]>;
+export type AnnotationSearchFn = (options: {
+    annotationRepo: IAnnotationRepo;
+    project?: string;
+    query: AnnotationSearchQuery;
+}) => AnnotationSearchResult[];
 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;
@@ -63,6 +70,9 @@ export interface GildashContext {
     readonly relationRepo: RelationRepository;
     readonly fileRepo: FileRepoLike;
     readonly parseCache: ParseCacheLike;
+    readonly annotationRepo: IAnnotationRepo | null;
+    readonly changelogRepo: ChangelogRepository | null;
+    readonly annotationSearchFn: AnnotationSearchFn | null;
     readonly releaseWatcherRoleFn: ReleaseWatcherRoleFn;
     readonly parseSourceFn: ParseSourceFn;
     readonly extractSymbolsFn: ExtractSymbolsFn;

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

@@ -14,6 +14,8 @@ import type { FileChangeEvent } from '../watcher/types';
 import { GildashError } from '../errors';
 import type { GildashOptions, SymbolDiff, ModuleInterface, HeritageNode, FullSymbol, FileStats, FanMetrics, ResolvedSymbol, BatchParseResult } from './types';
 import type { GildashInternalOptions } from './lifecycle';
+import type { AnnotationSearchQuery, AnnotationSearchResult } from '../search/annotation-search';
+import type { SymbolChange, SymbolChangeQueryOptions } from './types';
 export type { Logger, GildashOptions, SymbolDiff, ModuleInterface, HeritageNode, FullSymbol, FileStats, FanMetrics, ResolvedSymbol, BatchParseResult, } from './types';
 export type { GildashInternalOptions } from './lifecycle';
 /**
@@ -93,4 +95,7 @@ export declare class Gildash {
     onFileChanged(callback: (event: FileChangeEvent) => void): () => void;
     onError(callback: (error: GildashError) => void): () => void;
     onRoleChanged(callback: (newRole: 'owner' | 'reader') => void): () => void;
+    searchAnnotations(query: AnnotationSearchQuery): AnnotationSearchResult[];
+    getSymbolChanges(since: Date | string, options?: SymbolChangeQueryOptions): SymbolChange[];
+    pruneChangelog(before: Date | string): number;
 }

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

@@ -143,6 +143,29 @@ export interface BatchParseResult {
 /**
  * Options for creating a {@link Gildash} instance via {@link Gildash.open}.
  */
+export type SymbolChangeType = 'added' | 'modified' | 'removed' | 'renamed' | 'moved';
+export interface SymbolChange {
+    changeType: SymbolChangeType;
+    symbolName: string;
+    symbolKind: string;
+    filePath: string;
+    oldName: string | null;
+    oldFilePath: string | null;
+    fingerprint: string | null;
+    changedAt: string;
+    isFullIndex: boolean;
+    indexRunId: string;
+}
+export interface SymbolChangeQueryOptions {
+    symbolName?: string;
+    changeTypes?: SymbolChangeType[];
+    filePath?: string;
+    includeFullIndex?: boolean;
+    indexRunId?: string;
+    afterId?: number;
+    limit?: number;
+    project?: string;
+}
 export interface GildashOptions {
     /** Absolute path to the project root directory. */
     projectRoot: string;

package/dist/src/index.d.ts

@@ -17,3 +17,6 @@ export type { WatcherRole } from "./watcher/types";
 export type { ParsedFile } from "./parser/types";
 export type { FileRecord } from "./store/repositories/file.repository";
 export type { ResolvedType, SemanticReference, Implementation, SemanticModuleInterface } from "./semantic/types";
+export type { AnnotationSource, ExtractedAnnotation } from "./extractor/types";
+export type { AnnotationSearchQuery, AnnotationSearchResult } from "./search/annotation-search";
+export type { SymbolChange, SymbolChangeType, SymbolChangeQueryOptions } from "./gildash/types";

package/dist/src/indexer/annotation-indexer.d.ts

@@ -0,0 +1,25 @@
+import type { ParsedFile } from '../parser/types';
+interface AnnotationRepoPart {
+    deleteFileAnnotations(project: string, filePath: string): void;
+    insertBatch(project: string, filePath: string, rows: ReadonlyArray<{
+        project: string;
+        filePath: string;
+        tag: string;
+        value: string;
+        source: string;
+        symbolName: string | null;
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+        indexedAt: string;
+    }>): void;
+}
+export interface IndexFileAnnotationsOptions {
+    parsed: ParsedFile;
+    project: string;
+    filePath: string;
+    annotationRepo: AnnotationRepoPart;
+}
+export declare function indexFileAnnotations(opts: IndexFileAnnotationsOptions): number;
+export {};

package/dist/src/indexer/index-coordinator.d.ts

@@ -24,6 +24,8 @@ export interface IndexResult {
     totalSymbols: number;
     /** Total relation count after indexing. */
     totalRelations: number;
+    /** Total annotation count after indexing. */
+    totalAnnotations: number;
     /** Wall-clock duration of the indexing run in milliseconds. */
     durationMs: number;
     /** Absolute paths of files that changed and were re-indexed. */
@@ -91,6 +93,38 @@ export interface IndexCoordinatorOptions {
         }): void;
         deleteFileRelations(project: string, filePath: string): void;
     };
+    annotationRepo?: {
+        deleteFileAnnotations(project: string, filePath: string): void;
+        insertBatch(project: string, filePath: string, rows: ReadonlyArray<{
+            project: string;
+            filePath: string;
+            tag: string;
+            value: string;
+            source: string;
+            symbolName: string | null;
+            startLine: number;
+            startColumn: number;
+            endLine: number;
+            endColumn: number;
+            indexedAt: string;
+        }>): void;
+    };
+    changelogRepo?: {
+        insertBatch(rows: ReadonlyArray<{
+            project: string;
+            changeType: string;
+            symbolName: string;
+            symbolKind: string;
+            filePath: string;
+            oldName: string | null;
+            oldFilePath: string | null;
+            fingerprint: string | null;
+            changedAt: string;
+            isFullIndex: number;
+            indexRunId: string;
+        }>): void;
+        pruneOlderThan(project: string, before: string): number;
+    };
     parseSourceFn?: typeof parseSource;
     discoverProjectsFn?: typeof discoverProjects;
     logger?: Logger;
@@ -107,6 +141,7 @@ export declare class IndexCoordinator {
     private pendingFullIndexWaiters;
     private tsconfigPathsRaw;
     private boundariesRefresh;
+    private lastPruneAt;
     constructor(opts: IndexCoordinatorOptions);
     get tsconfigPaths(): Promise<TsconfigPaths | null>;
     fullIndex(): Promise<IndexResult>;

package/dist/src/indexer/index.d.ts

@@ -4,5 +4,7 @@ export { indexFileSymbols } from './symbol-indexer';
 export type { IndexFileSymbolsOptions, SymbolDbRow } from './symbol-indexer';
 export { indexFileRelations } from './relation-indexer';
 export type { IndexFileRelationsOptions, RelationDbRow } from './relation-indexer';
+export { indexFileAnnotations } from './annotation-indexer';
+export type { IndexFileAnnotationsOptions } from './annotation-indexer';
 export { IndexCoordinator, WATCHER_DEBOUNCE_MS } from './index-coordinator';
 export type { IndexCoordinatorOptions, IndexResult } from './index-coordinator';

package/dist/src/indexer/rename-detector.d.ts

@@ -0,0 +1,26 @@
+export interface SymbolSnap {
+    name: string;
+    filePath: string;
+    kind: string;
+    fingerprint: string | null;
+    structuralFingerprint: string | null;
+    startLine: number;
+}
+export interface RenamedEntry {
+    oldName: string;
+    newName: string;
+    filePath: string;
+    kind: string;
+}
+export interface SymbolInfo {
+    name: string;
+    filePath: string;
+    kind: string;
+    fingerprint: string | null;
+}
+export interface DetectRenamesResult {
+    renamed: RenamedEntry[];
+    added: SymbolInfo[];
+    removed: SymbolInfo[];
+}
+export declare function detectRenames(beforeSnapshot: Map<string, SymbolSnap>, afterSnapshot: Map<string, SymbolSnap>): DetectRenamesResult;

package/dist/src/indexer/symbol-indexer.d.ts

@@ -1,4 +1,5 @@
 import type { ParsedFile } from '../parser/types';
+import type { ExtractedSymbol } from '../extractor/types';
 export interface SymbolDbRow {
     project: string;
     filePath: string;
@@ -14,6 +15,7 @@ export interface SymbolDbRow {
     detailJson: string | null;
     contentHash: string;
     indexedAt: string;
+    structuralFingerprint: string | null;
 }
 interface SymbolRepoPart {
     replaceFileSymbols(project: string, filePath: string, contentHash: string, symbols: SymbolDbRow[]): void;
@@ -25,5 +27,6 @@ export interface IndexFileSymbolsOptions {
     contentHash: string;
     symbolRepo: SymbolRepoPart;
 }
+export declare function buildStructuralFingerprint(sym: ExtractedSymbol): string;
 export declare function indexFileSymbols(opts: IndexFileSymbolsOptions): void;
 export {};

package/dist/src/search/annotation-search.d.ts

@@ -0,0 +1,44 @@
+import type { AnnotationSource } from '../extractor/types';
+import type { AnnotationRecord } from '../store/repositories/annotation.repository';
+export interface AnnotationSearchQuery {
+    text?: string;
+    tag?: string;
+    filePath?: string;
+    symbolName?: string;
+    source?: AnnotationSource;
+    project?: string;
+    limit?: number;
+}
+export interface AnnotationSearchResult {
+    tag: string;
+    value: string;
+    source: AnnotationSource;
+    filePath: string;
+    symbolName: string | null;
+    span: {
+        start: {
+            line: number;
+            column: number;
+        };
+        end: {
+            line: number;
+            column: number;
+        };
+    };
+}
+export interface IAnnotationRepo {
+    search(opts: {
+        project?: string;
+        tag?: string;
+        filePath?: string;
+        symbolName?: string;
+        source?: string;
+        ftsQuery?: string;
+        limit: number;
+    }): AnnotationRecord[];
+}
+export declare function annotationSearch(options: {
+    annotationRepo: IAnnotationRepo;
+    project?: string;
+    query: AnnotationSearchQuery;
+}): AnnotationSearchResult[];

package/dist/src/search/index.d.ts

@@ -6,3 +6,5 @@ export { DependencyGraph } from './dependency-graph';
 export type { IDependencyGraphRepo } from './dependency-graph';
 export { patternSearch } from './pattern-search';
 export type { PatternMatch, PatternSearchOptions } from './pattern-search';
+export { annotationSearch } from './annotation-search';
+export type { AnnotationSearchQuery, AnnotationSearchResult, IAnnotationRepo } from './annotation-search';

package/dist/src/store/index.d.ts

@@ -6,4 +6,8 @@ export { SymbolRepository } from './repositories/symbol.repository';
 export type { SymbolRecord, SearchOptions, SymbolStats } from './repositories/symbol.repository';
 export { RelationRepository } from './repositories/relation.repository';
 export type { RelationRecord } from './repositories/relation.repository';
+export { AnnotationRepository } from './repositories/annotation.repository';
+export type { AnnotationRecord } from './repositories/annotation.repository';
+export { ChangelogRepository } from './repositories/changelog.repository';
+export type { ChangelogRecord } from './repositories/changelog.repository';
 export * as schema from './schema';

package/dist/src/store/repositories/annotation.repository.d.ts

@@ -0,0 +1,30 @@
+import type { DbConnection } from '../connection';
+export interface AnnotationRecord {
+    id: number;
+    project: string;
+    filePath: string;
+    tag: string;
+    value: string;
+    source: string;
+    symbolName: string | null;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+    indexedAt: string;
+}
+export declare class AnnotationRepository {
+    private readonly db;
+    constructor(db: DbConnection);
+    insertBatch(project: string, filePath: string, rows: ReadonlyArray<Omit<AnnotationRecord, 'id'>>): void;
+    deleteFileAnnotations(project: string, filePath: string): void;
+    search(opts: {
+        project?: string;
+        tag?: string;
+        filePath?: string;
+        symbolName?: string;
+        source?: string;
+        ftsQuery?: string;
+        limit: number;
+    }): AnnotationRecord[];
+}

package/dist/src/store/repositories/changelog.repository.d.ts

@@ -0,0 +1,32 @@
+import type { DbConnection } from '../connection';
+export interface ChangelogRecord {
+    id: number;
+    project: string;
+    changeType: string;
+    symbolName: string;
+    symbolKind: string;
+    filePath: string;
+    oldName: string | null;
+    oldFilePath: string | null;
+    fingerprint: string | null;
+    changedAt: string;
+    isFullIndex: number;
+    indexRunId: string;
+}
+export declare class ChangelogRepository {
+    private readonly db;
+    constructor(db: DbConnection);
+    insertBatch(rows: ReadonlyArray<Omit<ChangelogRecord, 'id'>>): void;
+    getSince(opts: {
+        project: string;
+        since: string;
+        symbolName?: string;
+        changeTypes?: string[];
+        filePath?: string;
+        includeFullIndex?: boolean;
+        indexRunId?: string;
+        afterId?: number;
+        limit: number;
+    }): ChangelogRecord[];
+    pruneOlderThan(project: string, before: string): number;
+}

package/dist/src/store/repositories/symbol.repository.d.ts

@@ -15,6 +15,7 @@ export interface SymbolRecord {
     contentHash: string;
     indexedAt: string;
     resolvedType?: string | null;
+    structuralFingerprint?: string | null;
 }
 export interface SearchOptions {
     kind?: string;