@saasontools/strauss-kb 0.1.19 → 0.1.20
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/ARCHITECTURE.md +5 -5
- package/README.md +11 -4
- package/dist/{chunk-ZWSCLHG6.js → chunk-EXZQZJU2.js} +2 -2
- package/dist/{chunk-MNQNHYWL.js → chunk-QQLPJO4R.js} +2781 -957
- package/dist/chunk-QQLPJO4R.js.map +1 -0
- package/dist/{chunk-CQBLH7CE.js → chunk-XDH6J6CH.js} +2 -2
- package/dist/cli-main.cjs +2783 -994
- package/dist/cli-main.cjs.map +1 -1
- package/dist/cli-main.js +2 -2
- package/dist/index.cjs +2149 -394
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +470 -96
- package/dist/index.d.ts +470 -96
- package/dist/index.js +38 -83
- package/dist/index.js.map +1 -1
- package/dist/mcp-main.cjs +2779 -990
- package/dist/mcp-main.cjs.map +1 -1
- package/dist/mcp-main.js +2 -2
- package/package.json +1 -1
- package/dist/chunk-MNQNHYWL.js.map +0 -1
- /package/dist/{chunk-ZWSCLHG6.js.map → chunk-EXZQZJU2.js.map} +0 -0
- /package/dist/{chunk-CQBLH7CE.js.map → chunk-XDH6J6CH.js.map} +0 -0
package/ARCHITECTURE.md
CHANGED
|
@@ -17,11 +17,11 @@ rather than closing it. A lock would close it and add a worse failure: a crashed
|
|
|
17
17
|
A base loaded at the start of a long conversation is summarised away by the end,
|
|
18
18
|
so no consumer loads it that way:
|
|
19
19
|
|
|
20
|
-
| Consumer | How it reads
|
|
21
|
-
| ------------------------------- |
|
|
22
|
-
| Diff annotation | `matchToDiff` — deterministic, no context
|
|
23
|
-
| "Has this been decided?" | a fresh short-lived reader, given base and question
|
|
24
|
-
| An implementor writing a record | a point query at the moment of writing
|
|
20
|
+
| Consumer | How it reads |
|
|
21
|
+
| ------------------------------- | ---------------------------------------------------- |
|
|
22
|
+
| Diff annotation | `matchToDiff`/`kb_match` — deterministic, no context |
|
|
23
|
+
| "Has this been decided?" | a fresh short-lived reader, given base and question |
|
|
24
|
+
| An implementor writing a record | a point query at the moment of writing |
|
|
25
25
|
|
|
26
26
|
Reloading costs about three thousand tokens for twenty records.
|
|
27
27
|
|
package/README.md
CHANGED
|
@@ -311,11 +311,14 @@ strauss-kb [--bundle PATH] <command> [args]
|
|
|
311
311
|
Resolve anchors against the working tree: stamp, or report drift.
|
|
312
312
|
reassess <concept-id> [--repo-root <path>] [--with-diff]
|
|
313
313
|
One drifted record as something to judge: claim, classes, diff, impact.
|
|
314
|
+
promote <concept-id...> --to <bundle> [--source <url>] [--force] | --list
|
|
315
|
+
Copy settled records into the base that outlives the pull request.
|
|
314
316
|
load [type] [--budget N | --all] [--repo-root PATH]
|
|
315
317
|
Hand over the whole base, each record with its standing.
|
|
316
318
|
catalog [type] Every record in one line — id, type, title, standing, stale flag.
|
|
317
319
|
pack <conceptId> [--hops N] [--max-nodes N] [--budget N]
|
|
318
320
|
The bounded neighbourhood around one record, every cut named.
|
|
321
|
+
export --format madr --to <dir> Write the base's decisions out as numbered MADR files.
|
|
319
322
|
query <text...> [--repo-root PATH] Search; every match arrives flagged with its standing.
|
|
320
323
|
trace <concept-id> [edges...] How a position was arrived at, as a timeline.
|
|
321
324
|
impact <concept-id> [--depth N] [--rels a,b]
|
|
@@ -327,6 +330,8 @@ strauss-kb [--bundle PATH] <command> [args]
|
|
|
327
330
|
validate Cross-record checks. Exits 1 when it reports a problem.
|
|
328
331
|
doctor [--expiring-days N] [--unverified-days N] [--aging-days N] [--repo-root PATH] [--strict]
|
|
329
332
|
Health sweep: what expired, went unconfirmed, aged, was orphaned, or drifted.
|
|
333
|
+
sweep --tag <tag> --terminal [--dry-run]
|
|
334
|
+
Delete tagged records that are resolved, rejected or superseded.
|
|
330
335
|
schema JSON Schema for the format.
|
|
331
336
|
types The twelve types, their sections and initial status.
|
|
332
337
|
pin [bundle-path] [flags] Pin a base. --mode, --profiles, --frozen; --local/--user pick the layer.
|
|
@@ -381,11 +386,12 @@ strauss-kb validate || echo "errors above" # warnings alone still exit 0
|
|
|
381
386
|
|
|
382
387
|
Every CLI verb is a tool: `kb_write`, `kb_write_decision`, `kb_no_decision`,
|
|
383
388
|
`kb_status`, `kb_supersede`, `kb_answer`, `kb_verify`, `kb_anchor_resolve`, `kb_reassess`,
|
|
389
|
+
`kb_promote`,
|
|
384
390
|
`kb_load`, `kb_catalog`,
|
|
385
|
-
`kb_pack`,
|
|
386
|
-
`kb_query`, `kb_trace`, `kb_impact`, `kb_backlinks`, `kb_list`, `kb_index`, `kb_log`, `kb_stamp`,
|
|
391
|
+
`kb_pack`, `kb_export`,
|
|
392
|
+
`kb_query`, `kb_trace`, `kb_impact`, `kb_backlinks`, `kb_match`, `kb_classify`, `kb_list`, `kb_index`, `kb_log`, `kb_stamp`,
|
|
387
393
|
`kb_validate`,
|
|
388
|
-
`kb_doctor`, `kb_schema`, `kb_types`, `kb_pin`, `kb_unpin`, `kb_pins`,
|
|
394
|
+
`kb_doctor`, `kb_sweep`, `kb_schema`, `kb_types`, `kb_pin`, `kb_unpin`, `kb_pins`,
|
|
389
395
|
`kb_context`. Most take a `bundlePath`. The one CLI verb with no tool is
|
|
390
396
|
`sync-instructions`; the agent capability is `kb_context`.
|
|
391
397
|
|
|
@@ -413,7 +419,8 @@ for (const hit of hits) {
|
|
|
413
419
|
```
|
|
414
420
|
|
|
415
421
|
`matchToDiff` takes hunks and optional symbol ranges rather than a patch,
|
|
416
|
-
answering which records are anchored to each hunk.
|
|
422
|
+
answering which records are anchored to each hunk. `kb_match` is the same
|
|
423
|
+
answer for a caller that cannot import this package.
|
|
417
424
|
|
|
418
425
|
## Retrieval
|
|
419
426
|
|
|
@@ -2,7 +2,7 @@ import {
|
|
|
2
2
|
KB_COMMANDS,
|
|
3
3
|
KbStore,
|
|
4
4
|
VERSION
|
|
5
|
-
} from "./chunk-
|
|
5
|
+
} from "./chunk-QQLPJO4R.js";
|
|
6
6
|
|
|
7
7
|
// src/mcp.ts
|
|
8
8
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
@@ -46,4 +46,4 @@ export {
|
|
|
46
46
|
createKbMcpServer,
|
|
47
47
|
runKbMcpServer
|
|
48
48
|
};
|
|
49
|
-
//# sourceMappingURL=chunk-
|
|
49
|
+
//# sourceMappingURL=chunk-EXZQZJU2.js.map
|