@hasna/knowledge 0.2.16 → 0.2.17
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.
- package/README.md +19 -1
- package/bin/open-knowledge-mcp.js +2224 -1835
- package/bin/open-knowledge.js +98 -84
- package/docs/architecture/ai-native-knowledge-base.md +6 -0
- package/docs/architecture/hybrid-semantic-search.md +3 -0
- package/package.json +2 -1
- package/src/agent.ts +367 -0
- package/src/cli.ts +41 -5
- package/src/mcp.js +19 -0
- package/src/providers.ts +1 -1
- package/src/service.ts +10 -0
package/README.md
CHANGED
|
@@ -98,6 +98,10 @@ open-knowledge embeddings search "company wiki policy" --scope project --json
|
|
|
98
98
|
open-knowledge search "company wiki policy" --scope project --json
|
|
99
99
|
open-knowledge search "company wiki policy" --scope project --semantic --json
|
|
100
100
|
open-knowledge search "company wiki policy" --scope project --context --json
|
|
101
|
+
|
|
102
|
+
# Build a citation answer/context draft for a prompt
|
|
103
|
+
open-knowledge ask "How do we cite handbook policy?" --scope project --json
|
|
104
|
+
knowledge "How do we cite handbook policy?" --scope project --json
|
|
101
105
|
```
|
|
102
106
|
|
|
103
107
|
## Commands
|
|
@@ -259,6 +263,19 @@ assembled citations, freshness and permission notes, graph evidence from
|
|
|
259
263
|
`citations`/`wiki_backlinks`, and final rerank scores. This is the shape future
|
|
260
264
|
`knowledge <prompt>` flows should send to a model instead of raw search rows.
|
|
261
265
|
|
|
266
|
+
### ask / build
|
|
267
|
+
```bash
|
|
268
|
+
open-knowledge ask <prompt> [--scope project] [--json]
|
|
269
|
+
open-knowledge build <prompt> [--generate] [--model default|provider:model] [--scope project] [--json]
|
|
270
|
+
knowledge <prompt> [--scope project] [--json]
|
|
271
|
+
```
|
|
272
|
+
Build an agent-native prompt run. The command first creates a read-only context
|
|
273
|
+
pack, returns a local citation draft by default, records a run ledger in
|
|
274
|
+
`runs`/`run_events`, and proposes durable wiki updates without writing them.
|
|
275
|
+
`--generate` explicitly calls AI SDK text generation; `--fake --generate` keeps
|
|
276
|
+
the flow deterministic for local tests. `--approve-write` records approval
|
|
277
|
+
intent, but durable wiki writes remain deferred to the wiki compile/write task.
|
|
278
|
+
|
|
262
279
|
### safety
|
|
263
280
|
```bash
|
|
264
281
|
open-knowledge safety status [--scope project] [--json]
|
|
@@ -340,7 +357,8 @@ The MCP server exposes item tools (`ok_add`, `ok_list`, `ok_get`, `ok_update`,
|
|
|
340
357
|
`ok_semantic_search`), hybrid retrieval (`ok_search`), and source-ref
|
|
341
358
|
parsing/resolution (`ok_parse_source_ref`, `ok_resolve_source`). The
|
|
342
359
|
`knowledge_search` MCP tool returns reranked citation context packs for agent
|
|
343
|
-
prompts
|
|
360
|
+
prompts, and `knowledge_ask` runs the same prompt flow exposed by
|
|
361
|
+
`open-knowledge ask`.
|
|
344
362
|
|
|
345
363
|
## Source And Artifact Boundary
|
|
346
364
|
|