@vpxa/kb 0.1.13 → 0.1.16

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

@@ -1,50 +1,50 @@
-/**
- * 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>;
 }
-//# sourceMappingURL=store.interface.d.ts.map
+//#endregion
+export { IKnowledgeStore, SearchOptions };

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

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

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

@@ -1,66 +1,65 @@
-/**
- * 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>>;
-//# sourceMappingURL=audit.d.ts.map
+declare function audit(store: IKnowledgeStore, embedder: IEmbedder, options?: AuditOptions): Promise<KBResponse<AuditData>>;
+//#endregion
+export { AuditCheck, AuditData, AuditOptions, AuditRecommendation, audit };

package/packages/tools/dist/audit.js

@@ -1,7 +1,6 @@
-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};

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

@@ -1,21 +1,23 @@
-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[]>;
-//# sourceMappingURL=batch.d.ts.map
+declare function batch(operations: BatchOperation[], executor: (op: BatchOperation) => Promise<unknown>, options?: BatchOptions): Promise<BatchResult[]>;
+//#endregion
+export { BatchOperation, BatchOptions, BatchResult, batch };

package/packages/tools/dist/batch.js

@@ -1 +1 @@
-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};

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

@@ -1,34 +1,36 @@
+//#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;
-//# sourceMappingURL=changelog.d.ts.map
+declare function formatChangelog(entries: ChangelogEntry[], format: ChangelogFormat, includeBreaking: boolean): string;
+//#endregion
+export { ChangelogEntry, ChangelogFormat, ChangelogOptions, ChangelogResult, changelog, formatChangelog };

package/packages/tools/dist/changelog.js

@@ -1,2 +1,2 @@
-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{execFileSync 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};

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

@@ -1,45 +1,48 @@
-import { type ParsedError } from './parse-output.js';
-export interface CheckOptions {
-    /** Specific files to check (if empty, checks all) */
-    files?: string[];
-    /** Working directory */
-    cwd?: string;
-    /** Skip typecheck */
-    skipTypes?: boolean;
-    /** Skip lint */
-    skipLint?: boolean;
-    /** Detail level: summary (default, minimal), errors (parsed errors), full (includes raw) */
-    detail?: 'summary' | 'errors' | 'full';
+import { ParsedError } from "./parse-output.js";
+
+//#region packages/tools/src/check.d.ts
+interface CheckOptions {
+  /** Specific files to check (if empty, checks all) */
+  files?: string[];
+  /** Working directory */
+  cwd?: string;
+  /** Skip typecheck */
+  skipTypes?: boolean;
+  /** Skip lint */
+  skipLint?: boolean;
+  /** Detail level: summary (default, minimal), errors (parsed errors), full (includes raw) */
+  detail?: 'summary' | 'errors' | 'full';
 }
-export interface CheckSummaryResult {
+interface CheckSummaryResult {
+  passed: boolean;
+  tsc: {
     passed: boolean;
-    tsc: {
-        passed: boolean;
-        errorCount: number;
-        warningCount: number;
-        topErrors: string[];
-    };
-    biome: {
-        passed: boolean;
-        errorCount: number;
-        warningCount: number;
-        topErrors: string[];
-    };
+    errorCount: number;
+    warningCount: number;
+    topErrors: string[];
+  };
+  biome: {
+    passed: boolean;
+    errorCount: number;
+    warningCount: number;
+    topErrors: string[];
+  };
 }
-export interface CheckResult {
-    tsc: {
-        errors: ParsedError[];
-        passed: boolean;
-        raw?: string;
-    };
-    biome: {
-        errors: ParsedError[];
-        passed: boolean;
-        raw?: string;
-    };
+interface CheckResult {
+  tsc: {
+    errors: ParsedError[];
+    passed: boolean;
+    raw?: string;
+  };
+  biome: {
+    errors: ParsedError[];
     passed: boolean;
+    raw?: string;
+  };
+  passed: boolean;
 }
-export declare function check(options?: CheckOptions): Promise<CheckResult>;
+declare function check(options?: CheckOptions): Promise<CheckResult>;
 /** Produce a minimal summary for LLM consumption (~300 tokens) */
-export declare function summarizeCheckResult(result: CheckResult): CheckSummaryResult;
-//# sourceMappingURL=check.d.ts.map
+declare function summarizeCheckResult(result: CheckResult): CheckSummaryResult;
+//#endregion
+export { CheckOptions, CheckResult, CheckSummaryResult, check, summarizeCheckResult };

package/packages/tools/dist/check.js

@@ -1,2 +1,2 @@
-import{execFile as d}from"node:child_process";import{readFile as m}from"node:fs/promises";import{join as f}from"node:path";import{promisify as g}from"node:util";import{parseBiome as h,parseTsc as b}from"./parse-output.js";const c=g(d);function p(r){const o=r,t=o.stdout?.toString()??"",s=o.stderr?.toString()??"";return[t,s].filter(Boolean).join(`
-`).trim()||o.message||"Command failed"}async function R(r={}){const o=r.cwd??process.cwd(),t={errors:[],passed:!0,raw:""},s={errors:[],passed:!0,raw:""};if(!r.skipTypes)try{const n=f(o,"package.json");let l=!1;try{l=!!JSON.parse(await m(n,"utf-8")).scripts?.typecheck}catch{}if(l&&!r.files?.length)await c("npx",["turbo","run","typecheck"],{cwd:o,shell:!0});else{const i=["--noEmit"];r.files?.length&&i.push(...r.files),await c("npx",["tsc",...i],{cwd:o,shell:!0})}}catch(n){t.raw=p(n),t.errors=b(t.raw),t.passed=t.errors.length===0}if(!r.skipLint)try{const n=["check"];r.files?.length&&n.push(...r.files),await c("npx",["biome",...n],{cwd:o,shell:!0})}catch(n){s.raw=p(n),s.errors=h(s.raw),s.passed=s.errors.length===0}const a=r.detail??"full",e={tsc:t,biome:s,passed:t.passed&&s.passed};return a==="full"?e:a==="errors"?{tsc:{errors:t.errors,passed:t.passed},biome:{errors:s.errors,passed:s.passed},passed:e.passed}:e}const u=3;function x(r){const o=r.tsc.errors.filter(e=>e.severity==="error"),t=r.tsc.errors.filter(e=>e.severity==="warning"),s=r.biome.errors.filter(e=>e.severity==="error"),a=r.biome.errors.filter(e=>e.severity==="warning");return{passed:r.passed,tsc:{passed:r.tsc.passed,errorCount:o.length,warningCount:t.length,topErrors:o.slice(0,u).map(e=>`${e.file}:${e.line} \u2014 ${e.message}`)},biome:{passed:r.biome.passed,errorCount:s.length,warningCount:a.length,topErrors:s.slice(0,u).map(e=>`${e.file}:${e.line} \u2014 ${e.message}`)}}}export{R as check,x as summarizeCheckResult};
+import{parseBiome as e,parseTsc as t}from"./parse-output.js";import{exec as n}from"node:child_process";import{readFile as r}from"node:fs/promises";import{join as i}from"node:path";import{promisify as a}from"node:util";const o=a(n);let s=0;function c(e){let t=e;return[t.stdout?.toString()??``,t.stderr?.toString()??``].filter(Boolean).join(`
+`).trim()||t.message||`Command failed`}async function l(e={}){if(s>=2)throw Error(`Too many concurrent check runs (max 2). Try again later.`);s++;try{return await u(e)}finally{s--}}async function u(n){let a=n.cwd??process.cwd(),s={errors:[],passed:!0,raw:``},l={errors:[],passed:!0,raw:``};if(!n.skipTypes)try{let e=i(a,`package.json`),t=!1;try{t=!!JSON.parse(await r(e,`utf-8`)).scripts?.typecheck}catch{}if(t&&!n.files?.length)await o(`npx turbo run typecheck`,{cwd:a,timeout:12e4});else{let e=[`--noEmit`];n.files?.length&&e.push(...n.files),await o(`npx tsc ${e.join(` `)}`,{cwd:a,timeout:12e4})}}catch(e){s.raw=c(e),s.errors=t(s.raw),s.passed=s.errors.length===0}if(!n.skipLint)try{let e=[`check`];n.files?.length&&e.push(...n.files),await o(`npx biome ${e.join(` `)}`,{cwd:a,timeout:12e4})}catch(t){l.raw=c(t),l.errors=e(l.raw),l.passed=l.errors.length===0}let u=n.detail??`full`,d={tsc:s,biome:l,passed:s.passed&&l.passed};return u===`full`?d:u===`errors`?{tsc:{errors:s.errors,passed:s.passed},biome:{errors:l.errors,passed:l.passed},passed:d.passed}:d}function d(e){let t=e.tsc.errors.filter(e=>e.severity===`error`),n=e.tsc.errors.filter(e=>e.severity===`warning`),r=e.biome.errors.filter(e=>e.severity===`error`),i=e.biome.errors.filter(e=>e.severity===`warning`);return{passed:e.passed,tsc:{passed:e.tsc.passed,errorCount:t.length,warningCount:n.length,topErrors:t.slice(0,3).map(e=>`${e.file}:${e.line} — ${e.message}`)},biome:{passed:e.biome.passed,errorCount:r.length,warningCount:i.length,topErrors:r.slice(0,3).map(e=>`${e.file}:${e.line} — ${e.message}`)}}}export{l as check,d as summarizeCheckResult};

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

@@ -1,17 +1,19 @@
-export interface Checkpoint {
-    id: string;
-    label: string;
-    createdAt: string;
-    data: Record<string, unknown>;
-    files?: string[];
-    notes?: string;
+//#region packages/tools/src/checkpoint.d.ts
+interface Checkpoint {
+  id: string;
+  label: string;
+  createdAt: string;
+  data: Record<string, unknown>;
+  files?: string[];
+  notes?: string;
 }
-export declare function checkpointSave(label: string, data: Record<string, unknown>, options?: {
-    files?: string[];
-    notes?: string;
-    cwd?: string;
+declare function checkpointSave(label: string, data: Record<string, unknown>, options?: {
+  files?: string[];
+  notes?: string;
+  cwd?: string;
 }): Checkpoint;
-export declare function checkpointLoad(id: string, cwd?: string): Checkpoint | undefined;
-export declare function checkpointList(cwd?: string): Checkpoint[];
-export declare function checkpointLatest(cwd?: string): Checkpoint | undefined;
-//# sourceMappingURL=checkpoint.d.ts.map
+declare function checkpointLoad(id: string, cwd?: string): Checkpoint | undefined;
+declare function checkpointList(cwd?: string): Checkpoint[];
+declare function checkpointLatest(cwd?: string): Checkpoint | undefined;
+//#endregion
+export { Checkpoint, checkpointLatest, checkpointList, checkpointLoad, checkpointSave };

package/packages/tools/dist/checkpoint.js

@@ -1,2 +1 @@
-import{existsSync as s,mkdirSync as d,readdirSync as f,readFileSync as a,writeFileSync as u}from"node:fs";import{resolve as i}from"node:path";const g=".kb-state/checkpoints";function o(n){const e=n??process.cwd(),t=i(e,g);return s(t)||d(t,{recursive:!0}),t}function C(n,e,t){const r=n.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")||"checkpoint",c={id:`${Date.now()}-${r}`,label:n,createdAt:new Date().toISOString(),data:e,files:t?.files,notes:t?.notes},p=i(o(t?.cwd),`${c.id}.json`);return u(p,`${JSON.stringify(c,null,2)}
-`,"utf-8"),c}function S(n,e){const t=i(o(e),`${n}.json`);if(s(t))return JSON.parse(a(t,"utf-8"))}function k(n){const e=o(n);return f(e).filter(t=>t.endsWith(".json")).map(t=>JSON.parse(a(i(e,t),"utf-8"))).sort((t,r)=>r.createdAt.localeCompare(t.createdAt))}function w(n){return k(n)[0]}export{w as checkpointLatest,k as checkpointList,S as checkpointLoad,C as checkpointSave};
+import{resolve as e}from"node:path";import{existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,writeFileSync as a}from"node:fs";import{KB_PATHS as o}from"../../core/dist/index.js";const s=`${o.state}/checkpoints`;function c(r){let i=e(r??process.cwd(),s);return t(i)||n(i,{recursive:!0}),i}function l(t,n,r){let i=t.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-|-$/g,``)||`checkpoint`,o={id:`${Date.now()}-${i}`,label:t,createdAt:new Date().toISOString(),data:n,files:r?.files,notes:r?.notes};return a(e(c(r?.cwd),`${o.id}.json`),`${JSON.stringify(o,null,2)}\n`,`utf-8`),o}function u(n,i){let a=e(c(i),`${n}.json`);if(t(a))try{return JSON.parse(r(a,`utf-8`))}catch{return}}function d(t){let n=c(t);return i(n).filter(e=>e.endsWith(`.json`)).flatMap(t=>{try{return[JSON.parse(r(e(n,t),`utf-8`))]}catch{return[]}}).sort((e,t)=>t.createdAt.localeCompare(e.createdAt))}function f(e){return d(e)[0]}export{f as checkpointLatest,d as checkpointList,u as checkpointLoad,l as checkpointSave};