@cat-factory/contracts 0.169.0 → 0.171.0

package/dist/human-verdict-gates.d.ts

@@ -0,0 +1,165 @@
+import * as v from 'valibot';
+export declare const humanTestEnvironmentSchema: v.ObjectSchema<{
+    /** The `environments` row id, so the window can fetch access creds / re-poll status. */
+    readonly id: v.StringSchema<undefined>;
+    /** The provisioned public URL the human tests against (null while still provisioning). */
+    readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** The environment lifecycle status; see {@link environmentStatusSchema}. */
+    readonly status: v.PicklistSchema<["provisioning", "ready", "failed", "expired", "tearing_down", "torn_down"], undefined>;
+    /** Epoch ms the environment expires (TTL), when known. */
+    readonly expiresAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export type HumanTestEnvironment = v.InferOutput<typeof humanTestEnvironmentSchema>;
+/**
+ * One round of human-driven remediation on a `human-test` gate: the human wrote findings and
+ * asked for a fix (helper `fixer`), or pulled main and hit a conflict (helper
+ * `conflict-resolver`). Appended when the round opens and stamped with its outcome once the
+ * helper job settles, so the window can show the full history of what was asked and how it ended.
+ */
+export declare const humanTestRoundSchema: v.ObjectSchema<{
+    /** The kind of round — a findings-driven fix or a pull-main-with-conflicts resolve. */
+    readonly kind: v.PicklistSchema<["fix", "pull-main"], undefined>;
+    /** The human's findings prompt (fix), or a one-line note for the pull-main round. */
+    readonly findings: v.StringSchema<undefined>;
+    /** The helper container kind this round dispatched (`fixer` / `conflict-resolver`). */
+    readonly helperKind: v.StringSchema<undefined>;
+    /** The helper job's id while it ran, for cross-referencing the run timeline. */
+    readonly jobId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** How the helper ended once its job settled. Absent while still in flight. */
+    readonly outcome: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["completed", "failed"], undefined>, undefined>, undefined>;
+    /** Epoch ms the round opened (the human clicked Request fix / Pull main). */
+    readonly at: v.NumberSchema<undefined>;
+}, undefined>;
+export type HumanTestRound = v.InferOutput<typeof humanTestRoundSchema>;
+/**
+ * State a `human-test` gate carries while it runs. Unlike a polling gate (`ci`/`conflicts`)
+ * there is no programmatic verdict — the HUMAN is the verdict — so the step spins up an
+ * ephemeral environment, parks for a person to validate it, and on demand dispatches the same
+ * helpers the other gates use (the Tester's `fixer` for findings; the `conflict-resolver` for a
+ * conflicting pull-main). Phases:
+ *   - `provisioning`        — an environment is being stood up (the driver polls until ready).
+ *   - `awaiting_human`      — parked: the human tests the env and confirms / requests a fix / etc.
+ *   - `fixing`              — a `fixer` job (from the human's findings) is in flight.
+ *   - `resolving_conflicts` — a `conflict-resolver` job (from a conflicting pull-main) is in flight.
+ *   - `passed`             — the human confirmed; the env is torn down and the run advances.
+ */
+export declare const humanTestStepStateSchema: v.ObjectSchema<{
+    readonly phase: v.PicklistSchema<["provisioning", "awaiting_human", "fixing", "resolving_conflicts", "passed"], undefined>;
+    /** The live ephemeral environment (null in degraded manual mode / after destroy). */
+    readonly environment: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+        /** The `environments` row id, so the window can fetch access creds / re-poll status. */
+        readonly id: v.StringSchema<undefined>;
+        /** The provisioned public URL the human tests against (null while still provisioning). */
+        readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /** The environment lifecycle status; see {@link environmentStatusSchema}. */
+        readonly status: v.PicklistSchema<["provisioning", "ready", "failed", "expired", "tearing_down", "torn_down"], undefined>;
+        /** Epoch ms the environment expires (TTL), when known. */
+        readonly expiresAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
+    /**
+     * Why no environment was auto-provisioned — set in degraded manual mode (no env provider
+     * wired, or provisioning errored) so the window can explain it and let the human test
+     * against the PR branch manually. Absent when an env was provisioned.
+     */
+    readonly degradedReason: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** How many helper (fixer / conflict-resolver) attempts have been dispatched so far. */
+    readonly attempts: v.NumberSchema<undefined>;
+    /** Ceiling on helper attempts, resolved from the task's merge preset (`ciMaxAttempts`). */
+    readonly maxAttempts: v.NumberSchema<undefined>;
+    /** The PR head commit being tested, when known. */
+    readonly headSha: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** Append-only history of fix / pull-main rounds; see {@link humanTestRoundSchema}. */
+    readonly rounds: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        /** The kind of round — a findings-driven fix or a pull-main-with-conflicts resolve. */
+        readonly kind: v.PicklistSchema<["fix", "pull-main"], undefined>;
+        /** The human's findings prompt (fix), or a one-line note for the pull-main round. */
+        readonly findings: v.StringSchema<undefined>;
+        /** The helper container kind this round dispatched (`fixer` / `conflict-resolver`). */
+        readonly helperKind: v.StringSchema<undefined>;
+        /** The helper job's id while it ran, for cross-referencing the run timeline. */
+        readonly jobId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        /** How the helper ended once its job settled. Absent while still in flight. */
+        readonly outcome: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["completed", "failed"], undefined>, undefined>, undefined>;
+        /** Epoch ms the round opened (the human clicked Request fix / Pull main). */
+        readonly at: v.NumberSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
+    /**
+     * Transient action the human requested while the gate is parked — recorded on the parked
+     * step and consumed by the durable driver when it re-enters the gate (the analogue of
+     * `pendingIncorporation` on a requirements gate). Cleared once the driver acts on it.
+     */
+    readonly pendingAction: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+        readonly type: v.PicklistSchema<["confirm", "request-fix", "pull-main", "recreate"], undefined>;
+        /** The findings prompt for a `request-fix` action. */
+        readonly findings: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
+}, undefined>;
+export type HumanTestStepState = v.InferOutput<typeof humanTestStepStateSchema>;
+/**
+ * One actual-vs-reference pairing the visual-confirmation gate shows the human: a logical
+ * view, the screenshot the UI tester captured of it (`actualArtifactId`), and the reference
+ * design image for the same view when one was uploaded (`referenceArtifactId`). Either side
+ * may be absent (a captured view with no reference, or a reference whose view wasn't captured).
+ */
+export declare const visualConfirmPairSchema: v.ObjectSchema<{
+    readonly view: v.StringSchema<undefined>;
+    readonly actualArtifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly referenceArtifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export type VisualConfirmPair = v.InferOutput<typeof visualConfirmPairSchema>;
+/** One human-requested fix round on a visual-confirmation gate (dispatches the `fixer`). */
+export declare const visualConfirmRoundSchema: v.ObjectSchema<{
+    readonly findings: v.StringSchema<undefined>;
+    readonly helperKind: v.StringSchema<undefined>;
+    readonly jobId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly outcome: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["completed", "failed"], undefined>, undefined>, undefined>;
+    readonly at: v.NumberSchema<undefined>;
+}, undefined>;
+export type VisualConfirmRound = v.InferOutput<typeof visualConfirmRoundSchema>;
+/**
+ * State a `visual-confirmation` gate carries while it runs. Like `human-test` there is no
+ * programmatic verdict — a HUMAN reviews the UI tester's screenshots against the uploaded
+ * reference designs and approves, or requests a fix (which dispatches the `fixer` and then
+ * re-captures via the UI tester). Phases:
+ *   - `awaiting_human`— parked: the human reviews actual-vs-reference and approves / requests a fix.
+ *   - `fixing`        — a `fixer` job (from the human's findings) is in flight.
+ *   - `approved`      — the human approved; the run advances.
+ *
+ * (A dedicated `capturing` phase for an auto re-run of the UI tester after a fix is deferred
+ * until that loop is wired — see the visual-confirmation handover doc — so it is intentionally
+ * absent from the picklist rather than carried as dead state.)
+ */
+export declare const visualConfirmStepStateSchema: v.ObjectSchema<{
+    readonly phase: v.PicklistSchema<["awaiting_human", "fixing", "approved"], undefined>;
+    /** The actual-vs-reference pairs the human reviews, refreshed on each (re)capture. */
+    readonly pairs: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly view: v.StringSchema<undefined>;
+        readonly actualArtifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly referenceArtifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
+    /** Set when no screenshots could be gathered (no UI tester ran / no storage) — manual mode. */
+    readonly degradedReason: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** How many fixer attempts have been dispatched so far. */
+    readonly attempts: v.NumberSchema<undefined>;
+    /** Ceiling on fixer attempts, resolved from the task's merge preset (`ciMaxAttempts`). */
+    readonly maxAttempts: v.NumberSchema<undefined>;
+    /** Append-only history of fix rounds; see {@link visualConfirmRoundSchema}. */
+    readonly rounds: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly findings: v.StringSchema<undefined>;
+        readonly helperKind: v.StringSchema<undefined>;
+        readonly jobId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly outcome: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["completed", "failed"], undefined>, undefined>, undefined>;
+        readonly at: v.NumberSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
+    /**
+     * Transient action the human requested while parked — consumed by the durable driver
+     * when it re-enters the gate. Cleared once acted on.
+     */
+    readonly pendingAction: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+        readonly type: v.PicklistSchema<["approve", "request-fix", "recapture"], undefined>;
+        /** The findings prompt for a `request-fix` action. */
+        readonly findings: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
+}, undefined>;
+export type VisualConfirmStepState = v.InferOutput<typeof visualConfirmStepStateSchema>;
+//# sourceMappingURL=human-verdict-gates.d.ts.map

package/dist/human-verdict-gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-verdict-gates.d.ts","sourceRoot":"","sources":["../src/human-verdict-gates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAe5B,eAAO,MAAM,0BAA0B;IACrC,wFAAwF;;IAExF,0FAA0F;;IAE1F,6EAA6E;;IAE7E,0DAA0D;;aAE1D,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;IAC/B,uFAAuF;;IAEvF,qFAAqF;;IAErF,uFAAuF;;IAEvF,gFAAgF;;IAEhF,+EAA+E;;IAE/E,6EAA6E;;aAE7E,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB;;IAEnC,qFAAqF;;QA/CrF,wFAAwF;;QAExF,0FAA0F;;QAE1F,6EAA6E;;QAE7E,0DAA0D;;;IA2C1D;;;;OAIG;;IAEH,wFAAwF;;IAExF,2FAA2F;;IAE3F,mDAAmD;;IAEnD,uFAAuF;;QA3CvF,uFAAuF;;QAEvF,qFAAqF;;QAErF,uFAAuF;;QAEvF,gFAAgF;;QAEhF,+EAA+E;;QAE/E,6EAA6E;;;IAmC7E;;;;OAIG;;;QAKG,sDAAsD;;;aAK5D,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;aAIlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,4FAA4F;AAC5F,eAAO,MAAM,wBAAwB;;;;;;aAMnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B;;IAEvC,sFAAsF;;;;;;IAEtF,+FAA+F;;IAE/F,2DAA2D;;IAE3D,0FAA0F;;IAE1F,+EAA+E;;;;;;;;IAE/E;;;OAGG;;;QAKG,sDAAsD;;;aAK5D,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,4BAA4B,CAAC,CAAA"}

package/dist/human-verdict-gates.js

@@ -0,0 +1,139 @@
+import * as v from 'valibot';
+import { environmentStatusSchema } from './environments.js';
+// ---------------------------------------------------------------------------
+// HUMAN-VERDICT gate step states: the parked state of the two gates whose verdict is a PERSON,
+// not a provider probe — `human-test` (validate a live ephemeral environment) and
+// `visual-confirmation` (review the UI tester's screenshots against the reference designs).
+//
+// They are grouped here, apart from the polling gates' `GateStepState` in `execution.ts`, because
+// they share a shape the programmatic gates do not have: an append-only history of human-requested
+// helper `rounds`, and a transient `pendingAction` the human sets while the step is parked, which
+// the durable driver consumes on re-entry (the analogue of a requirements gate's
+// `pendingIncorporation`). A third human-verdict gate belongs in this file, not in `execution.ts`.
+// ---------------------------------------------------------------------------
+export const humanTestEnvironmentSchema = v.object({
+    /** The `environments` row id, so the window can fetch access creds / re-poll status. */
+    id: v.string(),
+    /** The provisioned public URL the human tests against (null while still provisioning). */
+    url: v.nullable(v.string()),
+    /** The environment lifecycle status; see {@link environmentStatusSchema}. */
+    status: environmentStatusSchema,
+    /** Epoch ms the environment expires (TTL), when known. */
+    expiresAt: v.optional(v.nullable(v.number())),
+});
+/**
+ * One round of human-driven remediation on a `human-test` gate: the human wrote findings and
+ * asked for a fix (helper `fixer`), or pulled main and hit a conflict (helper
+ * `conflict-resolver`). Appended when the round opens and stamped with its outcome once the
+ * helper job settles, so the window can show the full history of what was asked and how it ended.
+ */
+export const humanTestRoundSchema = v.object({
+    /** The kind of round — a findings-driven fix or a pull-main-with-conflicts resolve. */
+    kind: v.picklist(['fix', 'pull-main']),
+    /** The human's findings prompt (fix), or a one-line note for the pull-main round. */
+    findings: v.string(),
+    /** The helper container kind this round dispatched (`fixer` / `conflict-resolver`). */
+    helperKind: v.string(),
+    /** The helper job's id while it ran, for cross-referencing the run timeline. */
+    jobId: v.optional(v.nullable(v.string())),
+    /** How the helper ended once its job settled. Absent while still in flight. */
+    outcome: v.optional(v.nullable(v.picklist(['completed', 'failed']))),
+    /** Epoch ms the round opened (the human clicked Request fix / Pull main). */
+    at: v.number(),
+});
+/**
+ * State a `human-test` gate carries while it runs. Unlike a polling gate (`ci`/`conflicts`)
+ * there is no programmatic verdict — the HUMAN is the verdict — so the step spins up an
+ * ephemeral environment, parks for a person to validate it, and on demand dispatches the same
+ * helpers the other gates use (the Tester's `fixer` for findings; the `conflict-resolver` for a
+ * conflicting pull-main). Phases:
+ *   - `provisioning`        — an environment is being stood up (the driver polls until ready).
+ *   - `awaiting_human`      — parked: the human tests the env and confirms / requests a fix / etc.
+ *   - `fixing`              — a `fixer` job (from the human's findings) is in flight.
+ *   - `resolving_conflicts` — a `conflict-resolver` job (from a conflicting pull-main) is in flight.
+ *   - `passed`             — the human confirmed; the env is torn down and the run advances.
+ */
+export const humanTestStepStateSchema = v.object({
+    phase: v.picklist(['provisioning', 'awaiting_human', 'fixing', 'resolving_conflicts', 'passed']),
+    /** The live ephemeral environment (null in degraded manual mode / after destroy). */
+    environment: v.optional(v.nullable(humanTestEnvironmentSchema)),
+    /**
+     * Why no environment was auto-provisioned — set in degraded manual mode (no env provider
+     * wired, or provisioning errored) so the window can explain it and let the human test
+     * against the PR branch manually. Absent when an env was provisioned.
+     */
+    degradedReason: v.optional(v.nullable(v.string())),
+    /** How many helper (fixer / conflict-resolver) attempts have been dispatched so far. */
+    attempts: v.number(),
+    /** Ceiling on helper attempts, resolved from the task's merge preset (`ciMaxAttempts`). */
+    maxAttempts: v.number(),
+    /** The PR head commit being tested, when known. */
+    headSha: v.optional(v.nullable(v.string())),
+    /** Append-only history of fix / pull-main rounds; see {@link humanTestRoundSchema}. */
+    rounds: v.optional(v.array(humanTestRoundSchema)),
+    /**
+     * Transient action the human requested while the gate is parked — recorded on the parked
+     * step and consumed by the durable driver when it re-enters the gate (the analogue of
+     * `pendingIncorporation` on a requirements gate). Cleared once the driver acts on it.
+     */
+    pendingAction: v.optional(v.nullable(v.object({
+        type: v.picklist(['confirm', 'request-fix', 'pull-main', 'recreate']),
+        /** The findings prompt for a `request-fix` action. */
+        findings: v.optional(v.string()),
+    }))),
+});
+/**
+ * One actual-vs-reference pairing the visual-confirmation gate shows the human: a logical
+ * view, the screenshot the UI tester captured of it (`actualArtifactId`), and the reference
+ * design image for the same view when one was uploaded (`referenceArtifactId`). Either side
+ * may be absent (a captured view with no reference, or a reference whose view wasn't captured).
+ */
+export const visualConfirmPairSchema = v.object({
+    view: v.string(),
+    actualArtifactId: v.optional(v.nullable(v.string())),
+    referenceArtifactId: v.optional(v.nullable(v.string())),
+});
+/** One human-requested fix round on a visual-confirmation gate (dispatches the `fixer`). */
+export const visualConfirmRoundSchema = v.object({
+    findings: v.string(),
+    helperKind: v.string(),
+    jobId: v.optional(v.nullable(v.string())),
+    outcome: v.optional(v.nullable(v.picklist(['completed', 'failed']))),
+    at: v.number(),
+});
+/**
+ * State a `visual-confirmation` gate carries while it runs. Like `human-test` there is no
+ * programmatic verdict — a HUMAN reviews the UI tester's screenshots against the uploaded
+ * reference designs and approves, or requests a fix (which dispatches the `fixer` and then
+ * re-captures via the UI tester). Phases:
+ *   - `awaiting_human`— parked: the human reviews actual-vs-reference and approves / requests a fix.
+ *   - `fixing`        — a `fixer` job (from the human's findings) is in flight.
+ *   - `approved`      — the human approved; the run advances.
+ *
+ * (A dedicated `capturing` phase for an auto re-run of the UI tester after a fix is deferred
+ * until that loop is wired — see the visual-confirmation handover doc — so it is intentionally
+ * absent from the picklist rather than carried as dead state.)
+ */
+export const visualConfirmStepStateSchema = v.object({
+    phase: v.picklist(['awaiting_human', 'fixing', 'approved']),
+    /** The actual-vs-reference pairs the human reviews, refreshed on each (re)capture. */
+    pairs: v.optional(v.array(visualConfirmPairSchema)),
+    /** Set when no screenshots could be gathered (no UI tester ran / no storage) — manual mode. */
+    degradedReason: v.optional(v.nullable(v.string())),
+    /** How many fixer attempts have been dispatched so far. */
+    attempts: v.number(),
+    /** Ceiling on fixer attempts, resolved from the task's merge preset (`ciMaxAttempts`). */
+    maxAttempts: v.number(),
+    /** Append-only history of fix rounds; see {@link visualConfirmRoundSchema}. */
+    rounds: v.optional(v.array(visualConfirmRoundSchema)),
+    /**
+     * Transient action the human requested while parked — consumed by the durable driver
+     * when it re-enters the gate. Cleared once acted on.
+     */
+    pendingAction: v.optional(v.nullable(v.object({
+        type: v.picklist(['approve', 'request-fix', 'recapture']),
+        /** The findings prompt for a `request-fix` action. */
+        findings: v.optional(v.string()),
+    }))),
+});
+//# sourceMappingURL=human-verdict-gates.js.map

package/dist/human-verdict-gates.js.map

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

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './errors.js';
 export * from './config.js';
 export * from './entities.js';
 export * from './execution.js';
+export * from './human-verdict-gates.js';
 export * from './frontend.js';
 export * from './service-connections.js';
 export * from './preview.js';
@@ -42,6 +43,8 @@ export * from './requirements.js';
 export * from './doc-interview.js';
 export * from './followUp.js';
 export * from './forkDecision.js';
+export * from './gate.js';
+export * from './judge.js';
 export * from './ralph.js';
 export * from './validation-checks.js';
 export * from './reproduction.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -3,6 +3,7 @@ export * from './errors.js';
 export * from './config.js';
 export * from './entities.js';
 export * from './execution.js';
+export * from './human-verdict-gates.js';
 export * from './frontend.js';
 export * from './service-connections.js';
 export * from './preview.js';
@@ -42,6 +43,8 @@ export * from './requirements.js';
 export * from './doc-interview.js';
 export * from './followUp.js';
 export * from './forkDecision.js';
+export * from './gate.js';
+export * from './judge.js';
 export * from './ralph.js';
 export * from './validation-checks.js';
 export * from './reproduction.js';

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/judge.d.ts

@@ -0,0 +1,181 @@
+import * as v from 'valibot';
+/** Default minimum verdict score (0..1) a judge requires to advance the run. */
+export declare const DEFAULT_JUDGE_MIN_SCORE = 0.7;
+/** Default number of bounce rounds a judge may spend before it must ask a human. */
+export declare const DEFAULT_JUDGE_MAX_BOUNCES = 1;
+/** How serious one judge finding is. Ordered low < medium < high < critical. */
+export declare const judgeFindingSeveritySchema: v.PicklistSchema<["low", "medium", "high", "critical"], undefined>;
+export type JudgeFindingSeverity = v.InferOutput<typeof judgeFindingSeveritySchema>;
+/**
+ * One concrete thing the rubric flagged. `title` is the headline a human (or the bounced
+ * producer) acts on; `detail` is the evidence. Both are MODEL-AUTHORED text — every render
+ * of them onto a host-parsed surface (the PR body) goes through kernel's `hostMarkdown`
+ * helpers plus `redactSecrets`, exactly like the rest of the verification report.
+ */
+export declare const judgeFindingSchema: v.ObjectSchema<{
+    readonly title: v.SchemaWithFallback<v.StringSchema<undefined>, "Untitled finding">;
+    readonly detail: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly severity: v.SchemaWithFallback<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, "medium">;
+    /** Where the finding applies, when the judge could localise it (`path` or `path:line`). */
+    readonly where: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export type JudgeFinding = v.InferOutput<typeof judgeFindingSchema>;
+/**
+ * The canonical structured verdict a judge's assessment returns. A registration MAY supply
+ * its own valibot schema (the driver parses against whatever it registered), but the value
+ * must still expose a `score` — that is the number the per-task threshold compares — so the
+ * shared window and the PR report can render any judge without knowing its rubric.
+ *
+ * Every field is `v.fallback`-wrapped so ONE noisy field degrades to its default instead of
+ * discarding an otherwise-usable verdict (the `securityAssessment` precedent in the example
+ * custom-agent package): a model that reports `score` on a 0..100 scale must not cost us the
+ * findings beside it.
+ */
+export declare const judgeVerdictSchema: v.ObjectSchema<{
+    /** How well the work meets the rubric, 0..1 (higher is better). Missing ⇒ 0 (fails). */
+    readonly score: v.SchemaWithFallback<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, 0>;
+    /** The judge's prose justification — what it looked at and why it scored that way. */
+    readonly summary: v.SchemaWithFallback<v.StringSchema<undefined>, "">;
+    /** What the rubric flagged. Empty on a clean verdict. */
+    readonly findings: v.OptionalSchema<v.SchemaWithFallback<v.ArraySchema<v.ObjectSchema<{
+        readonly title: v.SchemaWithFallback<v.StringSchema<undefined>, "Untitled finding">;
+        readonly detail: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly severity: v.SchemaWithFallback<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, "medium">;
+        /** Where the finding applies, when the judge could localise it (`path` or `path:line`). */
+        readonly where: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>, readonly []>, readonly []>;
+}, undefined>;
+export type JudgeVerdict = v.InferOutput<typeof judgeVerdictSchema>;
+/**
+ * What the engine DID with a verdict:
+ *  - `pass`   — at or above the threshold; the run advances.
+ *  - `park`   — a human must decide (the registration's `onFail`, or a spent bounce budget).
+ *  - `bounce` — the preceding producing step was re-armed with the findings as rework.
+ *  - `fail`   — the run was failed with the verdict summary.
+ */
+export declare const judgeDispositionSchema: v.PicklistSchema<["pass", "park", "bounce", "fail"], undefined>;
+export type JudgeDisposition = v.InferOutput<typeof judgeDispositionSchema>;
+/**
+ * The judge step's lifecycle:
+ *  - `evaluating`        — the assessment is running (transient; the driver holds the step).
+ *  - `awaiting_decision` — parked; a human picks proceed / bounce / stop.
+ *  - `bouncing`          — the producer was re-armed; the judge re-runs when it returns.
+ *  - `passed` / `failed` — settled.
+ *  - `skipped`           — no assessor wired (pass-through), or nothing to judge.
+ */
+export declare const judgeStatusSchema: v.PicklistSchema<["evaluating", "awaiting_decision", "bouncing", "passed", "failed", "skipped"], undefined>;
+export type JudgeStatus = v.InferOutput<typeof judgeStatusSchema>;
+/** One completed round of the judge loop (assessment + what the engine did with it). */
+export declare const judgeRoundSchema: v.ObjectSchema<{
+    /** 1-based round number; the first assessment is round 1. */
+    readonly round: v.NumberSchema<undefined>;
+    readonly at: v.NumberSchema<undefined>;
+    readonly verdict: v.ObjectSchema<{
+        /** How well the work meets the rubric, 0..1 (higher is better). Missing ⇒ 0 (fails). */
+        readonly score: v.SchemaWithFallback<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, 0>;
+        /** The judge's prose justification — what it looked at and why it scored that way. */
+        readonly summary: v.SchemaWithFallback<v.StringSchema<undefined>, "">;
+        /** What the rubric flagged. Empty on a clean verdict. */
+        readonly findings: v.OptionalSchema<v.SchemaWithFallback<v.ArraySchema<v.ObjectSchema<{
+            readonly title: v.SchemaWithFallback<v.StringSchema<undefined>, "Untitled finding">;
+            readonly detail: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly severity: v.SchemaWithFallback<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, "medium">;
+            /** Where the finding applies, when the judge could localise it (`path` or `path:line`). */
+            readonly where: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>, readonly []>, readonly []>;
+    }, undefined>;
+    readonly disposition: v.PicklistSchema<["pass", "park", "bounce", "fail"], undefined>;
+    /** The model that produced this round's verdict. */
+    readonly model: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export type JudgeRound = v.InferOutput<typeof judgeRoundSchema>;
+/**
+ * Live judge state carried on the run's judge step — the analogue of `GateStepState`.
+ * Created lazily by the engine on first entry; the rubric itself is NOT persisted here
+ * (only its identity), since a rubric body can be many KB and the step row is re-serialized
+ * on every progress write.
+ */
+export declare const judgeStepStateSchema: v.ObjectSchema<{
+    readonly status: v.PicklistSchema<["evaluating", "awaiting_decision", "bouncing", "passed", "failed", "skipped"], undefined>;
+    /** The rubric's stable id (the registration's, or the overriding fragment's). */
+    readonly rubricId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** The rubric's human name, for the window + the PR report. */
+    readonly rubricName: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** Whether the rubric body came from a workspace fragment override rather than the default. */
+    readonly rubricOverridden: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    /** The most recent verdict; null until the first assessment settles. */
+    readonly verdict: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+        /** How well the work meets the rubric, 0..1 (higher is better). Missing ⇒ 0 (fails). */
+        readonly score: v.SchemaWithFallback<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, 0>;
+        /** The judge's prose justification — what it looked at and why it scored that way. */
+        readonly summary: v.SchemaWithFallback<v.StringSchema<undefined>, "">;
+        /** What the rubric flagged. Empty on a clean verdict. */
+        readonly findings: v.OptionalSchema<v.SchemaWithFallback<v.ArraySchema<v.ObjectSchema<{
+            readonly title: v.SchemaWithFallback<v.StringSchema<undefined>, "Untitled finding">;
+            readonly detail: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly severity: v.SchemaWithFallback<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, "medium">;
+            /** Where the finding applies, when the judge could localise it (`path` or `path:line`). */
+            readonly where: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>, readonly []>, readonly []>;
+    }, undefined>, undefined>, undefined>;
+    /** The score the verdict had to reach, resolved from the task's merge preset. */
+    readonly threshold: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+    /** What the engine did with the most recent verdict. */
+    readonly disposition: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["pass", "park", "bounce", "fail"], undefined>, undefined>, undefined>;
+    /** How many bounce rounds have been spent, and the ceiling from the merge preset. */
+    readonly bounces: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+    readonly maxBounces: v.OptionalSchema<v.NumberSchema<undefined>, 1>;
+    /** The model that produced the most recent verdict. */
+    readonly model: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** Every settled round, oldest first — so the window shows the loop, not just its end. */
+    readonly rounds: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        /** 1-based round number; the first assessment is round 1. */
+        readonly round: v.NumberSchema<undefined>;
+        readonly at: v.NumberSchema<undefined>;
+        readonly verdict: v.ObjectSchema<{
+            /** How well the work meets the rubric, 0..1 (higher is better). Missing ⇒ 0 (fails). */
+            readonly score: v.SchemaWithFallback<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, 0>;
+            /** The judge's prose justification — what it looked at and why it scored that way. */
+            readonly summary: v.SchemaWithFallback<v.StringSchema<undefined>, "">;
+            /** What the rubric flagged. Empty on a clean verdict. */
+            readonly findings: v.OptionalSchema<v.SchemaWithFallback<v.ArraySchema<v.ObjectSchema<{
+                readonly title: v.SchemaWithFallback<v.StringSchema<undefined>, "Untitled finding">;
+                readonly detail: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly severity: v.SchemaWithFallback<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, "medium">;
+                /** Where the finding applies, when the judge could localise it (`path` or `path:line`). */
+                readonly where: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            }, undefined>, undefined>, readonly []>, readonly []>;
+        }, undefined>;
+        readonly disposition: v.PicklistSchema<["pass", "park", "bounce", "fail"], undefined>;
+        /** The model that produced this round's verdict. */
+        readonly model: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>, readonly []>;
+    /**
+     * Why the judge is `skipped`, or why a disposition degraded (e.g. a `bounce` with no
+     * preceding producing step to bounce to). Surfaced verbatim in the window + PR report,
+     * because a judge that quietly did nothing is indistinguishable from one that passed.
+     */
+    readonly note: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** The human's resolution of a park, once made. */
+    readonly resolution: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+        readonly choice: v.PicklistSchema<["proceed", "bounce", "stop"], undefined>;
+        readonly feedback: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly at: v.NumberSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
+}, undefined>;
+export type JudgeStepState = v.InferOutput<typeof judgeStepStateSchema>;
+/**
+ * Resolve a parked judge:
+ *  - `proceed` — advance despite the verdict (the human overrules the rubric);
+ *  - `bounce`  — spend a rework round on the producing step, even past the budget;
+ *  - `stop`    — fail the run.
+ * `feedback` is folded into a `bounce`'s rework brief (and recorded either way).
+ */
+export declare const resolveJudgeSchema: v.ObjectSchema<{
+    readonly choice: v.PicklistSchema<["proceed", "bounce", "stop"], undefined>;
+    readonly feedback: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 4000, undefined>]>, undefined>, undefined>;
+}, undefined>;
+export type ResolveJudgeInput = v.InferOutput<typeof resolveJudgeSchema>;
+/** Parse-or-throw a verdict payload an assessment returned (the engine validates it). */
+export declare function parseJudgeVerdict(value: unknown): JudgeVerdict;
+//# sourceMappingURL=judge.d.ts.map

package/dist/judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge.d.ts","sourceRoot":"","sources":["../src/judge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAoB5B,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C,oFAAoF;AACpF,eAAO,MAAM,yBAAyB,IAAI,CAAA;AAE1C,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,oEAAoD,CAAA;AAC3F,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;IAI7B,2FAA2F;;aAE3F,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB;IAC7B,wFAAwF;;IAExF,sFAAsF;;IAEtF,yDAAyD;;;;;QArBzD,2FAA2F;;;aAuB3F,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,iEAAiD,CAAA;AACpF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,6GAO5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE,wFAAwF;AACxF,eAAO,MAAM,gBAAgB;IAC3B,6DAA6D;;;;QAvC7D,wFAAwF;;QAExF,sFAAsF;;QAEtF,yDAAyD;;;;;YArBzD,2FAA2F;;;;;IA6D3F,oDAAoD;;aAEpD,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;IAE/B,iFAAiF;;IAEjF,+DAA+D;;IAE/D,+FAA+F;;IAE/F,wEAAwE;;QA/DxE,wFAAwF;;QAExF,sFAAsF;;QAEtF,yDAAyD;;;;;YArBzD,2FAA2F;;;;IAkF3F,iFAAiF;;IAEjF,wDAAwD;;IAExD,qFAAqF;;;IAGrF,uDAAuD;;IAEvD,0FAA0F;;QAnC1F,6DAA6D;;;;YAvC7D,wFAAwF;;YAExF,sFAAsF;;YAEtF,yDAAyD;;;;;gBArBzD,2FAA2F;;;;;QA6D3F,oDAAoD;;;IAgCpD;;;;OAIG;;IAEH,mDAAmD;;;;;;aAUnD,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAIvE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;aAG7B,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAExE,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAE9D"}