@substrat-run/kernel 0.141.0 → 0.142.0

package/dist/storage-gauge.js

@@ -0,0 +1,234 @@
+import { STORAGE_EXCLUSIONS, scopeStorageSample, } from '@substrat-run/contracts';
+import { assertRowLimit, boundedRetentionDelete } from './scope-host.js';
+/**
+ * The stored storage gauge (#1524), as statements both adapters run against their directory:
+ * the SQLite host over better-sqlite3, the hosted one inside ControlPlaneDO. Written once so
+ * the two cannot keep different histories of the same fleet.
+ *
+ * One row per (scope, UTC day): the day's LATEST reading, replaced by a later one on the
+ * same day. A day holds one number per scope, which is what a byte-day sum needs and no
+ * more, so the table grows by at most one row per scope per day, and retention
+ * (`STORAGE_GAUGE_RETENTION_MONTHS`) bounds it in time.
+ *
+ * The rows are written by the scheduled pass (`runPlatformSweep`'s storage phase), which
+ * samples only scopes an earlier phase of the same pass already woke. Nothing here reads a
+ * scope; serving a figure is a directory read.
+ *
+ * Beside the samples, `_substrat_scope_storage_attempts` keeps one row per scope: when the
+ * phase last TRIED, and the error if the read failed. It is what the phase picks due scopes
+ * by. Without it a scope whose read keeps failing would stay due and be retried on every
+ * pass, ahead of every scope that can be read, and its error would reach every pass's
+ * failure digest. With it, a failing scope is tried once a day like any other, while its last
+ * good sample stands.
+ */
+export const SCOPE_STORAGE_DDL = `
+  CREATE TABLE IF NOT EXISTS _substrat_scope_storage (
+    scope_id TEXT NOT NULL,
+    day TEXT NOT NULL,
+    tenant_id TEXT NOT NULL,
+    bytes INTEGER NOT NULL,
+    read_at TEXT NOT NULL,
+    PRIMARY KEY (scope_id, day)
+  );
+  CREATE INDEX IF NOT EXISTS _substrat_scope_storage_tenant ON _substrat_scope_storage (tenant_id, day);
+  CREATE INDEX IF NOT EXISTS _substrat_scope_storage_day ON _substrat_scope_storage (day);
+  CREATE TABLE IF NOT EXISTS _substrat_scope_storage_attempts (
+    scope_id TEXT PRIMARY KEY,
+    tenant_id TEXT NOT NULL,
+    attempted_at TEXT NOT NULL,
+    error TEXT
+  );
+`;
+/**
+ * The statuses a scope that holds a store can be in: every status but `provisioning` (no
+ * store yet) and `reaped` (its store is gone). A non-serving scope (suspended, archiving,
+ * archived) still holds its storage until reap, so it is measured and belongs on the bill.
+ */
+export const STORED_SCOPE_STATUSES = ['active', 'suspended', 'archiving', 'archived'];
+/**
+ * Whether a scope holds a store to measure (#1524): a `STORED_SCOPE_STATUSES` status, unless
+ * it was archived straight from `provisioning` (`archivedFromStatus`). That scope never held
+ * data, so it is neither read (a read would create the spine it never had) nor counted. A row
+ * archived before the column existed has a null `archivedFromStatus` and is measured, as
+ * before. `holdsStoreSql` is the same rule for the directory's SQL.
+ */
+export function holdsStore(scope) {
+    if (!STORED_SCOPE_STATUSES.includes(scope.status))
+        return false;
+    return !((scope.status === 'archived' || scope.status === 'archiving') && scope.archivedFromStatus === 'provisioning');
+}
+/** `holdsStore` over a `scopes` row, with an optional table alias (`'s.'`). */
+export function holdsStoreSql(alias = '') {
+    return (`${alias}status IN ('active', 'suspended', 'archiving', 'archived') AND NOT ` +
+        `(${alias}status IN ('archiving', 'archived') AND ${alias}archived_from_status IS 'provisioning')`);
+}
+/** How long a day's sample is kept: thirteen months, so a year can be compared with the one before it. */
+export const STORAGE_GAUGE_RETENTION_MONTHS = 13;
+/** How many samples one `pruneScopeStorage` call deletes, by default. */
+export const STORAGE_GAUGE_PRUNE_BATCH = 500;
+/** The most history rows one `listScopeStorage` call returns, and its default. */
+export const STORAGE_HISTORY_LIMIT_MAX = 10_000;
+export const STORAGE_HISTORY_LIMIT_DEFAULT = 1_000;
+/** The UTC day a reading belongs to. */
+export function storageGaugeDay(readAt) {
+    return new Date(readAt).toISOString().slice(0, 10);
+}
+/**
+ * The first day retention keeps: thirteen calendar months before `nowMs`, as a UTC day. The
+ * day is clamped to the target month's last day, so the 31st of a month counts back to the
+ * 28th, 29th or 30th rather than rolling forward into the month after.
+ */
+export function storageRetentionHorizon(nowMs) {
+    const now = new Date(nowMs);
+    const month = now.getUTCMonth() - STORAGE_GAUGE_RETENTION_MONTHS;
+    // Day 0 of the following month is the last day of the target month.
+    const lastDay = new Date(Date.UTC(now.getUTCFullYear(), month + 1, 0)).getUTCDate();
+    return new Date(Date.UTC(now.getUTCFullYear(), month, Math.min(now.getUTCDate(), lastDay))).toISOString().slice(0, 10);
+}
+/**
+ * Record attempts, a statement or two each. Every row is written only for a scope the
+ * directory holds UNDER THAT TENANT and has not reaped, so a reading can never land in another
+ * tenant's figure, and a scope reaped while its read was in flight leaves no row behind.
+ *
+ * Every attempt replaces the scope's attempt row. A successful one also upserts the day's
+ * sample, which replaces an older reading of that day and never a newer one; a failed one
+ * leaves the samples alone, so the last good reading stands. Returns how many SAMPLE rows
+ * were written.
+ */
+export function recordScopeStorageRows(sql, readings) {
+    let recorded = 0;
+    for (const r of readings) {
+        const readAt = new Date(r.readAt).toISOString();
+        const ok = r.bytes !== null && Number.isInteger(r.bytes) && r.bytes >= 0;
+        sql(`INSERT INTO _substrat_scope_storage_attempts (scope_id, tenant_id, attempted_at, error)
+       SELECT scope_id, tenant_id, ?, ? FROM scopes
+        WHERE scope_id = ? AND tenant_id = ? AND ${holdsStoreSql()}
+       ON CONFLICT (scope_id) DO UPDATE SET attempted_at = excluded.attempted_at, error = excluded.error
+        WHERE excluded.attempted_at >= _substrat_scope_storage_attempts.attempted_at`, [readAt, r.error ?? null, r.scopeId, r.tenantId]);
+        if (!ok)
+            continue;
+        recorded += sql(`INSERT INTO _substrat_scope_storage (scope_id, day, tenant_id, bytes, read_at)
+       SELECT scope_id, ?, tenant_id, ?, ? FROM scopes
+        WHERE scope_id = ? AND tenant_id = ? AND ${holdsStoreSql()}
+       ON CONFLICT (scope_id, day) DO UPDATE SET bytes = excluded.bytes, read_at = excluded.read_at
+        WHERE excluded.read_at >= _substrat_scope_storage.read_at
+       RETURNING 1`, [storageGaugeDay(readAt), r.bytes, readAt, r.scopeId, r.tenantId]).length;
+    }
+    return recorded;
+}
+/** Read samples — see `ScopeStorageFilter`. Every row is parsed on the way out. */
+export function listScopeStorageRows(sql, filter = {}) {
+    const where = [holdsStoreSql('s.')];
+    const params = [];
+    if (filter.tenantId) {
+        where.push('s.tenant_id = ?');
+        params.push(filter.tenantId);
+    }
+    if (filter.scopeId) {
+        where.push('s.scope_id = ?');
+        params.push(filter.scopeId);
+    }
+    let tail = '';
+    // `latest` is joined on the scope's newest day, which the (scope_id, day) key answers with
+    // one seek per scope, so a meter read touches one sample per scope however much history
+    // retention holds, rather than reading every day and discarding all but the last.
+    let latestDay = '';
+    if (filter.latest) {
+        latestDay = ' AND g.day = (SELECT MAX(m.day) FROM _substrat_scope_storage m WHERE m.scope_id = s.scope_id)';
+    }
+    else {
+        if (filter.since) {
+            where.push('g.day >= ?');
+            params.push(filter.since);
+        }
+        if (filter.until) {
+            where.push('g.day <= ?');
+            params.push(filter.until);
+        }
+        const limit = assertRowLimit('limit', filter.limit ?? STORAGE_HISTORY_LIMIT_DEFAULT);
+        tail = ' LIMIT ?';
+        params.push(Math.min(limit, STORAGE_HISTORY_LIMIT_MAX));
+    }
+    // The join to `scopes` is the belt to the reap's braces: a reaped scope's rows are
+    // deleted at reap, and any that survived are still never read.
+    const rows = sql(`SELECT g.tenant_id, g.scope_id, g.day, g.bytes, g.read_at
+       FROM scopes s
+       JOIN _substrat_scope_storage g ON g.scope_id = s.scope_id AND g.tenant_id = s.tenant_id${latestDay}
+      WHERE ${where.join(' AND ')}
+      ORDER BY g.scope_id, g.day${tail}`, params);
+    return rows.map((r) => scopeStorageSample.parse({
+        tenantId: r.tenant_id,
+        scopeId: r.scope_id,
+        day: r.day,
+        bytes: r.bytes,
+        readAt: r.read_at,
+    }));
+}
+/**
+ * Every stored scope's latest attempt — what the storage phase picks due scopes by, and
+ * what a meter reading names failing scopes from. `tenantId` narrows to one tenant.
+ */
+export function listScopeStorageAttemptRows(sql, tenantId) {
+    const rows = sql(`SELECT a.tenant_id, a.scope_id, a.attempted_at, a.error
+       FROM _substrat_scope_storage_attempts a
+       JOIN scopes s ON s.scope_id = a.scope_id AND s.tenant_id = a.tenant_id
+      WHERE ${holdsStoreSql('s.')}${tenantId ? ' AND s.tenant_id = ?' : ''}
+      ORDER BY a.scope_id`, tenantId ? [tenantId] : []);
+    return rows.map((r) => ({
+        tenantId: r.tenant_id,
+        scopeId: r.scope_id,
+        attemptedAt: r.attempted_at,
+        error: r.error,
+    }));
+}
+/** Delete at most `limit` samples older than retention, oldest first. Returns how many went. */
+export function pruneScopeStorageRows(sql, nowMs, limit) {
+    return sql(boundedRetentionDelete('_substrat_scope_storage', 'day'), [
+        storageRetentionHorizon(nowMs),
+        assertRowLimit('limit', limit),
+    ]).length;
+}
+/** Drop a scope's samples and attempt: its storage is gone, so its history describes nothing billable. */
+export function forgetScopeStorage(sql, scopeId) {
+    sql('DELETE FROM _substrat_scope_storage WHERE scope_id = ?', [scopeId]);
+    sql('DELETE FROM _substrat_scope_storage_attempts WHERE scope_id = ?', [scopeId]);
+}
+/**
+ * Fold latest samples into one gauge. `total` is the caller's count of stored scopes
+ * (`STORED_SCOPE_STATUSES`); samples are expected to be the latest per stored scope
+ * (`listScopeStorage({ latest })`), and attempts the latest per stored scope
+ * (`listScopeStorageAttempts`).
+ */
+export function foldStorageGauge(samples, total, attempts = []) {
+    let failing = 0;
+    let lastFailed = null;
+    for (const a of attempts) {
+        if (a.error === null)
+            continue;
+        failing += 1;
+        if (lastFailed === null || a.attemptedAt > lastFailed)
+            lastFailed = a.attemptedAt;
+    }
+    let bytes = 0;
+    let oldest = null;
+    let newest = null;
+    for (const s of samples) {
+        bytes += s.bytes;
+        if (oldest === null || s.readAt < oldest)
+            oldest = s.readAt;
+        if (newest === null || s.readAt > newest)
+            newest = s.readAt;
+    }
+    return {
+        basis: 'scope-databases',
+        excluded: [...STORAGE_EXCLUSIONS],
+        bytes,
+        sampled: samples.length,
+        total,
+        oldestReadAt: oldest,
+        newestReadAt: newest,
+        failing,
+        lastFailedAt: lastFailed,
+    };
+}
+//# sourceMappingURL=storage-gauge.js.map

package/dist/storage-gauge.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@substrat-run/kernel",
-  "version": "0.141.0",
+  "version": "0.142.0",
   "description": "Substrat kernel contracts and services — pure TypeScript, no platform imports (D-14)",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -16,13 +16,21 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./invocation-line": {
+      "types": "./dist/invocation-line.d.ts",
+      "default": "./dist/invocation-line.js"
+    },
+    "./ulid": {
+      "types": "./dist/ulid.d.ts",
+      "default": "./dist/ulid.js"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@substrat-run/contracts": "^0.141.0"
+    "@substrat-run/contracts": "^0.142.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.5",