@vpxa/kb 0.1.1 → 0.1.2

package/packages/cli/dist/commands/knowledge.js

@@ -1,139 +1 @@
-import { compact } from "@kb/tools";
-import { ctx } from "../context.js";
-import { extractNumFlag, extractStrFlag, readStdin, splitCsv } from "../helpers.js";
-const knowledgeCommands = [
-  {
-    name: "remember",
-    description: "Store curated knowledge",
-    usage: "kb remember <title> --category <cat> [--tags tag1,tag2]",
-    run: async (args) => {
-      const category = extractStrFlag(args, "--category", "").trim();
-      const tags = splitCsv(extractStrFlag(args, "--tags", ""));
-      const title = args.shift()?.trim() ?? "";
-      const stdinContent = await readStdin();
-      const content = stdinContent.trim().length > 0 ? stdinContent : args.join(" ").trim();
-      if (!title || !category || !content.trim()) {
-        console.error("Usage: kb remember <title> --category <cat> [--tags tag1,tag2]");
-        process.exit(1);
-      }
-      const { curated } = await ctx();
-      const result = await curated.remember(title, content, category, tags);
-      console.log("Stored curated entry");
-      console.log(`  Path: ${result.path}`);
-      console.log(`  Category: ${category}`);
-      if (tags.length > 0) console.log(`  Tags: ${tags.join(", ")}`);
-    }
-  },
-  {
-    name: "forget",
-    description: "Remove a curated entry",
-    usage: "kb forget <path> --reason <reason>",
-    run: async (args) => {
-      const reason = extractStrFlag(args, "--reason", "").trim();
-      const relativePath = args.shift()?.trim() ?? "";
-      if (!relativePath || !reason) {
-        console.error("Usage: kb forget <path> --reason <reason>");
-        process.exit(1);
-      }
-      const { curated } = await ctx();
-      const result = await curated.forget(relativePath, reason);
-      console.log(`Removed curated entry: ${result.path}`);
-    }
-  },
-  {
-    name: "read",
-    description: "Read a curated entry",
-    usage: "kb read <path>",
-    run: async (args) => {
-      const relativePath = args.shift()?.trim() ?? "";
-      if (!relativePath) {
-        console.error("Usage: kb read <path>");
-        process.exit(1);
-      }
-      const { curated } = await ctx();
-      const entry = await curated.read(relativePath);
-      console.log(entry.title);
-      console.log("\u2500".repeat(60));
-      console.log(`Path: ${entry.path}`);
-      console.log(`Category: ${entry.category}`);
-      console.log(`Version: ${entry.version}`);
-      console.log(`Tags: ${entry.tags.length > 0 ? entry.tags.join(", ") : "None"}`);
-      console.log("");
-      console.log(entry.content);
-    }
-  },
-  {
-    name: "list",
-    description: "List curated entries",
-    usage: "kb list [--category <cat>] [--tag <tag>]",
-    run: async (args) => {
-      const category = extractStrFlag(args, "--category", "").trim() || void 0;
-      const tag = extractStrFlag(args, "--tag", "").trim() || void 0;
-      const { curated } = await ctx();
-      const entries = await curated.list({ category, tag });
-      if (entries.length === 0) {
-        console.log("No curated entries found.");
-        return;
-      }
-      console.log(`Curated entries (${entries.length})`);
-      console.log("\u2500".repeat(60));
-      for (const entry of entries) {
-        console.log(entry.path);
-        console.log(`  ${entry.title}`);
-        console.log(`  Category: ${entry.category} | Version: ${entry.version}`);
-        console.log(`  Tags: ${entry.tags.length > 0 ? entry.tags.join(", ") : "None"}`);
-        const preview = entry.contentPreview.replace(/\s+/g, " ").trim();
-        if (preview) console.log(`  Preview: ${preview}`);
-        console.log("");
-      }
-    }
-  },
-  {
-    name: "update",
-    description: "Update a curated entry",
-    usage: "kb update <path> --reason <reason>",
-    run: async (args) => {
-      const reason = extractStrFlag(args, "--reason", "").trim();
-      const relativePath = args.shift()?.trim() ?? "";
-      const content = await readStdin();
-      if (!relativePath || !reason || !content.trim()) {
-        console.error("Usage: kb update <path> --reason <reason>");
-        process.exit(1);
-      }
-      const { curated } = await ctx();
-      const result = await curated.update(relativePath, content, reason);
-      console.log("Updated curated entry");
-      console.log(`  Path: ${result.path}`);
-      console.log(`  Version: ${result.version}`);
-    }
-  },
-  {
-    name: "compact",
-    description: "Compress text for context",
-    usage: "kb compact <query> [--max-chars N] [--segmentation paragraph|sentence|line]",
-    run: async (args) => {
-      const maxChars = extractNumFlag(args, "--max-chars", 3e3);
-      const segmentation = extractStrFlag(args, "--segmentation", "paragraph");
-      const query = args.join(" ").trim();
-      const text = await readStdin();
-      if (!query || !text.trim()) {
-        console.error(
-          "Usage: kb compact <query> [--max-chars N] [--segmentation paragraph|sentence|line]"
-        );
-        process.exit(1);
-      }
-      const { embedder } = await ctx();
-      const result = await compact(embedder, { text, query, maxChars, segmentation });
-      console.log(`Compressed ${result.originalChars} chars to ${result.compressedChars} chars`);
-      console.log(
-        `Ratio: ${(result.ratio * 100).toFixed(1)}% | Segments: ${result.segmentsKept}/${result.segmentsTotal}`
-      );
-      console.log("");
-      console.log(result.text);
-    }
-  }
-];
-export {
-  knowledgeCommands
-};
-//# sourceMappingURL=knowledge.js.map
+import{compact as m}from"@kb/tools";import{ctx as i}from"../context.js";import{extractNumFlag as p,extractStrFlag as c,readStdin as l,splitCsv as d}from"../helpers.js";const f=[{name:"remember",description:"Store curated knowledge",usage:"kb remember <title> --category <cat> [--tags tag1,tag2]",run:async t=>{const o=c(t,"--category","").trim(),a=d(c(t,"--tags","")),e=t.shift()?.trim()??"",r=await l(),n=r.trim().length>0?r:t.join(" ").trim();(!e||!o||!n.trim())&&(console.error("Usage: kb remember <title> --category <cat> [--tags tag1,tag2]"),process.exit(1));const{curated:s}=await i(),g=await s.remember(e,n,o,a);console.log("Stored curated entry"),console.log(`  Path: ${g.path}`),console.log(`  Category: ${o}`),a.length>0&&console.log(`  Tags: ${a.join(", ")}`)}},{name:"forget",description:"Remove a curated entry",usage:"kb forget <path> --reason <reason>",run:async t=>{const o=c(t,"--reason","").trim(),a=t.shift()?.trim()??"";(!a||!o)&&(console.error("Usage: kb forget <path> --reason <reason>"),process.exit(1));const{curated:e}=await i(),r=await e.forget(a,o);console.log(`Removed curated entry: ${r.path}`)}},{name:"read",description:"Read a curated entry",usage:"kb read <path>",run:async t=>{const o=t.shift()?.trim()??"";o||(console.error("Usage: kb read <path>"),process.exit(1));const{curated:a}=await i(),e=await a.read(o);console.log(e.title),console.log("\u2500".repeat(60)),console.log(`Path: ${e.path}`),console.log(`Category: ${e.category}`),console.log(`Version: ${e.version}`),console.log(`Tags: ${e.tags.length>0?e.tags.join(", "):"None"}`),console.log(""),console.log(e.content)}},{name:"list",description:"List curated entries",usage:"kb list [--category <cat>] [--tag <tag>]",run:async t=>{const o=c(t,"--category","").trim()||void 0,a=c(t,"--tag","").trim()||void 0,{curated:e}=await i(),r=await e.list({category:o,tag:a});if(r.length===0){console.log("No curated entries found.");return}console.log(`Curated entries (${r.length})`),console.log("\u2500".repeat(60));for(const n of r){console.log(n.path),console.log(`  ${n.title}`),console.log(`  Category: ${n.category} | Version: ${n.version}`),console.log(`  Tags: ${n.tags.length>0?n.tags.join(", "):"None"}`);const s=n.contentPreview.replace(/\s+/g," ").trim();s&&console.log(`  Preview: ${s}`),console.log("")}}},{name:"update",description:"Update a curated entry",usage:"kb update <path> --reason <reason>",run:async t=>{const o=c(t,"--reason","").trim(),a=t.shift()?.trim()??"",e=await l();(!a||!o||!e.trim())&&(console.error("Usage: kb update <path> --reason <reason>"),process.exit(1));const{curated:r}=await i(),n=await r.update(a,e,o);console.log("Updated curated entry"),console.log(`  Path: ${n.path}`),console.log(`  Version: ${n.version}`)}},{name:"compact",description:"Compress text for context",usage:"kb compact <query> [--max-chars N] [--segmentation paragraph|sentence|line]",run:async t=>{const o=p(t,"--max-chars",3e3),a=c(t,"--segmentation","paragraph"),e=t.join(" ").trim(),r=await l();(!e||!r.trim())&&(console.error("Usage: kb compact <query> [--max-chars N] [--segmentation paragraph|sentence|line]"),process.exit(1));const{embedder:n}=await i(),s=await m(n,{text:r,query:e,maxChars:o,segmentation:a});console.log(`Compressed ${s.originalChars} chars to ${s.compressedChars} chars`),console.log(`Ratio: ${(s.ratio*100).toFixed(1)}% | Segments: ${s.segmentsKept}/${s.segmentsTotal}`),console.log(""),console.log(s.text)}}];export{f as knowledgeCommands};

package/packages/cli/dist/commands/search.js

@@ -1,267 +1,8 @@
-import { find, findDeadSymbols, findExamples, scopeMap, symbol, trace } from "@kb/tools";
-import { ctx } from "../context.js";
-import {
-  extractNumFlag,
-  extractStrFlag,
-  formatFocusRanges,
-  printDeadSymbolsResult,
-  printExamplesResult,
-  printSymbolInfo,
-  printTraceResult,
-  rrf
-} from "../helpers.js";
-const searchCommands = [
-  {
-    name: "search",
-    description: "Search the knowledge base",
-    usage: "kb search <query> [--limit N] [--mode hybrid|semantic|keyword] [--graph-hops 0-3]",
-    run: async (args) => {
-      const limit = extractNumFlag(args, "--limit", 5);
-      const mode = extractStrFlag(args, "--mode", "hybrid");
-      const graphHops = extractNumFlag(args, "--graph-hops", 0);
-      const query = args.join(" ").trim();
-      if (!query) {
-        console.error("Usage: kb search <query>");
-        process.exit(1);
-      }
-      const { embedder, store, graphStore } = await ctx();
-      const queryVector = await embedder.embedQuery(query);
-      let results;
-      if (mode === "keyword") {
-        results = await store.ftsSearch(query, { limit });
-      } else if (mode === "semantic") {
-        results = await store.search(queryVector, { limit });
-      } else {
-        const [vec, fts] = await Promise.all([
-          store.search(queryVector, { limit: limit * 2 }),
-          store.ftsSearch(query, { limit: limit * 2 }).catch(() => [])
-        ]);
-        results = rrf(vec, fts).slice(0, limit);
-      }
-      if (results.length === 0) {
-        console.log("No results found.");
-        return;
-      }
-      for (const { record, score } of results) {
-        console.log(`
-${"\u2500".repeat(60)}`);
-        console.log(
-          `[${(score * 100).toFixed(1)}%] ${record.sourcePath}:${record.startLine}-${record.endLine}`
-        );
-        console.log(`  Type: ${record.contentType} | Origin: ${record.origin}`);
-        if (record.tags.length > 0) console.log(`  Tags: ${record.tags.join(", ")}`);
-        console.log("");
-        const preview = record.content.length > 500 ? `${record.content.slice(0, 500)}...` : record.content;
-        console.log(preview);
-      }
-      console.log(`
-${"\u2500".repeat(60)}`);
-      console.log(`${results.length} result(s) found.`);
-      if (graphHops > 0 && results.length > 0) {
-        try {
-          const { graphAugmentSearch } = await import("@kb/tools");
-          const hits = results.map((r) => ({
-            recordId: r.record.id,
-            score: r.score,
-            sourcePath: r.record.sourcePath
-          }));
-          const augmented = await graphAugmentSearch(graphStore, hits, {
-            hops: graphHops,
-            maxPerHit: 5
-          });
-          const hasContext = augmented.filter((a) => a.graphContext.nodes.length > 0);
-          if (hasContext.length > 0) {
-            console.log(`
-Graph context (${graphHops} hop${graphHops > 1 ? "s" : ""}):
-`);
-            for (const aug of hasContext) {
-              console.log(`  ${aug.sourcePath}:`);
-              for (const n of aug.graphContext.nodes.slice(0, 5)) {
-                console.log(`    \u2192 ${n.name} (${n.type})`);
-              }
-              for (const e of aug.graphContext.edges.slice(0, 5)) {
-                console.log(`    \u2192 ${e.fromId} --[${e.type}]--> ${e.toId}`);
-              }
-            }
-          }
-        } catch (err) {
-          console.error(`[graph] augmentation failed: ${err.message}`);
-        }
-      }
-    }
-  },
-  {
-    name: "find",
-    description: "Run federated search across indexed content and files",
-    usage: "kb find [query] [--glob <pattern>] [--pattern <regex>] [--limit N]",
-    run: async (args) => {
-      const limit = extractNumFlag(args, "--limit", 10);
-      const glob = extractStrFlag(args, "--glob", "").trim() || void 0;
-      const pattern = extractStrFlag(args, "--pattern", "").trim() || void 0;
-      const query = args.join(" ").trim() || void 0;
-      if (!query && !glob && !pattern) {
-        console.error("Usage: kb find [query] [--glob <pattern>] [--pattern <regex>] [--limit N]");
-        process.exit(1);
-      }
-      const { embedder, store } = await ctx();
-      const result = await find(embedder, store, { query, glob, pattern, limit });
-      if (result.results.length === 0) {
-        console.log("No matches found.");
-        return;
-      }
-      console.log(`Strategies: ${result.strategies.join(", ")}`);
-      console.log(`Results: ${result.results.length} shown (${result.totalFound} total)`);
-      for (const match of result.results) {
-        const lineRange = match.lineRange ? `:${match.lineRange.start}-${match.lineRange.end}` : "";
-        console.log(`
-[${match.source}] ${match.path}${lineRange}`);
-        console.log(`  Score: ${(match.score * 100).toFixed(1)}%`);
-        if (match.preview) console.log(`  ${match.preview.replace(/\s+/g, " ").trim()}`);
-      }
-    }
-  },
-  {
-    name: "scope-map",
-    description: "Generate a reading plan for a task",
-    usage: "kb scope-map <task> [--max-files N]",
-    run: async (args) => {
-      const maxFiles = extractNumFlag(args, "--max-files", 15);
-      const task = args.join(" ").trim();
-      if (!task) {
-        console.error("Usage: kb scope-map <task> [--max-files N]");
-        process.exit(1);
-      }
-      const { embedder, store } = await ctx();
-      const result = await scopeMap(embedder, store, { task, maxFiles });
-      console.log(`Task: ${result.task}`);
-      console.log(`Files: ${result.files.length}`);
-      console.log(`Estimated tokens: ${result.totalEstimatedTokens}`);
-      console.log("");
-      console.log("Reading order:");
-      for (const path of result.readingOrder) console.log(`  ${path}`);
-      for (const [index, file] of result.files.entries()) {
-        console.log(`
-${index + 1}. ${file.path}`);
-        console.log(
-          `   Relevance: ${(file.relevance * 100).toFixed(1)}% | Tokens: ${file.estimatedTokens}`
-        );
-        console.log(`   Why: ${file.reason}`);
-        if (file.focusRanges.length > 0) {
-          console.log(`   Focus: ${formatFocusRanges(file.focusRanges)}`);
-        }
-      }
-    }
-  },
-  {
-    name: "symbol",
-    description: "Resolve a symbol definition, imports, and references",
-    usage: "kb symbol <name> [--limit N]",
-    run: async (args) => {
-      const limit = extractNumFlag(args, "--limit", 20);
-      const name = args.join(" ").trim();
-      if (!name) {
-        console.error("Usage: kb symbol <name> [--limit N]");
-        process.exit(1);
-      }
-      const { embedder, store } = await ctx();
-      const result = await symbol(embedder, store, { name, limit });
-      printSymbolInfo(result);
-    }
-  },
-  {
-    name: "trace",
-    description: "Trace forward/backward flow for a symbol or file location",
-    usage: "kb trace <start> [--direction forward|backward|both] [--max-depth N]",
-    run: async (args) => {
-      const directionValue = extractStrFlag(args, "--direction", "both").trim() || "both";
-      const maxDepth = extractNumFlag(args, "--max-depth", 3);
-      const start = args.join(" ").trim();
-      if (!start || !["forward", "backward", "both"].includes(directionValue)) {
-        console.error(
-          "Usage: kb trace <start> [--direction forward|backward|both] [--max-depth N]"
-        );
-        process.exit(1);
-      }
-      const { embedder, store } = await ctx();
-      const result = await trace(embedder, store, {
-        start,
-        direction: directionValue,
-        maxDepth
-      });
-      printTraceResult(result);
-    }
-  },
-  {
-    name: "examples",
-    description: "Find real code examples of a symbol or pattern",
-    usage: "kb examples <query> [--limit N] [--content-type type]",
-    run: async (args) => {
-      const limit = extractNumFlag(args, "--limit", 5);
-      const contentType = extractStrFlag(args, "--content-type", "").trim() || void 0;
-      const query = args.join(" ").trim();
-      if (!query) {
-        console.error("Usage: kb examples <query> [--limit N] [--content-type type]");
-        process.exit(1);
-      }
-      const { embedder, store } = await ctx();
-      const result = await findExamples(embedder, store, { query, limit, contentType });
-      printExamplesResult(result);
-    }
-  },
-  {
-    name: "dead-symbols",
-    description: "Find exported symbols that appear to be unused",
-    usage: "kb dead-symbols [--limit N]",
-    run: async (args) => {
-      const limit = extractNumFlag(args, "--limit", 100);
-      const { embedder, store } = await ctx();
-      const result = await findDeadSymbols(embedder, store, { limit });
-      printDeadSymbolsResult(result);
-    }
-  },
-  {
-    name: "lookup",
-    description: "Look up indexed content by record ID or source path",
-    usage: "kb lookup <id>",
-    run: async (args) => {
-      const key = args.join(" ").trim();
-      if (!key) {
-        console.error("Usage: kb lookup <id>");
-        process.exit(1);
-      }
-      const { store } = await ctx();
-      const record = await store.getById(key);
-      if (record) {
-        console.log(record.id);
-        console.log("\u2500".repeat(60));
-        console.log(`Path: ${record.sourcePath}`);
-        console.log(`Chunk: ${record.chunkIndex + 1}/${record.totalChunks}`);
-        console.log(`Lines: ${record.startLine}-${record.endLine}`);
-        console.log(`Type: ${record.contentType} | Origin: ${record.origin}`);
-        if (record.tags.length > 0) console.log(`Tags: ${record.tags.join(", ")}`);
-        console.log("");
-        console.log(record.content);
-        return;
-      }
-      const records = await store.getBySourcePath(key);
-      if (records.length === 0) {
-        console.log(`No indexed content found for: ${key}`);
-        return;
-      }
-      records.sort((a, b) => a.chunkIndex - b.chunkIndex);
-      console.log(key);
-      console.log("\u2500".repeat(60));
-      console.log(`Chunks: ${records.length} | Type: ${records[0].contentType}`);
-      for (const chunk of records) {
-        const lineInfo = chunk.startLine ? ` (lines ${chunk.startLine}-${chunk.endLine})` : "";
-        console.log(`
-Chunk ${chunk.chunkIndex + 1}/${chunk.totalChunks}${lineInfo}`);
-        console.log(chunk.content);
-      }
-    }
-  }
-];
-export {
-  searchCommands
-};
-//# sourceMappingURL=search.js.map
+import{find as $,findDeadSymbols as k,findExamples as x,scopeMap as w,symbol as N,trace as R}from"@kb/tools";import{ctx as g}from"../context.js";import{extractNumFlag as p,extractStrFlag as h,formatFocusRanges as T,printDeadSymbolsResult as C,printExamplesResult as F,printSymbolInfo as S,printTraceResult as j,rrf as I}from"../helpers.js";const v=[{name:"search",description:"Search the knowledge base",usage:"kb search <query> [--limit N] [--mode hybrid|semantic|keyword] [--graph-hops 0-3]",run:async o=>{const t=p(o,"--limit",5),r=h(o,"--mode","hybrid"),e=p(o,"--graph-hops",0),s=o.join(" ").trim();s||(console.error("Usage: kb search <query>"),process.exit(1));const{embedder:n,store:a,graphStore:c}=await g(),l=await n.embedQuery(s);let d;if(r==="keyword")d=await a.ftsSearch(s,{limit:t});else if(r==="semantic")d=await a.search(l,{limit:t});else{const[i,f]=await Promise.all([a.search(l,{limit:t*2}),a.ftsSearch(s,{limit:t*2}).catch(()=>[])]);d=I(i,f).slice(0,t)}if(d.length===0){console.log("No results found.");return}for(const{record:i,score:f}of d){console.log(`
+${"\u2500".repeat(60)}`),console.log(`[${(f*100).toFixed(1)}%] ${i.sourcePath}:${i.startLine}-${i.endLine}`),console.log(`  Type: ${i.contentType} | Origin: ${i.origin}`),i.tags.length>0&&console.log(`  Tags: ${i.tags.join(", ")}`),console.log("");const y=i.content.length>500?`${i.content.slice(0,500)}...`:i.content;console.log(y)}if(console.log(`
+${"\u2500".repeat(60)}`),console.log(`${d.length} result(s) found.`),e>0&&d.length>0)try{const{graphAugmentSearch:i}=await import("@kb/tools"),f=d.map(m=>({recordId:m.record.id,score:m.score,sourcePath:m.record.sourcePath})),b=(await i(c,f,{hops:e,maxPerHit:5})).filter(m=>m.graphContext.nodes.length>0);if(b.length>0){console.log(`
+Graph context (${e} hop${e>1?"s":""}):
+`);for(const m of b){console.log(`  ${m.sourcePath}:`);for(const u of m.graphContext.nodes.slice(0,5))console.log(`    \u2192 ${u.name} (${u.type})`);for(const u of m.graphContext.edges.slice(0,5))console.log(`    \u2192 ${u.fromId} --[${u.type}]--> ${u.toId}`)}}}catch(i){console.error(`[graph] augmentation failed: ${i.message}`)}}},{name:"find",description:"Run federated search across indexed content and files",usage:"kb find [query] [--glob <pattern>] [--pattern <regex>] [--limit N]",run:async o=>{const t=p(o,"--limit",10),r=h(o,"--glob","").trim()||void 0,e=h(o,"--pattern","").trim()||void 0,s=o.join(" ").trim()||void 0;!s&&!r&&!e&&(console.error("Usage: kb find [query] [--glob <pattern>] [--pattern <regex>] [--limit N]"),process.exit(1));const{embedder:n,store:a}=await g(),c=await $(n,a,{query:s,glob:r,pattern:e,limit:t});if(c.results.length===0){console.log("No matches found.");return}console.log(`Strategies: ${c.strategies.join(", ")}`),console.log(`Results: ${c.results.length} shown (${c.totalFound} total)`);for(const l of c.results){const d=l.lineRange?`:${l.lineRange.start}-${l.lineRange.end}`:"";console.log(`
+[${l.source}] ${l.path}${d}`),console.log(`  Score: ${(l.score*100).toFixed(1)}%`),l.preview&&console.log(`  ${l.preview.replace(/\s+/g," ").trim()}`)}}},{name:"scope-map",description:"Generate a reading plan for a task",usage:"kb scope-map <task> [--max-files N]",run:async o=>{const t=p(o,"--max-files",15),r=o.join(" ").trim();r||(console.error("Usage: kb scope-map <task> [--max-files N]"),process.exit(1));const{embedder:e,store:s}=await g(),n=await w(e,s,{task:r,maxFiles:t});console.log(`Task: ${n.task}`),console.log(`Files: ${n.files.length}`),console.log(`Estimated tokens: ${n.totalEstimatedTokens}`),console.log(""),console.log("Reading order:");for(const a of n.readingOrder)console.log(`  ${a}`);for(const[a,c]of n.files.entries())console.log(`
+${a+1}. ${c.path}`),console.log(`   Relevance: ${(c.relevance*100).toFixed(1)}% | Tokens: ${c.estimatedTokens}`),console.log(`   Why: ${c.reason}`),c.focusRanges.length>0&&console.log(`   Focus: ${T(c.focusRanges)}`)}},{name:"symbol",description:"Resolve a symbol definition, imports, and references",usage:"kb symbol <name> [--limit N]",run:async o=>{const t=p(o,"--limit",20),r=o.join(" ").trim();r||(console.error("Usage: kb symbol <name> [--limit N]"),process.exit(1));const{embedder:e,store:s}=await g(),n=await N(e,s,{name:r,limit:t});S(n)}},{name:"trace",description:"Trace forward/backward flow for a symbol or file location",usage:"kb trace <start> [--direction forward|backward|both] [--max-depth N]",run:async o=>{const t=h(o,"--direction","both").trim()||"both",r=p(o,"--max-depth",3),e=o.join(" ").trim();(!e||!["forward","backward","both"].includes(t))&&(console.error("Usage: kb trace <start> [--direction forward|backward|both] [--max-depth N]"),process.exit(1));const{embedder:s,store:n}=await g(),a=await R(s,n,{start:e,direction:t,maxDepth:r});j(a)}},{name:"examples",description:"Find real code examples of a symbol or pattern",usage:"kb examples <query> [--limit N] [--content-type type]",run:async o=>{const t=p(o,"--limit",5),r=h(o,"--content-type","").trim()||void 0,e=o.join(" ").trim();e||(console.error("Usage: kb examples <query> [--limit N] [--content-type type]"),process.exit(1));const{embedder:s,store:n}=await g(),a=await x(s,n,{query:e,limit:t,contentType:r});F(a)}},{name:"dead-symbols",description:"Find exported symbols that appear to be unused",usage:"kb dead-symbols [--limit N]",run:async o=>{const t=p(o,"--limit",100),{embedder:r,store:e}=await g(),s=await k(r,e,{limit:t});C(s)}},{name:"lookup",description:"Look up indexed content by record ID or source path",usage:"kb lookup <id>",run:async o=>{const t=o.join(" ").trim();t||(console.error("Usage: kb lookup <id>"),process.exit(1));const{store:r}=await g(),e=await r.getById(t);if(e){console.log(e.id),console.log("\u2500".repeat(60)),console.log(`Path: ${e.sourcePath}`),console.log(`Chunk: ${e.chunkIndex+1}/${e.totalChunks}`),console.log(`Lines: ${e.startLine}-${e.endLine}`),console.log(`Type: ${e.contentType} | Origin: ${e.origin}`),e.tags.length>0&&console.log(`Tags: ${e.tags.join(", ")}`),console.log(""),console.log(e.content);return}const s=await r.getBySourcePath(t);if(s.length===0){console.log(`No indexed content found for: ${t}`);return}s.sort((n,a)=>n.chunkIndex-a.chunkIndex),console.log(t),console.log("\u2500".repeat(60)),console.log(`Chunks: ${s.length} | Type: ${s[0].contentType}`);for(const n of s){const a=n.startLine?` (lines ${n.startLine}-${n.endLine})`:"";console.log(`
+Chunk ${n.chunkIndex+1}/${n.totalChunks}${a}`),console.log(n.content)}}}];export{v as searchCommands};