crewly 1.14.1 → 1.16.0

package/dist/backend/backend/src/services/v3/fallback-trigger-cleanup.subscriber.js

@@ -0,0 +1,129 @@
+/**
+ * Fallback Trigger Cleanup — cancels a delegation's "fallback check" timer
+ * the moment the delegated WorkItem reaches a terminal status.
+ *
+ * `delegate-task` arms a one-shot time trigger named
+ * `fallback-<target>-<wi8>` whose action creates a self-targeted "Fallback
+ * check on <target> for task <wi8>" WorkItem for the orchestrator. Nothing
+ * ever cancelled it, so on steamfun-ops it fired after every delegation
+ * whether the work was long verified or not: 26 of 65 real WorkItems in
+ * three days were these checks, each one a full orchestrator turn
+ * (2026-09-18). The skill's default was raised to 2 h; this subscriber
+ * removes the timer as soon as the work is done, verified or cancelled so it
+ * never fires for finished work at all.
+ *
+ * @module services/v3/fallback-trigger-cleanup.subscriber
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { formatError } from '../../utils/format-error.js';
+import { TriggerEngine } from './trigger-engine.service.js';
+/** Events after which a delegation's fallback timer is pointless. */
+export const FALLBACK_CLEANUP_EVENTS = [
+    'task:done',
+    'task:verified',
+    'task:cancelled',
+];
+/** Length of the WorkItem-id prefix `delegate-task` puts in the trigger name. */
+const WI_ID_PREFIX_LENGTH = 8;
+/**
+ * Name `delegate-task` gives the fallback timer for a WorkItem.
+ *
+ * @param workItemId - Full WorkItem id
+ * @param target - Session the work was delegated to
+ * @returns The trigger name
+ */
+export function fallbackTriggerName(workItemId, target) {
+    return `fallback-${target}-${workItemId.slice(0, WI_ID_PREFIX_LENGTH)}`;
+}
+/**
+ * Whether a trigger is the fallback timer for the given WorkItem, regardless
+ * of target (the event may not carry the target session).
+ *
+ * @param trigger - Candidate trigger
+ * @param workItemId - Full WorkItem id
+ * @returns True when the name matches `fallback-*-<wi8>`
+ */
+export function isFallbackTriggerFor(trigger, workItemId) {
+    const name = trigger.name ?? '';
+    return name.startsWith('fallback-') && name.endsWith(`-${workItemId.slice(0, WI_ID_PREFIX_LENGTH)}`);
+}
+/**
+ * Subscribes to task terminal events and cancels matching fallback timers.
+ */
+export class FallbackTriggerCleanupSubscriber {
+    logger;
+    eventBus;
+    triggers;
+    unsubscribers = [];
+    started = false;
+    constructor(deps) {
+        this.logger = LoggerService.getInstance().createComponentLogger('FallbackTriggerCleanup');
+        this.eventBus = deps.eventBus;
+        this.triggers = deps.triggers;
+    }
+    /**
+     * Production wiring.
+     *
+     * @param eventBus - The process event bus
+     * @returns A subscriber bound to the trigger engine singleton
+     */
+    static boot(eventBus) {
+        return new FallbackTriggerCleanupSubscriber({ eventBus, triggers: TriggerEngine.getInstance() });
+    }
+    /** Subscribe. Idempotent. */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        for (const eventType of FALLBACK_CLEANUP_EVENTS) {
+            this.unsubscribers.push(this.eventBus.onInProcess(eventType, (e) => {
+                void this.handle(e).catch((err) => {
+                    this.logger.warn('Fallback trigger cleanup failed', { eventType, error: formatError(err) });
+                });
+            }));
+        }
+        this.logger.info('FallbackTriggerCleanup subscribed', { eventTypes: [...FALLBACK_CLEANUP_EVENTS] });
+    }
+    /** Unsubscribe. Safe to call twice. */
+    stop() {
+        for (const u of this.unsubscribers) {
+            try {
+                u();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.unsubscribers = [];
+        this.started = false;
+    }
+    /**
+     * Cancel every live fallback timer for the event's WorkItem.
+     *
+     * @param event - A task terminal event
+     * @returns Number of triggers cancelled
+     */
+    async handle(event) {
+        const workItemId = event.workItemId;
+        if (!workItemId)
+            return 0;
+        let cancelled = 0;
+        for (const trigger of this.triggers.list()) {
+            if (trigger.status !== 'active' && trigger.status !== 'paused')
+                continue;
+            if (!isFallbackTriggerFor(trigger, workItemId))
+                continue;
+            if (await this.triggers.cancel(trigger.id)) {
+                cancelled += 1;
+                this.logger.info('Cancelled fallback timer for finished WorkItem', {
+                    workItemId,
+                    triggerId: trigger.id,
+                    name: trigger.name,
+                    event: event.type,
+                });
+            }
+        }
+        return cancelled;
+    }
+}
+//# sourceMappingURL=fallback-trigger-cleanup.subscriber.js.map

package/dist/backend/backend/src/services/v3/fallback-trigger-cleanup.subscriber.js.map

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

package/dist/backend/backend/src/services/v3/kr-completion.subscriber.d.ts

@@ -0,0 +1,118 @@
+/**
+ * KR Completion Subscriber
+ *
+ * Closes two gaps in the OKR runtime loop that the data model already
+ * supported but nothing ever drove:
+ *
+ * 1. **KR auto-measurement from task completion.**
+ *    `KRTrackingService.onWorkItemCompleted` maps completed/total linked
+ *    WorkItems onto a KR whose `measurementSource === 'task_completion'`,
+ *    but had zero production callers. This subscriber listens to the
+ *    pool's terminal-success events (`task:done`, `task:verified`),
+ *    resolves the KR either from `workItem.metadata.krId` or from any KR
+ *    of the mission whose `linkedWorkItemIds` contains the WI, and calls
+ *    `onWorkItemCompleted`.
+ *
+ * 2. **`team:all_tasks_done` publication.**
+ *    The event was declared, CRITICAL, subscribed to by the orchestrator
+ *    and handled by the EventToWorkItemBridge (→ `mission:review_due` →
+ *    review WI) — but nothing published it. On every task terminal event
+ *    (`task:done`, `task:verified`, `task:cancelled`) this subscriber
+ *    checks whether the WI's mission has zero non-terminal WorkItems left
+ *    and, if so, publishes once per mission per UTC day (idempotent id
+ *    `<missionId>:all_tasks_done:<YYYY-MM-DD>`).
+ *
+ * Follows the same shape as the other in-process subscribers (bridge,
+ * auto-learning, milestone): `onInProcess` subscriptions, per-dispatch
+ * try/catch, `flushPending()` for tests, idempotent `start()`/`stop()`.
+ *
+ * @module services/v3/kr-completion.subscriber
+ */
+import { type ComponentLogger } from '../core/logger.service.js';
+import type { EventBusService } from '../event-bus/event-bus.service.js';
+import type { EventType } from '../../types/event-bus.types.js';
+import type { WorkItem } from '../../types/v2/work-item.types.js';
+import type { KeyResult } from '../../types/v2/key-result.types.js';
+import type { Mission } from '../../types/v2/mission.types.js';
+/** Terminal-success events that may move a `task_completion` KR. */
+export declare const KR_MEASURE_EVENTS: readonly EventType[];
+/**
+ * Task terminal events after which a mission may have no active work left.
+ * `task:cancelled` is included so a mission whose last item was cancelled
+ * still gets its "all done — review" nudge.
+ */
+export declare const ALL_TASKS_DONE_TRIGGER_EVENTS: readonly EventType[];
+/** Minimal pool surface the subscriber needs. */
+export interface KRCompletionTaskPool {
+    findWorkItem(id: string): Promise<WorkItem | null | undefined>;
+    getAllItems(): Promise<WorkItem[]>;
+}
+/** Minimal KR-tracking surface the subscriber needs. */
+export interface KRCompletionTracker {
+    listByMission(missionId: string): Promise<KeyResult[]>;
+    get(missionId: string, krId: string): Promise<KeyResult | null>;
+    onWorkItemCompleted(workItem: WorkItem): Promise<void>;
+}
+/** Constructor dependencies (all injectable for tests). */
+export interface KRCompletionSubscriberDependencies {
+    eventBus: EventBusService;
+    taskPool: KRCompletionTaskPool;
+    krTracking: KRCompletionTracker;
+    /** Loads a mission by id (for `ownerTeamId` on the published event). */
+    loadMission?: (missionId: string) => Promise<Mission | null>;
+    logger?: ComponentLogger;
+    /** Clock override for the per-day dedup key. */
+    now?: () => Date;
+}
+/**
+ * Drives KR auto-measurement and `team:all_tasks_done` from task terminal
+ * events. See module docs.
+ */
+export declare class KRCompletionSubscriber {
+    private readonly eventBus;
+    private readonly taskPool;
+    private readonly krTracking;
+    private readonly loadMission;
+    private readonly logger;
+    private readonly now;
+    private unsubscribers;
+    private started;
+    private readonly pendingDispatches;
+    /** `<missionId>:<YYYY-MM-DD>` keys already published today (FIFO-bounded). */
+    private readonly publishedAllDone;
+    constructor(deps: KRCompletionSubscriberDependencies);
+    /**
+     * Production wiring helper — constructs from singletons.
+     *
+     * @param eventBus - The live event bus
+     * @returns A subscriber ready to `start()`
+     */
+    static boot(eventBus: EventBusService): KRCompletionSubscriber;
+    /** Subscribe to the task terminal events. Idempotent. */
+    start(): void;
+    /** Detach all subscriptions. Idempotent. */
+    stop(): void;
+    /** Await every in-flight dispatch. Test affordance. */
+    flushPending(): Promise<void>;
+    private safeDispatch;
+    /**
+     * Resolve the source WI, then run the KR measurement (success events
+     * only) and the all-tasks-done check (every trigger event). The two
+     * halves are independent — a failure in one is logged and does not stop
+     * the other.
+     */
+    private handle;
+    /**
+     * Find the KR the WI contributes to and feed it to
+     * {@link KRTrackingService.onWorkItemCompleted} when that KR is measured
+     * by task completion.
+     */
+    private measureKR;
+    /**
+     * Publish `team:all_tasks_done` once per mission per UTC day when the
+     * mission has no non-terminal WorkItems left in the pool.
+     */
+    private maybePublishAllTasksDone;
+    private rememberPublished;
+}
+//# sourceMappingURL=kr-completion.subscriber.d.ts.map

package/dist/backend/backend/src/services/v3/kr-completion.subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kr-completion.subscriber.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/kr-completion.subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,mCAAmC,CAAC;AAC/F,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAW/D,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAA4C,CAAC;AAE/F;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,SAAS,EAIpD,CAAC;AAYX,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC/D,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CACpC;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACvD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAChE,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,2DAA2D;AAC3D,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,UAAU,EAAE,mBAAmB,CAAC;IAChC,wEAAwE;IACxE,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC7D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAwBD;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IACnE,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;gBAErC,IAAI,EAAE,kCAAkC;IAUpD;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,sBAAsB;IAQ9D,yDAAyD;IACzD,KAAK,IAAI,IAAI;IAab,4CAA4C;IAC5C,IAAI,IAAI,IAAI;IAYZ,uDAAuD;IACjD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAUnC,OAAO,CAAC,YAAY;IAiBpB;;;;;OAKG;YACW,MAAM;IAoBpB;;;;OAIG;YACW,SAAS;IAoCvB;;;OAGG;YACW,wBAAwB;IAoCtC,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/backend/backend/src/services/v3/kr-completion.subscriber.js

@@ -0,0 +1,277 @@
+/**
+ * KR Completion Subscriber
+ *
+ * Closes two gaps in the OKR runtime loop that the data model already
+ * supported but nothing ever drove:
+ *
+ * 1. **KR auto-measurement from task completion.**
+ *    `KRTrackingService.onWorkItemCompleted` maps completed/total linked
+ *    WorkItems onto a KR whose `measurementSource === 'task_completion'`,
+ *    but had zero production callers. This subscriber listens to the
+ *    pool's terminal-success events (`task:done`, `task:verified`),
+ *    resolves the KR either from `workItem.metadata.krId` or from any KR
+ *    of the mission whose `linkedWorkItemIds` contains the WI, and calls
+ *    `onWorkItemCompleted`.
+ *
+ * 2. **`team:all_tasks_done` publication.**
+ *    The event was declared, CRITICAL, subscribed to by the orchestrator
+ *    and handled by the EventToWorkItemBridge (→ `mission:review_due` →
+ *    review WI) — but nothing published it. On every task terminal event
+ *    (`task:done`, `task:verified`, `task:cancelled`) this subscriber
+ *    checks whether the WI's mission has zero non-terminal WorkItems left
+ *    and, if so, publishes once per mission per UTC day (idempotent id
+ *    `<missionId>:all_tasks_done:<YYYY-MM-DD>`).
+ *
+ * Follows the same shape as the other in-process subscribers (bridge,
+ * auto-learning, milestone): `onInProcess` subscriptions, per-dispatch
+ * try/catch, `flushPending()` for tests, idempotent `start()`/`stop()`.
+ *
+ * @module services/v3/kr-completion.subscriber
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { SLA_TERMINAL_WORK_ITEM_STATUSES } from '../../types/v2/work-item.types.js';
+import { formatError } from '../../utils/format-error.js';
+import { safeReadJson } from '../../utils/file-io.utils.js';
+import { getMissionPath } from './mission-paths.js';
+import { KRTrackingService } from './kr-tracking.service.js';
+import { TaskPoolService } from '../task-pool/task-pool.service.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Terminal-success events that may move a `task_completion` KR. */
+export const KR_MEASURE_EVENTS = ['task:done', 'task:verified'];
+/**
+ * Task terminal events after which a mission may have no active work left.
+ * `task:cancelled` is included so a mission whose last item was cancelled
+ * still gets its "all done — review" nudge.
+ */
+export const ALL_TASKS_DONE_TRIGGER_EVENTS = [
+    'task:done',
+    'task:verified',
+    'task:cancelled',
+];
+/** Bounded size of the per-day `team:all_tasks_done` dedup set. */
+const ALL_TASKS_DONE_DEDUP_CAPACITY = 1000;
+/** KR measurement source that this subscriber is allowed to drive. */
+const TASK_COMPLETION_SOURCE = 'task_completion';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** UTC calendar-day key (`YYYY-MM-DD`). */
+function dayKey(now) {
+    return now.toISOString().slice(0, 10);
+}
+/** Default production mission loader — reads the shared missions dir. */
+async function defaultLoadMission(missionId) {
+    try {
+        return await safeReadJson(getMissionPath(missionId), null);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Subscriber
+// ---------------------------------------------------------------------------
+/**
+ * Drives KR auto-measurement and `team:all_tasks_done` from task terminal
+ * events. See module docs.
+ */
+export class KRCompletionSubscriber {
+    eventBus;
+    taskPool;
+    krTracking;
+    loadMission;
+    logger;
+    now;
+    unsubscribers = [];
+    started = false;
+    pendingDispatches = new Set();
+    /** `<missionId>:<YYYY-MM-DD>` keys already published today (FIFO-bounded). */
+    publishedAllDone = [];
+    constructor(deps) {
+        this.eventBus = deps.eventBus;
+        this.taskPool = deps.taskPool;
+        this.krTracking = deps.krTracking;
+        this.loadMission = deps.loadMission ?? defaultLoadMission;
+        this.logger =
+            deps.logger ?? LoggerService.getInstance().createComponentLogger('KRCompletionSubscriber');
+        this.now = deps.now ?? (() => new Date());
+    }
+    /**
+     * Production wiring helper — constructs from singletons.
+     *
+     * @param eventBus - The live event bus
+     * @returns A subscriber ready to `start()`
+     */
+    static boot(eventBus) {
+        return new KRCompletionSubscriber({
+            eventBus,
+            taskPool: TaskPoolService.getInstance(),
+            krTracking: KRTrackingService.getInstance(),
+        });
+    }
+    /** Subscribe to the task terminal events. Idempotent. */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        for (const eventType of ALL_TASKS_DONE_TRIGGER_EVENTS) {
+            this.unsubscribers.push(this.eventBus.onInProcess(eventType, (e) => this.safeDispatch(eventType, e)));
+        }
+        this.logger.info('KRCompletionSubscriber subscribed', {
+            eventTypes: ALL_TASKS_DONE_TRIGGER_EVENTS,
+        });
+    }
+    /** Detach all subscriptions. Idempotent. */
+    stop() {
+        for (const u of this.unsubscribers) {
+            try {
+                u();
+            }
+            catch (err) {
+                this.logger.warn('KRCompletion unsubscribe threw', { error: formatError(err) });
+            }
+        }
+        this.unsubscribers = [];
+        this.started = false;
+    }
+    /** Await every in-flight dispatch. Test affordance. */
+    async flushPending() {
+        while (this.pendingDispatches.size > 0) {
+            await Promise.allSettled(Array.from(this.pendingDispatches));
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Dispatch
+    // -------------------------------------------------------------------------
+    safeDispatch(eventType, event) {
+        const promise = (async () => {
+            try {
+                await this.handle(eventType, event);
+            }
+            catch (err) {
+                this.logger.warn('KRCompletion dispatch threw — swallowed', {
+                    eventType,
+                    eventId: event.id,
+                    error: formatError(err),
+                });
+            }
+        })();
+        this.pendingDispatches.add(promise);
+        promise.finally(() => this.pendingDispatches.delete(promise));
+        return promise;
+    }
+    /**
+     * Resolve the source WI, then run the KR measurement (success events
+     * only) and the all-tasks-done check (every trigger event). The two
+     * halves are independent — a failure in one is logged and does not stop
+     * the other.
+     */
+    async handle(eventType, event) {
+        if (!event.workItemId)
+            return;
+        const workItem = await this.taskPool.findWorkItem(event.workItemId);
+        if (!workItem || !workItem.missionId)
+            return;
+        if (KR_MEASURE_EVENTS.includes(eventType)) {
+            try {
+                await this.measureKR(workItem);
+            }
+            catch (err) {
+                this.logger.warn('KR auto-measure failed', {
+                    workItemId: workItem.id,
+                    missionId: workItem.missionId,
+                    error: formatError(err),
+                });
+            }
+        }
+        await this.maybePublishAllTasksDone(workItem.missionId);
+    }
+    /**
+     * Find the KR the WI contributes to and feed it to
+     * {@link KRTrackingService.onWorkItemCompleted} when that KR is measured
+     * by task completion.
+     */
+    async measureKR(workItem) {
+        const missionId = workItem.missionId;
+        const explicitKrId = typeof workItem.metadata?.krId === 'string' ? workItem.metadata.krId : undefined;
+        let kr = null;
+        if (explicitKrId) {
+            kr = await this.krTracking.get(missionId, explicitKrId);
+        }
+        else {
+            const krs = await this.krTracking.listByMission(missionId);
+            kr = krs.find((k) => k.linkedWorkItemIds.includes(workItem.id)) ?? null;
+        }
+        if (!kr)
+            return;
+        if (kr.measurementSource !== TASK_COMPLETION_SOURCE) {
+            this.logger.debug('KR not measured by task completion — skipping auto-measure', {
+                krId: kr.id,
+                measurementSource: kr.measurementSource,
+            });
+            return;
+        }
+        // `onWorkItemCompleted` keys on `metadata.krId`; inject it when the link
+        // was discovered via `linkedWorkItemIds` so the existing service method
+        // can stay untouched.
+        const withKr = explicitKrId
+            ? workItem
+            : { ...workItem, metadata: { ...(workItem.metadata ?? {}), krId: kr.id } };
+        await this.krTracking.onWorkItemCompleted(withKr);
+        this.logger.info('KR auto-measured from task completion', {
+            krId: kr.id,
+            missionId,
+            workItemId: workItem.id,
+        });
+    }
+    /**
+     * Publish `team:all_tasks_done` once per mission per UTC day when the
+     * mission has no non-terminal WorkItems left in the pool.
+     */
+    async maybePublishAllTasksDone(missionId) {
+        const key = `${missionId}:${dayKey(this.now())}`;
+        if (this.publishedAllDone.includes(key))
+            return;
+        const allItems = await this.taskPool.getAllItems();
+        const missionItems = allItems.filter((wi) => wi.missionId === missionId);
+        if (missionItems.length === 0)
+            return;
+        const active = missionItems.filter((wi) => !SLA_TERMINAL_WORK_ITEM_STATUSES.has(wi.status));
+        if (active.length > 0)
+            return;
+        // Re-check after the awaits: two WIs finishing in the same tick both
+        // pass the early check above; only the first to reach this synchronous
+        // section may publish.
+        if (this.publishedAllDone.includes(key))
+            return;
+        this.rememberPublished(key);
+        const mission = await this.loadMission(missionId);
+        this.eventBus.publish({
+            id: `${missionId}:all_tasks_done:${dayKey(this.now())}`,
+            type: 'team:all_tasks_done',
+            timestamp: this.now().toISOString(),
+            teamId: mission?.ownerTeamId ?? '',
+            teamName: '',
+            memberId: '',
+            memberName: '',
+            sessionName: '',
+            previousValue: String(missionItems.length),
+            newValue: 'all_tasks_done',
+            changedField: 'taskStatus',
+            missionId,
+        });
+        this.logger.info('team:all_tasks_done published', {
+            missionId,
+            totalItems: missionItems.length,
+        });
+    }
+    rememberPublished(key) {
+        this.publishedAllDone.push(key);
+        if (this.publishedAllDone.length > ALL_TASKS_DONE_DEDUP_CAPACITY) {
+            this.publishedAllDone.shift();
+        }
+    }
+}
+//# sourceMappingURL=kr-completion.subscriber.js.map

package/dist/backend/backend/src/services/v3/kr-completion.subscriber.js.map

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

package/dist/backend/backend/src/services/v3/kr-skill-measurer.service.d.ts

@@ -0,0 +1,117 @@
+/**
+ * KR Skill Measurer — fills `measurementSource: 'skill_output'` Key Results
+ * from a skill's JSON output.
+ *
+ * Until 2026-09-18 a KR's value had exactly three ways to change and all of
+ * them were a hand-made API call, so "tickets waiting for acceptance" or
+ * "build pass rate" could only be tracked by someone remembering to type the
+ * number in. A KR configured as
+ *
+ * ```json
+ * { "measurementSource": "skill_output",
+ *   "measurementConfig": { "skill": "steamfun-ticket-count",
+ *                          "args": { "status": "review" },
+ *                          "jsonPath": ".count" } }
+ * ```
+ *
+ * is now measured on every mission sweep: the named skill's `execute.sh` is
+ * run with the JSON args, the number at `jsonPath` is read from its stdout
+ * and recorded as a measurement (deduped when unchanged since the last one).
+ *
+ * Safety: `skill` is a bare name (`[a-z0-9-]`) resolved against the known
+ * skill roots only — never a path — and runs with a hard timeout and a
+ * bounded output size. This is the same trust boundary as an agent running
+ * the skill itself, not a new one.
+ *
+ * @module services/v3/kr-skill-measurer.service
+ */
+import { KRTrackingService } from './kr-tracking.service.js';
+import type { KeyResult } from '../../types/v2/key-result.types.js';
+/** Shape of `measurementConfig` for a `skill_output` KR. */
+export interface SkillOutputMeasurementConfig {
+    /** Bare skill directory name, e.g. `steamfun-ticket-count`. */
+    skill: string;
+    /** JSON object passed to the skill as its single argument. */
+    args?: Record<string, unknown>;
+    /** Dot path into the skill's JSON stdout, e.g. `.count` or `.data.total`. Default `.value`. */
+    jsonPath?: string;
+}
+/** What one measurement attempt produced. */
+export interface SkillMeasurementOutcome {
+    krId: string;
+    status: 'recorded' | 'unchanged' | 'skipped' | 'failed';
+    value?: number;
+    reason?: string;
+}
+/** Runs a resolved skill and returns its stdout. Injectable for tests. */
+export type SkillRunner = (executePath: string, argsJson: string, timeoutMs: number) => Promise<string>;
+/**
+ * Default runner: `bash <execute.sh> '<json>'` with a timeout and output cap.
+ *
+ * @param executePath - Absolute path of the skill's execute.sh
+ * @param argsJson - JSON argument string
+ * @param timeoutMs - Kill the skill after this long
+ * @returns stdout
+ */
+export declare const defaultSkillRunner: SkillRunner;
+/**
+ * Read a dot path (`.a.b.c`, leading dot optional) out of parsed JSON.
+ *
+ * @param value - Parsed JSON
+ * @param jsonPath - Dot path
+ * @returns The value at the path, or undefined
+ */
+export declare function readJsonPath(value: unknown, jsonPath: string): unknown;
+/**
+ * Coerce a skill output value to a number: numbers as is, booleans to 1/0,
+ * numeric strings parsed. Anything else is undefined.
+ *
+ * @param raw - Value read from the skill output
+ * @returns A finite number or undefined
+ */
+export declare function coerceMeasurement(raw: unknown): number | undefined;
+/**
+ * Measures `skill_output` Key Results by running their skill.
+ */
+export declare class KRSkillMeasurerService {
+    private static instance;
+    private readonly logger;
+    private readonly runner;
+    private readonly skillRoots;
+    private readonly krTracking;
+    /**
+     * @param opts - Test seams: skill roots to search, a runner, a KR service
+     */
+    constructor(opts?: {
+        skillRoots?: string[];
+        runner?: SkillRunner;
+        krTracking?: KRTrackingService;
+        projectRoot?: string;
+    });
+    static getInstance(): KRSkillMeasurerService;
+    static setInstance(next: KRSkillMeasurerService | null): void;
+    /**
+     * Resolve a bare skill name to its `execute.sh`, searching the known roots.
+     *
+     * @param skill - Bare directory name
+     * @returns Absolute path, or null when the name is invalid or not found
+     */
+    resolveSkill(skill: string): string | null;
+    /**
+     * Measure every `skill_output` KR of a mission. Failure-soft: one KR's
+     * error never stops the others, and nothing throws to the sweep.
+     *
+     * @param missionId - Mission whose KRs to measure
+     * @returns One outcome per skill_output KR
+     */
+    measureMission(missionId: string): Promise<SkillMeasurementOutcome[]>;
+    /**
+     * Measure one KR. Exposed for the manual `POST …/measure-now` path.
+     *
+     * @param missionId - Owning mission
+     * @param kr - The KR (must be `skill_output`)
+     * @returns The outcome
+     */
+    measureOne(missionId: string, kr: KeyResult): Promise<SkillMeasurementOutcome>;
+}
+//# sourceMappingURL=kr-skill-measurer.service.d.ts.map