@rasensio/aidlc 0.7.0 → 1.1.0

package/dist/knowledge/engine.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Knowledge engine facade — opens the YAML store and SQLite index together
+ * and wires up the standard recovery paths:
+ *
+ * - Missing/empty index with YAML present → auto-rebuild from sources.
+ * - Outdated index schema → delete and rebuild (the index is a disposable
+ *   cache; YAML is the source of truth — design DD2).
+ *
+ * Requirements: KG 3.2, 3.3, 11.4
+ *
+ * @module
+ */
+import { YamlSourceStore } from './yaml-source.js';
+import { SqliteIndex } from './index/sqlite-index.js';
+import { KnowledgeWriter } from './writer.js';
+import { KnowledgeReader } from './reader.js';
+import { ContextGenerator } from './context-generator.js';
+import { StalenessDetector } from './staleness.js';
+/** Relative path of the knowledge directory within a project. */
+export declare const KNOWLEDGE_DIR: string;
+export interface KnowledgeEngine {
+    source: YamlSourceStore;
+    index: SqliteIndex;
+    writer: KnowledgeWriter;
+    reader: KnowledgeReader;
+    context: ContextGenerator;
+    staleness: StalenessDetector;
+    /** Parse warnings emitted by an auto-rebuild, if one ran. */
+    warnings: string[];
+    close(): void;
+}
+/**
+ * Open the knowledge engine for a project.
+ *
+ * @param projectRoot - Absolute project root (knowledge lives in `.aidlc/knowledge/`).
+ */
+export declare function openKnowledge(projectRoot: string): KnowledgeEngine;
+/** True when a project has any knowledge graph content. */
+export declare function knowledgeExists(projectRoot: string): boolean;
+//# sourceMappingURL=engine.d.ts.map

package/dist/knowledge/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/knowledge/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAiB,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,iEAAiE;AACjE,eAAO,MAAM,aAAa,QAA8B,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAgDlE;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/knowledge/engine.js

@@ -0,0 +1,79 @@
+/**
+ * Knowledge engine facade — opens the YAML store and SQLite index together
+ * and wires up the standard recovery paths:
+ *
+ * - Missing/empty index with YAML present → auto-rebuild from sources.
+ * - Outdated index schema → delete and rebuild (the index is a disposable
+ *   cache; YAML is the source of truth — design DD2).
+ *
+ * Requirements: KG 3.2, 3.3, 11.4
+ *
+ * @module
+ */
+import { join } from 'node:path';
+import { existsSync, rmSync } from 'node:fs';
+import { YamlSourceStore } from './yaml-source.js';
+import { SqliteIndex, INDEX_DB_FILE } from './index/sqlite-index.js';
+import { IndexOutdatedError } from './index/knowledge-index.js';
+import { KnowledgeWriter } from './writer.js';
+import { KnowledgeReader } from './reader.js';
+import { ContextGenerator } from './context-generator.js';
+import { StalenessDetector } from './staleness.js';
+/** Relative path of the knowledge directory within a project. */
+export const KNOWLEDGE_DIR = join('.aidlc', 'knowledge');
+/**
+ * Open the knowledge engine for a project.
+ *
+ * @param projectRoot - Absolute project root (knowledge lives in `.aidlc/knowledge/`).
+ */
+export function openKnowledge(projectRoot) {
+    const knowledgeDir = join(projectRoot, KNOWLEDGE_DIR);
+    const source = new YamlSourceStore(knowledgeDir);
+    const warnings = [];
+    const dbPath = join(knowledgeDir, INDEX_DB_FILE);
+    const dbExisted = existsSync(dbPath);
+    let index;
+    try {
+        index = new SqliteIndex(knowledgeDir);
+    }
+    catch (err) {
+        if (err instanceof IndexOutdatedError) {
+            // Outdated cache: discard and rebuild from YAML (KG Req 11.4).
+            rmSync(dbPath, { force: true });
+            rmSync(dbPath + '-wal', { force: true });
+            rmSync(dbPath + '-shm', { force: true });
+            index = new SqliteIndex(knowledgeDir);
+            warnings.push('Outdated knowledge index was discarded and rebuilt from YAML sources.');
+        }
+        else {
+            throw err;
+        }
+    }
+    // Fresh index but sources exist → populate from YAML (KG Req 3.2).
+    if ((!dbExisted || index.getAllEntities().length === 0) && source.exists()) {
+        const loaded = source.loadAll();
+        if (loaded.entities.length > 0 || loaded.relationships.length > 0) {
+            index.rebuild(loaded.entities, loaded.relationships);
+        }
+        warnings.push(...loaded.warnings);
+    }
+    const writer = new KnowledgeWriter(source, index);
+    const reader = new KnowledgeReader(index);
+    const context = new ContextGenerator(index);
+    const staleness = new StalenessDetector(index, source, projectRoot);
+    return {
+        source,
+        index,
+        writer,
+        reader,
+        context,
+        staleness,
+        warnings,
+        close: () => index.close(),
+    };
+}
+/** True when a project has any knowledge graph content. */
+export function knowledgeExists(projectRoot) {
+    return new YamlSourceStore(join(projectRoot, KNOWLEDGE_DIR)).exists();
+}
+//# sourceMappingURL=engine.js.map

package/dist/knowledge/engine.js.map

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

package/dist/knowledge/gate-criterion.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Ideation seeding gate criterion (design DD4, KG Req 8.5).
+ *
+ * Computed live against the knowledge index — never stored in phase state, so
+ * it cannot go stale. Applies only to the ideation phase and only once the
+ * project has adopted the knowledge graph (`.aidlc/knowledge/` exists);
+ * non-adopters see no new gate. No other phase gets a knowledge criterion
+ * (KG Req 9.3).
+ *
+ * @module
+ */
+/** Minimum seeded facts required to leave ideation (KG Req 8.5). */
+export declare const KNOWLEDGE_SEEDING_MINIMUMS: {
+    readonly modules: 3;
+    readonly dependsOnRelationships: 2;
+    readonly conventions: 1;
+};
+export interface KnowledgeCounts {
+    modules: number;
+    dependsOnRelationships: number;
+    conventions: number;
+}
+/**
+ * Pure check: shortfalls against the seeding minimums, phrased for
+ * `unsatisfiedCriteria` output (e.g. "knowledge graph has 1/3 modules").
+ */
+export declare function checkKnowledgeSeeding(counts: KnowledgeCounts): string[];
+/**
+ * Evaluate the ideation knowledge criterion for a project.
+ *
+ * @returns Unsatisfied criteria (empty when the gate passes), or empty when
+ *   the criterion does not apply (phase is not ideation, or the project has
+ *   not adopted the knowledge graph).
+ */
+export declare function evaluateKnowledgeCriterion(projectRoot: string, phaseName: string): string[];
+//# sourceMappingURL=gate-criterion.d.ts.map

package/dist/knowledge/gate-criterion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-criterion.d.ts","sourceRoot":"","sources":["../../src/knowledge/gate-criterion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,oEAAoE;AACpE,eAAO,MAAM,0BAA0B;;;;CAI7B,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAkBvE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3F"}

package/dist/knowledge/gate-criterion.js

@@ -0,0 +1,60 @@
+/**
+ * Ideation seeding gate criterion (design DD4, KG Req 8.5).
+ *
+ * Computed live against the knowledge index — never stored in phase state, so
+ * it cannot go stale. Applies only to the ideation phase and only once the
+ * project has adopted the knowledge graph (`.aidlc/knowledge/` exists);
+ * non-adopters see no new gate. No other phase gets a knowledge criterion
+ * (KG Req 9.3).
+ *
+ * @module
+ */
+import { openKnowledge, knowledgeExists } from './engine.js';
+/** Minimum seeded facts required to leave ideation (KG Req 8.5). */
+export const KNOWLEDGE_SEEDING_MINIMUMS = {
+    modules: 3,
+    dependsOnRelationships: 2,
+    conventions: 1,
+};
+/**
+ * Pure check: shortfalls against the seeding minimums, phrased for
+ * `unsatisfiedCriteria` output (e.g. "knowledge graph has 1/3 modules").
+ */
+export function checkKnowledgeSeeding(counts) {
+    const unsatisfied = [];
+    if (counts.modules < KNOWLEDGE_SEEDING_MINIMUMS.modules) {
+        unsatisfied.push(`knowledge graph has ${counts.modules}/${KNOWLEDGE_SEEDING_MINIMUMS.modules} module entities`);
+    }
+    if (counts.dependsOnRelationships < KNOWLEDGE_SEEDING_MINIMUMS.dependsOnRelationships) {
+        unsatisfied.push(`knowledge graph has ${counts.dependsOnRelationships}/${KNOWLEDGE_SEEDING_MINIMUMS.dependsOnRelationships} depends-on relationships`);
+    }
+    if (counts.conventions < KNOWLEDGE_SEEDING_MINIMUMS.conventions) {
+        unsatisfied.push(`knowledge graph has ${counts.conventions}/${KNOWLEDGE_SEEDING_MINIMUMS.conventions} convention entities`);
+    }
+    return unsatisfied;
+}
+/**
+ * Evaluate the ideation knowledge criterion for a project.
+ *
+ * @returns Unsatisfied criteria (empty when the gate passes), or empty when
+ *   the criterion does not apply (phase is not ideation, or the project has
+ *   not adopted the knowledge graph).
+ */
+export function evaluateKnowledgeCriterion(projectRoot, phaseName) {
+    if (phaseName !== 'ideation')
+        return [];
+    if (!knowledgeExists(projectRoot))
+        return [];
+    const engine = openKnowledge(projectRoot);
+    try {
+        return checkKnowledgeSeeding({
+            modules: engine.index.countEntitiesByType('module'),
+            dependsOnRelationships: engine.index.countRelationshipsByType('depends-on'),
+            conventions: engine.index.countEntitiesByType('convention'),
+        });
+    }
+    finally {
+        engine.close();
+    }
+}
+//# sourceMappingURL=gate-criterion.js.map

package/dist/knowledge/gate-criterion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-criterion.js","sourceRoot":"","sources":["../../src/knowledge/gate-criterion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,oEAAoE;AACpE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,OAAO,EAAE,CAAC;IACV,sBAAsB,EAAE,CAAC;IACzB,WAAW,EAAE,CAAC;CACN,CAAC;AAQX;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,MAAM,CAAC,OAAO,GAAG,0BAA0B,CAAC,OAAO,EAAE,CAAC;QACxD,WAAW,CAAC,IAAI,CACd,uBAAuB,MAAM,CAAC,OAAO,IAAI,0BAA0B,CAAC,OAAO,kBAAkB,CAC9F,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,sBAAsB,GAAG,0BAA0B,CAAC,sBAAsB,EAAE,CAAC;QACtF,WAAW,CAAC,IAAI,CACd,uBAAuB,MAAM,CAAC,sBAAsB,IAAI,0BAA0B,CAAC,sBAAsB,2BAA2B,CACrI,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,GAAG,0BAA0B,CAAC,WAAW,EAAE,CAAC;QAChE,WAAW,CAAC,IAAI,CACd,uBAAuB,MAAM,CAAC,WAAW,IAAI,0BAA0B,CAAC,WAAW,sBAAsB,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB,EAAE,SAAiB;IAC/E,IAAI,SAAS,KAAK,UAAU;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAE7C,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,qBAAqB,CAAC;YAC3B,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,QAAQ,CAAC;YACnD,sBAAsB,EAAE,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,YAAY,CAAC;YAC3E,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,YAAY,CAAC;SAC5D,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/knowledge/index/knowledge-index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * KnowledgeIndex — the narrow, engine-agnostic query interface (KG Req 3.7).
+ *
+ * The index is a derived cache of the YAML sources, never the source of
+ * truth. Nothing outside `src/knowledge/index/` may import a concrete
+ * engine; this seam keeps the storage engine swappable (design DD1).
+ *
+ * Requirements: KG 3.2, 3.4, 3.5, 3.8
+ *
+ * @module
+ */
+import type { Entity, Relationship } from '../types.js';
+export interface SearchOptions {
+    type?: string;
+    minConfidence?: number;
+    limit?: number;
+}
+export interface EntityFilter {
+    minConfidence?: number;
+}
+/** Thrown when the on-disk index schema is older than the CLI supports (KG Req 3.8, 11.4). */
+export declare class IndexOutdatedError extends Error {
+    constructor(found: number, expected: number);
+}
+export interface KnowledgeIndex {
+    getEntity(id: string): Entity | undefined;
+    upsertEntity(entity: Entity): void;
+    deleteEntity(id: string): void;
+    /** Ranked full-text search across name, description, and tags (KG Req 3.4, 5.7). */
+    fullTextSearch(term: string, options?: SearchOptions): Entity[];
+    getAllEntities(filter?: EntityFilter): Entity[];
+    getEntitiesByTypes(types: string[], filter?: EntityFilter): Entity[];
+    /** Entities mapped to a source file path (staleness detection, KG Req 7.3). */
+    getEntitiesByFilePath(path: string): Entity[];
+    countEntitiesByType(type: string): number;
+    upsertRelationship(rel: Relationship): void;
+    relationshipsFrom(id: string): Relationship[];
+    relationshipsTo(id: string): Relationship[];
+    relationshipsFor(ids: string[]): Relationship[];
+    countRelationshipsByType(type: string): number;
+    /** Replace all index contents from parsed YAML sources (KG Req 3.3). */
+    rebuild(entities: Entity[], relationships: Relationship[]): void;
+    close(): void;
+}
+//# sourceMappingURL=knowledge-index.d.ts.map

package/dist/knowledge/index/knowledge-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-index.d.ts","sourceRoot":"","sources":["../../../src/knowledge/index/knowledge-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,8FAA8F;AAC9F,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAO5C;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,oFAAoF;IACpF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CAAC;IAChE,cAAc,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;IAChD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;IACrE,+EAA+E;IAC/E,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9C,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAC5C,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAChD,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/C,wEAAwE;IACxE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAEjE,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/knowledge/index/knowledge-index.js

@@ -0,0 +1,20 @@
+/**
+ * KnowledgeIndex — the narrow, engine-agnostic query interface (KG Req 3.7).
+ *
+ * The index is a derived cache of the YAML sources, never the source of
+ * truth. Nothing outside `src/knowledge/index/` may import a concrete
+ * engine; this seam keeps the storage engine swappable (design DD1).
+ *
+ * Requirements: KG 3.2, 3.4, 3.5, 3.8
+ *
+ * @module
+ */
+/** Thrown when the on-disk index schema is older than the CLI supports (KG Req 3.8, 11.4). */
+export class IndexOutdatedError extends Error {
+    constructor(found, expected) {
+        super(`Knowledge index schema version ${found} is outdated (expected ${expected}). ` +
+            `Run 'aidlc knowledge rebuild'.`);
+        this.name = 'IndexOutdatedError';
+    }
+}
+//# sourceMappingURL=knowledge-index.js.map

package/dist/knowledge/index/knowledge-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-index.js","sourceRoot":"","sources":["../../../src/knowledge/index/knowledge-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,8FAA8F;AAC9F,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,KAAa,EAAE,QAAgB;QACzC,KAAK,CACH,kCAAkC,KAAK,0BAA0B,QAAQ,KAAK;YAC5E,gCAAgC,CACnC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/knowledge/index/sqlite-index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * SQLite implementation of KnowledgeIndex using the Node standard library
+ * (`node:sqlite`, Node >= 22) — zero npm dependencies (design DD1).
+ *
+ * FTS5 powers full-text search; if the runtime's SQLite build lacks FTS5 the
+ * index falls back to LIKE matching with a one-time stderr warning. The
+ * database is a disposable cache at `.aidlc/knowledge/index.db`, gitignored
+ * and rebuildable from YAML at any time (KG Req 3.1–3.3).
+ *
+ * Requirements: KG 3.1–3.8, 10.1–10.3, 11.4
+ *
+ * @module
+ */
+import type { Entity, Relationship } from '../types.js';
+import type { KnowledgeIndex, SearchOptions, EntityFilter } from './knowledge-index.js';
+/** Filename of the index database inside the knowledge directory. */
+export declare const INDEX_DB_FILE = "index.db";
+export declare class SqliteIndex implements KnowledgeIndex {
+    private readonly db;
+    private ftsAvailable;
+    private ftsWarned;
+    /**
+     * @param knowledgeDir - Directory holding YAML sources; index.db is created here.
+     * @param dbPathOverride - Test hook: use ':memory:' for an ephemeral index.
+     */
+    constructor(knowledgeDir: string, dbPathOverride?: string);
+    private ensureSchema;
+    private readSchemaVersion;
+    private createSchema;
+    getEntity(id: string): Entity | undefined;
+    upsertEntity(entity: Entity): void;
+    deleteEntity(id: string): void;
+    fullTextSearch(term: string, options?: SearchOptions): Entity[];
+    private ftsSearch;
+    private likeSearch;
+    getAllEntities(filter?: EntityFilter): Entity[];
+    getEntitiesByTypes(types: string[], filter?: EntityFilter): Entity[];
+    getEntitiesByFilePath(path: string): Entity[];
+    countEntitiesByType(type: string): number;
+    upsertRelationship(rel: Relationship): void;
+    relationshipsFrom(id: string): Relationship[];
+    relationshipsTo(id: string): Relationship[];
+    relationshipsFor(ids: string[]): Relationship[];
+    countRelationshipsByType(type: string): number;
+    rebuild(entities: Entity[], relationships: Relationship[]): void;
+    close(): void;
+    private syncFts;
+    private syncFileMapping;
+    private warnNoFts;
+}
+/** Split camelCase and kebab/snake-case identifiers into searchable words. */
+export declare function normalizeSearchText(text: string): string;
+//# sourceMappingURL=sqlite-index.d.ts.map

package/dist/knowledge/index/sqlite-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-index.d.ts","sourceRoot":"","sources":["../../../src/knowledge/index/sqlite-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAExF,qEAAqE;AACrE,eAAO,MAAM,aAAa,aAAa,CAAC;AAwBxC,qBAAa,WAAY,YAAW,cAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAClC,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,SAAS,CAAS;IAE1B;;;OAGG;gBACS,YAAY,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;IAYzD,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,YAAY;IAgEpB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOzC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAwBlC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ9B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,EAAE;IAenE,OAAO,CAAC,SAAS;IA2BjB,OAAO,CAAC,UAAU;IAkBlB,cAAc,CAAC,MAAM,GAAE,YAAiB,GAAG,MAAM,EAAE;IAYnD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,YAAiB,GAAG,MAAM,EAAE;IAcxE,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAW7C,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAWzC,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAU3C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,EAAE;IAO7C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,EAAE;IAO3C,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE;IAY/C,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAW9C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI;IAiBhE,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,SAAS;CAOlB;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD"}