@cat-factory/contracts 0.165.0 → 0.167.0

package/dist/merge.js

@@ -1,5 +1,6 @@
 import * as v from 'valibot';
 import { stepGatingSchema } from './consensus.js';
+import { changeClassSchema, RULEABLE_CHANGE_CLASSES } from './mergeTrackRecord.js';
 // ---------------------------------------------------------------------------
 // Merge-policy wire contracts. After a pipeline's implementation work is done
 // and CI is green, a `merger` agent assesses the pull request along three axes —
@@ -32,6 +33,34 @@ export const REQUIREMENT_CONCERN_RANK = {
     medium: 2,
     high: 3,
 };
+// ---------------------------------------------------------------------------
+// Per-CLASS auto-merge rules. The score ceilings below apply uniformly to every
+// change, which leaves a workspace unable to express "auto-merge dependency bumps
+// and docs, always review schema changes". A preset therefore also carries an
+// optional rule per {@link ChangeClass}, resolved against the run's deterministic,
+// path-derived classification. See `docs/initiatives/merge-track-record.md`.
+// ---------------------------------------------------------------------------
+/**
+ * What a preset does with a pull request of a given change class:
+ *
+ *  - `thresholds` — compare the merger's scores against this preset's ceilings (the default,
+ *    and what an ABSENT entry means, so `{}` behaves exactly like no rules at all).
+ *  - `always`     — auto-merge regardless of the scores.
+ *  - `never`      — always route to a human, regardless of the scores.
+ */
+export const mergeClassRuleSchema = v.picklist(['thresholds', 'always', 'never']);
+/**
+ * A preset's per-class rules: a PARTIAL map from change class to its rule. An absent class
+ * means `thresholds`, so an empty object is the "behave exactly as before" identity.
+ *
+ * `unknown` is deliberately NOT a member: an unclassifiable diff (no VCS client wired, a
+ * transient provider outage) must fall back to the score thresholds rather than silently
+ * adopt a widened policy. See `RULEABLE_CHANGE_CLASSES`.
+ */
+export const mergeClassRulesSchema = v.partial(
+// STRICT: an unknown key (notably `unknown`, which no rule may ever match) is a 400 rather than
+// being silently stripped. A caller who thinks they authored a rule must not be told it worked.
+v.strictObject(Object.fromEntries(RULEABLE_CHANGE_CLASSES.map((c) => [c, mergeClassRuleSchema]))));
 export const mergeAssessmentSchema = v.object({
     /** How intricate the change is (size, coupling, subtlety). */
     complexity: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
@@ -118,6 +147,12 @@ export const riskPolicySchema = v.object({
      * built-in presets.
      */
     forkDecision: v.optional(v.nullable(stepGatingSchema)),
+    /**
+     * Per-change-class auto-merge rules ({@link mergeClassRulesSchema}). An absent class — and
+     * therefore an empty object — means "use the score ceilings above", so `{}` is the identity.
+     * A rule NEVER overrides `autoMergeEnabled: false`: that master switch wins first.
+     */
+    classRules: mergeClassRulesSchema,
     /** The workspace's fallback preset, used by tasks that pick none. Exactly one is true. */
     isDefault: v.boolean(),
     /**
@@ -154,6 +189,8 @@ export const createRiskPolicySchema = v.object({
     autoMergeEnabled: v.optional(v.boolean(), true),
     /** Estimate gating for the implementation-fork decision phase; absent ⇒ off in `auto` mode. */
     forkDecision: v.optional(v.nullable(stepGatingSchema)),
+    /** Per-change-class auto-merge rules; absent ⇒ every class uses the score ceilings. */
+    classRules: v.optional(mergeClassRulesSchema, {}),
     /** Make this the workspace default (demotes the previous default). */
     isDefault: v.optional(v.boolean(), false),
 });
@@ -172,6 +209,8 @@ export const updateRiskPolicySchema = v.object({
     humanReviewGraceMinutes: v.optional(graceMinutesSchema),
     autoMergeEnabled: v.optional(v.boolean()),
     forkDecision: v.optional(v.nullable(stepGatingSchema)),
+    /** Replaces the whole rule map (not merged), so clearing a class is a plain omission. */
+    classRules: v.optional(mergeClassRulesSchema),
     isDefault: v.optional(v.boolean()),
 });
 /** Parse-or-throw an assessment payload an agent returned (the engine validates it). */
@@ -195,6 +234,13 @@ export const mergeDecisionThresholdsSchema = v.object({
     maxRisk: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
     maxImpact: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
     autoMergeEnabled: v.boolean(),
+    /**
+     * The rule the preset carried for the run's resolved change class, when one applied —
+     * so the decision banner can say "auto-merged because this preset always auto-merges
+     * dependency bumps" rather than implying the scores did it. Absent when the class was
+     * `unknown` (rules never match it) or the preset left the class on `thresholds`.
+     */
+    classRule: v.optional(mergeClassRuleSchema),
 });
 export const mergeDecisionSchema = v.object({
     /** What the engine did: merged the PR for real, or left it open for a human. */
@@ -212,6 +258,11 @@ export const mergeDecisionSchema = v.object({
      *  - `merge_partial`: review; a MULTI-REPO task auto-merged some of its PRs but an
      *    intermediate merge failed (cross-repo merges are non-atomic), so the block is left
      *    blocked with a notification enumerating the merged vs unmerged repos.
+     *  - `class_auto_merge`: auto-merged because the preset's rule for the run's change class
+     *    is `always` — the scores (and the rationale-credibility backstop) were bypassed by an
+     *    explicit operator policy keyed on the DETERMINISTIC backend classification.
+     *  - `class_requires_review`: review; the preset's rule for the change class is `never`,
+     *    regardless of how low the scores were.
      */
     reason: v.picklist([
         'within_thresholds',
@@ -221,11 +272,20 @@ export const mergeDecisionSchema = v.object({
         'no_assessment',
         'merge_failed',
         'merge_partial',
+        'class_auto_merge',
+        'class_requires_review',
     ]),
     /** The merger's assessment (absent only when it produced no parseable one). */
     assessment: v.optional(mergeAssessmentSchema),
     thresholds: mergeDecisionThresholdsSchema,
     /** The axes that exceeded their ceiling (empty unless `reason` is `exceeded_thresholds`). */
     exceededAxes: v.array(mergeAxisSchema),
+    /**
+     * The run's deterministic change class, when classification resolved one. Recorded on the
+     * step so the SPA can show WHAT KIND of change the decision was made about (and, with the
+     * class's rollup, how that class has historically fared). Absent ⇒ classification did not
+     * run (no VCS client wired) — the same state `unknown` denotes on a track record.
+     */
+    changeClass: v.optional(changeClassSchema),
 });
 //# sourceMappingURL=merge.js.map

package/dist/merge.js.map

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

package/dist/mergeTrackRecord.d.ts

@@ -0,0 +1,183 @@
+import * as v from 'valibot';
+/**
+ * What kind of change a run's pull request made, derived DETERMINISTICALLY on the backend
+ * from the PR's changed-file list (never from an agent's opinion). A small closed set so it
+ * can key a per-class merge rule, a rollup `GROUP BY`, and an i18n label.
+ *
+ *  - `docs`       — documentation + user-facing copy (Markdown, `docs/`, i18n catalogs).
+ *  - `test`       — test/spec/fixture files only.
+ *  - `dependency` — dependency manifests + lockfiles (a bump).
+ *  - `config`     — CI workflows, tooling config, container/IaC manifests.
+ *  - `source`     — application/library source code (the catch-all for real code).
+ *  - `schema`     — database migrations + schema definitions (the riskiest: irreversible).
+ *  - `unknown`    — no changed-file list was available (no VCS client wired, or an empty diff).
+ *
+ * A MIXED diff resolves to the HIGHEST-RANKED class present (see `CHANGE_CLASS_RANK` /
+ * `classifyChangedFiles` in `@cat-factory/kernel`), so a per-class rule can only ever fire on a
+ * diff containing nothing riskier than that class.
+ */
+export declare const changeClassSchema: v.PicklistSchema<["docs", "test", "dependency", "config", "source", "schema", "unknown"], undefined>;
+export type ChangeClass = v.InferOutput<typeof changeClassSchema>;
+/**
+ * Every {@link ChangeClass} in rank order (lowest → highest risk), `unknown` last. The
+ * ordering the preset editor renders and the rollup table iterates, so a new class is added
+ * in ONE place. `unknown` is deliberately last: it is a fallback outcome, not a policy target.
+ */
+export declare const CHANGE_CLASSES: readonly ["docs", "test", "dependency", "config", "source", "schema", "unknown"];
+/**
+ * The classes a per-class merge RULE may be authored for — every class except `unknown`.
+ * `unknown` must stay inert: an unclassifiable diff (a transient VCS outage) has to fall
+ * back to the score thresholds rather than silently adopt a widened policy.
+ */
+export declare const RULEABLE_CHANGE_CLASSES: readonly ["docs", "test", "dependency", "config", "source", "schema"];
+export type RuleableChangeClass = (typeof RULEABLE_CHANGE_CLASSES)[number];
+/**
+ * How much review effort a human actually spent on a pull request before merging it — the
+ * ground truth the auto-merge score thresholds are trying to approximate.
+ *
+ *  - `none`  — merged with zero blocking comments.
+ *  - `minor` — small comments / a nit pass, no substantive rework.
+ *  - `major` — real rework was required.
+ *
+ * ALWAYS optional: an untagged merge records a null tag and every consumer treats null as
+ * "not tagged", never as `none`.
+ */
+export declare const reviewEffortSchema: v.PicklistSchema<["none", "minor", "major"], undefined>;
+export type ReviewEffort = v.InferOutput<typeof reviewEffortSchema>;
+/** Every {@link ReviewEffort} in ascending order — the chip order the SPA renders. */
+export declare const REVIEW_EFFORTS: readonly ["none", "minor", "major"];
+/**
+ * What ultimately happened to the pull request a track record covers.
+ *
+ *  - `pending_review`   — the merger step routed it to a human; not yet resolved. Recorded at
+ *    the decision so the class + scores are captured even if the human never comes back.
+ *  - `auto_merged`      — the engine merged it on the policy (thresholds or a class rule).
+ *  - `human_merged`     — a human confirmed the merge THROUGH cat-factory (a notification act
+ *    or the inspector's merge control).
+ *  - `external_merged`  — a human merged it directly on the VCS provider, bypassing
+ *    cat-factory; detected from the webhook ingest.
+ *  - `rejected`         — a human dismissed the review card instead of merging.
+ */
+export declare const mergeTrackDecisionSchema: v.PicklistSchema<["pending_review", "auto_merged", "human_merged", "external_merged", "rejected"], undefined>;
+export type MergeTrackDecision = v.InferOutput<typeof mergeTrackDecisionSchema>;
+/**
+ * The decisions that represent a pull request that actually LANDED. The auto-merge share a
+ * rollup reports is `autoMerged / (every landed decision)` — a `pending_review` row is not in
+ * the denominator (nothing was decided yet) and neither is a `rejected` one.
+ */
+export declare const MERGED_TRACK_DECISIONS: readonly ["auto_merged", "human_merged", "external_merged"];
+/**
+ * One persisted merge decision: what kind of change it was, what the merger scored it, what
+ * the engine/human did, and how much review effort it needed. Written best-effort off the
+ * merge path — a failure to write one NEVER blocks or fails a merge.
+ *
+ * Provider-neutral by construction: the repo identity is `repoId` + `provider` (the kernel
+ * `VcsRepoRef`/`VcsProvider` vocabulary), never a GitHub-shaped `githubId`/`installationId`.
+ */
+export declare const mergeTrackRecordSchema: v.ObjectSchema<{
+    /**
+     * Deterministic id, derived from the run: `mtr_<executionId>`. Deterministic so a durable-driver
+     * replay of a settled merger step collides with the row it already wrote (first write wins)
+     * instead of duplicating it.
+     */
+    readonly id: v.StringSchema<undefined>;
+    /** The task/block whose pull request this covers. */
+    readonly blockId: v.StringSchema<undefined>;
+    /**
+     * The run that produced the PR. Nullable at the wire/storage level because the column is, but
+     * every record written today is born at a merge DECISION POINT inside a run, so it is set. An
+     * external merge does not MINT a record — it settles the one the run already wrote (which is
+     * also why attribution keys on `(repoId, prNumber)`); a PR cat-factory never opened has no
+     * record and is correctly invisible to the track record.
+     */
+    readonly executionId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** The deterministic, path-derived change class (see {@link changeClassSchema}). */
+    readonly changeClass: v.PicklistSchema<["docs", "test", "dependency", "config", "source", "schema", "unknown"], undefined>;
+    /** How many files the PR changed, when the changed-file list was readable. */
+    readonly changedFileCount: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** The merger's complexity score at the decision, when it produced a parseable assessment. */
+    readonly complexity: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+    /** The merger's risk score at the decision, when one was produced. */
+    readonly risk: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+    /** The merger's impact score at the decision, when one was produced. */
+    readonly impact: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+    /** The merge preset the decision was made against, for reading a record back in context. */
+    readonly riskPolicyId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly riskPolicyName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** What happened (see {@link mergeTrackDecisionSchema}). */
+    readonly decision: v.PicklistSchema<["pending_review", "auto_merged", "human_merged", "external_merged", "rejected"], undefined>;
+    /** The human's effort tag — null until somebody tags it. Tagging is never mandatory. */
+    readonly reviewEffort: v.NullableSchema<v.PicklistSchema<["none", "minor", "major"], undefined>, undefined>;
+    /** The PR number within its repo, when known. */
+    readonly prNumber: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** The PR's web URL, for the card's deep link. */
+    readonly prUrl: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Provider-neutral repo id the PR belongs to (`VcsRepoRef.repoId`). */
+    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 reached a terminal value; 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 MergeTrackRecord = v.InferOutput<typeof mergeTrackRecordSchema>;
+/** The per-effort-level counts within a class's rollup. `untagged` counts null tags. */
+export declare const reviewEffortDistributionSchema: v.ObjectSchema<{
+    readonly none: v.NumberSchema<undefined>;
+    readonly minor: v.NumberSchema<undefined>;
+    readonly major: v.NumberSchema<undefined>;
+    readonly untagged: v.NumberSchema<undefined>;
+}, undefined>;
+export type ReviewEffortDistribution = v.InferOutput<typeof reviewEffortDistributionSchema>;
+/** One change class's accumulated track record — the number that justifies widening a rule. */
+export declare const mergeClassRollupSchema: v.ObjectSchema<{
+    readonly changeClass: v.PicklistSchema<["docs", "test", "dependency", "config", "source", "schema", "unknown"], undefined>;
+    /** Every record in the class, including still-`pending_review` ones. */
+    readonly total: v.NumberSchema<undefined>;
+    /** Records whose PR landed (auto + human + external) — the auto-merge-share denominator. */
+    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>;
+export type MergeClassRollup = v.InferOutput<typeof mergeClassRollupSchema>;
+/**
+ * The auto-merge share of a class's LANDED records, 0..1, or null when nothing has landed
+ * yet (so the UI shows "no data" rather than a misleading 0%). Shared by the preset editor
+ * and any backend consumer so the two can never disagree.
+ */
+export declare function autoMergeShare(rollup: MergeClassRollup): number | null;
+/**
+ * The share of a class's TAGGED records that needed no blocking comments, 0..1, or null when
+ * nothing in the class has been tagged. This — not the auto-merge share — is the evidence that
+ * justifies flipping a class to `always`: it says humans found nothing to say.
+ */
+export declare function frictionlessShare(rollup: MergeClassRollup): number | null;
+/** An empty rollup for a class with no records yet (the UI renders every class, always). */
+export declare function emptyMergeClassRollup(changeClass: ChangeClass): MergeClassRollup;
+/**
+ * Body of `POST /blocks/:blockId/merge` — the inspector's merge control. Every field is optional,
+ * so `{}` is the historical no-body merge; `reviewEffort` records the effort tag onto the block's
+ * merge track record in the same request (the counterpart of the notification card's `act` body).
+ */
+export declare const mergeBlockSchema: v.ObjectSchema<{
+    readonly reviewEffort: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["none", "minor", "major"], undefined>, undefined>, undefined>;
+}, undefined>;
+export type MergeBlockInput = v.InferOutput<typeof mergeBlockSchema>;
+/** Tag a record with the review effort a human actually spent (`null` clears the tag). */
+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>;
+//# sourceMappingURL=mergeTrackRecord.d.ts.map

package/dist/mergeTrackRecord.d.ts.map

@@ -0,0 +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"}

package/dist/mergeTrackRecord.js

@@ -0,0 +1,251 @@
+import * as v from 'valibot';
+import { vcsProviderSchema } from './routes/auth.js';
+// ---------------------------------------------------------------------------
+// Merge TRACK RECORD wire contracts — the accumulated human evidence behind the
+// auto-merge policy.
+//
+// The merge decision itself runs on the `merger` agent's self-assessment (see
+// `merge.ts`): scores vs the task's preset ceilings. This module models what the
+// decision LEAVES BEHIND so the policy can eventually stand on evidence instead:
+//
+//   - WHAT KIND of change it was (a deterministic, path-derived {@link ChangeClass}),
+//   - the merger's scores at the moment of the decision,
+//   - how much review effort a human actually spent ({@link ReviewEffort}, nullable
+//     until somebody tags it — tagging is never mandatory),
+//   - and what happened ({@link MergeTrackDecision}).
+//
+// Per-class rollups of those records are what justify WIDENING a policy, which is
+// why merge presets carry per-class rules ({@link MergeClassRules} in `merge.ts`).
+//
+// Full design — the class precedence rules, the external-merge detection, and the
+// preset reshape — is in `docs/initiatives/merge-track-record.md`.
+// ---------------------------------------------------------------------------
+/**
+ * What kind of change a run's pull request made, derived DETERMINISTICALLY on the backend
+ * from the PR's changed-file list (never from an agent's opinion). A small closed set so it
+ * can key a per-class merge rule, a rollup `GROUP BY`, and an i18n label.
+ *
+ *  - `docs`       — documentation + user-facing copy (Markdown, `docs/`, i18n catalogs).
+ *  - `test`       — test/spec/fixture files only.
+ *  - `dependency` — dependency manifests + lockfiles (a bump).
+ *  - `config`     — CI workflows, tooling config, container/IaC manifests.
+ *  - `source`     — application/library source code (the catch-all for real code).
+ *  - `schema`     — database migrations + schema definitions (the riskiest: irreversible).
+ *  - `unknown`    — no changed-file list was available (no VCS client wired, or an empty diff).
+ *
+ * A MIXED diff resolves to the HIGHEST-RANKED class present (see `CHANGE_CLASS_RANK` /
+ * `classifyChangedFiles` in `@cat-factory/kernel`), so a per-class rule can only ever fire on a
+ * diff containing nothing riskier than that class.
+ */
+export const changeClassSchema = v.picklist([
+    'docs',
+    'test',
+    'dependency',
+    'config',
+    'source',
+    'schema',
+    'unknown',
+]);
+/**
+ * Every {@link ChangeClass} in rank order (lowest → highest risk), `unknown` last. The
+ * ordering the preset editor renders and the rollup table iterates, so a new class is added
+ * in ONE place. `unknown` is deliberately last: it is a fallback outcome, not a policy target.
+ */
+export const CHANGE_CLASSES = [
+    'docs',
+    'test',
+    'dependency',
+    'config',
+    'source',
+    'schema',
+    'unknown',
+];
+/**
+ * The classes a per-class merge RULE may be authored for — every class except `unknown`.
+ * `unknown` must stay inert: an unclassifiable diff (a transient VCS outage) has to fall
+ * back to the score thresholds rather than silently adopt a widened policy.
+ */
+export const RULEABLE_CHANGE_CLASSES = [
+    'docs',
+    'test',
+    'dependency',
+    'config',
+    'source',
+    'schema',
+];
+/**
+ * How much review effort a human actually spent on a pull request before merging it — the
+ * ground truth the auto-merge score thresholds are trying to approximate.
+ *
+ *  - `none`  — merged with zero blocking comments.
+ *  - `minor` — small comments / a nit pass, no substantive rework.
+ *  - `major` — real rework was required.
+ *
+ * ALWAYS optional: an untagged merge records a null tag and every consumer treats null as
+ * "not tagged", never as `none`.
+ */
+export const reviewEffortSchema = v.picklist(['none', 'minor', 'major']);
+/** Every {@link ReviewEffort} in ascending order — the chip order the SPA renders. */
+export const REVIEW_EFFORTS = ['none', 'minor', 'major'];
+/**
+ * What ultimately happened to the pull request a track record covers.
+ *
+ *  - `pending_review`   — the merger step routed it to a human; not yet resolved. Recorded at
+ *    the decision so the class + scores are captured even if the human never comes back.
+ *  - `auto_merged`      — the engine merged it on the policy (thresholds or a class rule).
+ *  - `human_merged`     — a human confirmed the merge THROUGH cat-factory (a notification act
+ *    or the inspector's merge control).
+ *  - `external_merged`  — a human merged it directly on the VCS provider, bypassing
+ *    cat-factory; detected from the webhook ingest.
+ *  - `rejected`         — a human dismissed the review card instead of merging.
+ */
+export const mergeTrackDecisionSchema = v.picklist([
+    'pending_review',
+    'auto_merged',
+    'human_merged',
+    'external_merged',
+    'rejected',
+]);
+/**
+ * The decisions that represent a pull request that actually LANDED. The auto-merge share a
+ * rollup reports is `autoMerged / (every landed decision)` — a `pending_review` row is not in
+ * the denominator (nothing was decided yet) and neither is a `rejected` one.
+ */
+export const MERGED_TRACK_DECISIONS = [
+    'auto_merged',
+    'human_merged',
+    'external_merged',
+];
+const scoreSchema = v.pipe(v.number(), v.minValue(0), v.maxValue(1));
+/**
+ * One persisted merge decision: what kind of change it was, what the merger scored it, what
+ * the engine/human did, and how much review effort it needed. Written best-effort off the
+ * merge path — a failure to write one NEVER blocks or fails a merge.
+ *
+ * Provider-neutral by construction: the repo identity is `repoId` + `provider` (the kernel
+ * `VcsRepoRef`/`VcsProvider` vocabulary), never a GitHub-shaped `githubId`/`installationId`.
+ */
+export const mergeTrackRecordSchema = v.object({
+    /**
+     * Deterministic id, derived from the run: `mtr_<executionId>`. Deterministic so a durable-driver
+     * replay of a settled merger step collides with the row it already wrote (first write wins)
+     * instead of duplicating it.
+     */
+    id: v.string(),
+    /** The task/block whose pull request this covers. */
+    blockId: v.string(),
+    /**
+     * The run that produced the PR. Nullable at the wire/storage level because the column is, but
+     * every record written today is born at a merge DECISION POINT inside a run, so it is set. An
+     * external merge does not MINT a record — it settles the one the run already wrote (which is
+     * also why attribution keys on `(repoId, prNumber)`); a PR cat-factory never opened has no
+     * record and is correctly invisible to the track record.
+     */
+    executionId: v.nullable(v.string()),
+    /** The deterministic, path-derived change class (see {@link changeClassSchema}). */
+    changeClass: changeClassSchema,
+    /** How many files the PR changed, when the changed-file list was readable. */
+    changedFileCount: v.nullable(v.number()),
+    /** The merger's complexity score at the decision, when it produced a parseable assessment. */
+    complexity: v.nullable(scoreSchema),
+    /** The merger's risk score at the decision, when one was produced. */
+    risk: v.nullable(scoreSchema),
+    /** The merger's impact score at the decision, when one was produced. */
+    impact: v.nullable(scoreSchema),
+    /** The merge preset the decision was made against, for reading a record back in context. */
+    riskPolicyId: v.nullable(v.string()),
+    riskPolicyName: v.nullable(v.string()),
+    /** What happened (see {@link mergeTrackDecisionSchema}). */
+    decision: mergeTrackDecisionSchema,
+    /** The human's effort tag — null until somebody tags it. Tagging is never mandatory. */
+    reviewEffort: v.nullable(reviewEffortSchema),
+    /** The PR number within its repo, when known. */
+    prNumber: v.nullable(v.number()),
+    /** The PR's web URL, for the card's deep link. */
+    prUrl: v.nullable(v.string()),
+    /** Provider-neutral repo id the PR belongs to (`VcsRepoRef.repoId`). */
+    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 reached a terminal value; null while `pending_review`. */
+    resolvedAt: v.nullable(v.number()),
+    /** Epoch ms the effort tag was recorded; null while untagged. */
+    taggedAt: v.nullable(v.number()),
+});
+// ---------------------------------------------------------------------------
+// Per-class rollups — SQL aggregates (COUNT / GROUP BY / conditional SUM), never
+// rows loaded and reduced in JS. ONE query per workspace returns every class, so
+// the preset editor's stats load in a single round-trip.
+// ---------------------------------------------------------------------------
+/** The per-effort-level counts within a class's rollup. `untagged` counts null tags. */
+export const reviewEffortDistributionSchema = v.object({
+    none: v.number(),
+    minor: v.number(),
+    major: v.number(),
+    untagged: v.number(),
+});
+/** One change class's accumulated track record — the number that justifies widening a rule. */
+export const mergeClassRollupSchema = v.object({
+    changeClass: changeClassSchema,
+    /** Every record in the class, including still-`pending_review` ones. */
+    total: v.number(),
+    /** Records whose PR landed (auto + human + external) — the auto-merge-share denominator. */
+    merged: v.number(),
+    autoMerged: v.number(),
+    humanMerged: v.number(),
+    externalMerged: v.number(),
+    rejected: v.number(),
+    pendingReview: v.number(),
+    effort: reviewEffortDistributionSchema,
+});
+/**
+ * The auto-merge share of a class's LANDED records, 0..1, or null when nothing has landed
+ * yet (so the UI shows "no data" rather than a misleading 0%). Shared by the preset editor
+ * and any backend consumer so the two can never disagree.
+ */
+export function autoMergeShare(rollup) {
+    if (rollup.merged === 0)
+        return null;
+    return rollup.autoMerged / rollup.merged;
+}
+/**
+ * The share of a class's TAGGED records that needed no blocking comments, 0..1, or null when
+ * nothing in the class has been tagged. This — not the auto-merge share — is the evidence that
+ * justifies flipping a class to `always`: it says humans found nothing to say.
+ */
+export function frictionlessShare(rollup) {
+    const tagged = rollup.effort.none + rollup.effort.minor + rollup.effort.major;
+    if (tagged === 0)
+        return null;
+    return rollup.effort.none / tagged;
+}
+/** An empty rollup for a class with no records yet (the UI renders every class, always). */
+export function emptyMergeClassRollup(changeClass) {
+    return {
+        changeClass,
+        total: 0,
+        merged: 0,
+        autoMerged: 0,
+        humanMerged: 0,
+        externalMerged: 0,
+        rejected: 0,
+        pendingReview: 0,
+        effort: { none: 0, minor: 0, major: 0, untagged: 0 },
+    };
+}
+// ---- Request bodies -------------------------------------------------------
+/**
+ * Body of `POST /blocks/:blockId/merge` — the inspector's merge control. Every field is optional,
+ * so `{}` is the historical no-body merge; `reviewEffort` records the effort tag onto the block's
+ * merge track record in the same request (the counterpart of the notification card's `act` body).
+ */
+export const mergeBlockSchema = v.object({
+    reviewEffort: v.optional(v.nullable(reviewEffortSchema)),
+});
+/** Tag a record with the review effort a human actually spent (`null` clears the tag). */
+export const tagReviewEffortSchema = v.object({
+    reviewEffort: v.nullable(reviewEffortSchema),
+});
+//# sourceMappingURL=mergeTrackRecord.js.map

package/dist/mergeTrackRecord.js.map

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