crewly 1.6.1 → 1.6.3

package/dist/backend/backend/src/services/team-health/stale-trigger-detector.js

@@ -0,0 +1,83 @@
+/**
+ * Stale-Trigger Detector — §B.4 implementation
+ *
+ * Pure function. Identifies WorkItems whose stated work has no source-of-
+ * truth basis. Returns a SUSPICION SCORE via Set<workItemId>; the watchdog
+ * action is to ask the assignee to confirm cancel — auto-cancel stays in
+ * Reconciler.
+ *
+ * @module services/team-health/stale-trigger-detector
+ */
+/**
+ * Identify the set of WorkItem IDs flagged stale per §B.4.
+ *
+ * @param workItems - All active WorkItems being evaluated
+ * @param input - Optional pre-computed signals (data provider supplies)
+ * @param config - Detection config
+ * @returns Set of WorkItem IDs flagged stale
+ */
+export function detectStaleWorkItems(workItems, input, config) {
+    const out = new Set();
+    if (!config.enabled)
+        return out;
+    for (const wi of workItems) {
+        if (isStale(wi, input, config))
+            out.add(wi.id);
+    }
+    return out;
+}
+/**
+ * Test whether a single WorkItem is stale.
+ *
+ * @param wi - WorkItem under inspection
+ * @param input - Pre-computed prior-done counts and artifact probes
+ * @param config - Detection config
+ * @returns true if any stale-fire condition matches
+ */
+export function isStale(wi, input, config) {
+    if (wi.status === 'done' || wi.status === 'verified' || wi.status === 'cancelled') {
+        return false;
+    }
+    const priorCount = input.priorDoneCounts?.get(wi.id) ?? 0;
+    if (priorCount >= config.minPriorDoneCountForRedundancy)
+        return true;
+    const probes = input.artifactProbes?.get(wi.id) ?? [];
+    for (const p of probes)
+        if (p.isStale)
+            return true;
+    return false;
+}
+/**
+ * Build a human-readable evidence string for one WorkItem.
+ *
+ * @param wi - The WorkItem
+ * @param input - Pre-computed signals
+ * @param config - Detection config
+ * @returns Multi-line evidence string; empty if no stale signal
+ */
+export function describeStaleEvidence(wi, input, config) {
+    const lines = [];
+    const priorCount = input.priorDoneCounts?.get(wi.id) ?? 0;
+    if (priorCount >= config.minPriorDoneCountForRedundancy) {
+        lines.push(`• ${priorCount} prior done tasks with overlapping AC ` +
+            `(threshold: ${config.minPriorDoneCountForRedundancy}).`);
+    }
+    const probes = input.artifactProbes?.get(wi.id) ?? [];
+    for (const p of probes) {
+        if (!p.isStale)
+            continue;
+        lines.push(`• ${labelKind(p.kind)}: ${p.evidence}`);
+    }
+    return lines.join('\n');
+}
+function labelKind(kind) {
+    switch (kind) {
+        case 'package_version': return 'package.json version mismatch';
+        case 'prior_done_count': return 'prior done tasks';
+        case 'route': return 'route reference';
+        case 'migration': return 'migration reference';
+        case 'file_state': return 'file already in target state';
+        default: return 'artifact probe';
+    }
+}
+//# sourceMappingURL=stale-trigger-detector.js.map

package/dist/backend/backend/src/services/team-health/stale-trigger-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-trigger-detector.js","sourceRoot":"","sources":["../../../../../../backend/src/services/team-health/stale-trigger-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAqB,EACrB,KAAwB,EACxB,MAA0B;IAE1B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,GAAG,CAAC;IAChC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CACrB,EAAY,EACZ,KAAwB,EACxB,MAA0B;IAE1B,IAAI,EAAE,CAAC,MAAM,KAAK,MAAM,IAAI,EAAE,CAAC,MAAM,KAAK,UAAU,IAAI,EAAE,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,UAAU,IAAI,MAAM,CAAC,8BAA8B;QAAE,OAAO,IAAI,CAAC;IACrE,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,IAAI,CAAC,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;IACnD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAY,EACZ,KAAwB,EACxB,MAA0B;IAE1B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,UAAU,IAAI,MAAM,CAAC,8BAA8B,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CACR,KAAK,UAAU,wCAAwC;YACrD,eAAe,MAAM,CAAC,8BAA8B,IAAI,CAC3D,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAS;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,IAAiC;IAClD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,iBAAiB,CAAC,CAAC,OAAO,+BAA+B,CAAC;QAC/D,KAAK,kBAAkB,CAAC,CAAC,OAAO,kBAAkB,CAAC;QACnD,KAAK,OAAO,CAAC,CAAC,OAAO,iBAAiB,CAAC;QACvC,KAAK,WAAW,CAAC,CAAC,OAAO,qBAAqB,CAAC;QAC/C,KAAK,YAAY,CAAC,CAAC,OAAO,8BAA8B,CAAC;QACzD,OAAO,CAAC,CAAC,OAAO,gBAAgB,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/backend/backend/src/services/team-health/team-health-alert-router.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Team-Health-Watchdog (THW) — Alert Router
+ *
+ * §D (dedup + cooldown ladder) and §H.2 (channel routing). Holds in-memory
+ * cooldown / alert-budget state. The watchdog service owns Slack delivery;
+ * this router decides what to send, to whom, and whether to suppress.
+ *
+ * Layer-4 invariant (§A.1): NEVER mutates lower-layer state.
+ *
+ * @module services/team-health/team-health-alert-router
+ */
+import type { AlertDecision, OffHoursConfig, TeamHealthAlertingConfig, TeamHealthDetection, TeamSummary, VerdictCode } from './team-health-types.js';
+interface CooldownEntry {
+    teamId: string;
+    verdict: VerdictCode;
+    bucket: number;
+    postedAt: number;
+}
+/**
+ * Routes detections to alert decisions (channel + message + suppress
+ * reason). State persists in memory; the watchdog can snapshot/restore
+ * across restarts via the sidecar JSON files (§F.2).
+ */
+export declare class TeamHealthAlertRouter {
+    private alertingConfig;
+    private offHoursConfig;
+    private shadowMode;
+    private cooldowns;
+    private budgets;
+    private silenced;
+    constructor(alertingConfig: TeamHealthAlertingConfig, offHoursConfig: OffHoursConfig, shadowMode: boolean);
+    setShadowMode(shadowMode: boolean): void;
+    reconfigure(alerting: TeamHealthAlertingConfig, offHours: OffHoursConfig): void;
+    silenceTeam(teamId: string, now: Date, durationMs: number): void;
+    snapshotState(): {
+        cooldowns: CooldownEntry[];
+        budgets: {
+            teamId: string;
+            count: number;
+            windowStart: number;
+        }[];
+        silenced: {
+            teamId: string;
+            until: number;
+        }[];
+    };
+    restoreState(snapshot: ReturnType<TeamHealthAlertRouter['snapshotState']>): void;
+    /**
+     * Route one detection to an AlertDecision. Idempotent: caller iterates
+     * over a batch without ordering side-effects. Cooldown commits happen
+     * only via `commitDecision`.
+     *
+     * @param detection - Detection from the detector
+     * @param team - Team summary (slack thread/TL routing)
+     * @param now - Current wall-clock time
+     * @param systemOrphanTotal - System-wide orphan count for ops escalation
+     */
+    route(detection: TeamHealthDetection, team: TeamSummary, now: Date, systemOrphanTotal: number): AlertDecision;
+    /**
+     * Acknowledge a delivered alert: bumps cooldown bucket + budget counter.
+     * Suppressed decisions do NOT call this — they have no side-effects.
+     */
+    commitDecision(decision: AlertDecision, now: Date): void;
+    private cooldownForVerdict;
+    private channelForVerdict;
+    private applyOffHoursDowngrade;
+    private dropCooldownsForTeam;
+    private budgetExceeded;
+    private bumpBudget;
+}
+/**
+ * Test whether `now` is inside the configured working window for the
+ * owner timezone (§FP-2). Conservative on parsing — invalid inputs
+ * default to "always working hours".
+ */
+export declare function isWithinWorkingHours(now: Date, config: OffHoursConfig): boolean;
+/**
+ * Build the multi-line roll-up Slack message for one detection (§D.5).
+ *
+ * @param detection - The team's detection
+ * @param team - Team summary (for member labels and TL @mention)
+ * @param effectiveVerdict - Final verdict after off-hours downgrade
+ * @param systemOrphanTotal - System-wide orphan count for context line
+ * @returns Slack-ready message text
+ */
+export declare function formatRollupMessage(detection: TeamHealthDetection, team: TeamSummary, effectiveVerdict: VerdictCode, systemOrphanTotal: number): string;
+/**
+ * Build the recovery message — short factual line, cooldown=0 (§6.3).
+ */
+export declare function formatRecoveryMessage(team: TeamSummary, detection: TeamHealthDetection, now: Date): string;
+export {};
+//# sourceMappingURL=team-health-alert-router.d.ts.map

package/dist/backend/backend/src/services/team-health/team-health-alert-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-health-alert-router.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/team-health/team-health-alert-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAEV,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACX,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAGhC,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD;;;;GAIG;AACH,qBAAa,qBAAqB;IAM9B,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;IAPpB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAyB;gBAG/B,cAAc,EAAE,wBAAwB,EACxC,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,OAAO;IAG7B,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAIxC,WAAW,CAAC,QAAQ,EAAE,wBAAwB,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK/E,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhE,aAAa,IAAI;QACf,SAAS,EAAE,aAAa,EAAE,CAAC;QAC3B,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAClE,QAAQ,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC/C;IAYD,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC,GAAG,IAAI;IAehF;;;;;;;;;OASG;IACH,KAAK,CACH,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,IAAI,EACT,iBAAiB,EAAE,MAAM,GACxB,aAAa;IA4DhB;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI;IAaxD,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,UAAU;CAanB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAO/E;AA0BD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,WAAW,EACjB,gBAAgB,EAAE,WAAW,EAC7B,iBAAiB,EAAE,MAAM,GACxB,MAAM,CA6DR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,mBAAmB,EAC9B,GAAG,EAAE,IAAI,GACR,MAAM,CAIR"}

package/dist/backend/backend/src/services/team-health/team-health-alert-router.js

@@ -0,0 +1,328 @@
+/**
+ * Team-Health-Watchdog (THW) — Alert Router
+ *
+ * §D (dedup + cooldown ladder) and §H.2 (channel routing). Holds in-memory
+ * cooldown / alert-budget state. The watchdog service owns Slack delivery;
+ * this router decides what to send, to whom, and whether to suppress.
+ *
+ * Layer-4 invariant (§A.1): NEVER mutates lower-layer state.
+ *
+ * @module services/team-health/team-health-alert-router
+ */
+import { VERDICT_DISPLAY } from './team-health-types.js';
+/**
+ * Routes detections to alert decisions (channel + message + suppress
+ * reason). State persists in memory; the watchdog can snapshot/restore
+ * across restarts via the sidecar JSON files (§F.2).
+ */
+export class TeamHealthAlertRouter {
+    alertingConfig;
+    offHoursConfig;
+    shadowMode;
+    cooldowns = new Map();
+    budgets = new Map();
+    silenced = new Map();
+    constructor(alertingConfig, offHoursConfig, shadowMode) {
+        this.alertingConfig = alertingConfig;
+        this.offHoursConfig = offHoursConfig;
+        this.shadowMode = shadowMode;
+    }
+    setShadowMode(shadowMode) {
+        this.shadowMode = shadowMode;
+    }
+    reconfigure(alerting, offHours) {
+        this.alertingConfig = alerting;
+        this.offHoursConfig = offHours;
+    }
+    silenceTeam(teamId, now, durationMs) {
+        this.silenced.set(teamId, now.getTime() + durationMs);
+    }
+    snapshotState() {
+        return {
+            cooldowns: Array.from(this.cooldowns.values()),
+            budgets: Array.from(this.budgets.entries()).map(([teamId, b]) => ({
+                teamId, count: b.count, windowStart: b.windowStart,
+            })),
+            silenced: Array.from(this.silenced.entries()).map(([teamId, until]) => ({
+                teamId, until,
+            })),
+        };
+    }
+    restoreState(snapshot) {
+        this.cooldowns.clear();
+        for (const e of snapshot.cooldowns) {
+            this.cooldowns.set(`${e.teamId}|${e.verdict}`, e);
+        }
+        this.budgets.clear();
+        for (const b of snapshot.budgets) {
+            this.budgets.set(b.teamId, { count: b.count, windowStart: b.windowStart });
+        }
+        this.silenced.clear();
+        for (const s of snapshot.silenced) {
+            this.silenced.set(s.teamId, s.until);
+        }
+    }
+    /**
+     * Route one detection to an AlertDecision. Idempotent: caller iterates
+     * over a batch without ordering side-effects. Cooldown commits happen
+     * only via `commitDecision`.
+     *
+     * @param detection - Detection from the detector
+     * @param team - Team summary (slack thread/TL routing)
+     * @param now - Current wall-clock time
+     * @param systemOrphanTotal - System-wide orphan count for ops escalation
+     */
+    route(detection, team, now, systemOrphanTotal) {
+        const baseDedupKey = `${detection.teamId}|${detection.verdict}`;
+        const effectiveVerdict = this.applyOffHoursDowngrade(detection.verdict, now);
+        if (effectiveVerdict === 'healthy') {
+            const hadAlerts = this.dropCooldownsForTeam(detection.teamId);
+            return {
+                detection,
+                channel: hadAlerts ? 'team-thread' : 'suppressed',
+                effectiveVerdict,
+                message: hadAlerts
+                    ? formatRecoveryMessage(team, detection, now)
+                    : formatHealthyNoOp(team, detection),
+                suppressionReason: hadAlerts ? undefined : 'stable_healthy',
+                dedupKey: baseDedupKey,
+            };
+        }
+        const silenceUntil = this.silenced.get(detection.teamId);
+        if (silenceUntil && silenceUntil > now.getTime()) {
+            return {
+                detection, channel: 'suppressed', effectiveVerdict, message: '',
+                suppressionReason: 'silenced_by_react', dedupKey: baseDedupKey,
+            };
+        }
+        if (this.shadowMode) {
+            return {
+                detection, channel: 'suppressed', effectiveVerdict,
+                message: formatRollupMessage(detection, team, effectiveVerdict, systemOrphanTotal),
+                suppressionReason: 'shadow_mode', dedupKey: baseDedupKey,
+            };
+        }
+        const cooldownMs = this.cooldownForVerdict(effectiveVerdict);
+        const bucket = Math.floor(now.getTime() / cooldownMs);
+        const existing = this.cooldowns.get(baseDedupKey);
+        if (existing && existing.bucket === bucket) {
+            return {
+                detection, channel: 'suppressed', effectiveVerdict, message: '',
+                suppressionReason: 'cooldown', dedupKey: baseDedupKey,
+            };
+        }
+        if (this.budgetExceeded(detection.teamId, now)) {
+            return {
+                detection, channel: 'suppressed', effectiveVerdict, message: '',
+                suppressionReason: 'alert_budget_exceeded', dedupKey: baseDedupKey,
+            };
+        }
+        return {
+            detection,
+            channel: this.channelForVerdict(effectiveVerdict, team),
+            effectiveVerdict,
+            message: formatRollupMessage(detection, team, effectiveVerdict, systemOrphanTotal),
+            dedupKey: baseDedupKey,
+        };
+    }
+    /**
+     * Acknowledge a delivered alert: bumps cooldown bucket + budget counter.
+     * Suppressed decisions do NOT call this — they have no side-effects.
+     */
+    commitDecision(decision, now) {
+        if (decision.channel === 'suppressed')
+            return;
+        if (decision.effectiveVerdict === 'healthy')
+            return;
+        const cooldownMs = this.cooldownForVerdict(decision.effectiveVerdict);
+        const bucket = Math.floor(now.getTime() / cooldownMs);
+        this.cooldowns.set(decision.dedupKey, {
+            teamId: decision.detection.teamId,
+            verdict: decision.effectiveVerdict,
+            bucket, postedAt: now.getTime(),
+        });
+        this.bumpBudget(decision.detection.teamId, now);
+    }
+    cooldownForVerdict(v) {
+        switch (v) {
+            case 'cascade': return this.alertingConfig.cascadeCooldownMs;
+            case 'stuck': return this.alertingConfig.redCooldownMs;
+            case 'stalling':
+            case 'stale':
+            default: return this.alertingConfig.yellowCooldownMs;
+        }
+    }
+    channelForVerdict(v, team) {
+        if (v === 'cascade')
+            return 'ops-channel';
+        return team.slackThreadId ? 'team-thread' : 'tl-dm';
+    }
+    applyOffHoursDowngrade(v, now) {
+        if (!this.offHoursConfig.enabled)
+            return v;
+        if (v !== 'stuck')
+            return v;
+        if (isWithinWorkingHours(now, this.offHoursConfig))
+            return v;
+        return 'stalling';
+    }
+    dropCooldownsForTeam(teamId) {
+        let droppedAny = false;
+        for (const key of Array.from(this.cooldowns.keys())) {
+            const entry = this.cooldowns.get(key);
+            if (entry && entry.teamId === teamId) {
+                this.cooldowns.delete(key);
+                droppedAny = true;
+            }
+        }
+        return droppedAny;
+    }
+    budgetExceeded(teamId, now) {
+        const budget = this.budgets.get(teamId);
+        if (!budget)
+            return false;
+        const windowEnd = budget.windowStart + this.alertingConfig.alertBudgetWindowMs;
+        if (now.getTime() > windowEnd) {
+            this.budgets.delete(teamId);
+            return false;
+        }
+        return budget.count >= this.alertingConfig.alertBudgetMaxAlertsPerTeam;
+    }
+    bumpBudget(teamId, now) {
+        const existing = this.budgets.get(teamId);
+        if (!existing) {
+            this.budgets.set(teamId, { count: 1, windowStart: now.getTime() });
+            return;
+        }
+        const windowEnd = existing.windowStart + this.alertingConfig.alertBudgetWindowMs;
+        if (now.getTime() > windowEnd) {
+            this.budgets.set(teamId, { count: 1, windowStart: now.getTime() });
+        }
+        else {
+            existing.count += 1;
+        }
+    }
+}
+/**
+ * Test whether `now` is inside the configured working window for the
+ * owner timezone (§FP-2). Conservative on parsing — invalid inputs
+ * default to "always working hours".
+ */
+export function isWithinWorkingHours(now, config) {
+    const window = parseWorkingWindow(config.workingHours);
+    if (!window)
+        return true;
+    const local = renderLocalHourMinute(now, config.ownerTimezone);
+    if (!local)
+        return true;
+    const cur = local.hour * 60 + local.minute;
+    return cur >= window.startMin && cur < window.endMin;
+}
+function parseWorkingWindow(str) {
+    const m = str.match(/^(\d{1,2}):(\d{2})-(\d{1,2}):(\d{2})$/);
+    if (!m)
+        return null;
+    const startMin = parseInt(m[1], 10) * 60 + parseInt(m[2], 10);
+    const endMin = parseInt(m[3], 10) * 60 + parseInt(m[4], 10);
+    if (Number.isNaN(startMin) || Number.isNaN(endMin) || startMin >= endMin)
+        return null;
+    return { startMin, endMin };
+}
+function renderLocalHourMinute(d, tz) {
+    try {
+        const fmt = new Intl.DateTimeFormat('en-US', {
+            timeZone: tz, hour: '2-digit', minute: '2-digit', hour12: false,
+        });
+        const parts = fmt.formatToParts(d);
+        const hour = parseInt(parts.find((p) => p.type === 'hour')?.value ?? 'NaN', 10);
+        const minute = parseInt(parts.find((p) => p.type === 'minute')?.value ?? 'NaN', 10);
+        if (Number.isNaN(hour) || Number.isNaN(minute))
+            return null;
+        return { hour: hour === 24 ? 0 : hour, minute };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build the multi-line roll-up Slack message for one detection (§D.5).
+ *
+ * @param detection - The team's detection
+ * @param team - Team summary (for member labels and TL @mention)
+ * @param effectiveVerdict - Final verdict after off-hours downgrade
+ * @param systemOrphanTotal - System-wide orphan count for context line
+ * @returns Slack-ready message text
+ */
+export function formatRollupMessage(detection, team, effectiveVerdict, systemOrphanTotal) {
+    const display = VERDICT_DISPLAY[effectiveVerdict];
+    const teamLabel = team.name ?? team.id;
+    const lines = [];
+    if (effectiveVerdict === 'cascade') {
+        const others = (detection.cascadeWith ?? []).join(', ');
+        lines.push(`${display} Team cascade — ${teamLabel} (also affecting ${others})`);
+    }
+    else if (effectiveVerdict === 'stale') {
+        lines.push(`${display} Possibly-stale work in ${teamLabel}`);
+    }
+    else {
+        const tag = effectiveVerdict === 'stuck' ? 'stuck' : 'stalling';
+        lines.push(`${display} Team ${tag} — ${teamLabel}`);
+    }
+    if (detection.pendingWorkItemIds.length > 0) {
+        lines.push(`Pending work:  ${detection.pendingWorkItemIds.length} WorkItem(s) (${preview(detection.pendingWorkItemIds)})`);
+    }
+    if (detection.idleAgentSessions.length > 0) {
+        const tlMark = team.tlSession && detection.idleAgentSessions.includes(team.tlSession)
+            ? ` (TL ${team.tlSession} idle)`
+            : '';
+        lines.push(`Idle members:  ${detection.idleAgentSessions.length} session(s)${tlMark}`);
+    }
+    if (detection.staleWorkItemIds && detection.staleWorkItemIds.length > 0) {
+        lines.push(`Stale-fire suspects: ${preview(detection.staleWorkItemIds)}`);
+    }
+    if (detection.lostDispatchWorkItemIds && detection.lostDispatchWorkItemIds.length > 0) {
+        lines.push(`Lost-dispatch suspects: ${preview(detection.lostDispatchWorkItemIds)}`);
+    }
+    if (detection.orphanRequestIds && detection.orphanRequestIds.length > 0) {
+        lines.push(`Orphan Requests: ${detection.orphanRequestIds.length} (system-wide: ${systemOrphanTotal})`);
+    }
+    lines.push('');
+    lines.push(detection.rationale);
+    lines.push('');
+    lines.push('Suggested next step:');
+    if (effectiveVerdict === 'stuck' && team.tlSession) {
+        lines.push(`  • Restart TL: \`start-agent --member ${team.tlSession}\``);
+    }
+    if (effectiveVerdict === 'stuck' || effectiveVerdict === 'cascade') {
+        lines.push('  • Or reassign top-of-queue WorkItem to a sibling team');
+    }
+    if (effectiveVerdict === 'stale') {
+        lines.push('  • Confirm cancel with the assignee or push back via TL');
+    }
+    if (effectiveVerdict === 'stalling' &&
+        ((detection.orphanRequestIds?.length ?? 0) > 0 ||
+            (detection.lostDispatchWorkItemIds?.length ?? 0) > 0)) {
+        lines.push('  • Investigate — orphan Request or lost-dispatch suspected');
+    }
+    lines.push('');
+    lines.push('Suppress this alert: react with 🔇 (silences for 2h)');
+    return lines.join('\n');
+}
+/**
+ * Build the recovery message — short factual line, cooldown=0 (§6.3).
+ */
+export function formatRecoveryMessage(team, detection, now) {
+    void detection;
+    const teamLabel = team.name ?? team.id;
+    return `${VERDICT_DISPLAY.healthy} ${teamLabel} recovered at ${now.toISOString()}.`;
+}
+function formatHealthyNoOp(team, detection) {
+    void detection;
+    return `${VERDICT_DISPLAY.healthy} ${team.id} healthy.`;
+}
+function preview(ids, max = 3) {
+    if (ids.length <= max)
+        return ids.join(', ');
+    return `${ids.slice(0, max).join(', ')}, +${ids.length - max} more`;
+}
+//# sourceMappingURL=team-health-alert-router.js.map

package/dist/backend/backend/src/services/team-health/team-health-alert-router.js.map

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

package/dist/backend/backend/src/services/team-health/team-health-config.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Team-Health-Watchdog (THW) — Config Loader
+ *
+ * Reads `~/.crewly/team-health/config.json`, validates against the SEALED
+ * schema (§F.4), and on bad config logs `warn` and falls back to defaults.
+ * MUST NEVER throw or crash the backend (§11.3).
+ *
+ * Env overrides:
+ *   - TEAMHEALTH_ENABLED        ('true'/'false')
+ *   - TEAMHEALTH_SHADOW_MODE    ('true'/'false')
+ *   - TEAMHEALTH_T1_MS          (numeric ms)
+ *   - TEAMHEALTH_T2_MS          (numeric ms)
+ *
+ * @module services/team-health/team-health-config
+ */
+import type { TeamHealthConfig } from './team-health-types.js';
+export declare function resolveConfigPath(): string;
+export declare function resolveSidecarDir(): string;
+export interface ConfigLogger {
+    warn(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Load and validate the THW config from disk + env. Always returns a
+ * valid TeamHealthConfig — bad fields fall back to defaults with a warn.
+ *
+ * @param logger - Optional logger for warnings
+ * @returns A fully-populated, valid TeamHealthConfig
+ */
+export declare function loadTeamHealthConfig(logger?: ConfigLogger): TeamHealthConfig;
+/**
+ * Merge user-provided config object onto defaults. Validates types as
+ * it goes; invalid fields fall back to default with a warn.
+ */
+export declare function mergeWithDefaults(input: unknown, logger?: ConfigLogger): TeamHealthConfig;
+/**
+ * Apply environment-variable overrides on top of the merged config.
+ * Mutates `config` in place.
+ */
+export declare function applyEnvOverrides(config: TeamHealthConfig, logger?: ConfigLogger): void;
+//# sourceMappingURL=team-health-config.d.ts.map

package/dist/backend/backend/src/services/team-health/team-health-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-health-config.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/team-health/team-health-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,gBAAgB,CAoB5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,YAAY,GACpB,gBAAgB,CAwGlB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CA0BvF"}