@saasontools/strauss-kb 0.1.22 → 0.1.23

package/dist/index.d.cts

@@ -2919,6 +2919,38 @@ declare class KbAnchorSetDuplicateError extends BaseError {
     constructor(locator: string);
 }
 
+/**
+ * What the run did about an anchor it set out to write. `applied` is set only
+ * after the record is persisted, so a report never claims a baseline the store
+ * does not hold.
+ */
+type AnchorUpdateOutcome = "applied" | "skipped" | "failed";
+/** Why an intended write did not happen. */
+type AnchorUpdateReason = "frozen" | "write-failed" | "pinned-ref";
+type AnchorResolveResult = {
+    file: string;
+    symbol?: string;
+    /** Set only for `side: "old"`: resolved at `ref`, never in the working tree. */
+    side?: "old";
+    /** `unstamped`: no hash yet, and nothing wrote one. */
+    state: "stamped" | "unstamped" | "match" | "drifted" | "unresolved";
+    storedHash?: string;
+    currentHash?: string;
+    /** What the compared hashes were taken over. */
+    hashKind?: AnchorHashKind;
+    /** `null` when the anchor recorded no `lines` — size unknown, not zero. */
+    diffSize?: number | null;
+    reason?: AnchorUnresolvedReason | AnchorDriftReason;
+    resolver?: AnchorResolverName;
+    /** Set only where a baseline write was due: the comparison is `state`. */
+    outcome?: AnchorUpdateOutcome;
+    outcomeReason?: AnchorUpdateReason;
+    rebaselined?: boolean;
+    /** Set only when the anchor was resolved against another repository. */
+    repo?: string;
+    remoteState?: RemoteAnchorState;
+};
+
 /**
  * The record's anchors, as the caller means them to end up.
  *
@@ -2962,10 +2994,13 @@ type KbAnchorSetResult = {
     /** Unchanged anchors are not listed; a no-op write reports nothing. */
     changes: KbAnchorChange[];
     anchors: KbAnchor[];
-    /** `stamped` when `resolve` ran; `unchanged` otherwise. */
-    baseline: "unchanged" | "stamped";
+    /**
+     * `unchanged` without `resolve`; with it, `stamped` only when every anchor
+     * matched or its write was `applied`, else `incomplete`.
+     */
+    baseline: "unchanged" | "stamped" | "incomplete";
     /** anchor-resolve's per-anchor results, when `resolve` ran. */
-    resolved?: unknown[];
+    resolved?: AnchorResolveResult[];
     note: string;
 };
 

package/dist/index.d.ts

@@ -2919,6 +2919,38 @@ declare class KbAnchorSetDuplicateError extends BaseError {
     constructor(locator: string);
 }
 
+/**
+ * What the run did about an anchor it set out to write. `applied` is set only
+ * after the record is persisted, so a report never claims a baseline the store
+ * does not hold.
+ */
+type AnchorUpdateOutcome = "applied" | "skipped" | "failed";
+/** Why an intended write did not happen. */
+type AnchorUpdateReason = "frozen" | "write-failed" | "pinned-ref";
+type AnchorResolveResult = {
+    file: string;
+    symbol?: string;
+    /** Set only for `side: "old"`: resolved at `ref`, never in the working tree. */
+    side?: "old";
+    /** `unstamped`: no hash yet, and nothing wrote one. */
+    state: "stamped" | "unstamped" | "match" | "drifted" | "unresolved";
+    storedHash?: string;
+    currentHash?: string;
+    /** What the compared hashes were taken over. */
+    hashKind?: AnchorHashKind;
+    /** `null` when the anchor recorded no `lines` — size unknown, not zero. */
+    diffSize?: number | null;
+    reason?: AnchorUnresolvedReason | AnchorDriftReason;
+    resolver?: AnchorResolverName;
+    /** Set only where a baseline write was due: the comparison is `state`. */
+    outcome?: AnchorUpdateOutcome;
+    outcomeReason?: AnchorUpdateReason;
+    rebaselined?: boolean;
+    /** Set only when the anchor was resolved against another repository. */
+    repo?: string;
+    remoteState?: RemoteAnchorState;
+};
+
 /**
  * The record's anchors, as the caller means them to end up.
  *
@@ -2962,10 +2994,13 @@ type KbAnchorSetResult = {
     /** Unchanged anchors are not listed; a no-op write reports nothing. */
     changes: KbAnchorChange[];
     anchors: KbAnchor[];
-    /** `stamped` when `resolve` ran; `unchanged` otherwise. */
-    baseline: "unchanged" | "stamped";
+    /**
+     * `unchanged` without `resolve`; with it, `stamped` only when every anchor
+     * matched or its write was `applied`, else `incomplete`.
+     */
+    baseline: "unchanged" | "stamped" | "incomplete";
     /** anchor-resolve's per-anchor results, when `resolve` ran. */
-    resolved?: unknown[];
+    resolved?: AnchorResolveResult[];
     note: string;
 };
 

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   runKbCli
-} from "./chunk-DVSPHL4B.js";
+} from "./chunk-5IPQVXCM.js";
 import {
   createKbMcpServer,
   runKbMcpServer
-} from "./chunk-TSE4YQEG.js";
+} from "./chunk-3EZ3PAPA.js";
 import {
   BaseError,
   CONTEXT_BEGIN,
@@ -156,7 +156,7 @@ import {
   unifiedDiff,
   unpinBase,
   validateBundle
-} from "./chunk-AEO5U42S.js";
+} from "./chunk-XENLCPL5.js";
 export {
   BaseError,
   CONTEXT_BEGIN,