@saasontools/strauss-kb 0.1.22 → 0.2.0

package/ARCHITECTURE.md

@@ -72,6 +72,18 @@ bundle would drop the record instead of naming it. Tolerant read, strict write:
 `kb_impact` reports a superseded or rejected record and stops there. A withdrawn
 record's declared dependencies are not obligations anyone still owes.
 
+An edge is `strauss_links` and nothing else. A markdown link in a body renders
+the same claim for a reader that knows only OKF, and `compose` writes both at
+once, so a consumer that walked prose would count the edge twice and disagree
+the moment the two drifted.
+
+Two representations is what the package had, and it cost data: `sweep` read
+frontmatter only and deleted records still cited in prose, while `doctor` read
+prose only and missed a `related_to` at a superseded target. The repair was one
+representation, not two readers: `compose` writes the link wherever it writes
+the sentence, and `validate` is the only body read left, reporting that a
+record's prose and its links have come apart.
+
 ## Rejected: a format that needs a parser
 
 A hand-rolled frontmatter reader could not express nested maps, misreading every

package/README.md

@@ -227,7 +227,7 @@ 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
-  (`unstamped` under `--check`, which writes none).
+  (`unstamped` until one lands, so `--check` and a refused write say so).
 - **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.
@@ -250,8 +250,9 @@ finding, not a command.
 An anchor must not read outside the repository it describes, checked lexically
 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 write the run asked for carries its own `outcome`, and the exit code follows
+it:
+[cli-reference](https://saasontools.github.io/strauss-agent-tools/cli-reference#anchor-resolve).
 
 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
@@ -473,6 +474,7 @@ caveats: <https://saasontools.github.io/strauss-agent-tools/mcp-reference>.
 and `unchecked`. All nine groups are reported even when empty; `--strict` gates
 on expiry alone, not on drift. Pass `--repo-root PATH` when the base does not sit
 inside the tree it describes.
+
 Windows and judgments:
 [cli-reference](https://saasontools.github.io/strauss-agent-tools/cli-reference).
 

package/dist/{chunk-DVSPHL4B.js → chunk-7J2BBP67.js}

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

package/dist/{chunk-TSE4YQEG.js → chunk-GMZDXWWU.js}

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