@noodleseed/one 0.46.0 → 0.48.0

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-runtime.js

@@ -0,0 +1,173 @@
+import { randomUUID } from 'node:crypto';
+import { createPostgresBillingMeterReadinessStore, createPostgresBillingMeterValidationEpochStore, } from './integration.js';
+import { createBillingMeterValidationMirror } from './meter-live-validation.js';
+import { BILLING_METER_RETRY_IDENTITY_VERSION, deriveBillingMeterKeyGeneration, } from './meter-readiness.js';
+import { BILLING_METER_WRITER_HEARTBEAT_INTERVAL_MS, } from './meter-readiness-health.js';
+import { BILLING_METER_VALIDATION_WRITER_CONTRACT_VERSION, } from './meter-validation-epoch.js';
+import { registerPostgresBillingMeterWriterSession } from './postgres-meter-live-validation.js';
+import { checkBillingMeterValidationFoundationPreflight } from './postgres-meter-prepare-preflight.js';
+import { BILLING_METER_SCHEDULER_CONTRACT_VERSION, ensureBillingMeterSchedulerSchema, PostgresBillingMeterScheduler, } from './postgres-meter-scheduler.js';
+import { createShadowBillingSink } from './shadow-meter.js';
+import { parseBillingUsageHmacKey } from './usage-identity.js';
+export async function createPostgresBillingMeterRuntime(input) {
+    const expectation = resolvePostgresBillingMeterRuntimeExpectation(input);
+    await ensureBillingMeterSchedulerSchema(input.pool);
+    const readinessStore = await createPostgresBillingMeterReadinessStore(input.pool, {
+        ...(input.billingUsageHmacKey === undefined
+            ? {}
+            : { billingUsageHmacKey: input.billingUsageHmacKey }),
+        ...(expectation === undefined ? {} : { validationRuntime: expectation }),
+    });
+    const validationEpochStore = await createPostgresBillingMeterValidationEpochStore(input.pool, {
+        ...(input.billingUsageHmacKey === undefined
+            ? {}
+            : { billingUsageHmacKey: input.billingUsageHmacKey }),
+        releaseSha: input.releaseSha,
+        foundationPreflight: ({ client }) => checkBillingMeterValidationFoundationPreflight(client),
+    });
+    if (expectation === undefined || input.validation === undefined) {
+        return {
+            readinessStore,
+            validationEpochStore,
+            start: () => undefined,
+            stop: () => Promise.resolve(),
+        };
+    }
+    const writer = await registerPostgresBillingMeterWriterSession(input.pool, {
+        sessionId: `bmws_${randomUUID()}`,
+        releaseSha: expectation.releaseSha,
+        keyGeneration: expectation.keyGeneration,
+        retryIdentityVersion: expectation.retryIdentityVersion,
+        writerContractVersion: expectation.writerContractVersion,
+    });
+    const mirror = createBillingMeterValidationMirror({
+        hmacKey: input.billingUsageHmacKey,
+        shadowSink: createShadowBillingSink({
+            store: input.usageStore,
+            ...(input.clock === undefined ? {} : { clock: input.clock }),
+            logger: input.logger,
+        }),
+        writer,
+        logger: input.logger,
+    });
+    const scheduler = new PostgresBillingMeterScheduler(input.pool, {
+        releaseSha: expectation.releaseSha,
+        cpuAlwaysAllocated: true,
+        ...(input.validation.schedulerIntervalMs === undefined
+            ? {}
+            : { intervalMs: input.validation.schedulerIntervalMs }),
+        ...(input.schedulerOperations === undefined ? {} : { operations: input.schedulerOperations }),
+        logger: input.logger,
+    });
+    return new LivePostgresBillingMeterRuntime(readinessStore, validationEpochStore, mirror, scheduler, input.validation.writerHeartbeatIntervalMs ?? BILLING_METER_WRITER_HEARTBEAT_INTERVAL_MS, input.logger);
+}
+class LivePostgresBillingMeterRuntime {
+    readinessStore;
+    validationEpochStore;
+    observer;
+    #mirror;
+    #scheduler;
+    #heartbeatIntervalMs;
+    #logger;
+    #started = false;
+    #closed = false;
+    #heartbeatTimer;
+    #heartbeatInFlight;
+    constructor(readinessStore, validationEpochStore, mirror, scheduler, heartbeatIntervalMs, logger) {
+        this.readinessStore = readinessStore;
+        this.validationEpochStore = validationEpochStore;
+        this.observer = mirror.observe;
+        this.#mirror = mirror;
+        this.#scheduler = scheduler;
+        this.#heartbeatIntervalMs = positiveInterval(heartbeatIntervalMs);
+        this.#logger = logger;
+    }
+    start() {
+        if (this.#closed)
+            throw new Error('billing meter runtime is closed');
+        if (this.#started)
+            return;
+        this.#started = true;
+        this.#scheduler.start();
+        void this.#reportAndScheduleHeartbeat();
+    }
+    async stop() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#started = false;
+        if (this.#heartbeatTimer !== undefined) {
+            clearTimeout(this.#heartbeatTimer);
+            this.#heartbeatTimer = undefined;
+        }
+        // Stop future scheduler recursion immediately, but do not put its potentially long current cycle in
+        // front of the writer's bounded drain. The service process has a shorter shutdown deadline than a
+        // scheduler cycle, so clean writer evidence must be persisted first.
+        const schedulerStop = this.#scheduler.stop();
+        const writerErrors = [];
+        if (this.#heartbeatInFlight !== undefined) {
+            try {
+                await this.#heartbeatInFlight;
+            }
+            catch (error) {
+                writerErrors.push(error);
+            }
+        }
+        try {
+            await this.#mirror.close();
+        }
+        catch (error) {
+            writerErrors.push(error);
+        }
+        await schedulerStop.catch(() => undefined);
+        if (writerErrors.length > 0) {
+            throw new AggregateError(writerErrors, 'billing meter writer shutdown failed');
+        }
+    }
+    async #reportAndScheduleHeartbeat() {
+        const report = this.#mirror.reportHealth().catch((error) => {
+            this.#logger.warn('billing.meter.writer_health_report_failed', {
+                errorKind: error instanceof Error ? error.name : 'unknown',
+            });
+        });
+        this.#heartbeatInFlight = report;
+        await report;
+        if (this.#heartbeatInFlight === report)
+            this.#heartbeatInFlight = undefined;
+        if (this.#started) {
+            this.#heartbeatTimer = setTimeout(() => {
+                this.#heartbeatTimer = undefined;
+                void this.#reportAndScheduleHeartbeat();
+            }, this.#heartbeatIntervalMs);
+            this.#heartbeatTimer.unref?.();
+        }
+    }
+}
+export function resolvePostgresBillingMeterRuntimeExpectation(input) {
+    if (input.validation === undefined)
+        return undefined;
+    if (input.validation.cpuAlwaysAllocated !== true) {
+        throw new Error('billing meter validation requires CPU to be always allocated');
+    }
+    if (input.billingUsageHmacKey === undefined) {
+        throw new Error('billing meter validation requires NOODLE_BILLING_USAGE_HMAC_KEY');
+    }
+    parseBillingUsageHmacKey(input.billingUsageHmacKey);
+    if (!/^[0-9a-f]{40}$/.test(input.releaseSha)) {
+        throw new Error('billing meter validation requires a full 40-character release SHA');
+    }
+    return {
+        releaseSha: input.releaseSha,
+        keyGeneration: deriveBillingMeterKeyGeneration(input.billingUsageHmacKey),
+        retryIdentityVersion: BILLING_METER_RETRY_IDENTITY_VERSION,
+        writerContractVersion: BILLING_METER_VALIDATION_WRITER_CONTRACT_VERSION,
+        schedulerContractVersion: BILLING_METER_SCHEDULER_CONTRACT_VERSION,
+    };
+}
+function positiveInterval(value) {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new Error('billing meter writer heartbeat interval must be positive');
+    }
+    return value;
+}
+//# sourceMappingURL=postgres-meter-runtime.js.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-runtime.js.map

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

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler-schema.d.ts

@@ -0,0 +1,7 @@
+import type { Pool } from 'pg';
+/**
+ * Additive scheduler evidence for the inactive validation meter. The scheduler owns this schema
+ * separately so boot wiring can create it without coupling scheduler evolution to receipt storage.
+ */
+export declare function ensureBillingMeterSchedulerSchema(database: Pick<Pool, 'query'>): Promise<void>;
+//# sourceMappingURL=postgres-meter-scheduler-schema.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-meter-scheduler-schema.d.ts","sourceRoot":"","sources":["../../src/billing/postgres-meter-scheduler-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B;;;GAGG;AACH,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler-schema.js

@@ -0,0 +1,50 @@
+/**
+ * Additive scheduler evidence for the inactive validation meter. The scheduler owns this schema
+ * separately so boot wiring can create it without coupling scheduler evolution to receipt storage.
+ */
+export async function ensureBillingMeterSchedulerSchema(database) {
+    await database.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_scheduler_runs (
+      run_id              text PRIMARY KEY,
+      run_sequence        bigint GENERATED ALWAYS AS IDENTITY UNIQUE,
+      contract_version    integer NOT NULL CHECK (contract_version = 1),
+      release_sha         text NOT NULL CHECK (release_sha ~ '^[0-9a-f]{40}$'),
+      cpu_always_allocated boolean NOT NULL CHECK (cpu_always_allocated),
+      status              text NOT NULL
+        CHECK (status IN ('running', 'succeeded', 'failed', 'backlogged')),
+      started_at          timestamptz NOT NULL,
+      completed_at        timestamptz,
+      windows_discovered  integer NOT NULL DEFAULT 0 CHECK (windows_discovered >= 0),
+      windows_processed   integer NOT NULL DEFAULT 0 CHECK (windows_processed >= 0),
+      windows_succeeded   integer NOT NULL DEFAULT 0 CHECK (windows_succeeded >= 0),
+      windows_failed      integer NOT NULL DEFAULT 0 CHECK (windows_failed >= 0),
+      backlog_detected    boolean NOT NULL DEFAULT false,
+      maintenance_run_id  text,
+      failure_code        text CHECK (
+        failure_code IN (
+          'reconciliation_failed',
+          'maintenance_failed',
+          'reconciliation_and_maintenance_failed',
+          'cycle_failed',
+          'leader_lost'
+        )
+      ),
+      CHECK (windows_discovered >= windows_processed),
+      CHECK (windows_processed = windows_succeeded + windows_failed),
+      CHECK (NOT backlog_detected OR windows_discovered > windows_processed),
+      CHECK (
+        (status = 'running' AND completed_at IS NULL AND failure_code IS NULL) OR
+        (status = 'succeeded' AND completed_at IS NOT NULL AND NOT backlog_detected AND
+          failure_code IS NULL) OR
+        (status = 'backlogged' AND completed_at IS NOT NULL AND backlog_detected AND
+          failure_code IS NULL) OR
+        (status = 'failed' AND completed_at IS NOT NULL AND failure_code IS NOT NULL)
+      )
+    )
+  `);
+    await database.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_scheduler_runs_latest_idx
+      ON billing_meter_scheduler_runs (run_sequence DESC)
+  `);
+}
+//# sourceMappingURL=postgres-meter-scheduler-schema.js.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-meter-scheduler-schema.js","sourceRoot":"","sources":["../../src/billing/postgres-meter-scheduler-schema.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,QAA6B;IAE7B,MAAM,QAAQ,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCpB,CAAC,CAAC;IACH,MAAM,QAAQ,CAAC,KAAK,CAAC;;;GAGpB,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler-store.d.ts

@@ -0,0 +1,34 @@
+import type { PoolClient } from 'pg';
+export declare const BILLING_METER_SCHEDULER_CONTRACT_VERSION = 1;
+export type BillingMeterSchedulerFailureCode = 'reconciliation_failed' | 'maintenance_failed' | 'reconciliation_and_maintenance_failed' | 'cycle_failed' | 'leader_lost';
+export interface BillingMeterSchedulerWindow {
+    readonly epochId: string;
+    readonly windowStart: string;
+    readonly windowEnd: string;
+}
+export interface BillingMeterSchedulerCycleCounts {
+    readonly windowsDiscovered: number;
+    readonly windowsProcessed: number;
+    readonly windowsSucceeded: number;
+    readonly windowsFailed: number;
+    readonly backlogDetected: boolean;
+    readonly maintenanceRunId: string | null;
+}
+export interface BillingMeterSchedulerCompletedCycle extends BillingMeterSchedulerCycleCounts {
+    readonly status: 'succeeded' | 'failed' | 'backlogged';
+    readonly runId: string;
+    readonly startedAt: string;
+    readonly completedAt: string;
+    readonly failureCode: BillingMeterSchedulerFailureCode | null;
+}
+export declare function startBillingMeterSchedulerRun(client: PoolClient, releaseSha: string): Promise<{
+    readonly runId: string;
+    readonly startedAt: string;
+}>;
+export declare function completeBillingMeterSchedulerRun(client: PoolClient, evidence: {
+    readonly runId: string;
+    readonly startedAt: string;
+}, counts: BillingMeterSchedulerCycleCounts, status: BillingMeterSchedulerCompletedCycle['status'], failureCode: BillingMeterSchedulerFailureCode | null): Promise<BillingMeterSchedulerCompletedCycle>;
+export declare function discoverBillingMeterSchedulerWindows(client: Pick<PoolClient, 'query'>, limit: number): Promise<readonly BillingMeterSchedulerWindow[]>;
+export declare function configureBillingMeterSchedulerSession(client: PoolClient, statementTimeoutMs: number, lockTimeoutMs: number): Promise<void>;
+//# sourceMappingURL=postgres-meter-scheduler-store.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-meter-scheduler-store.d.ts","sourceRoot":"","sources":["../../src/billing/postgres-meter-scheduler-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAUrC,eAAO,MAAM,wCAAwC,IAAI,CAAC;AAE1D,MAAM,MAAM,gCAAgC,GACxC,uBAAuB,GACvB,oBAAoB,GACpB,uCAAuC,GACvC,cAAc,GACd,aAAa,CAAC;AAElB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,mCAAoC,SAAQ,gCAAgC;IAC3F,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,gCAAgC,GAAG,IAAI,CAAC;CAC/D;AAQD,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBjE;AAED,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAChE,MAAM,EAAE,gCAAgC,EACxC,MAAM,EAAE,mCAAmC,CAAC,QAAQ,CAAC,EACrD,WAAW,EAAE,gCAAgC,GAAG,IAAI,GACnD,OAAO,CAAC,mCAAmC,CAAC,CAwC9C;AAED,wBAAsB,oCAAoC,CACxD,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EACjC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CA4EjD;AAED,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,UAAU,EAClB,kBAAkB,EAAE,MAAM,EAC1B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler-store.js

@@ -0,0 +1,157 @@
+import { randomUUID } from 'node:crypto';
+import { readBillingMeterTransactionTime } from './postgres-meter-clock.js';
+import { BILLING_METER_CHANGED_WINDOW_RECONCILIATION_DELAY_MS, BILLING_METER_CLEAN_WINDOW_RECONCILIATION_INTERVAL_MS, BILLING_METER_FAILED_WINDOW_RECONCILIATION_DELAY_MS, } from './postgres-meter-window-lock.js';
+import { validateScalarId } from './postgres-records.js';
+import { normalizeBillingUsageInstant } from './usage-window.js';
+export const BILLING_METER_SCHEDULER_CONTRACT_VERSION = 1;
+export async function startBillingMeterSchedulerRun(client, releaseSha) {
+    const runId = `bmsr_${randomUUID()}`;
+    await client.query('BEGIN');
+    try {
+        const startedAt = await readBillingMeterTransactionTime(client);
+        // Owning the global session lock proves no prior scheduler session is still alive. Close its
+        // durable running marker before starting fresh so takeover cannot mask a crash gap.
+        await client.query(`UPDATE billing_meter_scheduler_runs
+       SET status = 'failed', completed_at = $1, failure_code = 'leader_lost'
+       WHERE status = 'running'`, [startedAt]);
+        await client.query(`INSERT INTO billing_meter_scheduler_runs
+         (run_id, contract_version, release_sha, cpu_always_allocated, status, started_at)
+       VALUES ($1, $2, $3, true, 'running', $4)`, [runId, BILLING_METER_SCHEDULER_CONTRACT_VERSION, releaseSha, startedAt]);
+        await client.query('COMMIT');
+        return { runId, startedAt };
+    }
+    catch (error) {
+        await rollbackQuietly(client);
+        throw error;
+    }
+}
+export async function completeBillingMeterSchedulerRun(client, evidence, counts, status, failureCode) {
+    await client.query('BEGIN');
+    try {
+        const completedAt = await readBillingMeterTransactionTime(client);
+        const updated = await client.query(`UPDATE billing_meter_scheduler_runs
+       SET status = $2, completed_at = $3,
+           windows_discovered = $4, windows_processed = $5,
+           windows_succeeded = $6, windows_failed = $7,
+           backlog_detected = $8, maintenance_run_id = $9, failure_code = $10
+       WHERE run_id = $1 AND status = 'running'`, [
+            evidence.runId,
+            status,
+            completedAt,
+            counts.windowsDiscovered,
+            counts.windowsProcessed,
+            counts.windowsSucceeded,
+            counts.windowsFailed,
+            counts.backlogDetected,
+            counts.maintenanceRunId,
+            failureCode,
+        ]);
+        if (updated.rowCount !== 1) {
+            throw new Error('billing meter scheduler evidence was not running');
+        }
+        await client.query('COMMIT');
+        return {
+            status,
+            runId: evidence.runId,
+            startedAt: evidence.startedAt,
+            completedAt,
+            ...counts,
+            failureCode,
+        };
+    }
+    catch (error) {
+        await rollbackQuietly(client);
+        throw error;
+    }
+}
+export async function discoverBillingMeterSchedulerWindows(client, limit) {
+    const result = await client.query(`WITH scheduler_clock AS (
+       SELECT billing_meter_transaction_time() AS checked_at
+     )
+     SELECT meter_window.epoch_id, meter_window.window_start, meter_window.window_end
+     FROM billing_meter_windows AS meter_window
+     JOIN billing_meter_epochs AS epoch ON epoch.id = meter_window.epoch_id
+     CROSS JOIN scheduler_clock
+     LEFT JOIN LATERAL (
+       SELECT reconciliation.status, reconciliation.checked_at,
+              reconciliation.next_reconcile_at,
+              reconciliation.receipt_included_calls,
+              reconciliation.receipt_overage_calls,
+              reconciliation.receipt_denied_calls
+       FROM billing_meter_reconciliation_runs AS reconciliation
+       WHERE reconciliation.epoch_id = meter_window.epoch_id
+         AND reconciliation.window_start = meter_window.window_start
+         AND reconciliation.window_end = meter_window.window_end
+       ORDER BY reconciliation.checked_at DESC, reconciliation.run_id DESC
+       LIMIT 1
+     ) AS latest ON true
+     CROSS JOIN LATERAL (
+       SELECT least(
+         CASE
+           WHEN latest.checked_at IS NULL THEN meter_window.first_observed_at
+           ELSE coalesce(
+             latest.next_reconcile_at,
+             CASE latest.status
+               WHEN 'failed' THEN latest.checked_at + interval '${BILLING_METER_FAILED_WINDOW_RECONCILIATION_DELAY_MS} milliseconds'
+               ELSE latest.checked_at + interval '${BILLING_METER_CLEAN_WINDOW_RECONCILIATION_INTERVAL_MS} milliseconds'
+             END
+           )
+         END,
+         CASE
+           WHEN latest.checked_at IS NOT NULL AND
+                (
+                  meter_window.last_observed_at > latest.checked_at OR
+                  meter_window.receipt_included_calls <> latest.receipt_included_calls OR
+                  meter_window.receipt_overage_calls <> latest.receipt_overage_calls OR
+                  meter_window.receipt_denied_calls <> latest.receipt_denied_calls
+                )
+             THEN meter_window.last_observed_at + interval '${BILLING_METER_CHANGED_WINDOW_RECONCILIATION_DELAY_MS} milliseconds'
+         END,
+         CASE
+           WHEN latest.checked_at IS NULL OR
+                latest.checked_at < meter_window.window_end OR
+                latest.status = 'succeeded'
+             THEN meter_window.window_end
+         END,
+         CASE
+           WHEN epoch.state = 'retired' AND (
+             latest.checked_at IS NULL OR
+             latest.checked_at < epoch.retired_at OR
+             latest.status = 'succeeded'
+           ) THEN epoch.retired_at
+         END
+       ) AS due_at
+     ) AS schedule
+     WHERE epoch.state IN ('prepared', 'retired')
+       AND meter_window.sealed_at IS NULL
+       AND meter_window.first_observed_at IS NOT NULL
+       AND schedule.due_at <= scheduler_clock.checked_at
+     ORDER BY schedule.due_at,
+              meter_window.window_start, meter_window.window_end, meter_window.epoch_id
+     LIMIT $1`, [limit]);
+    if (result.rows.length > limit) {
+        throw new Error('billing meter scheduler window query exceeded its bound');
+    }
+    return result.rows.map((row) => ({
+        epochId: validateScalarId('billing meter epoch id', row.epoch_id),
+        windowStart: normalizeSchedulerInstant('billing meter window start', row.window_start),
+        windowEnd: normalizeSchedulerInstant('billing meter window end', row.window_end),
+    }));
+}
+export async function configureBillingMeterSchedulerSession(client, statementTimeoutMs, lockTimeoutMs) {
+    await client.query(`SELECT set_config('statement_timeout', $1, false),
+            set_config('lock_timeout', $2, false),
+            set_config('idle_in_transaction_session_timeout', $1, false)`, [`${statementTimeoutMs}ms`, `${lockTimeoutMs}ms`]);
+}
+function normalizeSchedulerInstant(label, value) {
+    return normalizeBillingUsageInstant(label, value instanceof Date ? value.toISOString() : value);
+}
+async function rollbackQuietly(client) {
+    try {
+        await client.query('ROLLBACK');
+    }
+    catch {
+        // Preserve the original scheduler evidence failure.
+    }
+}
+//# sourceMappingURL=postgres-meter-scheduler-store.js.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-meter-scheduler-store.js","sourceRoot":"","sources":["../../src/billing/postgres-meter-scheduler-store.ts"],"names":[],"mappings":"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"}

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler.d.ts

@@ -0,0 +1,56 @@
+import { type Logger } from '@noodle-borg/transport-http';
+import type { Pool, PoolClient } from 'pg';
+import { type BillingMeterSchedulerCompletedCycle, type BillingMeterSchedulerWindow } from './postgres-meter-scheduler-store.js';
+export { ensureBillingMeterSchedulerSchema } from './postgres-meter-scheduler-schema.js';
+export { BILLING_METER_SCHEDULER_CONTRACT_VERSION, type BillingMeterSchedulerCompletedCycle, type BillingMeterSchedulerFailureCode, type BillingMeterSchedulerWindow, } from './postgres-meter-scheduler-store.js';
+export declare const BILLING_METER_SCHEDULER_LOCK_KEY = "billing-meter-maintenance-scheduler:v1";
+export declare const BILLING_METER_SCHEDULER_INTERVAL_MS: number;
+export declare const BILLING_METER_SCHEDULER_MAX_WINDOWS_PER_CYCLE = 100;
+export declare const BILLING_METER_SCHEDULER_STATEMENT_TIMEOUT_MS = 30000;
+export declare const BILLING_METER_SCHEDULER_LOCK_TIMEOUT_MS = 5000;
+export declare const BILLING_METER_SCHEDULER_CYCLE_TIMEOUT_MS: number;
+export interface BillingMeterSchedulerOperations {
+    reconcileWindow(client: PoolClient, window: BillingMeterSchedulerWindow): Promise<{
+        readonly status: 'succeeded' | 'failed';
+    }>;
+    runMaintenance(client: PoolClient): Promise<{
+        readonly runId: string;
+    }>;
+}
+export interface PostgresBillingMeterSchedulerOptions {
+    /** Full source commit identity written into every durable cycle record. */
+    readonly releaseSha: string;
+    /** An enabled in-service timer requires hosting CPU allocation outside request handling. */
+    readonly cpuAlwaysAllocated: true;
+    readonly intervalMs?: number;
+    readonly maxWindowsPerCycle?: number;
+    readonly statementTimeoutMs?: number;
+    readonly lockTimeoutMs?: number;
+    readonly cycleTimeoutMs?: number;
+    readonly logger?: Logger;
+    /** Injectable only to isolate orchestration tests; production uses the connected-client stores. */
+    readonly operations?: BillingMeterSchedulerOperations;
+}
+export type BillingMeterSchedulerCycleResult = BillingMeterSchedulerCompletedCycle | {
+    readonly status: 'skipped';
+    readonly reason: 'lock_not_acquired';
+};
+/**
+ * One scheduler may run in every stateless service instance. Local recursion prevents overlap in
+ * one process; the session advisory lock elects one leader across the fleet for the complete cycle.
+ * Validation remains fail-open and this class never activates an epoch or changes admission.
+ */
+export declare class PostgresBillingMeterScheduler {
+    #private;
+    constructor(pool: Pool, options: PostgresBillingMeterSchedulerOptions);
+    /** Start one immediate cycle, followed by a recursive delay measured after each completion. */
+    start(): void;
+    /** Stop future recursion and wait for the current bounded cycle to release its database client. */
+    stop(): Promise<void>;
+    /** Run now, or join the already-running local cycle rather than overlapping it. */
+    runNow(): Promise<BillingMeterSchedulerCycleResult>;
+}
+export declare class BillingMeterSchedulerCycleTimeoutError extends Error {
+    constructor();
+}
+//# sourceMappingURL=postgres-meter-scheduler.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-meter-scheduler.d.ts","sourceRoot":"","sources":["../../src/billing/postgres-meter-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAM3C,OAAO,EACL,KAAK,mCAAmC,EAGxC,KAAK,2BAA2B,EAKjC,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,iCAAiC,EAAE,MAAM,sCAAsC,CAAC;AACzF,OAAO,EACL,wCAAwC,EACxC,KAAK,mCAAmC,EACxC,KAAK,gCAAgC,EACrC,KAAK,2BAA2B,GACjC,MAAM,qCAAqC,CAAC;AAE7C,eAAO,MAAM,gCAAgC,2CAA2C,CAAC;AACzF,eAAO,MAAM,mCAAmC,QAAiB,CAAC;AAClE,eAAO,MAAM,6CAA6C,MAAM,CAAC;AACjE,eAAO,MAAM,4CAA4C,QAAS,CAAC;AACnE,eAAO,MAAM,uCAAuC,OAAQ,CAAC;AAC7D,eAAO,MAAM,wCAAwC,QAAiB,CAAC;AAEvE,MAAM,WAAW,+BAA+B;IAC9C,eAAe,CACb,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAA;KAAE,CAAC,CAAC;IACxD,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,oCAAoC;IACnD,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,kBAAkB,EAAE,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,mGAAmG;IACnG,QAAQ,CAAC,UAAU,CAAC,EAAE,+BAA+B,CAAC;CACvD;AAED,MAAM,MAAM,gCAAgC,GACxC,mCAAmC,GACnC;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAOzE;;;;GAIG;AACH,qBAAa,6BAA6B;;gBAc5B,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,oCAAoC;IA8BrE,+FAA+F;IAC/F,KAAK,IAAI,IAAI;IAMb,mGAAmG;IAC7F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,mFAAmF;IACnF,MAAM,IAAI,OAAO,CAAC,gCAAgC,CAAC;CA8JpD;AA0BD,qBAAa,sCAAuC,SAAQ,KAAK;;CAKhE"}