crewly 1.20.361 → 1.20.363

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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"}