@telora/daemon 0.22.239 → 0.22.289

package/dist/queries/escalations/incident-record.js

@@ -0,0 +1,141 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/directive/phase-sync-refusal.test.ts,
+//   packages/daemon/src/drift/drift-eval-loop.test.ts,
+//   packages/daemon/src/focus/pending-spawn-review-next-step.test.ts,
+//   packages/daemon/src/merge/resolver-exhausted-observation.test.ts,
+//   packages/daemon/src/supervision/escalation-refusal.test.ts,
+//   packages/daemon/src/supervision/incident-correlation.test.ts,
+//   packages/daemon/src/supervision/loop-refusal-observation.test.ts,
+//   packages/daemon/src/supervision/oversized-stall-escalation-regression.test.ts
+// PINNED-BY-END
+/**
+ * The INCIDENT record an escalation row carries, and its pure readers: the row
+ * fields correlation reads, metadata.incident_key, the symptoms attached to the
+ * row (metadata.symptoms) and the ones retired from it
+ * (metadata.cleared_symptoms), and the lane a row sits in.
+ *
+ * Readers only -- including the open-row kind / delivery predicates the dedup
+ * reads and close-halves match rows with. What attaches to a row, and when a
+ * symptom is retired, is decided by supervision/incident-correlation.ts; the keys themselves are
+ * queries/escalations/cause-key.ts. Holds, dedup and the routing prompts read an incident
+ * through these narrowers so a malformed metadata bag never reaches them.
+ *
+ * Kept free of VALUE imports that reach @telora/daemon-core or the API client
+ * (the mock-loader note in queries/escalations/escalation-dispositions.ts).
+ */
+import { incidentKey, isIncidentSymptom } from './cause-key.js';
+import { DISPOSITION_AGENT_RESOLVABLE } from './escalation-dispositions.js';
+function nonBlankString(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : null;
+}
+/** Open statuses an incident can be attached to (pending / in_review). */
+export const INCIDENT_OPEN_STATUSES = ['pending', 'in_review'];
+/** Pure: the incident key a metadata bag carries, or null. */
+export function readIncidentKey(metadata) {
+    if (!metadata || typeof metadata !== 'object')
+        return null;
+    return nonBlankString(metadata.incident_key);
+}
+/** Pure: the well-formed symptoms a metadata bag carries (malformed entries dropped). */
+export function readSymptoms(metadata) {
+    if (!metadata || typeof metadata !== 'object')
+        return [];
+    const raw = metadata.symptoms;
+    return Array.isArray(raw) ? raw.filter(isIncidentSymptom) : [];
+}
+/** Pure: the well-formed cleared-symptom records a metadata bag carries. */
+export function readClearedSymptoms(metadata) {
+    if (!metadata || typeof metadata !== 'object')
+        return [];
+    const raw = metadata.cleared_symptoms;
+    if (!Array.isArray(raw))
+        return [];
+    return raw.filter((v) => {
+        if (!v || typeof v !== 'object')
+            return false;
+        const c = v;
+        return nonBlankString(c.cause_key) !== null && (c.escalation_kind === null || typeof c.escalation_kind === 'string') &&
+            typeof c.cleared_at === 'string' && typeof c.resolution_class === 'string';
+    });
+}
+/** Pure: a row sits in the machine lane (agent_resolvable); everything else is human-facing. */
+export function isMachineLaneRow(row) {
+    return row.disposition === DISPOSITION_AGENT_RESOLVABLE;
+}
+/** Pure: a row's metadata bag, or null. */
+export function incidentRowMeta(row) {
+    return row.metadata ?? null;
+}
+/** Pure: a row is open (pending / in_review, or a summary row carrying no status). */
+export function isOpenIncidentRow(row) {
+    return !row.status || INCIDENT_OPEN_STATUSES.includes(row.status);
+}
+/**
+ * Pure: whether a row answers for `kind` in a DEDUP read: its own column kind,
+ * the legacy metadata.kind, a hand-off row's metadata.originalKind or
+ * original_cause_key, or any symptom correlated onto it (by kind or by a cause key
+ * minted for the kind, `<kind>::...`). Hold reads must NOT use this -- a handed-off
+ * or absorbed condition has no close-half that would clear a hold keyed on it.
+ */
+export function rowAnswersForKind(row, kind) {
+    if (row.escalationKind === kind)
+        return true;
+    const meta = incidentRowMeta(row);
+    if (meta?.kind === kind || meta?.originalKind === kind)
+        return true;
+    if (typeof meta?.original_cause_key === 'string' && meta.original_cause_key.startsWith(`${kind}::`))
+        return true;
+    return readSymptoms(meta).some((s) => symptomAnswersForKind(s, kind));
+}
+/** Pure: a symptom is an observation of `kind` -- by its kind, or by a cause key minted for the kind (`<kind>::...`). */
+export function symptomAnswersForKind(symptom, kind) {
+    return symptom.escalation_kind === kind || symptom.cause_key.startsWith(`${kind}::`);
+}
+/**
+ * Pure: whether a row is about `deliveryId` in a DEDUP read: the delivery_id
+ * column, the metadata fallbacks, or an incident key naming the delivery (a
+ * historic promotion refile is anchored to the focus, so only its carried key names it).
+ */
+export function rowNamesDelivery(row, deliveryId) {
+    if (row.deliveryId === deliveryId)
+        return true;
+    const meta = incidentRowMeta(row);
+    if (meta?.deliveryId === deliveryId || meta?.delivery_id === deliveryId)
+        return true;
+    return readIncidentKey(meta) === incidentKey({ deliveryId });
+}
+// ── Open-row kind predicates (the queries/escalations/escalations.ts dedup reads + the
+// supervision/escalation-clearing.ts close-halves) ──
+/**
+ * Pure: an OPEN row of `kind` on `focusId` -- the typed focus_id + escalation_kind
+ * columns, or (back-compat, a row filed before the column promotion)
+ * metadata.focusId + metadata.kind. With `matchCorrelated` (DEDUP reads only), also
+ * a row on the focus answering for the kind as a hand-off row or a correlated
+ * symptom (rowAnswersForKind).
+ */
+export function isOpenFocusKindRow(row, focusId, kind, matchCorrelated = false) {
+    if (!isOpenIncidentRow(row))
+        return false;
+    const meta = incidentRowMeta(row);
+    if (matchCorrelated)
+        return (row.focusId === focusId || meta?.focusId === focusId) && rowAnswersForKind(row, kind);
+    if (row.focusId === focusId && row.escalationKind === kind)
+        return true;
+    return meta?.focusId === focusId && meta?.kind === kind;
+}
+/**
+ * Pure: an OPEN worktree-dirty-class row for `focusId` whose kind is in `kinds`.
+ * Shared by hasOpenWorktreeDirtyEscalation (dedup, matchCorrelated) and
+ * resolveOpenWorktreeDirtyEscalations (auto-close, never correlated: it must not
+ * close a row whose own condition is a different one) so both agree on what counts.
+ *
+ * The status re-check is defense-in-depth. The live escalation_list handler
+ * already honors the `statuses` filter server-side, but the invariant "a RESOLVED
+ * worktree-dirty row must never suppress (or be re-resolved as) a legitimate new
+ * escalation" must hold however the rows were fetched (custom `kinds`, a future
+ * caller that forgets the statuses filter, etc.).
+ */
+export function isOpenWorktreeDirtyMatch(row, focusId, kinds, matchCorrelated = false) {
+    return [...kinds].some((kind) => isOpenFocusKindRow(row, focusId, kind, matchCorrelated));
+}
+//# sourceMappingURL=incident-record.js.map

package/dist/queries/escalations/incident-record.js.map

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

package/dist/queries/escalations/routing-measurement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-measurement.d.ts","sourceRoot":"","sources":["../../../src/queries/escalations/routing-measurement.ts"],"names":[],"mappings":"AAmFA,iDAAiD;AACjD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uGAAuG;IACvG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,GAAG,qBAAqB,EAAE,CAqBvG;AAED,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,GAAG,cAAc,CAW1F;AAED,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,GAAG,eAAe,CAS7F"}

package/dist/queries/escalations/routing-measurement.js

@@ -0,0 +1,147 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/queries/escalations/routing-measurement.test.ts
+// PINNED-BY-END
+/**
+ * Map a recorded resolution_class to the actor that resolved it, or null when
+ * the class carries no actor signal (auto_swept / duplicate / declined_invalid /
+ * unknown) -- those rows cannot witness a mis-route and are excluded from the
+ * mis-route denominator.
+ */
+function resolverActorOf(resolutionClass) {
+    switch (resolutionClass) {
+        case 'agent_session':
+            return 'machine';
+        case 'operator_action':
+            return 'human';
+        case 'external_change':
+            return 'external';
+        default:
+            return null;
+    }
+}
+/**
+ * Map a filed disposition to the owner it declared, or null when the
+ * disposition is absent/unrecognized (excluded from the mis-route denominator).
+ */
+function declaredOwnerOf(disposition) {
+    switch (disposition) {
+        case 'agent_resolvable':
+            return 'machine';
+        case 'needs_operator':
+            return 'human';
+        // needs_intent / needs_clarification are directed HUMAN holds (no longer
+        // fileable, but present on historic rows): the human is the declared owner.
+        case 'needs_intent':
+        case 'needs_clarification':
+            return 'human';
+        case 'external_wait':
+            return 'external';
+        default:
+            return null;
+    }
+}
+/** Resolution classes meaning the filing was NOT worth acting on. */
+const NON_ACTWORTHY_CLASSES = ['declined_invalid', 'duplicate'];
+/**
+ * The disposition every promotion source was filed with. By construction: the
+ * promotion reads only open agent_resolvable rows (toAgentResolvableItems /
+ * toOrgAgentResolvableItems), so a refile's lineage always points back into the
+ * machine lane.
+ */
+const PROMOTION_SOURCE_DISPOSITION = 'agent_resolvable';
+/**
+ * Pure: expand a resolved sample into JUDGMENT UNITS, one per filing whose
+ * resolver the row witnesses. This is what lets the mis-route rate see the
+ * machine lane's dominant hand-back path, PROMOTION:
+ *
+ *   an agent_resolvable filing no agent clears is handed to a routing decider,
+ *   which files a needs_operator row carrying its lineage, and the source is closed
+ *   auto_swept (no actor -- never judged); when an operator resolves that
+ *   row, judging it as needs_operator + operator_action reads "correctly
+ *   routed", so a lane whose work all ages out and is handed to a human would
+ *   measure a mis-route rate of ~0.
+ *
+ * Instead a promoted refile (promotedFrom) is judged against its SOURCE's declared
+ * disposition (agent_resolvable) with the refile's own resolution class: closed
+ * operator_action it is a machine-lane hand-back (mis-route), closed agent_session
+ * the machine lane still cleared it (correct), closed auto_swept / declined it
+ * carries no actor (unjudged) -- the same resolverActorOf mapping as any row. A row
+ * that absorbed other promotions contributes one agent_resolvable unit per absorbed
+ * source, in addition to its own unit.
+ *
+ * One judgment per source filing: a source already witnessed by a carrier is not
+ * counted twice, and when the SOURCE row itself is in the sample with an actor
+ * class (an agent closed it while its promotion symptom sat on a human row), that
+ * direct close is the witness and the carrier's unit for it is dropped. The source
+ * row's own auto_swept promotion close carries no actor, so it never double-counts.
+ * Units carry no lineage fields, so the function is idempotent.
+ */
+export function resolvePromotionLineage(rows) {
+    const directlyJudged = new Set();
+    for (const row of rows) {
+        if (row.id !== undefined && resolverActorOf(row.resolutionClass) !== null)
+            directlyJudged.add(row.id);
+    }
+    const witnessed = new Set();
+    const units = [];
+    const sourceUnit = (sourceId, resolutionClass) => {
+        if (directlyJudged.has(sourceId) || witnessed.has(sourceId))
+            return;
+        witnessed.add(sourceId);
+        units.push({ disposition: PROMOTION_SOURCE_DISPOSITION, resolutionClass });
+    };
+    for (const row of rows) {
+        if (row.promotedFrom !== undefined) {
+            sourceUnit(row.promotedFrom, row.resolutionClass);
+        }
+        else {
+            units.push({ disposition: row.disposition, resolutionClass: row.resolutionClass });
+        }
+        for (const sourceId of row.absorbedPromotions ?? [])
+            sourceUnit(sourceId, row.resolutionClass);
+    }
+    return units;
+}
+/**
+ * The share of judgeable filings that were routed to the wrong owner.
+ *
+ * Only rows whose ACTUAL resolver is observable (resolution_class in
+ * agent_session / operator_action / external_change) AND whose disposition maps
+ * to a declared owner are judged. A row with no resolver signal (e.g. auto_swept,
+ * declined_invalid) or no disposition is not counted either way. Promotion
+ * lineage is applied first (resolvePromotionLineage): a promoted refile is judged
+ * against the machine-lane filing it was promoted from.
+ */
+export function computeMisRouteRate(rows) {
+    let judged = 0;
+    let misRouted = 0;
+    for (const row of resolvePromotionLineage(rows)) {
+        const actor = resolverActorOf(row.resolutionClass);
+        const declared = declaredOwnerOf(row.disposition);
+        if (actor === null || declared === null)
+            continue;
+        judged += 1;
+        if (actor !== declared)
+            misRouted += 1;
+    }
+    return { judged, misRouted, rate: judged === 0 ? 0 : misRouted / judged };
+}
+/**
+ * The share of classified filings that were worth acting on at all -- the
+ * complement of the declined/duplicate classes. Rows with no recorded
+ * resolution_class are not yet classifiable and are excluded from the
+ * denominator (they are neither act-worthy nor declined until closed).
+ */
+export function computeActWorthyShare(rows) {
+    let classified = 0;
+    let actWorthy = 0;
+    for (const row of rows) {
+        if (row.resolutionClass == null || row.resolutionClass === '')
+            continue;
+        classified += 1;
+        if (!NON_ACTWORTHY_CLASSES.includes(row.resolutionClass))
+            actWorthy += 1;
+    }
+    return { classified, actWorthy, share: classified === 0 ? 0 : actWorthy / classified };
+}
+//# sourceMappingURL=routing-measurement.js.map

package/dist/queries/escalations/routing-measurement.js.map

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

package/dist/queries/focus-debug-artifacts/directive-undelivered.d.ts

@@ -0,0 +1,66 @@
+/** The focus_debug_artifacts section the record lives in. */
+export declare const DIRECTIVE_UNDELIVERED_SECTION_KIND = "directive_undelivered";
+/** The line carrying the first-observed timestamp across re-records. */
+export declare const UNDELIVERED_SINCE_PREFIX = "Undelivered since: ";
+/** What was owed, to which session, and why it did not arrive. */
+export interface UndeliveredDirective {
+    /** 'coding' | 'review' -- which pass the focus was owed. */
+    sessionType: string;
+    /** The workflow stage whose directive this was, when known. */
+    originStageId: string | null;
+    /** Which write found the session gone. */
+    part: 'compact' | 'body';
+    /** Whether a /compact reached the session before the body did not. */
+    compactDelivered: boolean;
+    /** Size of the assembled body, when it had been assembled. */
+    contentLength: number | null;
+    /** The named reason the send reported (spawn/lead-send.ts). */
+    reason: string;
+    /** That reason as a readable clause. */
+    detail: string;
+    /** ISO timestamp of the attempt. */
+    attemptedAt: string;
+}
+/**
+ * Render the human-facing record.
+ *
+ * Written for someone arriving cold, an hour later, asking "why has this focus
+ * done nothing?" -- so it answers what was owed, to which session, why it did
+ * not arrive, and what happens next, in that order. The first-observed
+ * timestamp is the one line a re-record must find again, so it is emitted on
+ * its own line with a fixed prefix (parseUndeliveredSince reads it back).
+ */
+export declare function renderUndeliveredDirectiveArtifact(args: {
+    focusName: string;
+    undelivered: UndeliveredDirective;
+    since: string;
+}): string;
+/** The `Undelivered since:` value in a stored artifact, or null when absent. */
+export declare function parseUndeliveredSince(content: string | undefined): string | null;
+/**
+ * Record that this focus was owed a directive its session never received,
+ * carrying forward the first-observed timestamp when one is already on record.
+ */
+export declare function recordUndeliveredDirective(args: {
+    focusId: string;
+    focusName: string;
+    undelivered: UndeliveredDirective;
+}): Promise<void>;
+/**
+ * Whether this focus is still owed a directive its session never received.
+ *
+ * Read at daemon startup by the stage-watermark seeding: the in-memory
+ * "already processed" watermark does not survive a restart, and the seeding
+ * marks every active focus processed -- which would lose the re-offer of a
+ * directive the focus is still owed. This record is the durable half of that
+ * signal, and it is deleted the moment the focus is served, so it means exactly
+ * "still owed" and not "was owed once".
+ *
+ * Throws on an unreadable API: the caller decides how to fail, and the seeding
+ * fails SOFT (seeds as before) rather than leaving a focus re-offering forever
+ * on a signal it could not read.
+ */
+export declare function hasUndeliveredDirectiveRecord(focusId: string): Promise<boolean>;
+/** Clear the record. Idempotent: deleting a section that is not there is a no-op. */
+export declare function clearUndeliveredDirective(focusId: string): Promise<void>;
+//# sourceMappingURL=directive-undelivered.d.ts.map

package/dist/queries/focus-debug-artifacts/directive-undelivered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-undelivered.d.ts","sourceRoot":"","sources":["../../../src/queries/focus-debug-artifacts/directive-undelivered.ts"],"names":[],"mappings":"AA4CA,6DAA6D;AAC7D,eAAO,MAAM,kCAAkC,0BAA0B,CAAC;AAE1E,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0CAA0C;IAC1C,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,sEAAsE;IACtE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8DAA8D;IAC9D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,oBAAoB,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAmCT;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAShF;AASD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,oBAAoB,CAAA;CAAE,GAC9E,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,qFAAqF;AACrF,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/queries/focus-debug-artifacts/directive-undelivered.js

@@ -0,0 +1,159 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/spawn/directive-undelivered-record.test.ts
+// PINNED-BY-END
+/**
+ * The focus's durable record of "I was owed a directive my session never
+ * received", and its clear.
+ *
+ * WHY A RECORD AT ALL. When a directive delivery stops because its target
+ * session has ended, a log warn alone tells a later reader nothing about what
+ * the focus was owed. This record is what lets them learn what was lost.
+ *
+ * WHY IT MUST NOT BE THE OPERATOR-STOP DROP. The focus poller's null-role branch
+ * clears a pending directive and logs "dropped, not carried to resume" whatever
+ * put it there. For an operator stop that is exactly right -- the stop is an
+ * authoritative halt and the queued directive MUST NOT fire on resume, so
+ * dropping is the correct disposal and there is nothing to record. For a session
+ * that vanished mid-write it is a misdescription of an accident. One line
+ * covering both is why the two could not be told apart.
+ *
+ * WHERE IT LIVES. focus_debug_artifacts, following
+ * queries/focus-debug-artifacts/focus-integration-conflict.ts exactly: one row per (focus,
+ * section_kind), rendered on the focus Debug tab with its own "Updated ...",
+ * readable through the focus-debug API, cleared by DELETING the row -- which is
+ * the shape "until the focus is served again" wants. Critically it is read by
+ * NOTHING in the machine's decision path, so recording a loss can never misroute
+ * a delivery. It is a record for a reader.
+ *
+ * WHY NOT AN ESCALATION. An escalation is the residue of an attempt that failed
+ * and needs a human act. This needs none: the debt clears itself the moment the
+ * focus is served again. Filing one would manufacture an inbox item that can
+ * only wait.
+ *
+ * SINCE-WHEN SURVIVES THE RE-RECORD. `updated_at` moves on every write, so a
+ * focus losing directives repeatedly would always read "just now" and hide how
+ * long it had been going. The content carries `Undelivered since:` explicitly
+ * and a re-record READS the existing section and carries that value forward. A
+ * failed read costs the ORIGINAL since-when, never the record itself.
+ *
+ * History: docs/daemon/history-platform.md (queries/focus-debug-artifacts/directive-undelivered.ts).
+ */
+import { callApi } from '../api-client/shared.js';
+/** The focus_debug_artifacts section the record lives in. */
+export const DIRECTIVE_UNDELIVERED_SECTION_KIND = 'directive_undelivered';
+/** The line carrying the first-observed timestamp across re-records. */
+export const UNDELIVERED_SINCE_PREFIX = 'Undelivered since: ';
+/**
+ * Render the human-facing record.
+ *
+ * Written for someone arriving cold, an hour later, asking "why has this focus
+ * done nothing?" -- so it answers what was owed, to which session, why it did
+ * not arrive, and what happens next, in that order. The first-observed
+ * timestamp is the one line a re-record must find again, so it is emitted on
+ * its own line with a fixed prefix (parseUndeliveredSince reads it back).
+ */
+export function renderUndeliveredDirectiveArtifact(args) {
+    const { focusName, undelivered: u, since } = args;
+    const body = u.contentLength != null ? `${u.contentLength} chars` : 'not assembled';
+    const compactNote = u.part === 'body' && u.compactDelivered
+        ? 'The /compact WAS delivered, so the session was compacted and then left with no instruction.'
+        : 'No /compact reached the session.';
+    return [
+        '# A directive this focus was owed was never delivered',
+        '',
+        `The ${u.sessionType} directive for \`${focusName}\` could not be delivered: its target`,
+        'session ended mid-delivery. This is NOT an operator stop -- nobody chose to drop this',
+        'directive, and the work it carried did not happen.',
+        '',
+        `${UNDELIVERED_SINCE_PREFIX}${since}`,
+        `Last attempted: ${u.attemptedAt}`,
+        '',
+        '## What was owed',
+        '',
+        `- Pass: ${u.sessionType}`,
+        `- Originating stage: ${u.originStageId ?? '(not recorded)'}`,
+        `- Directive body: ${body}`,
+        `- ${compactNote}`,
+        '',
+        '## Why it did not arrive',
+        '',
+        `- The ${u.part} write found no live session (\`${u.reason}\`).`,
+        `- ${u.detail}.`,
+        '- It was not retried: a session that has ended is not a transient failure.',
+        '',
+        '## What happens next',
+        '',
+        'Nothing is queued from this. The focus is served again when it is next armed and a',
+        'team spawns, and this record is deleted the moment a directive reaches a live',
+        'session. If the record persists, the focus is not being served.',
+    ].join('\n');
+}
+/** The `Undelivered since:` value in a stored artifact, or null when absent. */
+export function parseUndeliveredSince(content) {
+    if (!content)
+        return null;
+    for (const line of content.split('\n')) {
+        if (line.startsWith(UNDELIVERED_SINCE_PREFIX)) {
+            const value = line.slice(UNDELIVERED_SINCE_PREFIX.length).trim();
+            if (value)
+                return value;
+        }
+    }
+    return null;
+}
+/** The first-observed timestamp already on record for this focus, or null. */
+async function readUndeliveredSince(focusId) {
+    const result = await callApi('focus_debug_get', { focusId });
+    const section = (result?.sections ?? []).find(s => s.sectionKind === DIRECTIVE_UNDELIVERED_SECTION_KIND);
+    return parseUndeliveredSince(section?.content);
+}
+/**
+ * Record that this focus was owed a directive its session never received,
+ * carrying forward the first-observed timestamp when one is already on record.
+ */
+export async function recordUndeliveredDirective(args) {
+    const { focusId, focusName, undelivered } = args;
+    let since = null;
+    try {
+        since = await readUndeliveredSince(focusId);
+    }
+    catch {
+        // A failed read costs the ORIGINAL since-when, never the record itself.
+        since = null;
+    }
+    await callApi('focus_debug_set', {
+        focusId,
+        fields: {
+            sectionKind: DIRECTIVE_UNDELIVERED_SECTION_KIND,
+            content: renderUndeliveredDirectiveArtifact({
+                focusName, undelivered, since: since ?? undelivered.attemptedAt,
+            }),
+        },
+    });
+}
+/**
+ * Whether this focus is still owed a directive its session never received.
+ *
+ * Read at daemon startup by the stage-watermark seeding: the in-memory
+ * "already processed" watermark does not survive a restart, and the seeding
+ * marks every active focus processed -- which would lose the re-offer of a
+ * directive the focus is still owed. This record is the durable half of that
+ * signal, and it is deleted the moment the focus is served, so it means exactly
+ * "still owed" and not "was owed once".
+ *
+ * Throws on an unreadable API: the caller decides how to fail, and the seeding
+ * fails SOFT (seeds as before) rather than leaving a focus re-offering forever
+ * on a signal it could not read.
+ */
+export async function hasUndeliveredDirectiveRecord(focusId) {
+    const result = await callApi('focus_debug_get', { focusId });
+    return (result?.sections ?? []).some(s => s.sectionKind === DIRECTIVE_UNDELIVERED_SECTION_KIND);
+}
+/** Clear the record. Idempotent: deleting a section that is not there is a no-op. */
+export async function clearUndeliveredDirective(focusId) {
+    await callApi('focus_debug_clear', {
+        focusId,
+        fields: { sectionKind: DIRECTIVE_UNDELIVERED_SECTION_KIND },
+    });
+}
+//# sourceMappingURL=directive-undelivered.js.map

package/dist/queries/focus-debug-artifacts/directive-undelivered.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-undelivered.js","sourceRoot":"","sources":["../../../src/queries/focus-debug-artifacts/directive-undelivered.ts"],"names":[],"mappings":"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"}

package/dist/queries/focus-debug-artifacts/focus-integration-conflict.d.ts

@@ -0,0 +1,58 @@
+/**
+ * WHAT the focus branch and integration disagree about, read from the aborted
+ * rebase itself rather than inferred later.
+ *
+ * The sync step used to answer only "it failed", so the divergence was first
+ * DESCRIBED at the completion merge, hours of commits later (2026-09-20, Tinker
+ * Tailor: the same abort logged on all 14 coding spawns; the duplication behind
+ * it was found by an audit 7 hours in, and the completion merge still conflicted
+ * in five files). The conflicting paths are read while the rebase is still
+ * stopped on them -- `git diff --diff-filter=U` only names unmerged paths mid-
+ * conflict -- and the missing commits after the abort has restored the branch,
+ * so reading them costs the worktree nothing: the step still ends CLEAN, on the
+ * focus branch, exactly as it did before.
+ */
+export interface IntegrationConflict {
+    /** The branch the focus could not be brought current with. */
+    integrationBranch: string;
+    /** Paths git left unmerged in the failed rebase. Empty when the read itself failed. */
+    conflictPaths: string[];
+    /**
+     * Commits on `integrationBranch` the focus branch does not have, newest first,
+     * as `<short sha> <subject>`. Bounded (MISSING_COMMIT_LIMIT) -- a team needs to
+     * know WHAT it is behind, not the whole log. Empty when the read failed.
+     */
+    missingCommits: string[];
+    /** ISO timestamp of the failed sync. */
+    detectedAt: string;
+}
+/** The focus_debug_artifacts section the record lives in. */
+export declare const INTEGRATION_SYNC_SECTION_KIND = "integration_sync";
+/** The line carrying the first-observed timestamp across re-records. */
+export declare const CONFLICTING_SINCE_PREFIX = "Conflicting since: ";
+/**
+ * Render the human-facing record. The first-observed timestamp is the one line
+ * a re-record must be able to find again, so it is emitted on its own line with
+ * a fixed prefix (parseConflictingSince reads it back).
+ */
+export declare function renderIntegrationConflictArtifact(args: {
+    focusName: string;
+    branchName: string;
+    conflict: IntegrationConflict;
+    since: string;
+}): string;
+/** The `Conflicting since:` value in a stored artifact, or null when absent. */
+export declare function parseConflictingSince(content: string | undefined): string | null;
+/**
+ * Record that this focus's branch conflicts with integration, carrying forward
+ * the first-observed timestamp when one is already on record.
+ */
+export declare function recordFocusIntegrationConflict(args: {
+    focusId: string;
+    focusName: string;
+    branchName: string;
+    conflict: IntegrationConflict;
+}): Promise<void>;
+/** Clear the record. Idempotent: deleting a section that is not there is a no-op. */
+export declare function clearFocusIntegrationConflict(focusId: string): Promise<void>;
+//# sourceMappingURL=focus-integration-conflict.d.ts.map

package/dist/queries/focus-debug-artifacts/focus-integration-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-integration-conflict.d.ts","sourceRoot":"","sources":["../../../src/queries/focus-debug-artifacts/focus-integration-conflict.ts"],"names":[],"mappings":"AAwCA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6DAA6D;AAC7D,eAAO,MAAM,6BAA6B,qBAAqB,CAAC;AAEhE,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAQ9D;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAwBT;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAShF;AASD;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,GAC9F,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,qFAAqF;AACrF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAKf"}