@patronage/software-factory 0.30.0-alpha.1 → 0.30.0-beta.1

package/dist/index.d.ts

@@ -371,8 +371,8 @@ interface DemandWaiver {
   operator: string;
   rationale: string;
   recordedAt: string;
-  /** The operator session the waiver was recorded in. */
-  session: string;
+  /** Optional audit metadata; never waiver authority. */
+  session?: string;
 }
 interface DemandWaiverStore {
   command: "patronage-factory demand:waive";
@@ -392,7 +392,7 @@ interface WaivedDemand {
   operator: string;
   rationale: string;
   recordedAt: string;
-  session: string;
+  session?: string;
   /** The demand's refusals at evaluation time, preserved verbatim. */
   unmetReasons: string[];
 }
@@ -431,7 +431,7 @@ declare const applyDemandWaiver: ({
 declare const waivedDemandNotice: (waived: WaivedDemand) => string;
 interface DemandWaiverAuthorization {
   operator: string;
-  session: string;
+  session?: string;
 }
 type AuthorizeDemandWaiverResult = {
   authorization: DemandWaiverAuthorization;
@@ -442,16 +442,15 @@ type AuthorizeDemandWaiverResult = {
 };
 /**
  * Operator identity, `declaredBy`-style: a named human account, recorded on
- * the waiver and enforced here — plus session distinctness from the candidate
- * the waiver applies to. Every refusal is named; nothing falls open.
+ * the waiver and enforced here. Session is optional audit metadata only: it is
+ * not credential-backed, so its absence or equality never authorizes or
+ * refuses an operator act.
  */
 declare const authorizeDemandWaiver: ({
   authenticatedLogin,
-  authoringSession,
   session
 }: {
   authenticatedLogin: string | undefined;
-  authoringSession: string | undefined;
   session: string | undefined;
 }) => AuthorizeDemandWaiverResult;
 //#endregion
@@ -519,27 +518,6 @@ declare const followUpFromArgv: (argv: string[]) => FollowUpAction;
 /** Canonical zod schema for the optional follow-up field on JSON outputs. */
 declare const FollowUpActionSchema: z.ZodType<FollowUpAction>;
 //#endregion
-//#region src/pr-readiness/handled-human-comments.d.ts
-declare const HANDLED_COMMENTS_PAYLOAD_KIND: "handled-human-comments";
-/**
- * Authenticated producer of the durable handled set. Recorded on the readiness
- * ledger; unverifiable producers are ignored on read (fail closed).
- */
-type HandledCommentsProducerMode = "app" | "commit-status";
-interface HandledCommentsProducer {
-  /** App id (stringified) or GitHub login, depending on mode. */
-  identity: string;
-  mode: HandledCommentsProducerMode;
-}
-interface HandledCommentsCheckPayload {
-  clearedAt?: string;
-  handledCommentUrls: string[];
-  kind: typeof HANDLED_COMMENTS_PAYLOAD_KIND;
-  pr: number;
-  schemaVersion: 1;
-  sessionId?: string;
-}
-//#endregion
 //#region src/diff-classification.d.ts
 declare const DIFF_CLASSIFICATIONS: readonly ["docs/process-only", "trivial", "non-trivial"];
 type DiffClassification = (typeof DIFF_CLASSIFICATIONS)[number];
@@ -595,16 +573,10 @@ declare const factoryProjectProfileSchema: z.ZodObject<{
       paths: z.ZodArray<z.ZodString>;
     }, z.core.$strict>>>;
     defaultMaxCycles: z.ZodNumber;
-    ladder: z.ZodOptional<z.ZodObject<{
-      gate: z.ZodOptional<z.ZodObject<{
-        cap: z.ZodNumber;
-      }, z.core.$strict>>;
-    }, z.core.$strict>>;
     modes: z.ZodArray<z.ZodEnum<{
       correctness: "correctness";
       security: "security";
     }>>;
-    standingChecklist: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$strict>;
   schemaVersion: z.ZodLiteral<4>;
   verification: z.ZodObject<{
@@ -784,14 +756,6 @@ interface CheckRunDependencies {
 declare function ensureFactoryCheckRunPublished(input: PublishFactoryCheckInput, dependencies?: CheckRunDependencies & {
   onDiagnostic?: (message: string) => void;
 }): Promise<boolean>;
-interface PublishHandledCommentsCheckInput {
-  cwd: string;
-  owner: string;
-  payload: HandledCommentsCheckPayload;
-  pr: number;
-  repo: string;
-  sha: string;
-}
 //#endregion
 //#region src/merge-freeze.d.ts
 declare const MERGE_FREEZE_CHECK_NAME = "patronage-factory/merge-freeze";
@@ -835,10 +799,10 @@ interface MergeFreezeStore {
   read: (input: MergeFreezeStoreInput) => unknown;
 }
 /**
- * The freeze generation as an arming decision needs to see it (#477).
+ * The freeze generation as a readiness decision needs to see it (#477).
  *
  * `read` above collapses three different situations into one refusal, because
- * merge time treated all of them as "do not merge". Arming time distinguishes
+ * merge time treated all of them as "do not merge". Readiness distinguishes
  * them: a settled generation is the writer's verdict, a **settling** one is the
  * window between a merge landing and its main-push verify completing (a
  * running generation, or a missing generation proven by the immediately prior
@@ -878,7 +842,6 @@ interface ProofDescriptor<T> {
 declare const reviewPromptSectionSchema: z.ZodObject<{
   provenance: z.ZodEnum<{
     "prior-review-ledger": "prior-review-ledger";
-    "profile-standing-checklist": "profile-standing-checklist";
     "issue-review-focus": "issue-review-focus";
   }>;
   source: z.ZodString;
@@ -889,7 +852,6 @@ type ReviewPromptSectionProvenance = ReviewPromptSection["provenance"];
 declare const reviewPromptSectionsSchema: z.ZodArray<z.ZodObject<{
   provenance: z.ZodEnum<{
     "prior-review-ledger": "prior-review-ledger";
-    "profile-standing-checklist": "profile-standing-checklist";
     "issue-review-focus": "issue-review-focus";
   }>;
   source: z.ZodString;
@@ -1171,33 +1133,11 @@ interface PrReviewProof {
 //#endregion
 //#region src/pr-readiness/readiness-ledger.d.ts
 declare const SCHEMA_VERSION = 1;
-declare const previewDeploySchema: z.ZodObject<{
-  adminUrl: z.ZodOptional<z.ZodString>;
-  apiHealthUrl: z.ZodOptional<z.ZodString>;
-  headSha: z.ZodOptional<z.ZodString>;
-  localPreviewProof: z.ZodOptional<z.ZodUnknown>;
-  localProofPath: z.ZodOptional<z.ZodString>;
-  proofSource: z.ZodOptional<z.ZodEnum<{
-    "github-actions": "github-actions";
-    "local-self-certified": "local-self-certified";
-  }>>;
-  publicUrl: z.ZodOptional<z.ZodString>;
-  seedStatus: z.ZodEnum<{
-    unknown: "unknown";
-    skipped: "skipped";
-    passed: "passed";
-    failed: "failed";
-  }>;
-  stage: z.ZodOptional<z.ZodString>;
-  timingsMs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodNumber>>>;
-  workflowRunUrl: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-declare const READINESS_REPAIR_CODES: readonly ["undraft-pr", "render-pr-body-sections", "await-post-undraft-checks"];
+declare const READINESS_REPAIR_CODES: readonly ["undraft-pr", "await-post-undraft-checks"];
 declare const readinessRepairSchema: z.ZodObject<{
   action: z.ZodString;
   code: z.ZodEnum<{
     "undraft-pr": "undraft-pr";
-    "render-pr-body-sections": "render-pr-body-sections";
     "await-post-undraft-checks": "await-post-undraft-checks";
   }>;
   command: z.ZodString;
@@ -1232,80 +1172,28 @@ declare const managedReadinessLedgerSchema: z.ZodObject<{
       "out-of-scope": "out-of-scope";
     }>;
   }, z.core.$strip>>>;
-  finalReviewPoint: z.ZodBoolean;
   github: z.ZodObject<{
-    currentWithBase: z.ZodBoolean;
     draft: z.ZodBoolean;
     mergeStateStatus: z.ZodString;
     mergeable: z.ZodString;
     requiredChecks: z.ZodEnum<{
       unknown: "unknown";
-      pending: "pending";
       passed: "passed";
       failed: "failed";
+      pending: "pending";
       none: "none";
     }>;
+    reviewDecision: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     unresolvedReviewThreads: z.ZodNumber;
   }, z.core.$strip>;
-  handledCommentsProducer: z.ZodOptional<z.ZodObject<{
-    identity: z.ZodString;
-    mode: z.ZodEnum<{
-      app: "app";
-      "commit-status": "commit-status";
-    }>;
-  }, z.core.$strip>>;
-  handledHumanComments: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    clearedAt: z.ZodOptional<z.ZodString>;
-    sessionId: z.ZodOptional<z.ZodString>;
-    source: z.ZodEnum<{
-      "check-run": "check-run";
-      cli: "cli";
-    }>;
-    url: z.ZodString;
-  }, z.core.$strip>>>;
   headSha: z.ZodString;
   mergeBaseSha: z.ZodOptional<z.ZodString>;
   patchId: z.ZodString;
-  postReadinessHumanComments: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    author: z.ZodString;
-    createdAt: z.ZodString;
-    summary: z.ZodString;
-    url: z.ZodString;
-  }, z.core.$strip>>>;
-  postReadinessHumanReviews: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    author: z.ZodString;
-    createdAt: z.ZodString;
-    summary: z.ZodString;
-    url: z.ZodString;
-  }, z.core.$strip>>>;
   pr: z.ZodNumber;
-  previewDeploy: z.ZodOptional<z.ZodObject<{
-    adminUrl: z.ZodOptional<z.ZodString>;
-    apiHealthUrl: z.ZodOptional<z.ZodString>;
-    headSha: z.ZodOptional<z.ZodString>;
-    localPreviewProof: z.ZodOptional<z.ZodUnknown>;
-    localProofPath: z.ZodOptional<z.ZodString>;
-    proofSource: z.ZodOptional<z.ZodEnum<{
-      "github-actions": "github-actions";
-      "local-self-certified": "local-self-certified";
-    }>>;
-    publicUrl: z.ZodOptional<z.ZodString>;
-    seedStatus: z.ZodEnum<{
-      unknown: "unknown";
-      skipped: "skipped";
-      passed: "passed";
-      failed: "failed";
-    }>;
-    stage: z.ZodOptional<z.ZodString>;
-    timingsMs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodNumber>>>;
-    workflowRunUrl: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
-  previewDeployRequired: z.ZodBoolean;
   repairs: z.ZodDefault<z.ZodArray<z.ZodObject<{
     action: z.ZodString;
     code: z.ZodEnum<{
       "undraft-pr": "undraft-pr";
-      "render-pr-body-sections": "render-pr-body-sections";
       "await-post-undraft-checks": "await-post-undraft-checks";
     }>;
     command: z.ZodString;
@@ -1371,39 +1259,31 @@ declare const managedReadinessLedgerSchema: z.ZodObject<{
   }>>;
   reviews: z.ZodObject<{
     correctness: z.ZodObject<{
-      docsOnlyDeltaAccepted: z.ZodOptional<z.ZodBoolean>;
       required: z.ZodBoolean;
       reviewedHeadSha: z.ZodOptional<z.ZodString>;
       reviewedPatchId: z.ZodOptional<z.ZodString>;
       status: z.ZodEnum<{
         blocked: "blocked";
-        "not-required": "not-required";
         stale: "stale";
+        "not-required": "not-required";
         current: "current";
         missing: "missing";
       }>;
     }, z.core.$strip>;
     security: z.ZodOptional<z.ZodObject<{
-      docsOnlyDeltaAccepted: z.ZodOptional<z.ZodBoolean>;
       required: z.ZodBoolean;
       reviewedHeadSha: z.ZodOptional<z.ZodString>;
       reviewedPatchId: z.ZodOptional<z.ZodString>;
       status: z.ZodEnum<{
         blocked: "blocked";
-        "not-required": "not-required";
         stale: "stale";
+        "not-required": "not-required";
         current: "current";
         missing: "missing";
       }>;
     }, z.core.$strip>>;
   }, z.core.$strip>;
   schemaVersion: z.ZodLiteral<1>;
-  stackRole: z.ZodEnum<{
-    slice: "slice";
-    single: "single";
-    rollup: "rollup";
-    "merge-gate prerequisite": "merge-gate prerequisite";
-  }>;
   verification: z.ZodObject<{
     command: z.ZodLiteral<"patronage-factory pr:verify">;
     docsOnlyDeltaAccepted: z.ZodOptional<z.ZodBoolean>;
@@ -1418,10 +1298,8 @@ declare const managedReadinessLedgerSchema: z.ZodObject<{
     verifiedHeadSha: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
 }, z.core.$strip>;
-type PreviewDeployProof = z.infer<typeof previewDeploySchema>;
-type PreviewSeedStatus = PreviewDeployProof["seedStatus"];
 type ReadinessRepair = z.infer<typeof readinessRepairSchema>;
-type ReadinessStatus = "ready" | "blocked" | "slice-ready/not-final";
+type ReadinessStatus = "ready" | "blocked";
 type ManagedReadinessLedger = z.infer<typeof managedReadinessLedgerSchema>;
 declare function validateManagedReadinessLedger(value: unknown): ManagedReadinessLedger;
 declare namespace status_check_rollup_d_exports {
@@ -1478,9 +1356,7 @@ declare const statusCheckState: (rollup: StatusCheckRollup[] | undefined, exclud
 interface PrReadyArgs extends LoadProjectProfileInput {
   authoringSessionIds?: string[];
   base: string;
-  bodyForEvaluation?: string;
   epic?: number;
-  handledCommentUrls?: string[];
   json?: boolean;
   output?: string;
   report?: boolean;
@@ -1508,31 +1384,12 @@ interface GitHubPullRequest {
   baseRefName: string;
   baseRefOid: string;
   body: string;
-  comments: {
-    author?: {
-      login?: string;
-    };
-    body: string;
-    createdAt?: string;
-    id?: string | number;
-    updatedAt?: string;
-    url?: string;
-  }[];
   headRefOid: string;
   isDraft: boolean;
   mergeStateStatus: string;
   mergeable: string;
   number: number;
-  reviews?: {
-    author?: {
-      login?: string;
-    };
-    body?: string;
-    lastEditedAt?: string;
-    state: string;
-    submittedAt?: string;
-    url?: string;
-  }[];
+  reviewDecision: string | null;
   statusCheckRollup?: StatusCheckRollup[];
   title: string;
   unresolvedReviewThreads: number;
@@ -1542,8 +1399,8 @@ interface PrReadyProof {
   schemaVersion: 3;
   /**
    * What GitHub actually did when this run armed native auto-merge (#477).
-   * Present exactly when readiness passed and the arming ran; read back from
-   * the PR rather than inferred from the invocation, because `gh pr merge
+   * Present exactly when a ready wave authorizes machine merge and arming ran;
+   * read back from the PR rather than inferred from the invocation, because `gh pr merge
    * --auto` arms, merges, or does nothing with the same exit code and the same
    * empty output. `not-armed` means the candidate is admitted but nothing will
    * merge it, and `followUp` carries the re-dispatch.
@@ -1582,8 +1439,9 @@ interface PrReadyProof {
   ledger: ManagedReadinessLedger;
   /**
    * Actionable facts that did not block (#477): a settling merge-freeze
-   * generation that armed with a notice, and how each waived demand reads to a
-   * human. Absent when there are none.
+   * generation that permitted readiness and any authorized arming with a
+   * notice, an admitted-but-unscheduled false boundary wave, and how each
+   * waived demand reads to a human. Absent when there are none.
    */
   notices?: string[];
   /** Committed profile blob evaluated by readiness. Required for merge. */
@@ -1598,16 +1456,15 @@ interface PrReadyProof {
    * Demands that were in force, were NOT met, and were waived by the operator
    * (#354, moved here from the merge-time proof by #477). Each entry carries
    * the demand's refusals verbatim, so a waived demand can never read as a met
-   * one; the arming proceeds on the recorded operator act, not on evidence.
+   * one; readiness proceeds on the recorded operator act, not on evidence.
    */
   waivedDemands?: WaivedDemand[];
 }
-type PublishHandledCommentsResult = HandledCommentsProducer | Promise<HandledCommentsProducer | undefined> | undefined;
 interface PrReadyDependencies {
   /**
-   * Arms GitHub native auto-merge for a passing candidate (#477). Defaults to
-   * the real `gh pr merge --auto` call plus the read-back that says what
-   * actually happened.
+   * Arms GitHub native auto-merge only for a passing boundary wave that
+   * authorizes machine merge (#477). Defaults to the real `gh pr merge --auto`
+   * call plus the read-back that says what actually happened.
    */
   armAutoMerge?: (input: ArmAutoMergeInput) => ArmAutoMergeOutcome;
   github?: {
@@ -1623,25 +1480,11 @@ interface PrReadyDependencies {
       owner: string;
       repo: string;
     }) => string;
-    fetchHandledComments?: (input: {
-      owner: string;
-      pr: number;
-      repo: string;
-    }) => {
-      producer?: HandledCommentsProducer;
-      urls: string[];
-    }; /** @deprecated Prefer fetchHandledComments (includes producer identity). */
-    fetchHandledCommentUrls?: (input: {
-      owner: string;
-      pr: number;
-      repo: string;
-    }) => string[];
     fetchPullRequest: (input: {
       owner: string;
       repo: string;
       pr: number;
     }) => GitHubPullRequest;
-    publishHandledCommentsCheck?: (input: PublishHandledCommentsCheckInput) => PublishHandledCommentsResult;
   };
   git?: PrReadyGitDependencies;
   hq?: HqIngestDependencies;
@@ -1667,8 +1510,6 @@ interface PrReadyDependencies {
   }) => Promise<boolean> | boolean;
   /** Injectable delay for the UNKNOWN-mergeable brief poll (tests). */
   sleep?: (ms: number) => Promise<void>;
-  /** Injectable clock for CLI handled-comment provenance (tests). */
-  now?: () => Date;
 }
 interface PrReadyGitDependencies {
   canResolveCommit: (cwd: string, sha: string) => boolean;
@@ -1859,8 +1700,8 @@ declare const loadEvidenceEnvelopes: (cwd: string) => LoadedEvidenceEnvelope[];
 declare const REVIEW_STATUS_VALUES: readonly ["not-required", "current", "stale", "missing", "blocked"];
 declare const reviewStatusSchema: z.ZodEnum<{
   blocked: "blocked";
-  "not-required": "not-required";
   stale: "stale";
+  "not-required": "not-required";
   current: "current";
   missing: "missing";
 }>;
@@ -2218,11 +2059,6 @@ declare const retroEnvelopeV1Schema: z.ZodObject<{
   }, z.core.$strict>;
   kind: z.ZodLiteral<"retro-envelope">;
   outcome: z.ZodOptional<z.ZodObject<{
-    mergeCheck: z.ZodOptional<z.ZodEnum<{
-      pass: "pass";
-      fail: "fail";
-      "not-run": "not-run";
-    }>>;
     status: z.ZodEnum<{
       success: "success";
       fail: "fail";
@@ -2581,7 +2417,8 @@ interface PrPublishHandoff {
    * An admitted candidate is not a handed-off one: `pr:ready` arms only when a
    * boundary wave authorized it, and the arming can fail to take effect. A
    * readiness status of `ready` says the candidate passed, never that anything
-   * will merge it — so publish reads this before claiming nothing is owed.
+   * will merge it — only an auto-merge-authorized boundary wave can schedule
+   * one — so publish reads this before claiming nothing is owed.
    */
   scheduled: boolean;
   status: PrReadyProof["status"];
@@ -2811,11 +2648,11 @@ declare const LegacyWorkerCloseoutStatusTraceEventSchema: z.ZodObject<{
   threadId: z.ZodOptional<z.ZodString>;
   workerId: z.ZodOptional<z.ZodString>;
   archiveStatus: z.ZodOptional<z.ZodEnum<{
+    pending: "pending";
     unavailable: "unavailable";
     archived: "archived";
     skipped: "skipped";
     "not-applicable": "not-applicable";
-    pending: "pending";
   }>>;
   closeoutReason: z.ZodOptional<z.ZodString>;
   eventType: z.ZodLiteral<"worker-closeout-lessons">;
@@ -3206,11 +3043,11 @@ declare const FACTORY_TRACE_EVENT_DEFINITIONS: readonly [DefinedTraceEvent<"revi
   threadId: z.ZodOptional<z.ZodString>;
   workerId: z.ZodOptional<z.ZodString>;
   archiveStatus: z.ZodOptional<z.ZodEnum<{
+    pending: "pending";
     unavailable: "unavailable";
     archived: "archived";
     skipped: "skipped";
     "not-applicable": "not-applicable";
-    pending: "pending";
   }>>;
   closeoutReason: z.ZodOptional<z.ZodString>;
   eventType: z.ZodLiteral<"worker-closeout-lessons">;
@@ -3247,11 +3084,11 @@ declare const FACTORY_TRACE_EVENT_DEFINITIONS: readonly [DefinedTraceEvent<"revi
   }, z.core.$strict>], "lessonStatus">;
   readonly 2: z.ZodObject<{
     archiveStatus: z.ZodOptional<z.ZodEnum<{
+      pending: "pending";
       unavailable: "unavailable";
       archived: "archived";
       skipped: "skipped";
       "not-applicable": "not-applicable";
-      pending: "pending";
     }>>;
     closeoutReason: z.ZodOptional<z.ZodString>;
     lessonStatus: z.ZodOptional<z.ZodEnum<{
@@ -3927,115 +3764,6 @@ declare function checkWorktreeScratchFiles(worktreePath?: string, listRootEntrie
  * apart.
  */
 declare function formatScratchFileCheckSummary(check: WorktreeScratchFileCheck): string;
-declare namespace pr_body_metadata_d_exports {
-  export { PrBodyMetadata, StackRole, readPrBodyMetadata };
-}
-type StackRole = "single" | "slice" | "rollup" | "merge-gate prerequisite";
-interface PrBodyMetadata {
-  requiredSectionsPresent: boolean;
-  stackRole: StackRole;
-  finalReviewPoint: boolean;
-  trivialWaiverAccepted: boolean;
-}
-declare const readPrBodyMetadata: (body: string) => PrBodyMetadata;
-declare namespace post_readiness_comments_d_exports {
-  export { BLOCKING_REVIEW_STATE, HandledCommentEntry, PostReadinessHumanComment, PrReadinessComment, PrReadinessReview, activePostReadinessHumanComments, activePostReadinessHumanReviews, isBotLogin, postReadinessHumanCommentReason, postReadinessHumanReviewReason, selectPostReadinessHumanComments };
-}
-interface PrReadinessComment {
-  author?: {
-    login?: string;
-  };
-  body: string;
-  createdAt?: string;
-  id?: string | number;
-  updatedAt?: string;
-  url?: string;
-}
-interface PrReadinessReview {
-  author?: {
-    login?: string;
-  };
-  body?: string;
-  /** GraphQL `PullRequestReview.lastEditedAt` — the body-edit signal used to re-arm a cleared review (#843). */
-  lastEditedAt?: string;
-  state: string;
-  submittedAt?: string;
-  url?: string;
-}
-interface PostReadinessHumanComment {
-  author: string;
-  createdAt: string;
-  summary: string;
-  url: string;
-}
-declare const BLOCKING_REVIEW_STATE = "CHANGES_REQUESTED";
-interface HandledCommentEntry {
-  clearedAt?: string;
-  url: string;
-}
-/**
- * Active human blocking comments: all non-bot human PR comments minus the
- * explicitly-handled URL set. No review-timestamp recency gate — an unhandled
- * blocker blocks regardless of later review runs (#819 cycle 3). A handled
- * comment that is EDITED after it was cleared re-arms (#825a).
- */
-declare const selectPostReadinessHumanComments: ({
-  comments,
-  handledComments
-}: {
-  comments: PrReadinessComment[];
-  handledComments?: HandledCommentEntry[];
-}) => PostReadinessHumanComment[];
-/**
- * Active human blockers are recomputed from live GitHub comments each run
- * (#819). The prior local readiness proof is not a carry source —
- * `.factory-memory/` is gitignored and vanishes on clean checkout. Clearing
- * persists only via the durable handled set (factory check-run
- * `patronage-factory/handled-comments`) plus explicit `--handled-comment`.
- */
-declare const activePostReadinessHumanComments: ({
-  comments,
-  handledComments
-}: {
-  comments: PrReadinessComment[];
-  handledComments?: HandledCommentEntry[];
-}) => PostReadinessHumanComment[];
-/**
- * Active CHANGES_REQUESTED PR review submissions (#825b): a top-level review
- * body carries no inline thread, so without this scan it is the only human
- * channel auto-merge would sail over — unwatched by both the issue-comment
- * scan and the unresolved-review-thread count. Shares the handled-set /
- * re-arm rules with comments so an operator can clear a stale request the
- * same way (`--handled-comment <review-url>`). The clear-comparison uses
- * `lastEditedAt` when present so a body edit after a clear re-arms the
- * blocker the same way an edited comment does — resubmission is not the
- * only edit signal GitHub exposes (#843).
- */
-declare const activePostReadinessHumanReviews: ({
-  handledComments,
-  reviews
-}: {
-  handledComments?: HandledCommentEntry[];
-  reviews: PrReadinessReview[];
-}) => PostReadinessHumanComment[];
-declare const postReadinessHumanCommentReason: ({
-  comment,
-  pr,
-  prTitle
-}: {
-  comment: PostReadinessHumanComment;
-  pr: number;
-  prTitle?: string;
-}) => string;
-declare const postReadinessHumanReviewReason: ({
-  pr,
-  prTitle,
-  review
-}: {
-  pr: number;
-  prTitle?: string;
-  review: PostReadinessHumanComment;
-}) => string;
 //#endregion
 //#region src/pr-readiness/pr-body-sections.d.ts
 declare const MANAGED_SECTION_NAMES: readonly ["Verification", "Review proof", "How to review"];
@@ -4152,31 +3880,27 @@ interface WaveReviewDemand {
   wave: string;
 }
 declare namespace readiness_evaluation_d_exports {
-  export { CORRECTNESS_UNTYPED_REVIEW_BLOCKER_REASON, DRAFT_BLOCKER_REASON, EvaluationInput, ManagedReadinessLedger, PENDING_CHECKS_BLOCKER_REASON_PREFIX, PreviewDeployProof, PreviewSeedStatus, READINESS_REPAIR_CODES, RENDER_PR_BODY_SECTIONS_BLOCKER_REASON, ReadinessRepair, ReadinessStatus, SCHEMA_VERSION, SECURITY_UNTYPED_REVIEW_BLOCKER_REASON, evaluateReadiness, managedReadinessLedgerSchema, readinessExitCode, readinessRepairSchema, validateManagedReadinessLedger };
+  export { CORRECTNESS_UNTYPED_REVIEW_BLOCKER_REASON, DRAFT_BLOCKER_REASON, EvaluationInput, ManagedReadinessLedger, PENDING_CHECKS_BLOCKER_REASON_PREFIX, READINESS_REPAIR_CODES, ReadinessRepair, ReadinessStatus, SCHEMA_VERSION, SECURITY_UNTYPED_REVIEW_BLOCKER_REASON, evaluateReadiness, managedReadinessLedgerSchema, readinessExitCode, readinessRepairSchema, validateManagedReadinessLedger };
 }
 declare const CORRECTNESS_UNTYPED_REVIEW_BLOCKER_REASON = "Correctness review proof is not a head-bound typed findings verdict; re-run pr:review with a valid findings file.";
 declare const SECURITY_UNTYPED_REVIEW_BLOCKER_REASON = "Security review proof is not a head-bound typed findings verdict; re-run pr:review with a valid findings file.";
 declare const DRAFT_BLOCKER_REASON = "PR is still marked draft.";
-declare const RENDER_PR_BODY_SECTIONS_BLOCKER_REASON = "PR body must include Verification, Review proof, and How to review sections.";
 declare const PENDING_CHECKS_BLOCKER_REASON_PREFIX = "Required/current checks are";
 declare const readinessExitCode: (status: ReadinessStatus) => 1 | 0;
 interface EvaluationInput {
   pr: number;
   prTitle?: string;
-  body: string;
   headSha: string;
   localHeadSha?: string;
   baseSha: string;
   patchId: string;
   classification: DiffClassification;
-  comments?: PrReadinessComment[];
-  reviews?: PrReadinessReview[];
+  reviewDecision: string | null;
   unresolvedReviewThreads: number;
   requiredChecks: CheckState;
   hostedVerifyCheck?: CheckState;
   autoMergeEnabled?: boolean;
   draft: boolean;
-  currentWithBase: boolean;
   mergeable: string;
   mergeStateStatus: string;
   ladderPolicy?: ReviewLadderPolicy;
@@ -4184,20 +3908,11 @@ interface EvaluationInput {
   reviewProof?: PrReviewProof;
   verificationProof?: VerificationProofState;
   docsOnlyVerifyBaselineHeadShas?: string[];
-  docsOnlySinceReviewProof?: boolean;
   externalRequiredChecks?: RequiredCheck[];
   evidenceEnvelopes?: LoadedEvidenceEnvelope[];
   mergeBaseSha?: string;
   authoringSessionIds?: string[];
   priorLedger?: Pick<ManagedReadinessLedger, "reviewRuns">;
-  handledCommentUrls?: string[];
-  checkRunHandledCommentUrls?: string[];
-  handledCommentsProducer?: {
-    identity: string;
-    mode: "app" | "commit-status";
-  };
-  handledCommentSessionId?: string;
-  handledCommentClearedAt?: string;
   waveReviewDemand?: Pick<WaveReviewDemand, "autoMerge" | "review" | "wave">;
   mergeFreeze?: {
     blockingReasons: string[];
@@ -4216,42 +3931,37 @@ declare const evaluateReadiness: (input: EvaluationInput) => {
     baseSha: string;
     blockingReasons: string[];
     classification: "trivial" | "docs/process-only" | "non-trivial";
-    finalReviewPoint: boolean;
     github: {
-      currentWithBase: boolean;
       draft: boolean;
       mergeStateStatus: string;
       mergeable: string;
-      requiredChecks: "unknown" | "pending" | "passed" | "failed" | "none";
+      requiredChecks: "unknown" | "passed" | "failed" | "pending" | "none";
       unresolvedReviewThreads: number;
+      reviewDecision?: string | null | undefined;
     };
     headSha: string;
     patchId: string;
     pr: number;
-    previewDeployRequired: boolean;
     repairs: {
       action: string;
-      code: "undraft-pr" | "render-pr-body-sections" | "await-post-undraft-checks";
+      code: "undraft-pr" | "await-post-undraft-checks";
       command: string;
     }[];
     reviews: {
       correctness: {
         required: boolean;
-        status: "blocked" | "not-required" | "stale" | "current" | "missing";
-        docsOnlyDeltaAccepted?: boolean | undefined;
+        status: "blocked" | "stale" | "not-required" | "current" | "missing";
         reviewedHeadSha?: string | undefined;
         reviewedPatchId?: string | undefined;
       };
       security?: {
         required: boolean;
-        status: "blocked" | "not-required" | "stale" | "current" | "missing";
-        docsOnlyDeltaAccepted?: boolean | undefined;
+        status: "blocked" | "stale" | "not-required" | "current" | "missing";
         reviewedHeadSha?: string | undefined;
         reviewedPatchId?: string | undefined;
       } | undefined;
     };
     schemaVersion: 1;
-    stackRole: "slice" | "single" | "rollup" | "merge-gate prerequisite";
     verification: {
       command: "patronage-factory pr:verify";
       prVerify: "stale" | "passed" | "missing";
@@ -4272,42 +3982,7 @@ declare const evaluateReadiness: (input: EvaluationInput) => {
         classifications: ("trivial" | "docs/process-only" | "non-trivial")[];
       } | undefined;
     }[] | undefined;
-    handledCommentsProducer?: {
-      identity: string;
-      mode: "app" | "commit-status";
-    } | undefined;
-    handledHumanComments?: {
-      source: "check-run" | "cli";
-      url: string;
-      clearedAt?: string | undefined;
-      sessionId?: string | undefined;
-    }[] | undefined;
     mergeBaseSha?: string | undefined;
-    postReadinessHumanComments?: {
-      author: string;
-      createdAt: string;
-      summary: string;
-      url: string;
-    }[] | undefined;
-    postReadinessHumanReviews?: {
-      author: string;
-      createdAt: string;
-      summary: string;
-      url: string;
-    }[] | undefined;
-    previewDeploy?: {
-      seedStatus: "unknown" | "skipped" | "passed" | "failed";
-      adminUrl?: string | undefined;
-      apiHealthUrl?: string | undefined;
-      headSha?: string | undefined;
-      localPreviewProof?: unknown;
-      localProofPath?: string | undefined;
-      proofSource?: "github-actions" | "local-self-certified" | undefined;
-      publicUrl?: string | undefined;
-      stage?: string | undefined;
-      timingsMs?: Record<string, number | undefined> | undefined;
-      workflowRunUrl?: string | undefined;
-    } | undefined;
     reviewCycleState?: {
       autoBlockingFindings: number;
       countsBySeverity: {
@@ -4346,7 +4021,7 @@ declare const evaluateReadiness: (input: EvaluationInput) => {
   notices: string[];
   repairs: {
     action: string;
-    code: "undraft-pr" | "render-pr-body-sections" | "await-post-undraft-checks";
+    code: "undraft-pr" | "await-post-undraft-checks";
     command: string;
   }[];
   status: ReadinessStatus; /** Demands that were in force, were NOT met, and the operator waived. */
@@ -4604,7 +4279,6 @@ interface AssembleReviewPromptInput {
   patchId: string;
   priorLedgerEntries?: FindingLedgerEntry[];
   profile: FactoryProjectProfile;
-  standingChecklist?: readonly string[];
 }
 interface AssembledReviewPrompt {
   prompt: string;
@@ -4618,8 +4292,7 @@ declare const assembleReviewPrompt: ({
   kind,
   patchId,
   priorLedgerEntries,
-  profile,
-  standingChecklist
+  profile
 }: AssembleReviewPromptInput) => AssembledReviewPrompt;
 //#endregion
 //#region src/review-ladder-trace.d.ts
@@ -4701,4 +4374,4 @@ interface CreateProgramOptions {
 declare function createProgram(options?: CreateProgramOptions): Command;
 declare function run(argv?: string[]): Promise<void>;
 //#endregion
-export { type AppendFactoryTraceEventResult, type AssembledReviewPrompt, type BoundaryCheckArgs, type BoundaryCheckDependencies, type BoundaryCheckProofRecord, type BuildEpicStructureEventInput, type BuildRetroEnvelopeInput, type CloudflareAccessServiceToken, CreateProgramOptions, DEFAULT_DEMAND_WAIVER_PATH, DEFAULT_FACTORY_REPOSITORY, type DagDocument, type DemandWaiveArgs, type DemandWaiveDependencies, DemandWaiveRefusalError, type DemandWaiver, type DemandWaiverStore, EPIC_STRUCTURE_NODE_STATUSES, EPIC_STRUCTURE_SCHEMA_VERSION, type EpicStructureEvent, type EpicStructureGraphPayload, type EpicStructureNodeStatus, EpicStructureValidationError, type EvidenceEmitArgs, type EvidenceEmitDependencies, type EvidenceEmitResult, type FactoryCliInvocation, FactoryCliInvocationSchema, type FactoryProjectProfile, type FactoryTraceDiagnostic, type FactoryTraceEnvelope, type FactoryTraceEvent, type FindingDisposition, type FindingLedgerEntry, type FollowUpAction, FollowUpActionSchema, type IssueReviewFocus, type LadderDispositionDeclaration, MERGE_FREEZE_APP_SLUG, MERGE_FREEZE_CHECK_NAME, type MergeFreezeState, type ParsedRetroEnvelope, type PrPublishArgs, type PrPublishDependencies, PrPublishFollowUpError, type PrPublishFollowUpOutcome, type PrPublishHandoff, type PrPublishResult, type PrReadyArgs, type PrReadyProof, type PublishEpicStructureArgs, type PublishEpicStructureResult, type PublishFollowUpPlan, RETRO_ENVELOPE_SCHEMA_VERSION, RETRO_ENVELOPE_VALIDATORS, REVIEW_FOCUS_SECTION, type RetroEnvelope, type ReviewGateNotRequiredProof, type ReviewGateTraceIdentity, type ReviewLadderCycle, type ReviewLadderEvaluation, type ReviewLadderPolicy, type ReviewLadderStageEvent, type ReviewLadderTraceIdentity, type ReviewPromptSection, type ReviewPromptSectionProvenance, SUPPORTED_RETRO_ENVELOPE_SCHEMA_VERSIONS, type ScanFactoryTraceDiagnosticsOptions, type ScanFactoryTraceOptions, type ScanFactoryTraceResult, type TraceMirrorDiagnostic, type TraceSink, type TraceWriteResult, type TraceWriteSinks, type VerificationReuse, type WaivedDemand, WorkerCheckoutGuardError, type WorkerCloseoutLessonsTraceEvent, appendReviewLadderStageTraceEvent, appendWithTraceSinks, applyDemandWaiver, assembleReviewPrompt, assertWorkerCheckoutAllowed, authorizeDemandWaiver, blockingLadderFindings, boundary_manifest_d_exports as boundaryManifest, boundary_review_proof_d_exports as boundaryReviewProof, buildEpicStructureEvent, buildEpicStructurePayload, buildEvidenceEnvelope, buildRetroEnvelope, buildReviewGateNotRequiredTraceEvent, buildReviewLadderStageTraceEvent, comment_provenance_d_exports as commentProvenance, createLocalJsonlTraceSink, createProgram, doctorProjectProfile, epicStructureEventId, evaluateReviewLadder, evidenceEnvelopeFilename, findingKey, followUpFromArgv, inferFixedInThreadDispositions, isProductionHqUrl, isRetroEnvelopeWireComplete, loadProjectProfile, normalizeIssueComments, openLadderFindings, parseRetroEnvelope, planPublishFollowUp, pr_body_metadata_d_exports as prReadinessBodyMetadata, readiness_evaluation_d_exports as prReadinessEvaluation, external_evidence_d_exports as prReadinessExternalEvidence, post_readiness_comments_d_exports as prReadinessPostComments, pr_body_renderer_d_exports as prReadinessPrBodyRenderer, proof_identity_d_exports as prReadinessProofIdentity, review_proof_d_exports as prReadinessReviewProof, status_check_rollup_d_exports as prReadinessStatusChecks, verification_proof_d_exports as prReadinessVerificationProof, publishEpicStructure, readDemandWaivers, readPrReadyProof, readPrReviewProof, resolveFactoryRepository, resolveFindingBlocking, resolveReviewFindingCategory, resolveReviewFindingSeverity, resolveReviewLadderPolicy, resolveTraceWriteSinks, retroEnvelopeSchemaVersionOf, retroEnvelopeV1Schema, retroEpicReference, reviewCycleStateFor, reviewFocusFromIssueBody, reviewPromptSectionSchema, reviewPromptSectionsSchema, run, runBoundaryCheck, runDemandWaive, runEvidenceEmit, runPrPublish, runPrReady, runPrReview, runPrVerify, scanFactoryTraceDiagnostics, scanFactoryTraceEvents, selectWaiversForCandidate, staleRepeatLadderFindings, toFactoryTraceEnvelope, tryAppendReviewGateNotRequiredTraceEvent, tryAppendReviewLadderStageTraceEvent, validateBoundaryCheckProof, validateDagDocument, validateDemandWaiverStore, validateFactoryTraceEvent, validateMergeFreezeState, validatePrReadyProof, validatePrReviewProof, validatePrVerifyProof, waivedDemandNotice, waivedDemandSchema, worktree_scratch_files_d_exports as worktreeScratchFiles };
+export { type AppendFactoryTraceEventResult, type AssembledReviewPrompt, type BoundaryCheckArgs, type BoundaryCheckDependencies, type BoundaryCheckProofRecord, type BuildEpicStructureEventInput, type BuildRetroEnvelopeInput, type CloudflareAccessServiceToken, CreateProgramOptions, DEFAULT_DEMAND_WAIVER_PATH, DEFAULT_FACTORY_REPOSITORY, type DagDocument, type DemandWaiveArgs, type DemandWaiveDependencies, DemandWaiveRefusalError, type DemandWaiver, type DemandWaiverStore, EPIC_STRUCTURE_NODE_STATUSES, EPIC_STRUCTURE_SCHEMA_VERSION, type EpicStructureEvent, type EpicStructureGraphPayload, type EpicStructureNodeStatus, EpicStructureValidationError, type EvidenceEmitArgs, type EvidenceEmitDependencies, type EvidenceEmitResult, type FactoryCliInvocation, FactoryCliInvocationSchema, type FactoryProjectProfile, type FactoryTraceDiagnostic, type FactoryTraceEnvelope, type FactoryTraceEvent, type FindingDisposition, type FindingLedgerEntry, type FollowUpAction, FollowUpActionSchema, type IssueReviewFocus, type LadderDispositionDeclaration, MERGE_FREEZE_APP_SLUG, MERGE_FREEZE_CHECK_NAME, type MergeFreezeState, type ParsedRetroEnvelope, type PrPublishArgs, type PrPublishDependencies, PrPublishFollowUpError, type PrPublishFollowUpOutcome, type PrPublishHandoff, type PrPublishResult, type PrReadyArgs, type PrReadyProof, type PublishEpicStructureArgs, type PublishEpicStructureResult, type PublishFollowUpPlan, RETRO_ENVELOPE_SCHEMA_VERSION, RETRO_ENVELOPE_VALIDATORS, REVIEW_FOCUS_SECTION, type RetroEnvelope, type ReviewGateNotRequiredProof, type ReviewGateTraceIdentity, type ReviewLadderCycle, type ReviewLadderEvaluation, type ReviewLadderPolicy, type ReviewLadderStageEvent, type ReviewLadderTraceIdentity, type ReviewPromptSection, type ReviewPromptSectionProvenance, SUPPORTED_RETRO_ENVELOPE_SCHEMA_VERSIONS, type ScanFactoryTraceDiagnosticsOptions, type ScanFactoryTraceOptions, type ScanFactoryTraceResult, type TraceMirrorDiagnostic, type TraceSink, type TraceWriteResult, type TraceWriteSinks, type VerificationReuse, type WaivedDemand, WorkerCheckoutGuardError, type WorkerCloseoutLessonsTraceEvent, appendReviewLadderStageTraceEvent, appendWithTraceSinks, applyDemandWaiver, assembleReviewPrompt, assertWorkerCheckoutAllowed, authorizeDemandWaiver, blockingLadderFindings, boundary_manifest_d_exports as boundaryManifest, boundary_review_proof_d_exports as boundaryReviewProof, buildEpicStructureEvent, buildEpicStructurePayload, buildEvidenceEnvelope, buildRetroEnvelope, buildReviewGateNotRequiredTraceEvent, buildReviewLadderStageTraceEvent, comment_provenance_d_exports as commentProvenance, createLocalJsonlTraceSink, createProgram, doctorProjectProfile, epicStructureEventId, evaluateReviewLadder, evidenceEnvelopeFilename, findingKey, followUpFromArgv, inferFixedInThreadDispositions, isProductionHqUrl, isRetroEnvelopeWireComplete, loadProjectProfile, normalizeIssueComments, openLadderFindings, parseRetroEnvelope, planPublishFollowUp, readiness_evaluation_d_exports as prReadinessEvaluation, external_evidence_d_exports as prReadinessExternalEvidence, pr_body_renderer_d_exports as prReadinessPrBodyRenderer, proof_identity_d_exports as prReadinessProofIdentity, review_proof_d_exports as prReadinessReviewProof, status_check_rollup_d_exports as prReadinessStatusChecks, verification_proof_d_exports as prReadinessVerificationProof, publishEpicStructure, readDemandWaivers, readPrReadyProof, readPrReviewProof, resolveFactoryRepository, resolveFindingBlocking, resolveReviewFindingCategory, resolveReviewFindingSeverity, resolveReviewLadderPolicy, resolveTraceWriteSinks, retroEnvelopeSchemaVersionOf, retroEnvelopeV1Schema, retroEpicReference, reviewCycleStateFor, reviewFocusFromIssueBody, reviewPromptSectionSchema, reviewPromptSectionsSchema, run, runBoundaryCheck, runDemandWaive, runEvidenceEmit, runPrPublish, runPrReady, runPrReview, runPrVerify, scanFactoryTraceDiagnostics, scanFactoryTraceEvents, selectWaiversForCandidate, staleRepeatLadderFindings, toFactoryTraceEnvelope, tryAppendReviewGateNotRequiredTraceEvent, tryAppendReviewLadderStageTraceEvent, validateBoundaryCheckProof, validateDagDocument, validateDemandWaiverStore, validateFactoryTraceEvent, validateMergeFreezeState, validatePrReadyProof, validatePrReviewProof, validatePrVerifyProof, waivedDemandNotice, waivedDemandSchema, worktree_scratch_files_d_exports as worktreeScratchFiles };