@stigmer/server 3.14.0-dev.20260910084630

package/dist/temporal/schedule/activities.js

@@ -0,0 +1,350 @@
+/**
+ * The tick workflow's activity surface — ports
+ * pkg/domain/schedule/temporal/tick_activities.go. Nominal fire times
+ * cross the boundary as RFC-3339 UTC strings so the payload never depends
+ * on the data converter's time handling — the same wire shape the cloud
+ * tick uses.
+ *
+ * Registered by the schedule worker under the pinned slash names
+ * (names.ts); the retry postures live with the CALLER (workflows/tick.ts's
+ * three activity-option contexts), most critically record-failure's
+ * single attempt — the streak increment is the clock's one non-idempotent
+ * write.
+ */
+import { timestampFromDate } from "@bufbuild/protobuf/wkt";
+import { AgentExecutionSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ScheduleSchema } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { ResourceNotFoundError } from "../../store/interface.js";
+import { FAILURE_RUN_FAILED, FAILURE_RUN_TIMED_OUT, FAILURE_START_FAILED, PHASE_CANCELLED, PHASE_COMPLETED, PHASE_FAILED, PHASE_GONE, PHASE_RUNNING, PHASE_TERMINATED, RECORD_FAILED_RUN_ACTIVITY_NAME, RECORD_SUCCESSFUL_RUN_ACTIVITY_NAME, RECORD_TICK_ACTIVITY_NAME, POLL_EXECUTION_PHASE_ACTIVITY_NAME, RUN_ALREADY_STARTED, RUN_REFUSED, RUN_SKIPPED, RUN_STARTED, RUN_TARGET_MISSING, START_SCHEDULED_RUN_ACTIVITY_NAME, TICK_FIRED, TICK_SKIPPED_AUTO_PAUSED, TICK_SKIPPED_DELETED, TICK_SKIPPED_DISABLED, } from "./names.js";
+import { RUN_LEDGER_ORIGIN_CRON, RUN_LEDGER_OUTCOME_COMPLETED, RUN_LEDGER_OUTCOME_FAILED, RUN_LEDGER_OUTCOME_TIMED_OUT, recordRunLedgerStart, recordRunLedgerVerdict, } from "./run-ledger.js";
+import { bumpStatusAudit, ensureStatus } from "./status-writes.js";
+/** Wires the activity implementations (Go NewTickActivities). */
+export function createScheduleTickActivities(deps) {
+    return {
+        [RECORD_TICK_ACTIVITY_NAME]: (scheduleResourceId, nominalFireTimeRfc3339) => recordTick(deps, scheduleResourceId, nominalFireTimeRfc3339),
+        [START_SCHEDULED_RUN_ACTIVITY_NAME]: (scheduleResourceId, nominalFireTimeRfc3339) => startScheduledRun(deps, scheduleResourceId, nominalFireTimeRfc3339),
+        [POLL_EXECUTION_PHASE_ACTIVITY_NAME]: (executionId) => pollExecutionPhase(deps, executionId),
+        [RECORD_SUCCESSFUL_RUN_ACTIVITY_NAME]: (scheduleResourceId) => recordSuccessfulRun(deps, scheduleResourceId),
+        [RECORD_FAILED_RUN_ACTIVITY_NAME]: (scheduleResourceId, reason, kind) => recordFailedRun(deps, scheduleResourceId, reason, kind),
+    };
+}
+/**
+ * Re-reads the schedule row and either records the fire or explains why
+ * this tick is a no-op — the revalidation that makes every orphaned
+ * artifact harmless by construction (DD-008 D2): deleted, owner-disabled,
+ * and platform-paused rows all decline the fire (Go RecordTick).
+ */
+async function recordTick(deps, scheduleResourceId, nominalFireTimeRfc3339) {
+    let schedule;
+    try {
+        schedule = await deps.store.getResource(ApiResourceKind.schedule, scheduleResourceId, ScheduleSchema);
+    }
+    catch (error) {
+        if (error instanceof ResourceNotFoundError) {
+            deps.logger.info("Schedule tick no-op — row deleted (orphaned artifact; the reconciliation pass removes it)", { schedule_id: scheduleResourceId });
+            return TICK_SKIPPED_DELETED;
+        }
+        throw new Error(`load schedule ${scheduleResourceId}: ${message(error)}`, {
+            cause: error,
+        });
+    }
+    if (!(schedule.spec?.enabled ?? false)) {
+        deps.logger.info("Schedule tick no-op — owner-disabled", {
+            schedule_id: scheduleResourceId,
+        });
+        return TICK_SKIPPED_DISABLED;
+    }
+    const pausedReason = schedule.status?.pausedReason ?? "";
+    if (pausedReason !== "") {
+        deps.logger.info("Schedule tick no-op — platform-paused", {
+            schedule_id: scheduleResourceId,
+            reason: pausedReason,
+        });
+        return TICK_SKIPPED_AUTO_PAUSED;
+    }
+    await recordFire(deps, schedule, nominalFireTimeRfc3339);
+    return TICK_FIRED;
+}
+/**
+ * Stamps the fire on status: last_fire_at = the NOMINAL time (identical on
+ * activity retry — idempotent by construction), plus a best-effort
+ * next_fire_at refresh from the live artifact. The refresh failing must
+ * never block recording the fire that already happened (Go recordFire).
+ */
+async function recordFire(deps, schedule, nominalFireTimeRfc3339) {
+    const nominal = parseRfc3339(nominalFireTimeRfc3339);
+    let nextFireAt;
+    let peekFailed = false;
+    try {
+        nextFireAt = await deps.syncer.peekNextFireAt(schedule);
+    }
+    catch (error) {
+        peekFailed = true;
+        deps.logger.warn("Could not refresh next_fire_at during tick (recording the fire without it)", {
+            schedule_id: schedule.metadata?.id ?? "",
+            error: message(error),
+        });
+    }
+    try {
+        await deps.store.updateResource(ApiResourceKind.schedule, schedule.metadata?.id ?? "", ScheduleSchema, (live) => {
+            const status = ensureStatus(live);
+            status.lastFireAt = timestampFromDate(nominal);
+            if (!peekFailed) {
+                status.nextFireAt =
+                    nextFireAt === undefined ? undefined : timestampFromDate(nextFireAt);
+            }
+            bumpStatusAudit(status);
+        });
+    }
+    catch (error) {
+        if (error instanceof ResourceNotFoundError) {
+            // Deleted between revalidation and the write: nothing to record.
+            return;
+        }
+        throw new Error(`record schedule fire on status: ${message(error)}`, {
+            cause: error,
+        });
+    }
+    deps.logger.info("Schedule fire recorded", {
+        schedule_id: schedule.metadata?.id ?? "",
+        nominal_fire_time: nominalFireTimeRfc3339,
+    });
+}
+/**
+ * Re-validates and starts this fire's run. The revalidation repeats
+ * recordTick's checks collapsed into one SKIPPED outcome — the row may
+ * have changed between the two activities, and a fire that recorded must
+ * still decline to run against a row that no longer wants it (Go
+ * StartScheduledRun).
+ */
+async function startScheduledRun(deps, scheduleResourceId, nominalFireTimeRfc3339) {
+    const trackingBudget = deps.config.resolvedRunTrackingTimeoutMinutes();
+    let schedule;
+    try {
+        schedule = await deps.store.getResource(ApiResourceKind.schedule, scheduleResourceId, ScheduleSchema);
+    }
+    catch (error) {
+        if (!(error instanceof ResourceNotFoundError)) {
+            throw new Error(`load schedule ${scheduleResourceId}: ${message(error)}`, { cause: error });
+        }
+        schedule = undefined;
+    }
+    if (schedule === undefined ||
+        !(schedule.spec?.enabled ?? false) ||
+        (schedule.status?.pausedReason ?? "") !== "") {
+        deps.logger.info("Schedule run start no-op — row deleted/disabled/paused between record and start", { schedule_id: scheduleResourceId });
+        const skipped = {
+            outcome: RUN_SKIPPED,
+            executionId: "",
+            trackingTimeoutMinutes: trackingBudget,
+            failureReason: "",
+        };
+        // The deleted-row skip deliberately leaves NO ledger row: the delete
+        // already cascaded the schedule's history, and a bookkeeping write here
+        // would resurrect it.
+        if (schedule !== undefined) {
+            await recordRunLedgerStart(deps.store, deps.logger, scheduleResourceId, schedule.metadata?.org ?? "", nominalFireTimeRfc3339, RUN_LEDGER_ORIGIN_CRON, skipped);
+        }
+        return skipped;
+    }
+    const nominal = parseRfc3339(nominalFireTimeRfc3339);
+    // Infrastructure failures throw: the activity retries, and the
+    // deterministic execution name absorbs the retry.
+    const outcome = await deps.runStarter.startRun(schedule, nominal);
+    const result = {
+        outcome: RUN_STARTED,
+        executionId: "",
+        trackingTimeoutMinutes: trackingBudget,
+        failureReason: "",
+    };
+    switch (outcome.kind) {
+        case "started":
+            result.outcome = outcome.alreadyExisted ? RUN_ALREADY_STARTED : RUN_STARTED;
+            result.executionId = outcome.executionId;
+            deps.logger.info("Schedule fire started its run", {
+                schedule_id: scheduleResourceId,
+                execution_id: outcome.executionId,
+                already_existed: outcome.alreadyExisted,
+            });
+            break;
+        case "targetMissing":
+            result.outcome = RUN_TARGET_MISSING;
+            result.failureReason = outcome.reason;
+            break;
+        case "refused":
+            result.outcome = RUN_REFUSED;
+            result.failureReason = `run refused: ${outcome.reason}`;
+            break;
+        default: {
+            const exhaustive = outcome;
+            throw new Error(`unknown run outcome ${String(exhaustive)}`);
+        }
+    }
+    // The fire ledger (DD-017 D-7): start failures are terminal at insert —
+    // the refusal reason must survive NOW, not at the pause threshold.
+    await recordRunLedgerStart(deps.store, deps.logger, scheduleResourceId, schedule.metadata?.org ?? "", nominalFireTimeRfc3339, RUN_LEDGER_ORIGIN_CRON, result);
+    return result;
+}
+/**
+ * Classifies the tracked run's current phase from one row read. GONE (row
+ * deleted mid-track) is distinct from RUNNING: a deleted run must not
+ * brick its schedule, so it yields no verdict.
+ *
+ * The read unmarshals the whole execution row — SQLite stores one protobuf
+ * blob with no projection (DD-015 D-E). At one poll per 5-60s per active
+ * run on a single-user daemon that is noise; a projected phase column is
+ * the named follow-up if it ever isn't (Go PollExecutionPhase).
+ */
+async function pollExecutionPhase(deps, executionId) {
+    let phase;
+    try {
+        const execution = await deps.store.getResource(ApiResourceKind.agent_execution, executionId, AgentExecutionSchema);
+        phase = execution.status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+    }
+    catch (error) {
+        if (error instanceof ResourceNotFoundError) {
+            return PHASE_GONE;
+        }
+        throw new Error(`load execution ${executionId}: ${message(error)}`, {
+            cause: error,
+        });
+    }
+    switch (phase) {
+        case ExecutionPhase.EXECUTION_COMPLETED:
+            return PHASE_COMPLETED;
+        case ExecutionPhase.EXECUTION_CANCELLED:
+            return PHASE_CANCELLED;
+        case ExecutionPhase.EXECUTION_TERMINATED:
+            return PHASE_TERMINATED;
+        case ExecutionPhase.EXECUTION_FAILED:
+            return PHASE_FAILED;
+        default:
+            // PENDING, IN_PROGRESS, WAITING_FOR_APPROVAL, PAUSED, and any future
+            // non-terminal phase: still running.
+            return PHASE_RUNNING;
+    }
+}
+/**
+ * Resets the failure streak to its absorbing zero. Idempotent — the caller
+ * retries freely: a LOST reset strands a stale streak that pauses a
+ * healthy schedule later, so this write must land (Go RecordSuccessfulRun).
+ */
+async function recordSuccessfulRun(deps, scheduleResourceId) {
+    try {
+        await deps.store.updateResource(ApiResourceKind.schedule, scheduleResourceId, ScheduleSchema, (live) => {
+            const status = ensureStatus(live);
+            status.consecutiveFailures = 0;
+            bumpStatusAudit(status);
+        });
+    }
+    catch (error) {
+        if (error instanceof ResourceNotFoundError) {
+            return; // deleted mid-track: nothing to reset
+        }
+        throw new Error(`reset failure streak on schedule ${scheduleResourceId}: ${message(error)}`, { cause: error });
+    }
+    await recordRunLedgerVerdict(deps.store, deps.logger, scheduleResourceId, RUN_LEDGER_OUTCOME_COMPLETED, "");
+    deps.logger.info("Schedule run completed — failure streak reset", {
+        schedule_id: scheduleResourceId,
+    });
+}
+/**
+ * Increments the failure streak and, exactly at the threshold crossing,
+ * latches the platform pause. The whole verdict is ONE updateResource
+ * closure on the freshly-read row — the OSS shape of the cloud's single
+ * guarded SQL statement (DD-015 D-C): the increment reads the live value
+ * inside the lock, the pause is written only at the crossing and only when
+ * no reason is already latched (the first pause's copy is never
+ * rewritten), and next_fire_at clears so the schedule advertises no fire
+ * it will decline.
+ *
+ * The caller gives this activity EXACTLY ONE attempt: an increment is not
+ * idempotent — a retry after a successful write over-counts and pauses a
+ * healthy schedule early, while a lost write under-counts and fails safe
+ * (Go RecordFailedRun).
+ */
+async function recordFailedRun(deps, scheduleResourceId, reason, kind) {
+    const threshold = deps.config.resolvedMaxConsecutiveFailures();
+    const pausedReason = `Paused after ${threshold} consecutive failed runs. Last failure: ${reason}`;
+    let recorded = { consecutiveFailures: 0, paused: false };
+    let crossedThreshold = false;
+    try {
+        await deps.store.updateResource(ApiResourceKind.schedule, scheduleResourceId, ScheduleSchema, (live) => {
+            const status = ensureStatus(live);
+            status.consecutiveFailures++;
+            if (status.consecutiveFailures >= threshold && status.pausedReason === "") {
+                status.pausedReason = pausedReason;
+                crossedThreshold = true;
+            }
+            if (status.consecutiveFailures >= threshold) {
+                status.nextFireAt = undefined;
+            }
+            bumpStatusAudit(status);
+            recorded = {
+                consecutiveFailures: status.consecutiveFailures,
+                paused: status.pausedReason !== "",
+            };
+        });
+    }
+    catch (error) {
+        if (error instanceof ResourceNotFoundError) {
+            // Deleted mid-track: a no-op by construction — deleting a run or its
+            // schedule must never resurrect either.
+            deps.logger.info("Schedule run failure not recorded — row deleted mid-track", { schedule_id: scheduleResourceId, reason });
+            return { consecutiveFailures: 0, paused: false };
+        }
+        throw new Error(`record failed run on schedule ${scheduleResourceId}: ${message(error)}`, { cause: error });
+    }
+    deps.logger.warn("Schedule run failed", {
+        failure_kind: kind,
+        schedule_id: scheduleResourceId,
+        consecutive_failures: recorded.consecutiveFailures,
+        threshold,
+        paused: recorded.paused,
+        reason,
+    });
+    // The fire ledger's terminal verdict. START_FAILED rows were already
+    // written terminal by the start activity — only tracked-run verdicts
+    // mark here.
+    switch (kind) {
+        case FAILURE_RUN_FAILED:
+            await recordRunLedgerVerdict(deps.store, deps.logger, scheduleResourceId, RUN_LEDGER_OUTCOME_FAILED, reason);
+            break;
+        case FAILURE_RUN_TIMED_OUT:
+            await recordRunLedgerVerdict(deps.store, deps.logger, scheduleResourceId, RUN_LEDGER_OUTCOME_TIMED_OUT, reason);
+            break;
+        case FAILURE_START_FAILED:
+            // Terminal at insert (recordRunLedgerStart) — nothing to mark.
+            break;
+        default: {
+            const exhaustive = kind;
+            throw new Error(`unknown failure kind ${String(exhaustive)}`);
+        }
+    }
+    if (crossedThreshold) {
+        // Best-effort immediate artifact re-sync so the pause reaches Temporal
+        // now; the reconciliation pass is the correctness path.
+        try {
+            const schedule = await deps.store.getResource(ApiResourceKind.schedule, scheduleResourceId, ScheduleSchema);
+            await deps.syncer.ensureAndRecord(schedule);
+        }
+        catch (error) {
+            deps.logger.error("Paused schedule's artifact not yet converged (the reconciliation pass will pause it)", { schedule_id: scheduleResourceId, error: message(error) });
+        }
+    }
+    return recorded;
+}
+/** Go time.Parse(time.RFC3339) — an unparseable nominal time fails the activity. */
+function parseRfc3339(value) {
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime())) {
+        throw new Error(`parse nominal fire time "${value}": invalid RFC-3339`);
+    }
+    return parsed;
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=activities.js.map

package/dist/temporal/schedule/activities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activities.js","sourceRoot":"","sources":["../../../src/temporal/schedule/activities.ts"],"names":[],"mappings":"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"}

package/dist/temporal/schedule/artifact.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The ONE resource-to-Temporal mapping — ports
+ * pkg/domain/schedule/temporal/artifact.go (the cloud ScheduleArtifact's
+ * twin). Whatever this writes is final for every artifact it creates,
+ * because the baked action is invisible to Temporal's schedule listing and
+ * cannot be repaired by the reconciliation sweep.
+ *
+ * Pinned policy, identical to cloud (Go CreateOptions):
+ *   - Overlap SKIP is explicit: since a tick SPANS its run (tracking),
+ *     SKIP genuinely means "never start a run while the last is active".
+ *   - PauseOnFailure stays false: Temporal must never pause behind the
+ *     platform's back, or the artifact would oscillate against the
+ *     reconciliation pass (which converges paused-state from the row).
+ *   - The action carries exactly ONE argument — the schedule resource id.
+ *     The nominal fire time cannot ride here (Temporal bakes action args
+ *     once and replays them verbatim per fire); the tick derives it from
+ *     the fire itself.
+ */
+import { type ScheduleDescription, type ScheduleOptions, type ScheduleUpdateOptions, type ScheduleOptionsStartWorkflowAction } from "@temporalio/client";
+import type { Workflow } from "@temporalio/common";
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+import type { ScheduleTemporalConfig } from "./config.js";
+/**
+ * The drift fingerprint written into the artifact's state note. Cron
+ * itself does NOT round-trip (the Temporal server compiles it into
+ * calendar specs and describes cronExpressions as empty), so the note is
+ * the only way the reconciliation pass can detect a spec change (Go Note).
+ */
+export declare function note(schedule: Schedule): string;
+/**
+ * The artifact must be paused when the owner disabled the schedule
+ * (spec.enabled=false) OR the platform latched it (status.paused_reason) —
+ * two levers, one artifact state (Go DesiredPaused).
+ */
+export declare function desiredPaused(schedule: Schedule): boolean;
+export declare class ScheduleArtifact {
+    private readonly config;
+    constructor(config: ScheduleTemporalConfig);
+    /** Builds the complete desired artifact for create (Go CreateOptions). */
+    createOptions(schedule: Schedule): ScheduleOptions;
+    /**
+     * Rewrites a described artifact to the resource's complete desired
+     * state — the update half of ensure's create-or-update (Go
+     * ApplyDesiredState). A lost race between two writers is benign: both
+     * write the same desired state.
+     *
+     * The ACTION is deliberately rewritten too, even though drift detection
+     * cannot see it (invisible to describe-level diffing): on the update
+     * path rewriting it is free and self-heals a hand-edited artifact.
+     */
+    applyDesiredState(previous: ScheduleDescription, schedule: Schedule): ScheduleUpdateOptions<ScheduleOptionsStartWorkflowAction<Workflow>>;
+    /**
+     * Bakes the tick workflow start: workflow id = artifact id (Temporal
+     * appends the nominal fire time per fire — the tick's second-tier
+     * nominal-time derivation), the schedule's own queue, and the 24h
+     * run-timeout backstop. Retry deliberately stays at the workflow default
+     * (none): a failed tick is a missed fire, not a hot loop (Go tickAction).
+     */
+    private tickAction;
+}
+//# sourceMappingURL=artifact.d.ts.map

package/dist/temporal/schedule/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../src/temporal/schedule/artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAEpB,KAAK,qBAAqB,EAC1B,KAAK,kCAAkC,EACxC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAEtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAG1D;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAUD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,sBAAsB;IAE3D,0EAA0E;IAC1E,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe;IAqBlD;;;;;;;;;OASG;IACH,iBAAiB,CACf,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,QAAQ,GACjB,qBAAqB,CAAC,kCAAkC,CAAC,QAAQ,CAAC,CAAC;IAqBtE;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;CAUnB"}

package/dist/temporal/schedule/artifact.js

@@ -0,0 +1,119 @@
+/**
+ * The ONE resource-to-Temporal mapping — ports
+ * pkg/domain/schedule/temporal/artifact.go (the cloud ScheduleArtifact's
+ * twin). Whatever this writes is final for every artifact it creates,
+ * because the baked action is invisible to Temporal's schedule listing and
+ * cannot be repaired by the reconciliation sweep.
+ *
+ * Pinned policy, identical to cloud (Go CreateOptions):
+ *   - Overlap SKIP is explicit: since a tick SPANS its run (tracking),
+ *     SKIP genuinely means "never start a run while the last is active".
+ *   - PauseOnFailure stays false: Temporal must never pause behind the
+ *     platform's back, or the artifact would oscillate against the
+ *     reconciliation pass (which converges paused-state from the row).
+ *   - The action carries exactly ONE argument — the schedule resource id.
+ *     The nominal fire time cannot ride here (Temporal bakes action args
+ *     once and replays them verbatim per fire); the tick derives it from
+ *     the fire itself.
+ */
+import { ScheduleOverlapPolicy, } from "@temporalio/client";
+import { TICK_WORKFLOW_TYPE, artifactId } from "./names.js";
+/**
+ * The drift fingerprint written into the artifact's state note. Cron
+ * itself does NOT round-trip (the Temporal server compiles it into
+ * calendar specs and describes cronExpressions as empty), so the note is
+ * the only way the reconciliation pass can detect a spec change (Go Note).
+ */
+export function note(schedule) {
+    return `cron=${specOf(schedule).cron} tz=${specOf(schedule).timeZone}`;
+}
+/**
+ * The artifact must be paused when the owner disabled the schedule
+ * (spec.enabled=false) OR the platform latched it (status.paused_reason) —
+ * two levers, one artifact state (Go DesiredPaused).
+ */
+export function desiredPaused(schedule) {
+    return !specOf(schedule).enabled || (schedule.status?.pausedReason ?? "") !== "";
+}
+function specOf(schedule) {
+    return {
+        cron: schedule.spec?.cron ?? "",
+        timeZone: schedule.spec?.timeZone ?? "",
+        enabled: schedule.spec?.enabled ?? false,
+    };
+}
+export class ScheduleArtifact {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Builds the complete desired artifact for create (Go CreateOptions). */
+    createOptions(schedule) {
+        const resourceId = schedule.metadata?.id ?? "";
+        return {
+            scheduleId: artifactId(resourceId),
+            spec: {
+                cronExpressions: [specOf(schedule).cron],
+                timezone: specOf(schedule).timeZone,
+            },
+            action: this.tickAction(resourceId),
+            policies: {
+                overlap: ScheduleOverlapPolicy.SKIP,
+                catchupWindow: this.config.catchupWindowMinutes * 60_000,
+                pauseOnFailure: false,
+            },
+            state: {
+                paused: desiredPaused(schedule),
+                note: note(schedule),
+            },
+        };
+    }
+    /**
+     * Rewrites a described artifact to the resource's complete desired
+     * state — the update half of ensure's create-or-update (Go
+     * ApplyDesiredState). A lost race between two writers is benign: both
+     * write the same desired state.
+     *
+     * The ACTION is deliberately rewritten too, even though drift detection
+     * cannot see it (invisible to describe-level diffing): on the update
+     * path rewriting it is free and self-heals a hand-edited artifact.
+     */
+    applyDesiredState(previous, schedule) {
+        const resourceId = schedule.metadata?.id ?? "";
+        return {
+            spec: {
+                cronExpressions: [specOf(schedule).cron],
+                timezone: specOf(schedule).timeZone,
+            },
+            action: this.tickAction(resourceId),
+            policies: {
+                overlap: ScheduleOverlapPolicy.SKIP,
+                catchupWindow: this.config.catchupWindowMinutes * 60_000,
+                pauseOnFailure: false,
+            },
+            state: {
+                ...previous.state,
+                paused: desiredPaused(schedule),
+                note: note(schedule),
+            },
+        };
+    }
+    /**
+     * Bakes the tick workflow start: workflow id = artifact id (Temporal
+     * appends the nominal fire time per fire — the tick's second-tier
+     * nominal-time derivation), the schedule's own queue, and the 24h
+     * run-timeout backstop. Retry deliberately stays at the workflow default
+     * (none): a failed tick is a missed fire, not a hot loop (Go tickAction).
+     */
+    tickAction(resourceId) {
+        return {
+            type: "startWorkflow",
+            workflowId: artifactId(resourceId),
+            workflowType: TICK_WORKFLOW_TYPE,
+            args: [resourceId],
+            taskQueue: this.config.stigmerQueue,
+            workflowRunTimeout: this.config.tickRunTimeoutHours * 3_600_000,
+        };
+    }
+}
+//# sourceMappingURL=artifact.js.map

package/dist/temporal/schedule/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../../src/temporal/schedule/artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,qBAAqB,GAMtB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,QAAkB;IACrC,OAAO,QAAQ,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;AACnF,CAAC;AAED,SAAS,MAAM,CAAC,QAAkB;IAChC,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE;QAC/B,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE;QACvC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,KAAK;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,MAA8B;QAA9B,WAAM,GAAN,MAAM,CAAwB;IAAG,CAAC;IAE/D,0EAA0E;IAC1E,aAAa,CAAC,QAAkB;QAC9B,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;QAC/C,OAAO;YACL,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;YAClC,IAAI,EAAE;gBACJ,eAAe,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;gBACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ;aACpC;YACD,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YACnC,QAAQ,EAAE;gBACR,OAAO,EAAE,qBAAqB,CAAC,IAAI;gBACnC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB,GAAG,MAAM;gBACxD,cAAc,EAAE,KAAK;aACtB;YACD,KAAK,EAAE;gBACL,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC;gBAC/B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC;aACrB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CACf,QAA6B,EAC7B,QAAkB;QAElB,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;QAC/C,OAAO;YACL,IAAI,EAAE;gBACJ,eAAe,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;gBACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ;aACpC;YACD,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YACnC,QAAQ,EAAE;gBACR,OAAO,EAAE,qBAAqB,CAAC,IAAI;gBACnC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB,GAAG,MAAM;gBACxD,cAAc,EAAE,KAAK;aACtB;YACD,KAAK,EAAE;gBACL,GAAG,QAAQ,CAAC,KAAK;gBACjB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC;gBAC/B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC;aACrB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,UAAU,CAAC,UAAkB;QACnC,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;YAClC,YAAY,EAAE,kBAAkB;YAChC,IAAI,EAAE,CAAC,UAAU,CAAC;YAClB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;YACnC,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,GAAG,SAAS;SAChE,CAAC;IACJ,CAAC;CACF"}