@farmslot/protocol 0.59.0 → 0.61.0

package/CHANGELOG.md

@@ -6,6 +6,20 @@ All notable changes to `@farmslot/protocol` are tracked here.
 
 - Active-development baseline; add user-facing changes here before release or package publication.
 
+## 0.61.0 - 2026-10-21
+
+- A review lineage no longer needs a PR (ADR-063 Amendment 5): `ReviewContinuationContext` makes `repository`/`prNumber` optional and adds the run `familyId`. `ReviewSessionTrace.fallback` (`ReviewSessionFallback`) records why a re-review ran a delta-scoped COLD and the ranges it compared, and `AgentContext.reviewFallback` keeps it for a reattach after a restart, with the new `reviewed-head-not-ancestor` refusal reason. `ReadyGatePayload.reviewLineageOptions` (`ReviewLineageOption`) lists the lineages a gate Request Review can continue and whether each session is available.
+- `gateActionsForReadiness`, `gateReasonsForAction`, `advancingGateAction` and `acceptReviewFindingsAvailable` are exported: the one gate action availability rule the gateway and clients share. `RunGateReadiness` adds `findings` and `findingsDigest`; the publication approval adds `acceptedFindings`, `reason`, `headSha` and `approver`; `run.resolveDecision` takes `findingsDigest`, which `buildRunResolveDecisionParams` fills in for `approve-publish-unresolved` (ADR-065 Amendment 8).
+- `RuntimeCapabilityLease.cleanupUnreachable` holds the `cleanupFailure` of a release action that could not reach the slot's node. The gateway retries that cleanup when the node reconnects.
+- `VIEW_QUERY_PARAMETERS` accepts the evidence review's `review`, `reviewFile`, `reviewAt` and `reviewCheck`, so a shared review link opens on the same criterion, file, moment and step check.
+
+## 0.60.0 - 2026-10-20
+
+- `reasonWithoutRemedy(message, spent)` is exported: the wording a gate reason keeps when its remedy is not offered, shared by clients and the gateway.
+- HUD readability (ADR-034 Amendment 7): `hudIntentDisplay` web style draws the intent at 16px/20px, weight 600, with no clamp, ellipsis or max height; native keeps two lines at 13px/17px (`HUD_NATIVE_INTENT_*`). `HUD_INTENT_MAX_LINES` is a nominal 3, `HUD_PANEL_BOUNDS.card` is 500px wide and web heights are nominal. New `hudFinishedLine` returns the discreet `✓`/`✗` line for the step that just finished, with `HUD_FINISHED_*`, `HUD_NATIVE_FINISHED_*` and `HUD_COLORS`.
+- `gateWaitReason(decision)`, `gateDisplayReasons(decision)` and their `GateDecisionFields` input are exported, so every screen derives an open gate's actionable reason from one rule. A listed reason whose remedy the gate does not offer keeps its finding, not the instruction.
+- A blocked run whose human gate decision is open reads `Needs your decision` with the gate's first readiness reason whose action the gate offers (`Review rounds spent: N issues open` when fixing is no longer offered) (`deriveRunLifecycleView`, `runStepDisplayStatus`/`Detail`, new `runDisplayStatus`), instead of Blocked; its gate step is not marked blocked. A `human-gating` run at its open gate gets the same label and badge. A blocked run with no open gate still reads Blocked. `openHumanGateDecision`, `HUMAN_GATE_DECISION_TYPE` and `isBlockedAtOpenHumanGate` are shared here (Companion and CC reuse them).
+
 ## 0.59.0 - 2026-10-19
 
 - `Run.reviewRoundSettlements` records reviewer attempts that ended without a verdict. `ReviewRoundBudget` adds `noVerdict` and `noVerdictLimit` (`REVIEW_NO_VERDICT_LIMIT`, 3), and `reviewRoundBudgetLabel` formats the gate line with the no-verdict count once there is one (ADR-063 Amendment 2). `RunEngineState.workspaceReviewDispatchGeneration` records the engine generation a workspace review admitted its round at.

package/dist/contracts/agents.d.ts

@@ -100,6 +100,8 @@ export interface AgentContext {
     /** Durable reviewer lineage, supplied by the review runtime. */
     reviewId?: string;
     reviewLoopNumber?: number | null;
+    /** Why this reviewer runs a delta-scoped COLD in a fresh session; a reattach reports it again. */
+    reviewFallback?: import('./runs.js').ReviewSessionFallback;
     /** Gateway validation completed for the structured reviewer result and archived artifacts. */
     reviewResultValidatedAt?: string;
     pipelineVisualReviewInput?: import('../recipe/pipeline-visual-judgments.js').PipelineReviewInput;

package/dist/contracts/agents.d.ts.map

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

package/dist/contracts/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/contracts/agents.ts"],"names":[],"mappings":"AAuDA,kGAAkG;AAClG,MAAM,UAAU,yBAAyB,CACvC,OAA+C;IAE/C,OAAO,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,KAAK;IACL,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,4EAA4E;IAC5E,8EAA8E;IAC9E,+DAA+D;IAC/D,SAAS;CACD,CAAC;AA4LX,wEAAwE;AACxE,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC/D,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IACzC,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,QAAQ,CAAC;IACnE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAClG,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/contracts/agents.ts"],"names":[],"mappings":"AAuDA,kGAAkG;AAClG,MAAM,UAAU,yBAAyB,CACvC,OAA+C;IAE/C,OAAO,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,KAAK;IACL,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,4EAA4E;IAC5E,8EAA8E;IAC9E,+DAA+D;IAC/D,SAAS;CACD,CAAC;AA8LX,wEAAwE;AACxE,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC/D,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IACzC,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,QAAQ,CAAC;IACnE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAClG,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/contracts/reviews.d.ts

@@ -126,6 +126,6 @@ export interface PRReviewComment {
     updatedAt: string;
 }
 export { APPROVE_PUBLISH_UNRESOLVED_ACTION, latestExhaustedReview, latestReview, reviewFixRetriesExhausted, reviewRetryCapReason, reviewRetryCount, stampReviewRetryCap, } from '../runs/review-retries.js';
-export type { CommentsTriageSummary, PublicationStatus, PublicationTarget, ReviewAttempt, ReviewContinuationContext, ReviewDiffSnapshot, ReviewFixDeltaSnapshot, ReviewGatePayload, ReviewLineComment, ReviewLoopTimelineSegment, ReviewLoopTimelineSegmentKind, ReviewMode, ReviewPolicy, ReviewRequestContext, ReviewRequestPayload, ReviewRunnerId, ReviewSelection, ReviewSequence, ReviewSessionRefusalReason, ReviewSessionTrace, ReviewStatus, ReviewValidationDepth, RunnerSessionUsage, } from './runs.js';
+export type { CommentsTriageSummary, PublicationStatus, PublicationTarget, ReviewAttempt, ReviewContinuationContext, ReviewDiffSnapshot, ReviewFixDeltaSnapshot, ReviewGatePayload, ReviewLineageOption, ReviewLineComment, ReviewLoopTimelineSegment, ReviewLoopTimelineSegmentKind, ReviewMode, ReviewPolicy, ReviewRequestContext, ReviewRequestPayload, ReviewRunnerId, ReviewSelection, ReviewSequence, ReviewSessionFallback, ReviewSessionRefusalReason, ReviewSessionTrace, ReviewStatus, ReviewValidationDepth, RunnerSessionUsage, } from './runs.js';
 export { DEFAULT_REVIEW_MODE, isReviewMode, isReviewValidationDepth, REVIEW_MODES, REVIEW_VALIDATION_DEPTHS, reviewValidationDepthForLoop, } from './runs.js';
 //# sourceMappingURL=reviews.d.ts.map

package/dist/contracts/reviews.d.ts.map

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

package/dist/contracts/reviews.js.map

@@ -1 +1 @@
-{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../src/contracts/reviews.ts"],"names":[],"mappings":"AAmJA,8EAA8E;AAC9E,OAAO,EACL,iCAAiC,EACjC,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AA0BnC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,YAAY,EACZ,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC"}
+{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../src/contracts/reviews.ts"],"names":[],"mappings":"AAmJA,8EAA8E;AAC9E,OAAO,EACL,iCAAiC,EACjC,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AA4BnC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,YAAY,EACZ,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC"}

package/dist/contracts/run-gate-readiness.d.ts

@@ -46,10 +46,23 @@ export interface RunGateInputIdentity {
     headSha?: string | null;
     packageHash?: string | null;
 }
+/** An open finding at the package head, as its review's structured result recorded it. */
+export interface GateReviewFinding {
+    reviewId: string;
+    file: string;
+    line?: number;
+    description: string;
+}
 export interface RunGateReadiness {
     state: 'collecting' | 'not-ready' | 'ready';
     identity: RunGateInputIdentity;
     reasons: RunGatePrerequisiteReason[];
+    /**
+     * The head's open findings, present only when every review reporting one returned a
+     * valid structured result. Accepting them echoes `findingsDigest` (ADR-065 Amendment 8).
+     */
+    findings?: GateReviewFinding[];
+    findingsDigest?: string;
 }
 /** Gate payloads whose advancing actions require the shared prerequisite evaluation. */
 export declare function isPrerequisiteGatePayload(payload?: RunDecisionPayload): payload is ReadyGatePayload | ReviewGatePayload | NoChangeGatePayload;

package/dist/contracts/run-gate-readiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-gate-readiness.d.ts","sourceRoot":"","sources":["../../src/contracts/run-gate-readiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,8EAA8E;IAC9E,cAAc,CAAC,EAAE,mBAAmB,GAAG,eAAe,GAAG,mBAAmB,CAAC;CAC9E;AAED,MAAM,MAAM,4BAA4B,GACpC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,YAAY,CAAC,EAAE,KAAK,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,2BAA2B,GAAG,4BAA4B,GAAG;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CActC;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,2BAA2B,EACjC,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAMT;AAED,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,2BAA2B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,yBAAyB,EAAE,CAAC;CAC5C;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;IAC5C,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,IAAI,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,CAEvE"}
+{"version":3,"file":"run-gate-readiness.d.ts","sourceRoot":"","sources":["../../src/contracts/run-gate-readiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,8EAA8E;IAC9E,cAAc,CAAC,EAAE,mBAAmB,GAAG,eAAe,GAAG,mBAAmB,CAAC;CAC9E;AAED,MAAM,MAAM,4BAA4B,GACpC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,YAAY,CAAC,EAAE,KAAK,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,2BAA2B,GAAG,4BAA4B,GAAG;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CActC;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,2BAA2B,EACjC,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAMT;AAED,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,2BAA2B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,yBAAyB,EAAE,CAAC;CAC5C;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,0FAA0F;AAC1F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;IAC5C,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,IAAI,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,CAEvE"}

package/dist/contracts/run-gate-readiness.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-gate-readiness.js","sourceRoot":"","sources":["../../src/contracts/run-gate-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAuC/C,mGAAmG;AACnG,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC,CAAC,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;YACtC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YAClC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC;YACpC,CAAC,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ;gBACxC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;gBACrC,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,IAAiC,EACjC,KAAkC;IAElC,OAAO,CACL,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QACtC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY;QACxC,IAAI,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,CAC/C,CAAC;AACJ,CAAC;AA6BD,wFAAwF;AACxF,MAAM,UAAU,yBAAyB,CACvC,OAA4B;IAE5B,OAAO,OAAO,EAAE,IAAI,KAAK,OAAO,IAAI,OAAO,EAAE,IAAI,KAAK,QAAQ,IAAI,OAAO,EAAE,IAAI,KAAK,WAAW,CAAC;AAClG,CAAC"}
+{"version":3,"file":"run-gate-readiness.js","sourceRoot":"","sources":["../../src/contracts/run-gate-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAuC/C,mGAAmG;AACnG,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC,CAAC,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;YACtC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YAClC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC;YACpC,CAAC,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ;gBACxC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;gBACrC,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,IAAiC,EACjC,KAAkC;IAElC,OAAO,CACL,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QACtC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY;QACxC,IAAI,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,CAC/C,CAAC;AACJ,CAAC;AA2CD,wFAAwF;AACxF,MAAM,UAAU,yBAAyB,CACvC,OAA4B;IAE5B,OAAO,OAAO,EAAE,IAAI,KAAK,OAAO,IAAI,OAAO,EAAE,IAAI,KAAK,QAAQ,IAAI,OAAO,EAAE,IAAI,KAAK,WAAW,CAAC;AAClG,CAAC"}

package/dist/contracts/run-lifecycle-view.d.ts

@@ -12,12 +12,51 @@ export interface RunLifecycleView {
     canAdvance: boolean;
     reasons: readonly RunGatePrerequisiteReason[];
 }
+export declare const HUMAN_GATE_DECISION_TYPE = "engine_human_gate";
+/** The fields of a run decision the lifecycle view reads. */
+export type GateDecisionFields = {
+    type: string;
+    resolvedAt?: string;
+    payload?: unknown;
+    actions?: readonly {
+        id: string;
+    }[];
+};
+/** The run's latest unresolved human gate, if any. */
+export declare function openHumanGateDecision<D extends GateDecisionFields>(run: {
+    decisions?: readonly D[];
+} | null | undefined): D | null;
+/** A blocked run whose latest human gate is open: it waits at the gate, not on a fault. */
+export declare function isBlockedAtOpenHumanGate(run: {
+    status: RunStatus;
+    decisions?: readonly GateDecisionFields[];
+}): boolean;
+/**
+ * A reason whose remedy the gate does not offer keeps its finding, not the instruction:
+ * with the review rounds spent it reads `Review rounds spent: N issues open`, otherwise
+ * its first sentence. The gateway words its review-fix reason with it too.
+ */
+export declare function reasonWithoutRemedy(message: string, spent: boolean): string;
+/**
+ * The gate's reason a person can act on: the first readiness reason whose action the
+ * gate offers. When that first reason's own remedy is not offered because the review
+ * rounds are spent, it says so with the open issue count instead.
+ */
+export declare function gateWaitReason(decision: GateDecisionFields): string | undefined;
+/** The gate's readiness reasons as screens list them, by the same rule as gateWaitReason. */
+export declare function gateDisplayReasons(decision: GateDecisionFields): RunGatePrerequisiteReason[];
+/** A run's status as a badge shows it: a run at its open human gate needs a decision. */
+export declare function runDisplayStatus(run: {
+    status: RunStatus;
+    decisions?: readonly GateDecisionFields[];
+}): string;
 /** Both clients and the CLI present the gateway's state and prerequisite reasons. */
 export declare function deriveRunLifecycleView(input: {
     status: RunStatus;
     gateReadiness?: unknown;
     waitingForOperator?: WorkerOperatorWait;
     error?: string | null;
+    decisions?: readonly GateDecisionFields[];
 }): RunLifecycleView;
 /** A blocked run's reason on one line: the first non-empty line of its error. */
 export declare function blockedRunReason(error?: string | null): string | undefined;
@@ -25,16 +64,22 @@ export declare function blockedRunReason(error?: string | null): string | undefi
  * The status a client shows for a run's step. A cancelled run's unfinished steps
  * read as skipped. The engine records the step a blocked run stopped at as done
  * and every later step as skipped, which reads as a finished run, so that step
- * (the last one neither pending nor skipped) shows as blocked.
+ * (the last one neither pending nor skipped) shows as blocked. A run waiting at its
+ * open human gate keeps that step as it is.
  */
 export declare function runStepDisplayStatus(run: {
     status: RunStatus;
     steps: readonly Pick<RunStep, 'name' | 'status'>[];
+    decisions?: readonly GateDecisionFields[];
 }, step: Pick<RunStep, 'name' | 'status'>): RunStepDisplayStatus;
-/** A step's detail as clients show it: a blocked run's reason on the step it stopped at. */
+/**
+ * A step's detail as clients show it: a blocked run's reason on the step it stopped
+ * at, and the gate's readiness reason on a human gate that waits for a decision.
+ */
 export declare function runStepDisplayDetail(run: {
     status: RunStatus;
     steps: readonly Pick<RunStep, 'name' | 'status'>[];
     error?: string | null;
+    decisions?: readonly GateDecisionFields[];
 }, step: Pick<RunStep, 'name' | 'status' | 'detail'>): string | undefined;
 //# sourceMappingURL=run-lifecycle-view.d.ts.map

package/dist/contracts/run-lifecycle-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-lifecycle-view.d.ts","sourceRoot":"","sources":["../../src/contracts/run-lifecycle-view.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,yBAAyB,EAAoB,MAAM,yBAAyB,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEnE,wFAAwF;AACxF,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC/C;AAyBD,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GAAG,gBAAgB,CA+CnB;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAK1E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAA;CAAE,EAC9E,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,GACrC,oBAAoB,CAUtB;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAClC,GAAG,EAAE;IACH,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,SAAS,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,EACD,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAChD,MAAM,GAAG,SAAS,CAIpB"}
+{"version":3,"file":"run-lifecycle-view.d.ts","sourceRoot":"","sources":["../../src/contracts/run-lifecycle-view.ts"],"names":[],"mappings":"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"}

package/dist/contracts/run-lifecycle-view.js

@@ -21,9 +21,89 @@ const labels = {
     failed: 'Failed',
     cancelled: 'Cancelled',
 };
+export const HUMAN_GATE_DECISION_TYPE = 'engine_human_gate';
+const NEEDS_YOUR_DECISION = 'Needs your decision';
+/** The run's latest unresolved human gate, if any. */
+export function openHumanGateDecision(run) {
+    const decisions = run?.decisions ?? [];
+    for (let index = decisions.length - 1; index >= 0; index -= 1) {
+        const decision = decisions[index];
+        if (decision.type === HUMAN_GATE_DECISION_TYPE && !decision.resolvedAt)
+            return decision;
+    }
+    return null;
+}
+/** A blocked run whose latest human gate is open: it waits at the gate, not on a fault. */
+export function isBlockedAtOpenHumanGate(run) {
+    return run.status === 'blocked' && openHumanGateDecision(run) !== null;
+}
+/**
+ * A run at its open human gate waits for a person's decision. The gateway marks it
+ * blocked while the gate is not ready, which is not a fault: it reads as needing a
+ * decision, with the gate's first readiness reason.
+ */
+function gateDecisionWait(run) {
+    if (run.status !== 'blocked' && run.status !== 'human-gating')
+        return undefined;
+    const decision = openHumanGateDecision(run);
+    if (!decision)
+        return undefined;
+    const reason = gateWaitReason(decision);
+    return reason ? { reason } : {};
+}
+/** A decision's readiness reasons, which of them the gate offers a remedy for, and its review budget. */
+function gateReasons(decision) {
+    const payload = isRecord(decision.payload) ? decision.payload : undefined;
+    const readiness = payload?.gateReadiness;
+    const offered = new Set(decision.actions?.map((action) => action.id));
+    const budget = isRecord(payload?.reviewRoundBudget) ? payload.reviewRoundBudget : undefined;
+    return {
+        reasons: isGateReadiness(readiness) ? readiness.reasons : [],
+        actionable: (reason) => !reason.actionId || offered.has(reason.actionId),
+        spent: budget?.remaining === 0,
+    };
+}
+/**
+ * A reason whose remedy the gate does not offer keeps its finding, not the instruction:
+ * with the review rounds spent it reads `Review rounds spent: N issues open`, otherwise
+ * its first sentence. The gateway words its review-fix reason with it too.
+ */
+export function reasonWithoutRemedy(message, spent) {
+    if (spent) {
+        const issues = /\d+ issues?/.exec(message)?.[0];
+        return issues ? `Review rounds spent: ${issues} open` : 'Review rounds spent';
+    }
+    return message.split(/(?<=\.)\s/)[0] ?? message;
+}
+/**
+ * The gate's reason a person can act on: the first readiness reason whose action the
+ * gate offers. When that first reason's own remedy is not offered because the review
+ * rounds are spent, it says so with the open issue count instead.
+ */
+export function gateWaitReason(decision) {
+    const { reasons, actionable, spent } = gateReasons(decision);
+    const [first] = reasons;
+    if (!first || actionable(first))
+        return first?.message;
+    if (spent)
+        return reasonWithoutRemedy(first.message, true);
+    return reasons.find(actionable)?.message ?? reasonWithoutRemedy(first.message, false);
+}
+/** The gate's readiness reasons as screens list them, by the same rule as gateWaitReason. */
+export function gateDisplayReasons(decision) {
+    const { reasons, actionable, spent } = gateReasons(decision);
+    return reasons.map((reason) => actionable(reason)
+        ? reason
+        : { ...reason, message: reasonWithoutRemedy(reason.message, spent) });
+}
+/** A run's status as a badge shows it: a run at its open human gate needs a decision. */
+export function runDisplayStatus(run) {
+    return gateDecisionWait(run) ? NEEDS_YOUR_DECISION : run.status;
+}
 /** Both clients and the CLI present the gateway's state and prerequisite reasons. */
 export function deriveRunLifecycleView(input) {
     const blockedReason = blockedRunReason(input.error);
+    const gateWait = gateDecisionWait(input);
     const readiness = isGateReadiness(input.gateReadiness) ? input.gateReadiness : undefined;
     const canAdvance = readiness?.state === 'ready' && input.status === 'human-gating';
     const tone = input.status === 'done'
@@ -44,14 +124,20 @@ export function deriveRunLifecycleView(input) {
                     : 'running';
     return {
         status: input.status,
-        label: labels[input.status],
-        ...(input.status === 'blocked'
-            ? { activityLabel: blockedReason ? `Blocked: ${blockedReason}` : labels.blocked }
-            : input.waitingForOperator && ['monitoring', 'reviewing', 'fixing'].includes(input.status)
-                ? { activityLabel: `Waiting on operator: ${input.waitingForOperator.who}` }
-                : ['fixing', 'review-failed', 'reconciling', 'needs-decision'].includes(input.status)
-                    ? { activityLabel: labels[input.status] }
-                    : {}),
+        label: gateWait ? NEEDS_YOUR_DECISION : labels[input.status],
+        ...(gateWait && input.status === 'blocked'
+            ? {
+                activityLabel: gateWait.reason
+                    ? `${NEEDS_YOUR_DECISION}: ${gateWait.reason}`
+                    : NEEDS_YOUR_DECISION,
+            }
+            : input.status === 'blocked'
+                ? { activityLabel: blockedReason ? `Blocked: ${blockedReason}` : labels.blocked }
+                : input.waitingForOperator && ['monitoring', 'reviewing', 'fixing'].includes(input.status)
+                    ? { activityLabel: `Waiting on operator: ${input.waitingForOperator.who}` }
+                    : ['fixing', 'review-failed', 'reconciling', 'needs-decision'].includes(input.status)
+                        ? { activityLabel: labels[input.status] }
+                        : {}),
         tone,
         ...(readiness
             ? {
@@ -79,10 +165,12 @@ export function blockedRunReason(error) {
  * The status a client shows for a run's step. A cancelled run's unfinished steps
  * read as skipped. The engine records the step a blocked run stopped at as done
  * and every later step as skipped, which reads as a finished run, so that step
- * (the last one neither pending nor skipped) shows as blocked.
+ * (the last one neither pending nor skipped) shows as blocked. A run waiting at its
+ * open human gate keeps that step as it is.
  */
 export function runStepDisplayStatus(run, step) {
     if (run.status === 'blocked' &&
+        !isBlockedAtOpenHumanGate(run) &&
         step.name ===
             [...run.steps].reverse().find((s) => s.status !== 'pending' && s.status !== 'skipped')?.name)
         return 'blocked';
@@ -90,8 +178,14 @@ export function runStepDisplayStatus(run, step) {
         return 'skipped';
     return step.status;
 }
-/** A step's detail as clients show it: a blocked run's reason on the step it stopped at. */
+/**
+ * A step's detail as clients show it: a blocked run's reason on the step it stopped
+ * at, and the gate's readiness reason on a human gate that waits for a decision.
+ */
 export function runStepDisplayDetail(run, step) {
+    const gateWait = step.name === 'human-gate' && step.status === 'running' && gateDecisionWait(run);
+    if (gateWait)
+        return gateWait.reason ?? step.detail;
     return runStepDisplayStatus(run, step) === 'blocked'
         ? (blockedRunReason(run.error) ?? step.detail)
         : step.detail;

package/dist/contracts/run-lifecycle-view.js.map

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

package/dist/contracts/runs.d.ts

@@ -11,7 +11,7 @@ import type { EvidenceQualityReport, RecipeQualityArtifact } from './recipes.js'
 import type { ResourcePostureWaitPolicy, RunResourcePostureState } from './resource-posture.js';
 import type { ResourceType } from './resources.js';
 import type { RunArtifactBundleRef, RunImportProvenance } from './run-bundles.js';
-import type { EvidencePolicyAttestation, RunGatePrerequisiteReason, RunGateReadiness } from './run-gate-readiness.js';
+import type { EvidenceAttestationApprover, EvidencePolicyAttestation, GateReviewFinding, RunGatePrerequisiteReason, RunGateReadiness } from './run-gate-readiness.js';
 import type { RuntimeCapabilityProofRequirement } from './runtime-capabilities.js';
 import type { SlotHealth } from './slots.js';
 import type { SubtaskSource } from './task.js';
@@ -187,11 +187,27 @@ export interface ReviewSelection {
 }
 /** Ordered reviewer selections. Array order is the execution order. */
 export type ReviewSequence = ReviewSelection[];
-/** Trusted request provenance, separate from the four configurable choices. */
+/**
+ * Trusted request provenance, separate from the four configurable choices. A lineage is
+ * keyed by its run family and `reviewId`; the PR is checked once both sides have one.
+ */
 export interface ReviewContinuationContext {
-    repository: string;
-    prNumber: number;
+    repository?: string;
+    prNumber?: number;
     reviewId: string;
+    /** Run family the lineage belongs to; it never continues in another family. */
+    familyId?: string;
+}
+/** A review lineage a gate request can continue, as the gateway sees it (ADR-063 Amendment 5). */
+export interface ReviewLineageOption {
+    context: ReviewContinuationContext;
+    runner: string;
+    model: string | null;
+    effort: string | null;
+    /** When the lineage last reviewed. */
+    reviewedAt: string;
+    /** Why its retained session can't continue on this run; absent when it can. */
+    unavailableReason?: string;
 }
 /** Context rows align with the complete sequence, including the first request row. */
 export interface ReviewRequestContext {
@@ -208,7 +224,17 @@ export declare function isReviewValidationDepth(value: unknown): value is Review
 export declare function reviewValidationDepthForLoop(_index: number, _total: number): ReviewValidationDepth;
 /** Observed launch provenance, kept separate from user selection. */
 export type ReviewSessionContinuity = 'fresh' | 'resumed' | 'resume-unconfirmed' | 'refused';
-export type ReviewSessionRefusalReason = 'unsupported-runner' | 'repository-mismatch' | 'pr-mismatch' | 'slot-mismatch' | 'runner-mismatch' | 'model-mismatch' | 'effort-mismatch' | 'missing-session' | 'missing-reviewed-head' | 'session-busy' | 'session-unavailable';
+export type ReviewSessionRefusalReason = 'unsupported-runner' | 'repository-mismatch' | 'pr-mismatch' | 'slot-mismatch' | 'runner-mismatch' | 'model-mismatch' | 'effort-mismatch' | 'missing-session' | 'missing-reviewed-head' | 'session-busy' | 'session-unavailable' | 'reviewed-head-not-ancestor';
+/** Why a re-review ran COLD in a fresh session, and the ranges it compared (ADR-063 Amendment 5). */
+export interface ReviewSessionFallback {
+    reason: ReviewSessionRefusalReason;
+    detail: string;
+    /**
+     * `lastReviewedHead..currentHead`. After a rebase, the branch's own change at both
+     * heads (`mergeBase..head`), compared with `git range-diff`.
+     */
+    comparedRanges: string[];
+}
 export interface ReviewSessionTrace {
     mode: ReviewMode;
     continuity: ReviewSessionContinuity;
@@ -224,6 +250,8 @@ export interface ReviewSessionTrace {
     priorSessionId?: string;
     sessionId?: string;
     refusalReason?: ReviewSessionRefusalReason;
+    /** Set when a re-review's retained session was unavailable and it ran a delta-scoped COLD. */
+    fallback?: ReviewSessionFallback;
 }
 /** Frozen summary for one run in a repeated-PR review chain. */
 export interface ReviewChainEntry {
@@ -795,6 +823,8 @@ export interface ReadyGatePayload {
     };
     reviewPolicy?: ReviewPolicy;
     reviews?: ReviewStatus[];
+    /** Lineages a Request Review can continue, most recent first, with their session's availability. */
+    reviewLineageOptions?: ReviewLineageOption[];
     reviewLaunchRejection?: PublicationReviewLaunchRejection;
     gatePolicy?: GatePolicy;
     /** Consolidated "what happened to reach this gate" snapshot (worker → reviews → cost). */
@@ -1245,6 +1275,14 @@ export interface RunDecision {
         visualJudgmentReceiptIds: string[];
         claimOverrideReceiptIds: string[];
         approvedAt: string;
+        /** Accept Review Findings and Publish only (ADR-065 Amendment 8). */
+        acceptedFindings?: {
+            findings: GateReviewFinding[];
+            digest: string;
+        };
+        reason?: string;
+        headSha?: string;
+        approver?: EvidenceAttestationApprover;
     };
     /** Completed failure-triage assessment consulted at resolution, without implied causation. */
     triageAssessmentId?: string;