agent-knowledge 1.0.0

package/dist/knowledge/git.js

@@ -0,0 +1,228 @@
+import { execFileSync } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+const CATEGORIES = ['projects', 'people', 'decisions', 'workflows', 'notes'];
+/**
+ * Run a git command safely using execFileSync (no shell).
+ */
+function execGit(args, cwd, timeout) {
+    try {
+        const output = execFileSync('git', args, {
+            cwd,
+            stdio: 'pipe',
+            timeout,
+        });
+        return output ? output.toString().trim() : '';
+    }
+    catch (err) {
+        const e = err;
+        const msg = e.stderr ? e.stderr.toString().trim() : (e.message ?? String(err));
+        throw new Error(`git ${args[0]} failed: ${msg}`, { cause: err });
+    }
+}
+/**
+ * Pull latest changes from remote with rebase.
+ */
+export async function gitPull(dir) {
+    try {
+        const output = execGit(['pull', '--rebase', '--quiet'], dir, 15_000);
+        return { success: true, message: output || 'up to date' };
+    }
+    catch (err) {
+        return { success: false, message: err instanceof Error ? err.message : String(err) };
+    }
+}
+/**
+ * Stage all changes, commit if dirty, and push.
+ * Only commits when there are staged changes.
+ */
+export async function gitPush(dir, commitMsg) {
+    const message = commitMsg ?? 'update knowledge base';
+    try {
+        execGit(['add', '-A'], dir, 5_000);
+        // Only commit if there are staged changes
+        try {
+            execGit(['diff', '--cached', '--quiet'], dir, 5_000);
+            // No error means no changes — skip commit
+        }
+        catch {
+            // diff --cached --quiet exits non-zero when there ARE changes
+            execGit(['commit', '-m', message], dir, 5_000);
+        }
+        execGit(['push', '--quiet'], dir, 15_000);
+        return { success: true, message: 'pushed successfully' };
+    }
+    catch (err) {
+        return { success: false, message: err instanceof Error ? err.message : String(err) };
+    }
+}
+/**
+ * Pull then push — full bidirectional sync.
+ */
+export async function gitSync(dir) {
+    const pull = await gitPull(dir);
+    const push = await gitPush(dir);
+    return { pull, push };
+}
+// ── Scaffold templates ──────────────────────────────────────────────────────
+const SCAFFOLD_GITIGNORE = `# OS
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Editors
+*.swp
+*.swo
+*~
+.vscode/
+.idea/
+
+# Secrets — never commit these
+.env
+.env.*
+*.pem
+*.key
+credentials.*
+secrets.*
+
+# Obsidian — keep config, ignore workspace cache
+.obsidian/workspace.json
+.obsidian/workspace-mobile.json
+.obsidian/cache/
+`;
+const SCAFFOLD_README = `# Knowledge Base
+
+Shared knowledge base managed by [agent-knowledge](https://github.com/keshrath/agent-knowledge).
+
+## Structure
+
+\`\`\`
+├── projects/    — Per-project context, architecture, tech stacks
+├── people/      — Team members, roles, contacts
+├── decisions/   — Architecture decisions, trade-offs
+├── workflows/   — Processes, deployment steps, runbooks
+└── notes/       — General notes, research, ideas
+\`\`\`
+
+## Auto-Distillation
+
+Agent-knowledge automatically distills session insights into \`projects/\` entries:
+- Topics discussed, tools used, files touched
+- All content is scrubbed for secrets before committing
+- Runs after each server startup
+
+## Usage
+
+### Via MCP tools
+
+- \`knowledge_list\` / \`knowledge_read\` / \`knowledge_write\` — browse and edit entries
+- \`knowledge_search\` — hybrid semantic + keyword search
+- \`knowledge_sync\` — manual git pull + push
+- \`knowledge_config\` — view or update settings
+
+### File format
+
+Markdown with optional YAML frontmatter:
+
+\`\`\`markdown
+---
+title: My Project
+tags: [backend, api]
+updated: 2026-01-01
+---
+
+# My Project
+
+Content here.
+\`\`\`
+
+## Security
+
+Content is scrubbed before every git push:
+- API keys, tokens, passwords, JWTs, private keys → redacted
+- System noise (XML tags, task notifications) → stripped
+- Absolute user paths → normalized to \`~/\`
+- Final audit blocks writes that still contain sensitive patterns
+`;
+/**
+ * Write scaffold files (README, .gitignore, category dirs) into a new
+ * knowledge base directory. Skips files that already exist.
+ */
+function scaffoldRepo(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    for (const cat of CATEGORIES) {
+        const catDir = join(dir, cat);
+        if (!existsSync(catDir)) {
+            mkdirSync(catDir, { recursive: true });
+        }
+    }
+    const readme = join(dir, 'README.md');
+    if (!existsSync(readme)) {
+        writeFileSync(readme, SCAFFOLD_README, 'utf-8');
+    }
+    const gitignore = join(dir, '.gitignore');
+    if (!existsSync(gitignore)) {
+        writeFileSync(gitignore, SCAFFOLD_GITIGNORE, 'utf-8');
+    }
+}
+// ── Repo initialization ─────────────────────────────────────────────────────
+/**
+ * Ensure the memory directory exists and is a git repo.
+ *
+ * - If dir missing + gitUrl set → clone, then scaffold missing files
+ * - If dir exists but not a git repo + gitUrl set → scaffold + init + push
+ * - If dir missing + no gitUrl → scaffold local-only dir
+ * - If dir exists + is a git repo → no-op
+ */
+export function ensureRepo(dir, gitUrl) {
+    const isGitRepo = existsSync(join(dir, '.git'));
+    if (isGitRepo) {
+        return { success: true, message: 'repo already exists' };
+    }
+    if (!existsSync(dir) && gitUrl) {
+        try {
+            execGit(['clone', gitUrl, dir], process.cwd(), 30_000);
+            scaffoldRepo(dir);
+            try {
+                execGit(['add', '-A'], dir, 5_000);
+                execGit(['diff', '--cached', '--quiet'], dir, 5_000);
+            }
+            catch {
+                execGit(['commit', '-m', 'add scaffold files'], dir, 5_000);
+                execGit(['push', '--quiet'], dir, 15_000);
+            }
+            return { success: true, message: `cloned ${gitUrl} into ${dir}` };
+        }
+        catch (err) {
+            return { success: false, message: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    scaffoldRepo(dir);
+    if (gitUrl) {
+        try {
+            execGit(['init'], dir, 5_000);
+            execGit(['remote', 'add', 'origin', gitUrl], dir, 5_000);
+            execGit(['add', '-A'], dir, 5_000);
+            try {
+                execGit(['commit', '-m', 'init knowledge base'], dir, 5_000);
+            }
+            catch {
+                /* no files to commit is fine */
+            }
+            try {
+                execGit(['push', '-u', 'origin', 'HEAD', '--quiet'], dir, 15_000);
+            }
+            catch {
+                /* remote may have existing content — pull first next time */
+            }
+            return { success: true, message: `initialized repo with remote ${gitUrl}` };
+        }
+        catch (err) {
+            return { success: false, message: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    return { success: true, message: 'created local-only memory directory (no git URL configured)' };
+}
+//# sourceMappingURL=git.js.map

package/dist/knowledge/git.js.map

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

package/dist/knowledge/search.d.ts

@@ -0,0 +1,20 @@
+import { KnowledgeEntry } from './store.js';
+export interface SearchOptions {
+    category?: string;
+    maxResults?: number;
+    caseSensitive?: boolean;
+}
+export interface SearchResult {
+    entry: KnowledgeEntry;
+    score: number;
+    excerpt: string;
+}
+/**
+ * Search knowledge entries using TF-IDF ranking with regex fallback.
+ *
+ * Builds a TF-IDF index from all entries, searches by query, and returns
+ * ranked results with excerpts. Falls back to regex search if TF-IDF
+ * returns no results (useful for exact phrase matches).
+ */
+export declare function searchKnowledge(dir: string, query: string, options?: SearchOptions): Array<SearchResult>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/knowledge/search.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,KAAK,CAAC,YAAY,CAAC,CAiErB"}

package/dist/knowledge/search.js

@@ -0,0 +1,72 @@
+import { TfIdfIndex } from '../search/tfidf.js';
+import { buildExcerpt } from '../search/excerpt.js';
+import { listEntries, readEntry } from './store.js';
+/**
+ * Search knowledge entries using TF-IDF ranking with regex fallback.
+ *
+ * Builds a TF-IDF index from all entries, searches by query, and returns
+ * ranked results with excerpts. Falls back to regex search if TF-IDF
+ * returns no results (useful for exact phrase matches).
+ */
+export function searchKnowledge(dir, query, options = {}) {
+    const { category, maxResults = 10, caseSensitive = false } = options;
+    // Gather all entries with their content
+    const entries = listEntries(dir, category);
+    const documents = [];
+    for (const entry of entries) {
+        try {
+            const { content } = readEntry(dir, entry.path);
+            documents.push({ entry: { ...entry, content }, content });
+        }
+        catch {
+            continue;
+        }
+    }
+    if (documents.length === 0)
+        return [];
+    // Build TF-IDF index
+    const index = new TfIdfIndex();
+    for (const doc of documents) {
+        index.addDocument(doc.entry.path, doc.content);
+    }
+    // Search using TF-IDF
+    const tfidfResults = index.search(query, maxResults);
+    if (tfidfResults.length > 0) {
+        const results = [];
+        for (const result of tfidfResults) {
+            const doc = documents.find((d) => d.entry.path === result.id);
+            if (!doc)
+                continue;
+            results.push({
+                entry: doc.entry,
+                score: result.score,
+                excerpt: buildExcerpt(doc.content, query, { caseSensitive, contextAfter: 200 }),
+            });
+        }
+        return results;
+    }
+    // Fallback: regex search for exact phrase matches
+    const flags = caseSensitive ? 'g' : 'gi';
+    let regex;
+    try {
+        regex = new RegExp(query, flags);
+    }
+    catch {
+        regex = new RegExp(query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), flags);
+    }
+    const regexResults = [];
+    for (const doc of documents) {
+        regex.lastIndex = 0; // Reset before test() — global regex is stateful
+        if (regex.test(doc.content)) {
+            regexResults.push({
+                entry: doc.entry,
+                score: 1,
+                excerpt: buildExcerpt(doc.content, query, { caseSensitive, contextAfter: 200 }),
+            });
+            if (regexResults.length >= maxResults)
+                break;
+        }
+    }
+    return regexResults;
+}
+//# sourceMappingURL=search.js.map

package/dist/knowledge/search.js.map

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

package/dist/knowledge/store.d.ts

@@ -0,0 +1,47 @@
+export declare const CATEGORIES: readonly ["projects", "people", "decisions", "workflows", "notes"];
+export type Category = (typeof CATEGORIES)[number];
+/**
+ * Sanitize a path component — reject null bytes and path traversal.
+ */
+export declare function sanitizePath(input: string): string;
+export interface KnowledgeEntry {
+    path: string;
+    title: string;
+    tags: string[];
+    updated: string;
+    category: string;
+    content?: string;
+}
+/**
+ * Parse YAML-like frontmatter delimited by `---`.
+ * Extracts title, tags (as array), updated, and any other simple key-value pairs.
+ */
+export declare function parseFrontmatter(content: string): {
+    meta: Record<string, string | string[]>;
+    body: string;
+};
+/**
+ * List all knowledge entries, optionally filtered by category and/or tag.
+ */
+export declare function listEntries(dir: string, category?: string, tag?: string): KnowledgeEntry[];
+/**
+ * Read a specific entry by its relative path.
+ * Includes path traversal protection.
+ */
+export declare function readEntry(dir: string, entryPath: string): {
+    entry: KnowledgeEntry;
+    content: string;
+};
+/**
+ * Write a knowledge entry to disk.
+ * Validates the category, ensures the directory exists, and auto-adds .md extension.
+ * Returns the relative path of the written file.
+ */
+export declare function writeEntry(dir: string, category: string, filename: string, content: string): string;
+/**
+ * Delete a knowledge entry.
+ * Includes path traversal protection.
+ * Returns true if the file was deleted, false if it didn't exist.
+ */
+export declare function deleteEntry(dir: string, entryPath: string): boolean;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/knowledge/store.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,oEAAqE,CAAC;AAC7F,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd,CAwBA;AAuBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAoC1F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA4B5C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,CA0BR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAenE"}

package/dist/knowledge/store.js

@@ -0,0 +1,173 @@
+import fs from 'fs';
+import path from 'path';
+export const CATEGORIES = ['projects', 'people', 'decisions', 'workflows', 'notes'];
+/**
+ * Sanitize a path component — reject null bytes and path traversal.
+ */
+export function sanitizePath(input) {
+    if (input.includes('\0')) {
+        throw new Error('Path contains null bytes');
+    }
+    const normalized = input.replace(/\\/g, '/');
+    if (normalized.includes('..') || normalized.startsWith('/')) {
+        throw new Error('Path traversal not allowed');
+    }
+    return input;
+}
+/**
+ * Parse YAML-like frontmatter delimited by `---`.
+ * Extracts title, tags (as array), updated, and any other simple key-value pairs.
+ */
+export function parseFrontmatter(content) {
+    // Normalize \r\n to \n for cross-platform compatibility
+    const normalized = content.replace(/\r\n/g, '\n');
+    const match = normalized.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match)
+        return { meta: {}, body: content };
+    const meta = {};
+    for (const line of match[1].split('\n')) {
+        const m = line.match(/^(\w+):\s*(.+)$/);
+        if (m) {
+            let val = m[2].trim();
+            // Parse inline arrays like [tag1, tag2, tag3]
+            if (val.startsWith('[') && val.endsWith(']')) {
+                val = val
+                    .slice(1, -1)
+                    .split(',')
+                    .map((s) => s.trim())
+                    .filter((s) => s.length > 0);
+            }
+            meta[m[1]] = val;
+        }
+    }
+    return { meta, body: match[2] };
+}
+/**
+ * Recursively collect all .md files under a directory.
+ * Skips directories starting with `.`
+ */
+function getAllFiles(dir, base = '') {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const rel = base ? `${base}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            if (entry.name.startsWith('.'))
+                continue;
+            results.push(...getAllFiles(path.join(dir, entry.name), rel));
+        }
+        else if (entry.name.endsWith('.md')) {
+            results.push(rel);
+        }
+    }
+    return results;
+}
+/**
+ * List all knowledge entries, optionally filtered by category and/or tag.
+ */
+export function listEntries(dir, category, tag) {
+    const searchDir = category ? path.join(dir, category) : dir;
+    const basePrefix = category || '';
+    const files = getAllFiles(searchDir, basePrefix);
+    const entries = [];
+    for (const file of files) {
+        const fullPath = path.join(dir, file);
+        try {
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const { meta } = parseFrontmatter(content);
+            // Filter by tag if specified
+            if (tag) {
+                const tags = Array.isArray(meta.tags) ? meta.tags : [];
+                if (!tags.some((t) => t.toLowerCase() === tag.toLowerCase())) {
+                    continue;
+                }
+            }
+            // Derive category from the first path segment
+            const entryCategory = file.includes('/') ? file.split('/')[0] : '';
+            entries.push({
+                path: file,
+                title: (typeof meta.title === 'string' ? meta.title : '') || file.replace(/\.md$/, ''),
+                tags: Array.isArray(meta.tags) ? meta.tags : [],
+                updated: (typeof meta.updated === 'string' ? meta.updated : '') || '',
+                category: entryCategory,
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    return entries;
+}
+/**
+ * Read a specific entry by its relative path.
+ * Includes path traversal protection.
+ */
+export function readEntry(dir, entryPath) {
+    sanitizePath(entryPath);
+    const filePath = path.resolve(dir, entryPath);
+    // Path traversal protection
+    if (!filePath.startsWith(path.resolve(dir))) {
+        throw new Error('Path traversal not allowed');
+    }
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`File not found: ${entryPath}`);
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const { meta, body } = parseFrontmatter(content);
+    const entryCategory = entryPath.includes('/') ? entryPath.split('/')[0] : '';
+    const entry = {
+        path: entryPath,
+        title: (typeof meta.title === 'string' ? meta.title : '') || entryPath.replace(/\.md$/, ''),
+        tags: Array.isArray(meta.tags) ? meta.tags : [],
+        updated: (typeof meta.updated === 'string' ? meta.updated : '') || '',
+        category: entryCategory,
+        content: body,
+    };
+    return { entry, content };
+}
+/**
+ * Write a knowledge entry to disk.
+ * Validates the category, ensures the directory exists, and auto-adds .md extension.
+ * Returns the relative path of the written file.
+ */
+export function writeEntry(dir, category, filename, content) {
+    if (!CATEGORIES.includes(category)) {
+        throw new Error(`Invalid category: ${category}. Must be one of: ${CATEGORIES.join(', ')}`);
+    }
+    // Reject filenames with path separators or traversal attempts
+    if (/[/\\]/.test(filename) || filename.includes('..')) {
+        throw new Error('Filename must not contain path separators or ".."');
+    }
+    const safeName = filename.endsWith('.md') ? filename : `${filename}.md`;
+    const categoryDir = path.join(dir, category);
+    if (!fs.existsSync(categoryDir)) {
+        fs.mkdirSync(categoryDir, { recursive: true });
+    }
+    const filePath = path.resolve(categoryDir, safeName);
+    // Path traversal protection
+    if (!filePath.startsWith(path.resolve(dir))) {
+        throw new Error('Path traversal not allowed');
+    }
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return `${category}/${safeName}`;
+}
+/**
+ * Delete a knowledge entry.
+ * Includes path traversal protection.
+ * Returns true if the file was deleted, false if it didn't exist.
+ */
+export function deleteEntry(dir, entryPath) {
+    sanitizePath(entryPath);
+    const filePath = path.resolve(dir, entryPath);
+    // Path traversal protection
+    if (!filePath.startsWith(path.resolve(dir))) {
+        throw new Error('Path traversal not allowed');
+    }
+    if (!fs.existsSync(filePath)) {
+        return false;
+    }
+    fs.unlinkSync(filePath);
+    return true;
+}
+//# sourceMappingURL=store.js.map

package/dist/knowledge/store.js.map

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

package/dist/search/excerpt.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared excerpt-building utility.
+ *
+ * Extracts a window of text around the first occurrence of `query`,
+ * with configurable context on each side.
+ */
+export declare function buildExcerpt(text: string, query: string, options?: {
+    contextBefore?: number;
+    contextAfter?: number;
+    caseSensitive?: boolean;
+}): string;
+//# sourceMappingURL=excerpt.d.ts.map

package/dist/search/excerpt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excerpt.d.ts","sourceRoot":"","sources":["../../src/search/excerpt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACvF,MAAM,CAwBR"}

package/dist/search/excerpt.js

@@ -0,0 +1,28 @@
+/**
+ * Shared excerpt-building utility.
+ *
+ * Extracts a window of text around the first occurrence of `query`,
+ * with configurable context on each side.
+ */
+export function buildExcerpt(text, query, options = {}) {
+    const { contextBefore = 100, contextAfter = 100, caseSensitive = false } = options;
+    if (!text)
+        return '';
+    if (!query)
+        return text.substring(0, 300) + (text.length > 300 ? '...' : '');
+    let idx;
+    try {
+        idx = text.search(new RegExp(query, caseSensitive ? '' : 'i'));
+    }
+    catch {
+        const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        idx = text.search(new RegExp(escaped, caseSensitive ? '' : 'i'));
+    }
+    if (idx === -1) {
+        return text.substring(0, 300) + (text.length > 300 ? '...' : '');
+    }
+    const start = Math.max(0, idx - contextBefore);
+    const end = Math.min(text.length, idx + query.length + contextAfter);
+    return ((start > 0 ? '...' : '') + text.substring(start, end).trim() + (end < text.length ? '...' : ''));
+}
+//# sourceMappingURL=excerpt.js.map

package/dist/search/excerpt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excerpt.js","sourceRoot":"","sources":["../../src/search/excerpt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,KAAa,EACb,UAAsF,EAAE;IAExF,MAAM,EAAE,aAAa,GAAG,GAAG,EAAE,YAAY,GAAG,GAAG,EAAE,aAAa,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEnF,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE7E,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QAC7D,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,aAAa,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;IAErE,OAAO,CACL,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAChG,CAAC;AACJ,CAAC"}

package/dist/search/fuzzy.d.ts

@@ -0,0 +1,15 @@
+export declare function levenshtein(a: string, b: string): number;
+export declare function fuzzyMatch(needle: string, haystack: string, threshold?: number): Array<{
+    start: number;
+    end: number;
+    score: number;
+}>;
+export declare function fuzzySearch(query: string, texts: Array<{
+    id: string;
+    text: string;
+}>, threshold?: number): Array<{
+    id: string;
+    score: number;
+    excerpt: string;
+}>;
+//# sourceMappingURL=fuzzy.d.ts.map

package/dist/search/fuzzy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy.d.ts","sourceRoot":"","sources":["../../src/search/fuzzy.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BxD;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAY,GACtB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgDtD;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC1C,SAAS,GAAE,MAAY,GACtB,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuBvD"}