@vpxa/kb 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (275) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +1140 -0
  3. package/bin/kb.mjs +10 -0
  4. package/package.json +67 -0
  5. package/packages/analyzers/dist/blast-radius-analyzer.d.ts +23 -0
  6. package/packages/analyzers/dist/blast-radius-analyzer.js +114 -0
  7. package/packages/analyzers/dist/dependency-analyzer.d.ts +29 -0
  8. package/packages/analyzers/dist/dependency-analyzer.js +425 -0
  9. package/packages/analyzers/dist/diagram-generator.d.ts +13 -0
  10. package/packages/analyzers/dist/diagram-generator.js +86 -0
  11. package/packages/analyzers/dist/entry-point-analyzer.d.ts +19 -0
  12. package/packages/analyzers/dist/entry-point-analyzer.js +239 -0
  13. package/packages/analyzers/dist/index.d.ts +14 -0
  14. package/packages/analyzers/dist/index.js +23 -0
  15. package/packages/analyzers/dist/knowledge-producer.d.ts +32 -0
  16. package/packages/analyzers/dist/knowledge-producer.js +113 -0
  17. package/packages/analyzers/dist/pattern-analyzer.d.ts +12 -0
  18. package/packages/analyzers/dist/pattern-analyzer.js +359 -0
  19. package/packages/analyzers/dist/regex-call-graph.d.ts +17 -0
  20. package/packages/analyzers/dist/regex-call-graph.js +428 -0
  21. package/packages/analyzers/dist/structure-analyzer.d.ts +11 -0
  22. package/packages/analyzers/dist/structure-analyzer.js +258 -0
  23. package/packages/analyzers/dist/symbol-analyzer.d.ts +10 -0
  24. package/packages/analyzers/dist/symbol-analyzer.js +442 -0
  25. package/packages/analyzers/dist/ts-call-graph.d.ts +27 -0
  26. package/packages/analyzers/dist/ts-call-graph.js +160 -0
  27. package/packages/analyzers/dist/types.d.ts +98 -0
  28. package/packages/analyzers/dist/types.js +1 -0
  29. package/packages/chunker/dist/call-graph-extractor.d.ts +22 -0
  30. package/packages/chunker/dist/call-graph-extractor.js +90 -0
  31. package/packages/chunker/dist/chunker-factory.d.ts +7 -0
  32. package/packages/chunker/dist/chunker-factory.js +36 -0
  33. package/packages/chunker/dist/chunker.interface.d.ts +10 -0
  34. package/packages/chunker/dist/chunker.interface.js +1 -0
  35. package/packages/chunker/dist/code-chunker.d.ts +14 -0
  36. package/packages/chunker/dist/code-chunker.js +134 -0
  37. package/packages/chunker/dist/generic-chunker.d.ts +12 -0
  38. package/packages/chunker/dist/generic-chunker.js +72 -0
  39. package/packages/chunker/dist/index.d.ts +8 -0
  40. package/packages/chunker/dist/index.js +21 -0
  41. package/packages/chunker/dist/markdown-chunker.d.ts +14 -0
  42. package/packages/chunker/dist/markdown-chunker.js +122 -0
  43. package/packages/chunker/dist/treesitter-chunker.d.ts +47 -0
  44. package/packages/chunker/dist/treesitter-chunker.js +234 -0
  45. package/packages/cli/dist/commands/analyze.d.ts +3 -0
  46. package/packages/cli/dist/commands/analyze.js +112 -0
  47. package/packages/cli/dist/commands/context-cmds.d.ts +3 -0
  48. package/packages/cli/dist/commands/context-cmds.js +155 -0
  49. package/packages/cli/dist/commands/environment.d.ts +3 -0
  50. package/packages/cli/dist/commands/environment.js +204 -0
  51. package/packages/cli/dist/commands/execution.d.ts +3 -0
  52. package/packages/cli/dist/commands/execution.js +137 -0
  53. package/packages/cli/dist/commands/graph.d.ts +3 -0
  54. package/packages/cli/dist/commands/graph.js +81 -0
  55. package/packages/cli/dist/commands/init.d.ts +8 -0
  56. package/packages/cli/dist/commands/init.js +87 -0
  57. package/packages/cli/dist/commands/knowledge.d.ts +3 -0
  58. package/packages/cli/dist/commands/knowledge.js +139 -0
  59. package/packages/cli/dist/commands/search.d.ts +3 -0
  60. package/packages/cli/dist/commands/search.js +267 -0
  61. package/packages/cli/dist/commands/system.d.ts +3 -0
  62. package/packages/cli/dist/commands/system.js +241 -0
  63. package/packages/cli/dist/commands/workspace.d.ts +3 -0
  64. package/packages/cli/dist/commands/workspace.js +388 -0
  65. package/packages/cli/dist/context.d.ts +5 -0
  66. package/packages/cli/dist/context.js +14 -0
  67. package/packages/cli/dist/helpers.d.ts +52 -0
  68. package/packages/cli/dist/helpers.js +458 -0
  69. package/packages/cli/dist/index.d.ts +8 -0
  70. package/packages/cli/dist/index.js +69 -0
  71. package/packages/cli/dist/kb-init.d.ts +57 -0
  72. package/packages/cli/dist/kb-init.js +82 -0
  73. package/packages/cli/dist/types.d.ts +7 -0
  74. package/packages/cli/dist/types.js +1 -0
  75. package/packages/core/dist/constants.d.ts +49 -0
  76. package/packages/core/dist/constants.js +43 -0
  77. package/packages/core/dist/content-detector.d.ts +9 -0
  78. package/packages/core/dist/content-detector.js +79 -0
  79. package/packages/core/dist/errors.d.ts +18 -0
  80. package/packages/core/dist/errors.js +40 -0
  81. package/packages/core/dist/index.d.ts +6 -0
  82. package/packages/core/dist/index.js +9 -0
  83. package/packages/core/dist/logger.d.ts +9 -0
  84. package/packages/core/dist/logger.js +34 -0
  85. package/packages/core/dist/types.d.ts +108 -0
  86. package/packages/core/dist/types.js +1 -0
  87. package/packages/embeddings/dist/embedder.interface.d.ts +24 -0
  88. package/packages/embeddings/dist/embedder.interface.js +1 -0
  89. package/packages/embeddings/dist/index.d.ts +3 -0
  90. package/packages/embeddings/dist/index.js +5 -0
  91. package/packages/embeddings/dist/onnx-embedder.d.ts +24 -0
  92. package/packages/embeddings/dist/onnx-embedder.js +82 -0
  93. package/packages/indexer/dist/file-hasher.d.ts +11 -0
  94. package/packages/indexer/dist/file-hasher.js +13 -0
  95. package/packages/indexer/dist/filesystem-crawler.d.ts +27 -0
  96. package/packages/indexer/dist/filesystem-crawler.js +125 -0
  97. package/packages/indexer/dist/graph-extractor.d.ts +22 -0
  98. package/packages/indexer/dist/graph-extractor.js +111 -0
  99. package/packages/indexer/dist/incremental-indexer.d.ts +47 -0
  100. package/packages/indexer/dist/incremental-indexer.js +278 -0
  101. package/packages/indexer/dist/index.d.ts +5 -0
  102. package/packages/indexer/dist/index.js +14 -0
  103. package/packages/server/dist/api.d.ts +8 -0
  104. package/packages/server/dist/api.js +9 -0
  105. package/packages/server/dist/config.d.ts +3 -0
  106. package/packages/server/dist/config.js +75 -0
  107. package/packages/server/dist/curated-manager.d.ts +86 -0
  108. package/packages/server/dist/curated-manager.js +357 -0
  109. package/packages/server/dist/index.d.ts +2 -0
  110. package/packages/server/dist/index.js +134 -0
  111. package/packages/server/dist/replay-interceptor.d.ts +11 -0
  112. package/packages/server/dist/replay-interceptor.js +38 -0
  113. package/packages/server/dist/resources/resources.d.ts +4 -0
  114. package/packages/server/dist/resources/resources.js +40 -0
  115. package/packages/server/dist/server.d.ts +21 -0
  116. package/packages/server/dist/server.js +247 -0
  117. package/packages/server/dist/tools/analyze.tools.d.ts +11 -0
  118. package/packages/server/dist/tools/analyze.tools.js +288 -0
  119. package/packages/server/dist/tools/forge.tools.d.ts +12 -0
  120. package/packages/server/dist/tools/forge.tools.js +501 -0
  121. package/packages/server/dist/tools/forget.tool.d.ts +4 -0
  122. package/packages/server/dist/tools/forget.tool.js +43 -0
  123. package/packages/server/dist/tools/graph.tool.d.ts +4 -0
  124. package/packages/server/dist/tools/graph.tool.js +110 -0
  125. package/packages/server/dist/tools/list.tool.d.ts +4 -0
  126. package/packages/server/dist/tools/list.tool.js +56 -0
  127. package/packages/server/dist/tools/lookup.tool.d.ts +4 -0
  128. package/packages/server/dist/tools/lookup.tool.js +53 -0
  129. package/packages/server/dist/tools/onboard.tool.d.ts +5 -0
  130. package/packages/server/dist/tools/onboard.tool.js +112 -0
  131. package/packages/server/dist/tools/produce.tool.d.ts +3 -0
  132. package/packages/server/dist/tools/produce.tool.js +74 -0
  133. package/packages/server/dist/tools/read.tool.d.ts +4 -0
  134. package/packages/server/dist/tools/read.tool.js +49 -0
  135. package/packages/server/dist/tools/reindex.tool.d.ts +7 -0
  136. package/packages/server/dist/tools/reindex.tool.js +70 -0
  137. package/packages/server/dist/tools/remember.tool.d.ts +4 -0
  138. package/packages/server/dist/tools/remember.tool.js +45 -0
  139. package/packages/server/dist/tools/replay.tool.d.ts +3 -0
  140. package/packages/server/dist/tools/replay.tool.js +89 -0
  141. package/packages/server/dist/tools/search.tool.d.ts +5 -0
  142. package/packages/server/dist/tools/search.tool.js +331 -0
  143. package/packages/server/dist/tools/status.tool.d.ts +4 -0
  144. package/packages/server/dist/tools/status.tool.js +68 -0
  145. package/packages/server/dist/tools/toolkit.tools.d.ts +35 -0
  146. package/packages/server/dist/tools/toolkit.tools.js +1674 -0
  147. package/packages/server/dist/tools/update.tool.d.ts +4 -0
  148. package/packages/server/dist/tools/update.tool.js +42 -0
  149. package/packages/server/dist/tools/utility.tools.d.ts +15 -0
  150. package/packages/server/dist/tools/utility.tools.js +461 -0
  151. package/packages/store/dist/graph-store.interface.d.ts +104 -0
  152. package/packages/store/dist/graph-store.interface.js +1 -0
  153. package/packages/store/dist/index.d.ts +6 -0
  154. package/packages/store/dist/index.js +9 -0
  155. package/packages/store/dist/lance-store.d.ts +32 -0
  156. package/packages/store/dist/lance-store.js +258 -0
  157. package/packages/store/dist/sqlite-graph-store.d.ts +43 -0
  158. package/packages/store/dist/sqlite-graph-store.js +374 -0
  159. package/packages/store/dist/store-factory.d.ts +9 -0
  160. package/packages/store/dist/store-factory.js +14 -0
  161. package/packages/store/dist/store.interface.d.ts +48 -0
  162. package/packages/store/dist/store.interface.js +1 -0
  163. package/packages/tools/dist/batch.d.ts +21 -0
  164. package/packages/tools/dist/batch.js +45 -0
  165. package/packages/tools/dist/changelog.d.ts +34 -0
  166. package/packages/tools/dist/changelog.js +112 -0
  167. package/packages/tools/dist/check.d.ts +26 -0
  168. package/packages/tools/dist/check.js +59 -0
  169. package/packages/tools/dist/checkpoint.d.ts +17 -0
  170. package/packages/tools/dist/checkpoint.js +43 -0
  171. package/packages/tools/dist/codemod.d.ts +37 -0
  172. package/packages/tools/dist/codemod.js +69 -0
  173. package/packages/tools/dist/compact.d.ts +41 -0
  174. package/packages/tools/dist/compact.js +60 -0
  175. package/packages/tools/dist/data-transform.d.ts +10 -0
  176. package/packages/tools/dist/data-transform.js +124 -0
  177. package/packages/tools/dist/dead-symbols.d.ts +21 -0
  178. package/packages/tools/dist/dead-symbols.js +71 -0
  179. package/packages/tools/dist/delegate.d.ts +34 -0
  180. package/packages/tools/dist/delegate.js +130 -0
  181. package/packages/tools/dist/diff-parse.d.ts +26 -0
  182. package/packages/tools/dist/diff-parse.js +153 -0
  183. package/packages/tools/dist/digest.d.ts +53 -0
  184. package/packages/tools/dist/digest.js +242 -0
  185. package/packages/tools/dist/encode.d.ts +14 -0
  186. package/packages/tools/dist/encode.js +46 -0
  187. package/packages/tools/dist/env-info.d.ts +28 -0
  188. package/packages/tools/dist/env-info.js +58 -0
  189. package/packages/tools/dist/eval.d.ts +13 -0
  190. package/packages/tools/dist/eval.js +79 -0
  191. package/packages/tools/dist/evidence-map.d.ts +79 -0
  192. package/packages/tools/dist/evidence-map.js +203 -0
  193. package/packages/tools/dist/file-summary.d.ts +32 -0
  194. package/packages/tools/dist/file-summary.js +106 -0
  195. package/packages/tools/dist/file-walk.d.ts +4 -0
  196. package/packages/tools/dist/file-walk.js +75 -0
  197. package/packages/tools/dist/find-examples.d.ts +25 -0
  198. package/packages/tools/dist/find-examples.js +48 -0
  199. package/packages/tools/dist/find.d.ts +47 -0
  200. package/packages/tools/dist/find.js +120 -0
  201. package/packages/tools/dist/forge-classify.d.ts +44 -0
  202. package/packages/tools/dist/forge-classify.js +319 -0
  203. package/packages/tools/dist/forge-ground.d.ts +64 -0
  204. package/packages/tools/dist/forge-ground.js +184 -0
  205. package/packages/tools/dist/git-context.d.ts +22 -0
  206. package/packages/tools/dist/git-context.js +46 -0
  207. package/packages/tools/dist/graph-query.d.ts +89 -0
  208. package/packages/tools/dist/graph-query.js +194 -0
  209. package/packages/tools/dist/health.d.ts +14 -0
  210. package/packages/tools/dist/health.js +118 -0
  211. package/packages/tools/dist/http-request.d.ts +23 -0
  212. package/packages/tools/dist/http-request.js +58 -0
  213. package/packages/tools/dist/index.d.ts +49 -0
  214. package/packages/tools/dist/index.js +273 -0
  215. package/packages/tools/dist/lane.d.ts +39 -0
  216. package/packages/tools/dist/lane.js +227 -0
  217. package/packages/tools/dist/measure.d.ts +38 -0
  218. package/packages/tools/dist/measure.js +119 -0
  219. package/packages/tools/dist/onboard.d.ts +41 -0
  220. package/packages/tools/dist/onboard.js +1139 -0
  221. package/packages/tools/dist/parse-output.d.ts +80 -0
  222. package/packages/tools/dist/parse-output.js +158 -0
  223. package/packages/tools/dist/process-manager.d.ts +18 -0
  224. package/packages/tools/dist/process-manager.js +69 -0
  225. package/packages/tools/dist/queue.d.ts +38 -0
  226. package/packages/tools/dist/queue.js +126 -0
  227. package/packages/tools/dist/regex-test.d.ts +31 -0
  228. package/packages/tools/dist/regex-test.js +39 -0
  229. package/packages/tools/dist/rename.d.ts +29 -0
  230. package/packages/tools/dist/rename.js +70 -0
  231. package/packages/tools/dist/replay.d.ts +56 -0
  232. package/packages/tools/dist/replay.js +108 -0
  233. package/packages/tools/dist/schema-validate.d.ts +23 -0
  234. package/packages/tools/dist/schema-validate.js +141 -0
  235. package/packages/tools/dist/scope-map.d.ts +52 -0
  236. package/packages/tools/dist/scope-map.js +72 -0
  237. package/packages/tools/dist/snippet.d.ts +34 -0
  238. package/packages/tools/dist/snippet.js +80 -0
  239. package/packages/tools/dist/stash.d.ts +12 -0
  240. package/packages/tools/dist/stash.js +60 -0
  241. package/packages/tools/dist/stratum-card.d.ts +31 -0
  242. package/packages/tools/dist/stratum-card.js +239 -0
  243. package/packages/tools/dist/symbol.d.ts +28 -0
  244. package/packages/tools/dist/symbol.js +87 -0
  245. package/packages/tools/dist/test-run.d.ts +23 -0
  246. package/packages/tools/dist/test-run.js +55 -0
  247. package/packages/tools/dist/text-utils.d.ts +16 -0
  248. package/packages/tools/dist/text-utils.js +31 -0
  249. package/packages/tools/dist/time-utils.d.ts +18 -0
  250. package/packages/tools/dist/time-utils.js +135 -0
  251. package/packages/tools/dist/trace.d.ts +24 -0
  252. package/packages/tools/dist/trace.js +114 -0
  253. package/packages/tools/dist/truncation.d.ts +22 -0
  254. package/packages/tools/dist/truncation.js +45 -0
  255. package/packages/tools/dist/watch.d.ts +30 -0
  256. package/packages/tools/dist/watch.js +61 -0
  257. package/packages/tools/dist/web-fetch.d.ts +45 -0
  258. package/packages/tools/dist/web-fetch.js +249 -0
  259. package/packages/tools/dist/web-search.d.ts +23 -0
  260. package/packages/tools/dist/web-search.js +46 -0
  261. package/packages/tools/dist/workset.d.ts +45 -0
  262. package/packages/tools/dist/workset.js +77 -0
  263. package/packages/tui/dist/App.d.ts +8 -0
  264. package/packages/tui/dist/App.js +52659 -0
  265. package/packages/tui/dist/index.d.ts +19 -0
  266. package/packages/tui/dist/index.js +54742 -0
  267. package/packages/tui/dist/panels/CuratedPanel.d.ts +8 -0
  268. package/packages/tui/dist/panels/CuratedPanel.js +34452 -0
  269. package/packages/tui/dist/panels/LogPanel.d.ts +3 -0
  270. package/packages/tui/dist/panels/LogPanel.js +51894 -0
  271. package/packages/tui/dist/panels/SearchPanel.d.ts +10 -0
  272. package/packages/tui/dist/panels/SearchPanel.js +34985 -0
  273. package/packages/tui/dist/panels/StatusPanel.d.ts +8 -0
  274. package/packages/tui/dist/panels/StatusPanel.js +34465 -0
  275. package/skills/knowledge-base/SKILL.md +316 -0
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { CuratedKnowledgeManager } from '../curated-manager.js';
3
+ export declare function registerUpdateTool(server: McpServer, curated: CuratedKnowledgeManager): void;
4
+ //# sourceMappingURL=update.tool.d.ts.map
@@ -0,0 +1,42 @@
1
+ import { z } from "zod";
2
+ function registerUpdateTool(server, curated) {
3
+ server.registerTool(
4
+ "update",
5
+ {
6
+ description: "Update an existing curated knowledge entry. Increments version and records the reason in the changelog.",
7
+ inputSchema: {
8
+ path: z.string().describe('Relative path within curated/ (e.g., "decisions/use-lancedb.md")'),
9
+ content: z.string().min(10).describe("New markdown content to replace existing content"),
10
+ reason: z.string().min(3).describe("Why this update is being made (recorded in changelog)")
11
+ }
12
+ },
13
+ async ({ path, content, reason }) => {
14
+ try {
15
+ const result = await curated.update(path, content, reason);
16
+ return {
17
+ content: [
18
+ {
19
+ type: "text",
20
+ text: `Updated: \`curated/${result.path}\` \u2192 version ${result.version}
21
+
22
+ Reason: ${reason}
23
+
24
+ ---
25
+ _Next: Use \`read\` to verify the updated content, or \`search\` to test searchability._`
26
+ }
27
+ ]
28
+ };
29
+ } catch (err) {
30
+ console.error("[KB] Update failed:", err);
31
+ return {
32
+ content: [{ type: "text", text: `Update failed: ${err.message}` }],
33
+ isError: true
34
+ };
35
+ }
36
+ }
37
+ );
38
+ }
39
+ export {
40
+ registerUpdateTool
41
+ };
42
+ //# sourceMappingURL=update.tool.js.map
@@ -0,0 +1,15 @@
1
+ /**
2
+ * MCP tool registrations for utility tools (web-search, http, regex, encode, etc.)
3
+ */
4
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
5
+ export declare function registerWebSearchTool(server: McpServer): void;
6
+ export declare function registerHttpTool(server: McpServer): void;
7
+ export declare function registerRegexTestTool(server: McpServer): void;
8
+ export declare function registerEncodeTool(server: McpServer): void;
9
+ export declare function registerMeasureTool(server: McpServer): void;
10
+ export declare function registerChangelogTool(server: McpServer): void;
11
+ export declare function registerSchemaValidateTool(server: McpServer): void;
12
+ export declare function registerSnippetTool(server: McpServer): void;
13
+ export declare function registerEnvTool(server: McpServer): void;
14
+ export declare function registerTimeTool(server: McpServer): void;
15
+ //# sourceMappingURL=utility.tools.d.ts.map
@@ -0,0 +1,461 @@
1
+ import {
2
+ changelog,
3
+ encode,
4
+ envInfo,
5
+ httpRequest,
6
+ measure,
7
+ regexTest,
8
+ schemaValidate,
9
+ snippet,
10
+ timeUtils,
11
+ webSearch
12
+ } from "@kb/tools";
13
+ import { z } from "zod";
14
+ function registerWebSearchTool(server) {
15
+ server.registerTool(
16
+ "web_search",
17
+ {
18
+ description: "PREFERRED web search \u2014 search the web via DuckDuckGo (no API key). Returns structured results with title, URL, and snippet.",
19
+ inputSchema: {
20
+ query: z.string().describe("Search query"),
21
+ limit: z.number().min(1).max(20).default(5).describe("Max results to return"),
22
+ site: z.string().optional().describe('Restrict to domain (e.g., "docs.aws.amazon.com")')
23
+ }
24
+ },
25
+ async ({ query, limit, site }) => {
26
+ try {
27
+ const result = await webSearch({ query, limit, site });
28
+ const lines = [`## Search: ${result.query}`, ""];
29
+ if (result.results.length === 0) {
30
+ lines.push("No results found.");
31
+ } else {
32
+ for (const r of result.results) {
33
+ lines.push(`### [${r.title}](${r.url})`, r.snippet, "");
34
+ }
35
+ }
36
+ lines.push("---", "_Next: Use `web_fetch` to read any of these pages in full._");
37
+ return { content: [{ type: "text", text: lines.join("\n") }] };
38
+ } catch (err) {
39
+ return {
40
+ content: [
41
+ { type: "text", text: `Web search failed: ${err.message}` }
42
+ ],
43
+ isError: true
44
+ };
45
+ }
46
+ }
47
+ );
48
+ }
49
+ function registerHttpTool(server) {
50
+ server.registerTool(
51
+ "http",
52
+ {
53
+ description: "Make HTTP requests (GET/POST/PUT/PATCH/DELETE/HEAD) for API testing. Returns status, headers, and formatted body with timing info.",
54
+ inputSchema: {
55
+ url: z.string().url().describe("Request URL (http/https only)"),
56
+ method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"]).default("GET").describe("HTTP method"),
57
+ headers: z.record(z.string(), z.string()).optional().describe("Request headers as key-value pairs"),
58
+ body: z.string().optional().describe("Request body (for POST/PUT/PATCH)"),
59
+ timeout: z.number().min(1e3).max(6e4).default(15e3).describe("Timeout in milliseconds")
60
+ }
61
+ },
62
+ async ({ url, method, headers, body, timeout }) => {
63
+ try {
64
+ const result = await httpRequest({
65
+ url,
66
+ method,
67
+ headers,
68
+ body,
69
+ timeout
70
+ });
71
+ const lines = [
72
+ `## ${method} ${url}`,
73
+ "",
74
+ `**Status:** ${result.status} ${result.statusText}`,
75
+ `**Time:** ${result.durationMs}ms`,
76
+ `**Size:** ${result.sizeBytes} bytes`,
77
+ `**Content-Type:** ${result.contentType}`,
78
+ "",
79
+ "### Headers",
80
+ "```json",
81
+ JSON.stringify(result.headers, null, 2),
82
+ "```",
83
+ "",
84
+ "### Body",
85
+ result.contentType.includes("json") ? "```json" : "```",
86
+ result.body,
87
+ "```"
88
+ ];
89
+ if (result.truncated) {
90
+ lines.push("", `_Response truncated \u2014 total size: ${result.sizeBytes} bytes_`);
91
+ }
92
+ return { content: [{ type: "text", text: lines.join("\n") }] };
93
+ } catch (err) {
94
+ return {
95
+ content: [
96
+ { type: "text", text: `HTTP request failed: ${err.message}` }
97
+ ],
98
+ isError: true
99
+ };
100
+ }
101
+ }
102
+ );
103
+ }
104
+ function registerRegexTestTool(server) {
105
+ server.registerTool(
106
+ "regex_test",
107
+ {
108
+ description: "Test a regex pattern against sample strings. Supports match, replace, and split modes.",
109
+ inputSchema: {
110
+ pattern: z.string().describe("Regex pattern (without delimiters)"),
111
+ flags: z.string().default("").describe("Regex flags (g, i, m, s, etc.)"),
112
+ test_strings: z.array(z.string()).describe("Strings to test the pattern against"),
113
+ mode: z.enum(["match", "replace", "split"]).default("match").describe("Test mode"),
114
+ replacement: z.string().optional().describe("Replacement string (for replace mode)")
115
+ }
116
+ },
117
+ async ({ pattern, flags, test_strings, mode, replacement }) => {
118
+ const result = regexTest({
119
+ pattern,
120
+ flags,
121
+ testStrings: test_strings,
122
+ mode,
123
+ replacement
124
+ });
125
+ if (!result.valid) {
126
+ return {
127
+ content: [{ type: "text", text: `Invalid regex: ${result.error}` }],
128
+ isError: true
129
+ };
130
+ }
131
+ const lines = [`## Regex: \`/${result.pattern}/${result.flags}\``, "", `Mode: ${mode}`, ""];
132
+ for (const r of result.results) {
133
+ lines.push(`**Input:** \`${r.input}\``);
134
+ lines.push(`**Matched:** ${r.matched}`);
135
+ if (r.matches) {
136
+ for (const m of r.matches) {
137
+ const groups = m.groups.length > 0 ? ` groups: [${m.groups.join(", ")}]` : "";
138
+ lines.push(` - "${m.full}" at index ${m.index}${groups}`);
139
+ }
140
+ }
141
+ if (r.replaced !== void 0) lines.push(`**Result:** \`${r.replaced}\``);
142
+ if (r.split) lines.push(`**Split:** ${JSON.stringify(r.split)}`);
143
+ lines.push("");
144
+ }
145
+ return { content: [{ type: "text", text: lines.join("\n") }] };
146
+ }
147
+ );
148
+ }
149
+ function registerEncodeTool(server) {
150
+ server.registerTool(
151
+ "encode",
152
+ {
153
+ description: "Encode, decode, or hash text. Supports base64, URL encoding, SHA-256, MD5, JWT decode, hex.",
154
+ inputSchema: {
155
+ operation: z.enum([
156
+ "base64_encode",
157
+ "base64_decode",
158
+ "url_encode",
159
+ "url_decode",
160
+ "sha256",
161
+ "md5",
162
+ "jwt_decode",
163
+ "hex_encode",
164
+ "hex_decode"
165
+ ]).describe("Operation to perform"),
166
+ input: z.string().describe("Input text")
167
+ }
168
+ },
169
+ async ({ operation, input }) => {
170
+ try {
171
+ const result = encode({ operation, input });
172
+ return {
173
+ content: [
174
+ {
175
+ type: "text",
176
+ text: `## ${operation}
177
+
178
+ **Input:** \`${input.length > 100 ? `${input.slice(0, 100)}...` : input}\`
179
+ **Output:**
180
+ \`\`\`
181
+ ${result.output}
182
+ \`\`\``
183
+ }
184
+ ]
185
+ };
186
+ } catch (err) {
187
+ return {
188
+ content: [{ type: "text", text: `Encode failed: ${err.message}` }],
189
+ isError: true
190
+ };
191
+ }
192
+ }
193
+ );
194
+ }
195
+ function registerMeasureTool(server) {
196
+ server.registerTool(
197
+ "measure",
198
+ {
199
+ description: "Measure code complexity, line counts, and function counts for a file or directory. Returns per-file metrics sorted by complexity.",
200
+ inputSchema: {
201
+ path: z.string().describe("File or directory path to measure"),
202
+ extensions: z.array(z.string()).optional().describe("File extensions to include (default: .ts,.tsx,.js,.jsx)")
203
+ }
204
+ },
205
+ async ({ path, extensions }) => {
206
+ try {
207
+ const result = measure({ path, extensions });
208
+ const lines = [
209
+ "## Code Metrics",
210
+ "",
211
+ `**Files:** ${result.summary.totalFiles}`,
212
+ `**Total lines:** ${result.summary.totalLines} (${result.summary.totalCodeLines} code)`,
213
+ `**Functions:** ${result.summary.totalFunctions}`,
214
+ `**Avg complexity:** ${result.summary.avgComplexity}`,
215
+ `**Max complexity:** ${result.summary.maxComplexity.value} (${result.summary.maxComplexity.file})`,
216
+ "",
217
+ "### Top files by complexity",
218
+ "",
219
+ "| File | Lines | Code | Complexity | Functions | Imports |",
220
+ "|------|-------|------|------------|-----------|---------|"
221
+ ];
222
+ for (const f of result.files.slice(0, 20)) {
223
+ lines.push(
224
+ `| ${f.path} | ${f.lines.total} | ${f.lines.code} | ${f.complexity} | ${f.functions} | ${f.imports} |`
225
+ );
226
+ }
227
+ if (result.files.length > 20) {
228
+ lines.push(``, `_...and ${result.files.length - 20} more files_`);
229
+ }
230
+ return { content: [{ type: "text", text: lines.join("\n") }] };
231
+ } catch (err) {
232
+ return {
233
+ content: [{ type: "text", text: `Measure failed: ${err.message}` }],
234
+ isError: true
235
+ };
236
+ }
237
+ }
238
+ );
239
+ }
240
+ function registerChangelogTool(server) {
241
+ server.registerTool(
242
+ "changelog",
243
+ {
244
+ description: "Generate a changelog from git history between two refs. Groups by conventional commit type.",
245
+ inputSchema: {
246
+ from: z.string().describe("Start ref (tag, SHA, HEAD~N)"),
247
+ to: z.string().default("HEAD").describe("End ref (default: HEAD)"),
248
+ format: z.enum(["grouped", "chronological", "per-scope"]).default("grouped").describe("Output format"),
249
+ include_breaking: z.boolean().default(true).describe("Highlight breaking changes")
250
+ }
251
+ },
252
+ async ({ from, to, format, include_breaking }) => {
253
+ try {
254
+ const result = changelog({ from, to, format, includeBreaking: include_breaking });
255
+ const stats = `${result.stats.total} commits (${Object.entries(result.stats.types).map(([k, v]) => `${v} ${k}`).join(", ")})`;
256
+ return {
257
+ content: [
258
+ {
259
+ type: "text",
260
+ text: `${result.markdown}
261
+ ---
262
+ _${stats}_`
263
+ }
264
+ ]
265
+ };
266
+ } catch (err) {
267
+ return {
268
+ content: [{ type: "text", text: `Changelog failed: ${err.message}` }],
269
+ isError: true
270
+ };
271
+ }
272
+ }
273
+ );
274
+ }
275
+ function registerSchemaValidateTool(server) {
276
+ server.registerTool(
277
+ "schema_validate",
278
+ {
279
+ description: "Validate JSON data against a JSON Schema. Supports type, required, properties, items, enum, pattern, min/max.",
280
+ inputSchema: {
281
+ data: z.string().describe("JSON data to validate (as string)"),
282
+ schema: z.string().describe("JSON Schema to validate against (as string)")
283
+ }
284
+ },
285
+ async ({ data, schema }) => {
286
+ try {
287
+ const parsedData = JSON.parse(data);
288
+ const parsedSchema = JSON.parse(schema);
289
+ const result = schemaValidate({ data: parsedData, schema: parsedSchema });
290
+ if (result.valid) {
291
+ return {
292
+ content: [
293
+ { type: "text", text: "## Validation: PASSED\n\nData matches the schema." }
294
+ ]
295
+ };
296
+ }
297
+ const lines = ["## Validation: FAILED", "", `**${result.errors.length} error(s):**`, ""];
298
+ for (const e of result.errors) {
299
+ const detail = e.expected ? ` (expected: ${e.expected}, got: ${e.received})` : "";
300
+ lines.push(`- \`${e.path}\`: ${e.message}${detail}`);
301
+ }
302
+ return { content: [{ type: "text", text: lines.join("\n") }] };
303
+ } catch (err) {
304
+ return {
305
+ content: [
306
+ { type: "text", text: `Schema validation failed: ${err.message}` }
307
+ ],
308
+ isError: true
309
+ };
310
+ }
311
+ }
312
+ );
313
+ }
314
+ function registerSnippetTool(server) {
315
+ server.registerTool(
316
+ "snippet",
317
+ {
318
+ description: "Save, retrieve, search, and manage persistent code snippets/templates.",
319
+ inputSchema: {
320
+ action: z.enum(["save", "get", "list", "search", "delete"]).describe("Operation to perform"),
321
+ name: z.string().optional().describe("Snippet name (required for save/get/delete)"),
322
+ language: z.string().optional().describe("Language tag (for save)"),
323
+ code: z.string().optional().describe("Code content (for save)"),
324
+ tags: z.array(z.string()).optional().describe("Tags for categorization (for save)"),
325
+ query: z.string().optional().describe("Search query (for search)")
326
+ }
327
+ },
328
+ async ({ action, name, language, code, tags, query }) => {
329
+ try {
330
+ const result = snippet({ action, name, language, code, tags, query });
331
+ if ("deleted" in result) {
332
+ return {
333
+ content: [
334
+ {
335
+ type: "text",
336
+ text: result.deleted ? `Snippet "${name}" deleted.` : `Snippet "${name}" not found.`
337
+ }
338
+ ]
339
+ };
340
+ }
341
+ if ("snippets" in result) {
342
+ if (result.snippets.length === 0) {
343
+ return { content: [{ type: "text", text: "No snippets found." }] };
344
+ }
345
+ const lines = ["## Snippets", ""];
346
+ for (const s2 of result.snippets) {
347
+ const tagStr2 = s2.tags.length > 0 ? ` [${s2.tags.join(", ")}]` : "";
348
+ lines.push(`- **${s2.name}** (${s2.language})${tagStr2}`);
349
+ }
350
+ return { content: [{ type: "text", text: lines.join("\n") }] };
351
+ }
352
+ const s = result;
353
+ const tagStr = s.tags.length > 0 ? `
354
+ Tags: ${s.tags.join(", ")}` : "";
355
+ return {
356
+ content: [
357
+ {
358
+ type: "text",
359
+ text: `## ${s.name} (${s.language})${tagStr}
360
+
361
+ \`\`\`${s.language}
362
+ ${s.code}
363
+ \`\`\``
364
+ }
365
+ ]
366
+ };
367
+ } catch (err) {
368
+ return {
369
+ content: [{ type: "text", text: `Snippet failed: ${err.message}` }],
370
+ isError: true
371
+ };
372
+ }
373
+ }
374
+ );
375
+ }
376
+ function registerEnvTool(server) {
377
+ server.registerTool(
378
+ "env",
379
+ {
380
+ description: "Get system and runtime environment info. Sensitive env vars are redacted by default.",
381
+ inputSchema: {
382
+ include_env: z.boolean().default(false).describe("Include environment variables"),
383
+ filter_env: z.string().optional().describe("Filter env vars by name substring"),
384
+ show_sensitive: z.boolean().default(false).describe("Show sensitive values (keys, tokens, etc.) \u2014 redacted by default")
385
+ }
386
+ },
387
+ async ({ include_env, filter_env, show_sensitive }) => {
388
+ const result = envInfo({
389
+ includeEnv: include_env,
390
+ filterEnv: filter_env,
391
+ showSensitive: show_sensitive
392
+ });
393
+ const lines = [
394
+ "## Environment",
395
+ "",
396
+ `**Platform:** ${result.system.platform} ${result.system.arch}`,
397
+ `**OS:** ${result.system.type} ${result.system.release}`,
398
+ `**Host:** ${result.system.hostname}`,
399
+ `**CPUs:** ${result.system.cpus}`,
400
+ `**Memory:** ${result.system.memoryFreeGb}GB free / ${result.system.memoryTotalGb}GB total`,
401
+ "",
402
+ `**Node:** ${result.runtime.node}`,
403
+ `**V8:** ${result.runtime.v8}`,
404
+ `**CWD:** ${result.cwd}`
405
+ ];
406
+ if (result.env) {
407
+ lines.push("", "### Environment Variables", "");
408
+ for (const [key, value] of Object.entries(result.env)) {
409
+ lines.push(`- \`${key}\`: ${value}`);
410
+ }
411
+ }
412
+ return { content: [{ type: "text", text: lines.join("\n") }] };
413
+ }
414
+ );
415
+ }
416
+ function registerTimeTool(server) {
417
+ server.registerTool(
418
+ "time",
419
+ {
420
+ description: "Parse dates, convert timezones, calculate durations, add time. Supports ISO 8601, unix timestamps, and human-readable formats.",
421
+ inputSchema: {
422
+ operation: z.enum(["now", "parse", "convert", "diff", "add"]).describe(
423
+ "now: current time | parse: parse a date string | convert: timezone conversion | diff: duration between two dates | add: add duration to date"
424
+ ),
425
+ input: z.string().optional().describe(
426
+ "Date input (ISO, unix timestamp, or parseable string). For diff: two comma-separated dates"
427
+ ),
428
+ timezone: z.string().optional().describe('Target timezone (e.g., "America/New_York", "Asia/Tokyo")'),
429
+ duration: z.string().optional().describe('Duration to add (e.g., "2h30m", "1d", "30s") \u2014 for add operation')
430
+ }
431
+ },
432
+ async ({ operation, input, timezone, duration }) => {
433
+ try {
434
+ const result = timeUtils({ operation, input, timezone, duration });
435
+ const lines = [`**${result.output}**`, "", `ISO: ${result.iso}`, `Unix: ${result.unix}`];
436
+ if (result.details) {
437
+ lines.push("", "```json", JSON.stringify(result.details, null, 2), "```");
438
+ }
439
+ return { content: [{ type: "text", text: lines.join("\n") }] };
440
+ } catch (err) {
441
+ return {
442
+ content: [{ type: "text", text: `Time failed: ${err.message}` }],
443
+ isError: true
444
+ };
445
+ }
446
+ }
447
+ );
448
+ }
449
+ export {
450
+ registerChangelogTool,
451
+ registerEncodeTool,
452
+ registerEnvTool,
453
+ registerHttpTool,
454
+ registerMeasureTool,
455
+ registerRegexTestTool,
456
+ registerSchemaValidateTool,
457
+ registerSnippetTool,
458
+ registerTimeTool,
459
+ registerWebSearchTool
460
+ };
461
+ //# sourceMappingURL=utility.tools.js.map
@@ -0,0 +1,104 @@
1
+ /**
2
+ * Knowledge graph store abstraction — typed nodes + edges for entity-relationship storage.
3
+ * Complements the vector store: vector search finds similar content,
4
+ * graph traversal finds connected concepts.
5
+ */
6
+ /** A node in the knowledge graph (entity, concept, service, etc.) */
7
+ export interface GraphNode {
8
+ /** Unique identifier */
9
+ id: string;
10
+ /** Node type (e.g., 'entity', 'service', 'api', 'concept', 'decision') */
11
+ type: string;
12
+ /** Display name */
13
+ name: string;
14
+ /** Arbitrary properties */
15
+ properties: Record<string, unknown>;
16
+ /** Back-link to KnowledgeRecord.id that produced this node */
17
+ sourceRecordId?: string;
18
+ /** Source file path (for cleanup on re-index) */
19
+ sourcePath?: string;
20
+ /** ISO timestamp */
21
+ createdAt?: string;
22
+ }
23
+ /** An edge connecting two nodes */
24
+ export interface GraphEdge {
25
+ /** Unique identifier */
26
+ id: string;
27
+ /** Source node ID */
28
+ fromId: string;
29
+ /** Target node ID */
30
+ toId: string;
31
+ /** Relationship type (e.g., 'depends-on', 'implements', 'calls', 'affects') */
32
+ type: string;
33
+ /** Optional weight (0-1) */
34
+ weight?: number;
35
+ /** Arbitrary properties */
36
+ properties?: Record<string, unknown>;
37
+ }
38
+ /** Options for graph traversal */
39
+ export interface GraphTraversalOptions {
40
+ /** Relationship type filter */
41
+ edgeType?: string;
42
+ /** Max traversal depth (default: 2) */
43
+ maxDepth?: number;
44
+ /** Direction: outgoing from start, incoming to start, or both */
45
+ direction?: 'outgoing' | 'incoming' | 'both';
46
+ /** Max total nodes returned (default: 50) */
47
+ limit?: number;
48
+ }
49
+ /** Result of a graph traversal */
50
+ export interface GraphTraversalResult {
51
+ nodes: GraphNode[];
52
+ edges: GraphEdge[];
53
+ }
54
+ /** Graph statistics */
55
+ export interface GraphStats {
56
+ nodeCount: number;
57
+ edgeCount: number;
58
+ nodeTypes: Record<string, number>;
59
+ edgeTypes: Record<string, number>;
60
+ }
61
+ /** Knowledge graph store interface */
62
+ export interface IGraphStore {
63
+ /** Initialize the store (create tables, indices) */
64
+ initialize(): Promise<void>;
65
+ /** Add or update a single node */
66
+ upsertNode(node: GraphNode): Promise<void>;
67
+ /** Add or update a single edge */
68
+ upsertEdge(edge: GraphEdge): Promise<void>;
69
+ /** Batch add/update nodes */
70
+ upsertNodes(nodes: GraphNode[]): Promise<void>;
71
+ /** Batch add/update edges */
72
+ upsertEdges(edges: GraphEdge[]): Promise<void>;
73
+ /** Get a node by ID */
74
+ getNode(id: string): Promise<GraphNode | null>;
75
+ /** Get direct neighbors of a node */
76
+ getNeighbors(nodeId: string, options?: GraphTraversalOptions): Promise<GraphTraversalResult>;
77
+ /** Multi-hop traversal from a starting node */
78
+ traverse(startId: string, options?: GraphTraversalOptions): Promise<GraphTraversalResult>;
79
+ /** Find nodes by type and/or name pattern */
80
+ findNodes(filter: {
81
+ type?: string;
82
+ namePattern?: string;
83
+ sourcePath?: string;
84
+ limit?: number;
85
+ }): Promise<GraphNode[]>;
86
+ /** Find edges by type between optional node filters */
87
+ findEdges(filter: {
88
+ type?: string;
89
+ fromId?: string;
90
+ toId?: string;
91
+ limit?: number;
92
+ }): Promise<GraphEdge[]>;
93
+ /** Delete a node and all its edges */
94
+ deleteNode(id: string): Promise<void>;
95
+ /** Delete all nodes/edges originating from a source path */
96
+ deleteBySourcePath(sourcePath: string): Promise<number>;
97
+ /** Delete all nodes and edges (full reset) */
98
+ clear(): Promise<void>;
99
+ /** Get graph statistics */
100
+ getStats(): Promise<GraphStats>;
101
+ /** Close the store */
102
+ close(): Promise<void>;
103
+ }
104
+ //# sourceMappingURL=graph-store.interface.d.ts.map
@@ -0,0 +1 @@
1
+ //# sourceMappingURL=graph-store.interface.js.map
@@ -0,0 +1,6 @@
1
+ export type { GraphEdge, GraphNode, GraphStats, GraphTraversalOptions, GraphTraversalResult, IGraphStore, } from './graph-store.interface.js';
2
+ export { LanceStore } from './lance-store.js';
3
+ export { SqliteGraphStore } from './sqlite-graph-store.js';
4
+ export type { IKnowledgeStore, SearchOptions } from './store.interface.js';
5
+ export { createStore, type StoreBackend, type StoreConfig } from './store-factory.js';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,9 @@
1
+ import { LanceStore } from "./lance-store.js";
2
+ import { SqliteGraphStore } from "./sqlite-graph-store.js";
3
+ import { createStore } from "./store-factory.js";
4
+ export {
5
+ LanceStore,
6
+ SqliteGraphStore,
7
+ createStore
8
+ };
9
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,32 @@
1
+ /**
2
+ * LanceDB implementation of the knowledge store.
3
+ * Uses @lancedb/lancedb for local vector + full-text search.
4
+ */
5
+ import type { IndexStats, KnowledgeRecord, SearchResult } from '@kb/core';
6
+ import type { IKnowledgeStore, SearchOptions } from './store.interface.js';
7
+ export declare class LanceStore implements IKnowledgeStore {
8
+ private db;
9
+ private table;
10
+ private readonly dbPath;
11
+ private readonly tableName;
12
+ constructor(options?: {
13
+ path?: string;
14
+ tableName?: string;
15
+ });
16
+ initialize(): Promise<void>;
17
+ upsert(records: KnowledgeRecord[], vectors: Float32Array[]): Promise<void>;
18
+ search(queryVector: Float32Array, options?: SearchOptions): Promise<SearchResult[]>;
19
+ createFtsIndex(): Promise<void>;
20
+ ftsSearch(query: string, options?: SearchOptions): Promise<SearchResult[]>;
21
+ getById(id: string): Promise<KnowledgeRecord | null>;
22
+ deleteBySourcePath(sourcePath: string): Promise<number>;
23
+ deleteById(id: string): Promise<boolean>;
24
+ getBySourcePath(sourcePath: string): Promise<KnowledgeRecord[]>;
25
+ getStats(): Promise<IndexStats>;
26
+ listSourcePaths(): Promise<string[]>;
27
+ dropTable(): Promise<void>;
28
+ close(): Promise<void>;
29
+ private buildFilterString;
30
+ private fromLanceRecord;
31
+ }
32
+ //# sourceMappingURL=lance-store.d.ts.map