crewly 1.20.361 → 1.20.362

package/dist/backend/backend/src/services/stall/background-run-detector.js

@@ -0,0 +1,93 @@
+/**
+ * Text heuristics for background runs (crewly#1363 kind c): an agent telling
+ * the owner or a room that it started something that runs on its own ("已经
+ * 开跑…预计 1 小时左右", "kicked off the render, about 40 min"), a later post
+ * that reports it finished or failed, and a post that carries a deliverable
+ * (a file or a link). No LLM. The duration comes from the open-items parser
+ * so the two agree on "一个半小时".
+ *
+ * @module services/stall/background-run-detector
+ */
+import { STALL_WATCHER_CONSTANTS } from '../../constants.js';
+import { durationMs, splitSentences } from '../open-items/open-item-extractor.js';
+const C = STALL_WATCHER_CONSTANTS;
+/** A sentence that asks something is not an announcement. */
+const QUESTION_END = /[?？]\s*[)）]?$/;
+/**
+ * Clip a sentence to one line of at most RUN_HEAD_MAX_CHARS.
+ *
+ * @param s - Sentence
+ * @returns Clipped text
+ */
+function clipHead(s) {
+    const one = s.replace(/\s+/g, ' ').trim();
+    return one.length > C.RUN_HEAD_MAX_CHARS ? `${one.slice(0, C.RUN_HEAD_MAX_CHARS - 1)}…` : one;
+}
+/**
+ * Whether an agent post announces a run that will take a while.
+ *
+ * The announcing sentence must match {@link STALL_WATCHER_CONSTANTS.BACKGROUND_RUN_PATTERN};
+ * the duration is read from that sentence, else from the sentence before or
+ * after it ("已经开跑。预计 1 小时左右。"). Without a duration anywhere near, the
+ * post is NOT a background run (the caller registers nothing): the watcher
+ * only keys to the agent's own estimate. Finished-work reports and questions
+ * return null.
+ *
+ * @param text - The agent's post
+ * @returns The run, or null
+ *
+ * @example
+ * ```typescript
+ * detectBackgroundRun('已经开跑了，预计 1 小时左右出结果。');
+ * // { head: '已经开跑了，预计 1 小时左右出结果。', estimateMs: 3600000 }
+ * detectBackgroundRun('Kicked off the render.'); // null — no duration
+ * ```
+ */
+export function detectBackgroundRun(text) {
+    const t = (text ?? '').trim();
+    if (t.length < 4)
+        return null;
+    const sentences = splitSentences(t).map((s) => s.text.trim()).filter(Boolean);
+    for (let i = 0; i < sentences.length; i++) {
+        const s = sentences[i];
+        if (QUESTION_END.test(s) || !C.BACKGROUND_RUN_PATTERN.test(s))
+            continue;
+        if (isRunFinishedReport(s))
+            continue;
+        const near = [s, sentences[i + 1], sentences[i - 1]].filter((x) => !!x);
+        let estimateMs = null;
+        for (const n of near) {
+            estimateMs = durationMs(n);
+            if (estimateMs !== null)
+                break;
+        }
+        if (estimateMs === null)
+            return null;
+        return { head: clipHead(s), estimateMs };
+    }
+    return null;
+}
+/**
+ * Whether a post reports a run finished or failed (either closes the record).
+ *
+ * @param text - The agent's post
+ * @returns True for a finished / failed report
+ */
+export function isRunFinishedReport(text) {
+    const t = (text ?? '').trim();
+    if (!t || QUESTION_END.test(t))
+        return false;
+    return C.RUN_FINISHED_PATTERN.test(t);
+}
+/**
+ * Whether a post carries a deliverable: an attachment, a link or a file name.
+ *
+ * @param message - Content and attachment count
+ * @returns True when something was delivered
+ */
+export function hasDeliverable(message) {
+    if ((message.attachmentCount ?? 0) > 0)
+        return true;
+    return C.DELIVERABLE_PATTERN.test(message.content ?? '');
+}
+//# sourceMappingURL=background-run-detector.js.map

package/dist/backend/backend/src/services/stall/background-run-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-run-detector.js","sourceRoot":"","sources":["../../../../../../backend/src/services/stall/background-run-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAElF,MAAM,CAAC,GAAG,uBAAuB,CAAC;AAUlC,6DAA6D;AAC7D,MAAM,YAAY,GAAG,eAAe,CAAC;AAErC;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,CAAS;IAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,kBAAkB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC/F,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QACxE,IAAI,mBAAmB,CAAC,CAAC,CAAC;YAAE,SAAS;QACrC,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,IAAI,UAAU,GAAkB,IAAI,CAAC;QACrC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACtB,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,UAAU,KAAK,IAAI;gBAAE,MAAM;QAChC,CAAC;QACD,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsD;IACpF,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/backend/backend/src/services/stall/claim-check.d.ts

@@ -0,0 +1,60 @@
+/**
+ * "X is doing it" claims (crewly#1362): an agent tells the owner a named
+ * teammate is doing something. The watcher later checks that a WorkItem or
+ * project ticket for that teammate exists around that time; when none does,
+ * the speaker is told once to delegate or correct the thread. This module is
+ * the text side: finding the claims and wording the nudge. No LLM.
+ *
+ * @module services/stall/claim-check
+ */
+/** A teammate the agent can name. */
+export interface ClaimableMember {
+    /** Display name as teammates write it ("Pia") */
+    name: string;
+    /** Agent session */
+    session: string;
+}
+/** One claim found in a post. */
+export interface TeammateClaim {
+    /** The teammate's session */
+    member: string;
+    /** The name as matched */
+    memberName: string;
+    /** The claiming sentence (clipped to RUN_HEAD_MAX_CHARS) */
+    sentence: string;
+}
+/**
+ * The claim patterns for one name.
+ *
+ * @param name - Display name
+ * @returns Patterns that match a claim about that teammate
+ */
+export declare function claimPatternsFor(name: string): RegExp[];
+/**
+ * Claims in an agent's post that a named teammate is doing the work.
+ *
+ * A member is matched by its display name (not the speaker itself); each
+ * member is reported once, with the first sentence that claims it. Questions
+ * and negated sentences ("不是 Pia 在做") are skipped.
+ *
+ * @param text - The agent's post
+ * @param members - The speaker's teammates (name + session)
+ * @param speaker - The speaker's session (never a claim about itself)
+ * @returns Claims found, in sentence order
+ *
+ * @example
+ * ```typescript
+ * detectTeammateClaims('对，视频已经是 Pia 在做了。', [{ name: 'Pia', session: 'flopost-pia' }], 'flopost-ella');
+ * // [{ member: 'flopost-pia', memberName: 'Pia', sentence: '对，视频已经是 Pia 在做了。' }]
+ * ```
+ */
+export declare function detectTeammateClaims(text: string, members: readonly ClaimableMember[], speaker: string): TeammateClaim[];
+/**
+ * The one line the speaker gets when nothing is assigned to the teammate.
+ *
+ * @param memberName - The teammate as named
+ * @param sentence - The claiming sentence
+ * @returns Nudge text
+ */
+export declare function claimNudgeText(memberName: string, sentence: string): string;
+//# sourceMappingURL=claim-check.d.ts.map

package/dist/backend/backend/src/services/stall/claim-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-check.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/stall/claim-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC7B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CACjB;AAkBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYvD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAmBxH;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK3E"}

package/dist/backend/backend/src/services/stall/claim-check.js

@@ -0,0 +1,98 @@
+/**
+ * "X is doing it" claims (crewly#1362): an agent tells the owner a named
+ * teammate is doing something. The watcher later checks that a WorkItem or
+ * project ticket for that teammate exists around that time; when none does,
+ * the speaker is told once to delegate or correct the thread. This module is
+ * the text side: finding the claims and wording the nudge. No LLM.
+ *
+ * @module services/stall/claim-check
+ */
+import { STALL_WATCHER_CONSTANTS } from '../../constants.js';
+import { splitSentences } from '../open-items/open-item-extractor.js';
+const C = STALL_WATCHER_CONSTANTS;
+/** A sentence that asks is not a claim ("让 Pia 做？"). */
+const QUESTION_END = /[?？]\s*[)）]?$/;
+/** A sentence that denies or undoes the claim. */
+const NEGATED = /(?:不是|没有?让|没有?交给|并不是|不再|不用|别让)|\b(?:not|isn'?t|wasn'?t|haven'?t|hasn'?t|no longer|didn'?t)\b/iu;
+/**
+ * Escape a name for use in a RegExp.
+ *
+ * @param name - Display name
+ * @returns Escaped text
+ */
+function escapeName(name) {
+    return name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * The claim patterns for one name.
+ *
+ * @param name - Display name
+ * @returns Patterns that match a claim about that teammate
+ */
+export function claimPatternsFor(name) {
+    const n = escapeName(name);
+    // English names need word boundaries; CJK names have none, so the verb
+    // lists carry the shape on their own.
+    const latin = /^[\p{Script=Latin}\d\s.'-]+$/u.test(name);
+    const b = latin ? '\\b' : '';
+    return [
+        new RegExp(`${b}${n}${b}\\s*${C.CLAIM_ZH_AFTER_NAME}`, 'iu'),
+        new RegExp(`${C.CLAIM_ZH_BEFORE_NAME}\\s*${n}${b}`, 'iu'),
+        new RegExp(`${b}${n}${b}\\s*${C.CLAIM_EN_AFTER_NAME}\\b`, 'iu'),
+        new RegExp(`\\b${C.CLAIM_EN_BEFORE_NAME}\\s+${n}${b}`, 'iu'),
+    ];
+}
+/**
+ * Claims in an agent's post that a named teammate is doing the work.
+ *
+ * A member is matched by its display name (not the speaker itself); each
+ * member is reported once, with the first sentence that claims it. Questions
+ * and negated sentences ("不是 Pia 在做") are skipped.
+ *
+ * @param text - The agent's post
+ * @param members - The speaker's teammates (name + session)
+ * @param speaker - The speaker's session (never a claim about itself)
+ * @returns Claims found, in sentence order
+ *
+ * @example
+ * ```typescript
+ * detectTeammateClaims('对，视频已经是 Pia 在做了。', [{ name: 'Pia', session: 'flopost-pia' }], 'flopost-ella');
+ * // [{ member: 'flopost-pia', memberName: 'Pia', sentence: '对，视频已经是 Pia 在做了。' }]
+ * ```
+ */
+export function detectTeammateClaims(text, members, speaker) {
+    const t = (text ?? '').trim();
+    if (t.length < 4 || members.length === 0)
+        return [];
+    const candidates = members.filter((m) => m.session !== speaker && m.name.trim().length > 0);
+    if (candidates.length === 0)
+        return [];
+    const patterns = candidates.map((m) => ({ m, res: claimPatternsFor(m.name.trim()) }));
+    const out = [];
+    const seen = new Set();
+    for (const { text: raw } of splitSentences(t)) {
+        const s = raw.trim();
+        if (!s || QUESTION_END.test(s) || NEGATED.test(s))
+            continue;
+        for (const { m, res } of patterns) {
+            if (seen.has(m.session) || !res.some((re) => re.test(s)))
+                continue;
+            seen.add(m.session);
+            const one = s.replace(/\s+/g, ' ');
+            out.push({ member: m.session, memberName: m.name.trim(), sentence: one.length > C.RUN_HEAD_MAX_CHARS ? `${one.slice(0, C.RUN_HEAD_MAX_CHARS - 1)}…` : one });
+        }
+    }
+    return out;
+}
+/**
+ * The one line the speaker gets when nothing is assigned to the teammate.
+ *
+ * @param memberName - The teammate as named
+ * @param sentence - The claiming sentence
+ * @returns Nudge text
+ */
+export function claimNudgeText(memberName, sentence) {
+    return (`${C.CLAIM_CHECK_TAG} You told the owner ${memberName} is doing it ("${sentence}"); nothing is assigned to ${memberName} ` +
+        `(no work item or ticket for ${memberName} within ${Math.round(C.CLAIM_CHECK_WINDOW_MS / 60_000)} minutes of that reply). Delegate it now, or correct the thread.`);
+}
+//# sourceMappingURL=claim-check.js.map

package/dist/backend/backend/src/services/stall/claim-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-check.js","sourceRoot":"","sources":["../../../../../../backend/src/services/stall/claim-check.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/stall/in-flight-runs.store.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The stall watcher's state on disk (`CREWLY_HOME/in-flight-runs.json`):
+ * background runs agents said they started, the ladder stamps of every
+ * stalled item (agent / lead / owner steps), pending teammate-claim checks,
+ * the per-agent nudge times and the time the watcher was first armed.
+ * One small JSON file, written atomically; a missing or broken file is an
+ * empty state (specs/2026-10-17-stall-watcher.md).
+ *
+ * @module services/stall/in-flight-runs.store
+ */
+/** A run an agent said it started, with when it should be back. */
+export interface InFlightRun {
+    /** Stable id (the message id that announced it) */
+    id: string;
+    /** Agent session */
+    agent: string;
+    /** chat-v2 channel of the announcement */
+    channelId: string;
+    /** chat-v2 thread root (the announcement itself when it was a root post) */
+    threadId: string;
+    /** The sentence that announced it (clipped) */
+    head: string;
+    /** Epoch ms of the announcement */
+    startedAt: number;
+    /** Estimate the agent gave (ms), or the default */
+    estimateMs: number;
+    /** Whether the estimate came from the text */
+    estimateSource: 'text' | 'default';
+    /** startedAt + estimateMs */
+    expectedBy: number;
+}
+/** When each step of the ladder fired for one item (epoch ms). */
+export interface LadderState {
+    agentAt?: number;
+    leadAt?: number;
+    ownerAt?: number;
+    /** The lead that was told at the lead step (its answer in the thread stops the owner step) */
+    leadSession?: string;
+    /** Last time any step of this item ran (for pruning) */
+    seenAt: number;
+}
+/** A "<Name> is doing it" told to the owner, waiting for its check (crewly#1362). */
+export interface PendingClaim {
+    /** The message id that made the claim */
+    id: string;
+    /** Who said it */
+    speaker: string;
+    /** The teammate named (session) */
+    member: string;
+    /** The teammate's display name as written */
+    memberName: string;
+    /** Epoch ms of the claim */
+    saidAt: number;
+    /** The sentence (clipped) */
+    head: string;
+}
+/** Everything the watcher persists. */
+export interface StallWatcherState {
+    version: number;
+    /** Epoch ms of the first real pass; sends start ARM_DELAY_MS later */
+    armedAt?: number;
+    runs: InFlightRun[];
+    /** Ladder stamps by item key (`promise:<request>/<item>`, `claim:<workItem>`, `run:<id>`) */
+    ladders: Record<string, LadderState>;
+    /** Last watcher nudge per agent session (epoch ms) */
+    lastNudgeByAgent: Record<string, number>;
+    claims: PendingClaim[];
+}
+/**
+ * A fresh, empty state.
+ *
+ * @returns Empty state
+ */
+export declare function emptyState(): StallWatcherState;
+/**
+ * Drop what is too old to matter: runs past RUN_MAX_AGE_MS, ladders not
+ * seen for LADDER_TTL_MS, nudge times older than the cooldown, and claim
+ * checks past their window twice over (something kept them from running).
+ * Caps the run and claim lists at their maxima (oldest first).
+ *
+ * @param state - State (mutated in place)
+ * @param now - Epoch ms
+ * @returns The same state
+ */
+export declare function pruneState(state: StallWatcherState, now: number): StallWatcherState;
+/**
+ * Reads and writes the state file.
+ */
+export declare class InFlightRunsStore {
+    private readonly filePath;
+    /**
+     * @param filePath - Absolute path of the state file
+     */
+    constructor(filePath: string);
+    /** @returns The state file path */
+    get path(): string;
+    /**
+     * Read the state; a missing, unreadable or malformed file is an empty state.
+     *
+     * @returns The state (missing lists filled in)
+     */
+    load(): Promise<StallWatcherState>;
+    /**
+     * Write the state atomically (temp file + rename).
+     *
+     * @param state - State to write
+     */
+    save(state: StallWatcherState): Promise<void>;
+}
+//# sourceMappingURL=in-flight-runs.store.d.ts.map

package/dist/backend/backend/src/services/stall/in-flight-runs.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-flight-runs.store.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/stall/in-flight-runs.store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC3B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;CACf;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC5B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACb;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,EAAE,YAAY,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,iBAAiB,CAE9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAUnF;AAcD;;GAEG;AACH,qBAAa,iBAAiB;IAIjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC;;OAEG;gBAC0B,QAAQ,EAAE,MAAM;IAE7C,mCAAmC;IACnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAkBxC;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAMnD"}

package/dist/backend/backend/src/services/stall/in-flight-runs.store.js

@@ -0,0 +1,109 @@
+/**
+ * The stall watcher's state on disk (`CREWLY_HOME/in-flight-runs.json`):
+ * background runs agents said they started, the ladder stamps of every
+ * stalled item (agent / lead / owner steps), pending teammate-claim checks,
+ * the per-agent nudge times and the time the watcher was first armed.
+ * One small JSON file, written atomically; a missing or broken file is an
+ * empty state (specs/2026-10-17-stall-watcher.md).
+ *
+ * @module services/stall/in-flight-runs.store
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { STALL_WATCHER_CONSTANTS } from '../../constants.js';
+const C = STALL_WATCHER_CONSTANTS;
+/**
+ * A fresh, empty state.
+ *
+ * @returns Empty state
+ */
+export function emptyState() {
+    return { version: C.STATE_VERSION, runs: [], ladders: {}, lastNudgeByAgent: {}, claims: [] };
+}
+/**
+ * Drop what is too old to matter: runs past RUN_MAX_AGE_MS, ladders not
+ * seen for LADDER_TTL_MS, nudge times older than the cooldown, and claim
+ * checks past their window twice over (something kept them from running).
+ * Caps the run and claim lists at their maxima (oldest first).
+ *
+ * @param state - State (mutated in place)
+ * @param now - Epoch ms
+ * @returns The same state
+ */
+export function pruneState(state, now) {
+    state.runs = state.runs.filter((r) => now - r.startedAt < C.RUN_MAX_AGE_MS).slice(-C.MAX_RUNS);
+    for (const [key, ladder] of Object.entries(state.ladders)) {
+        if (now - ladder.seenAt >= C.LADDER_TTL_MS)
+            delete state.ladders[key];
+    }
+    for (const [agent, at] of Object.entries(state.lastNudgeByAgent)) {
+        if (now - at >= C.NUDGE_COOLDOWN_MS)
+            delete state.lastNudgeByAgent[agent];
+    }
+    state.claims = state.claims.filter((c) => now - c.saidAt < 2 * C.CLAIM_CHECK_WINDOW_MS + C.INTERVAL_MS).slice(-C.MAX_PENDING_CLAIMS);
+    return state;
+}
+/**
+ * Whether a parsed file is a usable state.
+ *
+ * @param value - Parsed JSON
+ * @returns True for a state object
+ */
+function isState(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    return Array.isArray(v.runs) && typeof v.ladders === 'object' && v.ladders !== null;
+}
+/**
+ * Reads and writes the state file.
+ */
+export class InFlightRunsStore {
+    filePath;
+    /**
+     * @param filePath - Absolute path of the state file
+     */
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    /** @returns The state file path */
+    get path() {
+        return this.filePath;
+    }
+    /**
+     * Read the state; a missing, unreadable or malformed file is an empty state.
+     *
+     * @returns The state (missing lists filled in)
+     */
+    async load() {
+        try {
+            const raw = await fs.readFile(this.filePath, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (!isState(parsed))
+                return emptyState();
+            return {
+                ...emptyState(),
+                ...parsed,
+                runs: parsed.runs ?? [],
+                ladders: parsed.ladders ?? {},
+                lastNudgeByAgent: parsed.lastNudgeByAgent ?? {},
+                claims: parsed.claims ?? [],
+            };
+        }
+        catch {
+            return emptyState();
+        }
+    }
+    /**
+     * Write the state atomically (temp file + rename).
+     *
+     * @param state - State to write
+     */
+    async save(state) {
+        await fs.mkdir(path.dirname(this.filePath), { recursive: true });
+        const tmp = `${this.filePath}.${process.pid}.tmp`;
+        await fs.writeFile(tmp, JSON.stringify({ ...state, version: C.STATE_VERSION }, null, 2), 'utf8');
+        await fs.rename(tmp, this.filePath);
+    }
+}
+//# sourceMappingURL=in-flight-runs.store.js.map

package/dist/backend/backend/src/services/stall/in-flight-runs.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-flight-runs.store.js","sourceRoot":"","sources":["../../../../../../backend/src/services/stall/in-flight-runs.store.ts"],"names":[],"mappings":"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"}