@saasontools/strauss-kb 0.1.15 → 0.1.16

package/dist/index.d.cts

@@ -450,6 +450,11 @@ declare function resolveHeads(from: KbRecord, byId: Map<string, KbRecord>): {
     warnings: KbWarning[];
 };
 
+type KbRecordStamp = {
+    conceptId: string;
+    digest: string;
+};
+
 /**
  * Edges a trace may follow — the shared kb-edges.ts definitions, minus
  * `body-link`: body links can reach most of a bundle from anywhere, which
@@ -816,6 +821,16 @@ type KbLoadResult = {
      */
     digest: string;
 };
+/** What `stamp` reports for one base. See `kb-stamp.ts`. */
+type KbStampResult = {
+    path: string;
+    digest: string;
+    recordCount: number;
+    superseded: number;
+    /** Newest `generated.at` across the base, or null when none carries one. */
+    newestAt: string | null;
+    records: KbRecordStamp[];
+};
 type KbWriteInput = {
     type: string;
     slug: string;
@@ -984,6 +999,13 @@ declare class KbStore {
         all?: boolean;
         repoRoot?: string;
     }): Promise<KbLoadResult>;
+    /**
+     * `load`'s digest without `load`'s bodies — the same records, adjudicated
+     * the same way, handed back as a stamp. Skips the anchor drift pass, which
+     * reads source files and only ever adds warnings: no warning reaches the
+     * digest, so the value is identical to the one `load` returns.
+     */
+    stamp(bundlePath: string): Promise<KbStampResult>;
     /** How a position was arrived at, as a timeline. See `trace.ts`. */
     trace(bundlePath: string, seedId: string, options?: KbTraceOptions): Promise<KbTraceStep[]>;
     /** Every record named in one line each. See `catalog.ts`. */
@@ -1120,6 +1142,8 @@ declare enum ErrorTypes {
     KbPackBudgetExceeded = "KbPackBudgetExceeded",
     KbRecordNotFound = "KbRecordNotFound",
     KbSelfVerification = "KbSelfVerification",
+    KbStampBaselineUnreadable = "KbStampBaselineUnreadable",
+    KbStampDigestBaselineAmbiguous = "KbStampDigestBaselineAmbiguous",
     KbUnknownLinkRel = "KbUnknownLinkRel",
     KbWriteConflict = "KbWriteConflict"
 }
@@ -1981,8 +2005,12 @@ type KbCommand<Shape extends z.ZodRawShape = z.ZodRawShape> = {
     /** Shown to an agent choosing a tool, so it carries the judgment too. */
     description: string;
     input: z.ZodObject<Shape>;
-    /** Positional argv → the same object MCP receives. */
-    fromArgv(argv: string[], bundlePath: string, stdin: () => Promise<string>): Promise<unknown> | unknown;
+    /**
+     * Positional argv → the same object MCP receives. `bundleExplicit` says
+     * whether `--bundle` was actually passed, for the one command whose meaning
+     * turns on it: `stamp` with no bundle stamps every pinned base.
+     */
+    fromArgv(argv: string[], bundlePath: string, stdin: () => Promise<string>, bundleExplicit?: boolean): Promise<unknown> | unknown;
     run(ctx: KbCommandContext, input: z.infer<z.ZodObject<Shape>>): Promise<unknown>;
     /**
      * A human-readable form of the result, for the CLI. Where it exists the CLI

package/dist/index.d.ts

@@ -450,6 +450,11 @@ declare function resolveHeads(from: KbRecord, byId: Map<string, KbRecord>): {
     warnings: KbWarning[];
 };
 
+type KbRecordStamp = {
+    conceptId: string;
+    digest: string;
+};
+
 /**
  * Edges a trace may follow — the shared kb-edges.ts definitions, minus
  * `body-link`: body links can reach most of a bundle from anywhere, which
@@ -816,6 +821,16 @@ type KbLoadResult = {
      */
     digest: string;
 };
+/** What `stamp` reports for one base. See `kb-stamp.ts`. */
+type KbStampResult = {
+    path: string;
+    digest: string;
+    recordCount: number;
+    superseded: number;
+    /** Newest `generated.at` across the base, or null when none carries one. */
+    newestAt: string | null;
+    records: KbRecordStamp[];
+};
 type KbWriteInput = {
     type: string;
     slug: string;
@@ -984,6 +999,13 @@ declare class KbStore {
         all?: boolean;
         repoRoot?: string;
     }): Promise<KbLoadResult>;
+    /**
+     * `load`'s digest without `load`'s bodies — the same records, adjudicated
+     * the same way, handed back as a stamp. Skips the anchor drift pass, which
+     * reads source files and only ever adds warnings: no warning reaches the
+     * digest, so the value is identical to the one `load` returns.
+     */
+    stamp(bundlePath: string): Promise<KbStampResult>;
     /** How a position was arrived at, as a timeline. See `trace.ts`. */
     trace(bundlePath: string, seedId: string, options?: KbTraceOptions): Promise<KbTraceStep[]>;
     /** Every record named in one line each. See `catalog.ts`. */
@@ -1120,6 +1142,8 @@ declare enum ErrorTypes {
     KbPackBudgetExceeded = "KbPackBudgetExceeded",
     KbRecordNotFound = "KbRecordNotFound",
     KbSelfVerification = "KbSelfVerification",
+    KbStampBaselineUnreadable = "KbStampBaselineUnreadable",
+    KbStampDigestBaselineAmbiguous = "KbStampDigestBaselineAmbiguous",
     KbUnknownLinkRel = "KbUnknownLinkRel",
     KbWriteConflict = "KbWriteConflict"
 }
@@ -1981,8 +2005,12 @@ type KbCommand<Shape extends z.ZodRawShape = z.ZodRawShape> = {
     /** Shown to an agent choosing a tool, so it carries the judgment too. */
     description: string;
     input: z.ZodObject<Shape>;
-    /** Positional argv → the same object MCP receives. */
-    fromArgv(argv: string[], bundlePath: string, stdin: () => Promise<string>): Promise<unknown> | unknown;
+    /**
+     * Positional argv → the same object MCP receives. `bundleExplicit` says
+     * whether `--bundle` was actually passed, for the one command whose meaning
+     * turns on it: `stamp` with no bundle stamps every pinned base.
+     */
+    fromArgv(argv: string[], bundlePath: string, stdin: () => Promise<string>, bundleExplicit?: boolean): Promise<unknown> | unknown;
     run(ctx: KbCommandContext, input: z.infer<z.ZodObject<Shape>>): Promise<unknown>;
     /**
      * A human-readable form of the result, for the CLI. Where it exists the CLI

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   runKbCli
-} from "./chunk-MK7GU4DX.js";
+} from "./chunk-RINBOAQZ.js";
 import {
   createKbMcpServer,
   runKbMcpServer
-} from "./chunk-LACCRB2Y.js";
+} from "./chunk-MEZCF646.js";
 import {
   BaseError,
   CONTEXT_BEGIN,
@@ -117,7 +117,7 @@ import {
   trace,
   unpinBase,
   validateBundle
-} from "./chunk-KNIUBCZY.js";
+} from "./chunk-H5W53NVU.js";
 
 // src/match-diff.ts
 function matchToDiff(files, records, options = {}) {