@know-graph/core 0.4.0

package/dist/parsers/typescript-parser.js.map

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

package/dist/query/index.d.ts

@@ -0,0 +1,3 @@
+export { createQueryEngine } from './query-engine.js';
+export type { QueryEngine, QueryOptions, QueryResult } from './query-engine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/query/index.js

@@ -0,0 +1,2 @@
+export { createQueryEngine } from './query-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/query/query-engine.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Query engine with FTS5 full-text search, filtering, pagination, and dependency traversal
+ * owner: knowgraph-core
+ * status: stable
+ * tags: [query, search, fts5, filtering]
+ * context:
+ *   business_goal: Enable fast, flexible search across the code knowledge graph
+ *   domain: query-engine
+ */
+import type { DatabaseManager } from '../indexer/database.js';
+import type { EntityType, Status } from '../types/index.js';
+import type { IndexStats, StoredEntity } from '../indexer/types.js';
+export interface QueryOptions {
+    readonly query?: string;
+    readonly type?: EntityType;
+    readonly owner?: string;
+    readonly status?: Status;
+    readonly tags?: readonly string[];
+    readonly filePath?: string;
+    readonly limit?: number;
+    readonly offset?: number;
+}
+export interface QueryResult {
+    readonly entities: readonly StoredEntity[];
+    readonly total: number;
+    readonly query: QueryOptions;
+}
+export interface QueryEngine {
+    search(options: QueryOptions): QueryResult;
+    getEntity(id: string): StoredEntity | undefined;
+    getDependencies(entityId: string): readonly StoredEntity[];
+    getDependents(entityId: string): readonly StoredEntity[];
+    getByOwner(owner: string): readonly StoredEntity[];
+    getByTag(tag: string): readonly StoredEntity[];
+    getStats(): IndexStats;
+}
+export declare function createQueryEngine(dbManager: DatabaseManager): QueryEngine;
+//# sourceMappingURL=query-engine.d.ts.map

package/dist/query/query-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-engine.d.ts","sourceRoot":"","sources":["../../src/query/query-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAQ,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAAC;IAC3C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAChD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;IAC3D,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;IACzD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;IAC/C,QAAQ,IAAI,UAAU,CAAC;CACxB;AAqFD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,WAAW,CAgIzE"}

package/dist/query/query-engine.js

@@ -0,0 +1,126 @@
+function rowToStoredEntity(row, tags, links) {
+    return {
+        id: row.id,
+        filePath: row.file_path,
+        name: row.name,
+        entityType: row.entity_type,
+        description: row.description,
+        rawDocstring: row.raw_docstring,
+        signature: row.signature,
+        parent: row.parent,
+        language: row.language,
+        line: row.line,
+        column: row.column_num,
+        owner: row.owner,
+        status: row.status,
+        metadata: JSON.parse(row.metadata_json),
+        tags,
+        links,
+        fileHash: row.file_hash,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function hydrateEntity(db, row) {
+    const tags = db
+        .prepare('SELECT tag FROM tags WHERE entity_id = ?')
+        .all(row.id).map((r) => r.tag);
+    const links = db
+        .prepare('SELECT link_type, url, title FROM links WHERE entity_id = ?')
+        .all(row.id).map((r) => ({
+        type: r.link_type,
+        url: r.url,
+        title: r.title ?? undefined,
+    }));
+    return rowToStoredEntity(row, tags, links);
+}
+export function createQueryEngine(dbManager) {
+    const { db } = dbManager;
+    function search(options) {
+        const { query, type, owner, status, tags, filePath, limit = 50, offset = 0, } = options;
+        const conditions = [];
+        const params = {};
+        if (query) {
+            conditions.push(`e.id IN (SELECT entity_id FROM entities_fts WHERE entities_fts MATCH @query)`);
+            params.query = query;
+        }
+        if (type) {
+            conditions.push('e.entity_type = @type');
+            params.type = type;
+        }
+        if (owner) {
+            conditions.push('e.owner = @owner');
+            params.owner = owner;
+        }
+        if (status) {
+            conditions.push('e.status = @status');
+            params.status = status;
+        }
+        if (filePath) {
+            conditions.push('e.file_path = @filePath');
+            params.filePath = filePath;
+        }
+        if (tags && tags.length > 0) {
+            const tagPlaceholders = tags.map((_, i) => `@tag${i}`);
+            conditions.push(`e.id IN (SELECT entity_id FROM tags WHERE tag IN (${tagPlaceholders.join(', ')}))`);
+            for (let i = 0; i < tags.length; i++) {
+                params[`tag${i}`] = tags[i];
+            }
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const countSql = `SELECT COUNT(*) as count FROM entities e ${whereClause}`;
+        const total = db.prepare(countSql).get(params).count;
+        const dataSql = `SELECT e.* FROM entities e ${whereClause} ORDER BY e.name ASC LIMIT @limit OFFSET @offset`;
+        params.limit = limit;
+        params.offset = offset;
+        const rows = db.prepare(dataSql).all(params);
+        const entities = rows.map((row) => hydrateEntity(db, row));
+        return { entities, total, query: options };
+    }
+    function getEntity(id) {
+        return dbManager.getEntityById(id);
+    }
+    function getDependencies(entityId) {
+        const rows = db
+            .prepare(`SELECT e.* FROM entities e
+       JOIN relationships r ON e.id = r.target_id
+       WHERE r.source_id = ?`)
+            .all(entityId);
+        return rows.map((row) => hydrateEntity(db, row));
+    }
+    function getDependents(entityId) {
+        const rows = db
+            .prepare(`SELECT e.* FROM entities e
+       JOIN relationships r ON e.id = r.source_id
+       WHERE r.target_id = ?`)
+            .all(entityId);
+        return rows.map((row) => hydrateEntity(db, row));
+    }
+    function getByOwner(owner) {
+        const rows = db
+            .prepare('SELECT * FROM entities WHERE owner = ?')
+            .all(owner);
+        return rows.map((row) => hydrateEntity(db, row));
+    }
+    function getByTag(tag) {
+        const rows = db
+            .prepare(`SELECT e.* FROM entities e
+       JOIN tags t ON e.id = t.entity_id
+       WHERE t.tag = ?`)
+            .all(tag);
+        return rows.map((row) => hydrateEntity(db, row));
+    }
+    function getStats() {
+        return dbManager.getStats();
+    }
+    return {
+        search,
+        getEntity,
+        getDependencies,
+        getDependents,
+        getByOwner,
+        getByTag,
+        getStats,
+    };
+}
+//# sourceMappingURL=query-engine.js.map

package/dist/query/query-engine.js.map

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

package/dist/suggest/index.d.ts

@@ -0,0 +1,3 @@
+export type { SuggestionReason, FileSuggestion, SuggestionOptions, SuggestionResult, } from './types.js';
+export { createSuggestionEngine } from './suggestion-engine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/suggest/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/suggest/index.js

@@ -0,0 +1,2 @@
+export { createSuggestionEngine } from './suggestion-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/suggest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/suggest/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/suggest/suggestion-engine.d.ts

@@ -0,0 +1,7 @@
+import type { ParserRegistry } from '../parsers/types.js';
+import type { SuggestionOptions, SuggestionResult } from './types.js';
+export interface SuggestionEngine {
+    readonly suggest: (options: SuggestionOptions) => SuggestionResult;
+}
+export declare function createSuggestionEngine(_registry: ParserRegistry): SuggestionEngine;
+//# sourceMappingURL=suggestion-engine.d.ts.map

package/dist/suggest/suggestion-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion-engine.d.ts","sourceRoot":"","sources":["../../src/suggest/suggestion-engine.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAEV,iBAAiB,EAEjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAmPpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;CACpE;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,cAAc,GACxB,gBAAgB,CAyBlB"}

package/dist/suggest/suggestion-engine.js

@@ -0,0 +1,239 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Suggestion engine that scores and ranks unannotated files by annotation priority
+ * owner: knowgraph-core
+ * status: experimental
+ * tags: [suggest, engine, scoring, heuristics]
+ * context:
+ *   business_goal: Help developers find the most impactful files to annotate next
+ *   domain: suggest-engine
+ */
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, extname, basename, relative } from 'node:path';
+const KNOWGRAPH_MARKER = '@knowgraph';
+const ENTRY_POINT_NAMES = new Set([
+    'index.ts',
+    'index.js',
+    'index.tsx',
+    'index.jsx',
+    'main.ts',
+    'main.js',
+    'app.ts',
+    'app.js',
+    'main.py',
+    'app.py',
+    '__init__.py',
+    'server.ts',
+    'server.js',
+]);
+const PARSABLE_EXTENSIONS = new Set([
+    '.py',
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+]);
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '__pycache__',
+    '.venv',
+    'venv',
+    'coverage',
+    '.next',
+    '.knowgraph',
+]);
+const CONFIG_PATTERNS = new Set([
+    'eslint.config.js',
+    'eslint.config.ts',
+    'vitest.config.ts',
+    'vitest.config.js',
+    'jest.config.ts',
+    'jest.config.js',
+    'tsconfig.json',
+    'babel.config.js',
+    'webpack.config.js',
+    'rollup.config.js',
+    'vite.config.ts',
+    'vite.config.js',
+    'prettier.config.js',
+    'postcss.config.js',
+    'tailwind.config.js',
+    'tailwind.config.ts',
+]);
+const PRIMARY_LANGUAGE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.py',
+]);
+function isTestFile(fileName) {
+    return (fileName.includes('.test.') ||
+        fileName.includes('.spec.') ||
+        fileName.includes('__test__') ||
+        fileName.startsWith('test_'));
+}
+function isConfigFile(fileName) {
+    return CONFIG_PATTERNS.has(fileName) || fileName.startsWith('.');
+}
+function isFixtureFile(filePath) {
+    return (filePath.includes('/fixtures/') ||
+        filePath.includes('/__fixtures__/') ||
+        filePath.includes('/fixture/'));
+}
+function hasKnowgraphAnnotation(content) {
+    return content.includes(KNOWGRAPH_MARKER);
+}
+function countImports(content) {
+    const importRegex = /^(?:import\s|from\s|const\s+\w+\s*=\s*require\()/gm;
+    const matches = content.match(importRegex);
+    return matches?.length ?? 0;
+}
+function countLines(content) {
+    if (content.length === 0)
+        return 0;
+    return content.split('\n').length;
+}
+function extensionToLanguage(ext) {
+    switch (ext) {
+        case '.py':
+            return 'python';
+        case '.ts':
+        case '.tsx':
+            return 'typescript';
+        case '.js':
+        case '.jsx':
+            return 'javascript';
+        default:
+            return 'unknown';
+    }
+}
+function isInSrcDirectory(filePath) {
+    return filePath.includes('/src/') || filePath.startsWith('src/');
+}
+function collectFiles(rootDir) {
+    const results = [];
+    function walk(dir) {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.startsWith('.') || SKIP_DIRS.has(entry))
+                continue;
+            const fullPath = join(dir, entry);
+            try {
+                const stat = statSync(fullPath);
+                if (stat.isDirectory()) {
+                    walk(fullPath);
+                }
+                else if (stat.isFile()) {
+                    const ext = extname(entry);
+                    if (PARSABLE_EXTENSIONS.has(ext)) {
+                        results.push(fullPath);
+                    }
+                }
+            }
+            catch {
+                // Skip inaccessible files
+            }
+        }
+    }
+    walk(rootDir);
+    return results;
+}
+function analyzeFile(filePath, rootDir) {
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const fileName = basename(filePath);
+        const relativePath = relative(rootDir, filePath);
+        return {
+            filePath,
+            relativePath,
+            fileName,
+            content,
+            lineCount: countLines(content),
+            importCount: countImports(content),
+            extension: extname(fileName),
+            isAnnotated: hasKnowgraphAnnotation(content),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function scoreFile(analysis) {
+    let score = 0;
+    const reasons = [];
+    if (ENTRY_POINT_NAMES.has(analysis.fileName)) {
+        score += 100;
+        reasons.push('entry-point');
+    }
+    if (analysis.lineCount > 200) {
+        score += 100;
+        reasons.push('large-file');
+    }
+    else if (analysis.lineCount > 100) {
+        score += 50;
+        reasons.push('large-file');
+    }
+    if (isInSrcDirectory(analysis.relativePath)) {
+        score += 20;
+        reasons.push('exported-module');
+    }
+    if (analysis.importCount > 10) {
+        score += 60;
+        reasons.push('many-imports');
+    }
+    else if (analysis.importCount > 5) {
+        score += 30;
+        reasons.push('many-imports');
+    }
+    if (PRIMARY_LANGUAGE_EXTENSIONS.has(analysis.extension)) {
+        score += 10;
+    }
+    if (reasons.length === 0) {
+        reasons.push('uncovered');
+    }
+    return {
+        filePath: analysis.relativePath,
+        score,
+        reasons,
+        language: extensionToLanguage(analysis.extension),
+        lineCount: analysis.lineCount,
+    };
+}
+function shouldExclude(analysis) {
+    return (isTestFile(analysis.fileName) ||
+        isConfigFile(analysis.fileName) ||
+        isFixtureFile(analysis.relativePath) ||
+        analysis.isAnnotated);
+}
+export function createSuggestionEngine(_registry) {
+    return {
+        suggest(options) {
+            const { rootDir, limit = 10 } = options;
+            const allFiles = collectFiles(rootDir);
+            const analyses = allFiles
+                .map((f) => analyzeFile(f, rootDir))
+                .filter((a) => a !== null);
+            const totalFiles = analyses.length;
+            const unannotated = analyses.filter((a) => !shouldExclude(a));
+            const totalUnannotated = unannotated.length;
+            const scored = unannotated.map(scoreFile);
+            const sorted = [...scored].sort((a, b) => b.score - a.score);
+            const suggestions = sorted.slice(0, limit);
+            return {
+                suggestions,
+                totalUnannotated,
+                totalFiles,
+            };
+        },
+    };
+}
+//# sourceMappingURL=suggestion-engine.js.map

package/dist/suggest/suggestion-engine.js.map

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

package/dist/suggest/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @knowgraph
+ * type: interface
+ * description: Types for the file suggestion engine that ranks unannotated files by annotation priority
+ * owner: knowgraph-core
+ * status: experimental
+ * tags: [suggest, types, interface]
+ * context:
+ *   business_goal: Define contracts for the suggestion engine output
+ *   domain: suggest-engine
+ */
+export type SuggestionReason = 'entry-point' | 'large-file' | 'many-imports' | 'exported-module' | 'uncovered';
+export interface FileSuggestion {
+    readonly filePath: string;
+    readonly score: number;
+    readonly reasons: readonly SuggestionReason[];
+    readonly language: string;
+    readonly lineCount: number;
+}
+export interface SuggestionOptions {
+    readonly limit?: number;
+    readonly rootDir: string;
+}
+export interface SuggestionResult {
+    readonly suggestions: readonly FileSuggestion[];
+    readonly totalUnannotated: number;
+    readonly totalFiles: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/suggest/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,YAAY,GACZ,cAAc,GACd,iBAAiB,GACjB,WAAW,CAAC;AAEhB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/dist/suggest/types.js

@@ -0,0 +1,13 @@
+/**
+ * @knowgraph
+ * type: interface
+ * description: Types for the file suggestion engine that ranks unannotated files by annotation priority
+ * owner: knowgraph-core
+ * status: experimental
+ * tags: [suggest, types, interface]
+ * context:
+ *   business_goal: Define contracts for the suggestion engine output
+ *   domain: suggest-engine
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/suggest/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/suggest/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}