@cat-factory/contracts 0.6.0

package/dist/localModels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localModels.d.ts","sourceRoot":"","sources":["../src/localModels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAe5B,oFAAoF;AACpF,eAAO,MAAM,aAAa,YAAI,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAA;AAC1F,eAAO,MAAM,iBAAiB,4FAA4B,CAAA;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAMpE,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAM3D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;IAInC,kEAAkE;;IAElE,oFAAoF;;;;aAIpF,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAO/E,qFAAqF;AACrF,eAAO,MAAM,8BAA8B;;;;IAIzC,oFAAoF;;;aAGpF,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAEhG,iFAAiF;AACjF,eAAO,MAAM,4BAA4B;;;;aAIvC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAE5F,2DAA2D;AAC3D,eAAO,MAAM,kCAAkC;;IAE7C,6DAA6D;;IAE7D,+DAA+D;;aAE/D,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kCAAkC,CAAC,CAAA"}

package/dist/localModels.js

@@ -0,0 +1,79 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Locally-run model wire contracts. A developer running cat-factory in local
+// (or self-hosted Node) mode can point agents at an LLM running on their OWN
+// machine — Ollama, LM Studio, llama.cpp's `llama-server`, vLLM, or any other
+// OpenAI-compatible server. All expose the OpenAI `/v1/chat/completions` +
+// `/v1/models` shape, so a "runner" is just a provider id + a base URL.
+//
+// Endpoints are configured PER USER (a runner lives on a person's machine, so
+// `localhost:11434` means something different for each member) and stored in the
+// DB. At run time the LLM proxy / inline model provider resolve the base URL +
+// optional key by the RUN INITIATOR — exactly like personal subscriptions.
+// ---------------------------------------------------------------------------
+/** The supported local runner types. The runner type IS the `ModelRef.provider`. */
+export const LOCAL_RUNNERS = ['ollama', 'lmstudio', 'llamacpp', 'vllm', 'custom'];
+export const localRunnerSchema = v.picklist(LOCAL_RUNNERS);
+/** Whether a provider id is one of the local runner types. */
+export function isLocalRunner(provider) {
+    return LOCAL_RUNNERS.includes(provider);
+}
+/** Default base URL per runner, for UI prefill. `custom` has none (user supplies it). */
+export const LOCAL_RUNNER_DEFAULTS = {
+    ollama: 'http://localhost:11434/v1',
+    lmstudio: 'http://localhost:1234/v1',
+    llamacpp: 'http://localhost:8080/v1',
+    vllm: 'http://localhost:8000/v1',
+    custom: null,
+};
+/** Short display label per runner, shown in the picker as the provider label. */
+export const LOCAL_RUNNER_LABELS = {
+    ollama: 'Ollama',
+    lmstudio: 'LM Studio',
+    llamacpp: 'llama.cpp',
+    vllm: 'vLLM',
+    custom: 'Custom',
+};
+/**
+ * A user's configured local runner endpoint, as returned to the SPA. The API key is
+ * write-only (never returned); `hasApiKey` reports whether one is stored.
+ */
+export const localModelEndpointSchema = v.object({
+    provider: localRunnerSchema,
+    label: v.string(),
+    baseUrl: v.string(),
+    /** Whether a (write-only) API key is stored for this endpoint. */
+    hasApiKey: v.boolean(),
+    /** The model ids the user has enabled from this runner (surfaced in the picker). */
+    models: v.array(v.string()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+});
+const baseUrlSchema = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(300), v.url());
+const labelSchema = v.pipe(v.string(), v.trim(), v.maxLength(60));
+const apiKeySchema = v.pipe(v.string(), v.maxLength(400));
+const modelIdSchema = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(200));
+/** Create or replace the signed-in user's endpoint for a runner (one per runner). */
+export const upsertLocalModelEndpointSchema = v.object({
+    provider: localRunnerSchema,
+    label: v.optional(labelSchema),
+    baseUrl: baseUrlSchema,
+    /** Optional bearer key (most local runners ignore it); stored encrypted at rest. */
+    apiKey: v.optional(apiKeySchema),
+    models: v.array(modelIdSchema),
+});
+/** Probe a runner endpoint for reachability + the models it currently serves. */
+export const testLocalModelEndpointSchema = v.object({
+    provider: localRunnerSchema,
+    baseUrl: baseUrlSchema,
+    apiKey: v.optional(apiKeySchema),
+});
+/** The result of probing a runner endpoint's `/models`. */
+export const localModelEndpointTestResultSchema = v.object({
+    reachable: v.boolean(),
+    /** Model ids the runner reports (empty when unreachable). */
+    models: v.array(v.string()),
+    /** Human-readable failure reason when `reachable` is false. */
+    error: v.optional(v.string()),
+});
+//# sourceMappingURL=localModels.js.map

package/dist/localModels.js.map

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

package/dist/merge.d.ts

@@ -0,0 +1,106 @@
+import * as v from 'valibot';
+/**
+ * A `merger` agent's structured assessment of a pull request. Each axis is scored
+ * 0..1 (higher = more complex / riskier / higher blast-radius); `rationale` is the
+ * agent's prose justification, surfaced to a human when the PR needs review.
+ */
+/**
+ * The severity threshold a task tolerates from the requirements reviewer before it stops
+ * for a human. Mirrors the review item severities (`low`/`medium`/`high`) plus `none`,
+ * which tolerates nothing. Ordered none < low < medium < high.
+ */
+export declare const requirementConcernLevelSchema: v.PicklistSchema<["none", "low", "medium", "high"], undefined>;
+export type RequirementConcernLevel = v.InferOutput<typeof requirementConcernLevelSchema>;
+/** Rank of a {@link RequirementConcernLevel} for "at or below" comparisons. */
+export declare const REQUIREMENT_CONCERN_RANK: Record<RequirementConcernLevel, number>;
+export declare const mergeAssessmentSchema: v.ObjectSchema<{
+    /** How intricate the change is (size, coupling, subtlety). */
+    readonly complexity: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    /** Likelihood the change breaks something (test coverage, fragility). */
+    readonly risk: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    /** Blast radius if it does break (how much/who it affects). */
+    readonly impact: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    /** The agent's plain-prose justification for the scores + a merge recommendation. */
+    readonly rationale: v.StringSchema<undefined>;
+}, undefined>;
+export type MergeAssessment = v.InferOutput<typeof mergeAssessmentSchema>;
+/**
+ * A named, per-workspace merge policy: the upper bounds (0..1) a PR's assessment
+ * must stay within to auto-merge, plus the CI-fixer attempt budget. Exactly one
+ * preset per workspace is the default (`isDefault`), used by any task that has not
+ * picked one explicitly.
+ */
+export declare const mergeThresholdPresetSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    /** Auto-merge only when the assessment's complexity is at or below this. */
+    readonly maxComplexity: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    /** Auto-merge only when the assessment's risk is at or below this. */
+    readonly maxRisk: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    /** Auto-merge only when the assessment's impact is at or below this. */
+    readonly maxImpact: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    /** How many times the `ci-fixer` agent may try to turn CI green before giving up. */
+    readonly ciMaxAttempts: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    /**
+     * How many reviewer passes the iterative requirements-review loop may run before it
+     * stops on its own and asks the human to pick (extra round / proceed anyway / reset the
+     * task). One reviewer pass = one iteration; the initial review counts as iteration 1.
+     */
+    readonly maxRequirementIterations: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
+    /**
+     * The highest finding severity the requirements review tolerates WITHOUT stopping. When
+     * every outstanding finding from a reviewer pass is at or below this level, the findings
+     * are recorded but the run does NOT pause for human approval — the incorporation
+     * companion is skipped and the next pipeline step runs automatically. `none` (the
+     * default) tolerates nothing, so any finding pauses for a human; `high` tolerates
+     * everything. Severity order: none < low < medium < high.
+     */
+    readonly maxRequirementConcernAllowed: v.PicklistSchema<["none", "low", "medium", "high"], undefined>;
+    /**
+     * How long (minutes) the post-release-health gate watches the deployed release's
+     * Datadog monitors/SLOs before declaring it healthy and advancing.
+     */
+    readonly releaseWatchWindowMinutes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
+    /**
+     * How many `on-call` investigations the post-release-health gate may dispatch while
+     * watching before it gives up and raises a notification. The on-call agent investigates
+     * rather than fixing prod, so 1 is the sensible default.
+     */
+    readonly releaseMaxAttempts: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    /** The workspace's fallback preset, used by tasks that pick none. Exactly one is true. */
+    readonly isDefault: v.BooleanSchema<undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type MergeThresholdPreset = v.InferOutput<typeof mergeThresholdPresetSchema>;
+/** Create a new merge threshold preset in a workspace. */
+export declare const createMergePresetSchema: v.ObjectSchema<{
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 60, undefined>]>;
+    readonly maxComplexity: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    readonly maxRisk: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    readonly maxImpact: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    readonly ciMaxAttempts: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 50, undefined>]>;
+    readonly maxRequirementIterations: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 20, undefined>]>;
+    readonly maxRequirementConcernAllowed: v.PicklistSchema<["none", "low", "medium", "high"], undefined>;
+    readonly releaseWatchWindowMinutes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 720, undefined>]>, 30>;
+    readonly releaseMaxAttempts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 10, undefined>]>, 1>;
+    /** Make this the workspace default (demotes the previous default). */
+    readonly isDefault: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+}, undefined>;
+export type CreateMergePresetInput = v.InferOutput<typeof createMergePresetSchema>;
+/** Patch an existing merge threshold preset (all fields optional). */
+export declare const updateMergePresetSchema: v.ObjectSchema<{
+    readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 60, undefined>]>, undefined>;
+    readonly maxComplexity: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+    readonly maxRisk: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+    readonly maxImpact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+    readonly ciMaxAttempts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 50, undefined>]>, undefined>;
+    readonly maxRequirementIterations: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 20, undefined>]>, undefined>;
+    readonly maxRequirementConcernAllowed: v.OptionalSchema<v.PicklistSchema<["none", "low", "medium", "high"], undefined>, undefined>;
+    readonly releaseWatchWindowMinutes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 720, undefined>]>, undefined>;
+    readonly releaseMaxAttempts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 10, undefined>]>, undefined>;
+    readonly isDefault: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type UpdateMergePresetInput = v.InferOutput<typeof updateMergePresetSchema>;
+/** Parse-or-throw an assessment payload an agent returned (the engine validates it). */
+export declare function parseMergeAssessment(value: unknown): MergeAssessment;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAiB5B;;;;GAIG;AACH;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,gEAAgD,CAAA;AAC1F,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEzF,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAK5E,CAAA;AAED,eAAO,MAAM,qBAAqB;IAChC,8DAA8D;;IAE9D,yEAAyE;;IAEzE,+DAA+D;;IAE/D,qFAAqF;;aAErF,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;IAGrC,4EAA4E;;IAE5E,sEAAsE;;IAEtE,wEAAwE;;IAExE,qFAAqF;;IAErF;;;;OAIG;;IAEH;;;;;;;OAOG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;IAEH,0FAA0F;;;aAG1F,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAWnF,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB;;;;;;;;;;IAUlC,sEAAsE;;aAEtE,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAElF,sEAAsE;AACtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;aAWlC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAElF,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAEpE"}

package/dist/merge.js

@@ -0,0 +1,129 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// 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 —
+// complexity, risk and impact (each scored 0..1) — and the engine compares those
+// scores against the task's resolved *merge threshold preset*. If every score is
+// at or below its configured ceiling the PR is merged automatically; otherwise a
+// `merge_review` notification is raised for a human to act on.
+//
+// Presets are authored per workspace (a small library of named policies, e.g.
+// "Cautious", "Trusted") and one is selected per task; a task with no explicit
+// selection resolves to the workspace's default preset. The preset also carries
+// the CI-fixer attempt budget (how many times the `ci-fixer` agent may try to get
+// CI green before the run gives up).
+// ---------------------------------------------------------------------------
+/**
+ * A `merger` agent's structured assessment of a pull request. Each axis is scored
+ * 0..1 (higher = more complex / riskier / higher blast-radius); `rationale` is the
+ * agent's prose justification, surfaced to a human when the PR needs review.
+ */
+/**
+ * The severity threshold a task tolerates from the requirements reviewer before it stops
+ * for a human. Mirrors the review item severities (`low`/`medium`/`high`) plus `none`,
+ * which tolerates nothing. Ordered none < low < medium < high.
+ */
+export const requirementConcernLevelSchema = v.picklist(['none', 'low', 'medium', 'high']);
+/** Rank of a {@link RequirementConcernLevel} for "at or below" comparisons. */
+export const REQUIREMENT_CONCERN_RANK = {
+    none: 0,
+    low: 1,
+    medium: 2,
+    high: 3,
+};
+export const mergeAssessmentSchema = v.object({
+    /** How intricate the change is (size, coupling, subtlety). */
+    complexity: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
+    /** Likelihood the change breaks something (test coverage, fragility). */
+    risk: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
+    /** Blast radius if it does break (how much/who it affects). */
+    impact: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
+    /** The agent's plain-prose justification for the scores + a merge recommendation. */
+    rationale: v.string(),
+});
+/**
+ * A named, per-workspace merge policy: the upper bounds (0..1) a PR's assessment
+ * must stay within to auto-merge, plus the CI-fixer attempt budget. Exactly one
+ * preset per workspace is the default (`isDefault`), used by any task that has not
+ * picked one explicitly.
+ */
+export const mergeThresholdPresetSchema = v.object({
+    id: v.string(),
+    name: v.string(),
+    /** Auto-merge only when the assessment's complexity is at or below this. */
+    maxComplexity: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
+    /** Auto-merge only when the assessment's risk is at or below this. */
+    maxRisk: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
+    /** Auto-merge only when the assessment's impact is at or below this. */
+    maxImpact: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
+    /** How many times the `ci-fixer` agent may try to turn CI green before giving up. */
+    ciMaxAttempts: v.pipe(v.number(), v.integer(), v.minValue(0)),
+    /**
+     * How many reviewer passes the iterative requirements-review loop may run before it
+     * stops on its own and asks the human to pick (extra round / proceed anyway / reset the
+     * task). One reviewer pass = one iteration; the initial review counts as iteration 1.
+     */
+    maxRequirementIterations: v.pipe(v.number(), v.integer(), v.minValue(1)),
+    /**
+     * The highest finding severity the requirements review tolerates WITHOUT stopping. When
+     * every outstanding finding from a reviewer pass is at or below this level, the findings
+     * are recorded but the run does NOT pause for human approval — the incorporation
+     * companion is skipped and the next pipeline step runs automatically. `none` (the
+     * default) tolerates nothing, so any finding pauses for a human; `high` tolerates
+     * everything. Severity order: none < low < medium < high.
+     */
+    maxRequirementConcernAllowed: requirementConcernLevelSchema,
+    /**
+     * How long (minutes) the post-release-health gate watches the deployed release's
+     * Datadog monitors/SLOs before declaring it healthy and advancing.
+     */
+    releaseWatchWindowMinutes: v.pipe(v.number(), v.integer(), v.minValue(1)),
+    /**
+     * How many `on-call` investigations the post-release-health gate may dispatch while
+     * watching before it gives up and raises a notification. The on-call agent investigates
+     * rather than fixing prod, so 1 is the sensible default.
+     */
+    releaseMaxAttempts: v.pipe(v.number(), v.integer(), v.minValue(0)),
+    /** The workspace's fallback preset, used by tasks that pick none. Exactly one is true. */
+    isDefault: v.boolean(),
+    createdAt: v.number(),
+});
+// ---- Request bodies -------------------------------------------------------
+const presetNameSchema = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(60));
+const scoreSchema = v.pipe(v.number(), v.minValue(0), v.maxValue(1));
+const attemptsSchema = v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(50));
+const iterationsSchema = v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(20));
+const releaseWindowSchema = v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(720));
+const releaseAttemptsSchema = v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(10));
+/** Create a new merge threshold preset in a workspace. */
+export const createMergePresetSchema = v.object({
+    name: presetNameSchema,
+    maxComplexity: scoreSchema,
+    maxRisk: scoreSchema,
+    maxImpact: scoreSchema,
+    ciMaxAttempts: attemptsSchema,
+    maxRequirementIterations: iterationsSchema,
+    maxRequirementConcernAllowed: requirementConcernLevelSchema,
+    releaseWatchWindowMinutes: v.optional(releaseWindowSchema, 30),
+    releaseMaxAttempts: v.optional(releaseAttemptsSchema, 1),
+    /** Make this the workspace default (demotes the previous default). */
+    isDefault: v.optional(v.boolean(), false),
+});
+/** Patch an existing merge threshold preset (all fields optional). */
+export const updateMergePresetSchema = v.object({
+    name: v.optional(presetNameSchema),
+    maxComplexity: v.optional(scoreSchema),
+    maxRisk: v.optional(scoreSchema),
+    maxImpact: v.optional(scoreSchema),
+    ciMaxAttempts: v.optional(attemptsSchema),
+    maxRequirementIterations: v.optional(iterationsSchema),
+    maxRequirementConcernAllowed: v.optional(requirementConcernLevelSchema),
+    releaseWatchWindowMinutes: v.optional(releaseWindowSchema),
+    releaseMaxAttempts: v.optional(releaseAttemptsSchema),
+    isDefault: v.optional(v.boolean()),
+});
+/** Parse-or-throw an assessment payload an agent returned (the engine validates it). */
+export function parseMergeAssessment(value) {
+    return v.parse(mergeAssessmentSchema, value);
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

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

package/dist/model-defaults.d.ts

@@ -0,0 +1,23 @@
+import * as v from 'valibot';
+/**
+ * A workspace's per-agent-kind default models: a map from agent kind to the model
+ * catalog id it should default to. A kind absent from the map falls back to the
+ * env routing for that kind. Sent on the wire as the workspace's full selection.
+ */
+export declare const modelDefaultsSchema: v.ObjectSchema<{
+    readonly defaults: v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type ModelDefaults = v.InferOutput<typeof modelDefaultsSchema>;
+/**
+ * Replace a workspace's per-kind default models. Sending the full map replaces it
+ * wholesale (a kind omitted is cleared). Keys (agent kinds) and values (model ids)
+ * are both trimmed and must be non-empty — agent kinds are an open set (custom
+ * agents are allowed), so keys aren't checked against a closed list, and model ids
+ * aren't validated against the catalog here (an unresolvable id simply falls back
+ * to the env routing at run time).
+ */
+export declare const setModelDefaultsSchema: v.ObjectSchema<{
+    readonly defaults: v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+}, undefined>;
+export type SetModelDefaultsInput = v.InferOutput<typeof setModelDefaultsSchema>;
+//# sourceMappingURL=model-defaults.d.ts.map

package/dist/model-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-defaults.d.ts","sourceRoot":"","sources":["../src/model-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAe5B;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;aAE9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAIrE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;;aAKjC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA"}

package/dist/model-defaults.js

@@ -0,0 +1,34 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Per-workspace, per-agent-kind default model selection. A workspace can choose
+// which model is the default for each agent kind (e.g. point `architect` at a
+// strong model and `tester` at a cheap one), overriding the env-driven
+// `AGENT_routing` for that workspace at runtime. The map is keyed by agent kind
+// and valued by a model catalog id (the `ModelOption.id` from `GET /models`).
+//
+// Resolution precedence at run time is: a block's explicitly pinned model wins,
+// else this workspace per-kind default, else the env routing for the kind, else
+// the env default. So this map only fills the gap between "no per-task pin" and
+// "the deployment-wide routing".
+// ---------------------------------------------------------------------------
+/**
+ * A workspace's per-agent-kind default models: a map from agent kind to the model
+ * catalog id it should default to. A kind absent from the map falls back to the
+ * env routing for that kind. Sent on the wire as the workspace's full selection.
+ */
+export const modelDefaultsSchema = v.object({
+    defaults: v.record(v.string(), v.string()),
+});
+// ---- Request bodies -------------------------------------------------------
+/**
+ * Replace a workspace's per-kind default models. Sending the full map replaces it
+ * wholesale (a kind omitted is cleared). Keys (agent kinds) and values (model ids)
+ * are both trimmed and must be non-empty — agent kinds are an open set (custom
+ * agents are allowed), so keys aren't checked against a closed list, and model ids
+ * aren't validated against the catalog here (an unresolvable id simply falls back
+ * to the env routing at run time).
+ */
+export const setModelDefaultsSchema = v.object({
+    defaults: v.record(v.pipe(v.string(), v.trim(), v.minLength(1)), v.pipe(v.string(), v.trim(), v.minLength(1))),
+});
+//# sourceMappingURL=model-defaults.js.map

package/dist/model-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-defaults.js","sourceRoot":"","sources":["../src/model-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,uEAAuE;AACvE,gFAAgF;AAChF,8EAA8E;AAC9E,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,iCAAiC;AACjC,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;CAC3C,CAAC,CAAA;AAGF,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,CAChB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAC5C,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAC7C;CACF,CAAC,CAAA"}

package/dist/notifications.d.ts

@@ -0,0 +1,136 @@
+import * as v from 'valibot';
+/**
+ * The kind of human-actionable event a notification represents. A closed set so
+ * the frontend can switch on it to render the right action; extending it is a
+ * one-line change here plus a handler in the worker's `act` route.
+ */
+export declare const notificationTypeSchema: v.PicklistSchema<["merge_review", "pipeline_complete", "ci_failed", "test_failed", "requirement_review", "clarity_review", "release_regression", "decision_required"], undefined>;
+export type NotificationType = v.InferOutput<typeof notificationTypeSchema>;
+/**
+ * Lifecycle of a notification: `open` until a human engages, terminal `acted`
+ * once its action ran (merged, confirmed, retried…), or `dismissed` when waved
+ * off. Only `open` notifications surface on the board.
+ */
+export declare const notificationStatusSchema: v.PicklistSchema<["open", "acted", "dismissed"], undefined>;
+export type NotificationStatus = v.InferOutput<typeof notificationStatusSchema>;
+/**
+ * How urgently a notification is rendered. A notification starts `normal` (the
+ * inbox's usual per-type color) and is escalated to `urgent` (red) by the periodic
+ * sweep once it has been waiting for a human longer than the workspace's
+ * `waitingEscalationMinutes` threshold. This is the run-timing signal that replaced
+ * the old hard "decision timeout" auto-fail: runs now wait indefinitely, and the
+ * notification colour — not a killed run — conveys that a human is overdue.
+ */
+export declare const notificationSeveritySchema: v.PicklistSchema<["normal", "urgent"], undefined>;
+export type NotificationSeverity = v.InferOutput<typeof notificationSeveritySchema>;
+/**
+ * Optional structured detail a notification carries for rendering its card —
+ * e.g. a `merge_review` carries the agent's assessment + the PR it concerns. Kept
+ * deliberately small and additive so new notification types can attach their own
+ * context without a schema migration.
+ */
+export declare const notificationPayloadSchema: v.ObjectSchema<{
+    /** The `merger` agent's assessment, on a `merge_review`. */
+    readonly assessment: v.OptionalSchema<v.ObjectSchema<{
+        readonly complexity: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+        readonly risk: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+        readonly impact: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+        readonly rationale: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+    /** Web URL of the PR the notification concerns, when one is known. */
+    readonly prUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** The pipeline run that raised it, for display ("from the Full build run"). */
+    readonly pipelineName: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Number of open findings, on a `requirement_review`. */
+    readonly findingCount: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    /** The `on-call` agent's assessment, on a `release_regression`. */
+    readonly onCallAssessment: v.OptionalSchema<v.ObjectSchema<{
+        readonly culpritConfidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+        readonly recommendation: v.PicklistSchema<["revert", "hold", "monitor"], undefined>;
+        readonly rationale: v.StringSchema<undefined>;
+        readonly evidence: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+    }, undefined>, undefined>;
+    /** The monitors/SLOs that regressed, on a `release_regression`. */
+    readonly releaseSignals: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly kind: v.PicklistSchema<["monitor", "slo"], undefined>;
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+        readonly state: v.PicklistSchema<["ok", "warn", "alert", "no_data"], undefined>;
+        readonly detail: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
+    /** Web URL of a proposed revert PR the human can open/merge, when known. */
+    readonly revertUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * Internal user id (`usr_*`) of the member this notification is directed at — the
+     * task's responsible product person on a `requirement_review`. The inbox highlights
+     * it as "for you"; the notification stays workspace-visible to everyone.
+     */
+    readonly targetUserId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export type NotificationPayload = v.InferOutput<typeof notificationPayloadSchema>;
+/** A human-actionable item surfaced on the board. */
+export declare const notificationSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly type: v.PicklistSchema<["merge_review", "pipeline_complete", "ci_failed", "test_failed", "requirement_review", "clarity_review", "release_regression", "decision_required"], undefined>;
+    readonly status: v.PicklistSchema<["open", "acted", "dismissed"], undefined>;
+    /**
+     * Render urgency (see {@link notificationSeveritySchema}). Absent ⇒ `normal`. Flipped
+     * to `urgent` by the escalation sweep once it has waited past the workspace threshold.
+     */
+    readonly severity: v.OptionalSchema<v.PicklistSchema<["normal", "urgent"], undefined>, undefined>;
+    /** The block (task/frame) the notification is about; null for workspace-wide. */
+    readonly blockId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** The execution run that raised it, when applicable. */
+    readonly executionId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Short headline shown on the card. */
+    readonly title: v.StringSchema<undefined>;
+    /** Longer prose body / context. */
+    readonly body: v.StringSchema<undefined>;
+    /** Optional structured detail for rendering (see {@link notificationPayloadSchema}). */
+    readonly payload: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+        /** The `merger` agent's assessment, on a `merge_review`. */
+        readonly assessment: v.OptionalSchema<v.ObjectSchema<{
+            readonly complexity: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+            readonly risk: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+            readonly impact: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+            readonly rationale: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+        /** Web URL of the PR the notification concerns, when one is known. */
+        readonly prUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** The pipeline run that raised it, for display ("from the Full build run"). */
+        readonly pipelineName: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Number of open findings, on a `requirement_review`. */
+        readonly findingCount: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        /** The `on-call` agent's assessment, on a `release_regression`. */
+        readonly onCallAssessment: v.OptionalSchema<v.ObjectSchema<{
+            readonly culpritConfidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+            readonly recommendation: v.PicklistSchema<["revert", "hold", "monitor"], undefined>;
+            readonly rationale: v.StringSchema<undefined>;
+            readonly evidence: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+        }, undefined>, undefined>;
+        /** The monitors/SLOs that regressed, on a `release_regression`. */
+        readonly releaseSignals: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly kind: v.PicklistSchema<["monitor", "slo"], undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly state: v.PicklistSchema<["ok", "warn", "alert", "no_data"], undefined>;
+            readonly detail: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
+        /** Web URL of a proposed revert PR the human can open/merge, when known. */
+        readonly revertUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * Internal user id (`usr_*`) of the member this notification is directed at — the
+         * task's responsible product person on a `requirement_review`. The inbox highlights
+         * it as "for you"; the notification stays workspace-visible to everyone.
+         */
+        readonly targetUserId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    /** When it left `open` (acted/dismissed); null while open. */
+    readonly resolvedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type Notification = v.InferOutput<typeof notificationSchema>;
+/** How a human resolved a notification from its card. */
+export declare const resolveNotificationActionSchema: v.PicklistSchema<["act", "dismiss"], undefined>;
+export type ResolveNotificationAction = v.InferOutput<typeof resolveNotificationActionSchema>;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAyC5B;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,mLASjC,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,6DAA6C,CAAA;AAClF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,mDAAmC,CAAA;AAC1E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;IACpC,4DAA4D;;;;;;;IAE5D,sEAAsE;;IAEtE,gFAAgF;;IAEhF,0DAA0D;;IAE1D,mEAAmE;;;;;;;IAEnE,mEAAmE;;;;;;;;IAEnE,4EAA4E;;IAE5E;;;;OAIG;;aAEH,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEjF,qDAAqD;AACrD,eAAO,MAAM,kBAAkB;;;;IAI7B;;;OAGG;;IAEH,iFAAiF;;IAEjF,yDAAyD;;IAEzD,wCAAwC;;IAExC,mCAAmC;;IAEnC,wFAAwF;;QAzCxF,4DAA4D;;;;;;;QAE5D,sEAAsE;;QAEtE,gFAAgF;;QAEhF,0DAA0D;;QAE1D,mEAAmE;;;;;;;QAEnE,mEAAmE;;;;;;;;QAEnE,4EAA4E;;QAE5E;;;;WAIG;;;;IA0BH,8DAA8D;;aAE9D,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAInE,yDAAyD;AACzD,eAAO,MAAM,+BAA+B,iDAAiC,CAAA;AAC7E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA"}