@cat-factory/contracts 0.277.0 → 0.279.0

package/dist/index.js.map

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

package/dist/mergeTrackRecord.d.ts

@@ -180,4 +180,18 @@ export declare const tagReviewEffortSchema: v.ObjectSchema<{
     readonly reviewEffort: v.NullableSchema<v.PicklistSchema<["none", "minor", "major"], undefined>, undefined>;
 }, undefined>;
 export type TagReviewEffortInput = v.InferOutput<typeof tagReviewEffortSchema>;
+/**
+ * `error.details.reason` for "no merge record under that id in this workspace": the 404 BOTH
+ * record-addressed routes answer, the read and the tag alike.
+ *
+ * It is a constant rather than a literal per site because the two producers live in different
+ * packages: the read resolves the row in `@cat-factory/server` and refuses there, while the tag
+ * write refuses inside `MergeTrackRecordService` (a lost race between reading and patching is the
+ * service's to detect, not a controller's to pre-check). A machine-readable code that two packages
+ * spell independently is one rename away from a caller branching on a value only one route emits.
+ *
+ * Distinct from `no_merge_record`, which the RUN-scoped read answers for a readable run that
+ * simply made no merge decision: that is a fact about the run, not a missing id.
+ */
+export declare const MERGE_RECORD_NOT_FOUND_REASON = "merge_record_not_found";
 //# sourceMappingURL=mergeTrackRecord.d.ts.map

package/dist/mergeTrackRecord.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mergeTrackRecord.d.ts","sourceRoot":"","sources":["../src/mergeTrackRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAwB5B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,sGAQ5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,cAAc,kFAQgB,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,uEAOO,CAAA;AAE3C,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,yDAAyC,CAAA;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,sFAAsF;AACtF,eAAO,MAAM,cAAc,qCAAwE,CAAA;AAEnG;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,+GAMnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,6DAIe,CAAA;AAIlD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;;OAIG;;IAEH,qDAAqD;;IAErD;;;;;;OAMG;;IAEH,oFAAoF;;IAEpF,8EAA8E;;IAE9E,8FAA8F;;IAE9F,sEAAsE;;IAEtE,wEAAwE;;IAExE,4FAA4F;;;IAG5F,4DAA4D;;IAE5D,wFAAwF;;IAExF,iDAAiD;;IAEjD,kDAAkD;;IAElD,wEAAwE;;IAExE,wFAAwF;;IAExF,yEAAyE;;IAEzE,mFAAmF;;IAEnF,iEAAiE;;aAEjE,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAQ3E,wFAAwF;AACxF,eAAO,MAAM,8BAA8B;;;;;aAKzC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAE3F,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB;;IAEjC,wEAAwE;;IAExE,4FAA4F;;;;;;;;;;;;;aAQ5F,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAIzE;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,gBAAgB,CAYhF;AAID;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;aAE3B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEpE,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB;;aAEhC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA"}
+{"version":3,"file":"mergeTrackRecord.d.ts","sourceRoot":"","sources":["../src/mergeTrackRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAwB5B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,sGAQ5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,cAAc,kFAQgB,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,uEAOO,CAAA;AAE3C,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,yDAAyC,CAAA;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,sFAAsF;AACtF,eAAO,MAAM,cAAc,qCAAwE,CAAA;AAEnG;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,+GAMnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,6DAIe,CAAA;AAIlD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;;OAIG;;IAEH,qDAAqD;;IAErD;;;;;;OAMG;;IAEH,oFAAoF;;IAEpF,8EAA8E;;IAE9E,8FAA8F;;IAE9F,sEAAsE;;IAEtE,wEAAwE;;IAExE,4FAA4F;;;IAG5F,4DAA4D;;IAE5D,wFAAwF;;IAExF,iDAAiD;;IAEjD,kDAAkD;;IAElD,wEAAwE;;IAExE,wFAAwF;;IAExF,yEAAyE;;IAEzE,mFAAmF;;IAEnF,iEAAiE;;aAEjE,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAQ3E,wFAAwF;AACxF,eAAO,MAAM,8BAA8B;;;;;aAKzC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAE3F,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB;;IAEjC,wEAAwE;;IAExE,4FAA4F;;;;;;;;;;;;;aAQ5F,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAIzE;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,gBAAgB,CAYhF;AAID;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;aAE3B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEpE,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB;;aAEhC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAI9E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,6BAA6B,2BAA2B,CAAA"}

package/dist/mergeTrackRecord.js

@@ -248,4 +248,19 @@ export const mergeBlockSchema = v.object({
 export const tagReviewEffortSchema = v.object({
     reviewEffort: v.nullable(reviewEffortSchema),
 });
+// ---- Refusal vocabulary ---------------------------------------------------
+/**
+ * `error.details.reason` for "no merge record under that id in this workspace": the 404 BOTH
+ * record-addressed routes answer, the read and the tag alike.
+ *
+ * It is a constant rather than a literal per site because the two producers live in different
+ * packages: the read resolves the row in `@cat-factory/server` and refuses there, while the tag
+ * write refuses inside `MergeTrackRecordService` (a lost race between reading and patching is the
+ * service's to detect, not a controller's to pre-check). A machine-readable code that two packages
+ * spell independently is one rename away from a caller branching on a value only one route emits.
+ *
+ * Distinct from `no_merge_record`, which the RUN-scoped read answers for a readable run that
+ * simply made no merge decision: that is a fact about the run, not a missing id.
+ */
+export const MERGE_RECORD_NOT_FOUND_REASON = 'merge_record_not_found';
 //# sourceMappingURL=mergeTrackRecord.js.map

package/dist/mergeTrackRecord.js.map

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

package/dist/public-merge-evidence.d.ts

@@ -0,0 +1,94 @@
+import * as v from 'valibot';
+/**
+ * One persisted merge decision, as `/api/v1` speaks it: the deterministic change class, the
+ * merger's scores at the decision, what happened to the pull request, and the reviewer-effort
+ * tag a human left (null until somebody tags it; tagging is never mandatory).
+ *
+ * The projection of the stored row (`mergeTrackRecordSchema`) onto the public id vocabulary:
+ * `recordId`/`taskId`/`runId` for the row, its task and its run. Provider-neutral by
+ * construction, so a GitLab deployment reads the same shape.
+ */
+export declare const publicMergeRecordSchema: v.ObjectSchema<{
+    /** The id to pass to `POST /api/v1/merge-records/{recordId}/effort`. */
+    readonly recordId: v.StringSchema<undefined>;
+    /** The board task whose pull request this covers (`GET /api/v1/tasks/{taskId}`). */
+    readonly taskId: v.StringSchema<undefined>;
+    /**
+     * The run that produced the pull request (`GET /api/v1/runs/{runId}/report`). Nullable
+     * because the column is; every record written today is born at a merge decision inside a run,
+     * so in practice it is set. An external merge does not mint a record, it settles the one the
+     * run already wrote.
+     */
+    readonly runId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * What kind of change the pull request made, derived on the backend from its changed-file
+     * list and never from an agent's opinion. A mixed diff resolves to the highest-ranked class
+     * present, so a per-class rule can only fire on a diff carrying nothing riskier.
+     */
+    readonly changeClass: v.PicklistSchema<["docs", "test", "dependency", "config", "source", "schema", "unknown"], undefined>;
+    /** How many files the pull request changed, when the changed-file list was readable. */
+    readonly changedFileCount: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /**
+     * The merger's complexity score at the decision, 0..1. The three scores move together: all
+     * null means the merger produced no parseable assessment, not that it scored zero.
+     */
+    readonly complexity: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** The merger's risk score at the decision, 0..1 (see `complexity`). */
+    readonly risk: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** The merger's impact score at the decision, 0..1 (see `complexity`). */
+    readonly impact: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /**
+     * The merge-threshold preset the decision was compared against. The id is absent for the
+     * deployment's built-in fallback preset, which has no stored row; the name is set either way.
+     */
+    readonly mergePresetId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly mergePresetName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** What ultimately happened to the pull request. */
+    readonly decision: v.PicklistSchema<["pending_review", "auto_merged", "human_merged", "external_merged", "rejected"], undefined>;
+    /** How much review a human spent, once somebody tagged it; null while untagged. */
+    readonly reviewEffort: v.NullableSchema<v.PicklistSchema<["none", "minor", "major"], undefined>, undefined>;
+    /** The pull-request number within its repository, when known. */
+    readonly prNumber: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** The pull request's web URL. */
+    readonly prUrl: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Provider-neutral id of the repository the pull request belongs to. */
+    readonly repoId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Which VCS provider hosts it, so a mixed-provider workspace reads back correctly. */
+    readonly provider: v.NullableSchema<v.PicklistSchema<["github", "gitlab"], undefined>, undefined>;
+    /** Epoch ms the decision was recorded (the merger step's resolution). */
+    readonly createdAt: v.NumberSchema<undefined>;
+    /** Epoch ms the decision became terminal; null while `pending_review`. */
+    readonly resolvedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** Epoch ms the effort tag was recorded; null while untagged. */
+    readonly taggedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type PublicMergeRecord = v.InferOutput<typeof publicMergeRecordSchema>;
+/**
+ * Every change class's accumulated track record, whole rather than paginated: the set is the
+ * closed {@link changeClassSchema} union, so the response is seven rows on every workspace and
+ * its size is computable before the request.
+ *
+ * A class with no records is present as zeros rather than absent, for the same reason the app's
+ * table renders every class: "nothing has landed in this class yet" and "this class was left out
+ * of the response" are different facts, and only one of them is about the workspace.
+ */
+export declare const publicMergeClassRollupListSchema: v.ObjectSchema<{
+    readonly rollups: v.ArraySchema<v.ObjectSchema<{
+        readonly changeClass: v.PicklistSchema<["docs", "test", "dependency", "config", "source", "schema", "unknown"], undefined>;
+        readonly total: v.NumberSchema<undefined>;
+        readonly merged: v.NumberSchema<undefined>;
+        readonly autoMerged: v.NumberSchema<undefined>;
+        readonly humanMerged: v.NumberSchema<undefined>;
+        readonly externalMerged: v.NumberSchema<undefined>;
+        readonly rejected: v.NumberSchema<undefined>;
+        readonly pendingReview: v.NumberSchema<undefined>;
+        readonly effort: v.ObjectSchema<{
+            readonly none: v.NumberSchema<undefined>;
+            readonly minor: v.NumberSchema<undefined>;
+            readonly major: v.NumberSchema<undefined>;
+            readonly untagged: v.NumberSchema<undefined>;
+        }, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type PublicMergeClassRollupList = v.InferOutput<typeof publicMergeClassRollupListSchema>;
+//# sourceMappingURL=public-merge-evidence.d.ts.map

package/dist/public-merge-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-merge-evidence.d.ts","sourceRoot":"","sources":["../src/public-merge-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAqC5B;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB;IAClC,wEAAwE;;IAExE,oFAAoF;;IAEpF;;;;;OAKG;;IAEH;;;;OAIG;;IAEH,wFAAwF;;IAExF;;;OAGG;;IAEH,wEAAwE;;IAExE,0EAA0E;;IAE1E;;;OAGG;;;IAGH,oDAAoD;;IAEpD,mFAAmF;;IAEnF,iEAAiE;;IAEjE,kCAAkC;;IAElC,yEAAyE;;IAEzE,uFAAuF;;IAEvF,yEAAyE;;IAEzE,0EAA0E;;IAE1E,iEAAiE;;aAEjE,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;aAE3C,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gCAAgC,CAAC,CAAA"}

package/dist/public-merge-evidence.js

@@ -0,0 +1,106 @@
+import * as v from 'valibot';
+import { changeClassSchema, mergeClassRollupSchema, mergeTrackDecisionSchema, reviewEffortSchema, } from './mergeTrackRecord.js';
+import { vcsProviderSchema } from './routes/auth.js';
+// ---------------------------------------------------------------------------
+// Public MERGE-EVIDENCE wire shapes (`/api/v1/runs/:runId/merge-record`,
+// `/api/v1/merge-records/:recordId`, `…/effort`, and `/api/v1/merge-records/rollups`).
+//
+// The merge track record (ADR 0046) is the accumulated human evidence behind the auto-merge
+// policy: what KIND of change a run made, what the merger scored it, what happened, and how
+// much review a human actually spent. It was reachable only from a browser session, which
+// split the headless story in half: an integration could START a run and MERGE its pull
+// request through `/api/v1`, and then had nowhere to record how much review that merge took,
+// nor any way to read back what the workspace has accumulated. So the one signal the policy is
+// meant to eventually stand on was collectable only by the people who were not driving the runs.
+//
+// Three rules shape these shapes:
+//
+//  1. **The ROLLUPS are served verbatim** ({@link mergeClassRollupSchema}), the same aggregate
+//     the preset editor renders each class's rule against. A second, API-shaped projection of
+//     one `GROUP BY` is how two surfaces start reporting different auto-merge shares for one
+//     workspace. The consequence is worth stating: that schema is now part of the STABLE public
+//     surface and grows additively (CLAUDE.md, "The public API does not break").
+//  2. **The RECORD is projected, because its id vocabulary differs.** `/api/v1` says `taskId`
+//     and `runId` where the stored row says `blockId` and `executionId`; publishing the row
+//     as-is would hand a caller two ids it cannot address anything with, next to the ones it
+//     can. Nothing is dropped in the projection: a consumer sees every field the record holds.
+//  3. **`unknown` reaches the wire.** It is a first-class outcome (no VCS client wired, or an
+//     unreadable diff), not an error, and it never matches a per-class rule. A consumer that
+//     collapsed it onto a class would be reading a classification failure as a policy input.
+// ---------------------------------------------------------------------------
+/**
+ * One persisted merge decision, as `/api/v1` speaks it: the deterministic change class, the
+ * merger's scores at the decision, what happened to the pull request, and the reviewer-effort
+ * tag a human left (null until somebody tags it; tagging is never mandatory).
+ *
+ * The projection of the stored row (`mergeTrackRecordSchema`) onto the public id vocabulary:
+ * `recordId`/`taskId`/`runId` for the row, its task and its run. Provider-neutral by
+ * construction, so a GitLab deployment reads the same shape.
+ */
+export const publicMergeRecordSchema = v.object({
+    /** The id to pass to `POST /api/v1/merge-records/{recordId}/effort`. */
+    recordId: v.string(),
+    /** The board task whose pull request this covers (`GET /api/v1/tasks/{taskId}`). */
+    taskId: v.string(),
+    /**
+     * The run that produced the pull request (`GET /api/v1/runs/{runId}/report`). Nullable
+     * because the column is; every record written today is born at a merge decision inside a run,
+     * so in practice it is set. An external merge does not mint a record, it settles the one the
+     * run already wrote.
+     */
+    runId: v.nullable(v.string()),
+    /**
+     * What kind of change the pull request made, derived on the backend from its changed-file
+     * list and never from an agent's opinion. A mixed diff resolves to the highest-ranked class
+     * present, so a per-class rule can only fire on a diff carrying nothing riskier.
+     */
+    changeClass: changeClassSchema,
+    /** How many files the pull request changed, when the changed-file list was readable. */
+    changedFileCount: v.nullable(v.number()),
+    /**
+     * The merger's complexity score at the decision, 0..1. The three scores move together: all
+     * null means the merger produced no parseable assessment, not that it scored zero.
+     */
+    complexity: v.nullable(v.number()),
+    /** The merger's risk score at the decision, 0..1 (see `complexity`). */
+    risk: v.nullable(v.number()),
+    /** The merger's impact score at the decision, 0..1 (see `complexity`). */
+    impact: v.nullable(v.number()),
+    /**
+     * The merge-threshold preset the decision was compared against. The id is absent for the
+     * deployment's built-in fallback preset, which has no stored row; the name is set either way.
+     */
+    mergePresetId: v.nullable(v.string()),
+    mergePresetName: v.nullable(v.string()),
+    /** What ultimately happened to the pull request. */
+    decision: mergeTrackDecisionSchema,
+    /** How much review a human spent, once somebody tagged it; null while untagged. */
+    reviewEffort: v.nullable(reviewEffortSchema),
+    /** The pull-request number within its repository, when known. */
+    prNumber: v.nullable(v.number()),
+    /** The pull request's web URL. */
+    prUrl: v.nullable(v.string()),
+    /** Provider-neutral id of the repository the pull request belongs to. */
+    repoId: v.nullable(v.string()),
+    /** Which VCS provider hosts it, so a mixed-provider workspace reads back correctly. */
+    provider: v.nullable(vcsProviderSchema),
+    /** Epoch ms the decision was recorded (the merger step's resolution). */
+    createdAt: v.number(),
+    /** Epoch ms the decision became terminal; null while `pending_review`. */
+    resolvedAt: v.nullable(v.number()),
+    /** Epoch ms the effort tag was recorded; null while untagged. */
+    taggedAt: v.nullable(v.number()),
+});
+/**
+ * Every change class's accumulated track record, whole rather than paginated: the set is the
+ * closed {@link changeClassSchema} union, so the response is seven rows on every workspace and
+ * its size is computable before the request.
+ *
+ * A class with no records is present as zeros rather than absent, for the same reason the app's
+ * table renders every class: "nothing has landed in this class yet" and "this class was left out
+ * of the response" are different facts, and only one of them is about the workspace.
+ */
+export const publicMergeClassRollupListSchema = v.object({
+    rollups: v.array(mergeClassRollupSchema),
+});
+//# sourceMappingURL=public-merge-evidence.js.map

package/dist/public-merge-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-merge-evidence.js","sourceRoot":"","sources":["../src/public-merge-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,8EAA8E;AAC9E,yEAAyE;AACzE,uFAAuF;AACvF,EAAE;AACF,4FAA4F;AAC5F,4FAA4F;AAC5F,0FAA0F;AAC1F,wFAAwF;AACxF,6FAA6F;AAC7F,+FAA+F;AAC/F,iGAAiG;AACjG,EAAE;AACF,kCAAkC;AAClC,EAAE;AACF,+FAA+F;AAC/F,8FAA8F;AAC9F,6FAA6F;AAC7F,gGAAgG;AAChG,iFAAiF;AACjF,8FAA8F;AAC9F,4FAA4F;AAC5F,6FAA6F;AAC7F,+FAA+F;AAC/F,8FAA8F;AAC9F,6FAA6F;AAC7F,6FAA6F;AAC7F,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,wEAAwE;IACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,oFAAoF;IACpF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB;;;;;OAKG;IACH,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B;;;;OAIG;IACH,WAAW,EAAE,iBAAiB;IAC9B,wFAAwF;IACxF,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,wEAAwE;IACxE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,oDAAoD;IACpD,QAAQ,EAAE,wBAAwB;IAClC,mFAAmF;IACnF,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC5C,iEAAiE;IACjE,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,kCAAkC;IAClC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,yEAAyE;IACzE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,uFAAuF;IACvF,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACvC,yEAAyE;IACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,0EAA0E;IAC1E,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,iEAAiE;IACjE,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACjC,CAAC,CAAA;AAGF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;CACzC,CAAC,CAAA"}

package/dist/public-spend.d.ts

@@ -0,0 +1,204 @@
+import * as v from 'valibot';
+/**
+ * The time window a breakdown aggregates over, measured back from `generatedAt` and snapped
+ * DOWN to a bucket edge (see {@link publicSpendSchema}'s `since`).
+ *
+ * Same members as the internal `reportWindowSchema` in `reports.ts`, and `public-spend.test.ts`
+ * asserts the two stay in step, but this is the FROZEN copy: adding a
+ * window internally does not publish it, and removing one internally has to arrive here as a
+ * deliberate `/api/v1` decision rather than as a member that quietly stopped being accepted.
+ */
+export declare const publicSpendWindowSchema: v.PicklistSchema<["24h", "7d", "30d", "90d"], undefined>;
+export type PublicSpendWindow = v.InferOutput<typeof publicSpendWindowSchema>;
+/**
+ * Which store answered a breakdown. Frozen here for the same reason the window is: this is a
+ * value an external consumer branches on, so the internal spelling of it is not free to move.
+ */
+export declare const publicSpendSourceSchema: v.PicklistSchema<["ledger", "daily-rollup"], undefined>;
+export type PublicSpendSource = v.InferOutput<typeof publicSpendSourceSchema>;
+/**
+ * Hard ceiling on the slices one response may carry.
+ *
+ * A real bound rather than a suggestion: two of the published dimensions grow with ACTIVITY
+ * rather than with a catalog (`run` is one row per pipeline execution, `ticket` one per issue
+ * a run touched), so an unbounded `90d` breakdown on a busy board is a response nobody sized.
+ * The rows are heaviest first, so the cap is a prefix by cost: the slice a cost question is
+ * about, with {@link publicSpendSchema}'s `truncated` saying when there was a tail.
+ */
+export declare const PUBLIC_SPEND_MAX_ROWS = 500;
+/**
+ * What a public spend breakdown groups by.
+ *
+ * The two axes this surface exists for are `repo` and `ticket`: what an organisation budgets
+ * against, and the pair no other public read can produce. `run` is the finest of the three
+ * (one pipeline execution, end to end), and the rest are the same slices the usage read
+ * already implies, offered here because they come from one grouped query rather than four.
+ */
+export declare const publicSpendDimensionSchema: v.PicklistSchema<["model", "agentKind", "service", "repo", "taskType", "ticket", "run"], undefined>;
+export type PublicSpendDimension = v.InferOutput<typeof publicSpendDimensionSchema>;
+/**
+ * The spend dimensions this surface deliberately does NOT offer, each with the reason.
+ *
+ * Stated rather than left as an absence, and paired with a test asserting every internal
+ * `reportSpendDimensionSchema` member is EXACTLY ONCE across the two lists: a dimension
+ * added internally then has to be either published or explained, instead of silently missing
+ * from the surface that four SDKs are generated against.
+ */
+export declare const PUBLIC_SPEND_DIMENSIONS_OMITTED: Record<string, string>;
+/**
+ * One slice of a spend breakdown.
+ *
+ * `key` is the raw dimension value and the row's identity; the EMPTY string is a real bucket
+ * meaning UNATTRIBUTED (a call whose run, service, repository or ticket could not be resolved),
+ * never a dropped row. Dropping it would under-report the window while the breakdown still
+ * looked complete, which is the one thing `totals` and `truncated` exist to prevent.
+ *
+ * The two costs are separate on purpose and must never be summed: only `meteredCost` is money.
+ * `subscriptionCost` is what the same tokens WOULD have cost on the metered API, which is what
+ * a flat-rate harness plan (Claude Code, Codex, …) spends nothing per token on, and it is why
+ * the spend budget excludes it.
+ */
+export declare const publicSpendRowSchema: v.ObjectSchema<{
+    readonly key: v.StringSchema<undefined>;
+    /**
+     * A display name for `key` where the store can resolve one (a service's frame title, a
+     * repository's `owner/name`, the title of the block a run targets); null where the key is
+     * self-describing (a model id, an agent kind, a task type) or where nothing could be joined
+     * (a repository this board holds no projection row for keeps its money and loses its name).
+     */
+    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly inputTokens: v.NumberSchema<undefined>;
+    readonly outputTokens: v.NumberSchema<undefined>;
+    /** Recorded LLM calls in this slice, both billing kinds. */
+    readonly calls: v.NumberSchema<undefined>;
+    /** Real per-token cost, in the response's `currency`. */
+    readonly meteredCost: v.NumberSchema<undefined>;
+    /** Illustrative equivalent-API cost of flat-rate subscription usage. Never real spend. */
+    readonly subscriptionCost: v.NumberSchema<undefined>;
+}, undefined>;
+export type PublicSpendRow = v.InferOutput<typeof publicSpendRowSchema>;
+/**
+ * Window-wide totals, over EVERY slice the window holds rather than only the ones `rows`
+ * carries. So a `truncated` breakdown still reports what the board actually spent, the same
+ * rule the run LLM export states about its own rollups, and a caller reading the top twenty
+ * repositories can still say what share of the bill they are. On an untruncated response the
+ * rows sum to exactly this.
+ */
+export declare const publicSpendTotalsSchema: v.ObjectSchema<{
+    readonly inputTokens: v.NumberSchema<undefined>;
+    readonly outputTokens: v.NumberSchema<undefined>;
+    readonly calls: v.NumberSchema<undefined>;
+    readonly meteredCost: v.NumberSchema<undefined>;
+    readonly subscriptionCost: v.NumberSchema<undefined>;
+}, undefined>;
+export type PublicSpendTotals = v.InferOutput<typeof publicSpendTotalsSchema>;
+/** Query of `GET /api/v1/usage/spend`. */
+export declare const publicSpendQuerySchema: v.ObjectSchema<{
+    readonly dimension: v.PicklistSchema<["model", "agentKind", "service", "repo", "taskType", "ticket", "run"], undefined>;
+    /** Defaults to `7d`, the widest window served live off the ledger. */
+    readonly window: v.OptionalSchema<v.PicklistSchema<["24h", "7d", "30d", "90d"], undefined>, undefined>;
+    /**
+     * How many SLICES to return, 1..{@link PUBLIC_SPEND_MAX_ROWS} (default 100), heaviest first.
+     * `totals` is unaffected: it aggregates the whole window whatever this says, so a capped
+     * response still reports what the board spent.
+     *
+     * Digit-checked before the numeric coercion, like every other query number on this API:
+     * bare `Number()` also accepts `1e9`, `0x64` and `' '`, which read as plausible values
+     * rather than as the 400 a malformed request has earned.
+     */
+    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "Must be a whole number">, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 500, undefined>]>, undefined>;
+}, undefined>;
+export type PublicSpendQuery = v.InferOutput<typeof publicSpendQuerySchema>;
+/**
+ * The workspace's spend over a window, sliced one way.
+ *
+ * ONE dimension per request rather than every dimension at once (the shape the internal
+ * Reports panel reads): a panel renders all of them together, where a caller asks a question
+ * and each dimension is its own grouped query. Serving seven would make the common request
+ * seven times the work and the response mostly rows nobody asked for.
+ */
+export declare const publicSpendSchema: v.ObjectSchema<{
+    /** Echoes the requested dimension, so a stored response says what it grouped by. */
+    readonly dimension: v.PicklistSchema<["model", "agentKind", "service", "repo", "taskType", "ticket", "run"], undefined>;
+    readonly window: v.PicklistSchema<["24h", "7d", "30d", "90d"], undefined>;
+    /** When the breakdown was computed (epoch ms). */
+    readonly generatedAt: v.NumberSchema<undefined>;
+    /**
+     * Start of the window (epoch ms): `generatedAt - window`, snapped DOWN to a bucket edge, and
+     * the real span every number here was computed over. A window therefore covers up to one
+     * bucket more than its nominal length, which is why this is reported rather than left to be
+     * re-derived from `window`.
+     */
+    readonly since: v.NumberSchema<undefined>;
+    /** ISO 4217 currency both costs are denominated in (the deployment's base currency). */
+    readonly currency: v.StringSchema<undefined>;
+    /**
+     * Which store answered: a live scan of the metered ledger (`ledger`, the `24h`/`7d` windows)
+     * or the durable daily cost-attribution rollup (`daily-rollup`, `30d`/`90d`).
+     *
+     * They differ in more than freshness. The ledger resolves a repository or a ticket through
+     * the LIVE links, so it re-attributes history whenever a service is re-pointed or an issue
+     * re-imported, and it forgets whatever retention has pruned. The rollup froze that
+     * attribution while the money was being spent and is never pruned, at the cost of being only
+     * as current as the last sweep. A reader comparing two windows has to know which is talking.
+     */
+    readonly source: v.PicklistSchema<["ledger", "daily-rollup"], undefined>;
+    /**
+     * On a `daily-rollup` window: the newest UTC day (epoch ms, midnight) the rollup sweep has
+     * covered, or null when no pass has ever completed. Always null on a `ledger` window, where
+     * there is no rollup in the path to be behind.
+     *
+     * Null is why the field exists: a rollup that has never run and a board that spent nothing
+     * produce the same empty breakdown, and they call for opposite reactions. Read it before
+     * reporting a quiet quarter.
+     */
+    readonly rolledUpThrough: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    readonly totals: v.ObjectSchema<{
+        readonly inputTokens: v.NumberSchema<undefined>;
+        readonly outputTokens: v.NumberSchema<undefined>;
+        readonly calls: v.NumberSchema<undefined>;
+        readonly meteredCost: v.NumberSchema<undefined>;
+        readonly subscriptionCost: v.NumberSchema<undefined>;
+    }, undefined>;
+    /**
+     * True when the window holds more slices than `limit`, so `rows` is the heaviest prefix of
+     * them rather than all of them. STATED rather than left to be inferred from
+     * `rows.length === limit`, which cannot tell a board with exactly `limit` slices from one
+     * with a tail, and which is the reading that turns a capped list into a complete one.
+     *
+     * `totals` above is unaffected, so the share the returned rows account for is computable:
+     * what a truncated breakdown loses is the identity of the long tail, never its money.
+     */
+    readonly truncated: v.BooleanSchema<undefined>;
+    /**
+     * The slices, heaviest by metered cost first, capped at `limit`.
+     *
+     * Capped rather than served whole because two of the published dimensions grow with
+     * ACTIVITY rather than with a catalog: `run` is one row per pipeline execution and `ticket`
+     * one per issue a run touched, so a busy board over `90d` is thousands of rows on a
+     * response nobody sized. (`model`, `agentKind`, `service`, `repo` and `taskType` all key on
+     * a catalog and stay small on their own.) The order is what makes the cap honest: a cost
+     * question is about the heavy end, `truncated` says when there was a tail, and `totals`
+     * still covers all of it.
+     */
+    readonly rows: v.ArraySchema<v.ObjectSchema<{
+        readonly key: v.StringSchema<undefined>;
+        /**
+         * A display name for `key` where the store can resolve one (a service's frame title, a
+         * repository's `owner/name`, the title of the block a run targets); null where the key is
+         * self-describing (a model id, an agent kind, a task type) or where nothing could be joined
+         * (a repository this board holds no projection row for keeps its money and loses its name).
+         */
+        readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly inputTokens: v.NumberSchema<undefined>;
+        readonly outputTokens: v.NumberSchema<undefined>;
+        /** Recorded LLM calls in this slice, both billing kinds. */
+        readonly calls: v.NumberSchema<undefined>;
+        /** Real per-token cost, in the response's `currency`. */
+        readonly meteredCost: v.NumberSchema<undefined>;
+        /** Illustrative equivalent-API cost of flat-rate subscription usage. Never real spend. */
+        readonly subscriptionCost: v.NumberSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type PublicSpend = v.InferOutput<typeof publicSpendSchema>;
+//# sourceMappingURL=public-spend.d.ts.map

package/dist/public-spend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-spend.d.ts","sourceRoot":"","sources":["../src/public-spend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAwB5B;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,0DAA0C,CAAA;AAC9E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;GAGG;AACH,eAAO,MAAM,uBAAuB,yDAAyC,CAAA;AAC7E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,qGAQrC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKlE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB;;IAE/B;;;;;OAKG;;;;IAIH,4DAA4D;;IAE5D,yDAAyD;;IAEzD,0FAA0F;;aAE1F,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;;aAMlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,0CAA0C;AAC1C,eAAO,MAAM,sBAAsB;;IAEjC,sEAAsE;;IAEtE;;;;;;;;OAQG;;aAYH,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;IAC5B,oFAAoF;;;IAGpF,kDAAkD;;IAElD;;;;;OAKG;;IAEH,wFAAwF;;IAExF;;;;;;;;;OASG;;IAEH;;;;;;;;OAQG;;;;;;;;;IAGH;;;;;;;;OAQG;;IAEH;;;;;;;;;;OAUG;;;QA/HH;;;;;WAKG;;;;QAIH,4DAA4D;;QAE5D,yDAAyD;;QAEzD,0FAA0F;;;aAoH1F,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA"}