merge-steward 0.34.0 → 0.34.1

package/dist/github/pr-client.js

@@ -25,8 +25,7 @@ export class GitHubPRClient {
         const result = await exec("gh", [
             "pr", "view", String(prNumber),
             "--repo", this.repoFullName,
-            // Plan §8.4 change 3a: include baseRefName so the queue can
-            // detect stacked PRs at admission time.
+            // The base ref lets admission detect stacked PRs.
             "--json", "number,title,headRefName,headRefOid,baseRefName,reviewDecision,state,mergeStateStatus",
         ], { githubRepoFullName: this.repoFullName });
         const data = JSON.parse(result.stdout);

package/dist/service-queue.d.ts

@@ -19,11 +19,7 @@ export declare class MergeStewardQueueCommands {
         issueKey?: string;
         priority?: number;
         prTitle?: string;
-        /**
-         * Plan §8.4: PR's base ref. When this matches another open PR's
-         * `branch` (head ref), the entry is stacked and admission orders
-         * it immediately behind the parent.
-         */
+        /** A matching parent head branch makes this a stacked queue entry. */
         baseRefName?: string;
     }): QueueEntry | undefined;
     scanStartupAdmissions(): Promise<void>;

package/dist/service-queue.js

@@ -189,17 +189,8 @@ export class MergeStewardQueueCommands {
                     return false;
                 }
             }
-            // Plan §8.4: stack-aware admission. When the PR's base ref
-            // names another open PR's branch (head ref), the entry is
-            // stacked. Enqueue it only when the parent is already in the
-            // queue — otherwise the child's spec would build against the
-            // unmerged parent's pre-spec content. Positions are monotonic
-            // (`nextPosition`), so the child's position is always greater
-            // than the parent's; sibling PRs admitted between the parent's
-            // enqueue and the child's tryAdmit can sit between them. That's
-            // fine: queue head selection orders by (priority, position), so
-            // the parent is still processed before the child. The functional
-            // guarantee is "parent before child", not strict adjacency.
+            // A stacked PR waits for its parent queue entry. Monotonic positions
+            // guarantee parent-before-child ordering, not strict adjacency.
             const baseRefName = status.baseRefName ?? null;
             if (baseRefName && baseRefName !== this.config.baseBranch) {
                 const parentEntry = this.findActiveEntryByBranch(baseRefName);
@@ -330,9 +321,7 @@ export class MergeStewardQueueCommands {
         }
         return next;
     }
-    // Plan §8.4: lookup helper used by stack-aware admission. Returns
-    // the active queue entry whose `branch` (head ref) matches `name`,
-    // or undefined when no such entry is in the queue.
+    // Find the active entry whose head branch matches `name`.
     findActiveEntryByBranch(name) {
         return this.store.listActive(this.config.repoId).find((entry) => entry.branch === name);
     }

package/dist/types.d.ts

@@ -227,11 +227,7 @@ export interface PRStatus {
     branch: string;
     headSha: string;
     title?: string | undefined;
-    /**
-     * Plan §8.4: PR's base ref. When this names another open PR's
-     * `branch` (head ref), the PR is stacked and admission must defer
-     * until the parent is in the queue.
-     */
+    /** Base ref used to recognize and order stacked PRs. */
     baseRefName?: string | undefined;
     mergeable: boolean;
     mergeStateStatus?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "merge-steward",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "description": "Serial merge queue for GitHub — rebase, CI-gate, and merge PRs one at a time",
   "type": "module",
   "repository": {