@telora/daemon 0.22.104 → 0.22.131

package/dist/resolvers/shared/review-window-commits.js

@@ -0,0 +1,262 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/review-exit-foreign-findings.test.ts,
+//   packages/daemon/src/completion/review-exit-foreign-focus-regression.test.ts,
+//   packages/daemon/src/resolvers/shared/review-window-commits.test.ts
+// PINNED-BY-END
+/**
+ * Partition a review window's commits into the reviewing focus's OWN work and
+ * another focus's work, by each commit's `Telora-Delivery` trailer.
+ *
+ * The failure this serves (2026-09-15): a focus branch merges integration back
+ * in, so its incremental review range (reviewed_through_sha..tip) carries every
+ * commit a SIBLING focus merged to integration. The reviewer judged those commits
+ * as this focus's work and filed their defects on this focus's in-verify delivery
+ * -- so the focus re-entered coding for code it did not write, and could not
+ * converge while the sibling kept changing shared code (10 gaps_found cycles with
+ * every acceptance criterion met).
+ *
+ * The trailer is the per-commit fact that attributes a commit to a delivery
+ * (docs/daemon/verify-evidence-and-attribution.md section 3). A commit whose
+ * trailer names a delivery OUTSIDE the reviewing focus's delivery set is foreign.
+ * Everything else -- this focus's own trailers, the non-delivery sentinel, and an
+ * unattributed commit -- counts as the focus's own: the partition fails toward
+ * JUDGING a commit, never toward skipping one.
+ *
+ * Consumers: the git.diff_against_base resolver (a window carrying foreign
+ * commits is judged on the focus's own commit patches only -- buildOwnCommitsDiff
+ * -- with the foreign commits listed as not-judged context) and the review-exit
+ * foreign-finding backstop (completion/review-exit-foreign-findings.ts), which
+ * also attributes a sha-less file:line finding by blame (blameLineCommits).
+ *
+ * @module resolvers/shared/review-window-commits
+ */
+import { execFileSync } from 'node:child_process';
+import { DELIVERY_TRAILER_KEY, classifyTrailerValue } from './git-diff.js';
+/**
+ * The most commits one window read classifies. A window past it is truncated to
+ * its newest commits, and the rest are simply not listed as foreign -- so an
+ * oversized window fails toward judging (an unlisted commit is treated as own,
+ * and the resolver judges the aggregate diff rather than an incomplete own set).
+ */
+export const REVIEW_WINDOW_COMMIT_CAP = 500;
+/**
+ * Pure: partition a window by trailer. Foreign iff the trailer names a delivery
+ * not in `ownDeliveryIds`. An EMPTY own set partitions nothing as foreign -- with
+ * no known deliveries every trailered commit would read foreign, which is a
+ * missing input, not a finding.
+ */
+export function partitionReviewWindowCommits(commits, ownDeliveryIds) {
+    const own = [];
+    const foreign = [];
+    for (const c of commits) {
+        if (ownDeliveryIds.size > 0 && c.attribution.kind === 'delivery' && !ownDeliveryIds.has(c.attribution.deliveryId)) {
+            foreign.push({ sha: c.sha, subject: c.subject, deliveryId: c.attribution.deliveryId });
+        }
+        else {
+            own.push(c);
+        }
+    }
+    return { own, foreign };
+}
+const FIELD_SEP = '\x1f';
+const RECORD_SEP = '\x1e';
+const GIT_READ = { maxBuffer: 10 * 1024 * 1024, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] };
+/**
+ * Pure: parse the batched `git log` output {@link listReviewWindowCommits} reads.
+ * Each record is `<sha> US <subject> US <trailer values, newline-separated> RS`;
+ * the first non-empty trailer value is taken, exactly as readDeliveryTrailer does.
+ */
+export function parseReviewWindowLog(output) {
+    const commits = [];
+    for (const record of output.split(RECORD_SEP)) {
+        const trimmed = record.replace(/^\n+/, '');
+        if (trimmed === '')
+            continue;
+        const [sha = '', subject = '', trailers = ''] = trimmed.split(FIELD_SEP);
+        const cleanSha = sha.trim();
+        if (cleanSha === '')
+            continue;
+        const raw = trailers.split('\n').map((l) => l.trim()).find((l) => l !== '') ?? '';
+        commits.push({ sha: cleanSha, subject: subject.trim(), attribution: classifyTrailerValue(raw) });
+    }
+    return commits;
+}
+/**
+ * The non-merge commits in `<base>..<tip>` (newest first), each classified by its
+ * `Telora-Delivery` trailer through the same git trailer parse the per-commit read
+ * uses. One git process for the whole window. Returns null when git fails (an
+ * unreadable ref or worktree) so a caller can tell "unreadable" from "empty".
+ * Merges are excluded: a merge carries no trailer, and its own content (a conflict
+ * resolution) is the merging focus's work.
+ */
+export function listReviewWindowCommits(worktreePath, base, tip, cap = REVIEW_WINDOW_COMMIT_CAP) {
+    const from = (base ?? '').trim();
+    const to = (tip ?? '').trim();
+    if (worktreePath === '' || from === '' || to === '')
+        return null;
+    try {
+        const out = execFileSync('git', [
+            'log',
+            '--no-merges',
+            `--max-count=${cap}`,
+            `--format=%H${FIELD_SEP}%s${FIELD_SEP}%(trailers:key=${DELIVERY_TRAILER_KEY},valueonly)${RECORD_SEP}`,
+            `${from}..${to}`,
+            '--',
+        ], { cwd: worktreePath, ...GIT_READ });
+        return parseReviewWindowLog(out);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The merge commits on the FIRST-PARENT chain of `<base>..<tip>` (newest first):
+ * the merges made on the focus branch itself (integration merged in). Their
+ * conflict resolutions are the focus's own work. A merge reached only through a
+ * second parent (a sibling branch merged into integration) is not listed. Null
+ * when git fails.
+ */
+export function listFirstParentMerges(worktreePath, base, tip) {
+    if (worktreePath === '' || base.trim() === '' || tip.trim() === '')
+        return null;
+    try {
+        const out = execFileSync('git', ['rev-list', '--merges', '--first-parent', `${base.trim()}..${tip.trim()}`, '--'], {
+            cwd: worktreePath, ...GIT_READ,
+        });
+        return out.split('\n').map((l) => l.trim()).filter((l) => l !== '');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * One commit's own patch, headed `commit <short sha> <subject>`. A merge shows
+ * what it changed over git's automatic re-merge of its parents
+ * (`--remerge-diff`): every conflict it decided -- including one resolved to
+ * exactly one parent's side, which a dense combined diff (`--cc`) omits
+ * entirely -- and any edit beyond the merge, with the incoming side shown only
+ * inside the conflict it decided. A clean merge yields ''; a non-merge commit's
+ * patch is unchanged by the flag. Null when git fails (the caller then judges
+ * the aggregate diff).
+ */
+function showCommitPatch(worktreePath, sha) {
+    try {
+        const out = execFileSync('git', ['show', '--no-color', '--remerge-diff', `--format=${FIELD_SEP}%h %s${FIELD_SEP}`, sha, '--'], {
+            cwd: worktreePath, ...GIT_READ,
+        });
+        const [, header = '', ...rest] = out.split(FIELD_SEP);
+        const body = rest.join(FIELD_SEP).replace(/^\n+/, '');
+        return body.trim() === '' ? '' : `commit ${header}\n${body}`;
+    }
+    catch {
+        return null;
+    }
+}
+/** `git show --stat` of one commit (the truncation header). Empty on failure. */
+function showCommitStat(worktreePath, sha) {
+    try {
+        return execFileSync('git', ['show', '--no-color', '--stat', '--format=commit %h %s', sha, '--'], {
+            cwd: worktreePath, ...GIT_READ,
+        });
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * The judged diff when a review window carries foreign commits: each OWN
+ * non-merge commit's patch (oldest first), then the conflict resolutions of the
+ * merges on the focus branch's first-parent chain -- never a foreign commit's
+ * hunks. Null when any git read fails, so the caller falls back to the aggregate
+ * diff (fail toward judging, never toward a silently thinner diff).
+ */
+export function buildOwnCommitsDiff(worktreePath, base, own) {
+    const merges = listFirstParentMerges(worktreePath, base, 'HEAD');
+    if (merges === null)
+        return null;
+    const shas = [...own.map((c) => c.sha)].reverse().concat([...merges].reverse());
+    const patches = [];
+    for (const sha of shas) {
+        const patch = showCommitPatch(worktreePath, sha);
+        if (patch === null)
+            return null;
+        if (patch !== '')
+            patches.push(patch);
+    }
+    return {
+        diff: patches.join('\n'),
+        stat: () => shas.map((sha) => showCommitStat(worktreePath, sha)).filter((s) => s.trim() !== '').join('\n'),
+    };
+}
+/**
+ * Pure: the commit each line of `git blame --porcelain` output is attributed to,
+ * in line order. Every blamed line opens with a `<40-hex sha> <orig> <final>`
+ * header (the first line of a group adds a count); content lines start with a tab.
+ */
+export function parseBlamePorcelain(output) {
+    const shas = [];
+    for (const line of output.split('\n')) {
+        const m = /^([0-9a-f]{40}) \d+ \d+/.exec(line);
+        if (m?.[1])
+            shas.push(m[1]);
+    }
+    return shas;
+}
+/**
+ * The commit that last changed each line `start..end` (1-based, inclusive) of
+ * `file` as of `tip` (`git blame --porcelain`), in line order. Null when the
+ * range is malformed or git fails (a missing file, a range past the end of the
+ * file, an unreadable ref), or when the read does not cover every requested line
+ * -- so a caller can tell "unblameable" from an attribution.
+ */
+export function blameLineCommits(worktreePath, tip, file, start, end) {
+    if (worktreePath === '' || tip.trim() === '' || file.trim() === '')
+        return null;
+    if (!Number.isInteger(start) || !Number.isInteger(end) || start < 1 || end < start)
+        return null;
+    try {
+        const out = execFileSync('git', ['blame', '--porcelain', '-L', `${start},${end}`, tip.trim(), '--', file], {
+            cwd: worktreePath, ...GIT_READ,
+        });
+        const shas = parseBlamePorcelain(out);
+        return shas.length === end - start + 1 ? shas : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Pure: the prompt section that marks foreign commits in the reviewer's range as
+ * not this focus's work. Empty string when there are none (the section is omitted).
+ * `hunksExcluded`: the judged diff left their changes out (own-commit scoping), so
+ * the list is context only; otherwise (the aggregate fallback) their hunks are in
+ * the diff and the list tells the reviewer not to judge them.
+ */
+export function buildForeignCommitsSection(foreign, opts = {}) {
+    if (foreign.length === 0)
+        return '';
+    const lines = [
+        '### Commits in this range that are NOT this focus\'s work',
+        '',
+        ...(opts.hunksExcluded
+            ? [
+                'These commits are in this review\'s range, but their `Telora-Delivery` trailer names a',
+                'delivery of ANOTHER focus (they arrived by merging integration). Their changes are NOT in',
+                'the diff below and are not judged as this focus\'s work -- this list is context only. A',
+                'blocking defect you find in one of them anyway is filed on its OWNING delivery (listed),',
+                'with the commit sha named in the issue description -- never on this focus\'s in-verify delivery.',
+            ]
+            : [
+                'These commits are in the diff range above, but their `Telora-Delivery` trailer names a',
+                'delivery of ANOTHER focus (they arrived by merging integration). Do not judge them as this',
+                'focus\'s work. A blocking defect in one of them is filed on its OWNING delivery (listed),',
+                'with the commit sha named in the issue description -- never on this focus\'s in-verify delivery.',
+            ]),
+        '',
+    ];
+    for (const c of foreign) {
+        lines.push(`- \`${c.sha.slice(0, 12)}\` ${c.subject} (owning delivery \`${c.deliveryId}\`)`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=review-window-commits.js.map

package/dist/resolvers/shared/review-window-commits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-window-commits.js","sourceRoot":"","sources":["../../../src/resolvers/shared/review-window-commits.ts"],"names":[],"mappings":"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"}

package/dist/session/session-lineage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-lineage.d.ts","sourceRoot":"","sources":["../../src/session/session-lineage.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;GAcG;AAEH,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnD,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAChG,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACtC,GAAG,WAAW,CAKd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,iBAAiB,CAAC;CAC/B,GAAG,MAAM,GAAG,IAAI,CAGhB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAKV"}
+{"version":3,"file":"session-lineage.d.ts","sourceRoot":"","sources":["../../src/session/session-lineage.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;GAcG;AAEH,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnD,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAChG,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACtC,GAAG,WAAW,CAKd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,iBAAiB,CAAC;CAC/B,GAAG,MAAM,GAAG,IAAI,CAGhB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAKV"}

package/dist/session/session-lineage.js

@@ -1,9 +1,12 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
 // Pinned by: packages/daemon/src/directive/directive-executor-characterization.test.ts,
 //   packages/daemon/src/focus/focus-executor-characterization.test.ts,
+//   packages/daemon/src/integration/review-rework-resume-verdict.test.ts,
+//   packages/daemon/src/integration/verification-rework-resume-verdict.test.ts,
 //   packages/daemon/src/session/session-lineage.test.ts,
 //   packages/daemon/src/session/session-pass-close.test.ts,
-//   packages/daemon/src/session/session-pass-write-path.test.ts
+//   packages/daemon/src/session/session-pass-write-path.test.ts,
+//   packages/daemon/src/spawn/prompt-assembly-resume-verdict.test.ts
 // PINNED-BY-END
 /**
  * Persisted resume-slot key for an engine + lineage pair.

package/dist/session/session-lineage.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-lineage.js","sourceRoot":"","sources":["../../src/session/session-lineage.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wFAAwF;AACxF,uEAAuE;AACvE,yDAAyD;AACzD,4DAA4D;AAC5D,gEAAgE;AAChE,gBAAgB;AA2BhB;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAGlC;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO;WACjC,CAAC,IAAI,CAAC,SAAS,KAAK,WAAW,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3F,MAAM,UAAU,GAAsB,IAAI,CAAC,QAAQ,EAAE,UAAU,IAAI,QAAQ,CAAC;IAC5E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,IAK/B;IACC,IAAI,IAAI,CAAC,UAAU,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAA8C,EAC9C,QAAgB,EAChB,OAAe,EACf,SAAiB;IAEjB,OAAO,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,IAO/B;IACC,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,kBAAkB,KAAK,IAAI,CAAC,cAAc,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC,aAAa,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"session-lineage.js","sourceRoot":"","sources":["../../src/session/session-lineage.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wFAAwF;AACxF,uEAAuE;AACvE,0EAA0E;AAC1E,gFAAgF;AAChF,yDAAyD;AACzD,4DAA4D;AAC5D,iEAAiE;AACjE,qEAAqE;AACrE,gBAAgB;AA2BhB;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAGlC;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO;WACjC,CAAC,IAAI,CAAC,SAAS,KAAK,WAAW,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3F,MAAM,UAAU,GAAsB,IAAI,CAAC,QAAQ,EAAE,UAAU,IAAI,QAAQ,CAAC;IAC5E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,IAK/B;IACC,IAAI,IAAI,CAAC,UAAU,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAA8C,EAC9C,QAAgB,EAChB,OAAe,EACf,SAAiB;IAEjB,OAAO,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,IAO/B;IACC,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,kBAAkB,KAAK,IAAI,CAAC,cAAc,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC,aAAa,CAAC;AAC5B,CAAC"}

package/dist/shell/fail-stop.d.ts

@@ -0,0 +1,18 @@
+/** The exit code a fail-stopped daemon exits with (EX_SOFTWARE). */
+export declare const FAIL_STOP_EXIT_CODE = 70;
+/** Injectable seam; defaults to signalling this process. */
+export interface FailStopDeps {
+    signalSelf?: () => void;
+}
+/**
+ * Request the daemon fail-stop, naming why. Returns false when one was already
+ * requested (nothing is signalled again).
+ */
+export declare function requestDaemonFailStop(reason: string, deps?: FailStopDeps): boolean;
+/** Whether a fail-stop was requested: its SIGTERM tears down at once, never at a drain boundary (shell/graceful-shutdown.ts). */
+export declare function isDaemonFailStopRequested(): boolean;
+/** The exit code the graceful shutdown exits with: FAIL_STOP_EXIT_CODE once a fail-stop was requested, else 0. */
+export declare function daemonExitCode(): number;
+/** Test-only: forget a requested fail-stop. */
+export declare function __resetFailStopForTesting(): void;
+//# sourceMappingURL=fail-stop.d.ts.map

package/dist/shell/fail-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail-stop.d.ts","sourceRoot":"","sources":["../../src/shell/fail-stop.ts"],"names":[],"mappings":"AA6BA,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAMtF;AAED,iIAAiI;AACjI,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,kHAAkH;AAClH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,+CAA+C;AAC/C,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/shell/fail-stop.js

@@ -0,0 +1,53 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/shell/fail-stop.test.ts, packages/daemon/src/shell/graceful-shutdown.test.ts
+// PINNED-BY-END
+/**
+ * Daemon fail-stop: the terminal act of a bounded hold when nothing can record
+ * what it owes.
+ *
+ * Every hold ends in teardown or an escalation. An escalation needs a writer: the
+ * product API, or failing that the local escalation spool (queries/escalation-spool.ts).
+ * When BOTH stay unavailable past the hold's last bound, no escalation can be
+ * recorded, and holding on would be the unbounded wait the contract forbids. The
+ * hold then fires teardown of the daemon itself. requestDaemonFailStop signals the
+ * process with SIGTERM, which runs the ordinary graceful shutdown (teams torn down
+ * within the stop budget, worktrees kept, the PID lock released), and that shutdown
+ * exits with FAIL_STOP_EXIT_CODE instead of 0. The stopped daemon is then the
+ * signal no writer could leave: its heartbeat stops, and its supervisor sees a
+ * failed exit.
+ *
+ * Requested once: a second request is a no-op, so polls that race the shutdown
+ * never re-signal.
+ *
+ * @module shell/fail-stop
+ */
+import { createLogger } from './log.js';
+const log = createLogger({ module: 'shell' });
+/** The exit code a fail-stopped daemon exits with (EX_SOFTWARE). */
+export const FAIL_STOP_EXIT_CODE = 70;
+let failStopReason = null;
+/**
+ * Request the daemon fail-stop, naming why. Returns false when one was already
+ * requested (nothing is signalled again).
+ */
+export function requestDaemonFailStop(reason, deps = {}) {
+    if (failStopReason !== null)
+        return false;
+    failStopReason = reason;
+    log.error(`[fail-stop] stopping the daemon (exit code ${FAIL_STOP_EXIT_CODE}): ${reason}`);
+    (deps.signalSelf ?? (() => process.kill(process.pid, 'SIGTERM')))();
+    return true;
+}
+/** Whether a fail-stop was requested: its SIGTERM tears down at once, never at a drain boundary (shell/graceful-shutdown.ts). */
+export function isDaemonFailStopRequested() {
+    return failStopReason !== null;
+}
+/** The exit code the graceful shutdown exits with: FAIL_STOP_EXIT_CODE once a fail-stop was requested, else 0. */
+export function daemonExitCode() {
+    return isDaemonFailStopRequested() ? FAIL_STOP_EXIT_CODE : 0;
+}
+/** Test-only: forget a requested fail-stop. */
+export function __resetFailStopForTesting() {
+    failStopReason = null;
+}
+//# sourceMappingURL=fail-stop.js.map

package/dist/shell/fail-stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail-stop.js","sourceRoot":"","sources":["../../src/shell/fail-stop.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,8GAA8G;AAC9G,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAE9C,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAOtC,IAAI,cAAc,GAAkB,IAAI,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,OAAqB,EAAE;IAC3E,IAAI,cAAc,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1C,cAAc,GAAG,MAAM,CAAC;IACxB,GAAG,CAAC,KAAK,CAAC,8CAA8C,mBAAmB,MAAM,MAAM,EAAE,CAAC,CAAC;IAC3F,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iIAAiI;AACjI,MAAM,UAAU,yBAAyB;IACvC,OAAO,cAAc,KAAK,IAAI,CAAC;AACjC,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,cAAc;IAC5B,OAAO,yBAAyB,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,yBAAyB;IACvC,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/shell/graceful-shutdown.d.ts

@@ -0,0 +1,48 @@
+import { type StopRequest } from './stop-request.js';
+/** The engine surface shutdown drives. */
+export interface ShutdownEngine {
+    name: string;
+    stop(): void;
+    shutdown(): Promise<void>;
+}
+/** What the graceful shutdown tears down, and the process-wide effects it takes. */
+export interface GracefulShutdownDeps {
+    engines: ReadonlyArray<ShutdownEngine>;
+    governor: {
+        shutdown(): void;
+    };
+    pidFilePath: string;
+    /** Claim the shutdown: false when one is already under way (the flag the shell's other exits share). */
+    claimShutdown: () => boolean;
+    /** The shared stop budget the engine drain and the fleet reap fit inside together. */
+    stopDrainBudgetMs: number;
+    /** Floor for the reap budget when the engine drain overran the stop budget. */
+    reapMinBudgetMs: number;
+    reapWorkerFleet: (budgetMs: number) => Promise<unknown>;
+    clearWorkerPidfile: () => void;
+    stopCircuitWedgeWatcher: () => void;
+    stopOtlpReceiver: () => Promise<void>;
+    stopTelemetryWriter: () => Promise<void>;
+    stopLacunaSidecar: () => Promise<void>;
+    cleanupLogTee: (() => void) | null;
+    removeDaemonMeta: () => void;
+    releasePidLock: (pidFilePath: string) => void;
+    now?: () => number;
+    /** Ends the process. Defaults to process.exit. */
+    exit?: (code: number) => void;
+}
+/** Build the daemon's graceful shutdown (see the module header). */
+export declare function createGracefulShutdown(deps: GracefulShutdownDeps): (signal: string) => Promise<void>;
+/** How the stop signals reach the shutdown. */
+export interface StopSignalDeps {
+    shutdown: (signal: string) => Promise<void>;
+    /** Defer `teardown` to the fleet's zero-team boundary (the drain-to-idle path). */
+    runDrain: (teardown: () => Promise<void>) => Promise<unknown>;
+    readStopRequest?: () => StopRequest | null;
+    clearStopRequest?: () => void;
+    /** Registers a signal handler. Defaults to process.on. */
+    onSignal?: (signal: 'SIGINT' | 'SIGTERM', handler: () => void) => void;
+}
+/** Route SIGINT and SIGTERM to the shutdown (see the module header). */
+export declare function registerStopSignals(deps: StopSignalDeps): void;
+//# sourceMappingURL=graceful-shutdown.d.ts.map

package/dist/shell/graceful-shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graceful-shutdown.d.ts","sourceRoot":"","sources":["../../src/shell/graceful-shutdown.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAuD,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAK1G,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,oFAAoF;AACpF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACvC,QAAQ,EAAE;QAAE,QAAQ,IAAI,IAAI,CAAA;KAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,wGAAwG;IACxG,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,sFAAsF;IACtF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,uBAAuB,EAAE,MAAM,IAAI,CAAC;IACpC,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IACnC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,kDAAkD;IAClD,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAMD,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAoFpG;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,mFAAmF;IACnF,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,eAAe,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC3C,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACxE;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CA0B9D"}

package/dist/shell/graceful-shutdown.js

@@ -0,0 +1,152 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/shell/graceful-shutdown.test.ts
+// PINNED-BY-END
+/**
+ * The unified daemon's graceful shutdown and the stop signals that run it.
+ *
+ * runUnifiedDaemon (shell/unified-shell.ts) builds its shutdown with
+ * createGracefulShutdown and routes SIGINT / SIGTERM to it with
+ * registerStopSignals. They live here, with every process-wide effect injected,
+ * so the process's actual exit is observable: the exit code is the only signal a
+ * daemon fail-stop (shell/fail-stop.ts) leaves when neither the escalation API
+ * nor the local spool can record what a hold owes, and graceful-shutdown.test.ts
+ * drives both functions in a child process and reads that exit code.
+ *
+ * Shutdown sequence (idempotent; a second call is a no-op):
+ *   1. stop every engine accepting new work;
+ *   2. shut every engine down in parallel;
+ *   2.4 reap the worker fleet within what remains of the stop drain budget;
+ *   2.5 stop telemetry capture and the Lacuna sidecar;
+ *   3. release the log tee, daemon meta and PID lock, then exit with
+ *      daemonExitCode() -- 0, or FAIL_STOP_EXIT_CODE after a fail-stop.
+ *
+ * Stop signals: SIGINT and an external SIGTERM (no stop-request file) tear down
+ * at once; a SIGTERM carrying a `drain` stop-request defers teardown to the
+ * zero-team boundary, and a second stop signal during that drain forces it. A
+ * requested fail-stop always tears down at once: its SIGTERM ends a bounded hold,
+ * and a stale `drain` request left beside it must not turn that into an unbounded
+ * wait for the fleet to idle.
+ *
+ * @module shell/graceful-shutdown
+ */
+import { daemonExitCode, isDaemonFailStopRequested } from './fail-stop.js';
+import { setDaemonShuttingDown } from './shutdown-state.js';
+import { clearStopRequest, decideStopAction, readStopRequest } from './stop-request.js';
+import { createLogger } from './log.js';
+const log = createLogger({ module: 'telemetry' });
+function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Build the daemon's graceful shutdown (see the module header). */
+export function createGracefulShutdown(deps) {
+    const now = deps.now ?? Date.now;
+    const exit = deps.exit ?? ((code) => process.exit(code));
+    return async (signal) => {
+        if (!deps.claimShutdown())
+            return;
+        setDaemonShuttingDown();
+        // Start of the graceful-stop drain budget. The engine team drain (Phase 2)
+        // and the worker-fleet reap (Phase 2.4) must TOGETHER fit inside the stop
+        // budget -- the same window the CLI's stopDaemon() waits -- so the reap is
+        // given the REMAINING budget, never a fresh one.
+        const drainStartedAt = now();
+        log.info(`\nReceived ${signal}, shutting down gracefully...`);
+        // Shut down the resource governor (reject pending acquires)
+        deps.governor.shutdown();
+        // Phase 1: Stop all engines (stop accepting new work)
+        for (const engine of deps.engines) {
+            try {
+                engine.stop();
+                log.info(`[${engine.name}] Stopped accepting new work`);
+            }
+            catch (err) {
+                log.warn(`[${engine.name}] Error during stop: ${message(err)}`);
+            }
+        }
+        // Phase 2: Shut down all engines in parallel (graceful cleanup)
+        const shutdownResults = await Promise.allSettled(deps.engines.map(async (engine) => {
+            try {
+                await engine.shutdown();
+                log.info(`[${engine.name}] Shutdown complete`);
+            }
+            catch (err) {
+                log.warn(`[${engine.name}] Error during shutdown: ${message(err)}`);
+            }
+        }));
+        shutdownResults.forEach((result, i) => {
+            if (result.status === 'rejected') {
+                log.warn(`[${deps.engines[i]?.name ?? 'unknown'}] Shutdown promise rejected: ${String(result.reason)}`);
+            }
+        });
+        // Phase 2.4: Reap the worker fleet within the REMAINING drain window. The
+        // engine shutdown above is the graceful path, but a wedged engine can leave
+        // team-lead AND one-shot `claude --print` processes alive. This backstop
+        // SIGTERMs every tracked worker, waits, and SIGKILL-escalates inside whatever
+        // is LEFT of the shared stop budget, clamped to a small floor so it can still
+        // land SIGKILLs if the engine drain overran -- so `telora-daemon stop` drains
+        // within its budget and no worker orphans to init (the venus incident).
+        // Best-effort: a reap error must never block PID-lock release / process exit.
+        const reapBudgetMs = Math.max(deps.reapMinBudgetMs, deps.stopDrainBudgetMs - (now() - drainStartedAt));
+        try {
+            await deps.reapWorkerFleet(reapBudgetMs);
+        }
+        catch (err) {
+            log.warn(`[reap] Worker-fleet reap failed: ${message(err)}`);
+        }
+        // The fleet is reaped -- clear the persisted lead pidfile so neither the CLI
+        // nor the next boot acts on now-dead pids.
+        deps.clearWorkerPidfile();
+        // Phase 2.5: Stop telemetry capture (flush remaining buffered rows, close
+        // the OTLP receiver socket) and tear down the Lacuna sidecar (SIGTERM).
+        deps.stopCircuitWedgeWatcher();
+        try {
+            await deps.stopOtlpReceiver();
+            await deps.stopTelemetryWriter();
+        }
+        catch (err) {
+            log.warn(`Error during shutdown: ${message(err)}`);
+        }
+        try {
+            await deps.stopLacunaSidecar();
+        }
+        catch (err) {
+            log.warn(`[lacuna] Error during shutdown: ${message(err)}`);
+        }
+        // Phase 3: Release PID lock and clean up, then exit -- non-zero after a fail-stop.
+        deps.cleanupLogTee?.();
+        deps.removeDaemonMeta();
+        deps.releasePidLock(deps.pidFilePath);
+        log.info('Shutdown complete');
+        exit(daemonExitCode());
+    };
+}
+/** Route SIGINT and SIGTERM to the shutdown (see the module header). */
+export function registerStopSignals(deps) {
+    const read = deps.readStopRequest ?? (() => readStopRequest());
+    const clear = deps.clearStopRequest ?? (() => clearStopRequest());
+    const onSignal = deps.onSignal ?? ((signal, handler) => { process.on(signal, handler); });
+    let stopDraining = false;
+    const onStopSignal = (signal) => {
+        const request = read();
+        clear();
+        const failStop = isDaemonFailStopRequested();
+        if (failStop || decideStopAction(signal, request, stopDraining) === 'immediate') {
+            if (failStop && request?.mode === 'drain') {
+                log.info('[drain-teardown] a daemon fail-stop was requested -- tearing down now, not at the zero-team boundary');
+            }
+            else if (stopDraining) {
+                log.info('[drain-teardown] second stop signal received -- forcing immediate teardown');
+            }
+            void deps.shutdown(signal);
+            return;
+        }
+        stopDraining = true;
+        deps.runDrain(() => deps.shutdown('drain-to-idle')).catch((err) => {
+            log.error(`[drain-teardown] deferred teardown failed (${message(err)}) -- tearing down now`);
+            void deps.shutdown(signal);
+        });
+    };
+    onSignal('SIGINT', () => onStopSignal('SIGINT'));
+    onSignal('SIGTERM', () => onStopSignal('SIGTERM'));
+}
+//# sourceMappingURL=graceful-shutdown.js.map

package/dist/shell/graceful-shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graceful-shutdown.js","sourceRoot":"","sources":["../../src/shell/graceful-shutdown.ts"],"names":[],"mappings":"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"}

package/dist/shell/heartbeat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/shell/heartbeat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/shell/heartbeat.ts"],"names":[],"mappings":"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"}

package/dist/shell/heartbeat.js

@@ -292,10 +292,11 @@ export function readOnlyMetadataField() {
 }
 /**
  * Apply the focusId-SCOPED metadata fields (see the classification block
- * below): `narrations` (latest team-lead text), `teamPhases` (each active
- * team's lifecycle phase -- executing / idle_complete / directive_pending /
- * cooldown -- so the dashboard's liveness badge can tell a parked team from a
- * wedged one), and `teamClocks` (the per-team last-activity clock the daemon
+ * below): `narrations` (latest team-lead text), `teamPhases` (each focus's
+ * team lifecycle phase -- executing / awaiting_slot / idle_complete /
+ * directive_pending / cooldown -- so the dashboard's liveness badge can tell a
+ * parked team from a wedged one, and an armed focus waiting for a session slot
+ * from one that is not running), and `teamClocks` (the per-team last-activity clock the daemon
  * itself acts on, so every liveness surface classifies from the one clock the
  * daemon trusts rather than the separately-flushed activity_summary). All three
  * are pull-model: recomputed from live in-memory state each beat, so a change