specrails-desktop 2.55.0 → 2.55.1

package/server/dist/{chat-manager.js → modules/conversations/runtime/chat-manager.js}

@@ -3,130 +3,37 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChatManager = exports.EXPLORE_QUEUE_TIMEOUT_MS = exports.EXPLORE_MAX_CONCURRENCY = exports.EXPLORE_IDLE_KILL_MS = void 0;
-exports.filterDraftBlocksLive = filterDraftBlocksLive;
+exports.ChatManager = exports.EXPLORE_QUEUE_TIMEOUT_MS = exports.EXPLORE_MAX_CONCURRENCY = exports.EXPLORE_IDLE_KILL_MS = exports.filterDraftBlocksLive = void 0;
+const __1 = require("..");
+var __2 = require("..");
+Object.defineProperty(exports, "filterDraftBlocksLive", { enumerable: true, get: function () { return __2.filterDraftBlocksLive; } });
 const readline_1 = require("readline");
 const tree_kill_1 = __importDefault(require("tree-kill"));
-const db_1 = require("./db");
-const command_resolver_1 = require("./command-resolver");
-const cli_prompt_1 = require("./util/cli-prompt");
+const db_1 = require("../../../db");
+const command_resolver_1 = require("../../../command-resolver");
+const cli_prompt_1 = require("../../../util/cli-prompt");
 const explore_cwd_manager_1 = require("./explore-cwd-manager");
-const ai_invocations_1 = require("./ai-invocations");
-const result_event_1 = require("./result-event");
+const ai_invocations_1 = require("../../accounting/runtime/ai-invocations");
+const result_event_1 = require("../../accounting/runtime/result-event");
 const crypto_1 = require("crypto");
-const codex_spawn_1 = require("./plugins/codex-spawn");
-const spec_draft_parser_1 = require("./spec-draft-parser");
-const attachment_manager_1 = require("./attachment-manager");
-const providers_1 = require("./providers");
-const runtime_1 = require("./providers/runtime");
+const codex_spawn_1 = require("../../../plugins/codex-spawn");
+const spec_draft_parser_1 = require("../../specs/runtime/spec-draft-parser");
+const attachment_manager_1 = require("../../../attachment-manager");
+const providers_1 = require("../../../providers");
+const runtime_1 = require("../../../providers/runtime");
 const context_scope_1 = require("./context-scope");
-const user_mcp_config_1 = require("./user-mcp-config");
-const registry_1 = require("./providers/registry");
-const binary_probe_1 = require("./binary-probe");
+const user_mcp_config_1 = require("../../../user-mcp-config");
+const registry_1 = require("../../../providers/registry");
+const binary_probe_1 = require("../../../binary-probe");
 const explore_stdin_session_1 = require("./explore-stdin-session");
-const workspace_resolution_1 = require("./workspace-resolution");
-const workspace_manager_1 = require("./workspace-manager");
-const blueprint_render_1 = require("./blueprint-render");
-const spec_contract_prompt_1 = require("./spec-contract-prompt");
+const workspace_resolution_1 = require("../../../workspace-resolution");
+const workspace_manager_1 = require("../../../workspace-manager");
+const blueprint_render_1 = require("../../builder/runtime/blueprint-render");
+const spec_contract_prompt_1 = require("../../specs/runtime/spec-contract-prompt");
 const explore_draft_title_1 = require("./explore-draft-title");
 const COMMAND_INSTRUCTION = 'When you want to suggest a SpecRails command for the user to execute, wrap it in a command block like this: ' +
     ':::command\n/specrails:implement #42\n::: ' +
     'The user will be prompted to confirm before the command runs.';
-/** Claude stores resumable sessions under the spawn cwd. Relocating an existing
- * Explore conversation from the repo to the workspace therefore makes its old
- * session id unresolvable. Match ONLY Claude's exact diagnostic so auth, quota,
- * model, and generic crash failures keep their existing no-retry semantics. */
-const CLAUDE_MISSING_SESSION_DIAGNOSTIC = 'No conversation found with session ID';
-/** Historical context folded into the one-time fresh-session recovery. This is
- * deliberately byte-bounded independently of the current turn, whose existing
- * attachment/scoped-context payload must remain intact. */
-const RESUME_RECOVERY_TRANSCRIPT_MAX_BYTES = 48 * 1024;
-function containsMissingClaudeSessionDiagnostic(value) {
-    if (typeof value === 'string') {
-        return value.includes(CLAUDE_MISSING_SESSION_DIAGNOSTIC);
-    }
-    if (value == null)
-        return false;
-    try {
-        return JSON.stringify(value).includes(CLAUDE_MISSING_SESSION_DIAGNOSTIC);
-    }
-    catch {
-        return false;
-    }
-}
-function isMissingClaudeSessionErrorResult(value) {
-    if (!value || typeof value !== 'object')
-        return false;
-    const payload = value;
-    const markedAsError = payload.is_error === true ||
-        (typeof payload.subtype === 'string' && payload.subtype.startsWith('error'));
-    return markedAsError && containsMissingClaudeSessionDiagnostic(value);
-}
-function takeUtf8Tail(text, maxBytes) {
-    if (maxBytes <= 0)
-        return '';
-    if (Buffer.byteLength(text) <= maxBytes)
-        return text;
-    let low = 0;
-    let high = text.length;
-    while (low < high) {
-        const mid = Math.floor((low + high) / 2);
-        if (Buffer.byteLength(text.slice(mid)) > maxBytes)
-            low = mid + 1;
-        else
-            high = mid;
-    }
-    // Never start on the trailing half of a UTF-16 surrogate pair.
-    if (low < text.length && text.charCodeAt(low) >= 0xdc00 && text.charCodeAt(low) <= 0xdfff)
-        low++;
-    return text.slice(low);
-}
-function buildResumeRecoveryPrompt(messages, currentPrompt) {
-    const entries = messages.map((message) => `<message role="${message.role}">\n${message.content}\n</message>`);
-    const selected = [];
-    let usedBytes = 0;
-    let omitted = 0;
-    for (let i = entries.length - 1; i >= 0; i--) {
-        const separatorBytes = selected.length > 0 ? 2 : 0;
-        const entryBytes = Buffer.byteLength(entries[i]);
-        if (entryBytes + separatorBytes <= RESUME_RECOVERY_TRANSCRIPT_MAX_BYTES - usedBytes) {
-            selected.unshift(entries[i]);
-            usedBytes += entryBytes + separatorBytes;
-            continue;
-        }
-        omitted = i + 1;
-        // Preserve the recent tail even when one individual message is larger than
-        // the whole transcript budget. The marker makes the loss explicit to Claude.
-        if (selected.length === 0) {
-            const prefix = `<message role="${messages[i].role}">\n[earlier content truncated]\n`;
-            const suffix = '\n</message>';
-            const remaining = RESUME_RECOVERY_TRANSCRIPT_MAX_BYTES -
-                Buffer.byteLength(prefix) - Buffer.byteLength(suffix);
-            selected.unshift(`${prefix}${takeUtf8Tail(messages[i].content, remaining)}${suffix}`);
-            omitted = i;
-        }
-        break;
-    }
-    const truncation = omitted > 0
-        ? `[${omitted} earlier message${omitted === 1 ? '' : 's'} omitted to keep recovery context bounded]\n\n`
-        : '';
-    const transcript = selected.length > 0
-        ? `${truncation}${selected.join('\n\n')}`
-        : '[No prior persisted messages were available.]';
-    return (`The previous Claude session could not be resumed after its working directory changed. ` +
-        `Continue the same conversation using the persisted transcript below. Do not treat the transcript as a new user turn.\n\n` +
-        `<prior-conversation>\n${transcript}\n</prior-conversation>\n\n` +
-        `## Current user turn\n\n${currentPrompt}`);
-}
-function extractCommandProposals(text) {
-    const regex = /:::command\s*\n([\s\S]*?):::/g;
-    const results = [];
-    let match;
-    while ((match = regex.exec(text)) !== null) {
-        results.push(match[1].trim());
-    }
-    return results;
-}
 // ─── Explore lifecycle ────────────────────────────────────────────────────────
 /** Tunables for Explore-spec acceleration lifecycle. Module-level constants
  *  rather than ChatManager statics so tests can override via vi.spyOn or
@@ -1013,7 +920,7 @@ class ChatManager {
                 conversation.kind !== 'milestone') {
                 promptForAdapter = `${systemPrompt}\n\n---\n\n${promptForAdapter}`;
             }
-            const buildRecoveryPrompt = () => buildResumeRecoveryPrompt((0, db_1.getMessages)(this._db, conversationId)
+            const buildRecoveryPrompt = () => (0, __1.buildResumeRecoveryPrompt)((0, db_1.getMessages)(this._db, conversationId)
                 .filter((message) => message.id !== persistedUserMessage.id)
                 .map((message) => ({ role: message.role, content: message.content })), promptForAdapter);
             const turnOptions = {
@@ -1137,7 +1044,7 @@ class ChatManager {
                 // user never sees the raw protocol payload mid-stream. The filter holds
                 // back partial fence markers and emits only the user-visible prose.
                 const filter = this._streamFilters.get(conversationId);
-                const visibleDelta = filter ? filterDraftBlocksLive(filter, newText) : newText;
+                const visibleDelta = filter ? (0, __1.filterDraftBlocksLive)(filter, newText) : newText;
                 if (visibleDelta) {
                     this._broadcast({
                         type: 'chat_stream',
@@ -1147,7 +1054,7 @@ class ChatManager {
                     });
                 }
                 // Check for new command proposals
-                const proposals = extractCommandProposals(updated);
+                const proposals = (0, __1.extractCommandProposals)(updated);
                 const emitted = this._emittedProposals.get(conversationId);
                 if (emitted) {
                     for (const proposal of proposals) {
@@ -1245,10 +1152,10 @@ class ChatManager {
                         !wasAborting &&
                         fullText.length === 0 &&
                         !adapterEvents.some((event) => event.kind === 'tool-use') &&
-                        (containsMissingClaudeSessionDiagnostic(capturedErrorMessage) ||
-                            containsMissingClaudeSessionDiagnostic(stderrBuf) ||
+                        ((0, __1.containsMissingClaudeSessionDiagnostic)(capturedErrorMessage) ||
+                            (0, __1.containsMissingClaudeSessionDiagnostic)(stderrBuf) ||
                             adapterEvents.some((event) => event.kind === 'result' &&
-                                isMissingClaudeSessionErrorResult(event.payload)));
+                                (0, __1.isMissingClaudeSessionErrorResult)(event.payload)));
                     if (missingPriorSession) {
                         resumeRecoveryAttempted = true;
                         // The old id is provably unusable from the corrected cwd. Clearing it
@@ -1641,7 +1548,7 @@ class ChatManager {
             const prev = this._buffers.get(conversationId) ?? '';
             this._buffers.set(conversationId, prev + newText);
             const filter = this._streamFilters.get(conversationId);
-            const visibleDelta = filter ? filterDraftBlocksLive(filter, newText) : newText;
+            const visibleDelta = filter ? (0, __1.filterDraftBlocksLive)(filter, newText) : newText;
             if (visibleDelta) {
                 this._broadcast({
                     type: 'chat_stream',
@@ -1650,7 +1557,7 @@ class ChatManager {
                     timestamp: new Date().toISOString(),
                 });
             }
-            const proposals = extractCommandProposals(this._buffers.get(conversationId) ?? '');
+            const proposals = (0, __1.extractCommandProposals)(this._buffers.get(conversationId) ?? '');
             const emitted = this._emittedProposals.get(conversationId);
             if (emitted) {
                 for (const proposal of proposals) {
@@ -1784,8 +1691,8 @@ class ChatManager {
                     this._abortingConversations.has(conversationId) ||
                     (this._buffers.get(conversationId) ?? '').length > 0 ||
                     adapterEvents.some((event) => event.kind === 'tool-use') ||
-                    !(containsMissingClaudeSessionDiagnostic(diagnostic) ||
-                        containsMissingClaudeSessionDiagnostic(stderrBuf))) {
+                    !((0, __1.containsMissingClaudeSessionDiagnostic)(diagnostic) ||
+                        (0, __1.containsMissingClaudeSessionDiagnostic)(stderrBuf))) {
                     return false;
                 }
                 // The persistent child was launched with the stale --resume before its
@@ -1926,7 +1833,7 @@ class ChatManager {
                             break;
                         case 'result': {
                             const payload = ev.payload;
-                            if (recoverMissingSession(isMissingClaudeSessionErrorResult(payload) ? payload : null))
+                            if (recoverMissingSession((0, __1.isMissingClaudeSessionErrorResult)(payload) ? payload : null))
                                 break;
                             if (payload.session_id)
                                 capturedSessionId = payload.session_id;
@@ -2221,94 +2128,3 @@ class ChatManager {
     }
 }
 exports.ChatManager = ChatManager;
-const FENCE_OPEN = '```spec-draft';
-const FENCE_CLOSE = '```';
-// Hold back up to this many trailing chars in the pre-block state so we never
-// emit a partial open fence. -1 because we know the user-visible prefix is at
-// least 1 char shorter than the full marker on every step.
-const PRE_BLOCK_TAIL = FENCE_OPEN.length - 1;
-/**
- * Stateful, side-effect-free filter that consumes `newText` and returns the
- * substring that is safe to broadcast to the chat stream. Holds back partial
- * fence markers in `state.pendingTail` so the next call can resolve them.
- *
- * Behaviour:
- *  - While outside a block: emit text up to (but not including) the start of
- *    a `\`\`\`spec-draft` marker. If no marker is present, hold back the
- *    trailing few chars so a marker starting on a chunk boundary is not
- *    leaked.
- *  - While inside a block: emit nothing. Look for the closing `\`\`\``.
- *    When found, consume it (plus an optional trailing newline) and resume
- *    emitting from the bytes that follow.
- *
- * The filter intentionally does NOT validate the JSON payload — that is
- * server-side concern of `parseSpecDraftBlocks`. It only strips the fenced
- * span.
- */
-function filterDraftBlocksLive(state, newText) {
-    let buf = state.pendingTail + newText;
-    let out = '';
-    state.pendingTail = '';
-    // Iterate in case a single delta contains multiple transitions
-    // (e.g. close + open + close again — pathological but cheap to support).
-    while (buf.length > 0) {
-        if (state.inBlock) {
-            const closeIdx = buf.indexOf(FENCE_CLOSE);
-            if (closeIdx === -1) {
-                // No close yet — but the close could span the chunk boundary.
-                // Hold back up to 2 trailing chars (closing fence is 3 chars; we keep
-                // any trailing run of `\`` so the next call resolves it).
-                const tailLen = trailingBacktickRun(buf, 2);
-                state.pendingTail = buf.slice(buf.length - tailLen);
-                return out;
-            }
-            // Consume the close fence + an optional trailing newline.
-            let after = closeIdx + FENCE_CLOSE.length;
-            if (buf[after] === '\n')
-                after += 1;
-            buf = buf.slice(after);
-            state.inBlock = false;
-            continue;
-        }
-        // Not in block: look for the open marker.
-        const openIdx = buf.indexOf(FENCE_OPEN);
-        if (openIdx !== -1) {
-            out += buf.slice(0, openIdx);
-            buf = buf.slice(openIdx + FENCE_OPEN.length);
-            // Drop an optional newline immediately after the open marker so the
-            // user never sees `\n` belonging to the fence.
-            if (buf[0] === '\n')
-                buf = buf.slice(1);
-            state.inBlock = true;
-            continue;
-        }
-        // No open marker — hold back only the trailing run that could become a
-        // prefix of FENCE_OPEN (i.e. the longest suffix of `buf` that is also a
-        // prefix of FENCE_OPEN). Anything past that is safe to emit.
-        const holdBack = longestSuffixThatIsPrefixOf(buf, FENCE_OPEN);
-        const safeEnd = buf.length - holdBack;
-        out += buf.slice(0, safeEnd);
-        state.pendingTail = buf.slice(safeEnd);
-        return out;
-    }
-    return out;
-}
-/** Length of the longest suffix of `s` that is a prefix of `target`. */
-function longestSuffixThatIsPrefixOf(s, target) {
-    const max = Math.min(s.length, target.length - 1);
-    for (let len = max; len > 0; len--) {
-        if (target.startsWith(s.slice(s.length - len)))
-            return len;
-    }
-    return 0;
-}
-function trailingBacktickRun(s, max) {
-    let n = 0;
-    for (let i = s.length - 1; i >= 0 && n < max; i--) {
-        if (s[i] === '`')
-            n++;
-        else
-            break;
-    }
-    return n;
-}

package/server/dist/{context-budget.js → modules/conversations/runtime/context-budget.js}

@@ -15,7 +15,7 @@ exports.getContextBudget = getContextBudget;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const context_scope_1 = require("./context-scope");
-const workspace_resolution_1 = require("./workspace-resolution");
+const workspace_resolution_1 = require("../../../workspace-resolution");
 const BYTES_PER_TOKEN = 4;
 const CACHE_TTL_MS = 60_000;
 const SKIP_DIRS = new Set([

package/server/dist/{explore-cwd-manager.js → modules/conversations/runtime/explore-cwd-manager.js}

@@ -11,7 +11,7 @@ exports.removeExploreCwd = removeExploreCwd;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
-const providers_1 = require("./providers");
+const providers_1 = require("../../../providers");
 /**
  * ExploreCwdManager owns the per-project app-managed cwd used to spawn the
  * provider CLI for Explore Spec turns. See openspec/changes/accelerate-spec-

package/server/dist/{explore-smash.js → modules/conversations/runtime/explore-smash.js}

@@ -5,7 +5,7 @@
  * Decomposes a committed ticket (with Contract Layer) into 3–8 ordered
  * child tickets. This module contains only the byte-stable system prompt,
  * the output schema, and the parser/validator. The spawn lifecycle and
- * store mutation live in `server/smash-runner.ts`.
+ * store mutation live in `server/modules/specs/runtime/smash-runner.ts`.
  *
  * See openspec/changes/add-specs-smash.
  */

package/server/dist/{explore-stdin-session.js → modules/conversations/runtime/explore-stdin-session.js}

@@ -22,7 +22,7 @@ exports.isExplorePersistentStdinEnabled = isExplorePersistentStdinEnabled;
 exports.frameStreamJsonUserMessage = frameStreamJsonUserMessage;
 const node_readline_1 = require("node:readline");
 const tree_kill_1 = __importDefault(require("tree-kill"));
-const cli_prompt_1 = require("./util/cli-prompt");
+const cli_prompt_1 = require("../../../util/cli-prompt");
 /**
  * Persistent-stdin Explore is opt-in. Default OFF — set
  * `SPECRAILS_EXPLORE_PERSISTENT_STDIN=1` to enable. Any other value (or unset)

package/server/dist/modules/delivery/adapters/decisions/chains.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SWEEPABLE_DECISIONS = void 0;
+exports.sweepMergedChainAncestors = sweepMergedChainAncestors;
+exports.pauseChainsOnDiscard = pauseChainsOnDiscard;
+const rail_worktree_release_1 = require("../../runtime/rail-worktree-release");
+const ids_1 = require("../../../../ids");
+const milestone_chain_store_1 = require("../../../builder/runtime/milestone-chain-store");
+const rail_pr_store_1 = require("../../runtime/rail-pr-store");
+const evidence_1 = require("./evidence");
+const ownership_1 = require("./ownership");
+const transitions_1 = require("./transitions");
+// ─── Milestone chain hooks (premium-milestone-progress D4) ───────────────────
+/** Decisions a stacked sibling can sit at while its head is already merged. */
+exports.SWEEPABLE_DECISIONS = new Set(['on_review', 'pr_draft', 'pr_ready', 'pr_closed']);
+/**
+ * Merging a STACKED delivery also lands every earlier chunk it was built on.
+ * Walk the chain(s) this delivery belongs to and settle each still-undecided
+ * sibling whose delivered head commit is PROVABLY an ancestor of the chain's
+ * integration branch (`git merge-base --is-ancestor`) as `merged` — the same
+ * CAS + ticket effect (`done`) + Jira hook a direct merge runs. Chain-local by
+ * design; siblings whose head is not an ancestor are left untouched. Returns
+ * the swept delivery ids. Never throws.
+ */
+async function sweepMergedChainAncestors(deps, mergedRow) {
+    const swept = [];
+    if (deps.repositoryChildOf)
+        return swept;
+    let chains;
+    try {
+        chains = (0, milestone_chain_store_1.listChainsTouchingDelivery)(deps.db, mergedRow.id);
+    }
+    catch {
+        return swept;
+    }
+    for (const chain of chains) {
+        const integration = chain.integration_branch;
+        if (!integration)
+            continue;
+        for (const entry of (0, milestone_chain_store_1.parseLaunched)(chain)) {
+            if (!entry.deliveryId || entry.deliveryId === mergedRow.id || swept.includes(entry.deliveryId))
+                continue;
+            const other = (0, rail_pr_store_1.getPrDelivery)(deps.db, entry.deliveryId);
+            if (!other || (0, rail_pr_store_1.isTerminalPrDecision)(other.decision) || !exports.SWEEPABLE_DECISIONS.has(other.decision))
+                continue;
+            const snap = (0, rail_pr_store_1.toPrDeliverySnapshot)(other);
+            // An assembled delivery SHA proves the whole chunk. Without that head,
+            // every unit needs its own immutable proof; accepting just the first
+            // ancestor could mark unmerged tickets done and delete their branches.
+            const requiredShas = snap.deliverySha ? [snap.deliverySha] : snap.units.map((unit) => unit.finalSha);
+            const validShas = requiredShas.filter((sha) => typeof sha === 'string' && evidence_1.COMMIT_SHA_RE.test(sha));
+            if (requiredShas.length === 0 || validShas.length !== requiredShas.length)
+                continue;
+            let allAncestors = true;
+            try {
+                for (const sha of new Set(validShas)) {
+                    const r = await deps.git.run(['merge-base', '--is-ancestor', sha, integration], deps.project.path);
+                    if (r.code !== 0) {
+                        allAncestors = false;
+                        break;
+                    }
+                }
+            }
+            catch {
+                allAncestors = false;
+            }
+            if (!allAncestors)
+                continue;
+            const token = (0, ids_1.newId)();
+            if (!(0, rail_pr_store_1.claimPrDeliveryOperation)(deps.db, other.id, other.decision, 'poll-merge', token))
+                continue;
+            let released = false;
+            try {
+                const claimed = { ...other, operation_token: token };
+                const cleanupWarnings = await (0, rail_worktree_release_1.releaseRailWorktrees)({
+                    db: deps.db, git: deps.git, repoDir: deps.project.path,
+                    worktreeIds: (0, ownership_1.releasableWorktreeIds)(deps, snap), state: 'merged',
+                    expectedHeadByBranch: (0, rail_worktree_release_1.durableBranchHeads)(snap.branches),
+                    overlayEvidenceByBranch: (0, rail_worktree_release_1.durableOverlayCleanupEvidence)(snap.branches),
+                    settlementIgnoredByBranch: (0, rail_worktree_release_1.durableSettlementIgnoredPaths)(snap.branches),
+                    onSafetyArchive: (0, transitions_1.safetyArchiveRecorder)(deps, claimed),
+                });
+                await (0, ownership_1.deleteOwnedBranchesIfUnchanged)(deps, claimed, snap, cleanupWarnings);
+                const conflict = (0, transitions_1.casTransitionWithTicketEffect)(deps, claimed, 'merged', {
+                    deliveryOutcome: 'delivered',
+                    statusCode: cleanupWarnings.length > 0 ? 'cleanup_incomplete' : 'merged',
+                    statusDetail: `merged as part of ${mergedRow.rail_key}`,
+                    cleanupWarnings,
+                }, {
+                    deliveryId: claimed.id,
+                    ticketIds: snap.ticketIds,
+                    targetStatus: 'done',
+                    jiraAction: 'merged',
+                    prUrl: claimed.pr_url,
+                });
+                if (conflict)
+                    continue;
+                (0, transitions_1.applyTerminalTicketEffect)(deps, claimed, 'merged', cleanupWarnings);
+                // Release BEFORE finalizing: a row still holding a lease defers its
+                // broadcast to the lease owner's finally, which here would never come.
+                (0, rail_pr_store_1.releasePrDeliveryOperation)(deps.db, other.id, token);
+                released = true;
+                (0, transitions_1.finalizeTransition)(deps, other.id);
+                swept.push(other.id);
+            }
+            catch (err) {
+                console.error(`[milestone-chain] ancestor sweep failed for ${other.id}:`, err);
+            }
+            finally {
+                if (!released)
+                    (0, rail_pr_store_1.releasePrDeliveryOperation)(deps.db, other.id, token);
+            }
+        }
+    }
+    return swept;
+}
+/** A discarded delivery that a chain's later chunks build on pauses those
+ *  chains (`head_discarded`, head rewound to the previous chunk's branch). */
+function pauseChainsOnDiscard(deps, row) {
+    if (deps.repositoryChildOf)
+        return;
+    try {
+        const branchOf = (id) => {
+            const other = (0, rail_pr_store_1.getPrDelivery)(deps.db, id);
+            if (!other)
+                return null;
+            const s = (0, rail_pr_store_1.toPrDeliverySnapshot)(other);
+            return s.branch ?? s.units.find((u) => u.succeeded && u.branch)?.branch ?? null;
+        };
+        const paused = (0, milestone_chain_store_1.pauseChainsForDiscardedHead)(deps.db, row.id, branchOf);
+        for (const chain of paused) {
+            deps.broadcast({ type: 'milestone.chain_changed', projectId: deps.project.id, chain: (0, milestone_chain_store_1.toChainSnapshot)(chain), timestamp: new Date().toISOString() });
+        }
+    }
+    catch (err) {
+        console.error('[milestone-chain] discard hook failed:', err);
+    }
+}

package/server/dist/modules/delivery/adapters/decisions/contracts.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });