patchrelay 0.48.0 → 0.49.1

package/README.md

@@ -119,8 +119,8 @@ See the [merge-steward package README](./packages/merge-steward/README.md) for t
 - [Prompting](./docs/prompting.md) — how workflow files and the built-in scaffold compose
 - [Secrets](./docs/secrets.md) — systemd credentials, resolution order
 - [review-quill reference](./docs/review-quill.md) · [merge-steward reference](./docs/merge-steward.md)
-- [Design docs](./docs/design-docs/index.md) · [Core beliefs](./docs/design-docs/core-beliefs.md)
-- [Security policy](./SECURITY.md)
+- [Product specs](./docs/product-specs/index.md) · [Design docs](./docs/design-docs/index.md) · [Core beliefs](./docs/design-docs/core-beliefs.md)
+- [Contributing](./CONTRIBUTING.md) · [Security policy](./SECURITY.md)
 
 ## Status
 

package/dist/agent-session-plan.js

@@ -104,6 +104,17 @@ function resolvePlanRunType(params) {
 }
 export function buildAgentSessionPlan(params) {
     if (params.issueClass === "orchestration") {
+        const settling = params.orchestrationSettleUntil
+            ? Number.isFinite(Date.parse(params.orchestrationSettleUntil)) && Date.parse(params.orchestrationSettleUntil) > Date.now()
+            : false;
+        if (settling) {
+            return [
+                { content: "Wait for child set to settle", status: "inProgress" },
+                { content: "Review umbrella goal and child set", status: "pending" },
+                { content: "Wait for or inspect child progress", status: "pending" },
+                { content: "Audit delivered outcome", status: "pending" },
+            ];
+        }
         switch (params.factoryState) {
             case "done":
                 return setStatuses(orchestrationPlan(), ["completed", "completed", "completed", "completed"]);
@@ -181,6 +192,7 @@ export function buildAgentSessionPlanForIssue(issue, options) {
         ciRepairAttempts: issue.ciRepairAttempts,
         queueRepairAttempts: issue.queueRepairAttempts,
         ...(issue.issueClass ? { issueClass: issue.issueClass } : {}),
+        ...(issue.orchestrationSettleUntil ? { orchestrationSettleUntil: issue.orchestrationSettleUntil } : {}),
         ...(issue.pendingRunType ? { pendingRunType: issue.pendingRunType } : {}),
         ...(options?.activeRunType ? { activeRunType: options.activeRunType } : {}),
     });

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "service": "patchrelay",
-  "version": "0.48.0",
-  "commit": "a606bc8b729a",
-  "builtAt": "2026-04-18T14:29:29.224Z"
+  "version": "0.49.1",
+  "commit": "b14320b27556",
+  "builtAt": "2026-04-19T11:22:46.139Z"
 }

package/dist/cli/data.js

@@ -9,6 +9,8 @@ import { buildManualRetryAttemptReset, resolveRetryTarget } from "../manual-issu
 import { WorktreeManager } from "../worktree-manager.js";
 import { parseDelegationObservedPayload, parseRunReleasedAuthorityPayload } from "../delegation-audit.js";
 import { CliOperatorApiClient } from "./operator-client.js";
+import { resolveEffectiveActiveRun } from "../effective-active-run.js";
+import { derivePatchRelayWaitingReason } from "../waiting-reason.js";
 function safeJsonParse(value) {
     if (!value)
         return undefined;
@@ -105,8 +107,11 @@ export class CliDataAccess extends CliOperatorApiClient {
         if (!issue)
             return undefined;
         const dbIssue = this.db.issues.getIssueByKey(issueKey);
-        const activeRun = dbIssue.activeRunId ? this.db.runs.getRunById(dbIssue.activeRunId) : undefined;
         const latestRun = this.db.runs.getLatestRunForIssue(issue.projectId, issue.linearIssueId);
+        const activeRun = resolveEffectiveActiveRun({
+            activeRun: dbIssue.activeRunId ? this.db.runs.getRunById(dbIssue.activeRunId) : undefined,
+            latestRun,
+        });
         const latestReport = normalizeStageReport(latestRun?.reportJson, latestRun?.status);
         const latestSummary = safeJsonParse(latestRun?.summaryJson);
         const completionCheck = latestRun ? extractCompletionCheck(latestRun) : undefined;
@@ -139,7 +144,10 @@ export class CliDataAccess extends CliOperatorApiClient {
         if (!issue)
             return undefined;
         const dbIssue = this.db.issues.getIssueByKey(issueKey);
-        const run = dbIssue.activeRunId ? this.db.runs.getRunById(dbIssue.activeRunId) : undefined;
+        const run = resolveEffectiveActiveRun({
+            activeRun: dbIssue.activeRunId ? this.db.runs.getRunById(dbIssue.activeRunId) : undefined,
+            latestRun: this.db.runs.getLatestRunForIssue(issue.projectId, issue.linearIssueId),
+        });
         if (!run)
             return undefined;
         const live = run.threadId &&
@@ -469,19 +477,36 @@ export class CliDataAccess extends CliOperatorApiClient {
         ORDER BY i.updated_at DESC, i.issue_key ASC
         `)
             .all(...values);
-        const items = rows.map((row) => ({
-            ...(row.issue_key !== null ? { issueKey: String(row.issue_key) } : {}),
-            ...(row.title !== null ? { title: String(row.title) } : {}),
-            projectId: String(row.project_id),
-            ...(row.current_linear_state !== null ? { currentLinearState: String(row.current_linear_state) } : {}),
-            ...(row.session_state !== null ? { sessionState: String(row.session_state) } : {}),
-            factoryState: String(row.factory_state ?? "delegated"),
-            ...(row.waiting_reason !== null ? { waitingReason: String(row.waiting_reason) } : {}),
-            ...(row.active_run_type !== null ? { activeRunType: String(row.active_run_type) } : {}),
-            ...(row.latest_run_type !== null ? { latestRunType: String(row.latest_run_type) } : {}),
-            ...(row.latest_run_status !== null ? { latestRunStatus: String(row.latest_run_status) } : {}),
-            updatedAt: String(row.updated_at),
-        }));
+        const items = rows.map((row) => {
+            const detachedActiveRun = row.active_run_type === null
+                && (row.latest_run_status === "queued" || row.latest_run_status === "running");
+            const activeRunType = row.active_run_type !== null
+                ? String(row.active_run_type)
+                : detachedActiveRun && row.latest_run_type !== null
+                    ? String(row.latest_run_type)
+                    : undefined;
+            const waitingReason = detachedActiveRun
+                ? derivePatchRelayWaitingReason({
+                    activeRunId: 1,
+                    factoryState: String(row.factory_state ?? "delegated"),
+                })
+                : row.waiting_reason !== null
+                    ? String(row.waiting_reason)
+                    : undefined;
+            return {
+                ...(row.issue_key !== null ? { issueKey: String(row.issue_key) } : {}),
+                ...(row.title !== null ? { title: String(row.title) } : {}),
+                projectId: String(row.project_id),
+                ...(row.current_linear_state !== null ? { currentLinearState: String(row.current_linear_state) } : {}),
+                ...(row.session_state !== null ? { sessionState: detachedActiveRun ? "running" : String(row.session_state) } : {}),
+                factoryState: String(row.factory_state ?? "delegated"),
+                ...(waitingReason ? { waitingReason } : {}),
+                ...(activeRunType ? { activeRunType } : {}),
+                ...(row.latest_run_type !== null ? { latestRunType: String(row.latest_run_type) } : {}),
+                ...(row.latest_run_status !== null ? { latestRunStatus: String(row.latest_run_status) } : {}),
+                updatedAt: String(row.updated_at),
+            };
+        });
         return items.filter((item) => {
             if (options?.active && !item.activeRunType)
                 return false;

package/dist/db/issue-store.js

@@ -28,6 +28,14 @@ export class IssueStore {
                 sets.push("issue_class_source = @issueClassSource");
                 values.issueClassSource = params.issueClassSource;
             }
+            if (params.parentLinearIssueId !== undefined) {
+                sets.push("parent_linear_issue_id = @parentLinearIssueId");
+                values.parentLinearIssueId = params.parentLinearIssueId;
+            }
+            if (params.parentIssueKey !== undefined) {
+                sets.push("parent_issue_key = @parentIssueKey");
+                values.parentIssueKey = params.parentIssueKey;
+            }
             if (params.issueKey !== undefined) {
                 sets.push("issue_key = COALESCE(@issueKey, issue_key)");
                 values.issueKey = params.issueKey;
@@ -224,12 +232,16 @@ export class IssueStore {
                 sets.push("last_zombie_recovery_at = @lastZombieRecoveryAt");
                 values.lastZombieRecoveryAt = params.lastZombieRecoveryAt;
             }
+            if (params.orchestrationSettleUntil !== undefined) {
+                sets.push("orchestration_settle_until = @orchestrationSettleUntil");
+                values.orchestrationSettleUntil = params.orchestrationSettleUntil;
+            }
             this.connection.prepare(`UPDATE issues SET ${sets.join(", ")} WHERE project_id = @projectId AND linear_issue_id = @linearIssueId`).run(values);
         }
         else {
             this.connection.prepare(`
         INSERT INTO issues (
-          project_id, linear_issue_id, delegated_to_patchrelay, issue_class, issue_class_source, issue_key, title, description, url,
+          project_id, linear_issue_id, delegated_to_patchrelay, issue_class, issue_class_source, parent_linear_issue_id, parent_issue_key, issue_key, title, description, url,
           priority, estimate,
           current_linear_state, current_linear_state_type, factory_state, pending_run_type, pending_run_context_json,
           branch_name, worktree_path, thread_id, active_run_id, status_comment_id,
@@ -239,10 +251,10 @@ export class IssueStore {
           last_github_ci_snapshot_head_sha, last_github_ci_snapshot_gate_check_name, last_github_ci_snapshot_gate_check_status, last_github_ci_snapshot_json, last_github_ci_snapshot_settled_at,
           last_queue_signal_at, last_queue_incident_json,
           last_attempted_failure_head_sha, last_attempted_failure_signature, last_attempted_failure_at,
-          ci_repair_attempts, queue_repair_attempts, review_fix_attempts, zombie_recovery_attempts, last_zombie_recovery_at,
+          ci_repair_attempts, queue_repair_attempts, review_fix_attempts, zombie_recovery_attempts, last_zombie_recovery_at, orchestration_settle_until,
           updated_at
         ) VALUES (
-          @projectId, @linearIssueId, @delegatedToPatchRelay, @issueClass, @issueClassSource, @issueKey, @title, @description, @url,
+          @projectId, @linearIssueId, @delegatedToPatchRelay, @issueClass, @issueClassSource, @parentLinearIssueId, @parentIssueKey, @issueKey, @title, @description, @url,
           @priority, @estimate,
           @currentLinearState, @currentLinearStateType, @factoryState, @pendingRunType, @pendingRunContextJson,
           @branchName, @worktreePath, @threadId, @activeRunId, @statusCommentId,
@@ -252,7 +264,7 @@ export class IssueStore {
           @lastGitHubCiSnapshotHeadSha, @lastGitHubCiSnapshotGateCheckName, @lastGitHubCiSnapshotGateCheckStatus, @lastGitHubCiSnapshotJson, @lastGitHubCiSnapshotSettledAt,
           @lastQueueSignalAt, @lastQueueIncidentJson,
           @lastAttemptedFailureHeadSha, @lastAttemptedFailureSignature, @lastAttemptedFailureAt,
-          @ciRepairAttempts, @queueRepairAttempts, @reviewFixAttempts, @zombieRecoveryAttempts, @lastZombieRecoveryAt,
+          @ciRepairAttempts, @queueRepairAttempts, @reviewFixAttempts, @zombieRecoveryAttempts, @lastZombieRecoveryAt, @orchestrationSettleUntil,
           @now
         )
       `).run({
@@ -261,6 +273,8 @@ export class IssueStore {
                 delegatedToPatchRelay: params.delegatedToPatchRelay === false ? 0 : 1,
                 issueClass: params.issueClass ?? null,
                 issueClassSource: params.issueClassSource ?? null,
+                parentLinearIssueId: params.parentLinearIssueId ?? null,
+                parentIssueKey: params.parentIssueKey ?? null,
                 issueKey: params.issueKey ?? null,
                 title: params.title ?? null,
                 description: params.description ?? null,
@@ -310,6 +324,7 @@ export class IssueStore {
                 reviewFixAttempts: params.reviewFixAttempts ?? 0,
                 zombieRecoveryAttempts: params.zombieRecoveryAttempts ?? 0,
                 lastZombieRecoveryAt: params.lastZombieRecoveryAt ?? null,
+                orchestrationSettleUntil: params.orchestrationSettleUntil ?? null,
                 now,
             });
         }
@@ -456,6 +471,67 @@ export class IssueStore {
             linearIssueId: String(row.linear_issue_id),
         }));
     }
+    replaceIssueParentLink(params) {
+        const now = isoNow();
+        this.connection
+            .prepare("DELETE FROM issue_children WHERE project_id = ? AND child_linear_issue_id = ?")
+            .run(params.projectId, params.childLinearIssueId);
+        if (!params.parentLinearIssueId) {
+            return;
+        }
+        this.connection.prepare(`
+      INSERT INTO issue_children (
+        project_id,
+        parent_linear_issue_id,
+        child_linear_issue_id,
+        updated_at
+      ) VALUES (?, ?, ?, ?)
+    `).run(params.projectId, params.parentLinearIssueId, params.childLinearIssueId, now);
+    }
+    listChildLinks(projectId, parentLinearIssueId) {
+        const rows = this.connection.prepare(`
+      SELECT project_id, parent_linear_issue_id, child_linear_issue_id, updated_at
+      FROM issue_children
+      WHERE project_id = ? AND parent_linear_issue_id = ?
+      ORDER BY child_linear_issue_id ASC
+    `).all(projectId, parentLinearIssueId);
+        return rows.map((row) => ({
+            projectId: String(row.project_id),
+            parentLinearIssueId: String(row.parent_linear_issue_id),
+            childLinearIssueId: String(row.child_linear_issue_id),
+            updatedAt: String(row.updated_at),
+        }));
+    }
+    listChildIssues(projectId, parentLinearIssueId) {
+        const rows = this.connection.prepare(`
+      SELECT child.*
+      FROM issue_children edges
+      JOIN issues child
+        ON child.project_id = edges.project_id
+       AND child.linear_issue_id = edges.child_linear_issue_id
+      WHERE edges.project_id = ? AND edges.parent_linear_issue_id = ?
+      ORDER BY COALESCE(child.issue_key, child.linear_issue_id) ASC
+    `).all(projectId, parentLinearIssueId);
+        return rows.map(mapIssueRow);
+    }
+    countOpenChildIssues(projectId, parentLinearIssueId) {
+        const row = this.connection.prepare(`
+      SELECT COUNT(*) AS count
+      FROM issue_children edges
+      LEFT JOIN issues child
+        ON child.project_id = edges.project_id
+       AND child.linear_issue_id = edges.child_linear_issue_id
+      WHERE edges.project_id = ? AND edges.parent_linear_issue_id = ?
+        AND (
+          child.linear_issue_id IS NULL
+          OR (
+            COALESCE(child.current_linear_state_type, '') NOT IN ('completed', 'canceled')
+            AND LOWER(TRIM(COALESCE(child.current_linear_state, ''))) NOT IN ('done', 'duplicate', 'canceled')
+          )
+        )
+    `).get(projectId, parentLinearIssueId);
+        return Number(row?.count ?? 0);
+    }
     countUnresolvedBlockers(projectId, linearIssueId) {
         const row = this.connection.prepare(`
       SELECT COUNT(*) AS count
@@ -493,6 +569,10 @@ export function mapIssueRow(row) {
         ...(row.issue_class_source !== null && row.issue_class_source !== undefined
             ? { issueClassSource: String(row.issue_class_source) }
             : {}),
+        ...(row.parent_linear_issue_id !== null && row.parent_linear_issue_id !== undefined
+            ? { parentLinearIssueId: String(row.parent_linear_issue_id) }
+            : {}),
+        ...(row.parent_issue_key !== null && row.parent_issue_key !== undefined ? { parentIssueKey: String(row.parent_issue_key) } : {}),
         ...(row.issue_key !== null ? { issueKey: String(row.issue_key) } : {}),
         ...(row.title !== null ? { title: String(row.title) } : {}),
         ...(row.description !== null && row.description !== undefined ? { description: String(row.description) } : {}),
@@ -583,5 +663,8 @@ export function mapIssueRow(row) {
         reviewFixAttempts: Number(row.review_fix_attempts ?? 0),
         zombieRecoveryAttempts: Number(row.zombie_recovery_attempts ?? 0),
         ...(row.last_zombie_recovery_at !== null && row.last_zombie_recovery_at !== undefined ? { lastZombieRecoveryAt: String(row.last_zombie_recovery_at) } : {}),
+        ...(row.orchestration_settle_until !== null && row.orchestration_settle_until !== undefined
+            ? { orchestrationSettleUntil: String(row.orchestration_settle_until) }
+            : {}),
     };
 }

package/dist/db/migrations.js

@@ -6,6 +6,8 @@ CREATE TABLE IF NOT EXISTS issues (
   delegated_to_patchrelay INTEGER NOT NULL DEFAULT 1,
   issue_class TEXT,
   issue_class_source TEXT,
+  parent_linear_issue_id TEXT,
+  parent_issue_key TEXT,
   issue_key TEXT,
   title TEXT,
   url TEXT,
@@ -32,6 +34,7 @@ CREATE TABLE IF NOT EXISTS issues (
   last_blocking_review_head_sha TEXT,
   ci_repair_attempts INTEGER NOT NULL DEFAULT 0,
   queue_repair_attempts INTEGER NOT NULL DEFAULT 0,
+  orchestration_settle_until TEXT,
   updated_at TEXT NOT NULL,
   UNIQUE(project_id, linear_issue_id)
 );
@@ -218,6 +221,14 @@ CREATE TABLE IF NOT EXISTS issue_dependencies (
   PRIMARY KEY (project_id, linear_issue_id, blocker_linear_issue_id)
 );
 
+CREATE TABLE IF NOT EXISTS issue_children (
+  project_id TEXT NOT NULL,
+  parent_linear_issue_id TEXT NOT NULL,
+  child_linear_issue_id TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (project_id, parent_linear_issue_id, child_linear_issue_id)
+);
+
 CREATE INDEX IF NOT EXISTS idx_issues_project ON issues(project_id, linear_issue_id);
 CREATE INDEX IF NOT EXISTS idx_issues_key ON issues(issue_key);
 CREATE INDEX IF NOT EXISTS idx_issues_ready ON issues(pending_run_type, active_run_id);
@@ -238,6 +249,8 @@ CREATE INDEX IF NOT EXISTS idx_linear_catalog_teams_installation ON linear_catal
 CREATE INDEX IF NOT EXISTS idx_linear_catalog_projects_installation ON linear_catalog_projects(installation_id, project_name);
 CREATE INDEX IF NOT EXISTS idx_issue_dependencies_issue ON issue_dependencies(project_id, linear_issue_id);
 CREATE INDEX IF NOT EXISTS idx_issue_dependencies_blocker ON issue_dependencies(project_id, blocker_linear_issue_id);
+CREATE INDEX IF NOT EXISTS idx_issue_children_parent ON issue_children(project_id, parent_linear_issue_id);
+CREATE INDEX IF NOT EXISTS idx_issue_children_child ON issue_children(project_id, child_linear_issue_id);
 `;
 export function runPatchRelayMigrations(connection) {
     connection.exec(schema);
@@ -246,6 +259,18 @@ export function runPatchRelayMigrations(connection) {
     addColumnIfMissing(connection, "issues", "delegated_to_patchrelay", "INTEGER NOT NULL DEFAULT 1");
     addColumnIfMissing(connection, "issues", "issue_class", "TEXT");
     addColumnIfMissing(connection, "issues", "issue_class_source", "TEXT");
+    addColumnIfMissing(connection, "issues", "parent_linear_issue_id", "TEXT");
+    addColumnIfMissing(connection, "issues", "parent_issue_key", "TEXT");
+    addColumnIfMissing(connection, "issues", "orchestration_settle_until", "TEXT");
+    // Earlier releases persisted derived classifications as "explicit", which
+    // made bad umbrella guesses sticky forever. We do not have a user-authored
+    // explicit classification path yet, so downgrade old rows back to heuristic
+    // and let current classification logic recompute them.
+    connection.prepare(`
+    UPDATE issues
+    SET issue_class_source = 'heuristic'
+    WHERE issue_class_source = 'explicit'
+  `).run();
     // Add pending_merge_prep column for merge queue stewardship
     addColumnIfMissing(connection, "issues", "pending_merge_prep", "INTEGER NOT NULL DEFAULT 0");
     // Add merge_prep_attempts for retry budget / escalation
@@ -330,6 +355,8 @@ function removeRetiredIssueColumnsIfPresent(connection) {
         delegated_to_patchrelay INTEGER NOT NULL DEFAULT 1,
         issue_class TEXT,
         issue_class_source TEXT,
+        parent_linear_issue_id TEXT,
+        parent_issue_key TEXT,
         issue_key TEXT,
         title TEXT,
         description TEXT,
@@ -379,6 +406,7 @@ function removeRetiredIssueColumnsIfPresent(connection) {
         review_fix_attempts INTEGER NOT NULL DEFAULT 0,
         zombie_recovery_attempts INTEGER NOT NULL DEFAULT 0,
         last_zombie_recovery_at TEXT,
+        orchestration_settle_until TEXT,
         updated_at TEXT NOT NULL,
         UNIQUE(project_id, linear_issue_id)
       );
@@ -390,6 +418,8 @@ function removeRetiredIssueColumnsIfPresent(connection) {
         delegated_to_patchrelay,
         issue_class,
         issue_class_source,
+        parent_linear_issue_id,
+        parent_issue_key,
         issue_key,
         title,
         description,
@@ -439,6 +469,7 @@ function removeRetiredIssueColumnsIfPresent(connection) {
         review_fix_attempts,
         zombie_recovery_attempts,
         last_zombie_recovery_at,
+        orchestration_settle_until,
         updated_at
       )
       SELECT
@@ -448,6 +479,8 @@ function removeRetiredIssueColumnsIfPresent(connection) {
         COALESCE(delegated_to_patchrelay, 1),
         issue_class,
         issue_class_source,
+        parent_linear_issue_id,
+        parent_issue_key,
         issue_key,
         title,
         description,
@@ -497,6 +530,7 @@ function removeRetiredIssueColumnsIfPresent(connection) {
         COALESCE(review_fix_attempts, 0),
         COALESCE(zombie_recovery_attempts, 0),
         last_zombie_recovery_at,
+        orchestration_settle_until,
         updated_at
       FROM issues;
 

package/dist/db.js

@@ -154,6 +154,18 @@ export class PatchRelayDatabase {
     listDependents(projectId, blockerLinearIssueId) {
         return this.issues.listDependents(projectId, blockerLinearIssueId);
     }
+    replaceIssueParentLink(params) {
+        this.issues.replaceIssueParentLink(params);
+    }
+    listChildLinks(projectId, parentLinearIssueId) {
+        return this.issues.listChildLinks(projectId, parentLinearIssueId);
+    }
+    listChildIssues(projectId, parentLinearIssueId) {
+        return this.issues.listChildIssues(projectId, parentLinearIssueId);
+    }
+    countOpenChildIssues(projectId, parentLinearIssueId) {
+        return this.issues.countOpenChildIssues(projectId, parentLinearIssueId);
+    }
     getLatestGitHubCiSnapshot(projectId, linearIssueId) {
         return this.issues.getLatestGitHubCiSnapshot(projectId, linearIssueId);
     }

package/dist/effective-active-run.js

@@ -0,0 +1,15 @@
+function isActiveRunStatus(status) {
+    return status === "queued" || status === "running";
+}
+export function hasDetachedActiveLatestRun(params) {
+    return params.activeRunId === undefined
+        && params.latestRun !== undefined
+        && isActiveRunStatus(params.latestRun.status);
+}
+export function resolveEffectiveActiveRun(params) {
+    if (params.activeRun)
+        return params.activeRun;
+    if (params.latestRun && isActiveRunStatus(params.latestRun.status))
+        return params.latestRun;
+    return undefined;
+}

package/dist/idle-reconciliation.js

@@ -5,6 +5,7 @@ import { deriveIssueSessionReactiveIntent } from "./issue-session.js";
 import { parseStoredQueueRepairContext } from "./merge-queue-incident.js";
 import { buildClosedPrCleanupFields, resolveClosedPrDisposition } from "./pr-state.js";
 import { getReviewFixBudget } from "./run-budgets.js";
+import { queueSettledOrchestrationIssue } from "./orchestration-parent-wake.js";
 import { execCommand } from "./utils.js";
 function isFailingCheckStatus(status) {
     return status === "failed" || status === "failure";
@@ -170,6 +171,24 @@ export class IdleIssueReconciler {
                 }
             }
         }
+        const now = Date.now();
+        for (const issue of this.db.issues.listIssues()) {
+            if (issue.issueClass !== "orchestration"
+                || !issue.orchestrationSettleUntil
+                || issue.activeRunId !== undefined
+                || !issue.delegatedToPatchRelay) {
+                continue;
+            }
+            const settleAt = Date.parse(issue.orchestrationSettleUntil);
+            if (!Number.isFinite(settleAt) || settleAt > now) {
+                continue;
+            }
+            queueSettledOrchestrationIssue({
+                db: this.db,
+                issue,
+                enqueueIssue: this.deps.enqueueIssue,
+            });
+        }
     }
     shouldProbeTerminalIssueFromGitHub(issue) {
         if (issue.prNumber === undefined)

package/dist/issue-class.js

@@ -18,10 +18,14 @@ function looksLikeUmbrellaText(issue) {
     ].some((token) => haystack.includes(token));
 }
 export function classifyIssue(params) {
-    if (params.issue.issueClass === "implementation" || params.issue.issueClass === "orchestration") {
+    if (params.issue.issueClassSource === "explicit"
+        && (params.issue.issueClass === "implementation" || params.issue.issueClass === "orchestration")) {
         return { issueClass: params.issue.issueClass, issueClassSource: "explicit" };
     }
-    if (params.trackedDependentCount > 0) {
+    if (params.issue.parentLinearIssueId) {
+        return { issueClass: "implementation", issueClassSource: "hierarchy" };
+    }
+    if (params.childIssueCount > 0) {
         return { issueClass: "orchestration", issueClassSource: "hierarchy" };
     }
     if (looksLikeUmbrellaText(params.issue)) {

package/dist/issue-overview-query.js

@@ -94,6 +94,7 @@ export class IssueOverviewQuery {
             blockedByKeys,
             factoryState: issueRecord?.factoryState ?? "delegated",
             pendingRunType: issueRecord?.pendingRunType,
+            orchestrationSettleUntil: issueRecord?.orchestrationSettleUntil,
             prNumber: session.prNumber,
             prState: issueRecord?.prState,
             prHeadSha: issueRecord?.prHeadSha ?? session.prHeadSha,
@@ -128,6 +129,7 @@ export class IssueOverviewQuery {
                 blockedByCount: unresolvedBlockedBy.length,
                 hasPendingWake: this.db.issueSessions.peekIssueSessionWake(session.projectId, session.linearIssueId) !== undefined,
                 hasLegacyPendingRun: issueRecord?.pendingRunType !== undefined,
+                orchestrationSettleUntil: issueRecord?.orchestrationSettleUntil,
                 ...(session.prNumber !== undefined ? { prNumber: session.prNumber } : {}),
                 ...(issueRecord?.prState ? { prState: issueRecord.prState } : {}),
                 ...(issueRecord?.prReviewState ? { prReviewState: issueRecord.prReviewState } : {}),

package/dist/issue-session.js

@@ -88,6 +88,12 @@ export function isIssueSessionReadyForExecution(params) {
         return false;
     if (params.blockedByCount > 0)
         return false;
+    if (params.orchestrationSettleUntil) {
+        const settleAt = Date.parse(params.orchestrationSettleUntil);
+        if (Number.isFinite(settleAt) && settleAt > Date.now()) {
+            return false;
+        }
+    }
     if (params.sessionState === "done" || params.sessionState === "waiting_input") {
         return false;
     }

package/dist/linear-client.js

@@ -2,6 +2,16 @@ import { refreshLinearOAuthToken } from "./linear-oauth.js";
 import { decryptSecret, encryptSecret } from "./token-crypto.js";
 const LINEAR_ISSUE_SELECTION = `
   id
+  parent {
+    id
+    identifier
+    title
+    state {
+      id
+      name
+      type
+    }
+  }
   identifier
   title
   description
@@ -334,6 +344,9 @@ export class LinearGraphqlClient {
         }));
         return {
             id: issue.id,
+            ...(issue.parent?.id ? { parentId: issue.parent.id } : {}),
+            ...(issue.parent?.identifier ? { parentIdentifier: issue.parent.identifier } : {}),
+            ...(issue.parent?.title ? { parentTitle: issue.parent.title } : {}),
             ...(issue.identifier ? { identifier: issue.identifier } : {}),
             ...(issue.title ? { title: issue.title } : {}),
             ...(issue.description ? { description: issue.description } : {}),

package/dist/linear-status-comment-sync.js

@@ -40,6 +40,7 @@ function renderStatusComment(db, issue, trackedIssue, options) {
         ...(issue.activeRunId !== undefined ? { activeRunId: issue.activeRunId } : {}),
         factoryState: issue.factoryState,
         pendingRunType: issue.pendingRunType,
+        orchestrationSettleUntil: issue.orchestrationSettleUntil,
         ...(issue.prNumber !== undefined ? { prNumber: issue.prNumber } : {}),
         ...(issue.prState ? { prState: issue.prState } : {}),
         prHeadSha: issue.prHeadSha,

package/dist/no-pr-completion-check.js

@@ -168,6 +168,9 @@ export async function handleNoPrCompletionCheck(params) {
             });
             return;
         }
+        const orchestrationOpenChildren = params.issue.issueClass === "orchestration"
+            ? params.db.issues.countOpenChildIssues(params.run.projectId, params.run.linearIssueId)
+            : 0;
         const completed = params.withHeldLease(params.run.projectId, params.run.linearIssueId, (lease) => {
             params.db.runs.finishRun(params.run.id, completedRunUpdate);
             params.db.runs.saveCompletionCheck(params.run.id, completionCheck);
@@ -176,9 +179,10 @@ export async function handleNoPrCompletionCheck(params) {
                 projectId: params.run.projectId,
                 linearIssueId: params.run.linearIssueId,
                 activeRunId: null,
-                factoryState: "done",
+                factoryState: params.issue.issueClass === "orchestration" && orchestrationOpenChildren > 0 ? "delegated" : "done",
                 pendingRunType: null,
                 pendingRunContextJson: null,
+                orchestrationSettleUntil: null,
                 lastGitHubFailureSource: null,
                 lastGitHubFailureHeadSha: null,
                 lastGitHubFailureSignature: null,
@@ -203,8 +207,12 @@ export async function handleNoPrCompletionCheck(params) {
             fallbackIssue: params.issue,
             level: "info",
             status: "completion_check_done",
-            summary: "No PR found; confirmed done",
-            detail: completionCheck.summary,
+            summary: params.issue.issueClass === "orchestration" && orchestrationOpenChildren > 0
+                ? "No PR found; orchestration will wait on child deliveries"
+                : "No PR found; confirmed done",
+            detail: params.issue.issueClass === "orchestration" && orchestrationOpenChildren > 0
+                ? `${completionCheck.summary} Waiting on ${orchestrationOpenChildren} open child issue(s) before final convergence.`
+                : completionCheck.summary,
             activity: buildCompletionCheckActivity("done", completionCheck),
         });
         const doneIssue = params.db.issues.getIssue(params.run.projectId, params.run.linearIssueId) ?? params.issue;