kirograph 0.17.0 → 0.20.0

package/dist/docs/indexer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Documentation Indexer
+ *
+ * Orchestrates: scan doc files → parse sections → persist to DB.
+ * Supports incremental re-indexing via content hashes.
+ */
+import type { KiroGraphConfig } from '../config';
+import type { DocIndexResult } from './types';
+export declare class DocsIndexer {
+    private readonly db;
+    private readonly config;
+    private readonly projectRoot;
+    constructor(db: any, config: KiroGraphConfig, projectRoot: string);
+    /**
+     * Index all documentation files in the project.
+     * Skips files whose content hash hasn't changed (incremental).
+     */
+    indexAll(opts?: {
+        force?: boolean;
+        onProgress?: (msg: string) => void;
+    }): Promise<DocIndexResult>;
+    /**
+     * Index a single file. Returns null if unchanged (hash match).
+     */
+    indexFile(relPath: string, force?: boolean): Promise<{
+        created: number;
+        updated: number;
+        removed: number;
+        codeRefs: number;
+    } | null>;
+    /**
+     * Scan the project for documentation files matching include/exclude patterns.
+     */
+    private scanDocFiles;
+    /**
+     * Flatten a parsed section tree into a flat array of DocSection objects.
+     */
+    private flattenSections;
+    /**
+     * Extract the first meaningful sentence from section content.
+     * Skips the heading line itself.
+     */
+    private extractFirstSentence;
+    /**
+     * Remove sections for files that no longer exist on disk.
+     */
+    private removeDeletedFiles;
+}
+//# sourceMappingURL=indexer.d.ts.map

package/dist/docs/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/docs/indexer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAA6B,cAAc,EAAE,MAAM,SAAS,CAAC;AAQzE,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM;IAMjE;;;OAGG;IACG,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAyDvG;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAiIxI;;OAEG;IACH,OAAO,CAAC,YAAY;IAgCpB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+CvB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB3B"}

package/dist/docs/linker.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Code ↔ Documentation Linker
+ *
+ * Detects references to code symbols within documentation sections.
+ * Strategies:
+ *   1. Backtick references: `functionName`, `ClassName.method`
+ *   2. Import-style paths: from './auth/service'
+ *   3. Identifier patterns: CamelCase, snake_case words that match indexed symbols
+ */
+import type { DocCodeRef } from './types';
+/**
+ * Extract candidate symbol references from documentation content.
+ * Returns unique candidate names that should be looked up against the graph.
+ */
+export declare function extractCandidateRefs(content: string): string[];
+/**
+ * Resolve candidate references against the code graph.
+ * Returns DocCodeRef entries for symbols that actually exist in the index.
+ *
+ * @param sectionId - The doc section ID
+ * @param candidates - Candidate symbol names extracted from the section
+ * @param db - Raw SQLite database handle
+ */
+export declare function resolveCodeRefs(sectionId: string, candidates: string[], db: any): DocCodeRef[];
+/**
+ * Run the full linking pipeline for a section.
+ * Extracts candidates from content, resolves against the graph, returns refs.
+ */
+export declare function linkSection(sectionId: string, content: string, db: any): DocCodeRef[];
+//# sourceMappingURL=linker.d.ts.map

package/dist/docs/linker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linker.d.ts","sourceRoot":"","sources":["../../src/docs/linker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,SAAS,CAAC;AA0BtD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAqC9D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAAE,EACpB,EAAE,EAAE,GAAG,GACN,UAAU,EAAE,CAoCd;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,GAAG,GACN,UAAU,EAAE,CAGd"}

package/dist/docs/lint.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Documentation Lint
+ *
+ * Health checks for the docs index:
+ * 1. Broken code refs — qualified_names that no longer resolve to any node
+ * 2. Stale sections — sections whose content_hash doesn't match the file on disk
+ * 3. FTS desync — doc_sections_fts row count doesn't match doc_sections
+ * 4. Orphan refs — doc_code_refs pointing to non-existent sections
+ */
+export interface LintResult {
+    brokenRefs: Array<{
+        sectionId: string;
+        qualifiedName: string;
+    }>;
+    staleSections: Array<{
+        id: string;
+        filePath: string;
+    }>;
+    ftsDesync: {
+        sections: number;
+        ftsRows: number;
+    } | null;
+    orphanRefs: number;
+    totalIssues: number;
+}
+export declare function docsLint(db: any, projectRoot: string): LintResult;
+//# sourceMappingURL=lint.d.ts.map

package/dist/docs/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/docs/lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CA8DjE"}

package/dist/docs/queries.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Documentation Queries
+ *
+ * Read-side helpers for MCP tools and CLI commands.
+ * All methods operate on the doc_sections and doc_code_refs tables.
+ */
+import type { DocSection, DocTocEntry, DocSearchResult } from './types';
+import type { KiroGraphConfig } from '../config';
+export declare class DocsQueries {
+    private readonly db;
+    private readonly projectRoot;
+    private readonly config;
+    constructor(db: any, projectRoot: string, config?: KiroGraphConfig);
+    /**
+     * Get table of contents for a file or the whole project.
+     */
+    getToc(opts?: {
+        file?: string;
+        tree?: boolean;
+    }): DocTocEntry[];
+    /**
+     * Get heading hierarchy for a single document.
+     */
+    getOutline(file: string): DocTocEntry[];
+    /**
+     * Get a section by ID, optionally with context (ancestor chain + child summaries).
+     */
+    getSection(id: string, opts?: {
+        context?: boolean;
+    }): {
+        section: DocSection;
+        content: string;
+        ancestors?: Array<{
+            id: string;
+            title: string;
+            level: number;
+        }>;
+        children?: Array<{
+            id: string;
+            title: string;
+            summary: string | null;
+        }>;
+    } | null;
+    /**
+     * Search sections by query using FTS5 + optional vector search (hybrid).
+     */
+    searchSections(query: string, opts?: {
+        file?: string;
+        limit?: number;
+    }): Promise<DocSearchResult[]>;
+    /**
+     * FTS-only search (used internally and as fallback).
+     */
+    private searchFTS;
+    /**
+     * Get code symbols referenced by a section, or doc sections that reference a symbol.
+     */
+    getRefs(opts: {
+        sectionId?: string;
+        qualifiedName?: string;
+    }): Array<{
+        sectionId: string;
+        qualifiedName: string;
+        refType: string;
+        confidence: number;
+        sectionTitle?: string;
+    }>;
+    getStats(): {
+        files: number;
+        sections: number;
+        codeRefs: number;
+    };
+    private rowToSection;
+    private readSectionContent;
+    private buildTocTree;
+    private searchFallback;
+}
+//# sourceMappingURL=queries.d.ts.map

package/dist/docs/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/docs/queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAEpC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe;IAQlE;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,WAAW,EAAE;IA6B/D;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;IAMvC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG;QACpD,OAAO,EAAE,UAAU,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChE,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC,CAAC;KACzE,GAAG,IAAI;IAgCR;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAqDzG;;OAEG;IACH,OAAO,CAAC,SAAS;IAkDjB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;QACnE,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IAsCF,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IASjE,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,cAAc;CAoBvB"}

package/dist/docs/section-id.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Stable Section ID Generation
+ *
+ * Format: {file_path}::{ancestor-chain/slug}#{level}
+ *
+ * IDs remain stable across re-indexing when:
+ * - file path doesn't change
+ * - heading text doesn't change
+ * - heading level doesn't change
+ * - parent heading chain doesn't change
+ */
+/**
+ * Convert a heading title to a URL-safe slug.
+ * Matches common Markdown anchor generation (GitHub-style).
+ */
+export declare function slugify(title: string): string;
+/**
+ * Build the ancestor chain string from parent slugs.
+ * Example: ['installation', 'prerequisites'] → 'installation/prerequisites'
+ */
+export declare function buildAncestorChain(parentSlugs: string[], currentSlug: string): string;
+/**
+ * Generate a stable section ID.
+ *
+ * @param filePath - Relative path to the doc file
+ * @param ancestorSlugs - Slugified titles of all ancestor headings (root → parent)
+ * @param title - The heading title of this section
+ * @param level - The heading level (1–6)
+ * @returns Stable section ID string
+ *
+ * @example
+ * generateSectionId('docs/install.md', [], 'Installation', 1)
+ * // → 'docs/install.md::installation#1'
+ *
+ * generateSectionId('docs/install.md', ['installation'], 'Prerequisites', 2)
+ * // → 'docs/install.md::installation/prerequisites#2'
+ */
+export declare function generateSectionId(filePath: string, ancestorSlugs: string[], title: string, level: number): string;
+/**
+ * Parse a section ID back into its components.
+ * Returns null if the ID is malformed.
+ */
+export declare function parseSectionId(id: string): {
+    filePath: string;
+    ancestorChain: string;
+    level: number;
+} | null;
+//# sourceMappingURL=section-id.d.ts.map

package/dist/docs/section-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-id.d.ts","sourceRoot":"","sources":["../../src/docs/section-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAc7C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAErF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAgBP"}

package/dist/docs/summarizer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Documentation Section Summarizer
+ *
+ * Strategies:
+ * - 'first-sentence': Extract the first meaningful sentence from section content
+ * - 'embedding': Use the embedding model to score sentences by relevance to heading (future)
+ * - 'off': No summary, return null
+ */
+/**
+ * Extract a summary from section content based on the configured strategy.
+ */
+export declare function summarizeSection(content: string, title: string, strategy: 'embedding' | 'first-sentence' | 'off'): string | null;
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/docs/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../src/docs/summarizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,GAAG,gBAAgB,GAAG,KAAK,GAC/C,MAAM,GAAG,IAAI,CAMf"}

package/dist/docs/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * KiroGraph Documentation Module — Type Definitions
+ *
+ * These types model the documentation layer: sections extracted from
+ * doc files, cross-references to code symbols, and search results.
+ * All populated only when enableDocs=true in config.
+ */
+export interface DocSection {
+    id: string;
+    filePath: string;
+    title: string;
+    level: number;
+    parentId: string | null;
+    summary: string | null;
+    byteStart: number;
+    byteEnd: number;
+    contentHash: string;
+    tags: string[];
+    position: number;
+    updatedAt: number;
+}
+export type DocRefType = 'mentions' | 'documents' | 'example' | 'configures';
+export interface DocCodeRef {
+    sectionId: string;
+    qualifiedName: string;
+    refType: DocRefType;
+    confidence: number;
+}
+export interface ParsedSection {
+    title: string;
+    level: number;
+    byteStart: number;
+    byteEnd: number;
+    content: string;
+    children: ParsedSection[];
+}
+export interface ParseResult {
+    sections: ParsedSection[];
+    format: string;
+}
+export interface DocFormatParser {
+    /** Unique name for this parser (e.g. 'markdown', 'rst') */
+    name: string;
+    /** File extensions this parser handles (e.g. ['.md', '.mdx']) */
+    extensions: string[];
+    /** Parse a file's content into a section hierarchy */
+    parse(content: string, filePath: string): ParseResult;
+}
+export interface DocSearchResult {
+    section: DocSection;
+    score: number;
+    matchType: 'fts' | 'semantic' | 'exact';
+}
+export interface DocIndexResult {
+    filesIndexed: number;
+    sectionsCreated: number;
+    sectionsUpdated: number;
+    sectionsRemoved: number;
+    codeRefsCreated: number;
+    errors: string[];
+    duration: number;
+}
+export interface DocTocEntry {
+    id: string;
+    title: string;
+    level: number;
+    filePath: string;
+    summary: string | null;
+    children?: DocTocEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/docs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docs/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;CACvD;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC;CACzC;AAID,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B"}

package/dist/docs/vectors.d.ts

@@ -0,0 +1,54 @@
+/**
+ * KiroGraph Docs — Vector embedding and search
+ *
+ * Reuses the same embedding model and pipeline as the memory module,
+ * but operates on doc_vectors table independently.
+ */
+import type { KiroGraphConfig } from '../config';
+import type { DocSection } from './types';
+export declare class DocsVectorManager {
+    private config;
+    private db;
+    private modelName;
+    private cacheDir;
+    constructor(config: KiroGraphConfig, db: any);
+    /**
+     * Check if embeddings are enabled in config.
+     */
+    isEnabled(): boolean;
+    /**
+     * Embed a single doc section and store in doc_vectors.
+     */
+    embedSection(section: DocSection): Promise<void>;
+    /**
+     * Embed multiple sections in batch.
+     */
+    embedBatch(sections: DocSection[]): Promise<number>;
+    /**
+     * Vector search over doc sections.
+     * Returns scored sections sorted by cosine similarity.
+     * Falls back to empty results if embeddings are disabled.
+     */
+    search(query: string, limit?: number): Promise<Array<{
+        sectionId: string;
+        score: number;
+    }>>;
+    /**
+     * Check if there are vectors with a mismatched model.
+     */
+    hasModelMismatch(): boolean;
+    /**
+     * Get vector stats.
+     */
+    getStats(): {
+        total: number;
+        currentModel: number;
+        mismatch: number;
+    };
+    /**
+     * Re-embed all doc sections with the current model.
+     */
+    reembed(batchSize?: number): Promise<number>;
+    private embed;
+}
+//# sourceMappingURL=vectors.d.ts.map

package/dist/docs/vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.d.ts","sourceRoot":"","sources":["../../src/docs/vectors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAuD3D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,GAAG;IAU5C;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtD;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAezD;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAoC7F;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAQ3B;;OAEG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IASrE;;OAEG;IACG,OAAO,CAAC,SAAS,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;YAgChC,KAAK;CAUpB"}

package/dist/extraction/extractor.d.ts

@@ -7,7 +7,7 @@ import type { Node, Edge, Language } from '../types';
 export interface UnresolvedRef {
     sourceId: string;
     refName: string;
-    refKind: 'function' | 'import';
+    refKind: 'function' | 'import' | 'extends' | 'implements';
     line: number;
     column: number;
 }

package/dist/extraction/extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/extraction/extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAY,QAAQ,EAAE,MAAM,UAAU,CAAC;AAI/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7F;AAeD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA+CjI"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/extraction/extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAY,QAAQ,EAAE,MAAM,UAAU,CAAC;AAK/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7F;AAeD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAwDjI"}

package/dist/extraction/extractor.js

@@ -37,6 +37,7 @@ var fs = __toESM(require("fs"));
 var crypto = __toESM(require("crypto"));
 var import_languages = require("./languages");
 var import_grammars = require("./grammars");
+var import_notebook = require("./notebook");
 function makeNodeId(filePath, kind, name, line) {
   const hash = crypto.createHash("sha256").update(`${filePath}:${kind}:${name}:${line}`).digest("hex").slice(0, 32);
   return `${kind}:${hash}`;
@@ -65,6 +66,9 @@ async function extractFile(filePath, projectRoot, content) {
   } catch {
     return null;
   }
+  if (language === "jupyter") {
+    return (0, import_notebook.extractNotebook)(filePath, projectRoot, source);
+  }
   const contentHash = crypto.createHash("sha256").update(source).digest("hex");
   const fileSize = Buffer.byteLength(source, "utf8");
   const relPath = path.relative(projectRoot, filePath).replace(/\\/g, "/");
@@ -275,6 +279,33 @@ function extractVariableKind(node) {
   }
   return "variable";
 }
+const DART_WIDGET_SUPERCLASSES = /* @__PURE__ */ new Set([
+  "StatelessWidget",
+  "StatefulWidget",
+  "HookWidget",
+  "ConsumerWidget",
+  "ConsumerStatefulWidget"
+]);
+function refineDartClassKind(node, source) {
+  for (let i = 0; i < node.childCount; i++) {
+    const child = node.child(i);
+    if (child.type === "superclass") {
+      const superText = source.slice(child.startIndex, child.endIndex);
+      if (DART_WIDGET_SUPERCLASSES.has(superText.replace(/^extends\s+/, "").trim())) {
+        return "component";
+      }
+      for (let j = 0; j < child.childCount; j++) {
+        const typeNode = child.child(j);
+        if (typeNode.type === "type_identifier" || typeNode.type === "identifier") {
+          const name = source.slice(typeNode.startIndex, typeNode.endIndex).trim();
+          if (DART_WIDGET_SUPERCLASSES.has(name)) return "component";
+          if (name.endsWith("Widget") && name !== "State") return "component";
+        }
+      }
+    }
+  }
+  return "class";
+}
 const IMPORT_NODE_TYPES = /* @__PURE__ */ new Set([
   "import_statement",
   // TS/JS
@@ -318,6 +349,9 @@ function walkTree(node, source, filePath, language, nodes, edges, unresolvedRefs
     kind = extractVariableKind(node);
   }
   if (!kind) kind = getLanguageSpecificKind(node.type, language);
+  if (language === "dart" && node.type === "class_definition" && kind === "class") {
+    kind = refineDartClassKind(node, source);
+  }
   if (kind) {
     const name = extractName(node, source, language, kind);
     if (name) {
@@ -457,6 +491,53 @@ function getLanguageSpecificKind(type, lang) {
       if (type === "rule_set") return "class";
       if (type === "declaration") return "variable";
       break;
+    case "rescript":
+      if (type === "let_binding") return "function";
+      if (type === "type_definition") return "type_alias";
+      if (type === "module_declaration") return "module";
+      break;
+    case "sql":
+      if (type === "create_function_statement") return "function";
+      if (type === "create_table_statement") return "class";
+      if (type === "create_view_statement") return "function";
+      if (type === "create_procedure_statement") return "function";
+      break;
+    case "r":
+      if (type === "function_definition") return "function";
+      if (type === "left_assignment") return "variable";
+      break;
+    case "julia":
+      if (type === "function_definition") return "function";
+      if (type === "struct_definition") return "struct";
+      if (type === "module_definition") return "module";
+      if (type === "macro_definition") return "function";
+      break;
+    case "powershell":
+      if (type === "function_statement") return "function";
+      if (type === "class_statement") return "class";
+      break;
+    case "perl":
+      if (type === "subroutine_declaration_statement") return "function";
+      if (type === "package_statement") return "module";
+      break;
+    case "gdscript":
+      if (type === "function_definition") return "function";
+      if (type === "class_definition") return "class";
+      if (type === "variable_statement") return "variable";
+      break;
+    case "astro":
+      if (type === "function_declaration") return "function";
+      if (type === "function_definition") return "function";
+      break;
+    case "nix":
+      if (type === "function") return "function";
+      if (type === "binding") return "variable";
+      break;
+    case "verilog":
+      if (type === "module_declaration") return "class";
+      if (type === "task_declaration") return "function";
+      if (type === "function_declaration") return "function";
+      break;
   }
   return null;
 }