@vpxa/kb 0.1.13 → 0.1.16

package/packages/cli/dist/kb-init.js

@@ -1 +1 @@
-import{existsSync as d,readFileSync as g}from"node:fs";import{dirname as p,resolve as o}from"node:path";import{initializeTreeSitter as m}from"../../chunker/dist/index.js";import{OnnxEmbedder as l}from"../../embeddings/dist/index.js";import{IncrementalIndexer as u}from"../../indexer/dist/index.js";import{createStore as f,SqliteGraphStore as h}from"../../store/dist/index.js";function y(){const t=process.env.KB_CONFIG_PATH??(d(o(process.cwd(),"kb.config.json"))?o(process.cwd(),"kb.config.json"):null);t||(console.error("No kb.config.json found in current directory."),console.error("Run `kb init` to create one, or set KB_CONFIG_PATH."),process.exit(1));const r=g(t,"utf-8"),e=JSON.parse(r),n=p(t);return e.sources=e.sources.map(s=>({...s,path:o(n,s.path)})),e.store.path=o(n,e.store.path),e.curated=e.curated??{path:"curated"},e.curated.path=o(n,e.curated.path),e}async function x(){const t=y(),r=new l({model:t.embedding.model,dimensions:t.embedding.dimensions});await r.initialize();const e=await f({backend:t.store.backend,path:t.store.path});await e.initialize();const n=new u(r,e),{CuratedKnowledgeManager:s}=await import("../../server/dist/curated-manager.js"),c=new s(t.curated.path,e,r);let i;try{const a=new h({path:t.store.path});await a.initialize(),i=a,n.setGraphStore(i)}catch(a){console.error(`[kb] Graph store init failed (non-fatal): ${a.message}`),i={initialize:async()=>{},upsertNode:async()=>{},upsertEdge:async()=>{},upsertNodes:async()=>{},upsertEdges:async()=>{},getNode:async()=>null,getNeighbors:async()=>({nodes:[],edges:[]}),traverse:async()=>({nodes:[],edges:[]}),findNodes:async()=>[],findEdges:async()=>[],deleteNode:async()=>{},deleteBySourcePath:async()=>0,clear:async()=>{},getStats:async()=>({nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}}),close:async()=>{}}}return await m().catch(()=>{}),{config:t,embedder:r,store:e,graphStore:i,indexer:n,curated:c}}export{x as initKB};
+import{existsSync as e,readFileSync as t}from"node:fs";import{dirname as n,resolve as r}from"node:path";import{initializeWasm as i}from"../../chunker/dist/index.js";import{OnnxEmbedder as a}from"../../embeddings/dist/index.js";import{IncrementalIndexer as o}from"../../indexer/dist/index.js";import{SqliteGraphStore as s,createStore as c}from"../../store/dist/index.js";function l(){let i=process.env.KB_CONFIG_PATH??(e(r(process.cwd(),`kb.config.json`))?r(process.cwd(),`kb.config.json`):null);i||(console.error(`No kb.config.json found in current directory.`),console.error("Run `kb init` to create one, or set KB_CONFIG_PATH."),process.exit(1));let a=t(i,`utf-8`),o;try{o=JSON.parse(a)}catch{console.error(`Failed to parse ${i} as JSON. Ensure the file contains valid JSON.`),process.exit(1)}let s=n(i);return o.sources=o.sources.map(e=>({...e,path:r(s,e.path)})),o.store.path=r(s,o.store.path),o.curated=o.curated??{path:`curated`},o.curated.path=r(s,o.curated.path),o}async function u(){let e=l(),t=new a({model:e.embedding.model,dimensions:e.embedding.dimensions});await t.initialize();let n=await c({backend:e.store.backend,path:e.store.path});await n.initialize();let r=new o(t,n),{CuratedKnowledgeManager:u}=await import(`../../server/dist/curated-manager.js`),d=new u(e.curated.path,n,t),f;try{let t=new s({path:e.store.path});await t.initialize(),f=t,r.setGraphStore(f)}catch(e){console.error(`[kb] Graph store init failed (non-fatal): ${e.message}`),f={initialize:async()=>{},upsertNode:async()=>{},upsertEdge:async()=>{},upsertNodes:async()=>{},upsertEdges:async()=>{},getNode:async()=>null,getNeighbors:async()=>({nodes:[],edges:[]}),traverse:async()=>({nodes:[],edges:[]}),findNodes:async()=>[],findEdges:async()=>[],deleteNode:async()=>{},deleteBySourcePath:async()=>0,clear:async()=>{},getStats:async()=>({nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}}),close:async()=>{}}}return await i().catch(()=>{}),{config:e,embedder:t,store:n,graphStore:f,indexer:r,curated:d}}export{u as initKB};

package/packages/cli/dist/types.d.ts

@@ -1,7 +1,9 @@
-export interface Command {
-    name: string;
-    description: string;
-    usage?: string;
-    run: (args: string[]) => Promise<void>;
+//#region packages/cli/src/types.d.ts
+interface Command {
+  name: string;
+  description: string;
+  usage?: string;
+  run: (args: string[]) => Promise<void>;
 }
-//# sourceMappingURL=types.d.ts.map
+//#endregion
+export { Command };

package/packages/cli/dist/types.js

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

package/packages/core/dist/constants.d.ts

@@ -1,49 +1,73 @@
+//#region packages/core/src/constants.d.ts
 /**
  * Default constants for the Knowledge Base system.
  */
+/**
+ * Centralized directory paths for all KB artifacts.
+ * Single source of truth — change here to update everywhere.
+ */
+declare const KB_PATHS: {
+  /** AI artifacts root directory */readonly ai: ".ai"; /** Onboard / produce_knowledge output directory */
+  readonly aiKb: ".ai/kb"; /** Curated knowledge directory */
+  readonly aiCurated: ".ai/curated"; /** Vector store + graph data */
+  readonly data: ".kb-data"; /** Session state (stash, lanes, checkpoints, worksets, queues, replay, evidence-maps, snippets) */
+  readonly state: ".kb-state"; /** Persistent warn/error logs for dogfooding review */
+  readonly logs: ".kb-state/logs"; /** Brainstorming sessions */
+  readonly brainstorm: ".brainstorm"; /** Session handoff documents */
+  readonly handoffs: ".handoffs";
+};
+/**
+ * Global-mode directory paths (under ~/.kb-data/).
+ * Used when KB is installed at user level rather than per-workspace.
+ */
+declare const KB_GLOBAL_PATHS: {
+  /** Root directory name for global data store */readonly root: ".kb-data"; /** Registry file tracking all enrolled workspaces */
+  readonly registry: "registry.json";
+};
 /** Default chunk sizes by content type */
-export declare const CHUNK_SIZES: {
-    readonly markdown: {
-        readonly max: 1500;
-        readonly min: 100;
-    };
-    readonly code: {
-        readonly max: 2000;
-        readonly min: 50;
-    };
-    readonly config: {
-        readonly max: 3000;
-        readonly min: 50;
-    };
-    readonly default: {
-        readonly max: 1500;
-        readonly min: 100;
-        readonly overlap: 200;
-    };
+declare const CHUNK_SIZES: {
+  readonly markdown: {
+    readonly max: 1500;
+    readonly min: 100;
+  };
+  readonly code: {
+    readonly max: 2000;
+    readonly min: 50;
+  };
+  readonly config: {
+    readonly max: 3000;
+    readonly min: 50;
+  };
+  readonly default: {
+    readonly max: 1500;
+    readonly min: 100;
+    readonly overlap: 200;
+  };
 };
 /** Default embedding config */
-export declare const EMBEDDING_DEFAULTS: {
-    readonly model: "mixedbread-ai/mxbai-embed-large-v1";
-    readonly dimensions: 1024;
+declare const EMBEDDING_DEFAULTS: {
+  readonly model: "mixedbread-ai/mxbai-embed-large-v1";
+  readonly dimensions: 1024;
 };
 /** Default store config */
-export declare const STORE_DEFAULTS: {
-    readonly backend: "lancedb";
-    readonly path: ".kb-data";
-    readonly tableName: "knowledge";
+declare const STORE_DEFAULTS: {
+  readonly backend: "lancedb";
+  readonly path: ".kb-data";
+  readonly tableName: "knowledge";
 };
 /** File size limits */
-export declare const FILE_LIMITS: {
-    readonly maxFileSizeBytes: 1000000;
-    readonly maxCuratedFileSizeBytes: 50000;
+declare const FILE_LIMITS: {
+  readonly maxFileSizeBytes: 1000000;
+  readonly maxCuratedFileSizeBytes: 50000;
 };
 /** Search defaults */
-export declare const SEARCH_DEFAULTS: {
-    readonly maxResults: 10;
-    readonly minScore: 0.25;
+declare const SEARCH_DEFAULTS: {
+  readonly maxResults: 10;
+  readonly minScore: 0.25;
 };
 /** Category validation regex */
-export declare const CATEGORY_PATTERN: RegExp;
+declare const CATEGORY_PATTERN: RegExp;
 /** Default knowledge categories */
-export declare const DEFAULT_CATEGORIES: readonly ["decisions", "patterns", "troubleshooting", "conventions", "architecture"];
-//# sourceMappingURL=constants.d.ts.map
+declare const DEFAULT_CATEGORIES: readonly ["decisions", "patterns", "troubleshooting", "conventions", "architecture"];
+//#endregion
+export { CATEGORY_PATTERN, CHUNK_SIZES, DEFAULT_CATEGORIES, EMBEDDING_DEFAULTS, FILE_LIMITS, KB_GLOBAL_PATHS, KB_PATHS, SEARCH_DEFAULTS, STORE_DEFAULTS };

package/packages/core/dist/constants.js

@@ -1 +1 @@
-const e={markdown:{max:1500,min:100},code:{max:2e3,min:50},config:{max:3e3,min:50},default:{max:1500,min:100,overlap:200}},t={model:"mixedbread-ai/mxbai-embed-large-v1",dimensions:1024},o={backend:"lancedb",path:".kb-data",tableName:"knowledge"},a={maxFileSizeBytes:1e6,maxCuratedFileSizeBytes:5e4},n={maxResults:10,minScore:.25},s=/^[a-z][a-z0-9-]*$/,c=["decisions","patterns","troubleshooting","conventions","architecture"];export{s as CATEGORY_PATTERN,e as CHUNK_SIZES,c as DEFAULT_CATEGORIES,t as EMBEDDING_DEFAULTS,a as FILE_LIMITS,n as SEARCH_DEFAULTS,o as STORE_DEFAULTS};
+const e={ai:`.ai`,aiKb:`.ai/kb`,aiCurated:`.ai/curated`,data:`.kb-data`,state:`.kb-state`,logs:`.kb-state/logs`,brainstorm:`.brainstorm`,handoffs:`.handoffs`},t={root:`.kb-data`,registry:`registry.json`},n={markdown:{max:1500,min:100},code:{max:2e3,min:50},config:{max:3e3,min:50},default:{max:1500,min:100,overlap:200}},r={model:`mixedbread-ai/mxbai-embed-large-v1`,dimensions:1024},i={backend:`lancedb`,path:e.data,tableName:`knowledge`},a={maxFileSizeBytes:1e6,maxCuratedFileSizeBytes:5e4},o={maxResults:10,minScore:.25},s=/^[a-z][a-z0-9-]*$/,c=[`decisions`,`patterns`,`troubleshooting`,`conventions`,`architecture`];export{s as CATEGORY_PATTERN,n as CHUNK_SIZES,c as DEFAULT_CATEGORIES,r as EMBEDDING_DEFAULTS,a as FILE_LIMITS,t as KB_GLOBAL_PATHS,e as KB_PATHS,o as SEARCH_DEFAULTS,i as STORE_DEFAULTS};

package/packages/core/dist/content-detector.d.ts

@@ -1,13 +1,13 @@
-/**
- * Detects content type from file path and extension.
- */
-import type { ContentType, SourceType } from './types.js';
+import { ContentType, SourceType } from "./types.js";
+
+//#region packages/core/src/content-detector.d.ts
 /**
  * Detect the content type of a file based on its path.
  */
-export declare function detectContentType(filePath: string): ContentType;
+declare function detectContentType(filePath: string): ContentType;
 /** Derive the coarse SourceType from a ContentType. */
-export declare function contentTypeToSourceType(ct: ContentType): SourceType;
+declare function contentTypeToSourceType(ct: ContentType): SourceType;
 /** Get all ContentTypes that belong to a given SourceType. */
-export declare function sourceTypeContentTypes(st: SourceType): ContentType[];
-//# sourceMappingURL=content-detector.d.ts.map
+declare function sourceTypeContentTypes(st: SourceType): ContentType[];
+//#endregion
+export { contentTypeToSourceType, detectContentType, sourceTypeContentTypes };

package/packages/core/dist/content-detector.js

@@ -1 +1 @@
-import{basename as r,extname as p}from"node:path";const n={".ts":"code-typescript",".tsx":"code-typescript",".mts":"code-typescript",".cts":"code-typescript",".js":"code-javascript",".jsx":"code-javascript",".mjs":"code-javascript",".cjs":"code-javascript",".py":"code-python",".json":"config-json",".yaml":"config-yaml",".yml":"config-yaml",".toml":"config-toml",".env":"config-env",".md":"markdown",".mdx":"markdown"},i=[/\.test\.[jt]sx?$/,/\.spec\.[jt]sx?$/,/(^|\/)__tests__\//,/(^|\/)test\//,/(^|\/)tests\//,/(^|\/)spec\//,/(^|\/)fixtures\//],d=[/\.stack\.[jt]s$/,/(^|\/)stacks\//,/(^|\/)constructs\//,/cdk\.json$/];function m(e){const t=p(e).toLowerCase(),s=r(e).toLowerCase();return e.includes("curated/")?"curated-knowledge":i.some(o=>o.test(e))?"test-code":d.some(o=>o.test(e))?"cdk-stack":t in n?n[t]:s.startsWith(".env")?"config-env":[".go",".rs",".java",".rb",".php",".sh",".ps1",".sql",".graphql",".proto",".css",".scss",".less",".html",".htm",".vue",".svelte",".astro",".hbs",".ejs",".svg"].includes(t)?"code-other":"unknown"}const c={"code-typescript":"source","code-javascript":"source","code-python":"source","code-other":"source","cdk-stack":"source","test-code":"test",markdown:"documentation",documentation:"documentation","curated-knowledge":"documentation","produced-knowledge":"documentation","config-json":"config","config-yaml":"config","config-toml":"config","config-env":"config",unknown:"source"};function y(e){return c[e]??"source"}function T(e){return Object.entries(c).filter(([,t])=>t===e).map(([t])=>t)}export{y as contentTypeToSourceType,m as detectContentType,T as sourceTypeContentTypes};
+import{KB_PATHS as e}from"./constants.js";import{basename as t,extname as n}from"node:path";const r={".ts":`code-typescript`,".tsx":`code-typescript`,".mts":`code-typescript`,".cts":`code-typescript`,".js":`code-javascript`,".jsx":`code-javascript`,".mjs":`code-javascript`,".cjs":`code-javascript`,".py":`code-python`,".json":`config-json`,".yaml":`config-yaml`,".yml":`config-yaml`,".toml":`config-toml`,".env":`config-env`,".md":`markdown`,".mdx":`markdown`},i=[/\.test\.[jt]sx?$/,/\.spec\.[jt]sx?$/,/(^|\/)__tests__\//,/(^|\/)test\//,/(^|\/)tests\//,/(^|\/)spec\//,/(^|\/)fixtures\//],a=[/\.stack\.[jt]s$/,/(^|\/)stacks\//,/(^|\/)constructs\//,/cdk\.json$/];function o(o){let s=n(o).toLowerCase(),c=t(o).toLowerCase();return o.includes(`${e.aiKb}/`)?`produced-knowledge`:o.includes(`${e.aiCurated}/`)?`curated-knowledge`:i.some(e=>e.test(o))?`test-code`:a.some(e=>e.test(o))?`cdk-stack`:s in r?r[s]:c.startsWith(`.env`)?`config-env`:[`.go`,`.rs`,`.java`,`.rb`,`.php`,`.sh`,`.ps1`,`.sql`,`.graphql`,`.proto`,`.css`,`.scss`,`.less`,`.html`,`.htm`,`.vue`,`.svelte`,`.astro`,`.hbs`,`.ejs`,`.svg`].includes(s)?`code-other`:`unknown`}const s={"code-typescript":`source`,"code-javascript":`source`,"code-python":`source`,"code-other":`source`,"cdk-stack":`source`,"test-code":`test`,markdown:`documentation`,documentation:`documentation`,"curated-knowledge":`documentation`,"produced-knowledge":`documentation`,"config-json":`config`,"config-yaml":`config`,"config-toml":`config`,"config-env":`config`,unknown:`source`};function c(e){return s[e]??`source`}function l(e){return Object.entries(s).filter(([,t])=>t===e).map(([e])=>e)}export{c as contentTypeToSourceType,o as detectContentType,l as sourceTypeContentTypes};

package/packages/core/dist/errors.d.ts

@@ -1,18 +1,20 @@
-export declare class KBError extends Error {
-    readonly code: string;
-    readonly cause?: unknown | undefined;
-    constructor(message: string, code: string, cause?: unknown | undefined);
+//#region packages/core/src/errors.d.ts
+declare class KBError extends Error {
+  readonly code: string;
+  readonly cause?: unknown | undefined;
+  constructor(message: string, code: string, cause?: unknown | undefined);
 }
-export declare class EmbeddingError extends KBError {
-    constructor(message: string, cause?: unknown);
+declare class EmbeddingError extends KBError {
+  constructor(message: string, cause?: unknown);
 }
-export declare class StoreError extends KBError {
-    constructor(message: string, cause?: unknown);
+declare class StoreError extends KBError {
+  constructor(message: string, cause?: unknown);
 }
-export declare class IndexError extends KBError {
-    constructor(message: string, cause?: unknown);
+declare class IndexError extends KBError {
+  constructor(message: string, cause?: unknown);
 }
-export declare class ConfigError extends KBError {
-    constructor(message: string, cause?: unknown);
+declare class ConfigError extends KBError {
+  constructor(message: string, cause?: unknown);
 }
-//# sourceMappingURL=errors.d.ts.map
+//#endregion
+export { ConfigError, EmbeddingError, IndexError, KBError, StoreError };

package/packages/core/dist/errors.js

@@ -1 +1 @@
-class s extends Error{constructor(r,e,t){super(r);this.code=e;this.cause=t;this.name="KBError"}}class E extends s{constructor(n,r){super(n,"EMBEDDING_ERROR",r),this.name="EmbeddingError"}}class c extends s{constructor(n,r){super(n,"STORE_ERROR",r),this.name="StoreError"}}class u extends s{constructor(n,r){super(n,"INDEX_ERROR",r),this.name="IndexError"}}class i extends s{constructor(n,r){super(n,"CONFIG_ERROR",r),this.name="ConfigError"}}export{i as ConfigError,E as EmbeddingError,u as IndexError,s as KBError,c as StoreError};
+var e=class extends Error{constructor(e,t,n){super(e),this.code=t,this.cause=n,this.name=`KBError`}},t=class extends e{constructor(e,t){super(e,`EMBEDDING_ERROR`,t),this.name=`EmbeddingError`}},n=class extends e{constructor(e,t){super(e,`STORE_ERROR`,t),this.name=`StoreError`}},r=class extends e{constructor(e,t){super(e,`INDEX_ERROR`,t),this.name=`IndexError`}},i=class extends e{constructor(e,t){super(e,`CONFIG_ERROR`,t),this.name=`ConfigError`}};export{i as ConfigError,t as EmbeddingError,r as IndexError,e as KBError,n as StoreError};

package/packages/core/dist/global-registry.d.ts

@@ -0,0 +1,62 @@
+//#region packages/core/src/global-registry.d.ts
+/**
+ * Global registry for tracking workspaces enrolled in global MCP install mode.
+ * Registry lives at ~/.kb-data/registry.json alongside per-workspace partition directories.
+ */
+/** A single workspace entry in the global registry. */
+interface RegistryEntry {
+  /** Partition key: <folder-name>-<sha256-8chars> */
+  partition: string;
+  /** Absolute path to workspace root */
+  workspacePath: string;
+  /** ISO timestamp of first registration */
+  registeredAt: string;
+  /** ISO timestamp of last server start */
+  lastAccessedAt: string;
+}
+/** Schema for ~/.kb-data/registry.json */
+interface GlobalRegistry {
+  version: 1;
+  workspaces: Record<string, RegistryEntry>;
+}
+/**
+ * Get the global data directory root.
+ * Override with `KB_GLOBAL_DATA_DIR` env var for testing.
+ */
+declare function getGlobalDataDir(): string;
+/**
+ * Compute a deterministic partition key from a workspace path.
+ * Format: <folder-basename>-<sha256(absolutePath)-first8hex>
+ */
+declare function computePartitionKey(cwd: string): string;
+/**
+ * Load the global registry. Returns empty registry if file doesn't exist.
+ */
+declare function loadRegistry(): GlobalRegistry;
+/**
+ * Save the global registry atomically (write to .tmp then rename).
+ */
+declare function saveRegistry(registry: GlobalRegistry): void;
+/**
+ * Register a workspace in the global registry. Creates partition directory.
+ * If already registered, updates lastAccessedAt.
+ */
+declare function registerWorkspace(cwd: string): RegistryEntry;
+/**
+ * Look up a workspace in the registry by cwd.
+ */
+declare function lookupWorkspace(cwd: string): RegistryEntry | undefined;
+/**
+ * List all registered workspaces.
+ */
+declare function listWorkspaces(): RegistryEntry[];
+/**
+ * Get the absolute path to a partition's data directory.
+ */
+declare function getPartitionDir(partition: string): string;
+/**
+ * Check whether global mode is installed (registry.json exists in ~/.kb-data/).
+ */
+declare function isGlobalInstalled(): boolean;
+//#endregion
+export { GlobalRegistry, RegistryEntry, computePartitionKey, getGlobalDataDir, getPartitionDir, isGlobalInstalled, listWorkspaces, loadRegistry, lookupWorkspace, registerWorkspace, saveRegistry };

package/packages/core/dist/global-registry.js

@@ -0,0 +1 @@
+import{KB_GLOBAL_PATHS as e}from"./constants.js";import{basename as t,resolve as n}from"node:path";import{createHash as r}from"node:crypto";import{existsSync as i,mkdirSync as a,readFileSync as o,renameSync as s,writeFileSync as c}from"node:fs";import{homedir as l}from"node:os";function u(){return process.env.KB_GLOBAL_DATA_DIR??n(l(),e.root)}function d(e){let i=n(e);return`${t(i).toLowerCase().replace(/[^a-z0-9-]/g,`-`)||`workspace`}-${r(`sha256`).update(i).digest(`hex`).slice(0,8)}`}function f(){let t=n(u(),e.registry);if(!i(t))return{version:1,workspaces:{}};let r=o(t,`utf-8`);return JSON.parse(r)}function p(t){let r=u();a(r,{recursive:!0});let i=n(r,e.registry),o=`${i}.tmp`;c(o,JSON.stringify(t,null,2),`utf-8`),s(o,i)}function m(e){let t=f(),r=d(e),i=new Date().toISOString();return t.workspaces[r]?t.workspaces[r].lastAccessedAt=i:t.workspaces[r]={partition:r,workspacePath:n(e),registeredAt:i,lastAccessedAt:i},a(_(r),{recursive:!0}),p(t),t.workspaces[r]}function h(e){let t=f(),n=d(e);return t.workspaces[n]}function g(){let e=f();return Object.values(e.workspaces)}function _(e){return n(u(),e)}function v(){return i(n(u(),e.registry))}export{d as computePartitionKey,u as getGlobalDataDir,_ as getPartitionDir,v as isGlobalInstalled,g as listWorkspaces,f as loadRegistry,h as lookupWorkspace,m as registerWorkspace,p as saveRegistry};

package/packages/core/dist/index.d.ts

@@ -1,6 +1,7 @@
-export * from './constants.js';
-export { contentTypeToSourceType, detectContentType, sourceTypeContentTypes, } from './content-detector.js';
-export * from './errors.js';
-export * from './logger.js';
-export * from './types.js';
-//# sourceMappingURL=index.d.ts.map
+import { CATEGORY_PATTERN, CHUNK_SIZES, DEFAULT_CATEGORIES, EMBEDDING_DEFAULTS, FILE_LIMITS, KB_GLOBAL_PATHS, KB_PATHS, SEARCH_DEFAULTS, STORE_DEFAULTS } from "./constants.js";
+import { CONTENT_TYPES, ChunkMetadata, ContentType, IndexStats, KBConfig, KNOWLEDGE_ORIGINS, KnowledgeOrigin, KnowledgeRecord, RawChunk, SOURCE_TYPES, SearchResult, SourceType } from "./types.js";
+import { contentTypeToSourceType, detectContentType, sourceTypeContentTypes } from "./content-detector.js";
+import { ConfigError, EmbeddingError, IndexError, KBError, StoreError } from "./errors.js";
+import { GlobalRegistry, RegistryEntry, computePartitionKey, getGlobalDataDir, getPartitionDir, isGlobalInstalled, listWorkspaces, loadRegistry, lookupWorkspace, registerWorkspace, saveRegistry } from "./global-registry.js";
+import { LogLevel, createLogger, getLogLevel, resetLogDir, serializeError, setFileSinkEnabled, setLogLevel } from "./logger.js";
+export { CATEGORY_PATTERN, CHUNK_SIZES, CONTENT_TYPES, ChunkMetadata, ConfigError, ContentType, DEFAULT_CATEGORIES, EMBEDDING_DEFAULTS, EmbeddingError, FILE_LIMITS, GlobalRegistry, IndexError, IndexStats, KBConfig, KBError, KB_GLOBAL_PATHS, KB_PATHS, KNOWLEDGE_ORIGINS, KnowledgeOrigin, KnowledgeRecord, LogLevel, RawChunk, RegistryEntry, SEARCH_DEFAULTS, SOURCE_TYPES, STORE_DEFAULTS, SearchResult, SourceType, StoreError, computePartitionKey, contentTypeToSourceType, createLogger, detectContentType, getGlobalDataDir, getLogLevel, getPartitionDir, isGlobalInstalled, listWorkspaces, loadRegistry, lookupWorkspace, registerWorkspace, resetLogDir, saveRegistry, serializeError, setFileSinkEnabled, setLogLevel, sourceTypeContentTypes };

package/packages/core/dist/index.js

@@ -1 +1 @@
-export*from"./constants.js";import{contentTypeToSourceType as r,detectContentType as p,sourceTypeContentTypes as n}from"./content-detector.js";export*from"./errors.js";export*from"./logger.js";export*from"./types.js";export{r as contentTypeToSourceType,p as detectContentType,n as sourceTypeContentTypes};
+import{CATEGORY_PATTERN as e,CHUNK_SIZES as t,DEFAULT_CATEGORIES as n,EMBEDDING_DEFAULTS as r,FILE_LIMITS as i,KB_GLOBAL_PATHS as a,KB_PATHS as o,SEARCH_DEFAULTS as s,STORE_DEFAULTS as c}from"./constants.js";import{contentTypeToSourceType as l,detectContentType as u,sourceTypeContentTypes as d}from"./content-detector.js";import{ConfigError as f,EmbeddingError as p,IndexError as m,KBError as h,StoreError as g}from"./errors.js";import{computePartitionKey as _,getGlobalDataDir as v,getPartitionDir as y,isGlobalInstalled as b,listWorkspaces as x,loadRegistry as S,lookupWorkspace as C,registerWorkspace as w,saveRegistry as T}from"./global-registry.js";import{createLogger as E,getLogLevel as D,resetLogDir as O,serializeError as k,setFileSinkEnabled as A,setLogLevel as j}from"./logger.js";import{CONTENT_TYPES as M,KNOWLEDGE_ORIGINS as N,SOURCE_TYPES as P}from"./types.js";export{e as CATEGORY_PATTERN,t as CHUNK_SIZES,M as CONTENT_TYPES,f as ConfigError,n as DEFAULT_CATEGORIES,r as EMBEDDING_DEFAULTS,p as EmbeddingError,i as FILE_LIMITS,m as IndexError,h as KBError,a as KB_GLOBAL_PATHS,o as KB_PATHS,N as KNOWLEDGE_ORIGINS,s as SEARCH_DEFAULTS,P as SOURCE_TYPES,c as STORE_DEFAULTS,g as StoreError,_ as computePartitionKey,l as contentTypeToSourceType,E as createLogger,u as detectContentType,v as getGlobalDataDir,D as getLogLevel,y as getPartitionDir,b as isGlobalInstalled,x as listWorkspaces,S as loadRegistry,C as lookupWorkspace,w as registerWorkspace,O as resetLogDir,T as saveRegistry,k as serializeError,A as setFileSinkEnabled,j as setLogLevel,d as sourceTypeContentTypes};

package/packages/core/dist/logger.d.ts

@@ -1,9 +1,20 @@
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-export declare function setLogLevel(level: LogLevel): void;
-export declare function createLogger(component: string): {
-    debug: (msg: string, data?: Record<string, unknown>) => void;
-    info: (msg: string, data?: Record<string, unknown>) => void;
-    warn: (msg: string, data?: Record<string, unknown>) => void;
-    error: (msg: string, data?: Record<string, unknown>) => void;
+//#region packages/core/src/logger.d.ts
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+declare function setLogLevel(level: LogLevel): void;
+declare function getLogLevel(): LogLevel;
+declare function setFileSinkEnabled(enabled: boolean): void;
+/** Reset resolved log directory (for testing). */
+declare function resetLogDir(): void;
+/**
+ * Serialize an unknown error into a structured record suitable for JSON logging.
+ * Includes stack traces only at debug level to keep production logs concise.
+ */
+declare function serializeError(err: unknown): Record<string, unknown>;
+declare function createLogger(component: string): {
+  debug: (msg: string, data?: Record<string, unknown>) => void;
+  info: (msg: string, data?: Record<string, unknown>) => void;
+  warn: (msg: string, data?: Record<string, unknown>) => void;
+  error: (msg: string, data?: Record<string, unknown>) => void;
 };
-//# sourceMappingURL=logger.d.ts.map
+//#endregion
+export { LogLevel, createLogger, getLogLevel, resetLogDir, serializeError, setFileSinkEnabled, setLogLevel };

package/packages/core/dist/logger.js

@@ -1 +1 @@
-const t={debug:0,info:1,warn:2,error:3};let g=process.env.KB_LOG_LEVEL??"info";function s(o){g=o}function u(o){function e(n,r,i){if(t[n]<t[g])return;const L={ts:new Date().toISOString(),level:n,component:o,msg:r,...i};console.error(JSON.stringify(L))}return{debug:(n,r)=>e("debug",n,r),info:(n,r)=>e("info",n,r),warn:(n,r)=>e("warn",n,r),error:(n,r)=>e("error",n,r)}}export{u as createLogger,s as setLogLevel};
+import{KB_PATHS as e}from"./constants.js";import{join as t,resolve as n}from"node:path";import{appendFileSync as r,mkdirSync as i,readdirSync as a,unlinkSync as o}from"node:fs";const s={debug:0,info:1,warn:2,error:3};let c=process.env.KB_LOG_LEVEL??`info`,l=process.env.KB_LOG_FILE_SINK===`true`||process.env.KB_LOG_FILE_SINK!==`false`&&!process.env.VITEST&&process.env.NODE_ENV!==`test`;function u(){return l?process.env.VITEST||process.env.NODE_ENV===`test`?process.env.KB_LOG_FILE_SINK===`true`:!0:!1}let d;function f(){return d||=n(process.cwd(),e.logs),d}function p(e){let n=e.toISOString().slice(0,10);return t(f(),`${n}.jsonl`)}let m=0;function h(){let e=Date.now();if(!(e-m<36e5)){m=e;try{let n=f(),r=new Date(e-30*864e5).toISOString().slice(0,10);for(let e of a(n))if(e.endsWith(`.jsonl`)&&e.slice(0,10)<r)try{o(t(n,e))}catch{}}catch{}}}function g(e,t){try{i(f(),{recursive:!0}),r(p(t),`${e}\n`),h()}catch{}}function _(e){c=e}function v(){return c}function y(e){l=e}function b(){d=void 0}function x(e){if(e instanceof Error){let t={error:e.message};return c===`debug`&&e.stack&&(t.stack=e.stack),t}return{error:String(e)}}function S(e){function t(t,n,r){if(s[t]<s[c])return;let i=new Date,a={ts:i.toISOString(),level:t,component:e,msg:n,...r},o=JSON.stringify(a);console.error(o),u()&&(t===`warn`||t===`error`)&&g(o,i)}return{debug:(e,n)=>t(`debug`,e,n),info:(e,n)=>t(`info`,e,n),warn:(e,n)=>t(`warn`,e,n),error:(e,n)=>t(`error`,e,n)}}export{S as createLogger,v as getLogLevel,b as resetLogDir,x as serializeError,y as setFileSinkEnabled,_ as setLogLevel};

package/packages/core/dist/types.d.ts

@@ -1,110 +1,125 @@
+//#region packages/core/src/types.d.ts
 /**
  * Core types for the MCP Knowledge Base system.
  */
 /** The origin of a knowledge record — how it was created */
-export type KnowledgeOrigin = 'indexed' | 'curated' | 'produced';
+declare const KNOWLEDGE_ORIGINS: readonly ["indexed", "curated", "produced"];
+type KnowledgeOrigin = (typeof KNOWLEDGE_ORIGINS)[number];
 /** Coarse source classification derived from ContentType */
-export type SourceType = 'source' | 'documentation' | 'test' | 'config' | 'generated';
+declare const SOURCE_TYPES: readonly ["source", "documentation", "test", "config", "generated"];
+type SourceType = (typeof SOURCE_TYPES)[number];
 /** Content type classification */
-export type ContentType = 'documentation' | 'code-typescript' | 'code-javascript' | 'code-python' | 'code-other' | 'config-json' | 'config-yaml' | 'config-toml' | 'config-env' | 'test-code' | 'cdk-stack' | 'markdown' | 'curated-knowledge' | 'produced-knowledge' | 'unknown';
+declare const CONTENT_TYPES: readonly ["documentation", "code-typescript", "code-javascript", "code-python", "code-other", "config-json", "config-yaml", "config-toml", "config-env", "test-code", "cdk-stack", "markdown", "curated-knowledge", "produced-knowledge", "unknown"];
+type ContentType = (typeof CONTENT_TYPES)[number];
 /** A single knowledge record stored in the vector DB */
-export interface KnowledgeRecord {
-    /** Unique identifier (deterministic hash of source + chunk index) */
-    id: string;
-    /** The text content of this chunk */
-    content: string;
-    /** Source file path relative to workspace root */
-    sourcePath: string;
-    /** Content type classification */
-    contentType: ContentType;
-    /** Heading path for markdown (e.g., "## Setup > ### Prerequisites") */
-    headingPath?: string;
-    /** Zero-based chunk index within the source file */
-    chunkIndex: number;
-    /** Total number of chunks from this source file */
-    totalChunks: number;
-    /** Start line in source file (1-based) */
-    startLine: number;
-    /** End line in source file (1-based) */
-    endLine: number;
-    /** File hash for incremental indexing */
-    fileHash: string;
-    /** ISO timestamp when this record was created/updated */
-    indexedAt: string;
-    /** How this record was created */
-    origin: KnowledgeOrigin;
-    /** User-defined tags for categorization */
-    tags: string[];
-    /** Category for curated/produced knowledge */
-    category?: string;
-    /** Version number for curated knowledge updates */
-    version: number;
+interface KnowledgeRecord {
+  /** Unique identifier (deterministic hash of source + chunk index) */
+  id: string;
+  /** The text content of this chunk */
+  content: string;
+  /** Source file path relative to workspace root */
+  sourcePath: string;
+  /** Content type classification */
+  contentType: ContentType;
+  /** Heading path for markdown (e.g., "## Setup > ### Prerequisites") */
+  headingPath?: string;
+  /** Zero-based chunk index within the source file */
+  chunkIndex: number;
+  /** Total number of chunks from this source file */
+  totalChunks: number;
+  /** Start line in source file (1-based) */
+  startLine: number;
+  /** End line in source file (1-based) */
+  endLine: number;
+  /** File hash for incremental indexing */
+  fileHash: string;
+  /** ISO timestamp when this record was created/updated */
+  indexedAt: string;
+  /** How this record was created */
+  origin: KnowledgeOrigin;
+  /** User-defined tags for categorization */
+  tags: string[];
+  /** Category for curated/produced knowledge */
+  category?: string;
+  /** Version number for curated knowledge updates */
+  version: number;
 }
 /** A raw chunk produced by a chunker before embedding */
-export interface RawChunk {
-    /** The text content */
-    text: string;
-    /** Source file path */
-    sourcePath: string;
-    /** Content type */
-    contentType: ContentType;
-    /** Heading path (markdown only) */
-    headingPath?: string;
-    /** Chunk index */
-    chunkIndex: number;
-    /** Total chunks from this file */
-    totalChunks: number;
-    /** Start line (1-based) */
-    startLine: number;
-    /** End line (1-based) */
-    endLine: number;
+interface RawChunk {
+  /** The text content */
+  text: string;
+  /** Source file path */
+  sourcePath: string;
+  /** Content type */
+  contentType: ContentType;
+  /** Heading path (markdown only) */
+  headingPath?: string;
+  /** Chunk index */
+  chunkIndex: number;
+  /** Total chunks from this file */
+  totalChunks: number;
+  /** Start line (1-based) */
+  startLine: number;
+  /** End line (1-based) */
+  endLine: number;
 }
 /** Metadata passed to a chunker */
-export interface ChunkMetadata {
-    /** File path relative to workspace root */
-    sourcePath: string;
-    /** Detected content type */
-    contentType: ContentType;
+interface ChunkMetadata {
+  /** File path relative to workspace root */
+  sourcePath: string;
+  /** Detected content type */
+  contentType: ContentType;
 }
 /** Search result returned by the store */
-export interface SearchResult {
-    /** The matching knowledge record */
-    record: KnowledgeRecord;
-    /** Similarity score (0-1, higher = more similar) */
-    score: number;
+interface SearchResult {
+  /** The matching knowledge record */
+  record: KnowledgeRecord;
+  /** Similarity score (0-1, higher = more similar) */
+  score: number;
 }
 /** Configuration loaded from kb.config.json */
-export interface KBConfig {
-    sources: Array<{
-        path: string;
-        excludePatterns: string[];
-    }>;
-    indexing: {
-        chunkSize: number;
-        chunkOverlap: number;
-        minChunkSize: number;
-        /** Max files processed concurrently. Defaults to half of available CPU cores. */
-        concurrency?: number;
-    };
-    embedding: {
-        model: string;
-        dimensions: number;
-    };
-    store: {
-        backend: string;
-        path: string;
-    };
-    curated: {
-        path: string;
-    };
+interface KBConfig {
+  /** MCP server name. Defaults to 'kb'. */
+  serverName?: string;
+  sources: Array<{
+    path: string;
+    excludePatterns: string[];
+  }>;
+  indexing: {
+    chunkSize: number;
+    chunkOverlap: number;
+    minChunkSize: number; /** Max files processed concurrently. Defaults to half of available CPU cores. */
+    concurrency?: number;
+  };
+  embedding: {
+    model: string;
+    dimensions: number;
+  };
+  store: {
+    backend: string;
+    path: string;
+  };
+  curated: {
+    path: string;
+  };
+  /** Enterprise RAG bridge configuration (optional) */
+  er?: {
+    /** Whether ER integration is enabled */enabled: boolean; /** Base URL of the ER API (e.g., https://xxx.execute-api.region.amazonaws.com/prod) */
+    baseUrl: string; /** Request timeout in milliseconds. Defaults to 5000. */
+    timeoutMs?: number; /** Cache TTL in milliseconds. Defaults to 21600000 (6 hours). */
+    cacheTtlMs?: number; /** Maximum cache entries. Defaults to 100. */
+    cacheMaxEntries?: number; /** Vector similarity threshold below which ER fallback triggers. Defaults to 0.45. */
+    fallbackThreshold?: number;
+  };
 }
 /** Index statistics */
-export interface IndexStats {
-    totalRecords: number;
-    totalFiles: number;
-    contentTypeBreakdown: Record<string, number>;
-    lastIndexedAt: string | null;
-    storeBackend: string;
-    embeddingModel: string;
+interface IndexStats {
+  totalRecords: number;
+  totalFiles: number;
+  contentTypeBreakdown: Record<string, number>;
+  lastIndexedAt: string | null;
+  storeBackend: string;
+  embeddingModel: string;
 }
-//# sourceMappingURL=types.d.ts.map
+//#endregion
+export { CONTENT_TYPES, ChunkMetadata, ContentType, IndexStats, KBConfig, KNOWLEDGE_ORIGINS, KnowledgeOrigin, KnowledgeRecord, RawChunk, SOURCE_TYPES, SearchResult, SourceType };

package/packages/core/dist/types.js

@@ -0,0 +1 @@
+const e=[`indexed`,`curated`,`produced`],t=[`source`,`documentation`,`test`,`config`,`generated`],n=[`documentation`,`code-typescript`,`code-javascript`,`code-python`,`code-other`,`config-json`,`config-yaml`,`config-toml`,`config-env`,`test-code`,`cdk-stack`,`markdown`,`curated-knowledge`,`produced-knowledge`,`unknown`];export{n as CONTENT_TYPES,e as KNOWLEDGE_ORIGINS,t as SOURCE_TYPES};