@saasontools/strauss-kb 0.1.21 → 0.1.23

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 CHANGED
@@ -227,11 +227,18 @@ against the working tree (`--repo-root` when the base is not inside it) and
227
227
  never writes `verified[]`; `--check` writes nothing at all. Per anchor:
228
228
 
229
229
  - **stamped** — no hash yet; hash, line count, and timestamp are written
230
- (`unstamped` under `--check`, which writes none).
230
+ (`unstamped` until one lands, so `--check` and a refused write say so).
231
231
  - **match** — unchanged; nothing written. `--restamp` re-dates on purpose.
232
232
  - **drifted** — hash changed. Baseline kept unless `--rebaseline`.
233
233
  - **unresolved** — not comparable, with a reason. A finding, not an error.
234
234
 
235
+ `anchor-set <concept-id>` (`kb_anchor_set`) sets those pointers when a refactor
236
+ renamed or extracted the code: the complete new anchor set, plus a required
237
+ reason that lands in the log. Carry an anchor's `hash` forward and the code
238
+ behind a moved pointer still reports drift until it is read and
239
+ accepted with `--rebaseline`; `--resolve` stamps the set in the same call.
240
+ It never verifies or moves standing. [Full rules](https://saasontools.github.io/strauss-agent-tools/cli-reference#anchor-set).
241
+
235
242
  An anchor naming another `repo` is read from that repository's **remote**,
236
243
  through a bare cache under `~/.strauss/repo-cache` — a local checkout is one
237
244
  person's possibly stale view of the same file. With a `ref` it has three
@@ -243,8 +250,9 @@ finding, not a command.
243
250
  An anchor must not read outside the repository it describes, checked lexically
244
251
  and again on the real path after symlinks.
245
252
 
246
- Exit code is non-zero on **drifted**, or on **unresolved** for an anchor that
247
- carries a hash; unstamped anchors and unreachable remotes never fail.
253
+ A write the run asked for carries its own `outcome`, and the exit code follows
254
+ it:
255
+ [cli-reference](https://saasontools.github.io/strauss-agent-tools/cli-reference#anchor-resolve).
248
256
 
249
257
  Symbols resolve tree-sitter first — the 20 language packs that have both a
250
258
  grammar and a definitions query, pinned together by `pnpm grammars pin` from
@@ -307,6 +315,8 @@ strauss-kb [--bundle PATH] <command> [args]
307
315
  verify <concept-id> --note <text> Append a verified[] event — who checked, when, and what the check found.
308
316
  anchor-resolve <concept-id> [--repo-root <path>] [--rebaseline] [--restamp]
309
317
  Resolve anchors against the working tree: stamp, or report drift.
318
+ anchor-set <concept-id> [--resolve] < anchors.json
319
+ Set anchors after a refactor you read, with a reason; --resolve stamps them.
310
320
  reassess <concept-id> [--repo-root <path>] [--with-diff]
311
321
  One drifted record as something to judge: claim, classes, diff, impact.
312
322
  promote <concept-id...> --to <bundle> [--source <url>] [--force] | --list
@@ -383,7 +393,7 @@ strauss-kb validate || echo "errors above" # warnings alone still exit 0
383
393
  ```
384
394
 
385
395
  Every CLI verb is a tool: `kb_write`, `kb_write_decision`, `kb_no_decision`,
386
- `kb_status`, `kb_supersede`, `kb_answer`, `kb_verify`, `kb_anchor_resolve`, `kb_reassess`,
396
+ `kb_status`, `kb_supersede`, `kb_answer`, `kb_verify`, `kb_anchor_resolve`, `kb_anchor_set`, `kb_reassess`,
387
397
  `kb_promote`,
388
398
  `kb_load`, `kb_catalog`,
389
399
  `kb_pack`, `kb_export`,
@@ -2,7 +2,7 @@ import {
2
2
  KB_COMMANDS,
3
3
  KbStore,
4
4
  VERSION
5
- } from "./chunk-XBZ7G5R5.js";
5
+ } from "./chunk-XENLCPL5.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-WVJULVGY.js.map
49
+ //# sourceMappingURL=chunk-3EZ3PAPA.js.map
@@ -4,7 +4,7 @@ import {
4
4
  KB_DIR,
5
5
  KbStore,
6
6
  VERSION
7
- } from "./chunk-XBZ7G5R5.js";
7
+ } from "./chunk-XENLCPL5.js";
8
8
 
9
9
  // src/cli.ts
10
10
  import { join } from "path";
@@ -121,4 +121,4 @@ function usage() {
121
121
  export {
122
122
  runKbCli
123
123
  };
124
- //# sourceMappingURL=chunk-VXWN62HT.js.map
124
+ //# sourceMappingURL=chunk-5IPQVXCM.js.map