@saasontools/strauss-kb 0.1.19 → 0.1.21

package/ARCHITECTURE.md

@@ -17,11 +17,11 @@ rather than closing it. A lock would close it and add a worse failure: a crashed
 A base loaded at the start of a long conversation is summarised away by the end,
 so no consumer loads it that way:
 
-| Consumer                        | How it reads                                        |
-| ------------------------------- | --------------------------------------------------- |
-| Diff annotation                 | `matchToDiff` — deterministic, no context           |
-| "Has this been decided?"        | a fresh short-lived reader, given base and question |
-| An implementor writing a record | a point query at the moment of writing              |
+| Consumer                        | How it reads                                         |
+| ------------------------------- | ---------------------------------------------------- |
+| Diff annotation                 | `matchToDiff`/`kb_match` — deterministic, no context |
+| "Has this been decided?"        | a fresh short-lived reader, given base and question  |
+| An implementor writing a record | a point query at the moment of writing               |
 
 Reloading costs about three thousand tokens for twenty records.
 

package/README.md

@@ -222,11 +222,12 @@ end of it. Six optional fields extend it:
 them; `repo` and `ref` are **author-owned identity** and a resolution pass
 never writes them.
 
-`anchor-resolve <concept-id>` (`kb_anchor_resolve`) is `verify`'s mechanical
-counterpart: it checks the anchored code against the working tree
-(`--repo-root` when the base is not inside it). Per anchor:
+`anchor-resolve <concept-id>` (`kb_anchor_resolve`) checks the anchored code
+against the working tree (`--repo-root` when the base is not inside it) and
+never writes `verified[]`; `--check` writes nothing at all. Per anchor:
 
-- **stamped** — no hash yet; hash, line count, and timestamp are written.
+- **stamped** — no hash yet; hash, line count, and timestamp are written
+  (`unstamped` under `--check`, which writes none).
 - **match** — unchanged; nothing written. `--restamp` re-dates on purpose.
 - **drifted** — hash changed. Baseline kept unless `--rebaseline`.
 - **unresolved** — not comparable, with a reason. A finding, not an error.
@@ -245,9 +246,6 @@ and again on the real path after symlinks.
 Exit code is non-zero on **drifted**, or on **unresolved** for an anchor that
 carries a hash; unstamped anchors and unreachable remotes never fail.
 
-A fully clean run — every anchor checked and `match`, none stamped this run —
-appends a `verified[]` event.
-
 Symbols resolve tree-sitter first — the 20 language packs that have both a
 grammar and a definitions query, pinned together by `pnpm grammars pin` from
 `grammars/packs.json` and proved at pin time — then the regex heuristic for
@@ -311,11 +309,14 @@ strauss-kb [--bundle PATH] <command> [args]
                                            Resolve anchors against the working tree: stamp, or report drift.
   reassess <concept-id> [--repo-root <path>] [--with-diff]
                                            One drifted record as something to judge: claim, classes, diff, impact.
+  promote <concept-id...> --to <bundle> [--source <url>] [--force] | --list
+                                           Copy settled records into the base that outlives the pull request.
   load [type] [--budget N | --all] [--repo-root PATH]
                                            Hand over the whole base, each record with its standing.
   catalog [type]                           Every record in one line — id, type, title, standing, stale flag.
   pack <conceptId> [--hops N] [--max-nodes N] [--budget N]
                                            The bounded neighbourhood around one record, every cut named.
+  export --format madr --to <dir>          Write the base's decisions out as numbered MADR files.
   query <text...> [--repo-root PATH]       Search; every match arrives flagged with its standing.
   trace <concept-id> [edges...]            How a position was arrived at, as a timeline.
   impact <concept-id> [--depth N] [--rels a,b]
@@ -327,6 +328,8 @@ strauss-kb [--bundle PATH] <command> [args]
   validate                                 Cross-record checks. Exits 1 when it reports a problem.
   doctor [--expiring-days N] [--unverified-days N] [--aging-days N] [--repo-root PATH] [--strict]
                                            Health sweep: what expired, went unconfirmed, aged, was orphaned, or drifted.
+  sweep --tag <tag> --terminal [--dry-run]
+                                           Delete tagged records that are resolved, rejected or superseded.
   schema                                   JSON Schema for the format.
   types                                    The twelve types, their sections and initial status.
   pin [bundle-path] [flags]                Pin a base. --mode, --profiles, --frozen; --local/--user pick the layer.
@@ -381,11 +384,12 @@ strauss-kb validate || echo "errors above"   # warnings alone still exit 0
 
 Every CLI verb is a tool: `kb_write`, `kb_write_decision`, `kb_no_decision`,
 `kb_status`, `kb_supersede`, `kb_answer`, `kb_verify`, `kb_anchor_resolve`, `kb_reassess`,
+`kb_promote`,
 `kb_load`, `kb_catalog`,
-`kb_pack`,
-`kb_query`, `kb_trace`, `kb_impact`, `kb_backlinks`, `kb_list`, `kb_index`, `kb_log`, `kb_stamp`,
+`kb_pack`, `kb_export`,
+`kb_query`, `kb_trace`, `kb_impact`, `kb_backlinks`, `kb_match`, `kb_classify`, `kb_list`, `kb_index`, `kb_log`, `kb_stamp`,
 `kb_validate`,
-`kb_doctor`, `kb_schema`, `kb_types`, `kb_pin`, `kb_unpin`, `kb_pins`,
+`kb_doctor`, `kb_sweep`, `kb_schema`, `kb_types`, `kb_pin`, `kb_unpin`, `kb_pins`,
 `kb_context`. Most take a `bundlePath`. The one CLI verb with no tool is
 `sync-instructions`; the agent capability is `kb_context`.
 
@@ -413,7 +417,8 @@ for (const hit of hits) {
 ```
 
 `matchToDiff` takes hunks and optional symbol ranges rather than a patch,
-answering which records are anchored to each hunk.
+answering which records are anchored to each hunk. `kb_match` is the same
+answer for a caller that cannot import this package.
 
 ## Retrieval
 

package/dist/{chunk-CQBLH7CE.js → chunk-VXWN62HT.js}

@@ -4,7 +4,7 @@ import {
   KB_DIR,
   KbStore,
   VERSION
-} from "./chunk-MNQNHYWL.js";
+} from "./chunk-XBZ7G5R5.js";
 
 // src/cli.ts
 import { join } from "path";
@@ -121,4 +121,4 @@ function usage() {
 export {
   runKbCli
 };
-//# sourceMappingURL=chunk-CQBLH7CE.js.map
+//# sourceMappingURL=chunk-VXWN62HT.js.map

package/dist/{chunk-ZWSCLHG6.js → chunk-WVJULVGY.js}

@@ -2,7 +2,7 @@ import {
   KB_COMMANDS,
   KbStore,
   VERSION
-} from "./chunk-MNQNHYWL.js";
+} from "./chunk-XBZ7G5R5.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -46,4 +46,4 @@ export {
   createKbMcpServer,
   runKbMcpServer
 };
-//# sourceMappingURL=chunk-ZWSCLHG6.js.map
+//# sourceMappingURL=chunk-WVJULVGY.js.map