opencode-swarm 7.126.5 → 7.127.0

package/dist/hooks/pr-workflow-gate.d.ts

@@ -1,13 +1,47 @@
 import * as fsp from 'node:fs/promises';
-import { resolveCommitCountSince, resolveCurrentGitHead, resolveCurrentUpstreamPushTarget, resolveCurrentUpstreamRemoteRef, resolveExactRemoteBranchHead, resolveIsExactSingleChildCommit, resolveIsWorkingTreeClean, resolvePrWorkflowRevisionDigest, resolveRemoteRefsContainingHead } from '../background/workspace-snapshot.js';
+import { resolveCommitCountSince, resolveCurrentGitHead, resolveCurrentUpstreamPushTarget, resolveCurrentUpstreamRemoteRef, resolveExactRemoteBranchHead, resolveIsExactSingleChildCommit, resolveIsWorkingTreeClean, resolvePrReviewDiffStats, resolvePrWorkflowRevisionDigest, resolveRemoteRefsContainingHead } from '../background/workspace-snapshot.js';
 export declare const PR_REVIEW_BASE_DIMENSION_IDS: readonly ["intent-architecture", "correctness-state", "tests-falsifiability", "security-trust", "reliability-performance", "compatibility-delivery"];
 export declare const PR_REVIEW_REQUIRED_MICRO_LANE_IDS: readonly ["auth-identity-secrets", "untrusted-input-boundaries", "subprocess-platform", "concurrency-state", "dependencies-build-release", "api-schema-migrations", "test-infrastructure", "ui-accessibility-i18n", "privacy-observability", "generated-provenance", "unclassified-risk"];
 export type PrReviewBaseDimensionId = (typeof PR_REVIEW_BASE_DIMENSION_IDS)[number];
 export type PrWorkflowMode = 'PR_REVIEW' | 'PR_FEEDBACK';
+export type PrReviewDepthTier = 'S' | 'M' | 'L';
+/**
+ * Objective size thresholds for the controller-computed PR-review depth tier.
+ * Risk-trigger escalation is semantic and stays caller-side: callers may
+ * always dispatch more lanes than a tier's floor, never fewer.
+ */
+export declare const PR_REVIEW_DEPTH_TIER_THRESHOLDS: {
+    readonly smallMaxChangedLines: 50;
+    readonly smallMaxChangedFiles: 3;
+    readonly mediumMaxChangedLines: 500;
+    readonly mediumMaxChangedFiles: 20;
+};
+/**
+ * Minimum initial base-wave lane counts per depth tier. Tier L preserves the
+ * historical exact-six singleton wave; S/M permit consolidated lanes that own
+ * multiple dimensions while every dimension stays mandatory to evaluate.
+ */
+export declare const PR_REVIEW_BASE_LANE_FLOORS: Record<PrReviewDepthTier, number>;
+/**
+ * Unknown or uncomputable diff size fails strict to the deepest tier, as does
+ * any range containing a submodule pointer change: git's numstat reports a
+ * gitlink bump as a fixed 1-added/1-deleted row regardless of the referenced
+ * repository's actual diff size, so no line/file threshold can bound it.
+ */
+export declare function computePrReviewDepthTier(stats: {
+    changedLines: number;
+    changedFiles: number;
+    hasSubmoduleChange?: boolean;
+} | null | undefined): PrReviewDepthTier;
 export interface PrWorkflowLaneSpec {
     laneId?: string;
     workflowLane?: string;
     reviewItemIds?: string[];
+    /**
+     * Complete dimension/family set this lane covers under a consolidated depth
+     * tier. Must contain workflowLane. Absent means the singleton [workflowLane].
+     */
+    ownedWorkflowLanes?: string[];
 }
 export interface PrFeedbackLaneOwnership {
     laneId: string;
@@ -18,6 +52,7 @@ interface PrReviewBaseDispatchRecord {
     lanes: Array<{
         laneId: string;
         workflowLane: PrReviewBaseDimensionId;
+        ownedWorkflowLanes?: PrReviewBaseDimensionId[];
     }>;
     validatedAt: string;
 }
@@ -115,6 +150,14 @@ export interface PrWorkflowGateState {
     prHeadSha?: string;
     prReviewBaseRef?: string;
     prReviewBaseSha?: string;
+    /** Controller-computed size tier for the bound merge-base scope. */
+    prReviewDepthTier?: PrReviewDepthTier;
+    /** Audit record of the bounded numstat totals behind prReviewDepthTier. */
+    prReviewDiffStats?: {
+        changedLines: number;
+        changedFiles: number;
+        hasSubmoduleChange: boolean;
+    };
     prReviewBaseDispatches?: PrReviewBaseDispatchRecord[];
     /** @deprecated Compatibility projection of the most recent base dispatch. */
     prReviewBaseDispatch?: PrReviewBaseDispatchRecord;
@@ -188,7 +231,18 @@ export declare function bindPrReviewBase(directory: string, sessionID: string, o
     baseRef: string;
     baseSha: string;
 }): Promise<PrWorkflowGateState>;
-/** Prove that caller-provided PR identity equals the actual checked-out commit. */
+/**
+ * Prove that caller-provided PR identity equals the actual checked-out commit.
+ *
+ * Two distinct failure modes are reported with separate, diagnostic-rich
+ * messages (issue #1931): a null HEAD means Git could not resolve HEAD at all
+ * (the directory may not be a repository, HEAD may be unborn, the commit may
+ * be missing from a shallow clone, the `git` binary may not be on PATH, or
+ * the bounded Git invocation may have timed out); a non-matching HEAD means
+ * a different commit is checked out. Both messages name `directory` and the
+ * exact remediation command so callers can self-diagnose instead of
+ * cascading into fictional root causes.
+ */
 export declare function assertCurrentCheckoutHead(directory: string, expectedHead: string): string;
 /** Prove that every PR-review lane reads the immutable checked-out PR tree. */
 export declare function assertPrReviewCleanCheckout(directory: string, mode?: PrWorkflowMode): void;
@@ -274,6 +328,7 @@ export declare const _test_exports: {
     resolveCommitCountSince: typeof resolveCommitCountSince;
     resolveIsWorkingTreeClean: typeof resolveIsWorkingTreeClean;
     resolveIsExactSingleChildCommit: typeof resolveIsExactSingleChildCommit;
+    resolvePrReviewDiffStats: typeof resolvePrReviewDiffStats;
     resolvePrWorkflowRevisionDigest: typeof resolvePrWorkflowRevisionDigest;
     resolveRemoteRefsContainingHead: typeof resolveRemoteRefsContainingHead;
     parseCriticVerdict: typeof parseCriticVerdict;