@atolis-hq/wake 0.4.56 → 0.4.57

package/README.md

@@ -150,6 +150,10 @@ enter it in the UI. Successful logins persist for two years across browser and
 Wake-container restarts. Use `wake ui token set <key>` to replace the durable
 access key; replacement signs out existing sessions.
 
+Analytics provides live reports with selectable windows, run outcome buckets,
+and summary metrics alongside today's system activity counters. See
+[Analytics API](docs/analytics-api.md) and [web UI](docs/web-ui.md) for definitions.
+
 ## Supported Agent CLIs
 
 Wake wraps existing coding-agent CLIs rather than replacing them. Runner

package/dist/src/bootstrap/analytics-reports.d.ts

@@ -0,0 +1,27 @@
+import type { EventJournal } from '@atolis-hq/eventing';
+import { type ReportWindowId } from '../kernel/index.js';
+export declare function createAnalyticsReports(journal: EventJournal, now: () => string): {
+    catalogue: () => {
+        id: string;
+        title: string;
+    }[];
+    report(id: string, windowId: ReportWindowId, signal?: AbortSignal): Promise<{
+        data: import("../kernel/index.js").TimeSeriesReport;
+        meta: import("../surfaces/index.js").ResponseMeta;
+    }>;
+    summary(windowId: ReportWindowId, signal?: AbortSignal): Promise<{
+        data: {
+            workItemsDone: number;
+            medianEndToEndDurationMs: number | null;
+            runs: number;
+            completed: number;
+            blockedOrAwaitingApproval: number;
+            failed: number;
+            totalTokens: number;
+            totalCostUsd: number;
+            medianRunDurationMs: number | null;
+            window: import("../kernel/index.js").ReportWindow;
+        };
+        meta: import("../surfaces/index.js").ResponseMeta;
+    }>;
+};

package/dist/src/bootstrap/analytics-reports.js

@@ -0,0 +1,38 @@
+import { createRunOutcomesReport, queryRunAnalytics } from '../execution/index.js';
+import { reportWindow } from '../kernel/index.js';
+import { queryWorkCompletionSummary } from '../orchestration/index.js';
+import { sampledMeta } from './surface-api-metadata.js';
+export function createAnalyticsReports(journal, now) {
+    const definitions = [createRunOutcomesReport(journal)];
+    return {
+        catalogue: () => definitions.map(({ id, title }) => ({ id, title })),
+        async report(id, windowId, signal) {
+            const definition = definitions.find((report) => report.id === id);
+            if (definition === undefined)
+                throw new Error('Unknown report');
+            const collectedAt = now();
+            return {
+                data: await definition.query({
+                    window: reportWindow(windowId, collectedAt),
+                    ...(signal === undefined ? {} : { signal }),
+                }),
+                meta: sampledMeta(collectedAt),
+            };
+        },
+        async summary(windowId, signal) {
+            const collectedAt = now();
+            const query = {
+                window: reportWindow(windowId, collectedAt),
+                ...(signal === undefined ? {} : { signal }),
+            };
+            const [runs, work] = await Promise.all([
+                queryRunAnalytics(journal, query),
+                queryWorkCompletionSummary(journal, query),
+            ]);
+            return {
+                data: { window: query.window, ...runs.summary, ...work },
+                meta: sampledMeta(collectedAt),
+            };
+        },
+    };
+}

package/dist/src/bootstrap/surface-api-applications.js

@@ -1,6 +1,7 @@
 import { ActivationSchedulerSubscriptionStatus, ControlStreamKind, } from '../control-plane/index.js';
 import { ApiCommandStatus, fromWorkItemKey, presentBoardCard, presentResource, presentStatus, presentWorkflowInstance, redactConfiguration, } from '../surfaces/index.js';
 import { analyticsProjection } from './analytics-projection.js';
+import { createAnalyticsReports } from './analytics-reports.js';
 import { boardConditionCounts, boardProjection, normalizeBoardActiveRunPhase, } from './board-projection.js';
 import { primaryExternalRef } from './external-ref.js';
 import { createSelfUpdateFailureLog, describeSelfUpdateFailure, } from './self-update-failure-log.js';
@@ -187,6 +188,7 @@ async function recentEvents(journal, beforeGlobalPosition, limit, include) {
 }
 function createObservabilityApplications(root, now) {
     return {
+        reports: createAnalyticsReports(root.journal, now),
         async metrics(query = { days: 7 }) {
             const collectedAt = now();
             const stored = await root.projections.read(analyticsProjection.name, 'global');

package/dist/src/bootstrap/version.js

@@ -124,6 +124,6 @@ export function resolveWakeVersion(options = {}) {
         return `g${headHash.slice(0, 7)}`;
     return '0.1.0-dev';
 }
-export const wakeVersion = "v0.4.56";
+export const wakeVersion = "v0.4.57";
 /** The registry-installable version used by packaged sandbox images. */
 export const wakePackageVersion = packageVersion(defaultRepoRoot) ?? wakeVersion;

package/dist/src/execution/application/run-reports.d.ts

@@ -0,0 +1,29 @@
+import { type EventJournal } from '@atolis-hq/eventing';
+import { type ReportDefinition, type ReportQuery, type TimeSeriesReport, type ValueOf } from '../../kernel/index.js';
+import type { RunView } from '../contracts/views.js';
+export declare const RunReportId: {
+    readonly Outcomes: "run-outcomes-over-time";
+};
+export declare const RunReportOutcome: {
+    readonly Completed: "completed";
+    readonly Blocked: "blocked";
+    readonly AwaitingApproval: "awaiting-approval";
+    readonly Failed: "failed";
+    readonly Other: "other";
+};
+export type RunReportOutcome = ValueOf<typeof RunReportOutcome>;
+export interface RunSummary {
+    readonly runs: number;
+    readonly completed: number;
+    readonly blockedOrAwaitingApproval: number;
+    readonly failed: number;
+    readonly totalTokens: number;
+    readonly totalCostUsd: number;
+    readonly medianRunDurationMs: number | null;
+}
+export declare function runReportOutcome(run: RunView): RunReportOutcome;
+export declare function createRunOutcomesReport(journal: EventJournal): ReportDefinition;
+export declare function queryRunAnalytics(journal: EventJournal, query: ReportQuery): Promise<{
+    report: TimeSeriesReport;
+    summary: RunSummary;
+}>;

package/dist/src/execution/application/run-reports.js

@@ -0,0 +1,116 @@
+import { scanJournal, yieldScan } from '@atolis-hq/eventing';
+import { ActivityOutcomeKind } from '../../activities/index.js';
+import { defineClosedVocabulary, median, } from '../../kernel/index.js';
+import { selectRunExecutionEvent } from '../contracts/events.js';
+import { agentTokenUsage } from '../contracts/runner.js';
+import { RunStatus } from '../contracts/vocabulary.js';
+import { foldRunEvent } from '../domain/run.js';
+export const RunReportId = defineClosedVocabulary({ Outcomes: 'run-outcomes-over-time' });
+export const RunReportOutcome = defineClosedVocabulary({
+    Completed: 'completed',
+    Blocked: 'blocked',
+    AwaitingApproval: 'awaiting-approval',
+    Failed: 'failed',
+    Other: 'other',
+});
+const series = [
+    { id: RunReportOutcome.Completed, title: 'Completed' },
+    { id: RunReportOutcome.Blocked, title: 'Blocked' },
+    { id: RunReportOutcome.AwaitingApproval, title: 'Awaiting approval' },
+    { id: RunReportOutcome.Failed, title: 'Failed' },
+    { id: RunReportOutcome.Other, title: 'Other' },
+];
+export function runReportOutcome(run) {
+    if (run.status === RunStatus.Failed)
+        return RunReportOutcome.Failed;
+    if (run.status !== RunStatus.Succeeded)
+        return RunReportOutcome.Other;
+    switch (run.outcome?.kind) {
+        case ActivityOutcomeKind.Done:
+            return RunReportOutcome.Completed;
+        case ActivityOutcomeKind.Blocked:
+            return RunReportOutcome.Blocked;
+        case ActivityOutcomeKind.Waiting:
+            return RunReportOutcome.AwaitingApproval;
+        case ActivityOutcomeKind.Failed:
+        case ActivityOutcomeKind.Rejected:
+            return RunReportOutcome.Failed;
+        default:
+            return RunReportOutcome.Other;
+    }
+}
+export function createRunOutcomesReport(journal) {
+    return {
+        id: RunReportId.Outcomes,
+        title: 'Run outcomes over time',
+        query: async (query) => (await queryRunAnalytics(journal, query)).report,
+    };
+}
+export async function queryRunAnalytics(journal, query) {
+    const grouped = new Map();
+    for await (const event of scanJournal(journal, query.signal)) {
+        const owned = selectRunExecutionEvent(event);
+        if (owned === null)
+            continue;
+        grouped.set(owned.stream.id, foldRunEvent(grouped.get(owned.stream.id) ?? null, owned));
+    }
+    const from = Date.parse(query.window.from);
+    const to = Date.parse(query.window.to);
+    const first = Math.floor(from / query.window.bucketMs) * query.window.bucketMs;
+    const zero = () => Object.fromEntries(series.map(({ id }) => [id, 0]));
+    const buckets = [];
+    for (let start = first; start < to; start += query.window.bucketMs)
+        buckets.push({
+            from: new Date(start).toISOString(),
+            to: new Date(start + query.window.bucketMs).toISOString(),
+            values: zero(),
+        });
+    const totals = zero();
+    const durations = [];
+    let runs = 0, totalTokens = 0, totalCostUsd = 0, processed = 0;
+    for (const run of grouped.values()) {
+        if (processed++ % 100 === 0)
+            await yieldScan(query.signal);
+        const start = Date.parse(run.startedAt);
+        if (!(start >= from && start < to))
+            continue;
+        const outcome = runReportOutcome(run);
+        totals[outcome]++;
+        buckets[Math.floor((start - first) / query.window.bucketMs)].values[outcome]++;
+        runs++;
+        const usage = agentTokenUsage(run.agent?.metadata);
+        totalTokens += finiteOrZero(usage.tokens);
+        totalCostUsd += finiteOrZero(usage.costUsd);
+        const duration = runDuration(run);
+        if (duration !== null)
+            durations.push(duration);
+    }
+    query.signal?.throwIfAborted();
+    return {
+        report: {
+            report: { id: RunReportId.Outcomes, title: 'Run outcomes over time' },
+            window: query.window,
+            series,
+            totals,
+            buckets,
+        },
+        summary: {
+            runs,
+            completed: totals[RunReportOutcome.Completed],
+            blockedOrAwaitingApproval: totals[RunReportOutcome.Blocked] + totals[RunReportOutcome.AwaitingApproval],
+            failed: totals[RunReportOutcome.Failed],
+            totalTokens,
+            totalCostUsd,
+            medianRunDurationMs: await median(durations, () => yieldScan(query.signal)),
+        },
+    };
+}
+function finiteOrZero(value) {
+    return Number.isFinite(value) ? value : 0;
+}
+function runDuration(run) {
+    if (run.finishedAt === undefined)
+        return null;
+    const duration = Date.parse(run.finishedAt) - Date.parse(run.startedAt);
+    return Number.isFinite(duration) && duration >= 0 ? duration : null;
+}

package/dist/src/execution/contracts/runner.js

@@ -5,7 +5,7 @@ export const WakeMcpServerName = 'wake';
 export function agentTokenUsage(metadata) {
     const numeric = (key) => {
         const value = metadata?.[key];
-        return typeof value === 'number' ? value : 0;
+        return typeof value === 'number' && Number.isFinite(value) ? value : 0;
     };
     return {
         tokens: numeric('inputTokens') +

package/dist/src/execution/domain/run.d.ts

@@ -1,3 +1,5 @@
 import { type RunExecutionEvent } from '../contracts/events.js';
 import type { RunView } from '../contracts/views.js';
 export declare function foldRun(events: readonly RunExecutionEvent[]): RunView | null;
+/** Incremental replay for bounded live readers; persisted events must already be decoded. */
+export declare function foldRunEvent(previous: RunView | null, event: RunExecutionEvent): RunView;

package/dist/src/execution/domain/run.js

@@ -33,6 +33,16 @@ export function foldRun(events) {
         applyRunEvent(state, event.event);
     return state;
 }
+/** Incremental replay for bounded live readers; persisted events must already be decoded. */
+export function foldRunEvent(previous, event) {
+    if (previous === null)
+        return foldRun([event]);
+    if (event.event.eventType === ExecutionEventType.RunPreparationStarted)
+        throw invalidRunStream(event.stream.id, 'RunPreparationStarted must be the first event');
+    const next = { ...previous };
+    applyRunEvent(next, event.event);
+    return next;
+}
 function creationWorkspace(event) {
     if (event.eventType !== ExecutionEventType.RunStarted || event.payload.workspace === undefined)
         return {};

package/dist/src/execution/index.d.ts

@@ -32,3 +32,4 @@ export * from './infrastructure/transcripts.js';
 export * from './infrastructure/transcript-store.js';
 export * from './infrastructure/workspace/fake-workspace.js';
 export * from './infrastructure/workspace/git-workspace.js';
+export * from './application/run-reports.js';

package/dist/src/execution/index.js

@@ -32,3 +32,4 @@ export * from './infrastructure/transcripts.js';
 export * from './infrastructure/transcript-store.js';
 export * from './infrastructure/workspace/fake-workspace.js';
 export * from './infrastructure/workspace/git-workspace.js';
+export * from './application/run-reports.js';

package/dist/src/kernel/contracts/reports.d.ts

@@ -0,0 +1,39 @@
+import { type ValueOf } from './vocabulary.js';
+export declare const ReportWindowId: {
+    readonly Day: "1d";
+    readonly ThreeDays: "3d";
+    readonly FiveDays: "5d";
+    readonly Week: "7d";
+};
+export type ReportWindowId = ValueOf<typeof ReportWindowId>;
+export interface ReportWindow {
+    readonly id: ReportWindowId;
+    readonly from: string;
+    readonly to: string;
+    readonly bucketMs: number;
+}
+export interface ReportQuery {
+    readonly window: ReportWindow;
+    readonly signal?: AbortSignal;
+}
+export interface ReportDescriptor {
+    readonly id: string;
+    readonly title: string;
+}
+export interface TimeSeriesReport {
+    readonly report: ReportDescriptor;
+    readonly window: ReportWindow;
+    readonly series: readonly ReportDescriptor[];
+    readonly totals: Readonly<Record<string, number>>;
+    readonly buckets: readonly {
+        readonly from: string;
+        readonly to: string;
+        readonly values: Readonly<Record<string, number>>;
+    }[];
+}
+export interface ReportDefinition extends ReportDescriptor {
+    query(query: ReportQuery): Promise<TimeSeriesReport>;
+}
+export declare function reportWindow(id: ReportWindowId, now: string): ReportWindow;
+/** Exact median with bounded sorting/merging work between caller-supplied pauses. */
+export declare function median(values: readonly number[], pause: () => Promise<void>): Promise<number | null>;

package/dist/src/kernel/contracts/reports.js

@@ -0,0 +1,53 @@
+import { defineClosedVocabulary } from './vocabulary.js';
+export const ReportWindowId = defineClosedVocabulary({
+    Day: '1d',
+    ThreeDays: '3d',
+    FiveDays: '5d',
+    Week: '7d',
+});
+export function reportWindow(id, now) {
+    const day = 24 * 60 * 60 * 1000;
+    const days = {
+        [ReportWindowId.Day]: 1,
+        [ReportWindowId.ThreeDays]: 3,
+        [ReportWindowId.FiveDays]: 5,
+        [ReportWindowId.Week]: 7,
+    }[id];
+    const rolling = days <= 3;
+    const to = rolling ? Date.parse(now) : Math.floor(Date.parse(now) / day) * day;
+    return {
+        id,
+        from: new Date(to - days * day).toISOString(),
+        to: new Date(to).toISOString(),
+        bucketMs: days === 1 ? day / 24 : days === 3 ? day / 4 : day,
+    };
+}
+/** Exact median with bounded sorting/merging work between caller-supplied pauses. */
+export async function median(values, pause) {
+    if (values.length === 0)
+        return null;
+    const batchSize = 1024;
+    let sorted = [];
+    for (let start = 0; start < values.length; start += batchSize) {
+        await pause();
+        sorted.push(...values.slice(start, start + batchSize).sort((a, b) => a - b));
+    }
+    for (let width = batchSize; width < values.length; width *= 2) {
+        const merged = [];
+        for (let start = 0; start < values.length; start += width * 2) {
+            const middle = Math.min(start + width, values.length), end = Math.min(start + width * 2, values.length);
+            let left = start, right = middle;
+            while (left < middle || right < end) {
+                if (merged.length % batchSize === 0)
+                    await pause();
+                if (right === end || (left < middle && sorted[left] <= sorted[right]))
+                    merged.push(sorted[left++]);
+                else
+                    merged.push(sorted[right++]);
+            }
+        }
+        sorted = merged;
+    }
+    const middle = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0 ? (sorted[middle - 1] + sorted[middle]) / 2 : sorted[middle];
+}

package/dist/src/kernel/index.d.ts

@@ -8,3 +8,4 @@ export * from './domain/match-mode.js';
 export * from './domain/relation.js';
 export * from './infrastructure/system-clock.js';
 export * from './infrastructure/ulid-id-generator.js';
+export * from './contracts/reports.js';

package/dist/src/kernel/index.js

@@ -7,3 +7,4 @@ export * from './domain/match-mode.js';
 export * from './domain/relation.js';
 export * from './infrastructure/system-clock.js';
 export * from './infrastructure/ulid-id-generator.js';
+export * from './contracts/reports.js';

package/dist/src/node_modules/@atolis-hq/eventing/dist/index.d.ts

@@ -16,4 +16,5 @@ export * from './store/checkpoint-store.js';
 export * from './store/event-journal.js';
 export * from './subscriptions/event-processor.js';
 export * from './subscriptions/journal-change-signal.js';
+export * from './store/scan-journal.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/node_modules/@atolis-hq/eventing/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AAExC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAEjF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAEtF,cAAc,sCAAsC,CAAC;AAErD,cAAc,uCAAuC,CAAC;AAEtD,cAAc,mCAAmC,CAAC;AAElD,cAAc,kCAAkC,CAAC;AAEjD,cAAc,oBAAoB,CAAC;AAEnC,cAAc,mCAAmC,CAAC;AAElD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6BAA6B,CAAC;AAE5C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,oCAAoC,CAAC;AAEnD,cAAc,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AAExC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAEjF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAEtF,cAAc,sCAAsC,CAAC;AAErD,cAAc,uCAAuC,CAAC;AAEtD,cAAc,mCAAmC,CAAC;AAElD,cAAc,kCAAkC,CAAC;AAEjD,cAAc,oBAAoB,CAAC;AAEnC,cAAc,mCAAmC,CAAC;AAElD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6BAA6B,CAAC;AAE5C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,oCAAoC,CAAC;AAEnD,cAAc,0CAA0C,CAAC;AAEzD,cAAc,yBAAyB,CAAC"}

package/dist/src/node_modules/@atolis-hq/eventing/dist/index.js

@@ -15,3 +15,4 @@ export * from './store/checkpoint-store.js';
 export * from './store/event-journal.js';
 export * from './subscriptions/event-processor.js';
 export * from './subscriptions/journal-change-signal.js';
+export * from './store/scan-journal.js';

package/dist/src/node_modules/@atolis-hq/eventing/dist/store/event-journal.d.ts

@@ -5,6 +5,8 @@ export declare class WrongExpectedSequenceError extends Error {
 export interface EventJournal {
     appendToStream(stream: StreamRef, expectedSequence: number, events: readonly EventData[]): Promise<readonly EventEnvelope[]>;
     readStream(stream: StreamRef): Promise<readonly EventEnvelope[]>;
+    /** Optional bounded, cancellable snapshot reader for adapters with a streaming source. */
+    scanAll?(signal?: AbortSignal): AsyncIterable<EventEnvelope>;
     readAll(afterGlobalPosition: number, limit?: number): Promise<readonly EventEnvelope[]>;
     readLatest?(beforeGlobalPosition?: number, limit?: number): Promise<readonly EventEnvelope[]>;
     latestGlobalPosition(): Promise<number>;

package/dist/src/node_modules/@atolis-hq/eventing/dist/store/event-journal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-journal.d.ts","sourceRoot":"","sources":["../../src/store/event-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAErF,qBAAa,0BAA2B,SAAQ,KAAK;CAAG;AAExD,MAAM,WAAW,YAAY;IAC3B,cAAc,CACZ,MAAM,EAAE,SAAS,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,SAAS,EAAE,GAC3B,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACrC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,mBAAmB,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACxF,UAAU,CAAC,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IAI9F,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,kBAAkB,CAChB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;CAC5C"}
+{"version":3,"file":"event-journal.d.ts","sourceRoot":"","sources":["../../src/store/event-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAErF,qBAAa,0BAA2B,SAAQ,KAAK;CAAG;AAExD,MAAM,WAAW,YAAY;IAC3B,cAAc,CACZ,MAAM,EAAE,SAAS,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,SAAS,EAAE,GAC3B,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACrC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACjE,0FAA0F;IAC1F,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;IAC7D,OAAO,CAAC,mBAAmB,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACxF,UAAU,CAAC,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IAI9F,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,kBAAkB,CAChB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;CAC5C"}

package/dist/src/node_modules/@atolis-hq/eventing/dist/store/scan-journal.d.ts

@@ -0,0 +1,5 @@
+import type { EventJournal } from './event-journal.js';
+/** A bounded snapshot scan that gives hosts time to serve other work between batches. */
+export declare function scanJournal(journal: EventJournal, signal?: AbortSignal): AsyncGenerator<import("../index.js").EventEnvelope<import("../index.js").EventData<string, unknown>, import("../index.js").StreamRef<string, string>>, void, unknown>;
+export declare function yieldScan(signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=scan-journal.d.ts.map

package/dist/src/node_modules/@atolis-hq/eventing/dist/store/scan-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-journal.d.ts","sourceRoot":"","sources":["../../src/store/scan-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,yFAAyF;AACzF,wBAAuB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,yKAyB7E;AAED,wBAAsB,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAInE"}

package/dist/src/node_modules/@atolis-hq/eventing/dist/store/scan-journal.js

@@ -0,0 +1,34 @@
+/** A bounded snapshot scan that gives hosts time to serve other work between batches. */
+export async function* scanJournal(journal, signal) {
+    signal?.throwIfAborted();
+    if (journal.scanAll !== undefined) {
+        for await (const event of journal.scanAll(signal)) {
+            signal?.throwIfAborted();
+            yield event;
+        }
+        signal?.throwIfAborted();
+        return;
+    }
+    const end = await journal.latestGlobalPosition();
+    let position = 0;
+    while (position < end) {
+        await yieldScan(signal);
+        const batch = await journal.readAll(position, 100);
+        signal?.throwIfAborted();
+        if (batch.length === 0)
+            return;
+        for (const event of batch) {
+            signal?.throwIfAborted();
+            if (event.globalPosition > end)
+                return;
+            yield event;
+            position = event.globalPosition;
+        }
+    }
+    signal?.throwIfAborted();
+}
+export async function yieldScan(signal) {
+    signal?.throwIfAborted();
+    await new Promise((resolve) => setTimeout(resolve, 0));
+    signal?.throwIfAborted();
+}

package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-event-journal.d.ts

@@ -28,6 +28,10 @@ export declare class FileEventJournal implements EventJournal {
     appendToStream(stream: StreamRef, expectedSequence: number, drafts: readonly EventData[]): Promise<readonly EventEnvelope[]>;
     private nextSegmentFile;
     readStream(stream: StreamRef): Promise<readonly EventEnvelope<EventData<string, unknown>, StreamRef<string, string>>[]>;
+    /** Live readers bypass the full-history cache and stop at captured segment sizes. */
+    scanAll(signal?: AbortSignal): AsyncIterable<EventEnvelope>;
+    private scanSegment;
+    private decodeScanRecord;
     readAll(after: number, limit?: number): Promise<EventEnvelope<EventData<string, unknown>, StreamRef<string, string>>[]>;
     readLatest(beforeGlobalPosition?: number, limit?: number): Promise<EventEnvelope<EventData<string, unknown>, StreamRef<string, string>>[]>;
     latestGlobalPosition(): Promise<number>;

package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-event-journal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-event-journal.d.ts","sourceRoot":"","sources":["../src/file-event-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAW7B,MAAM,WAAW,uBAAuB;IACtC,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CACrD;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,IAAI,KACf,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAEtC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,8BAA8B,CAAC;IACzD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;CACvC;AAOD,qBAAa,gBAAiB,YAAW,YAAY;IAIjD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;gBAG1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,uBAA4B;IAKxD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsC;IACzE,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,qBAAqB,CAA4B;IAEzD,IAAI,YAAY,IAAI,mBAAmB,CAEtC;IAED,OAAO,CAAC,MAAM,CAOA;IAWd,OAAO,CAAC,YAAY,CAC4E;IAEhG,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,gBAAgB,CAC4D;IAEpF,OAAO,CAAC,oBAAoB,CAA2C;IACvE,OAAO,CAAC,yBAAyB,CAAK;IAEhC,cAAc,CAClB,MAAM,EAAE,SAAS,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,SAAS,EAAE,GAC3B,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;YAwCtB,eAAe;IAsBvB,UAAU,CAAC,MAAM,EAAE,SAAS;IA4B5B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAA2B;IAyBvD,UAAU,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,KAAK,SAA2B;IAW1E,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC,kBAAkB,CACtB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAWhB,OAAO,CAAC,mBAAmB;YAUb,kBAAkB;YA4BlB,WAAW;IAkDzB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;YAQf,eAAe;YAMf,YAAY;YAYZ,IAAI;YAYJ,kBAAkB;YAmBlB,kBAAkB;IAkBhC,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,0BAA0B;YAQpB,mBAAmB;IA0BjC,OAAO,CAAC,mBAAmB;YAwBb,eAAe;CAkD9B"}
+{"version":3,"file":"file-event-journal.d.ts","sourceRoot":"","sources":["../src/file-event-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAW7B,MAAM,WAAW,uBAAuB;IACtC,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CACrD;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,IAAI,KACf,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAEtC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,8BAA8B,CAAC;IACzD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;CACvC;AAOD,qBAAa,gBAAiB,YAAW,YAAY;IAIjD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;gBAG1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,uBAA4B;IAKxD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsC;IACzE,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,qBAAqB,CAA4B;IAEzD,IAAI,YAAY,IAAI,mBAAmB,CAEtC;IAED,OAAO,CAAC,MAAM,CAOA;IAWd,OAAO,CAAC,YAAY,CAC4E;IAEhG,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,gBAAgB,CAC4D;IAEpF,OAAO,CAAC,oBAAoB,CAA2C;IACvE,OAAO,CAAC,yBAAyB,CAAK;IAEhC,cAAc,CAClB,MAAM,EAAE,SAAS,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,SAAS,EAAE,GAC3B,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;YAwCtB,eAAe;IAsBvB,UAAU,CAAC,MAAM,EAAE,SAAS;IA4BlC,qFAAqF;IAC9E,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC;YAcnD,WAAW;IAgC1B,OAAO,CAAC,gBAAgB;IAoBlB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAA2B;IAyBvD,UAAU,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,KAAK,SAA2B;IAW1E,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC,kBAAkB,CACtB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAWhB,OAAO,CAAC,mBAAmB;YAUb,kBAAkB;YA4BlB,WAAW;IAkDzB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;YAQf,eAAe;YAMf,YAAY;YAYZ,IAAI;YAYJ,kBAAkB;YAmBlB,kBAAkB;IAkBhC,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,0BAA0B;YAQpB,mBAAmB;IA0BjC,OAAO,CAAC,mBAAmB;YAwBb,eAAe;CAkD9B"}

package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-event-journal.js

@@ -1,6 +1,6 @@
-import { decodeEventEnvelope, WrongExpectedSequenceError } from '@atolis-hq/eventing';
+import { decodeEventEnvelope, WrongExpectedSequenceError, yieldScan } from '@atolis-hq/eventing';
 import { InProcessJournalChangeSignal } from '@atolis-hq/eventing/memory';
-import { watch } from 'node:fs';
+import { createReadStream, watch } from 'node:fs';
 import { mkdir, open, readdir, readFile, rm, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { performance } from 'node:perf_hooks';
@@ -115,6 +115,64 @@ export class FileEventJournal {
         }
         return (await this.scan(entries)).filter((event) => key(event.stream) === streamKey);
     }
+    /** Live readers bypass the full-history cache and stop at captured segment sizes. */
+    async *scanAll(signal) {
+        signal?.throwIfAborted();
+        const entries = await this.readCurrentEntries();
+        let position = 0;
+        for (const entry of entries) {
+            let lineNumber = 0;
+            for await (const line of this.scanSegment(entry, signal)) {
+                if (position % 100 === 0)
+                    await yieldScan(signal);
+                signal?.throwIfAborted();
+                yield this.decodeScanRecord(entry.file, ++lineNumber, line, ++position);
+            }
+        }
+    }
+    async *scanSegment(entry, signal) {
+        if (entry.size === 0)
+            return;
+        const source = createReadStream(join(this.root, 'events', entry.file), {
+            encoding: 'utf8',
+            end: entry.size - 1,
+            ...(signal === undefined ? {} : { signal }),
+        });
+        let pending = '', bytes = 0;
+        try {
+            for await (const chunk of source) {
+                signal?.throwIfAborted();
+                const text = String(chunk);
+                bytes += Buffer.byteLength(text);
+                pending += text;
+                let offset = 0, newline = pending.indexOf('\n');
+                while (newline !== -1) {
+                    yield pending.slice(offset, newline);
+                    offset = newline + 1;
+                    newline = pending.indexOf('\n', offset);
+                }
+                pending = pending.slice(offset);
+            }
+            signal?.throwIfAborted();
+            if (pending !== '' || bytes !== entry.size)
+                throw new Error(`Incomplete trailing line in ${entry.file}`);
+        }
+        finally {
+            source.destroy();
+        }
+    }
+    decodeScanRecord(file, lineNumber, line, position) {
+        let input;
+        try {
+            input = JSON.parse(line);
+            const event = decodeEventRecord(input);
+            validateEnvelope(event, position);
+            return event;
+        }
+        catch (error) {
+            throw new Error(`Corrupt event at ${file}:${lineNumber}${eventContext(input)}: ${error.message}`, { cause: error });
+        }
+    }
     async readAll(after, limit = Number.POSITIVE_INFINITY) {
         const entries = await this.readEntriesForRead();
         if (this.cached !== undefined && sameEntries(this.cached.entries, entries))

package/dist/src/orchestration/application/work-completion-summary.d.ts

@@ -0,0 +1,6 @@
+import { type EventJournal } from '@atolis-hq/eventing';
+import { type ReportQuery } from '../../kernel/index.js';
+export declare function queryWorkCompletionSummary(journal: EventJournal, query: ReportQuery): Promise<{
+    workItemsDone: number;
+    medianEndToEndDurationMs: number | null;
+}>;

package/dist/src/orchestration/application/work-completion-summary.js

@@ -0,0 +1,49 @@
+import { scanJournal, yieldScan } from '@atolis-hq/eventing';
+import { median } from '../../kernel/index.js';
+import { selectWorkEvent, WorkEventType } from '../../work/index.js';
+import { selectWorkflowOrchestrationEvent } from '../contracts/event-decoder.js';
+import { OrchestrationEventType } from '../contracts/events.js';
+export async function queryWorkCompletionSummary(journal, query) {
+    const facts = { created: new Map(), instances: new Map(), completed: new Map() };
+    for await (const event of scanJournal(journal, query.signal))
+        acceptFact(facts, event);
+    const from = Date.parse(query.window.from), to = Date.parse(query.window.to);
+    let workItemsDone = 0, processed = 0;
+    const durations = [];
+    for (const [id, end] of facts.completed) {
+        if (processed++ % 100 === 0)
+            await yieldScan(query.signal);
+        if (!(end >= from && end < to))
+            continue;
+        workItemsDone++;
+        const start = facts.created.get(id);
+        if (start !== undefined && Number.isFinite(start) && end >= start)
+            durations.push(end - start);
+    }
+    return {
+        workItemsDone,
+        medianEndToEndDurationMs: await median(durations, () => yieldScan(query.signal)),
+    };
+}
+function acceptFact(facts, event) {
+    const work = selectWorkEvent(event);
+    if (work?.event.eventType === WorkEventType.ItemCreated)
+        facts.created.set(work.stream.id, Date.parse(work.event.occurredAt));
+    const workflow = selectWorkflowOrchestrationEvent(event);
+    if (workflow === null)
+        return;
+    switch (workflow.event.eventType) {
+        case OrchestrationEventType.InstanceStarted:
+            if (!('parentWorkflowInstanceId' in workflow.event.payload))
+                facts.instances.set(workflow.stream.id, workflow.event.payload.workItemId);
+            return;
+        case OrchestrationEventType.InstanceCompleted: {
+            const id = facts.instances.get(workflow.stream.id);
+            if (id !== undefined && !facts.completed.has(id))
+                facts.completed.set(id, Date.parse(workflow.event.occurredAt));
+            return;
+        }
+        default:
+            return;
+    }
+}