@vpxa/kb 0.1.13 → 0.1.15

package/packages/store/dist/sqlite-graph-store.js

@@ -1,4 +1,4 @@
-import{existsSync as g,mkdirSync as l,readFileSync as N,writeFileSync as f}from"node:fs";import{dirname as S,join as I}from"node:path";class b{db=null;dbPath;dirty=!1;constructor(e){const t=e?.path??".kb-data";this.dbPath=I(t,"graph.db")}async initialize(){const e=S(this.dbPath);g(e)||l(e,{recursive:!0});const t=(await import("sql.js")).default,s=await t();if(g(this.dbPath)){const i=N(this.dbPath);this.db=new s.Database(i)}else this.db=new s.Database;this.db.run("PRAGMA journal_mode = WAL"),this.db.exec("PRAGMA foreign_keys = ON;"),this.db.run(`
+import{existsSync as e,mkdirSync as t,readFileSync as n,writeFileSync as r}from"node:fs";import{dirname as i,join as a}from"node:path";var o=class{db=null;dbPath;dirty=!1;constructor(e){this.dbPath=a(e?.path??`.kb-data`,`graph.db`)}async initialize(){let r=i(this.dbPath);e(r)||t(r,{recursive:!0});let a=(await import(`sql.js`)).default,o=await a();if(e(this.dbPath)){let e=n(this.dbPath);this.db=new o.Database(e)}else this.db=new o.Database;this.db.run(`PRAGMA journal_mode = WAL`),this.db.exec(`PRAGMA foreign_keys = ON;`),this.db.run(`
       CREATE TABLE IF NOT EXISTS nodes (
         id TEXT PRIMARY KEY,
         type TEXT NOT NULL,
@@ -19,7 +19,7 @@ import{existsSync as g,mkdirSync as l,readFileSync as N,writeFileSync as f}from"
         FOREIGN KEY (from_id) REFERENCES nodes(id) ON DELETE CASCADE,
         FOREIGN KEY (to_id) REFERENCES nodes(id) ON DELETE CASCADE
       )
-    `),this.db.run("CREATE INDEX IF NOT EXISTS idx_nodes_type ON nodes(type)"),this.db.run("CREATE INDEX IF NOT EXISTS idx_nodes_name ON nodes(name)"),this.db.run("CREATE INDEX IF NOT EXISTS idx_nodes_source_path ON nodes(source_path)"),this.db.run("CREATE INDEX IF NOT EXISTS idx_edges_from ON edges(from_id)"),this.db.run("CREATE INDEX IF NOT EXISTS idx_edges_to ON edges(to_id)"),this.db.run("CREATE INDEX IF NOT EXISTS idx_edges_type ON edges(type)"),this.persist()}ensureDb(){if(!this.db)throw new Error("Graph store not initialized \u2014 call initialize() first");return this.db}persist(){if(!this.db)return;const e=this.db.export();f(this.dbPath,Buffer.from(e)),this.db.exec("PRAGMA foreign_keys = ON;"),this.dirty=!1}markDirty(){this.dirty=!0}flushIfDirty(){this.dirty&&this.persist()}query(e,t=[]){const i=this.ensureDb().prepare(e);i.bind(t);const d=[];for(;i.step();)d.push(i.getAsObject());return i.free(),d}run(e,t=[]){this.ensureDb().run(e,t)}async upsertNode(e){this.run(`INSERT INTO nodes (id, type, name, properties, source_record_id, source_path, created_at)
+    `),this.db.run(`CREATE INDEX IF NOT EXISTS idx_nodes_type ON nodes(type)`),this.db.run(`CREATE INDEX IF NOT EXISTS idx_nodes_name ON nodes(name)`),this.db.run(`CREATE INDEX IF NOT EXISTS idx_nodes_source_path ON nodes(source_path)`),this.db.run(`CREATE INDEX IF NOT EXISTS idx_edges_from ON edges(from_id)`),this.db.run(`CREATE INDEX IF NOT EXISTS idx_edges_to ON edges(to_id)`),this.db.run(`CREATE INDEX IF NOT EXISTS idx_edges_type ON edges(type)`),this.persist()}ensureDb(){if(!this.db)throw Error(`Graph store not initialized — call initialize() first`);return this.db}persist(){if(!this.db)return;let e=this.db.export();try{r(this.dbPath,Buffer.from(e))}finally{this.db.exec(`PRAGMA foreign_keys = ON;`)}this.dirty=!1}markDirty(){this.dirty=!0}flushIfDirty(){this.dirty&&this.persist()}query(e,t=[]){let n=this.ensureDb().prepare(e);n.bind(t);let r=[];try{for(;n.step();)r.push(n.getAsObject())}finally{n.free()}return r}run(e,t=[]){this.ensureDb().run(e,t)}async upsertNode(e){this.run(`INSERT INTO nodes (id, type, name, properties, source_record_id, source_path, created_at)
        VALUES (?, ?, ?, ?, ?, ?, ?)
        ON CONFLICT(id) DO UPDATE SET
          type = excluded.type, name = excluded.name, properties = excluded.properties,
@@ -27,20 +27,21 @@ import{existsSync as g,mkdirSync as l,readFileSync as N,writeFileSync as f}from"
        VALUES (?, ?, ?, ?, ?, ?)
        ON CONFLICT(id) DO UPDATE SET
          from_id = excluded.from_id, to_id = excluded.to_id,
-         type = excluded.type, weight = excluded.weight, properties = excluded.properties`,[e.id,e.fromId,e.toId,e.type,e.weight??1,JSON.stringify(e.properties??{})]),this.markDirty(),this.flushIfDirty()}async upsertNodes(e){if(e.length!==0){this.ensureDb().run("BEGIN TRANSACTION");for(const t of e)this.run(`INSERT INTO nodes (id, type, name, properties, source_record_id, source_path, created_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?)
-         ON CONFLICT(id) DO UPDATE SET
-           type = excluded.type, name = excluded.name, properties = excluded.properties,
-           source_record_id = excluded.source_record_id, source_path = excluded.source_path`,[t.id,t.type,t.name,JSON.stringify(t.properties),t.sourceRecordId??null,t.sourcePath??null,t.createdAt??new Date().toISOString()]);this.ensureDb().run("COMMIT"),this.markDirty(),this.flushIfDirty()}}async upsertEdges(e){if(e.length!==0){this.ensureDb().run("BEGIN TRANSACTION");for(const t of e)this.run(`INSERT INTO edges (id, from_id, to_id, type, weight, properties)
-         VALUES (?, ?, ?, ?, ?, ?)
-         ON CONFLICT(id) DO UPDATE SET
-           from_id = excluded.from_id, to_id = excluded.to_id,
-           type = excluded.type, weight = excluded.weight, properties = excluded.properties`,[t.id,t.fromId,t.toId,t.type,t.weight??1,JSON.stringify(t.properties??{})]);this.ensureDb().run("COMMIT"),this.markDirty(),this.flushIfDirty()}}async getNode(e){const t=this.query("SELECT * FROM nodes WHERE id = ?",[e]);return t.length>0?T(t[0]):null}async getNeighbors(e,t){const s=t?.direction??"both",i=t?.edgeType,d=t?.limit??50,p=[],n=[],u=new Set,h=`
+         type = excluded.type, weight = excluded.weight, properties = excluded.properties`,[e.id,e.fromId,e.toId,e.type,e.weight??1,JSON.stringify(e.properties??{})]),this.markDirty(),this.flushIfDirty()}async upsertNodes(e){if(e.length===0)return;let t=this.ensureDb();t.run(`BEGIN TRANSACTION`);try{for(let t of e)this.run(`INSERT INTO nodes (id, type, name, properties, source_record_id, source_path, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?)
+           ON CONFLICT(id) DO UPDATE SET
+             type = excluded.type, name = excluded.name, properties = excluded.properties,
+             source_record_id = excluded.source_record_id, source_path = excluded.source_path`,[t.id,t.type,t.name,JSON.stringify(t.properties),t.sourceRecordId??null,t.sourcePath??null,t.createdAt??new Date().toISOString()]);t.run(`COMMIT`)}catch(e){throw t.run(`ROLLBACK`),e}this.markDirty(),this.flushIfDirty()}async upsertEdges(e){if(e.length===0)return;let t=this.ensureDb();t.run(`BEGIN TRANSACTION`);try{for(let t of e)this.run(`INSERT INTO edges (id, from_id, to_id, type, weight, properties)
+           VALUES (?, ?, ?, ?, ?, ?)
+           ON CONFLICT(id) DO UPDATE SET
+             from_id = excluded.from_id, to_id = excluded.to_id,
+             type = excluded.type, weight = excluded.weight, properties = excluded.properties`,[t.id,t.fromId,t.toId,t.type,t.weight??1,JSON.stringify(t.properties??{})]);t.run(`COMMIT`)}catch(e){throw t.run(`ROLLBACK`),e}this.markDirty(),this.flushIfDirty()}async getNode(e){let t=this.query(`SELECT * FROM nodes WHERE id = ?`,[e]);return t.length>0?c(t[0]):null}async getNeighbors(e,t){let n=t?.direction??`both`,r=t?.edgeType,i=t?.limit??50,a=[],o=[],s=new Set;if(n===`outgoing`||n===`both`){let t=`
       SELECT e.id AS edge_id, e.from_id, e.to_id, e.type AS edge_type, e.weight, e.properties AS edge_props,
              n.id AS node_id, n.type AS node_type, n.name AS node_name, n.properties AS node_props,
              n.source_record_id AS node_src_rec, n.source_path AS node_src_path, n.created_at AS node_created
-      FROM edges e JOIN nodes n ON e.to_id = n.id WHERE e.from_id = ?`,_=`
+      FROM edges e JOIN nodes n ON e.to_id = n.id WHERE e.from_id = ?`,n=[e];r&&(t+=` AND e.type = ?`,n.push(r)),t+=` LIMIT ?`,n.push(i);let c=this.query(t,n);for(let e of c)o.push(u(e)),s.has(e.node_id)||(s.add(e.node_id),a.push(d(e)))}if(n===`incoming`||n===`both`){let t=`
       SELECT e.id AS edge_id, e.from_id, e.to_id, e.type AS edge_type, e.weight, e.properties AS edge_props,
              n.id AS node_id, n.type AS node_type, n.name AS node_name, n.properties AS node_props,
              n.source_record_id AS node_src_rec, n.source_path AS node_src_path, n.created_at AS node_created
-      FROM edges e JOIN nodes n ON e.from_id = n.id WHERE e.to_id = ?`;if(s==="outgoing"||s==="both"){let o=h;const c=[e];i&&(o+=" AND e.type = ?",c.push(i)),o+=" LIMIT ?",c.push(d);const a=this.query(o,c);for(const E of a)n.push(y(E)),u.has(E.node_id)||(u.add(E.node_id),p.push(m(E)))}if(s==="incoming"||s==="both"){let o=_;const c=[e];i&&(o+=" AND e.type = ?",c.push(i)),o+=" LIMIT ?",c.push(d);const a=this.query(o,c);for(const E of a)n.push(y(E)),u.has(E.node_id)||(u.add(E.node_id),p.push(m(E)))}return{nodes:p,edges:n}}async traverse(e,t){const s=t?.maxDepth??2,i=t?.direction??"both",d=t?.edgeType,p=t?.limit??50,n=new Map,u=new Map,h=new Set,_=[{nodeId:e,depth:0}];for(;_.length>0&&n.size<p;){const o=_.shift();if(!o||h.has(o.nodeId)||o.depth>s)continue;h.add(o.nodeId);const c=await this.getNeighbors(o.nodeId,{direction:i,edgeType:d,limit:p-n.size});for(const a of c.nodes)n.has(a.id)||(n.set(a.id,a),o.depth+1<s&&_.push({nodeId:a.id,depth:o.depth+1}));for(const a of c.edges)u.set(a.id,a)}return{nodes:[...n.values()],edges:[...u.values()]}}async findNodes(e){const t=[],s=[];e.type&&(t.push("type = ?"),s.push(e.type)),e.namePattern&&(t.push("name LIKE ?"),s.push(`%${e.namePattern}%`)),e.sourcePath&&(t.push("source_path = ?"),s.push(e.sourcePath));const i=t.length>0?`WHERE ${t.join(" AND ")}`:"",d=e.limit??100;return this.query(`SELECT * FROM nodes ${i} LIMIT ?`,[...s,d]).map(n=>T(n))}async findEdges(e){const t=[],s=[];e.type&&(t.push("type = ?"),s.push(e.type)),e.fromId&&(t.push("from_id = ?"),s.push(e.fromId)),e.toId&&(t.push("to_id = ?"),s.push(e.toId));const i=t.length>0?`WHERE ${t.join(" AND ")}`:"",d=e.limit??100;return this.query(`SELECT * FROM edges ${i} LIMIT ?`,[...s,d]).map(n=>O(n))}async deleteNode(e){this.ensureDb().run("BEGIN TRANSACTION"),this.run("DELETE FROM edges WHERE from_id = ? OR to_id = ?",[e,e]),this.run("DELETE FROM nodes WHERE id = ?",[e]),this.ensureDb().run("COMMIT"),this.markDirty(),this.flushIfDirty()}async deleteBySourcePath(e){const t=this.query("SELECT id FROM nodes WHERE source_path = ?",[e]);if(t.length===0)return 0;this.ensureDb().run("BEGIN TRANSACTION");for(const s of t)this.run("DELETE FROM edges WHERE from_id = ? OR to_id = ?",[s.id,s.id]);return this.run("DELETE FROM nodes WHERE source_path = ?",[e]),this.ensureDb().run("COMMIT"),this.markDirty(),this.flushIfDirty(),t.length}async clear(){this.run("DELETE FROM edges"),this.run("DELETE FROM nodes"),this.markDirty(),this.flushIfDirty()}async getStats(){const t=this.query("SELECT COUNT(*) as count FROM nodes")[0]?.count??0,i=this.query("SELECT COUNT(*) as count FROM edges")[0]?.count??0,d=this.query("SELECT type, COUNT(*) as count FROM nodes GROUP BY type"),p={};for(const h of d)p[h.type]=h.count;const n=this.query("SELECT type, COUNT(*) as count FROM edges GROUP BY type"),u={};for(const h of n)u[h.type]=h.count;return{nodeCount:t,edgeCount:i,nodeTypes:p,edgeTypes:u}}async close(){this.db&&(this.flushIfDirty(),this.db.close(),this.db=null)}}function T(r){return{id:r.id,type:r.type,name:r.name,properties:JSON.parse(r.properties),sourceRecordId:r.source_record_id??void 0,sourcePath:r.source_path??void 0,createdAt:r.created_at}}function O(r){return{id:r.id,fromId:r.from_id,toId:r.to_id,type:r.type,weight:r.weight??1,properties:JSON.parse(r.properties)}}function y(r){return{id:r.edge_id,fromId:r.from_id,toId:r.to_id,type:r.edge_type,weight:r.weight??1,properties:JSON.parse(r.edge_props??"{}")}}function m(r){return{id:r.node_id,type:r.node_type,name:r.node_name,properties:JSON.parse(r.node_props??"{}"),sourceRecordId:r.node_src_rec??void 0,sourcePath:r.node_src_path??void 0,createdAt:r.node_created}}export{b as SqliteGraphStore};
+      FROM edges e JOIN nodes n ON e.from_id = n.id WHERE e.to_id = ?`,n=[e];r&&(t+=` AND e.type = ?`,n.push(r)),t+=` LIMIT ?`,n.push(i);let c=this.query(t,n);for(let e of c)o.push(u(e)),s.has(e.node_id)||(s.add(e.node_id),a.push(d(e)))}return{nodes:a,edges:o}}async traverse(e,t){let n=t?.maxDepth??2,r=t?.direction??`both`,i=t?.edgeType,a=t?.limit??50,o=new Map,s=new Map,c=new Set,l=[{nodeId:e,depth:0}];for(;l.length>0&&o.size<a;){let e=l.shift();if(!e||c.has(e.nodeId)||e.depth>n)continue;c.add(e.nodeId);let t=await this.getNeighbors(e.nodeId,{direction:r,edgeType:i,limit:a-o.size});for(let r of t.nodes)o.has(r.id)||(o.set(r.id,r),e.depth+1<n&&l.push({nodeId:r.id,depth:e.depth+1}));for(let e of t.edges)s.set(e.id,e)}return{nodes:[...o.values()],edges:[...s.values()]}}async findNodes(e){let t=[],n=[];e.type&&(t.push(`type = ?`),n.push(e.type)),e.namePattern&&(t.push(`name LIKE ?`),n.push(`%${e.namePattern}%`)),e.sourcePath&&(t.push(`source_path = ?`),n.push(e.sourcePath));let r=t.length>0?`WHERE ${t.join(` AND `)}`:``,i=e.limit??100;return this.query(`SELECT * FROM nodes ${r} LIMIT ?`,[...n,i]).map(e=>c(e))}async findEdges(e){let t=[],n=[];e.type&&(t.push(`type = ?`),n.push(e.type)),e.fromId&&(t.push(`from_id = ?`),n.push(e.fromId)),e.toId&&(t.push(`to_id = ?`),n.push(e.toId));let r=t.length>0?`WHERE ${t.join(` AND `)}`:``,i=e.limit??100;return this.query(`SELECT * FROM edges ${r} LIMIT ?`,[...n,i]).map(e=>l(e))}async deleteNode(e){let t=this.ensureDb();t.run(`BEGIN TRANSACTION`);try{this.run(`DELETE FROM edges WHERE from_id = ? OR to_id = ?`,[e,e]),this.run(`DELETE FROM nodes WHERE id = ?`,[e]),t.run(`COMMIT`)}catch(e){throw t.run(`ROLLBACK`),e}this.markDirty(),this.flushIfDirty()}async deleteBySourcePath(e){let t=this.query(`SELECT id FROM nodes WHERE source_path = ?`,[e]);if(t.length===0)return 0;let n=this.ensureDb();n.run(`BEGIN TRANSACTION`);try{for(let e of t)this.run(`DELETE FROM edges WHERE from_id = ? OR to_id = ?`,[e.id,e.id]);this.run(`DELETE FROM nodes WHERE source_path = ?`,[e]),n.run(`COMMIT`)}catch(e){throw n.run(`ROLLBACK`),e}return this.markDirty(),this.flushIfDirty(),t.length}async clear(){this.run(`DELETE FROM edges`),this.run(`DELETE FROM nodes`),this.markDirty(),this.flushIfDirty()}async getStats(){let e=this.query(`SELECT COUNT(*) as count FROM nodes`)[0]?.count??0,t=this.query(`SELECT COUNT(*) as count FROM edges`)[0]?.count??0,n=this.query(`SELECT type, COUNT(*) as count FROM nodes GROUP BY type`),r={};for(let e of n)r[e.type]=e.count;let i=this.query(`SELECT type, COUNT(*) as count FROM edges GROUP BY type`),a={};for(let e of i)a[e.type]=e.count;return{nodeCount:e,edgeCount:t,nodeTypes:r,edgeTypes:a}}async close(){this.db&&=(this.flushIfDirty(),this.db.close(),null)}};function s(e){if(!e)return{};try{return JSON.parse(e)}catch{return{}}}function c(e){return{id:e.id,type:e.type,name:e.name,properties:s(e.properties),sourceRecordId:e.source_record_id??void 0,sourcePath:e.source_path??void 0,createdAt:e.created_at}}function l(e){return{id:e.id,fromId:e.from_id,toId:e.to_id,type:e.type,weight:e.weight??1,properties:s(e.properties)}}function u(e){return{id:e.edge_id,fromId:e.from_id,toId:e.to_id,type:e.edge_type,weight:e.weight??1,properties:s(e.edge_props??`{}`)}}function d(e){return{id:e.node_id,type:e.node_type,name:e.node_name,properties:s(e.node_props??`{}`),sourceRecordId:e.node_src_rec??void 0,sourcePath:e.node_src_path??void 0,createdAt:e.node_created}}export{o as SqliteGraphStore};
+//# sourceMappingURL=sqlite-graph-store.js.map

package/packages/store/dist/store-factory.d.ts

@@ -1,9 +1,13 @@
-import type { IKnowledgeStore } from './store.interface.js';
-export type StoreBackend = 'lancedb' | 'sqlite-vec';
-export interface StoreConfig {
-    backend: StoreBackend;
-    path: string;
-    options?: Record<string, unknown>;
+import { IKnowledgeStore } from "./store.interface.js";
+
+//#region packages/store/src/store-factory.d.ts
+type StoreBackend = 'lancedb' | 'sqlite-vec';
+interface StoreConfig {
+  backend: StoreBackend;
+  path: string;
+  options?: Record<string, unknown>;
 }
-export declare function createStore(config: StoreConfig): Promise<IKnowledgeStore>;
+declare function createStore(config: StoreConfig): Promise<IKnowledgeStore>;
+//#endregion
+export { StoreBackend, StoreConfig, createStore };
 //# sourceMappingURL=store-factory.d.ts.map

package/packages/store/dist/store-factory.js

@@ -1 +1,2 @@
-async function n(e){if(e.backend==="lancedb"){const{LanceStore:t}=await import("./lance-store.js");return new t({path:e.path})}else throw new Error(`Unknown store backend: "${e.backend}". Supported: lancedb`)}export{n as createStore};
+async function e(e){switch(e.backend){case`lancedb`:{let{LanceStore:t}=await import(`./lance-store.js`);return new t({path:e.path})}default:throw Error(`Unknown store backend: "${e.backend}". Supported: lancedb`)}}export{e as createStore};
+//# sourceMappingURL=store-factory.js.map

package/packages/store/dist/store.interface.d.ts

@@ -1,50 +1,51 @@
-/**
- * Knowledge store abstraction — allows swapping vector DB backends.
- */
-import type { IndexStats, KnowledgeRecord, SearchResult } from '@kb/core';
+import { ContentType, IndexStats, KnowledgeOrigin, KnowledgeRecord, SearchResult, SourceType } from "@kb/core";
+
+//#region packages/store/src/store.interface.d.ts
 /** Options for searching the store */
-export interface SearchOptions {
-    /** Maximum number of results to return */
-    limit?: number;
-    /** Minimum similarity score (0-1) */
-    minScore?: number;
-    /** Filter by content type */
-    contentType?: string;
-    /** Filter by coarse source type (source, documentation, test, config, generated) */
-    sourceType?: string;
-    /** Filter by origin */
-    origin?: string;
-    /** Filter by category */
-    category?: string;
-    /** Filter by tags (any match) */
-    tags?: string[];
+interface SearchOptions {
+  /** Maximum number of results to return */
+  limit?: number;
+  /** Minimum similarity score (0-1) */
+  minScore?: number;
+  /** Filter by content type */
+  contentType?: ContentType;
+  /** Filter by coarse source type (source, documentation, test, config, generated) */
+  sourceType?: SourceType;
+  /** Filter by origin */
+  origin?: KnowledgeOrigin;
+  /** Filter by category */
+  category?: string;
+  /** Filter by tags (any match) */
+  tags?: string[];
 }
-export interface IKnowledgeStore {
-    /** Initialize the store (create tables, etc.) */
-    initialize(): Promise<void>;
-    /** Add or update records with their embedding vectors */
-    upsert(records: KnowledgeRecord[], vectors: Float32Array[]): Promise<void>;
-    /** Search by vector similarity */
-    search(queryVector: Float32Array, options?: SearchOptions): Promise<SearchResult[]>;
-    /** Get a specific record by ID */
-    getById(id: string): Promise<KnowledgeRecord | null>;
-    /** Delete records by source path (used during re-indexing) */
-    deleteBySourcePath(sourcePath: string): Promise<number>;
-    /** Delete a specific record by ID */
-    deleteById(id: string): Promise<boolean>;
-    /** Get all records for a source path */
-    getBySourcePath(sourcePath: string): Promise<KnowledgeRecord[]>;
-    /** Get index statistics */
-    getStats(): Promise<IndexStats>;
-    /** List all unique source paths in the store */
-    listSourcePaths(): Promise<string[]>;
-    /** Create a full-text search index on the content column for keyword search */
-    createFtsIndex(): Promise<void>;
-    /** Full-text keyword search (requires FTS index) */
-    ftsSearch(query: string, options?: SearchOptions): Promise<SearchResult[]>;
-    /** Drop the backing table entirely — used for hard resets (e.g. dimension changes) */
-    dropTable(): Promise<void>;
-    /** Close the store connection */
-    close(): Promise<void>;
+interface IKnowledgeStore {
+  /** Initialize the store (create tables, etc.) */
+  initialize(): Promise<void>;
+  /** Add or update records with their embedding vectors */
+  upsert(records: KnowledgeRecord[], vectors: Float32Array[]): Promise<void>;
+  /** Search by vector similarity */
+  search(queryVector: Float32Array, options?: SearchOptions): Promise<SearchResult[]>;
+  /** Get a specific record by ID */
+  getById(id: string): Promise<KnowledgeRecord | null>;
+  /** Delete records by source path (used during re-indexing) */
+  deleteBySourcePath(sourcePath: string): Promise<number>;
+  /** Delete a specific record by ID */
+  deleteById(id: string): Promise<boolean>;
+  /** Get all records for a source path */
+  getBySourcePath(sourcePath: string): Promise<KnowledgeRecord[]>;
+  /** Get index statistics */
+  getStats(): Promise<IndexStats>;
+  /** List all unique source paths in the store */
+  listSourcePaths(): Promise<string[]>;
+  /** Create a full-text search index on the content column for keyword search */
+  createFtsIndex(): Promise<void>;
+  /** Full-text keyword search (requires FTS index) */
+  ftsSearch(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+  /** Drop the backing table entirely — used for hard resets (e.g. dimension changes) */
+  dropTable(): Promise<void>;
+  /** Close the store connection */
+  close(): Promise<void>;
 }
+//#endregion
+export { IKnowledgeStore, SearchOptions };
 //# sourceMappingURL=store.interface.d.ts.map

package/packages/store/dist/store.interface.js

@@ -0,0 +1 @@
+export{};

package/packages/tools/dist/audit.d.ts

@@ -1,66 +1,66 @@
-/**
- * Unified audit tool (E-007) — runs structure, dependencies, patterns, health,
- * dead_symbols, and check in one call, producing a synthesized report.
- */
-import type { IEmbedder } from '@kb/embeddings';
-import type { IKnowledgeStore } from '@kb/store';
-import { type KBResponse } from './response-envelope.js';
-export type AuditCheck = 'structure' | 'dependencies' | 'patterns' | 'health' | 'dead_symbols' | 'check' | 'entry_points';
-export interface AuditOptions {
-    /** Root path to audit (default: cwd) */
-    path?: string;
-    /** Which checks to run (default: all) */
-    checks?: AuditCheck[];
-    /** Detail level (default: 'summary') */
-    detail?: 'summary' | 'full';
+import { KBResponse } from "./response-envelope.js";
+import { IEmbedder } from "@kb/embeddings";
+import { IKnowledgeStore } from "@kb/store";
+
+//#region packages/tools/src/audit.d.ts
+type AuditCheck = 'structure' | 'dependencies' | 'patterns' | 'health' | 'dead_symbols' | 'check' | 'entry_points';
+interface AuditOptions {
+  /** Root path to audit (default: cwd) */
+  path?: string;
+  /** Which checks to run (default: all) */
+  checks?: AuditCheck[];
+  /** Detail level (default: 'summary') */
+  detail?: 'summary' | 'full';
 }
-export interface AuditRecommendation {
-    priority: 'high' | 'medium' | 'low';
-    area: string;
-    message: string;
+interface AuditRecommendation {
+  priority: 'high' | 'medium' | 'low';
+  area: string;
+  message: string;
 }
-export interface AuditData {
+interface AuditData {
+  score: number;
+  structure?: {
+    files: number;
+    packages: number;
+    languages: Record<string, number>;
+  };
+  dependencies?: {
+    external: number;
+    internal: number;
+  };
+  patterns?: Array<{
+    name: string;
+    confidence: string;
+    count: number;
+  }>;
+  health?: {
     score: number;
-    structure?: {
-        files: number;
-        packages: number;
-        languages: Record<string, number>;
-    };
-    dependencies?: {
-        external: number;
-        internal: number;
-    };
-    patterns?: Array<{
-        name: string;
-        confidence: string;
-        count: number;
-    }>;
-    health?: {
-        score: number;
-        checks: number;
-        passed: number;
-        warned: number;
-        failed: number;
-    };
-    deadSymbols?: {
-        source: number;
-        docs: number;
-    };
-    entryPoints?: {
-        total: number;
-        types: Record<string, number>;
-    };
-    typecheck?: {
-        passed: boolean;
-        errorCount: number;
-        topErrors: string[];
-    };
-    lint?: {
-        passed: boolean;
-        errorCount: number;
-        topErrors: string[];
-    };
-    recommendations: AuditRecommendation[];
+    checks: number;
+    passed: number;
+    warned: number;
+    failed: number;
+  };
+  deadSymbols?: {
+    source: number;
+    docs: number;
+  };
+  entryPoints?: {
+    total: number;
+    types: Record<string, number>;
+  };
+  typecheck?: {
+    passed: boolean;
+    errorCount: number;
+    topErrors: string[];
+  };
+  lint?: {
+    passed: boolean;
+    errorCount: number;
+    topErrors: string[];
+  };
+  recommendations: AuditRecommendation[];
 }
-export declare function audit(store: IKnowledgeStore, embedder: IEmbedder, options?: AuditOptions): Promise<KBResponse<AuditData>>;
+declare function audit(store: IKnowledgeStore, embedder: IEmbedder, options?: AuditOptions): Promise<KBResponse<AuditData>>;
+//#endregion
+export { AuditCheck, AuditData, AuditOptions, AuditRecommendation, audit };
 //# sourceMappingURL=audit.d.ts.map

package/packages/tools/dist/audit.js

@@ -1,7 +1,7 @@
-import{DependencyAnalyzer as $,EntryPointAnalyzer as A,PatternAnalyzer as w,StructureAnalyzer as S}from"../../analyzers/dist/index.js";import{check as x,summarizeCheckResult as C}from"./check.js";import{findDeadSymbols as D}from"./dead-symbols.js";import{health as R}from"./health.js";import{resolvePath as P}from"./path-resolver.js";import{errorResponse as z,okResponse as E}from"./response-envelope.js";const _=["structure","dependencies","patterns","health","dead_symbols","check","entry_points"];async function B(e,h,n={}){const o=Date.now(),i=P(n.path),l=n.checks??_,f=n.detail??"summary",d=[],t={score:100,recommendations:d};try{const c=[];l.includes("structure")&&c.push((async()=>{const s=await new S().analyze(i,{format:"json"}),a=s.data;t.structure={files:a.stats?.totalFiles??s.meta.fileCount,packages:Array.isArray(a.packages)?a.packages.length:0,languages:a.stats?.languages??{}}})()),l.includes("dependencies")&&c.push((async()=>{const a=(await new $().analyze(i)).data,u=a.imports??[];t.dependencies={external:a.external?.length??u.filter(p=>p.isExternal).length,internal:a.internal?.length??u.filter(p=>!p.isExternal).length}})()),l.includes("patterns")&&c.push((async()=>{const a=(await new w().analyze(i)).data;t.patterns=(a.patterns??[]).map(u=>({name:u.pattern,confidence:u.confidence,count:u.locations.length}))})()),l.includes("entry_points")&&c.push((async()=>{const a=(await new A().analyze(i)).data,u=a.entryPoints??[],p={};for(const b of u)p[b.type]=(p[b.type]??0)+1;t.entryPoints={total:a.total??u.length,types:p}})()),l.includes("health")&&c.push((async()=>{const r=R(i);t.health={score:r.score,checks:r.checks.length,passed:r.checks.filter(s=>s.status==="pass").length,warned:r.checks.filter(s=>s.status==="warn").length,failed:r.checks.filter(s=>s.status==="fail").length},r.score<70&&d.push({priority:"medium",area:"health",message:`Health score ${r.score}/100 \u2014 ${t.health.failed} failed checks`})})()),l.includes("dead_symbols")&&c.push((async()=>{const r=await D(h,e,{rootPath:i});t.deadSymbols={source:r.totalDeadSource,docs:r.totalDeadDocs},r.totalDeadSource>0&&d.push({priority:r.totalDeadSource>10?"high":"medium",area:"dead-code",message:`${r.totalDeadSource} unused exports in source files`})})()),l.includes("check")&&c.push((async()=>{const r=await x({cwd:i}),s=C(r);t.typecheck={passed:s.tsc.passed,errorCount:s.tsc.errorCount,topErrors:s.tsc.topErrors},t.lint={passed:s.biome.passed,errorCount:s.biome.errorCount,topErrors:s.biome.topErrors},s.tsc.passed||d.push({priority:"high",area:"type-safety",message:`Fix ${s.tsc.errorCount} tsc error(s)`}),s.biome.passed||d.push({priority:"medium",area:"lint",message:`Fix ${s.biome.errorCount} lint error(s)`})})()),await Promise.all(c);let m=0;t.typecheck&&!t.typecheck.passed&&(m+=15),t.lint&&!t.lint.passed&&(m+=5),t.health&&t.health.score<80&&(m+=10),t.deadSymbols&&t.deadSymbols.source>10&&(m+=5),t.entryPoints&&t.entryPoints.total===0&&(m+=5),t.score=Math.max(0,100-m);const g={high:0,medium:1,low:2};d.sort((r,s)=>g[r.priority]-g[s.priority]);const k=j(t,f),y=[];return t.typecheck&&!t.typecheck.passed&&y.push({tool:"check",reason:"Get full error details",suggested_args:{detail:"errors"}}),t.deadSymbols&&t.deadSymbols.source>0&&y.push({tool:"dead_symbols",reason:"See which exports are unused",suggested_args:{root_path:i}}),E("audit",k,t,{durationMs:Date.now()-o,detail:f},y)}catch(c){return z("audit",{code:"ANALYSIS_FAILED",category:"runtime",retryable:!1,message:`Audit failed: ${c.message}`},Date.now()-o)}}function j(e,h){const n=[];if(n.push(`## Audit Report \u2014 Score: ${e.score}/100
-`),e.structure&&n.push(`**Structure:** ${e.structure.files} files, ${e.structure.packages} packages, ${Object.keys(e.structure.languages).length} languages`),e.entryPoints){const o=Object.entries(e.entryPoints.types).map(([i,l])=>`${l} ${i}`).join(", ");n.push(`**Entry Points:** ${e.entryPoints.total} (${o||"none"})`)}if(e.dependencies&&n.push(`**Dependencies:** ${e.dependencies.external} external, ${e.dependencies.internal} internal`),e.health&&n.push(`**Health:** ${e.health.score}/100 (${e.health.passed}\u2713 ${e.health.warned}\u26A0 ${e.health.failed}\u2717)`),e.deadSymbols&&n.push(`**Dead Symbols:** ${e.deadSymbols.source} in source (actionable), ${e.deadSymbols.docs} in docs`),e.typecheck){const o=e.typecheck.passed?"\u2713 passed":`\u2717 ${e.typecheck.errorCount} errors`;n.push(`**Typecheck:** ${o}`)}if(e.lint){const o=e.lint.passed?"\u2713 passed":`\u2717 ${e.lint.errorCount} errors`;n.push(`**Lint:** ${o}`)}if(e.recommendations.length>0){n.push(`
+import{check as e,summarizeCheckResult as t}from"./check.js";import{findDeadSymbols as n}from"./dead-symbols.js";import{health as r}from"./health.js";import{resolvePath as i}from"./path-resolver.js";import{errorResponse as a,okResponse as o}from"./response-envelope.js";import{DependencyAnalyzer as s,EntryPointAnalyzer as c,PatternAnalyzer as l,StructureAnalyzer as u}from"../../analyzers/dist/index.js";const d=[`structure`,`dependencies`,`patterns`,`health`,`dead_symbols`,`check`,`entry_points`];async function f(f,m,h={}){let g=Date.now(),_=i(h.path),v=h.checks??d,y=h.detail??`summary`,b=[],x={score:100,recommendations:b};try{let i=[];v.includes(`structure`)&&i.push((async()=>{let e=await new u().analyze(_,{format:`json`}),t=e.data;x.structure={files:t.stats?.totalFiles??e.meta.fileCount,packages:Array.isArray(t.packages)?t.packages.length:0,languages:t.stats?.languages??{}}})()),v.includes(`dependencies`)&&i.push((async()=>{let e=(await new s().analyze(_)).data,t=e.imports??[];x.dependencies={external:e.external?.length??t.filter(e=>e.isExternal).length,internal:e.internal?.length??t.filter(e=>!e.isExternal).length}})()),v.includes(`patterns`)&&i.push((async()=>{x.patterns=((await new l().analyze(_)).data.patterns??[]).map(e=>({name:e.pattern,confidence:e.confidence,count:e.locations.length}))})()),v.includes(`entry_points`)&&i.push((async()=>{let e=(await new c().analyze(_)).data,t=e.entryPoints??[],n={};for(let e of t)n[e.type]=(n[e.type]??0)+1;x.entryPoints={total:e.total??t.length,types:n}})()),v.includes(`health`)&&i.push((async()=>{let e=r(_);x.health={score:e.score,checks:e.checks.length,passed:e.checks.filter(e=>e.status===`pass`).length,warned:e.checks.filter(e=>e.status===`warn`).length,failed:e.checks.filter(e=>e.status===`fail`).length},e.score<70&&b.push({priority:`medium`,area:`health`,message:`Health score ${e.score}/100 — ${x.health.failed} failed checks`})})()),v.includes(`dead_symbols`)&&i.push((async()=>{let e=await n(m,f,{rootPath:_});x.deadSymbols={source:e.totalDeadSource,docs:e.totalDeadDocs},e.totalDeadSource>0&&b.push({priority:e.totalDeadSource>10?`high`:`medium`,area:`dead-code`,message:`${e.totalDeadSource} unused exports in source files`})})()),v.includes(`check`)&&i.push((async()=>{let n=t(await e({cwd:_}));x.typecheck={passed:n.tsc.passed,errorCount:n.tsc.errorCount,topErrors:n.tsc.topErrors},x.lint={passed:n.biome.passed,errorCount:n.biome.errorCount,topErrors:n.biome.topErrors},n.tsc.passed||b.push({priority:`high`,area:`type-safety`,message:`Fix ${n.tsc.errorCount} tsc error(s)`}),n.biome.passed||b.push({priority:`medium`,area:`lint`,message:`Fix ${n.biome.errorCount} lint error(s)`})})()),await Promise.all(i);let a=0;x.typecheck&&!x.typecheck.passed&&(a+=15),x.lint&&!x.lint.passed&&(a+=5),x.health&&x.health.score<80&&(a+=10),x.deadSymbols&&x.deadSymbols.source>10&&(a+=5),x.entryPoints&&x.entryPoints.total===0&&(a+=5),x.score=Math.max(0,100-a);let d={high:0,medium:1,low:2};b.sort((e,t)=>d[e.priority]-d[t.priority]);let h=p(x,y),S=[];return x.typecheck&&!x.typecheck.passed&&S.push({tool:`check`,reason:`Get full error details`,suggested_args:{detail:`errors`}}),x.deadSymbols&&x.deadSymbols.source>0&&S.push({tool:`dead_symbols`,reason:`See which exports are unused`,suggested_args:{root_path:_}}),o(`audit`,h,x,{durationMs:Date.now()-g,detail:y},S)}catch{return a(`audit`,{code:`ANALYSIS_FAILED`,category:`runtime`,retryable:!1,message:`Audit failed. Check server logs for details.`},Date.now()-g)}}function p(e,t){let n=[];if(n.push(`## Audit Report — Score: ${e.score}/100\n`),e.structure&&n.push(`**Structure:** ${e.structure.files} files, ${e.structure.packages} packages, ${Object.keys(e.structure.languages).length} languages`),e.entryPoints){let t=Object.entries(e.entryPoints.types).map(([e,t])=>`${t} ${e}`).join(`, `);n.push(`**Entry Points:** ${e.entryPoints.total} (${t||`none`})`)}if(e.dependencies&&n.push(`**Dependencies:** ${e.dependencies.external} external, ${e.dependencies.internal} internal`),e.health&&n.push(`**Health:** ${e.health.score}/100 (${e.health.passed}✓ ${e.health.warned}⚠ ${e.health.failed}✗)`),e.deadSymbols&&n.push(`**Dead Symbols:** ${e.deadSymbols.source} in source (actionable), ${e.deadSymbols.docs} in docs`),e.typecheck){let t=e.typecheck.passed?`✓ passed`:`✗ ${e.typecheck.errorCount} errors`;n.push(`**Typecheck:** ${t}`)}if(e.lint){let t=e.lint.passed?`✓ passed`:`✗ ${e.lint.errorCount} errors`;n.push(`**Lint:** ${t}`)}if(e.recommendations.length>0){n.push(`
 ### Recommendations
-`);for(const o of e.recommendations){const i=o.priority==="high"?"\u{1F534}":o.priority==="medium"?"\u{1F7E1}":"\u{1F7E2}";n.push(`${i} **${o.area}:** ${o.message}`)}}if(h==="full"&&e.patterns&&e.patterns.length>0){n.push(`
+`);for(let t of e.recommendations){let e=t.priority===`high`?`🔴`:t.priority===`medium`?`🟡`:`🟢`;n.push(`${e} **${t.area}:** ${t.message}`)}}if(t===`full`&&e.patterns&&e.patterns.length>0){n.push(`
 ### Patterns Detected
-`),n.push("| Pattern | Confidence | Count |"),n.push("|---------|-----------|-------|");for(const o of e.patterns)n.push(`| ${o.name} | ${o.confidence} | ${o.count} |`)}return n.join(`
-`)}export{B as audit};
+`),n.push(`| Pattern | Confidence | Count |`),n.push(`|---------|-----------|-------|`);for(let t of e.patterns)n.push(`| ${t.name} | ${t.confidence} | ${t.count} |`)}return n.join(`
+`)}export{f as audit};
+//# sourceMappingURL=audit.js.map

package/packages/tools/dist/batch.d.ts

@@ -1,21 +1,24 @@
-export interface BatchOperation {
-    /** Unique ID for this operation */
-    id: string;
-    /** Operation type */
-    type: string;
-    /** Arguments for the operation */
-    args: Record<string, unknown>;
+//#region packages/tools/src/batch.d.ts
+interface BatchOperation {
+  /** Unique ID for this operation */
+  id: string;
+  /** Operation type */
+  type: string;
+  /** Arguments for the operation */
+  args: Record<string, unknown>;
 }
-export interface BatchResult {
-    id: string;
-    status: 'success' | 'error';
-    result?: unknown;
-    error?: string;
-    durationMs: number;
+interface BatchResult {
+  id: string;
+  status: 'success' | 'error';
+  result?: unknown;
+  error?: string;
+  durationMs: number;
 }
-export interface BatchOptions {
-    /** Max concurrent operations (default: 4) */
-    concurrency?: number;
+interface BatchOptions {
+  /** Max concurrent operations (default: 4) */
+  concurrency?: number;
 }
-export declare function batch(operations: BatchOperation[], executor: (op: BatchOperation) => Promise<unknown>, options?: BatchOptions): Promise<BatchResult[]>;
+declare function batch(operations: BatchOperation[], executor: (op: BatchOperation) => Promise<unknown>, options?: BatchOptions): Promise<BatchResult[]>;
+//#endregion
+export { BatchOperation, BatchOptions, BatchResult, batch };
 //# sourceMappingURL=batch.d.ts.map

package/packages/tools/dist/batch.js

@@ -1 +1,2 @@
-async function h(o,a,c={}){const i=Math.max(1,c.concurrency??4),e=[],s=[...o];async function u(r){const n=Date.now();try{const t=await a(r);return{id:r.id,status:"success",result:t,durationMs:Date.now()-n}}catch(t){return{id:r.id,status:"error",error:t instanceof Error?t.message:String(t),durationMs:Date.now()-n}}}for(;s.length>0;){const r=s.splice(0,i),n=await Promise.allSettled(r.map(t=>u(t)));for(const t of n){if(t.status==="fulfilled"){e.push(t.value);continue}e.push({id:"unknown",status:"error",error:t.reason instanceof Error?t.reason.message:"Promise rejected",durationMs:0})}}return e}export{h as batch};
+async function e(e,t,n={}){let r=Math.max(1,n.concurrency??4),i=[],a=[...e];async function o(e){let n=Date.now();try{let r=await t(e);return{id:e.id,status:`success`,result:r,durationMs:Date.now()-n}}catch(t){return{id:e.id,status:`error`,error:t instanceof Error?t.message:String(t),durationMs:Date.now()-n}}}for(;a.length>0;){let e=a.splice(0,r),t=await Promise.allSettled(e.map(e=>o(e)));for(let e of t){if(e.status===`fulfilled`){i.push(e.value);continue}i.push({id:`unknown`,status:`error`,error:e.reason instanceof Error?e.reason.message:`Promise rejected`,durationMs:0})}}return i}export{e as batch};
+//# sourceMappingURL=batch.js.map

package/packages/tools/dist/changelog.d.ts

@@ -1,34 +1,37 @@
+//#region packages/tools/src/changelog.d.ts
 /**
  * kb_changelog — Generate a changelog from git history.
  */
-export type ChangelogFormat = 'grouped' | 'chronological' | 'per-scope';
-export interface ChangelogOptions {
-    from: string;
-    to?: string;
-    format?: ChangelogFormat;
-    includeBreaking?: boolean;
-    cwd?: string;
+type ChangelogFormat = 'grouped' | 'chronological' | 'per-scope';
+interface ChangelogOptions {
+  from: string;
+  to?: string;
+  format?: ChangelogFormat;
+  includeBreaking?: boolean;
+  cwd?: string;
 }
-export interface ChangelogEntry {
-    hash: string;
-    type: string;
-    scope: string;
-    subject: string;
-    body: string;
-    author: string;
-    date: string;
-    breaking: boolean;
+interface ChangelogEntry {
+  hash: string;
+  type: string;
+  scope: string;
+  subject: string;
+  body: string;
+  author: string;
+  date: string;
+  breaking: boolean;
 }
-export interface ChangelogResult {
-    entries: ChangelogEntry[];
-    markdown: string;
-    stats: {
-        total: number;
-        breaking: number;
-        types: Record<string, number>;
-    };
+interface ChangelogResult {
+  entries: ChangelogEntry[];
+  markdown: string;
+  stats: {
+    total: number;
+    breaking: number;
+    types: Record<string, number>;
+  };
 }
-export declare function changelog(options: ChangelogOptions): ChangelogResult;
+declare function changelog(options: ChangelogOptions): ChangelogResult;
 /** Exported for testing */
-export declare function formatChangelog(entries: ChangelogEntry[], format: ChangelogFormat, includeBreaking: boolean): string;
+declare function formatChangelog(entries: ChangelogEntry[], format: ChangelogFormat, includeBreaking: boolean): string;
+//#endregion
+export { ChangelogEntry, ChangelogFormat, ChangelogOptions, ChangelogResult, changelog, formatChangelog };
 //# sourceMappingURL=changelog.d.ts.map

package/packages/tools/dist/changelog.js

@@ -1,2 +1,3 @@
-import{execSync as E}from"node:child_process";const $=/^[a-zA-Z0-9_./\-~^@{}]+$/;function w(i){const{from:a,to:g="HEAD",format:r="grouped",includeBreaking:e=!0,cwd:t=process.cwd()}=i;if(!$.test(a))throw new Error(`Invalid git ref: ${a}`);if(!$.test(g))throw new Error(`Invalid git ref: ${g}`);const n="",o="",s=`%H${n}%s${n}%b${n}%an${n}%ai${o}`;let h;try{h=E(`git log "${a}..${g}" --format="${s}"`,{cwd:t,encoding:"utf8",maxBuffer:10*1024*1024})}catch{throw new Error(`Git log failed. Ensure "${a}" and "${g}" are valid refs.`)}const p=h.split(o).map(c=>c.trim()).filter(Boolean).map(c=>{const[m="",d="",b="",y="",C=""]=c.split(n),f=d.match(/^(\w+)(?:\(([^)]*)\))?(!)?:\s*(.+)/);return{hash:m.slice(0,8),type:f?.[1]??"other",scope:f?.[2]??"",subject:f?.[4]??d,body:b.trim(),author:y.trim(),date:C.trim().split(" ")[0],breaking:!!(f?.[3]||/BREAKING[\s-]CHANGE/i.test(b))}}),l={};let u=0;for(const c of p)l[c.type]=(l[c.type]??0)+1,c.breaking&&u++;return{entries:p,markdown:k(p,r,e),stats:{total:p.length,breaking:u,types:l}}}function k(i,a,g){const r=["# Changelog",""];if(g){const e=i.filter(t=>t.breaking);if(e.length>0){r.push("## Breaking Changes","");for(const t of e)r.push(`- ${t.subject} (${t.hash})`);r.push("")}}if(a==="grouped"){const e={};for(const o of i)e[o.type]||(e[o.type]=[]),e[o.type].push(o);const t=["feat","fix","refactor","perf","test","docs","chore"],n={feat:"Features",fix:"Bug Fixes",refactor:"Refactoring",perf:"Performance",test:"Tests",docs:"Documentation",chore:"Chores",other:"Other"};for(const o of[...t,...Object.keys(e).filter(s=>!t.includes(s))])if(e[o]?.length){r.push(`## ${n[o]??o}`,"");for(const s of e[o]){const h=s.scope?`**${s.scope}:** `:"";r.push(`- ${h}${s.subject} (${s.hash})`)}r.push("")}}else if(a==="chronological")for(const e of i){const t=e.scope?`(${e.scope}) `:"";r.push(`- \`${e.date}\` ${e.type}: ${t}${e.subject} (${e.hash})`)}else{const e={};for(const t of i){const n=t.scope||"general";e[n]||(e[n]=[]),e[n].push(t)}for(const[t,n]of Object.entries(e)){r.push(`## ${t}`,"");for(const o of n)r.push(`- ${o.type}: ${o.subject} (${o.hash})`);r.push("")}}return r.join(`
-`)}export{w as changelog,k as formatChangelog};
+import{execSync as e}from"node:child_process";const t=/^[a-zA-Z0-9_./\-~^@{}]+$/;function n(n){let{from:i,to:a=`HEAD`,format:o=`grouped`,includeBreaking:s=!0,cwd:c=process.cwd()}=n;if(!t.test(i))throw Error(`Invalid git ref: ${i}`);if(!t.test(a))throw Error(`Invalid git ref: ${a}`);let l;try{l=e(`git log "${i}..${a}" --format="%H%s%b%an%ai"`,{cwd:c,encoding:`utf8`,maxBuffer:10*1024*1024,timeout:3e4})}catch{throw Error(`Git log failed. Ensure "${i}" and "${a}" are valid refs.`)}let u=l.split(``).map(e=>e.trim()).filter(Boolean).map(e=>{let[t=``,n=``,r=``,i=``,a=``]=e.split(``),o=n.match(/^(\w+)(?:\(([^)]*)\))?(!)?:\s*(.+)/);return{hash:t.slice(0,8),type:o?.[1]??`other`,scope:o?.[2]??``,subject:o?.[4]??n,body:r.trim(),author:i.trim(),date:a.trim().split(` `)[0],breaking:!!(o?.[3]||/BREAKING[\s-]CHANGE/i.test(r))}}),d={},f=0;for(let e of u)d[e.type]=(d[e.type]??0)+1,e.breaking&&f++;return{entries:u,markdown:r(u,o,s),stats:{total:u.length,breaking:f,types:d}}}function r(e,t,n){let r=[`# Changelog`,``];if(n){let t=e.filter(e=>e.breaking);if(t.length>0){r.push(`## Breaking Changes`,``);for(let e of t)r.push(`- ${e.subject} (${e.hash})`);r.push(``)}}if(t===`grouped`){let t={};for(let n of e)t[n.type]||(t[n.type]=[]),t[n.type].push(n);let n=[`feat`,`fix`,`refactor`,`perf`,`test`,`docs`,`chore`],i={feat:`Features`,fix:`Bug Fixes`,refactor:`Refactoring`,perf:`Performance`,test:`Tests`,docs:`Documentation`,chore:`Chores`,other:`Other`};for(let e of[...n,...Object.keys(t).filter(e=>!n.includes(e))])if(t[e]?.length){r.push(`## ${i[e]??e}`,``);for(let n of t[e]){let e=n.scope?`**${n.scope}:** `:``;r.push(`- ${e}${n.subject} (${n.hash})`)}r.push(``)}}else if(t===`chronological`)for(let t of e){let e=t.scope?`(${t.scope}) `:``;r.push(`- \`${t.date}\` ${t.type}: ${e}${t.subject} (${t.hash})`)}else{let t={};for(let n of e){let e=n.scope||`general`;t[e]||(t[e]=[]),t[e].push(n)}for(let[e,n]of Object.entries(t)){r.push(`## ${e}`,``);for(let e of n)r.push(`- ${e.type}: ${e.subject} (${e.hash})`);r.push(``)}}return r.join(`
+`)}export{n as changelog,r as formatChangelog};
+//# sourceMappingURL=changelog.js.map