stitchkit 0.109.1 → 0.109.3

package/CHANGELOG.md

@@ -15,6 +15,27 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.109.3] - 2026-10-13
+
+### Added
+
+- `stitchkit/application` — `createApplicationOpenTelemetry` reports
+  `stitchkit.application.schedule.runs_woken` and `.wakes_coalesced` beside the existing schedule
+  counters, so a dashboard shows how many runs came from `wake()` and how many came from the
+  period.
+
+## [0.109.2] - 2026-10-13
+
+### Added
+
+- `stitchkit/application` — `ManagedSchedule.wake()` runs the schedule now, for the owner of the
+  event that creates its work. The run takes the timer's path (`dependsOn`, `overlap`,
+  `errorPolicy`, `onError`, counters); calls in one tick or during a busy run collapse into one
+  following run; before activation and after stop it does nothing. The period keeps its grid, so
+  `everyMs: 1000` polling becomes `everyMs: 60_000` plus `wake()`. `ManagedScheduleRunContext`
+  gains `trigger` (`'timer' | 'wake'`) and `ManagedScheduleStatus` gains `runsWoken`,
+  `wakesCoalesced` and `lastTrigger`.
+
 ## [0.109.1] - 2026-10-11
 
 ### Fixed

package/dist/application/opentelemetry.d.ts

@@ -1,7 +1,7 @@
 import type { Attributes, MetricOptions, ObservableGauge } from '@opentelemetry/api';
 import type { ActivityProjection } from './activity.js';
 import type { ApplicationHandle } from './kernel-contract.js';
-import type { ManagedSchedule } from './schedule.js';
+import type { ManagedSchedule } from './schedule-contract.js';
 export interface ApplicationTelemetryMeter {
     createObservableGauge(name: string, options?: MetricOptions): ObservableGauge<Attributes>;
 }

package/dist/application/opentelemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../../src/application/opentelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAEb,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAYlD,MAAM,WAAW,yBAAyB;IACxC,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,CAAC;IAChE,iBAAiB,CAAC,CAAC,OAAO,EAAE,uCAAuC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf;AAwOD,iFAAiF;AACjF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,8BAA8B,GACrC,+BAA+B,CAwJjC"}
+{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../../src/application/opentelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAEb,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAY3D,MAAM,WAAW,yBAAyB;IACxC,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,CAAC;IAChE,iBAAiB,CAAC,CAAC,OAAO,EAAE,uCAAuC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf;AAkPD,iFAAiF;AACjF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,8BAA8B,GACrC,+BAA+B,CAwJjC"}

package/dist/application/schedule-contract.d.ts

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+import type { ManagedResource } from './resource.js';
+export declare const ManagedScheduleOverlapSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    mode: z.ZodLiteral<"skip">;
+}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+    mode: z.ZodLiteral<"queue-one">;
+}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+    mode: z.ZodLiteral<"parallel">;
+    maxConcurrent: z.ZodNumber;
+}, z.core.$strip>>], "mode">;
+export type ManagedScheduleOverlap = z.infer<typeof ManagedScheduleOverlapSchema>;
+export declare const ManagedScheduleErrorPolicySchema: z.ZodEnum<{
+    continue: "continue";
+    "stop-schedule": "stop-schedule";
+}>;
+export type ManagedScheduleErrorPolicy = z.infer<typeof ManagedScheduleErrorPolicySchema>;
+declare const ManagedScheduleTriggerSchema: z.ZodEnum<{
+    timer: "timer";
+    wake: "wake";
+}>;
+/** What started a run: the period elapsing, or the owner's `wake()`. */
+export type ManagedScheduleTrigger = z.infer<typeof ManagedScheduleTriggerSchema>;
+export declare const ManagedScheduleDescriptorSchema: z.ZodReadonly<z.ZodObject<{
+    id: z.ZodString;
+    everyMs: z.ZodNumber;
+    startAfterMs: z.ZodNumber;
+    overlap: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        mode: z.ZodLiteral<"skip">;
+    }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+        mode: z.ZodLiteral<"queue-one">;
+    }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+        mode: z.ZodLiteral<"parallel">;
+        maxConcurrent: z.ZodNumber;
+    }, z.core.$strip>>], "mode">;
+    errorPolicy: z.ZodEnum<{
+        continue: "continue";
+        "stop-schedule": "stop-schedule";
+    }>;
+}, z.core.$strip>>;
+export type ManagedScheduleDescriptor = z.infer<typeof ManagedScheduleDescriptorSchema>;
+export declare const ManagedScheduleStatusSchema: z.ZodReadonly<z.ZodObject<{
+    descriptor: z.ZodReadonly<z.ZodObject<{
+        id: z.ZodString;
+        everyMs: z.ZodNumber;
+        startAfterMs: z.ZodNumber;
+        overlap: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+            mode: z.ZodLiteral<"skip">;
+        }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+            mode: z.ZodLiteral<"queue-one">;
+        }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+            mode: z.ZodLiteral<"parallel">;
+            maxConcurrent: z.ZodNumber;
+        }, z.core.$strip>>], "mode">;
+        errorPolicy: z.ZodEnum<{
+            continue: "continue";
+            "stop-schedule": "stop-schedule";
+        }>;
+    }, z.core.$strip>>;
+    state: z.ZodEnum<{
+        draining: "draining";
+        inactive: "inactive";
+        running: "running";
+        scheduled: "scheduled";
+        stopped: "stopped";
+    }>;
+    revision: z.ZodNumber;
+    capturedAt: z.ZodString;
+    changedAt: z.ZodString;
+    accepting: z.ZodBoolean;
+    active: z.ZodNumber;
+    queued: z.ZodBoolean;
+    runsStarted: z.ZodNumber;
+    runsCompleted: z.ZodNumber;
+    runsFailed: z.ZodNumber;
+    runsWoken: z.ZodNumber;
+    ticksSkipped: z.ZodNumber;
+    wakesCoalesced: z.ZodNumber;
+    lastTrigger: z.ZodNullable<z.ZodEnum<{
+        timer: "timer";
+        wake: "wake";
+    }>>;
+    nextRunAt: z.ZodNullable<z.ZodString>;
+    lastScheduledAt: z.ZodNullable<z.ZodString>;
+    lastStartedAt: z.ZodNullable<z.ZodString>;
+    lastFinishedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export type ManagedScheduleStatus = z.infer<typeof ManagedScheduleStatusSchema>;
+export interface ManagedScheduleTimer {
+    cancel(): void;
+}
+/** Monotonic timer boundary. Tests can replace it without changing schedule semantics. */
+export interface ManagedScheduleClock {
+    /** Monotonic clock used for cadence and deadline arithmetic. */
+    now(): number;
+    /** Wall clock used only to project portable status timestamps. */
+    wallNow(): Date;
+    schedule(callback: () => void, delayMs: number): ManagedScheduleTimer;
+}
+export interface ManagedScheduleRunContext {
+    readonly applicationId: string;
+    readonly signal: AbortSignal;
+    readonly scheduledAt: number;
+    readonly startedAt: number;
+    readonly trigger: ManagedScheduleTrigger;
+    now(): number;
+}
+export interface ManagedScheduleConfig {
+    readonly id: string;
+    readonly dependsOn?: readonly string[];
+    readonly required?: boolean;
+    readonly everyMs: number;
+    /** Defaults to one interval. A zero value schedules the first run after activation. */
+    readonly startAfterMs?: number;
+    readonly overlap?: ManagedScheduleOverlap;
+    readonly errorPolicy?: ManagedScheduleErrorPolicy;
+    readonly run: (context: ManagedScheduleRunContext) => void | Promise<void>;
+    readonly onError?: (error: unknown, context: ManagedScheduleRunContext) => void | Promise<void>;
+    readonly clock?: ManagedScheduleClock;
+}
+export interface ManagedSchedule extends ManagedResource {
+    readonly status: ManagedScheduleStatus;
+    /**
+     * Ask for one run now, because the owner knows work has appeared. The run takes the same path
+     * as a timer run: `overlap`, `onError`, `errorPolicy` and the counters apply, and the period
+     * keeps its own cadence as the check for an event that was lost. Calls made in one tick, or
+     * while a run holds every slot, collapse into one following run. Before the schedule is
+     * activated and after it stops accepting, the call does nothing and is not remembered.
+     */
+    wake(): void;
+}
+export {};
+//# sourceMappingURL=schedule-contract.d.ts.map

package/dist/application/schedule-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-contract.d.ts","sourceRoot":"","sources":["../../src/application/schedule-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAalD,eAAO,MAAM,4BAA4B;;;;;;;4BASvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,gCAAgC;;;EAAwC,CAAC;AACtF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,QAAA,MAAM,4BAA4B;;;EAA4B,CAAC;AAC/D,wEAAwE;AACxE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;kBAQ/B,CAAC;AACd,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsB3B,CAAC;AACd,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,MAAM,WAAW,oBAAoB;IACnC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,GAAG,IAAI,MAAM,CAAC;IACd,kEAAkE;IAClE,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAAC;CACvE;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,GAAG,IAAI,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,0BAA0B,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,CACjB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,KAC/B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC;;;;;;OAMG;IACH,IAAI,IAAI,IAAI,CAAC;CACd"}

package/dist/application/schedule-run.d.ts

@@ -0,0 +1,47 @@
+import type { ManagedResourceContext } from './resource.js';
+import { type ManagedScheduleClock, type ManagedScheduleConfig, type ManagedScheduleDescriptor, type ManagedScheduleOverlap, type ManagedScheduleRunContext, type ManagedScheduleStatus, type ManagedScheduleTrigger } from './schedule-contract.js';
+export interface ScheduleCounts {
+    runsStarted: number;
+    runsCompleted: number;
+    runsFailed: number;
+    runsWoken: number;
+    ticksSkipped: number;
+    wakesCoalesced: number;
+    lastTrigger: ManagedScheduleTrigger | null;
+    lastScheduledAt: string | null;
+    lastStartedAt: string | null;
+    lastFinishedAt: string | null;
+}
+export declare function emptyCounts(): ScheduleCounts;
+/** The validated public descriptor of a schedule configuration, with defaults applied. */
+export declare function describeSchedule(config: ManagedScheduleConfig): ManagedScheduleDescriptor;
+export declare function scheduleState(activated: boolean, stopped: boolean, accepting: boolean, active: number): ManagedScheduleStatus['state'];
+/** A monotonic instant on the wall clock, through one captured anchor. */
+export declare function wallAt(monotonicAt: number | null, anchor: {
+    readonly monotonicNow: number;
+    readonly wallNow: number;
+}): string | null;
+/** What a due tick does under the overlap policy, given how many runs are active. A wake that
+ *  is not `start` waits for a free slot under every policy: it is an event, not a missed tick. */
+export declare function overlapDecision(overlap: ManagedScheduleOverlap, active: number): 'start' | 'queue' | 'skip';
+export declare function reportScheduleError(config: ManagedScheduleConfig, error: unknown, context: ManagedScheduleRunContext): void;
+/** Wait for the active runs to settle, or for the signal or the deadline first. */
+export declare function waitForSettled(active: ReadonlySet<Promise<void>>, clock: ManagedScheduleClock, context: ManagedResourceContext, deadlineAt: number | undefined): Promise<void>;
+export interface RunDeps {
+    readonly config: ManagedScheduleConfig;
+    readonly descriptor: ManagedScheduleDescriptor;
+    readonly clock: ManagedScheduleClock;
+    readonly counts: ScheduleCounts;
+    readonly resourceContext: ManagedResourceContext;
+    changed(): void;
+    stopAdmission(): void;
+    isAccepting(): boolean;
+}
+/**
+ * One execution of the schedule's `run`, counted and timestamped, with its
+ * outcome turned into health under the error policy. Never rejects.
+ */
+export declare function executeRun(deps: RunDeps, scheduledAt: number, trigger: ManagedScheduleTrigger): Promise<void>;
+/** How many whole intervals a late timer spans: at least one, the tick it fired for. */
+export declare function elapsedIntervals(scheduledAt: number, observedAt: number, everyMs: number): number;
+//# sourceMappingURL=schedule-run.d.ts.map

package/dist/application/schedule-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-run.d.ts","sourceRoot":"","sources":["../../src/application/schedule-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAE9B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC3C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,wBAAgB,WAAW,IAAI,cAAc,CAa5C;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,qBAAqB,GAAG,yBAAyB,CAQzF;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,MAAM,GACb,qBAAqB,CAAC,OAAO,CAAC,CAIhC;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CACpB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,MAAM,EAAE;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClE,MAAM,GAAG,IAAI,CAGf;AAED;kGACkG;AAClG,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,GAAG,OAAO,GAAG,MAAM,CAI5B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,IAAI,CAON;AAED,mFAAmF;AACnF,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAClC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,sBAAsB,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,OAAO,IAAI,IAAI,CAAC;IAChB,aAAa,IAAI,IAAI,CAAC;IACtB,WAAW,IAAI,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,MAAM,CAER"}

package/dist/application/schedule.d.ts

@@ -1,111 +1,4 @@
-import { z } from 'zod';
-import type { ManagedResource } from './resource.js';
-export declare const ManagedScheduleOverlapSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
-    mode: z.ZodLiteral<"skip">;
-}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
-    mode: z.ZodLiteral<"queue-one">;
-}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
-    mode: z.ZodLiteral<"parallel">;
-    maxConcurrent: z.ZodNumber;
-}, z.core.$strip>>], "mode">;
-export type ManagedScheduleOverlap = z.infer<typeof ManagedScheduleOverlapSchema>;
-export declare const ManagedScheduleErrorPolicySchema: z.ZodEnum<{
-    continue: "continue";
-    "stop-schedule": "stop-schedule";
-}>;
-export type ManagedScheduleErrorPolicy = z.infer<typeof ManagedScheduleErrorPolicySchema>;
-export declare const ManagedScheduleDescriptorSchema: z.ZodReadonly<z.ZodObject<{
-    id: z.ZodString;
-    everyMs: z.ZodNumber;
-    startAfterMs: z.ZodNumber;
-    overlap: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
-        mode: z.ZodLiteral<"skip">;
-    }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
-        mode: z.ZodLiteral<"queue-one">;
-    }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
-        mode: z.ZodLiteral<"parallel">;
-        maxConcurrent: z.ZodNumber;
-    }, z.core.$strip>>], "mode">;
-    errorPolicy: z.ZodEnum<{
-        continue: "continue";
-        "stop-schedule": "stop-schedule";
-    }>;
-}, z.core.$strip>>;
-export type ManagedScheduleDescriptor = z.infer<typeof ManagedScheduleDescriptorSchema>;
-export declare const ManagedScheduleStatusSchema: z.ZodReadonly<z.ZodObject<{
-    descriptor: z.ZodReadonly<z.ZodObject<{
-        id: z.ZodString;
-        everyMs: z.ZodNumber;
-        startAfterMs: z.ZodNumber;
-        overlap: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
-            mode: z.ZodLiteral<"skip">;
-        }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
-            mode: z.ZodLiteral<"queue-one">;
-        }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
-            mode: z.ZodLiteral<"parallel">;
-            maxConcurrent: z.ZodNumber;
-        }, z.core.$strip>>], "mode">;
-        errorPolicy: z.ZodEnum<{
-            continue: "continue";
-            "stop-schedule": "stop-schedule";
-        }>;
-    }, z.core.$strip>>;
-    state: z.ZodEnum<{
-        draining: "draining";
-        inactive: "inactive";
-        running: "running";
-        scheduled: "scheduled";
-        stopped: "stopped";
-    }>;
-    revision: z.ZodNumber;
-    capturedAt: z.ZodString;
-    changedAt: z.ZodString;
-    accepting: z.ZodBoolean;
-    active: z.ZodNumber;
-    queued: z.ZodBoolean;
-    runsStarted: z.ZodNumber;
-    runsCompleted: z.ZodNumber;
-    runsFailed: z.ZodNumber;
-    ticksSkipped: z.ZodNumber;
-    nextRunAt: z.ZodNullable<z.ZodString>;
-    lastScheduledAt: z.ZodNullable<z.ZodString>;
-    lastStartedAt: z.ZodNullable<z.ZodString>;
-    lastFinishedAt: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>>;
-export type ManagedScheduleStatus = z.infer<typeof ManagedScheduleStatusSchema>;
-export interface ManagedScheduleTimer {
-    cancel(): void;
-}
-/** Monotonic timer boundary. Tests can replace it without changing schedule semantics. */
-export interface ManagedScheduleClock {
-    /** Monotonic clock used for cadence and deadline arithmetic. */
-    now(): number;
-    /** Wall clock used only to project portable status timestamps. */
-    wallNow(): Date;
-    schedule(callback: () => void, delayMs: number): ManagedScheduleTimer;
-}
-export interface ManagedScheduleRunContext {
-    readonly applicationId: string;
-    readonly signal: AbortSignal;
-    readonly scheduledAt: number;
-    readonly startedAt: number;
-    now(): number;
-}
-export interface ManagedScheduleConfig {
-    readonly id: string;
-    readonly dependsOn?: readonly string[];
-    readonly required?: boolean;
-    readonly everyMs: number;
-    /** Defaults to one interval. A zero value schedules the first run after activation. */
-    readonly startAfterMs?: number;
-    readonly overlap?: ManagedScheduleOverlap;
-    readonly errorPolicy?: ManagedScheduleErrorPolicy;
-    readonly run: (context: ManagedScheduleRunContext) => void | Promise<void>;
-    readonly onError?: (error: unknown, context: ManagedScheduleRunContext) => void | Promise<void>;
-    readonly clock?: ManagedScheduleClock;
-}
-export interface ManagedSchedule extends ManagedResource {
-    readonly status: ManagedScheduleStatus;
-}
+import { type ManagedSchedule, type ManagedScheduleConfig } from './schedule-contract.js';
+/** Create one fixed-rate, process-local periodic application resource. */
 export declare function createManagedSchedule(config: ManagedScheduleConfig): ManagedSchedule;
 //# sourceMappingURL=schedule.d.ts.map

package/dist/application/schedule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/application/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAA0B,MAAM,YAAY,CAAC;AAa1E,eAAO,MAAM,4BAA4B;;;;;;;4BASvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,gCAAgC;;;EAAwC,CAAC;AACtF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;kBAQ/B,CAAC;AACd,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmB3B,CAAC;AACd,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,MAAM,WAAW,oBAAoB;IACnC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,GAAG,IAAI,MAAM,CAAC;IACd,kEAAkE;IAClE,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAAC;CACvE;AAWD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,GAAG,IAAI,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,0BAA0B,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,CACjB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,KAC/B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AA8ID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAuMpF"}
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/application/schedule.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,qBAAqB,EAK3B,MAAM,qBAAqB,CAAC;AAsB7B,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAoMpF"}

package/dist/entrypoints/application/opentelemetry.js

@@ -3,7 +3,7 @@ import"../../index-qaet40b2.js";
 import {
   ActivitySnapshotSchema2,
   ManagedScheduleStatusSchema2
-} from "../../index-n4689krb.js";
+} from "../../index-f24bdt13.js";
 import {
   ApplicationSnapshotSchema2
 } from "../../index-w5s3xftz.js";
@@ -103,6 +103,8 @@ var scheduleMetrics = [
   scheduleMetric("stitchkit.application.schedule.runs_started", "Absolute schedule runs started.", (value) => value.runsStarted),
   scheduleMetric("stitchkit.application.schedule.runs_completed", "Absolute schedule runs completed.", (value) => value.runsCompleted),
   scheduleMetric("stitchkit.application.schedule.runs_failed", "Absolute schedule runs failed.", (value) => value.runsFailed),
+  scheduleMetric("stitchkit.application.schedule.runs_woken", "Absolute schedule runs started by a wake request.", (value) => value.runsWoken),
+  scheduleMetric("stitchkit.application.schedule.wakes_coalesced", "Absolute wake requests folded into a run that was already pending.", (value) => value.wakesCoalesced),
   scheduleMetric("stitchkit.application.schedule.ticks_skipped", "Absolute schedule ticks skipped.", (value) => value.ticksSkipped)
 ];
 var activityMetric = (name, description, value) => ({

package/dist/entrypoints/application.d.ts

@@ -18,7 +18,8 @@ export { createProcessLifecycleLedger, type LifecycleLedgerResource, type Lifecy
 export { type DrainingFact, type LifecycleRun, LifecycleRunSchema, type LifecycleState, LifecycleStateSchema, type LifecycleTermination, LifecycleTerminationSchema, type LifecycleTransition, type PreviousExit, PreviousExitSchema, type ProcessLifecycleFact, type ReadyFact, type SameVersionOverlap, type ShutdownFact, type StartFact, type TransitionRunInput, type TransitionShutdownInput, type TransitionStartInput, transitionProcessDraining, transitionProcessReady, transitionProcessShutdown, transitionProcessStart, type VersionChangeOverlap, } from '../application/process-lifecycle-transitions.js';
 export { defineManagedResource, type ManagedResource, type ManagedResourceAdmission, type ManagedResourceContext, type ManagedResourceDependency, type ManagedResourcePublished, type ManagedResourcePublishesNoValue, type ManagedResourceStartResult, managedResourceDependencyId, } from '../application/resource.js';
 export { createRevisionSignal, type RevisionSignal, type RevisionSignalAdvanceResult, RevisionSignalAdvanceResultSchema, type RevisionSignalClock, type RevisionSignalConfig, type RevisionSignalSnapshot, RevisionSignalSnapshotSchema, type RevisionSignalState, RevisionSignalStateSchema, type RevisionSignalTimer, type RevisionSignalWaitOptions, type RevisionSignalWaitOutcome, RevisionSignalWaitOutcomeSchema, type RevisionSignalWaitResult, RevisionSignalWaitResultSchema, } from '../application/revision-signal.js';
-export { createManagedSchedule, type ManagedSchedule, type ManagedScheduleClock, type ManagedScheduleConfig, type ManagedScheduleDescriptor, ManagedScheduleDescriptorSchema, type ManagedScheduleErrorPolicy, ManagedScheduleErrorPolicySchema, type ManagedScheduleOverlap, ManagedScheduleOverlapSchema, type ManagedScheduleRunContext, type ManagedScheduleStatus, ManagedScheduleStatusSchema, type ManagedScheduleTimer, } from '../application/schedule.js';
+export { createManagedSchedule } from '../application/schedule.js';
+export { type ManagedSchedule, type ManagedScheduleClock, type ManagedScheduleConfig, type ManagedScheduleDescriptor, ManagedScheduleDescriptorSchema, type ManagedScheduleErrorPolicy, ManagedScheduleErrorPolicySchema, type ManagedScheduleOverlap, ManagedScheduleOverlapSchema, type ManagedScheduleRunContext, type ManagedScheduleStatus, ManagedScheduleStatusSchema, type ManagedScheduleTimer, type ManagedScheduleTrigger, } from '../application/schedule-contract.js';
 export { type ManagedServerResource, type ManagedServerResourceConfig, managedServerResource, } from '../application/server-resource.js';
 export type { StateStore, StateStoreUpdate, StateStoreUpdateContext, } from '../application/state-store.js';
 export { type AttachedWatcher, createWatchHub, type WatchAdmissionScope, type WatchHub, type WatchHubConfig, type WatchOperation, type WatchSubscriber, watchKey, } from '../application/watch-hub.js';

package/dist/entrypoints/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/entrypoints/application.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/entrypoints/application.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,mCAAmC,EACxC,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,4BAA4B,EAC5B,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,8BAA8B,EAC9B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,0BAA0B,GAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,sBAAsB,EACtB,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,KAAK,8BAA8B,EACnC,oCAAoC,EACpC,KAAK,qCAAqC,EAC1C,2CAA2C,EAC3C,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,uCAAuC,EACvC,KAAK,wBAAwB,EAC7B,8BAA8B,EAC9B,KAAK,2BAA2B,EAChC,8BAA8B,EAC9B,KAAK,qCAAqC,EAC1C,KAAK,+BAA+B,EACpC,qCAAqC,EACrC,KAAK,qCAAqC,EAC1C,2CAA2C,GAC5C,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,yBAAyB,GAC1B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,+BAA+B,EACpC,qCAAqC,EACrC,KAAK,8BAA8B,EACnC,KAAK,qCAAqC,EAC1C,2CAA2C,EAC3C,8BAA8B,EAC9B,oCAAoC,GACrC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,8BAA8B,EAC9B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,gCAAgC,GACjC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,2BAA2B,EAChC,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iCAAiC,EACtC,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,GAClC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,EAC/B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,8BAA8B,GAC/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,KAAK,eAAe,EACpB,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,QAAQ,GACT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvF,cAAc,uBAAuB,CAAC"}

package/dist/entrypoints/application.js

@@ -23,9 +23,8 @@ import {
   ManagedScheduleOverlapSchema2,
   ManagedScheduleErrorPolicySchema2,
   ManagedScheduleDescriptorSchema2,
-  ManagedScheduleStatusSchema2,
-  createManagedSchedule2
-} from "../index-n4689krb.js";
+  ManagedScheduleStatusSchema2
+} from "../index-f24bdt13.js";
 import {
   backoffDelay,
   createBackoff2
@@ -2094,6 +2093,310 @@ function createRevisionSignal(config) {
     getSnapshot: snapshot
   };
 }
+// src/application/schedule-run.ts
+var DEFAULT_OVERLAP = { mode: "skip" };
+function emptyCounts() {
+  return {
+    runsStarted: 0,
+    runsCompleted: 0,
+    runsFailed: 0,
+    runsWoken: 0,
+    ticksSkipped: 0,
+    wakesCoalesced: 0,
+    lastTrigger: null,
+    lastScheduledAt: null,
+    lastStartedAt: null,
+    lastFinishedAt: null
+  };
+}
+function describeSchedule(config) {
+  return ManagedScheduleDescriptorSchema2.parse({
+    id: config.id,
+    everyMs: config.everyMs,
+    startAfterMs: config.startAfterMs ?? config.everyMs,
+    overlap: config.overlap ?? DEFAULT_OVERLAP,
+    errorPolicy: config.errorPolicy ?? "continue"
+  });
+}
+function scheduleState(activated, stopped, accepting, active) {
+  if (!activated)
+    return stopped ? "stopped" : "inactive";
+  if (!accepting)
+    return active > 0 ? "draining" : "stopped";
+  return active > 0 ? "running" : "scheduled";
+}
+function wallAt(monotonicAt, anchor) {
+  if (monotonicAt === null)
+    return null;
+  return new Date(anchor.wallNow + monotonicAt - anchor.monotonicNow).toISOString();
+}
+function overlapDecision(overlap, active) {
+  if (overlap.mode === "skip")
+    return active > 0 ? "skip" : "start";
+  if (overlap.mode === "queue-one")
+    return active > 0 ? "queue" : "start";
+  return active >= overlap.maxConcurrent ? "skip" : "start";
+}
+function reportScheduleError(config, error, context) {
+  if (!config.onError)
+    return;
+  Promise.resolve().then(() => config.onError?.(error, context)).catch(() => {});
+}
+async function waitForSettled(active, clock, context, deadlineAt) {
+  if (active.size === 0 || context.signal.aborted)
+    return;
+  await new Promise((resolve) => {
+    let settled = false;
+    let deadlineTimer = null;
+    const finish = () => {
+      if (settled)
+        return;
+      settled = true;
+      deadlineTimer?.cancel();
+      context.signal.removeEventListener("abort", finish);
+      resolve();
+    };
+    context.signal.addEventListener("abort", finish, { once: true });
+    if (deadlineAt !== undefined) {
+      deadlineTimer = clock.schedule(finish, Math.max(0, deadlineAt - context.now()));
+    }
+    Promise.allSettled([...active]).then(finish);
+  });
+}
+async function executeRun(deps, scheduledAt, trigger) {
+  const { config, descriptor, clock, counts, resourceContext } = deps;
+  const startedAt = clock.now();
+  const wallStartedAt = clock.wallNow().getTime();
+  const runContext = {
+    applicationId: resourceContext.applicationId,
+    signal: resourceContext.signal,
+    scheduledAt,
+    startedAt,
+    trigger,
+    now: () => clock.now()
+  };
+  counts.runsStarted += 1;
+  if (trigger === "wake")
+    counts.runsWoken += 1;
+  counts.lastTrigger = trigger;
+  counts.lastScheduledAt = new Date(wallStartedAt + scheduledAt - startedAt).toISOString();
+  counts.lastStartedAt = new Date(wallStartedAt).toISOString();
+  deps.changed();
+  try {
+    await Promise.resolve();
+    await config.run(runContext);
+  } catch (error) {
+    counts.runsFailed += 1;
+    counts.lastFinishedAt = clock.wallNow().toISOString();
+    reportScheduleError(config, error, runContext);
+    if (descriptor.errorPolicy === "stop-schedule") {
+      resourceContext.reportHealth("unhealthy");
+      deps.stopAdmission();
+    } else {
+      resourceContext.reportHealth("degraded");
+    }
+    return;
+  }
+  counts.runsCompleted += 1;
+  counts.lastFinishedAt = clock.wallNow().toISOString();
+  if (descriptor.errorPolicy === "continue" && deps.isAccepting()) {
+    resourceContext.reportHealth("healthy");
+  }
+}
+function elapsedIntervals(scheduledAt, observedAt, everyMs) {
+  return Math.max(1, Math.floor((observedAt - scheduledAt) / everyMs) + 1);
+}
+
+// src/application/schedule.ts
+var systemClock2 = {
+  now: () => performance.now(),
+  wallNow: () => new Date,
+  schedule(callback, delayMs) {
+    const timer = setTimeout(callback, delayMs);
+    return { cancel: () => clearTimeout(timer) };
+  }
+};
+function createManagedSchedule(config) {
+  const descriptor = describeSchedule(config);
+  const dependsOn = config.dependsOn?.map((id) => ApplicationIdSchema2.parse(id));
+  const clock = config.clock ?? systemClock2;
+  let revision = 0;
+  let accepting = false;
+  let activated = false;
+  let stopped = false;
+  let timer = null;
+  let activationContext = null;
+  let nextRunAt = null;
+  let queued = null;
+  const counts = emptyCounts();
+  let changedAt = clock.wallNow().toISOString();
+  const active = new Set;
+  const changed = () => {
+    revision += 1;
+    changedAt = clock.wallNow().toISOString();
+  };
+  const cancelFuture = () => {
+    timer?.cancel();
+    timer = null;
+    nextRunAt = null;
+    queued = null;
+  };
+  const stopAdmission = () => {
+    if (!accepting && stopped)
+      return;
+    accepting = false;
+    stopped = true;
+    cancelFuture();
+    changed();
+  };
+  const status = () => {
+    const captured = clock.wallNow();
+    const anchor = { monotonicNow: clock.now(), wallNow: captured.getTime() };
+    return ManagedScheduleStatusSchema2.parse({
+      descriptor,
+      state: scheduleState(activated, stopped, accepting, active.size),
+      revision,
+      capturedAt: captured.toISOString(),
+      changedAt,
+      accepting,
+      active: active.size,
+      queued: queued !== null,
+      ...counts,
+      nextRunAt: wallAt(nextRunAt, anchor)
+    });
+  };
+  let startExecution = () => {
+    return;
+  };
+  const settleExecution = () => {
+    if (!accepting || queued === null)
+      return;
+    if (overlapDecision(descriptor.overlap, active.size) !== "start")
+      return;
+    const successor = queued;
+    queued = null;
+    changed();
+    startExecution(successor.at, successor.trigger);
+  };
+  startExecution = (scheduledAt, trigger) => {
+    const resourceContext = activationContext;
+    if (!accepting || !resourceContext)
+      return;
+    queued = null;
+    const tracked = executeRun({
+      config,
+      descriptor,
+      clock,
+      counts,
+      resourceContext,
+      changed,
+      stopAdmission,
+      isAccepting: () => accepting
+    }, scheduledAt, trigger).finally(() => {
+      active.delete(tracked);
+      changed();
+      settleExecution();
+    });
+    active.add(tracked);
+  };
+  const dispatchTick = (scheduledAt) => {
+    if (!accepting)
+      return;
+    const decision = overlapDecision(descriptor.overlap, active.size);
+    if (decision === "start") {
+      startExecution(scheduledAt, "timer");
+      return;
+    }
+    if (decision === "queue")
+      queued = { at: scheduledAt, trigger: queued?.trigger ?? "timer" };
+    else
+      counts.ticksSkipped += 1;
+    changed();
+  };
+  const wake = () => {
+    if (!accepting)
+      return;
+    if (queued) {
+      counts.wakesCoalesced += 1;
+      queued = { at: queued.at, trigger: "wake" };
+      changed();
+      return;
+    }
+    queued = { at: clock.now(), trigger: "wake" };
+    changed();
+    queueMicrotask(settleExecution);
+  };
+  const arm = () => {
+    if (!accepting || nextRunAt === null)
+      return;
+    const delayMs = Math.max(0, nextRunAt - clock.now());
+    timer = clock.schedule(() => {
+      timer = null;
+      if (!accepting || nextRunAt === null)
+        return;
+      const scheduledAt = nextRunAt;
+      const elapsed = elapsedIntervals(scheduledAt, clock.now(), descriptor.everyMs);
+      if (elapsed > 1) {
+        counts.ticksSkipped += elapsed - 1;
+        changed();
+      }
+      nextRunAt = scheduledAt + elapsed * descriptor.everyMs;
+      arm();
+      dispatchTick(scheduledAt);
+    }, delayMs);
+  };
+  const waitForActive = (context, deadlineAt) => waitForSettled(active, clock, context, deadlineAt);
+  const drain = async (context) => {
+    stopAdmission();
+    await waitForActive(context, context.deadlineAt);
+  };
+  return {
+    id: descriptor.id,
+    ...dependsOn && { dependsOn },
+    ...config.required !== undefined && { required: config.required },
+    get status() {
+      return status();
+    },
+    wake,
+    start() {
+      if (active.size > 0) {
+        throw new Error(`[stitchkit] schedule "${descriptor.id}" still has executions from its previous generation`);
+      }
+      cancelFuture();
+      stopped = false;
+      accepting = false;
+      activated = false;
+      activationContext = null;
+      queued = null;
+      changed();
+    },
+    activate(context) {
+      if (activated || stopped)
+        return;
+      activated = true;
+      accepting = true;
+      activationContext = context;
+      nextRunAt = clock.now() + descriptor.startAfterMs;
+      context.reportHealth("healthy");
+      changed();
+      arm();
+    },
+    stopAdmission() {
+      stopAdmission();
+    },
+    drain,
+    close() {
+      stopAdmission();
+    },
+    async force(context) {
+      stopAdmission();
+      await waitForActive(context, context.forceDeadlineAt);
+      if (active.size > 0) {
+        throw new Error(`[stitchkit] schedule "${descriptor.id}" still has active executions`);
+      }
+    }
+  };
+}
 // src/application/server-resource.ts
 function managedServerResource(config) {
   let shutdownPromise;
@@ -2636,7 +2939,7 @@ export {
   createCreditWindow2 as createCreditWindow,
   createDecisionPipeline,
   createDiagnosticJournalReadResultSchema2 as createDiagnosticJournalReadResultSchema,
-  createManagedSchedule2 as createManagedSchedule,
+  createManagedSchedule,
   createNotificationOutbox,
   createProcessLifecycleLedger,
   createRevisionSignal,

package/dist/{index-n4689krb.js → index-f24bdt13.js}

@@ -282,7 +282,7 @@ function createActivityProjection2(config) {
   };
 }
 
-// src/application/schedule.ts
+// src/application/schedule-contract.ts
 import { z as z3 } from "zod";
 var NonNegativeSafeIntegerSchema = z3.number().int().nonnegative().refine(Number.isSafeInteger, "Expected a safe integer");
 var PositiveSafeIntegerSchema = NonNegativeSafeIntegerSchema.refine((value) => value > 0, "Expected a positive integer");
@@ -295,6 +295,7 @@ var ManagedScheduleOverlapSchema2 = z3.discriminatedUnion("mode", [
   }).readonly()
 ]);
 var ManagedScheduleErrorPolicySchema2 = z3.enum(["continue", "stop-schedule"]);
+var ManagedScheduleTriggerSchema = z3.enum(["timer", "wake"]);
 var ManagedScheduleDescriptorSchema2 = z3.object({
   id: ApplicationIdSchema2,
   everyMs: PositiveSafeIntegerSchema,
@@ -314,282 +315,14 @@ var ManagedScheduleStatusSchema2 = z3.object({
   runsStarted: NonNegativeSafeIntegerSchema,
   runsCompleted: NonNegativeSafeIntegerSchema,
   runsFailed: NonNegativeSafeIntegerSchema,
+  runsWoken: NonNegativeSafeIntegerSchema,
   ticksSkipped: NonNegativeSafeIntegerSchema,
+  wakesCoalesced: NonNegativeSafeIntegerSchema,
+  lastTrigger: ManagedScheduleTriggerSchema.nullable(),
   nextRunAt: z3.string().datetime({ offset: true }).nullable(),
   lastScheduledAt: z3.string().datetime({ offset: true }).nullable(),
   lastStartedAt: z3.string().datetime({ offset: true }).nullable(),
   lastFinishedAt: z3.string().datetime({ offset: true }).nullable()
 }).readonly();
-var systemClock = {
-  now: () => performance.now(),
-  wallNow: () => new Date,
-  schedule(callback, delayMs) {
-    const timer = setTimeout(callback, delayMs);
-    return { cancel: () => clearTimeout(timer) };
-  }
-};
-var DEFAULT_OVERLAP = { mode: "skip" };
-function scheduleState(activated, stopped, accepting, active) {
-  if (!activated)
-    return stopped ? "stopped" : "inactive";
-  if (!accepting)
-    return active > 0 ? "draining" : "stopped";
-  return active > 0 ? "running" : "scheduled";
-}
-function wallAt(monotonicAt, anchor) {
-  if (monotonicAt === null)
-    return null;
-  return new Date(anchor.wallNow + monotonicAt - anchor.monotonicNow).toISOString();
-}
-function overlapDecision(overlap, active) {
-  if (overlap.mode === "skip")
-    return active > 0 ? "skip" : "start";
-  if (overlap.mode === "queue-one")
-    return active > 0 ? "queue" : "start";
-  return active >= overlap.maxConcurrent ? "skip" : "start";
-}
-function reportScheduleError(config, error, context) {
-  if (!config.onError)
-    return;
-  Promise.resolve().then(() => config.onError?.(error, context)).catch(() => {});
-}
-async function waitForSettled(active, clock, context, deadlineAt) {
-  if (active.size === 0 || context.signal.aborted)
-    return;
-  await new Promise((resolve) => {
-    let settled = false;
-    let deadlineTimer = null;
-    const finish = () => {
-      if (settled)
-        return;
-      settled = true;
-      deadlineTimer?.cancel();
-      context.signal.removeEventListener("abort", finish);
-      resolve();
-    };
-    context.signal.addEventListener("abort", finish, { once: true });
-    if (deadlineAt !== undefined) {
-      deadlineTimer = clock.schedule(finish, Math.max(0, deadlineAt - context.now()));
-    }
-    Promise.allSettled([...active]).then(finish);
-  });
-}
-async function executeRun(deps, scheduledAt) {
-  const { config, descriptor, clock, counts, resourceContext } = deps;
-  const startedAt = clock.now();
-  const wallStartedAt = clock.wallNow().getTime();
-  const runContext = {
-    applicationId: resourceContext.applicationId,
-    signal: resourceContext.signal,
-    scheduledAt,
-    startedAt,
-    now: () => clock.now()
-  };
-  counts.runsStarted += 1;
-  counts.lastScheduledAt = new Date(wallStartedAt + scheduledAt - startedAt).toISOString();
-  counts.lastStartedAt = new Date(wallStartedAt).toISOString();
-  deps.changed();
-  try {
-    await Promise.resolve();
-    await config.run(runContext);
-  } catch (error) {
-    counts.runsFailed += 1;
-    counts.lastFinishedAt = clock.wallNow().toISOString();
-    reportScheduleError(config, error, runContext);
-    if (descriptor.errorPolicy === "stop-schedule") {
-      resourceContext.reportHealth("unhealthy");
-      deps.stopAdmission();
-    } else {
-      resourceContext.reportHealth("degraded");
-    }
-    return;
-  }
-  counts.runsCompleted += 1;
-  counts.lastFinishedAt = clock.wallNow().toISOString();
-  if (descriptor.errorPolicy === "continue" && deps.isAccepting()) {
-    resourceContext.reportHealth("healthy");
-  }
-}
-function elapsedIntervals(scheduledAt, observedAt, everyMs) {
-  return Math.max(1, Math.floor((observedAt - scheduledAt) / everyMs) + 1);
-}
-function createManagedSchedule2(config) {
-  const descriptor = ManagedScheduleDescriptorSchema2.parse({
-    id: config.id,
-    everyMs: config.everyMs,
-    startAfterMs: config.startAfterMs ?? config.everyMs,
-    overlap: config.overlap ?? DEFAULT_OVERLAP,
-    errorPolicy: config.errorPolicy ?? "continue"
-  });
-  const dependsOn = config.dependsOn?.map((id) => ApplicationIdSchema2.parse(id));
-  const clock = config.clock ?? systemClock;
-  let revision = 0;
-  let accepting = false;
-  let activated = false;
-  let stopped = false;
-  let timer = null;
-  let activationContext = null;
-  let nextRunAt = null;
-  let queuedAt = null;
-  const counts = {
-    runsStarted: 0,
-    runsCompleted: 0,
-    runsFailed: 0,
-    ticksSkipped: 0,
-    lastScheduledAt: null,
-    lastStartedAt: null,
-    lastFinishedAt: null
-  };
-  let changedAt = clock.wallNow().toISOString();
-  const active = new Set;
-  const changed = () => {
-    revision += 1;
-    changedAt = clock.wallNow().toISOString();
-  };
-  const cancelFuture = () => {
-    timer?.cancel();
-    timer = null;
-    nextRunAt = null;
-    queuedAt = null;
-  };
-  const stopAdmission = () => {
-    if (!accepting && stopped)
-      return;
-    accepting = false;
-    stopped = true;
-    cancelFuture();
-    changed();
-  };
-  const status = () => {
-    const captured = clock.wallNow();
-    const anchor = { monotonicNow: clock.now(), wallNow: captured.getTime() };
-    return ManagedScheduleStatusSchema2.parse({
-      descriptor,
-      state: scheduleState(activated, stopped, accepting, active.size),
-      revision,
-      capturedAt: captured.toISOString(),
-      changedAt,
-      accepting,
-      active: active.size,
-      queued: queuedAt !== null,
-      ...counts,
-      nextRunAt: wallAt(nextRunAt, anchor)
-    });
-  };
-  let startExecution = () => {
-    return;
-  };
-  const settleExecution = () => {
-    if (!accepting || queuedAt === null || active.size !== 0)
-      return;
-    const successorAt = queuedAt;
-    queuedAt = null;
-    changed();
-    startExecution(successorAt);
-  };
-  startExecution = (scheduledAt) => {
-    const resourceContext = activationContext;
-    if (!accepting || !resourceContext)
-      return;
-    const tracked = executeRun({
-      config,
-      descriptor,
-      clock,
-      counts,
-      resourceContext,
-      changed,
-      stopAdmission,
-      isAccepting: () => accepting
-    }, scheduledAt).finally(() => {
-      active.delete(tracked);
-      changed();
-      settleExecution();
-    });
-    active.add(tracked);
-  };
-  const dispatchTick = (scheduledAt) => {
-    if (!accepting)
-      return;
-    const decision = overlapDecision(descriptor.overlap, active.size);
-    if (decision === "start") {
-      startExecution(scheduledAt);
-      return;
-    }
-    if (decision === "queue")
-      queuedAt = scheduledAt;
-    else
-      counts.ticksSkipped += 1;
-    changed();
-  };
-  const arm = () => {
-    if (!accepting || nextRunAt === null)
-      return;
-    const delayMs = Math.max(0, nextRunAt - clock.now());
-    timer = clock.schedule(() => {
-      timer = null;
-      if (!accepting || nextRunAt === null)
-        return;
-      const scheduledAt = nextRunAt;
-      const elapsed = elapsedIntervals(scheduledAt, clock.now(), descriptor.everyMs);
-      if (elapsed > 1) {
-        counts.ticksSkipped += elapsed - 1;
-        changed();
-      }
-      nextRunAt = scheduledAt + elapsed * descriptor.everyMs;
-      arm();
-      dispatchTick(scheduledAt);
-    }, delayMs);
-  };
-  const waitForActive = (context, deadlineAt) => waitForSettled(active, clock, context, deadlineAt);
-  const drain = async (context) => {
-    stopAdmission();
-    await waitForActive(context, context.deadlineAt);
-  };
-  return {
-    id: descriptor.id,
-    ...dependsOn && { dependsOn },
-    ...config.required !== undefined && { required: config.required },
-    get status() {
-      return status();
-    },
-    start() {
-      if (active.size > 0) {
-        throw new Error(`[stitchkit] schedule "${descriptor.id}" still has executions from its previous generation`);
-      }
-      cancelFuture();
-      stopped = false;
-      accepting = false;
-      activated = false;
-      activationContext = null;
-      queuedAt = null;
-      changed();
-    },
-    activate(context) {
-      if (activated || stopped)
-        return;
-      activated = true;
-      accepting = true;
-      activationContext = context;
-      nextRunAt = clock.now() + descriptor.startAfterMs;
-      context.reportHealth("healthy");
-      changed();
-      arm();
-    },
-    stopAdmission() {
-      stopAdmission();
-    },
-    drain,
-    close() {
-      stopAdmission();
-    },
-    async force(context) {
-      stopAdmission();
-      await waitForActive(context, context.forceDeadlineAt);
-      if (active.size > 0) {
-        throw new Error(`[stitchkit] schedule "${descriptor.id}" still has active executions`);
-      }
-    }
-  };
-}
 
-export { ApplicationSnapshotSinkStatusSchema2, createApplicationSnapshotSink2, ActivityIdSchema2, ActivityStageIdSchema2, ActivityStageSnapshotSchema2, ActivitySnapshotSchema2, ActivityLiveStateSchema2, ActivityTokenBrand2, createActivityProjection2, ManagedScheduleOverlapSchema2, ManagedScheduleErrorPolicySchema2, ManagedScheduleDescriptorSchema2, ManagedScheduleStatusSchema2, createManagedSchedule2 };
+export { ApplicationSnapshotSinkStatusSchema2, createApplicationSnapshotSink2, ActivityIdSchema2, ActivityStageIdSchema2, ActivityStageSnapshotSchema2, ActivitySnapshotSchema2, ActivityLiveStateSchema2, ActivityTokenBrand2, createActivityProjection2, ManagedScheduleOverlapSchema2, ManagedScheduleErrorPolicySchema2, ManagedScheduleDescriptorSchema2, ManagedScheduleStatusSchema2 };

package/llms/application.3.txt

@@ -160,9 +160,12 @@ delivery. Its filesystem reader is in the diagnostic-journal leaf; there is no m
 | `ManagedScheduleStatusSchema` / `ManagedScheduleStatus` | schema / _type_ | absolute schedule state, revision, counters and timestamps |
 
 Schedule authoring additionally exports `ManagedSchedule`, `ManagedScheduleConfig`,
-`ManagedScheduleRunContext`, `ManagedScheduleClock` and `ManagedScheduleTimer`.
+`ManagedScheduleRunContext`, `ManagedScheduleClock`, `ManagedScheduleTimer` and `ManagedScheduleTrigger`.
 The clock exposes monotonic cadence/deadline arithmetic and a wall-clock projection for portable
 status timestamps; it is a deterministic test boundary, not a durable scheduler.
+A `ManagedSchedule` also has `wake()`: the owner of the event that creates work asks for one run now,
+and the run follows the timer path (`overlap`, `errorPolicy`, `onError`, counters). Run context
+carries `trigger` (`'timer'` or `'wake'`); status adds `runsWoken`, `wakesCoalesced` and `lastTrigger`.
 
 ### Application and activity projection
 

package/llms/application.txt

@@ -349,7 +349,7 @@ Every instrument uses unit `1` and reports an absolute current/lifetime value:
 | `stitchkit.application.lifecycle`, `.ready` | current lifecycle/health fact and readiness |
 | `stitchkit.application.admission.accepting`, `.accepted`, `.completed`, `.pending` | current gate and absolute lifetime admission counts |
 | `stitchkit.application.resource.ready` | readiness for each declared resource with required/state/health attributes |
-| `stitchkit.application.schedule.accepting`, `.active`, `.queued`, `.runs_started`, `.runs_completed`, `.runs_failed`, `.ticks_skipped` | current schedule state and absolute run/tick counts |
+| `stitchkit.application.schedule.accepting`, `.active`, `.queued`, `.runs_started`, `.runs_completed`, `.runs_failed`, `.runs_woken`, `.wakes_coalesced`, `.ticks_skipped` | current schedule state and absolute run, wake and tick counts |
 | `stitchkit.application.activity.active`, `.queued`, `.completed`, `.failed` | absolute stage projections for declared activity sources |
 
 ## Replacing part of the graph without stopping the process
@@ -783,6 +783,35 @@ those semantics in a durable application scheduler when they are required.
 Schedule cadence stays monotonic, while status snapshots expose ISO wall-clock
 `capturedAt`, `changedAt` and next/last-run timestamps for portable observation.
 
+### Wake a schedule when work appears
+
+An owner that knows the moment work arrives keeps a long period as the check for a lost event and
+calls `wake()` from the place that enqueues:
+
+```ts
+const drain = createManagedSchedule({
+  id: 'drain-queue',
+  everyMs: 60_000,
+  run: ({ trigger, signal }) => drainQueue(signal, trigger),
+})
+
+function enqueue(job: Job) {
+  queue.push(job)
+  drain.wake()
+}
+```
+
+- `wake()` asks for one run now and takes the timer's path: `dependsOn`, `overlap`, `errorPolicy`,
+  `onError`, the shutdown signal and the counters all apply.
+- Calls made in one tick, or while a run holds every slot, collapse into one following run, under
+  every overlap policy (a wake is an event, so `skip` defers it instead of dropping it).
+- Before the schedule is activated (its dependencies are not ready) and after it stops accepting
+  (shutdown, `stop-schedule`), `wake()` does nothing and is not remembered.
+- The period keeps its own fixed-rate grid and is not moved by a wake, so it stays a single timer
+  chain and never becomes a second queue.
+- `run` receives `trigger` (`'timer'` or `'wake'`); status reports `runsWoken`, `wakesCoalesced` and
+  `lastTrigger`.
+
 ## Operational projection
 
 Declare aggregate activity stages, then update them with anonymous handles:

package/llms-full.txt

@@ -7228,7 +7228,7 @@ Every instrument uses unit `1` and reports an absolute current/lifetime value:
 | `stitchkit.application.lifecycle`, `.ready` | current lifecycle/health fact and readiness |
 | `stitchkit.application.admission.accepting`, `.accepted`, `.completed`, `.pending` | current gate and absolute lifetime admission counts |
 | `stitchkit.application.resource.ready` | readiness for each declared resource with required/state/health attributes |
-| `stitchkit.application.schedule.accepting`, `.active`, `.queued`, `.runs_started`, `.runs_completed`, `.runs_failed`, `.ticks_skipped` | current schedule state and absolute run/tick counts |
+| `stitchkit.application.schedule.accepting`, `.active`, `.queued`, `.runs_started`, `.runs_completed`, `.runs_failed`, `.runs_woken`, `.wakes_coalesced`, `.ticks_skipped` | current schedule state and absolute run, wake and tick counts |
 | `stitchkit.application.activity.active`, `.queued`, `.completed`, `.failed` | absolute stage projections for declared activity sources |
 
 ## Replacing part of the graph without stopping the process
@@ -7662,6 +7662,35 @@ those semantics in a durable application scheduler when they are required.
 Schedule cadence stays monotonic, while status snapshots expose ISO wall-clock
 `capturedAt`, `changedAt` and next/last-run timestamps for portable observation.
 
+### Wake a schedule when work appears
+
+An owner that knows the moment work arrives keeps a long period as the check for a lost event and
+calls `wake()` from the place that enqueues:
+
+```ts
+const drain = createManagedSchedule({
+  id: 'drain-queue',
+  everyMs: 60_000,
+  run: ({ trigger, signal }) => drainQueue(signal, trigger),
+})
+
+function enqueue(job: Job) {
+  queue.push(job)
+  drain.wake()
+}
+```
+
+- `wake()` asks for one run now and takes the timer's path: `dependsOn`, `overlap`, `errorPolicy`,
+  `onError`, the shutdown signal and the counters all apply.
+- Calls made in one tick, or while a run holds every slot, collapse into one following run, under
+  every overlap policy (a wake is an event, so `skip` defers it instead of dropping it).
+- Before the schedule is activated (its dependencies are not ready) and after it stops accepting
+  (shutdown, `stop-schedule`), `wake()` does nothing and is not remembered.
+- The period keeps its own fixed-rate grid and is not moved by a wake, so it stays a single timer
+  chain and never becomes a second queue.
+- `run` receives `trigger` (`'timer'` or `'wake'`); status reports `runsWoken`, `wakesCoalesced` and
+  `lastTrigger`.
+
 ## Operational projection
 
 Declare aggregate activity stages, then update them with anonymous handles:
@@ -21430,9 +21459,12 @@ delivery. Its filesystem reader is in the diagnostic-journal leaf; there is no m
 | `ManagedScheduleStatusSchema` / `ManagedScheduleStatus` | schema / _type_ | absolute schedule state, revision, counters and timestamps |
 
 Schedule authoring additionally exports `ManagedSchedule`, `ManagedScheduleConfig`,
-`ManagedScheduleRunContext`, `ManagedScheduleClock` and `ManagedScheduleTimer`.
+`ManagedScheduleRunContext`, `ManagedScheduleClock`, `ManagedScheduleTimer` and `ManagedScheduleTrigger`.
 The clock exposes monotonic cadence/deadline arithmetic and a wall-clock projection for portable
 status timestamps; it is a deterministic test boundary, not a durable scheduler.
+A `ManagedSchedule` also has `wake()`: the owner of the event that creates work asks for one run now,
+and the run follows the timer path (`overlap`, `errorPolicy`, `onError`, counters). Run context
+carries `trigger` (`'timer'` or `'wake'`); status adds `runsWoken`, `wakesCoalesced` and `lastTrigger`.
 
 ### Application and activity projection
 

package/llms.txt

@@ -33,7 +33,7 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/agent-runtime/openrouter**: [llms/agent-runtime-openrouter.txt](llms/agent-runtime-openrouter.txt) 1.1 KB
 - **stitchkit/agent-runtime/sqlite/bun**: [llms/agent-runtime-sqlite-bun.txt](llms/agent-runtime-sqlite-bun.txt) 1.8 KB
 - **stitchkit/agent-runtime/sqlite/node**: [llms/agent-runtime-sqlite-node.txt](llms/agent-runtime-sqlite-node.txt) 1.7 KB
-- **stitchkit/application**: [llms/application.txt](llms/application.txt) 39.6 KB → [llms/application.2.txt](llms/application.2.txt) 30.7 KB → [llms/application.3.txt](llms/application.3.txt) 29.0 KB
+- **stitchkit/application**: [llms/application.txt](llms/application.txt) 40.8 KB → [llms/application.2.txt](llms/application.2.txt) 30.7 KB → [llms/application.3.txt](llms/application.3.txt) 29.4 KB
 - **stitchkit/application/grammy**: [llms/application-grammy.txt](llms/application-grammy.txt) 2.3 KB
 - **stitchkit/application/opentelemetry**: [llms/application-opentelemetry.txt](llms/application-opentelemetry.txt) 1.6 KB
 - **stitchkit/application/directory-inbox**: [llms/application-directory-inbox.txt](llms/application-directory-inbox.txt) 0.3 KB

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.109.1",
+  "version": "0.109.3",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",