@dikolab/kbdb 0.6.1 → 0.6.3

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 (49) hide show
  1. package/README.md +33 -6
  2. package/README.md.bak +33 -6
  3. package/dist/README.md +33 -6
  4. package/dist/cli.cjs +663 -218
  5. package/dist/cli.cjs.map +3 -3
  6. package/dist/cli.mjs +663 -218
  7. package/dist/cli.mjs.map +3 -3
  8. package/dist/kbdb-worker.cjs +71 -12
  9. package/dist/kbdb-worker.cjs.map +3 -3
  10. package/dist/mod.cjs +1 -1
  11. package/dist/mod.cjs.map +1 -1
  12. package/dist/mod.mjs +1 -1
  13. package/dist/mod.mjs.map +1 -1
  14. package/dist/src/shared/cli/constants/recfile-field-maps.constant.d.ts +3 -1
  15. package/dist/src/shared/cli/functions/format-command-output.function.d.ts +0 -4
  16. package/dist/src/shared/cli/functions/format-command-text.function.d.ts +1 -0
  17. package/dist/src/shared/cli/functions/format-mcp-output.function.d.ts +5 -4
  18. package/dist/src/shared/cli/functions/format-output.function.d.ts +3 -7
  19. package/dist/src/shared/cli/functions/format-text-output.function.d.ts +3 -2
  20. package/dist/src/shared/cli/functions/run-agent-search.function.d.ts +13 -0
  21. package/dist/src/shared/cli/functions/run-check.function.d.ts +1 -1
  22. package/dist/src/shared/cli/functions/run-content.function.d.ts +18 -14
  23. package/dist/src/shared/cli/functions/run-learn.function.d.ts +6 -11
  24. package/dist/src/shared/cli/functions/run-skill-search.function.d.ts +13 -0
  25. package/dist/src/shared/cli/functions/wrap-mcp-envelope.function.d.ts +8 -0
  26. package/dist/src/shared/cli/typings/cli-options.interface.d.ts +6 -0
  27. package/dist/src/shared/cli/typings/learn-client.interface.d.ts +6 -2
  28. package/dist/src/shared/cli/typings/learn-result.model.d.ts +4 -0
  29. package/dist/src/shared/cli/typings/search-display.model.d.ts +2 -2
  30. package/dist/src/shared/mcp/constants/tool-agent-search.constant.d.ts +3 -0
  31. package/dist/src/shared/mcp/constants/tool-skill-search.constant.d.ts +3 -0
  32. package/dist/src/shared/mcp/functions/format-search-results.function.d.ts +25 -0
  33. package/dist/src/shared/mcp/functions/handle-agent-get.function.d.ts +4 -4
  34. package/dist/src/shared/mcp/functions/handle-agent-list.function.d.ts +3 -7
  35. package/dist/src/shared/mcp/functions/handle-agent-search.function.d.ts +11 -0
  36. package/dist/src/shared/mcp/functions/handle-recall.function.d.ts +1 -1
  37. package/dist/src/shared/mcp/functions/handle-skill-search.function.d.ts +11 -0
  38. package/dist/src/shared/mcp/functions/handle-tool-search.function.d.ts +3 -3
  39. package/dist/src/shared/mcp/typings/mcp-client.interface.d.ts +2 -2
  40. package/dist/src/shared/mcp/typings/mcp-worker-client.interface.d.ts +2 -2
  41. package/dist/src/shared/version/constants/version.constant.d.ts +1 -1
  42. package/dist/src/shared/worker-client/typings/add-section-result.model.d.ts +6 -12
  43. package/dist/src/shared/worker-client/typings/status-result.model.d.ts +2 -2
  44. package/dist/src/shared/worker-daemon/functions/strip-recall-by-depth.function.d.ts +22 -0
  45. package/dist/wasm/fs-database/kbdb_fs_database_bg.wasm +0 -0
  46. package/dist/wasm/kb-worker/kbdb_worker_bg.wasm +0 -0
  47. package/dist/worker.mjs +71 -12
  48. package/dist/worker.mjs.map +3 -3
  49. package/package.json +1 -1
package/README.md CHANGED
@@ -75,16 +75,26 @@ That's it. No database server. No extra tools.
75
75
 
76
76
  **Using Node.js:**
77
77
 
78
+ CLI build hosted on
79
+ [NPM](https://www.npmjs.com/package/@dikolab/kbdb).
80
+
78
81
  ```sh
79
82
  npm install -g @dikolab/kbdb
80
83
  ```
81
84
 
82
85
  **Using Deno:**
83
86
 
87
+ CLI build hosted on
88
+ [JSR](https://jsr.io/@dikolab/kbdb).
89
+
84
90
  ```sh
85
91
  deno install -Agf jsr:@dikolab/kbdb/cli
86
92
  ```
87
93
 
94
+ See the
95
+ [CLI Installation Guide](https://diko316.gitlab.io/knowledge-base-db/details/install-cli)
96
+ for prerequisites and verification steps.
97
+
88
98
  ### Try It Out
89
99
 
90
100
  **1. Create a knowledge base**
@@ -120,10 +130,11 @@ kbdb search "how does auth work" --db ./my-kb
120
130
 
121
131
  Results are ranked by relevance with snippets
122
132
  showing where your terms matched. Output defaults
123
- to **recfile** format (one `field: value` per
124
- line) for easy grepping. Use `--format json` for
125
- machine-readable JSON, or `--offset` to page
126
- through large result sets.
133
+ to `--format rec` (recfile: one `field: value` per
134
+ line) for easy grepping. Other formats: `json`
135
+ (machine-readable), `text` (numbered list), and
136
+ `mcp` (JSON-RPC 2.0 envelope). Use `--offset` to
137
+ page through large result sets.
127
138
 
128
139
  To try hybrid search (keyword + AI similarity):
129
140
 
@@ -188,8 +199,20 @@ for the full walkthrough, including export and backup.
188
199
 
189
200
  Integrate kbdb with AI agents and custom tools.
190
201
 
191
- - **MCP server** with 20 tools -- search, recall,
192
- learn, export, and more
202
+ **MCP quick-start (Claude CLI):**
203
+
204
+ ```sh
205
+ claude mcp add kbdb -- \
206
+ npx @dikolab/kbdb mcp --db /path/to/.kbdb
207
+ ```
208
+
209
+ See the
210
+ [MCP Installation Guide](https://diko316.gitlab.io/knowledge-base-db/details/install-mcp)
211
+ for Claude Code, VS Code, and Claude Desktop
212
+ config files, plus troubleshooting.
213
+
214
+ - **MCP server** with 22 tools -- search, recall,
215
+ learn, export, skill/agent search, and more
193
216
  - **Skills** -- store reusable prompt templates
194
217
  with fill-in-the-blank arguments
195
218
  - **Agents** -- create AI agent profiles that
@@ -285,12 +308,16 @@ build targets.
285
308
 
286
309
  ## Documentation
287
310
 
311
+ - [CLI Installation Guide](https://diko316.gitlab.io/knowledge-base-db/details/install-cli)
312
+ -- prerequisites, npm/JSR install, verification
288
313
  - [Knowledge Base Guide](https://diko316.gitlab.io/knowledge-base-db/details/knowledge-base)
289
314
  -- importing, searching, recall, export
290
315
  - [Agent Tooling Guide](https://diko316.gitlab.io/knowledge-base-db/details/agent-tooling)
291
316
  -- MCP, skills, agents, library API
292
317
  - [CLI Reference](https://diko316.gitlab.io/knowledge-base-db/details/cli) -- full command
293
318
  list with examples
319
+ - [MCP Installation Guide](https://diko316.gitlab.io/knowledge-base-db/details/install-mcp)
320
+ -- Claude CLI, Claude Code, VS Code, Claude Desktop
294
321
  - [MCP Server Guide](https://diko316.gitlab.io/knowledge-base-db/details/mcp-server) --
295
322
  setup, tools, environment config
296
323
  - [Search and Ranking](https://diko316.gitlab.io/knowledge-base-db/details/search-and-ranking)
package/README.md.bak CHANGED
@@ -75,16 +75,26 @@ That's it. No database server. No extra tools.
75
75
 
76
76
  **Using Node.js:**
77
77
 
78
+ CLI build hosted on
79
+ [NPM](https://www.npmjs.com/package/@dikolab/kbdb).
80
+
78
81
  ```sh
79
82
  npm install -g @dikolab/kbdb
80
83
  ```
81
84
 
82
85
  **Using Deno:**
83
86
 
87
+ CLI build hosted on
88
+ [JSR](https://jsr.io/@dikolab/kbdb).
89
+
84
90
  ```sh
85
91
  deno install -Agf jsr:@dikolab/kbdb/cli
86
92
  ```
87
93
 
94
+ See the
95
+ [CLI Installation Guide](./docs/details/install-cli.md)
96
+ for prerequisites and verification steps.
97
+
88
98
  ### Try It Out
89
99
 
90
100
  **1. Create a knowledge base**
@@ -120,10 +130,11 @@ kbdb search "how does auth work" --db ./my-kb
120
130
 
121
131
  Results are ranked by relevance with snippets
122
132
  showing where your terms matched. Output defaults
123
- to **recfile** format (one `field: value` per
124
- line) for easy grepping. Use `--format json` for
125
- machine-readable JSON, or `--offset` to page
126
- through large result sets.
133
+ to `--format rec` (recfile: one `field: value` per
134
+ line) for easy grepping. Other formats: `json`
135
+ (machine-readable), `text` (numbered list), and
136
+ `mcp` (JSON-RPC 2.0 envelope). Use `--offset` to
137
+ page through large result sets.
127
138
 
128
139
  To try hybrid search (keyword + AI similarity):
129
140
 
@@ -188,8 +199,20 @@ for the full walkthrough, including export and backup.
188
199
 
189
200
  Integrate kbdb with AI agents and custom tools.
190
201
 
191
- - **MCP server** with 20 tools -- search, recall,
192
- learn, export, and more
202
+ **MCP quick-start (Claude CLI):**
203
+
204
+ ```sh
205
+ claude mcp add kbdb -- \
206
+ npx @dikolab/kbdb mcp --db /path/to/.kbdb
207
+ ```
208
+
209
+ See the
210
+ [MCP Installation Guide](./docs/details/install-mcp.md)
211
+ for Claude Code, VS Code, and Claude Desktop
212
+ config files, plus troubleshooting.
213
+
214
+ - **MCP server** with 22 tools -- search, recall,
215
+ learn, export, skill/agent search, and more
193
216
  - **Skills** -- store reusable prompt templates
194
217
  with fill-in-the-blank arguments
195
218
  - **Agents** -- create AI agent profiles that
@@ -285,12 +308,16 @@ build targets.
285
308
 
286
309
  ## Documentation
287
310
 
311
+ - [CLI Installation Guide](./docs/details/install-cli.md)
312
+ -- prerequisites, npm/JSR install, verification
288
313
  - [Knowledge Base Guide](./docs/details/knowledge-base.md)
289
314
  -- importing, searching, recall, export
290
315
  - [Agent Tooling Guide](./docs/details/agent-tooling.md)
291
316
  -- MCP, skills, agents, library API
292
317
  - [CLI Reference](./docs/details/cli.md) -- full command
293
318
  list with examples
319
+ - [MCP Installation Guide](./docs/details/install-mcp.md)
320
+ -- Claude CLI, Claude Code, VS Code, Claude Desktop
294
321
  - [MCP Server Guide](./docs/details/mcp-server.md) --
295
322
  setup, tools, environment config
296
323
  - [Search and Ranking](./docs/details/search-and-ranking.md)
package/dist/README.md CHANGED
@@ -75,16 +75,26 @@ That's it. No database server. No extra tools.
75
75
 
76
76
  **Using Node.js:**
77
77
 
78
+ CLI build hosted on
79
+ [NPM](https://www.npmjs.com/package/@dikolab/kbdb).
80
+
78
81
  ```sh
79
82
  npm install -g @dikolab/kbdb
80
83
  ```
81
84
 
82
85
  **Using Deno:**
83
86
 
87
+ CLI build hosted on
88
+ [JSR](https://jsr.io/@dikolab/kbdb).
89
+
84
90
  ```sh
85
91
  deno install -Agf jsr:@dikolab/kbdb/cli
86
92
  ```
87
93
 
94
+ See the
95
+ [CLI Installation Guide](https://diko316.gitlab.io/knowledge-base-db/details/install-cli)
96
+ for prerequisites and verification steps.
97
+
88
98
  ### Try It Out
89
99
 
90
100
  **1. Create a knowledge base**
@@ -120,10 +130,11 @@ kbdb search "how does auth work" --db ./my-kb
120
130
 
121
131
  Results are ranked by relevance with snippets
122
132
  showing where your terms matched. Output defaults
123
- to **recfile** format (one `field: value` per
124
- line) for easy grepping. Use `--format json` for
125
- machine-readable JSON, or `--offset` to page
126
- through large result sets.
133
+ to `--format rec` (recfile: one `field: value` per
134
+ line) for easy grepping. Other formats: `json`
135
+ (machine-readable), `text` (numbered list), and
136
+ `mcp` (JSON-RPC 2.0 envelope). Use `--offset` to
137
+ page through large result sets.
127
138
 
128
139
  To try hybrid search (keyword + AI similarity):
129
140
 
@@ -188,8 +199,20 @@ for the full walkthrough, including export and backup.
188
199
 
189
200
  Integrate kbdb with AI agents and custom tools.
190
201
 
191
- - **MCP server** with 20 tools -- search, recall,
192
- learn, export, and more
202
+ **MCP quick-start (Claude CLI):**
203
+
204
+ ```sh
205
+ claude mcp add kbdb -- \
206
+ npx @dikolab/kbdb mcp --db /path/to/.kbdb
207
+ ```
208
+
209
+ See the
210
+ [MCP Installation Guide](https://diko316.gitlab.io/knowledge-base-db/details/install-mcp)
211
+ for Claude Code, VS Code, and Claude Desktop
212
+ config files, plus troubleshooting.
213
+
214
+ - **MCP server** with 22 tools -- search, recall,
215
+ learn, export, skill/agent search, and more
193
216
  - **Skills** -- store reusable prompt templates
194
217
  with fill-in-the-blank arguments
195
218
  - **Agents** -- create AI agent profiles that
@@ -285,12 +308,16 @@ build targets.
285
308
 
286
309
  ## Documentation
287
310
 
311
+ - [CLI Installation Guide](https://diko316.gitlab.io/knowledge-base-db/details/install-cli)
312
+ -- prerequisites, npm/JSR install, verification
288
313
  - [Knowledge Base Guide](https://diko316.gitlab.io/knowledge-base-db/details/knowledge-base)
289
314
  -- importing, searching, recall, export
290
315
  - [Agent Tooling Guide](https://diko316.gitlab.io/knowledge-base-db/details/agent-tooling)
291
316
  -- MCP, skills, agents, library API
292
317
  - [CLI Reference](https://diko316.gitlab.io/knowledge-base-db/details/cli) -- full command
293
318
  list with examples
319
+ - [MCP Installation Guide](https://diko316.gitlab.io/knowledge-base-db/details/install-mcp)
320
+ -- Claude CLI, Claude Code, VS Code, Claude Desktop
294
321
  - [MCP Server Guide](https://diko316.gitlab.io/knowledge-base-db/details/mcp-server) --
295
322
  setup, tools, environment config
296
323
  - [Search and Ranking](https://diko316.gitlab.io/knowledge-base-db/details/search-and-ranking)