audit-tools 0.32.22 → 0.32.27

package/dist/shared/dispatch/admissionLoop.d.ts

@@ -39,14 +39,14 @@ export declare const AdmissionGrantSchema: z.ZodObject<{
     lease_id: z.ZodString;
     cost: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
-    packet_id: string;
     cost: number;
+    packet_id: string;
     pool_id: string;
     resource_key: string;
     lease_id: string;
 }, {
-    packet_id: string;
     cost: number;
+    packet_id: string;
     pool_id: string;
     resource_key: string;
     lease_id: string;
@@ -65,18 +65,18 @@ export declare const AdmissionExplainSchema: z.ZodObject<{
     cost: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
     reason: "admitted" | "no_capable_pool" | "budget_exhausted" | "cap_reached";
+    cost: number;
     admitted: boolean;
     packet_id: string;
-    cost: number;
     pool_id: string | null;
     resource_key: string | null;
     headroom_before?: number | undefined;
     outstanding_before?: number | undefined;
 }, {
     reason: "admitted" | "no_capable_pool" | "budget_exhausted" | "cap_reached";
+    cost: number;
     admitted: boolean;
     packet_id: string;
-    cost: number;
     pool_id: string | null;
     resource_key: string | null;
     headroom_before?: number | undefined;
@@ -101,14 +101,14 @@ export declare const DispatchAdmissionSchema: z.ZodObject<{
         lease_id: z.ZodString;
         cost: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        packet_id: string;
         cost: number;
+        packet_id: string;
         pool_id: string;
         resource_key: string;
         lease_id: string;
     }, {
-        packet_id: string;
         cost: number;
+        packet_id: string;
         pool_id: string;
         resource_key: string;
         lease_id: string;
@@ -126,18 +126,18 @@ export declare const DispatchAdmissionSchema: z.ZodObject<{
         cost: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
         reason: "admitted" | "no_capable_pool" | "budget_exhausted" | "cap_reached";
+        cost: number;
         admitted: boolean;
         packet_id: string;
-        cost: number;
         pool_id: string | null;
         resource_key: string | null;
         headroom_before?: number | undefined;
         outstanding_before?: number | undefined;
     }, {
         reason: "admitted" | "no_capable_pool" | "budget_exhausted" | "cap_reached";
+        cost: number;
         admitted: boolean;
         packet_id: string;
-        cost: number;
         pool_id: string | null;
         resource_key: string | null;
         headroom_before?: number | undefined;
@@ -145,8 +145,8 @@ export declare const DispatchAdmissionSchema: z.ZodObject<{
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
     leases: {
-        packet_id: string;
         cost: number;
+        packet_id: string;
         pool_id: string;
         resource_key: string;
         lease_id: string;
@@ -155,9 +155,9 @@ export declare const DispatchAdmissionSchema: z.ZodObject<{
     declared_cap: number | null;
     explains: {
         reason: "admitted" | "no_capable_pool" | "budget_exhausted" | "cap_reached";
+        cost: number;
         admitted: boolean;
         packet_id: string;
-        cost: number;
         pool_id: string | null;
         resource_key: string | null;
         headroom_before?: number | undefined;
@@ -165,8 +165,8 @@ export declare const DispatchAdmissionSchema: z.ZodObject<{
     }[];
 }, {
     leases: {
-        packet_id: string;
         cost: number;
+        packet_id: string;
         pool_id: string;
         resource_key: string;
         lease_id: string;
@@ -175,9 +175,9 @@ export declare const DispatchAdmissionSchema: z.ZodObject<{
     declared_cap: number | null;
     explains: {
         reason: "admitted" | "no_capable_pool" | "budget_exhausted" | "cap_reached";
+        cost: number;
         admitted: boolean;
         packet_id: string;
-        cost: number;
         pool_id: string | null;
         resource_key: string | null;
         headroom_before?: number | undefined;

package/dist/shared/dispatch/costRank.d.ts

@@ -50,11 +50,22 @@ export declare function blendedPrice(price: ModelStatics["price"] | undefined):
 /**
  * Resolve a model id to its blended $/Mtok price via the vendored models.dev
  * snapshot, or `undefined` when the model is unknown / the dataset is empty.
+ *
+ * Optional `provider` pins the native (per-provider) price; omitting it takes the
+ * cheapest-collision default. Single-provider snapshots resolve identically
+ * either way.
  */
-export declare function resolveModelPrice(model: string | null | undefined): number | undefined;
+export declare function resolveModelPrice(model: string | null | undefined, provider?: string | null): number | undefined;
 export interface CostRankInput {
     /** Model id for the price lookup (rung 2). `null`/unknown ⇒ falls through. */
     model: string | null | undefined;
+    /**
+     * Optional provider that owns this pool's model. When set, the price lookup
+     * pins that provider's native price on a cross-provider model-id collision;
+     * omitting it takes the cheapest-collision default. No effect on a
+     * single-provider snapshot.
+     */
+    provider?: string | null;
     /** Pool tier for the fallback ordinal (rung 3). */
     tier: DispatchModelTier | null | undefined;
     /**
@@ -75,6 +86,11 @@ export interface CostCandidate {
     /** Stable identifier for the candidate (provider name, or `provider/model`). */
     key: string;
     model?: string | null;
+    /**
+     * Optional owning provider; pins the native price on a cross-provider model-id
+     * collision. Omit for the cheapest-collision default.
+     */
+    provider?: string | null;
     tier?: DispatchModelTier | null;
 }
 /** A candidate with its resolved price + the tool's suggested position. */

package/dist/shared/dispatch/costRank.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"costRank.d.ts","sourceRoot":"","sources":["../../../src/shared/dispatch/costRank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,eAAe,UAAY,CAAC;AACzC,eAAO,MAAM,uBAAuB,UAAY,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUzF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEtF;AAED,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,mDAAmD;IACnD,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAc3D;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACjC;AAED,2EAA2E;AAC3E,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,oBAAoB,EAAE,CAsBvF;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACjD,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,GAAG,IAAI,CAIf;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAClG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAcrB"}
+{"version":3,"file":"costRank.d.ts","sourceRoot":"","sources":["../../../src/shared/dispatch/costRank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,eAAe,UAAY,CAAC;AACzC,eAAO,MAAM,uBAAuB,UAAY,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUzF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,GAAG,SAAS,CAEpB;AAED,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mDAAmD;IACnD,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAc3D;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACjC;AAED,2EAA2E;AAC3E,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,oBAAoB,EAAE,CAsBvF;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACjD,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,GAAG,IAAI,CAIf;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAClG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAcrB"}

package/dist/shared/dispatch/costRank.js

@@ -63,9 +63,13 @@ export function blendedPrice(price) {
 /**
  * Resolve a model id to its blended $/Mtok price via the vendored models.dev
  * snapshot, or `undefined` when the model is unknown / the dataset is empty.
+ *
+ * Optional `provider` pins the native (per-provider) price; omitting it takes the
+ * cheapest-collision default. Single-provider snapshots resolve identically
+ * either way.
  */
-export function resolveModelPrice(model) {
-    return blendedPrice(resolveModelStatics(model)?.price);
+export function resolveModelPrice(model, provider) {
+    return blendedPrice(resolveModelStatics(model, provider)?.price);
 }
 /**
  * Derive a pool's `costRank` (LOWER = cheaper). Total order across all pools in a
@@ -79,7 +83,7 @@ export function deriveCostRank(input) {
         return CONFIRMED_ORDER_BAND_BASE + input.confirmedPosition;
     }
     // Rung 2 — real blended price when the dataset knows the model.
-    const price = resolveModelPrice(input.model);
+    const price = resolveModelPrice(input.model, input.provider);
     if (price !== undefined)
         return PRICE_BAND_BASE + price;
     // Rung 3 — tier ordinal, offset above every priced pool (unknown = overflow).
@@ -94,7 +98,7 @@ export function deriveCostRank(input) {
  */
 export function suggestCostOrdering(candidates) {
     const priced = candidates.map((c) => {
-        const price = resolveModelPrice(c.model);
+        const price = resolveModelPrice(c.model, c.provider);
         return { candidate: c, price };
     });
     const sorted = [...priced].sort((a, b) => {

package/dist/shared/dispatch/costRank.js.map

@@ -1 +1 @@
-{"version":3,"file":"costRank.js","sourceRoot":"","sources":["../../../src/shared/dispatch/costRank.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"costRank.js","sourceRoot":"","sources":["../../../src/shared/dispatch/costRank.ts"],"names":[],"mappings":"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"}

package/dist/shared/friction/captureFrictionEvent.d.ts

@@ -1,4 +1,5 @@
 import { type FrictionCaptureArtifact, type FrictionItem } from "../io/frictionCapture.js";
+import { type FrictionCategory } from "./frictionRecord.js";
 export type { CapturedFrictionItem } from "./frictionRecord.js";
 /**
  * The single mechanical-friction sink (FC-005). Mechanical seams (O3
@@ -40,6 +41,18 @@ export interface FrictionEvent extends FrictionItem {
      * already present in the run record is a no-op (per-event de-dup, INV-O1-6).
      */
     id: string;
+    /**
+     * The REAL close-out category (one of `FRICTION_CATEGORIES`) this event feeds.
+     * Carried through onto the persisted `CapturedFrictionItem` so the per-category
+     * friction walk keys on a real category, not the coarse `bug|trap|suggestion`
+     * origin hint. Optional so a bare `captureFrictionEvent` caller need not supply it.
+     */
+    frictionCategory?: FrictionCategory;
+    /**
+     * Optional artifact/subject key — the aggregation axis that collapses N
+     * same-artifact events into ONE derived observation.
+     */
+    artifact?: string;
 }
 /**
  * Append one mechanical friction event to the per-run record, best-effort.

package/dist/shared/friction/captureFrictionEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"captureFrictionEvent.d.ts","sourceRoot":"","sources":["../../../src/shared/friction/captureFrictionEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAM3F,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,oEAAoE;AACpE,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,uBAAuB,CAAC,MAAM,CAAoB,GACvD,OAAO,CAAC,IAAI,CAAC,CA0Bf"}
+{"version":3,"file":"captureFrictionEvent.d.ts","sourceRoot":"","sources":["../../../src/shared/friction/captureFrictionEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,oEAAoE;AACpE,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,uBAAuB,CAAC,MAAM,CAAoB,GACvD,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/shared/friction/captureFrictionEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"captureFrictionEvent.js","sourceRoot":"","sources":["../../../src/shared/friction/captureFrictionEvent.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AA+C7B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAoB,EACpB,KAAa,EACb,KAAoB,EACpB,OAAwC,gBAAgB;IAExD,IAAI,CAAC;QACH,MAAM,uBAAuB,CAC3B,YAAY,EACZ,KAAK,EACL,CAAC,MAAM,EAAE,EAAE;YACT,MAAM,SAAS,GAA2B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;gBACvE,CAAC,CAAC,MAAM,CAAC,SAAS;gBAClB,CAAC,CAAC,EAAE,CAAC;YACP,oEAAoE;YACpE,mEAAmE;YACnE,gEAAgE;YAChE,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBACnD,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,OAAO;gBACL,GAAG,MAAM;gBACT,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;gBACzB,SAAS,EAAE,CAAC,GAAG,SAAS,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;aACxC,CAAC;QACJ,CAAC,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;AACH,CAAC"}
+{"version":3,"file":"captureFrictionEvent.js","sourceRoot":"","sources":["../../../src/shared/friction/captureFrictionEvent.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AA2D7B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAoB,EACpB,KAAa,EACb,KAAoB,EACpB,OAAwC,gBAAgB;IAExD,IAAI,CAAC;QACH,MAAM,uBAAuB,CAC3B,YAAY,EACZ,KAAK,EACL,CAAC,MAAM,EAAE,EAAE;YACT,MAAM,SAAS,GAA2B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;gBACvE,CAAC,CAAC,MAAM,CAAC,SAAS;gBAClB,CAAC,CAAC,EAAE,CAAC;YACP,oEAAoE;YACpE,mEAAmE;YACnE,gEAAgE;YAChE,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBACnD,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,OAAO;gBACL,GAAG,MAAM;gBACT,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;gBACzB,SAAS,EAAE,CAAC,GAAG,SAAS,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;aACxC,CAAC;QACJ,CAAC,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;AACH,CAAC"}

package/dist/shared/friction/frictionRecord.d.ts

@@ -17,10 +17,49 @@ import { type FrictionCaptureArtifact, type FrictionItem } from "../io/frictionC
  * (via `frictionCapturePath` / `sanitizeRunId`) — no platform-baked literal, so
  * the substrate is OS/path-agnostic (INV-O1-7).
  */
-/** A single captured mechanical friction event: a `FrictionItem` plus a stable id. */
+/**
+ * The REQUIRED friction CATEGORIES — the coverage axis the blocking close-out
+ * enforces EVERY run. The host must, for EACH category, either record ≥1
+ * `open_observations[]` entry tagged with it OR an explicit
+ * `category_attestations[]` "nothing to report". A category can never be skipped
+ * by silence — that omission is exactly the failure the gate prevents.
+ *
+ * Single-sourced HERE in the substrate (not in `triage.ts`) so the mechanical
+ * capture layer (`stepBoundaryCapture.ts`) can stamp a captured event with a REAL
+ * category without importing the triage module — there is exactly ONE category
+ * vocabulary shared by capture, triage, and the render, and it can never drift.
+ */
+export declare const FRICTION_CATEGORIES: readonly ["ambiguous_direction", "tool_should_decide", "inefficient_feeding"];
+export type FrictionCategory = (typeof FRICTION_CATEGORIES)[number];
+/** Whether a value is one of the required friction categories (contract check). */
+export declare function isFrictionCategory(value: unknown): value is FrictionCategory;
+/**
+ * A single captured mechanical friction event: a `FrictionItem` plus a stable id
+ * and the REAL friction category it belongs to (one of `FRICTION_CATEGORIES`).
+ */
 export interface CapturedFrictionItem extends FrictionItem {
     /** Stable distinct id; re-recording an event with this id is a no-op de-dup. */
     id: string;
+    /**
+     * The REAL close-out category (one of `FRICTION_CATEGORIES`) this mechanical
+     * event belongs to — what the per-category friction walk keys on. Distinct
+     * from the inherited `FrictionItem.category` (`bug|trap|suggestion`), which is
+     * only a coarse origin hint and is NEVER a close-out category. Optional only
+     * for back-compat with older records; a stamped event always carries it.
+     */
+    frictionCategory?: FrictionCategory;
+    /**
+     * Optional artifact/subject key this event concerns (e.g. the node id, the
+     * contract id) — the aggregation axis that collapses N same-artifact events
+     * into ONE derived observation. Falls back to `area` when unset.
+     */
+    artifact?: string;
+    /**
+     * Optional measured token cost this event incurred (best-effort — supplied only
+     * when the seam has a real measure). Summed into the aggregate's `tokens` cost
+     * signal; never fabricated when absent.
+     */
+    tokens?: number;
 }
 /** The host disposition vocabulary over a captured subject. */
 export type FrictionDisposition = "keep" | "discard" | "annotate";
@@ -46,6 +85,21 @@ export interface FrictionOpenObservation {
     dimension?: string;
     /** The host's observation note. */
     note: string;
+    /**
+     * When set, the aggregation subject (artifact/node/contract key) this
+     * observation summarizes. Present on TOOL-DERIVED observations (see `derived`)
+     * so a re-run can idempotently replace the derived set keyed on
+     * `(category, artifact)`; absent on host-authored observations.
+     */
+    artifact?: string;
+    /**
+     * True when the tool DERIVED this observation by aggregating mechanical
+     * step-boundary events (pre-populating the host's category walk), vs. a
+     * host-authored observation. The close-out counts a derived observation toward
+     * category coverage exactly like a host one; the flag only lets the derive step
+     * replace its own prior output without ever touching host-authored entries.
+     */
+    derived?: boolean;
 }
 /**
  * An explicit affirmation that a friction CATEGORY had nothing to report this

package/dist/shared/friction/frictionRecord.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frictionRecord.d.ts","sourceRoot":"","sources":["../../../src/shared/friction/frictionRecord.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAKlB,MAAM,0BAA0B,CAAC;AAIlC;;;;;;;;;;;;;;;;;GAiBG;AAEH,sFAAsF;AACtF,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAElE,mFAAmF;AACnF,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,WAAW,EAAE,mBAAmB,CAAC;IACjC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oFAAoF;AACpF,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IACtE,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,qEAAqE;IACrE,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC3C;yFACqF;IACrF,iBAAiB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC9C,kFAAkF;IAClF,qBAAqB,CAAC,EAAE,2BAA2B,EAAE,CAAC;IACtD,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,uBAAuB,EACpE,IAAI,GAAE,uBAAuB,CAAC,MAAM,CAAoB,GACvD,OAAO,CAAC,uBAAuB,CAAC,CAUlC"}
+{"version":3,"file":"frictionRecord.d.ts","sourceRoot":"","sources":["../../../src/shared/friction/frictionRecord.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAKlB,MAAM,0BAA0B,CAAC;AAIlC;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,+EAItB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAK5E;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAElE,mFAAmF;AACnF,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,WAAW,EAAE,mBAAmB,CAAC;IACjC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oFAAoF;AACpF,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IACtE,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,qEAAqE;IACrE,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC3C;yFACqF;IACrF,iBAAiB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC9C,kFAAkF;IAClF,qBAAqB,CAAC,EAAE,2BAA2B,EAAE,CAAC;IACtD,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,uBAAuB,EACpE,IAAI,GAAE,uBAAuB,CAAC,MAAM,CAAoB,GACvD,OAAO,CAAC,uBAAuB,CAAC,CAUlC"}

package/dist/shared/friction/frictionRecord.js

@@ -2,6 +2,46 @@ import { join } from "node:path";
 import { FRICTION_CAPTURE_SCHEMA_VERSION, frictionCaptureDir, frictionCapturePath, sanitizeRunId, } from "../io/frictionCapture.js";
 import { readOptionalJsonFile, writeJsonFile } from "../io/json.js";
 import { withFileLock } from "../quota/fileLock.js";
+/**
+ * The shared per-run friction RECORD substrate (CE-004 / CE-010, the O1
+ * FRICTION-FOUNDATION layer). Single-sourced for BOTH orchestrators so the
+ * record shape, the lock path, and the locked read-merge-write append cannot
+ * drift between the two halves of the pipeline.
+ *
+ * `captureFrictionEvent` (the mechanical sink) and `recordFrictionDisposition` /
+ * `decideFrictionTriage` (the host triage path) BOTH route their record
+ * mutations through `appendFrictionUnderLock`, which rides ONE
+ * `withFileLock(frictionLockPath)` and reads-then-MERGEs the existing record —
+ * so a late mechanical emit never clobbers host `dispositions[]` /
+ * `open_observations[]` already written, and a host disposition never drops a
+ * concurrently-appended mechanical `frictions[]` entry (CE-010).
+ *
+ * Every path derives from `node:path` joins off the supplied artifacts dir
+ * (via `frictionCapturePath` / `sanitizeRunId`) — no platform-baked literal, so
+ * the substrate is OS/path-agnostic (INV-O1-7).
+ */
+/**
+ * The REQUIRED friction CATEGORIES — the coverage axis the blocking close-out
+ * enforces EVERY run. The host must, for EACH category, either record ≥1
+ * `open_observations[]` entry tagged with it OR an explicit
+ * `category_attestations[]` "nothing to report". A category can never be skipped
+ * by silence — that omission is exactly the failure the gate prevents.
+ *
+ * Single-sourced HERE in the substrate (not in `triage.ts`) so the mechanical
+ * capture layer (`stepBoundaryCapture.ts`) can stamp a captured event with a REAL
+ * category without importing the triage module — there is exactly ONE category
+ * vocabulary shared by capture, triage, and the render, and it can never drift.
+ */
+export const FRICTION_CATEGORIES = [
+    "ambiguous_direction", // direction/decision the tool or prompt left to the host that it should have resolved
+    "tool_should_decide", // the host had to remember / notice / enforce something the tool should guarantee
+    "inefficient_feeding", // redundant or wasteful work, poor context feeding, or a tool inefficiency
+];
+/** Whether a value is one of the required friction categories (contract check). */
+export function isFrictionCategory(value) {
+    return (typeof value === "string" &&
+        FRICTION_CATEGORIES.includes(value));
+}
 /**
  * `<artifactsDir>/friction/<run_id>.lock` — the lock path guarding the per-run
  * record. Single-sourced so every record mutator (mechanical sink + host triage)

package/dist/shared/friction/frictionRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"frictionRecord.js","sourceRoot":"","sources":["../../../src/shared/friction/frictionRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAGL,+BAA+B,EAC/B,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAwFpD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB,EAAE,KAAa;IAClE,OAAO,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,iFAAiF;AACjF,SAAS,WAAW,CAClB,KAAa,EACb,IAAqC;IAErC,OAAO;QACL,cAAc,EAAE,+BAA+B;QAC/C,IAAI;QACJ,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAoB,EACpB,KAAa,EACb,MAAoE,EACpE,OAAwC,gBAAgB;IAExD,OAAO,YAAY,CAAC,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CACzC,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,CACzC,CAAC;QACF,MAAM,IAAI,GAAG,QAAQ,IAAI,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,aAAa,CAAC,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"frictionRecord.js","sourceRoot":"","sources":["../../../src/shared/friction/frictionRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAGL,+BAA+B,EAC/B,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,qBAAqB,EAAE,sFAAsF;IAC7G,oBAAoB,EAAE,kFAAkF;IACxG,qBAAqB,EAAE,2EAA2E;CAC1F,CAAC;AAGX,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,mBAAyC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC3D,CAAC;AACJ,CAAC;AA2GD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB,EAAE,KAAa;IAClE,OAAO,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,iFAAiF;AACjF,SAAS,WAAW,CAClB,KAAa,EACb,IAAqC;IAErC,OAAO;QACL,cAAc,EAAE,+BAA+B;QAC/C,IAAI;QACJ,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAoB,EACpB,KAAa,EACb,MAAoE,EACpE,OAAwC,gBAAgB;IAExD,OAAO,YAAY,CAAC,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CACzC,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,CACzC,CAAC;QACF,MAAM,IAAI,GAAG,QAAQ,IAAI,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,aAAa,CAAC,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/friction/stepBoundaryCapture.d.ts

@@ -1,5 +1,6 @@
 import type { FrictionItem } from "../io/frictionCapture.js";
 import type { FrictionCaptureArtifact } from "../io/frictionCapture.js";
+import type { FrictionCategory } from "./frictionRecord.js";
 /**
  * CE-005 — the SINGLE shared backend-observed step-boundary chokepoint.
  *
@@ -48,6 +49,12 @@ import type { FrictionCaptureArtifact } from "../io/frictionCapture.js";
  *                           quarantine ref, NOT landed (discriminator: the node id).
  */
 export type StepBoundaryEventType = "phase_reemit" | "artifact_rejected" | "repair_round" | "post_repair_rederive" | "no_change_merge" | "intent_gate_fallback" | "quota_escalation" | "coverage_total_lines_mismatch" | "node_quarantine" | (string & {});
+/**
+ * The REAL close-out friction category for a step-boundary fact kind. Total: an
+ * unknown event type degrades to `inefficient_feeding` so the mapping is never
+ * undefined and a captured event is ALWAYS tagged with a real category.
+ */
+export declare function stepBoundaryFrictionCategory(eventType: StepBoundaryEventType): FrictionCategory;
 /**
  * Build the STRUCTURED, collision-free de-dup id for a step-boundary fact.
  * Components are individually percent-encoded then joined with `:` — a delimiter
@@ -70,6 +77,13 @@ export interface StepBoundaryFriction {
     severity?: FrictionItem["severity"];
     category?: FrictionItem["category"];
     area?: string;
+    /**
+     * Optional artifact/subject key this fact concerns (e.g. the node id, the
+     * contract id). The aggregation axis for the derived per-category observation:
+     * N facts on the SAME artifact collapse to one `inefficient_feeding` line.
+     * Falls back to `area`, then the discriminator, when unset.
+     */
+    artifact?: string;
 }
 /**
  * Route ONE backend-observed step-boundary fact through the single chokepoint.

package/dist/shared/friction/stepBoundaryCapture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stepBoundaryCapture.d.ts","sourceRoot":"","sources":["../../../src/shared/friction/stepBoundaryCapture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,mBAAmB,GACnB,cAAc,GACd,sBAAsB,GACtB,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,+BAA+B,GAC/B,iBAAiB,GACjB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAgBlB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,MAAM,CAIR;AAED,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,SAAS,EAAE,qBAAqB,CAAC;IACjC;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CASf"}
+{"version":3,"file":"stepBoundaryCapture.d.ts","sourceRoot":"","sources":["../../../src/shared/friction/stepBoundaryCapture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,mBAAmB,GACnB,cAAc,GACd,sBAAsB,GACtB,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,+BAA+B,GAC/B,iBAAiB,GACjB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAgClB;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,qBAAqB,GAC/B,gBAAgB,CAElB;AAgBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,MAAM,CAIR;AAED,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,SAAS,EAAE,qBAAqB,CAAC;IACjC;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/shared/friction/stepBoundaryCapture.js

@@ -1,4 +1,41 @@
 import { captureFrictionEvent } from "./captureFrictionEvent.js";
+/**
+ * Deterministic map from a backend step-boundary fact kind to the REAL close-out
+ * friction CATEGORY (one of `FRICTION_CATEGORIES`) it belongs to. This is what
+ * lets the auto-captured event feed the per-category friction walk directly:
+ * every backend fact is redundant/wasteful re-work or a something-the-tool-had-to
+ * -be-reminded-of, never the coarse `trap` bucket the sink used to stamp.
+ *
+ *  - `inefficient_feeding` — redundant / wasteful re-work: phase re-emits, repair
+ *    rounds, post-repair re-derives, no-change merges, quota escalations, and the
+ *    coverage-line mismatch (a re-round-trip to fix a mechanical mismatch).
+ *  - `tool_should_decide`  — a fact where the tool fell back to host discretion or
+ *    quarantined work the host must now shepherd: artifact rejection, the
+ *    intent-gate lock-across-judge fallback, and a node quarantine.
+ *
+ * The named members are pinned; any UNKNOWN `event_type` degrades to
+ * `inefficient_feeding` (the safe "this was avoidable re-work" default) so a new
+ * backend fact always lands in a real category — never `trap`, never uncovered.
+ */
+const STEP_BOUNDARY_CATEGORY = {
+    phase_reemit: "inefficient_feeding",
+    repair_round: "inefficient_feeding",
+    post_repair_rederive: "inefficient_feeding",
+    no_change_merge: "inefficient_feeding",
+    quota_escalation: "inefficient_feeding",
+    coverage_total_lines_mismatch: "inefficient_feeding",
+    artifact_rejected: "tool_should_decide",
+    intent_gate_fallback: "tool_should_decide",
+    node_quarantine: "tool_should_decide",
+};
+/**
+ * The REAL close-out friction category for a step-boundary fact kind. Total: an
+ * unknown event type degrades to `inefficient_feeding` so the mapping is never
+ * undefined and a captured event is ALWAYS tagged with a real category.
+ */
+export function stepBoundaryFrictionCategory(eventType) {
+    return STEP_BOUNDARY_CATEGORY[eventType] ?? "inefficient_feeding";
+}
 /**
  * Percent-encode a single id component so the join delimiter (`:`) cannot appear
  * inside it. `encodeURIComponent` already escapes `:` (and `/`, `\`, `%`, etc.),
@@ -33,7 +70,17 @@ export async function captureStepBoundaryFriction(artifactsDir, runId, fact, too
         id: stepBoundaryEventId(fact.eventType, runId, fact.discriminator),
         note: fact.note,
         severity: fact.severity,
+        // The inherited `FrictionItem.category` (`bug|trap|suggestion`) is only a
+        // coarse ORIGIN hint. It is NEVER the close-out category — the close-out keys
+        // on `frictionCategory` below. Default the origin hint to `trap` (a standing
+        // tooling fact) but ALWAYS stamp a REAL close-out category so the event feeds
+        // the per-category walk instead of the dead `trap` bucket it used to land in.
         category: fact.category ?? "trap",
+        frictionCategory: stepBoundaryFrictionCategory(fact.eventType),
+        // The aggregation axis: N same-artifact backend facts collapse to ONE derived
+        // observation. Prefer the caller's explicit `artifact`, then the fact's area,
+        // then the discriminator (which is per-instance but still a stable subject key).
+        artifact: fact.artifact ?? fact.area ?? fact.discriminator,
         area: fact.area,
     };
     await captureFrictionEvent(artifactsDir, runId, event, tool);

package/dist/shared/friction/stepBoundaryCapture.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepBoundaryCapture.js","sourceRoot":"","sources":["../../../src/shared/friction/stepBoundaryCapture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAsB,MAAM,2BAA2B,CAAC;AA8DrF;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,OAAO,CACtC,OAAO,EACP,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CACxD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAgC,EAChC,KAAa,EACb,aAAqB;IAErB,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC;SACrC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;SACtC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAmBD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,YAAoB,EACpB,KAAa,EACb,IAA0B,EAC1B,IAAqC;IAErC,MAAM,KAAK,GAAkB;QAC3B,EAAE,EAAE,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC;QAClE,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM;QACjC,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;IACF,MAAM,oBAAoB,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"stepBoundaryCapture.js","sourceRoot":"","sources":["../../../src/shared/friction/stepBoundaryCapture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAsB,MAAM,2BAA2B,CAAC;AA+DrF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,sBAAsB,GAAqC;IAC/D,YAAY,EAAE,qBAAqB;IACnC,YAAY,EAAE,qBAAqB;IACnC,oBAAoB,EAAE,qBAAqB;IAC3C,eAAe,EAAE,qBAAqB;IACtC,gBAAgB,EAAE,qBAAqB;IACvC,6BAA6B,EAAE,qBAAqB;IACpD,iBAAiB,EAAE,oBAAoB;IACvC,oBAAoB,EAAE,oBAAoB;IAC1C,eAAe,EAAE,oBAAoB;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,SAAgC;IAEhC,OAAO,sBAAsB,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,OAAO,CACtC,OAAO,EACP,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CACxD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAgC,EAChC,KAAa,EACb,aAAqB;IAErB,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC;SACrC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;SACtC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AA0BD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,YAAoB,EACpB,KAAa,EACb,IAA0B,EAC1B,IAAqC;IAErC,MAAM,KAAK,GAAkB;QAC3B,EAAE,EAAE,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC;QAClE,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,0EAA0E;QAC1E,8EAA8E;QAC9E,6EAA6E;QAC7E,8EAA8E;QAC9E,8EAA8E;QAC9E,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM;QACjC,gBAAgB,EAAE,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC;QAC9D,8EAA8E;QAC9E,8EAA8E;QAC9E,iFAAiF;QACjF,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa;QAC1D,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;IACF,MAAM,oBAAoB,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/shared/friction/triage.d.ts

@@ -1,8 +1,8 @@
 import { type FrictionCaptureArtifact } from '../io/frictionCapture.js';
 import { type AgentReflection } from '../agentReflections.js';
-import { type FrictionCategoryAttestation, type FrictionDisposition, type FrictionDispositionRecord, type FrictionOpenObservation, type TriagedFrictionArtifact } from './frictionRecord.js';
-export type { CapturedFrictionItem, FrictionCategoryAttestation, FrictionDisposition, FrictionDispositionRecord, FrictionOpenObservation, TriagedFrictionArtifact, } from './frictionRecord.js';
-export { appendFrictionUnderLock, frictionLockPath } from './frictionRecord.js';
+import { type CapturedFrictionItem, type FrictionCategory, type FrictionCategoryAttestation, type FrictionDisposition, type FrictionDispositionRecord, type FrictionOpenObservation, type TriagedFrictionArtifact } from './frictionRecord.js';
+export type { CapturedFrictionItem, FrictionCategory, FrictionCategoryAttestation, FrictionDisposition, FrictionDispositionRecord, FrictionOpenObservation, TriagedFrictionArtifact, } from './frictionRecord.js';
+export { FRICTION_CATEGORIES, appendFrictionUnderLock, frictionLockPath, isFrictionCategory, } from './frictionRecord.js';
 /**
  * O1 end-of-run friction TRIAGE — single-sourced for BOTH orchestrators so the
  * triage step shape, the disposition vocabulary, the blocking semantics, and the
@@ -54,19 +54,99 @@ export interface TriageSubject {
  */
 export declare const FRICTION_NAMED_DIMENSIONS: readonly ["gate_reloops", "integration_guard_failures", "rescopes", "surprises", "manual_interventions", "other"];
 export type FrictionDimension = (typeof FRICTION_NAMED_DIMENSIONS)[number] | string;
-/**
- * The REQUIRED friction CATEGORIES — the coverage axis the blocking close-out
- * enforces EVERY run. The host must, for EACH category, either record ≥1
- * `open_observations[]` entry tagged with it OR an explicit
- * `category_attestations[]` "nothing to report". A category can never be skipped
- * by silence — that omission is exactly the failure this gate prevents.
- */
-export declare const FRICTION_CATEGORIES: readonly ["ambiguous_direction", "tool_should_decide", "inefficient_feeding"];
-export type FrictionCategory = (typeof FRICTION_CATEGORIES)[number];
 /** One-line human labels for each category, shown in the triage prompt. */
 export declare const FRICTION_CATEGORY_LABELS: Record<FrictionCategory, string>;
-/** Whether a value is one of the required friction categories (contract check). */
-export declare function isFrictionCategory(value: unknown): value is FrictionCategory;
+/**
+ * Cost signals measured across an aggregate of same-category (and, where
+ * applicable, same-artifact) mechanical events. These are what let the walk say
+ * "this was expensive re-work" quantitatively, not just "something happened".
+ */
+export interface FrictionCostSignals {
+    /**
+     * Round-trips: the number of aggregated mechanical events. Each backend
+     * step-boundary fact is one avoidable round-trip (a re-emit, a repair round, a
+     * re-derive, …), so the event count IS the round-trip count.
+     */
+    round_trips: number;
+    /**
+     * Verbatim re-authors: aggregated events whose subject artifact was touched by
+     * MORE THAN ONE event — i.e. the same artifact was re-worked repeatedly. This
+     * is the "we re-authored the same thing again" signal.
+     */
+    verbatim_re_authors: number;
+    /**
+     * Summed token cost across the aggregated events, when the events carried a
+     * `tokens` measure (0 when none did — token accounting stays best-effort and
+     * never fabricated).
+     */
+    tokens: number;
+}
+/**
+ * The threshold an aggregate must reach to SURFACE as a pre-populated,
+ * auto-covering observation. Below it, the aggregate is still reported (so the
+ * host sees it) but does NOT auto-cover its category — the host still walks it.
+ * "Below MUST NOT fire" is the contract: a single, cheap round-trip is noise, not
+ * a surfaced friction observation.
+ */
+export declare const FRICTION_COST_SURFACE_THRESHOLD = 2;
+/** Whether an aggregate's cost is at/above the surface threshold (fires). */
+export declare function costSignalsSurface(signals: FrictionCostSignals): boolean;
+/**
+ * ONE derived observation aggregated from N same-category mechanical events. This
+ * is the pre-populated close-out entry: N same-artifact backend facts collapse
+ * into a SINGLE `inefficient_feeding` (or other-category) observation with the
+ * measured cost signals and the covered event ids.
+ */
+export interface DerivedFrictionObservation {
+    /** The real close-out category this aggregate covers. */
+    category: FrictionCategory;
+    /** The aggregation subject (the shared artifact key, or "(mixed)" when several). */
+    artifact: string;
+    /** The ids of the mechanical events folded into this observation. */
+    event_ids: string[];
+    /** The measured cost across the folded events. */
+    cost: FrictionCostSignals;
+    /**
+     * True when the aggregate's cost is at/above the surface threshold: only these
+     * pre-populate/auto-cover the category. A below-threshold aggregate is still
+     * listed for the host but never fires (never auto-covers).
+     */
+    surfaced: boolean;
+    /** A ready-to-paste observation note summarizing the aggregate + cost. */
+    note: string;
+}
+/**
+ * Measure the cost signals across an aggregate of mechanical events. Pure and
+ * deterministic — round_trips is the event count (each backend fact is one
+ * avoidable round-trip), verbatim_re_authors fires only when the SAME subject was
+ * touched by MORE THAN ONE event, and tokens sums the best-effort per-event
+ * measure (never fabricated: a missing/non-finite `tokens` contributes 0).
+ */
+export declare function measureFrictionCost(items: readonly CapturedFrictionItem[]): FrictionCostSignals;
+/**
+ * Aggregate the run's mechanical events into ONE derived observation per
+ * (real category, artifact) group — the pre-population source for the host's
+ * category walk. Pure and deterministic:
+ *
+ *  - ONLY events carrying a REAL `frictionCategory` feed the walk; an untagged
+ *    legacy event covers no category (it is a bare pending subject, not a walk
+ *    contribution) so pre-population never invents coverage.
+ *  - N same-artifact same-category events collapse to ONE observation carrying
+ *    the measured cost (`measureFrictionCost`) and the covered event ids.
+ *  - `surfaced` is the below/above threshold gate: a single cheap round-trip
+ *    (round_trips < `FRICTION_COST_SURFACE_THRESHOLD`) is reported but does NOT
+ *    fire (never auto-covers its category) — "below MUST NOT fire".
+ *  - Output order is stable (canonical category order, then artifact) so a
+ *    re-derive never churns the record.
+ */
+export declare function deriveFrictionObservations(frictions: readonly CapturedFrictionItem[]): DerivedFrictionObservation[];
+/**
+ * The SURFACED derived observations mapped into the persisted
+ * `open_observations[]` shape — the pre-populated entries the close-out gate (and
+ * the Stop-hook backstop) read for category coverage. Only aggregates at/above
+ * the surface threshold are emitted; below-threshold aggregates never fire.
+ */
+export declare function prepopulatedObservations(derived: readonly DerivedFrictionObservation[]): FrictionOpenObservation[];
 /**
  * The mandatory blocking triage decision. `pending` means the close-out is NOT
  * satisfied. `action`: