@omnitron-dev/omnitron 0.2.0 → 0.3.1

package/dist/services/trace-collector.service.d.ts

@@ -14,47 +14,8 @@
 import type { Kysely } from 'kysely';
 import type { ILogger } from '@omnitron-dev/titan/module/logger';
 import type { OmnitronDatabase } from '../database/schema.js';
-export interface TraceSpan {
-    traceId: string;
-    spanId: string;
-    parentSpanId: string | null;
-    operationName: string;
-    serviceName: string;
-    startTime: string;
-    endTime: string;
-    duration: number;
-    status: 'ok' | 'error';
-    tags: Record<string, string>;
-    logs?: Array<{
-        timestamp: string;
-        message: string;
-    }>;
-}
-export interface Trace {
-    traceId: string;
-    spans: TraceSpan[];
-    duration: number;
-    serviceName: string;
-    operationName: string;
-    startTime: string;
-}
-export interface TraceFilter {
-    service?: string;
-    operation?: string;
-    minDuration?: number;
-    maxDuration?: number;
-    from?: string;
-    to?: string;
-    limit?: number;
-    tags?: Record<string, string>;
-}
-export interface ServiceMapEntry {
-    source: string;
-    target: string;
-    callCount: number;
-    avgDuration: number;
-    errorRate: number;
-}
+import type { TraceSpan, Trace, TraceFilter, ServiceMapEntry } from '../shared/dto/traces.js';
+export type { TraceSpan, Trace, TraceFilter, ServiceMapEntry, } from '../shared/dto/traces.js';
 export declare class TraceCollectorService {
     private readonly db;
     private readonly logger;

package/dist/services/trace-collector.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace-collector.service.d.ts","sourceRoot":"","sources":["../../src/services/trace-collector.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAM9D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,qBAAqB;IAO9B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAO;gBAGlB,EAAE,EAAE,MAAM,CAAC,gBAAgB,CAAC,EAC5B,MAAM,EAAE,OAAO;IAOlC,KAAK,IAAI,IAAI;IAMP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAuBhD,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA+ClD,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YA8BnC,KAAK;IAwCnB,OAAO,CAAC,OAAO;CAehB"}
+{"version":3,"file":"trace-collector.service.d.ts","sourceRoot":"","sources":["../../src/services/trace-collector.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EACL,WAAW,EACX,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAMjC,YAAY,EACV,SAAS,EACT,KAAK,EACL,WAAW,EACX,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAOjC,qBAAa,qBAAqB;IAO9B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAO;IAErC,YACmB,EAAE,EAAE,MAAM,CAAC,gBAAgB,CAAC,EAC5B,MAAM,EAAE,OAAO,EAC9B;IAMJ,KAAK,IAAI,IAAI,CAIZ;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1B;IAMK,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/C;IAEK,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnD;IAMK,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAqBrD;IAEK,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAyDvD;IAEK,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAgChD;YAMa,KAAK;IAwCnB,OAAO,CAAC,OAAO;CAehB"}

package/dist/services/trace-collector.service.js

@@ -82,10 +82,22 @@ export class TraceCollectorService {
     async queryTraces(filter) {
         const limit = filter.limit ?? 50;
         // Query distinct trace IDs matching the filter, then fetch full traces
+        // The most recent span of each trace decides where the trace sorts.
+        //
+        // This was `SELECT DISTINCT traceId … ORDER BY startTime`, which Postgres
+        // rejects outright — "for SELECT DISTINCT, ORDER BY expressions must
+        // appear in select list" — so the traces page has never listed anything.
+        // The console hid it: the page fired this and `getServiceMap` through
+        // `Promise.allSettled` and read only the fulfilled halves, so a rejection
+        // left the previous (empty) value on screen with nothing said.
+        //
+        // Selecting the max start time per trace both satisfies the rule and is
+        // the ordering that was intended: a trace is as recent as its latest span.
         let query = this.db
             .selectFrom('traces')
             .select(['traceId'])
-            .distinct();
+            .select(sql `MAX("startTime")`.as('latestStart'))
+            .groupBy('traceId');
         if (filter.service) {
             query = query.where('serviceName', '=', filter.service);
         }
@@ -110,7 +122,7 @@ export class TraceCollectorService {
             }
         }
         const traceIds = await query
-            .orderBy('startTime', 'desc')
+            .orderBy('latestStart', 'desc')
             .limit(limit)
             .execute();
         const traces = [];
@@ -123,17 +135,25 @@ export class TraceCollectorService {
     }
     async getServiceMap() {
         // Query parent-child span pairs to build service-to-service call map
+        // Column names are quoted camelCase — this table is created that way (see
+        // migration 003), and the unquoted snake_case this query used does not
+        // exist, so every call failed with `column child.trace_id does not exist`.
+        // Both halves of the traces page were broken in the same way and the page
+        // showed neither, because it read only the fulfilled halves of an
+        // `allSettled` pair.
         const rows = await sql `
       SELECT
-        parent.service_name AS source,
-        child.service_name AS target,
+        parent."serviceName" AS source,
+        child."serviceName" AS target,
         COUNT(*) AS call_count,
         AVG(child.duration) AS avg_duration,
         SUM(CASE WHEN child.status = 'error' THEN 1 ELSE 0 END)::float / NULLIF(COUNT(*), 0) AS error_rate
       FROM traces child
-      JOIN traces parent ON child.trace_id = parent.trace_id AND child.parent_span_id = parent.span_id
-      WHERE parent.service_name != child.service_name
-      GROUP BY parent.service_name, child.service_name
+      JOIN traces parent
+        ON child."traceId" = parent."traceId"
+       AND child."parentSpanId" = parent."spanId"
+      WHERE parent."serviceName" != child."serviceName"
+      GROUP BY parent."serviceName", child."serviceName"
       ORDER BY call_count DESC
       LIMIT 100
     `.execute(this.db);

package/dist/services/trace-collector.service.js.map

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

package/dist/services/wait-for-postgres.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Wait until a Postgres accepts connections.
+ *
+ * Its own module because it has no dependency on `ProjectService` and one test
+ * that mattered could not reach it there. `project-service-internals.spec.ts`
+ * used to carry a COPY of this function, with a comment saying so, and
+ * therefore passed no matter what the real implementation did — including a
+ * change to this very message. A test that exercises a duplicate of the code
+ * is not a test of the code.
+ */
+/**
+ * Poll until Postgres answers `SELECT 1`, or the deadline passes.
+ *
+ * Containers are reported "running" by Docker before they accept connections,
+ * especially right after a fresh provision: a cold one has to initdb and
+ * install extensions first. Callers run migrations immediately after this
+ * returns, and a `stack start` aborts entirely if it throws, so the deadline
+ * they pass decides whether a slow first boot is a delay or a stack that never
+ * comes up.
+ *
+ * On failure the message carries the last connection error and the time
+ * actually spent. Without them it said only that the deadline passed, which is
+ * the one thing the operator already knows — "not listening yet", "wrong
+ * password" and "database refuses connections" all arrived as the same
+ * sentence, naming a duration rather than a cause.
+ */
+export declare function waitForPostgres(host: string, port: number, user: string, password: string, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=wait-for-postgres.d.ts.map

package/dist/services/wait-for-postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-postgres.d.ts","sourceRoot":"","sources":["../../src/services/wait-for-postgres.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/services/wait-for-postgres.js

@@ -0,0 +1,77 @@
+/**
+ * Wait until a Postgres accepts connections.
+ *
+ * Its own module because it has no dependency on `ProjectService` and one test
+ * that mattered could not reach it there. `project-service-internals.spec.ts`
+ * used to carry a COPY of this function, with a comment saying so, and
+ * therefore passed no matter what the real implementation did — including a
+ * change to this very message. A test that exercises a duplicate of the code
+ * is not a test of the code.
+ */
+/**
+ * Poll until Postgres answers `SELECT 1`, or the deadline passes.
+ *
+ * Containers are reported "running" by Docker before they accept connections,
+ * especially right after a fresh provision: a cold one has to initdb and
+ * install extensions first. Callers run migrations immediately after this
+ * returns, and a `stack start` aborts entirely if it throws, so the deadline
+ * they pass decides whether a slow first boot is a delay or a stack that never
+ * comes up.
+ *
+ * On failure the message carries the last connection error and the time
+ * actually spent. Without them it said only that the deadline passed, which is
+ * the one thing the operator already knows — "not listening yet", "wrong
+ * password" and "database refuses connections" all arrived as the same
+ * sentence, naming a duration rather than a cause.
+ */
+export async function waitForPostgres(host, port, user, password, timeoutMs) {
+    const startedAt = Date.now();
+    const deadline = startedAt + timeoutMs;
+    const { Client } = await import('pg').catch(() => ({ Client: null }));
+    const failure = (kind, lastError) => {
+        const waited = Math.round((Date.now() - startedAt) / 1000);
+        const last = lastError ? ` Last attempt: ${lastError.message}.` : '';
+        return new Error(`Postgres at ${host}:${port} ${kind} (waited ${waited}s, limit ${timeoutMs}ms).${last}`, lastError ? { cause: lastError } : undefined);
+    };
+    let lastError = null;
+    if (!Client) {
+        // `pg` unavailable in this build — fall back to a TCP connect probe.
+        const net = await import('node:net');
+        while (Date.now() < deadline) {
+            const ok = await new Promise((resolve) => {
+                const sock = net.createConnection({ host, port }, () => {
+                    sock.end();
+                    resolve(true);
+                });
+                sock.once('error', (err) => {
+                    lastError = err;
+                    resolve(false);
+                });
+                sock.setTimeout(2_000, () => {
+                    sock.destroy();
+                    resolve(false);
+                });
+            });
+            if (ok)
+                return;
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        throw failure('was not reachable', lastError);
+    }
+    while (Date.now() < deadline) {
+        const client = new Client({ host, port, user, password, database: 'postgres', connectionTimeoutMillis: 2_000 });
+        try {
+            await client.connect();
+            await client.query('SELECT 1');
+            await client.end().catch(() => { });
+            return;
+        }
+        catch (err) {
+            lastError = err;
+            await client.end().catch(() => { });
+            await new Promise((r) => setTimeout(r, 500));
+        }
+    }
+    throw failure('did not become ready', lastError);
+}
+//# sourceMappingURL=wait-for-postgres.js.map

package/dist/services/wait-for-postgres.js.map

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

package/dist/shared/alert-expression.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The alert expressions this platform can evaluate.
+ *
+ * Shared between the daemon and the console on purpose. The evaluator
+ * answers anything it cannot parse with `firing: false` — the same answer a
+ * healthy platform gives — so a rule outside this grammar is created
+ * successfully, shows enabled and green, and catches nothing. There is no
+ * later moment at which anybody finds out.
+ *
+ * The console's own placeholder used to read `cpu_percent > 90`, which is
+ * not one of these forms: the interface was suggesting an expression that
+ * could never fire. Keeping the grammar in one dependency-free module is
+ * what lets the form reject it before the rule exists, the evaluator report
+ * it if one slips through, and `omnitron doctor` find the ones already
+ * stored — all from the same list.
+ */
+/** Every expression form `evaluateExpression` recognises. */
+export declare const ALERT_EXPRESSION_FORMS: readonly [RegExp, RegExp, RegExp, RegExp];
+/** Human-readable grammar, for a message that has to tell someone what to type. */
+export declare const ALERT_EXPRESSION_HELP = "app.<name|*>.status != <status> \u00B7 app.<name|*>.<cpu|memory> <op> <number> \u00B7 infra.<name|*>.health != <status> \u00B7 host.disk.free <op> <bytes>";
+/** Whether the evaluator can read this expression at all. */
+export declare function isAlertExpressionParseable(expression: string): boolean;
+/** Ascending: a threshold of `warning` notifies for `warning` and `critical`. */
+export declare const ALERT_SEVERITIES: readonly ['info', 'warning', 'critical'];
+export type AlertSeverity = (typeof ALERT_SEVERITIES)[number];
+export declare function severityRank(severity: string): number;
+/**
+ * What a rule watches, read off its expression — a state (`health`) or a
+ * figure (`metric`). It used to be chosen in the form, beside the expression
+ * that already said it, and nothing read the choice: a rule could be filed
+ * as `log`, a kind the grammar has no form for.
+ */
+export declare function alertRuleTypeOf(expression: string): 'metric' | 'health' | null;
+export declare const ALERT_RULE_LIMITS: {
+    readonly name: 100;
+    readonly expression: 200;
+    readonly summary: 500;
+    readonly forDuration: 86400;
+};
+export interface AlertRuleFields {
+    name: string;
+    expression: string;
+    severity: AlertSeverity;
+    /** Seconds the condition must hold before the alert fires; null fires at once. */
+    forDuration: number | null;
+    /** The sentence the alert is listed with; null lists the expression and its value. */
+    summary: string | null;
+    enabled: boolean;
+}
+/**
+ * The fields of a rule as a client sends them, checked and normalised — one
+ * function for the console's form and for the daemon, so the two cannot
+ * drift. `partial` reads an update: absent fields stay absent. Every problem
+ * is named, one per field.
+ */
+export declare function readAlertRuleFields(input: unknown, partial: boolean): {
+    fields: Partial<AlertRuleFields>;
+    problems: string[];
+};
+//# sourceMappingURL=alert-expression.d.ts.map

package/dist/shared/alert-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-expression.d.ts","sourceRoot":"","sources":["../../src/shared/alert-expression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,2CAMzB,CAAC;AAEX,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,+JAC6G,CAAC;AAEhJ,6DAA6D;AAC7D,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGtE;AAMD,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,YAAI,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AACzE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAK9E;AAED,eAAO,MAAM,iBAAiB;aAAK,IAAI,EAAE,GAAG;aAAE,UAAU,EAAE,GAAG;aAAE,OAAO,EAAE,GAAG;aAAE,WAAW,EAAE,KAAM;CAAW,CAAC;AAE5G,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,kFAAkF;IAClF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sFAAsF;IACtF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACf;IAAE,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA4C1D"}

package/dist/shared/alert-expression.js

@@ -0,0 +1,124 @@
+/**
+ * The alert expressions this platform can evaluate.
+ *
+ * Shared between the daemon and the console on purpose. The evaluator
+ * answers anything it cannot parse with `firing: false` — the same answer a
+ * healthy platform gives — so a rule outside this grammar is created
+ * successfully, shows enabled and green, and catches nothing. There is no
+ * later moment at which anybody finds out.
+ *
+ * The console's own placeholder used to read `cpu_percent > 90`, which is
+ * not one of these forms: the interface was suggesting an expression that
+ * could never fire. Keeping the grammar in one dependency-free module is
+ * what lets the form reject it before the rule exists, the evaluator report
+ * it if one slips through, and `omnitron doctor` find the ones already
+ * stored — all from the same list.
+ */
+/** Every expression form `evaluateExpression` recognises. */
+export const ALERT_EXPRESSION_FORMS = [
+    /^app\.(\*|[\w-]+)\.status\s*(!=|==)\s*(\w+)$/,
+    /^app\.(\*|[\w-]+)\.(cpu|memory)\s*(>|<|>=|<=)\s*(\d+)$/,
+    /^infra\.(\*|[\w-]+)\.health\s*(!=|==)\s*(\w+)$/,
+    // Bytes free on the host's own disk (monitoring/host-disk.ts).
+    /^host\.disk\.free\s*(>|<|>=|<=)\s*(\d+)$/,
+];
+/** Human-readable grammar, for a message that has to tell someone what to type. */
+export const ALERT_EXPRESSION_HELP = 'app.<name|*>.status != <status> · app.<name|*>.<cpu|memory> <op> <number> · infra.<name|*>.health != <status> · host.disk.free <op> <bytes>';
+/** Whether the evaluator can read this expression at all. */
+export function isAlertExpressionParseable(expression) {
+    const trimmed = expression.trim();
+    return ALERT_EXPRESSION_FORMS.some((form) => form.test(trimmed));
+}
+// =============================================================================
+// Rules — what a rule is made of, checked the same way in the form and the daemon
+// =============================================================================
+/** Ascending: a threshold of `warning` notifies for `warning` and `critical`. */
+export const ALERT_SEVERITIES = ['info', 'warning', 'critical'];
+export function severityRank(severity) {
+    return ALERT_SEVERITIES.indexOf(severity);
+}
+/**
+ * What a rule watches, read off its expression — a state (`health`) or a
+ * figure (`metric`). It used to be chosen in the form, beside the expression
+ * that already said it, and nothing read the choice: a rule could be filed
+ * as `log`, a kind the grammar has no form for.
+ */
+export function alertRuleTypeOf(expression) {
+    const trimmed = expression.trim();
+    if (ALERT_EXPRESSION_FORMS[1].test(trimmed) || ALERT_EXPRESSION_FORMS[3].test(trimmed))
+        return 'metric';
+    if (ALERT_EXPRESSION_FORMS[0].test(trimmed) || ALERT_EXPRESSION_FORMS[2].test(trimmed))
+        return 'health';
+    return null;
+}
+export const ALERT_RULE_LIMITS = { name: 100, expression: 200, summary: 500, forDuration: 86_400 };
+/**
+ * The fields of a rule as a client sends them, checked and normalised — one
+ * function for the console's form and for the daemon, so the two cannot
+ * drift. `partial` reads an update: absent fields stay absent. Every problem
+ * is named, one per field.
+ */
+export function readAlertRuleFields(input, partial) {
+    const raw = (input !== null && typeof input === 'object' ? input : {});
+    const fields = {};
+    const problems = [];
+    const present = (key) => raw[key] !== undefined;
+    if (present('name') || !partial) {
+        const name = typeof raw['name'] === 'string' ? raw['name'].trim() : '';
+        if (name.length === 0 || name.length > ALERT_RULE_LIMITS.name) {
+            problems.push(`name: 1 to ${ALERT_RULE_LIMITS.name} characters`);
+        }
+        else
+            fields.name = name;
+    }
+    if (present('expression') || !partial) {
+        const expression = typeof raw['expression'] === 'string' ? raw['expression'].trim() : '';
+        if (expression.length > ALERT_RULE_LIMITS.expression || !isAlertExpressionParseable(expression)) {
+            problems.push(`expression: not one the evaluator reads — ${ALERT_EXPRESSION_HELP}`);
+        }
+        else
+            fields.expression = expression;
+    }
+    if (present('severity') || !partial) {
+        const severity = raw['severity'];
+        if (typeof severity !== 'string' || severityRank(severity) < 0) {
+            problems.push(`severity: one of ${ALERT_SEVERITIES.join(', ')}`);
+        }
+        else
+            fields.severity = severity;
+    }
+    if (present('forDuration')) {
+        const seconds = raw['forDuration'];
+        if (seconds === null)
+            fields.forDuration = null;
+        else if (typeof seconds !== 'number' || !Number.isInteger(seconds) || seconds < 0 || seconds > ALERT_RULE_LIMITS.forDuration) {
+            problems.push(`forDuration: whole seconds from 0 to ${ALERT_RULE_LIMITS.forDuration}, or null`);
+        }
+        else
+            fields.forDuration = seconds === 0 ? null : seconds;
+    }
+    else if (!partial)
+        fields.forDuration = null;
+    if (present('summary')) {
+        const summary = raw['summary'];
+        if (summary === null || (typeof summary === 'string' && summary.trim() === ''))
+            fields.summary = null;
+        else if (typeof summary !== 'string' || summary.trim().length > ALERT_RULE_LIMITS.summary) {
+            problems.push(`summary: at most ${ALERT_RULE_LIMITS.summary} characters`);
+        }
+        else
+            fields.summary = summary.trim();
+    }
+    else if (!partial)
+        fields.summary = null;
+    if (present('enabled')) {
+        if (typeof raw['enabled'] !== 'boolean')
+            problems.push('enabled: true or false');
+        else
+            fields.enabled = raw['enabled'];
+    }
+    else if (!partial)
+        fields.enabled = true;
+    return { fields, problems };
+}
+//# sourceMappingURL=alert-expression.js.map

package/dist/shared/alert-expression.js.map

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

package/dist/shared/audit-outcome.d.ts

@@ -0,0 +1,39 @@
+/**
+ * How an audit row's action ended — one reading for `omnitron audit`, which
+ * colours it, and the console's audit page, which showed none: its rows
+ * carried `outcome=partial` as one more `key=value` among the details, so a
+ * stack start in which apps did not come up read like any other.
+ *
+ * Imported by the console through `@omnitron-dev/omnitron/audit-outcome`, so
+ * nothing here may need Node.
+ */
+/** `partial`: the action happened, and not all of it — a stack start where some apps did not come up. */
+export type AuditOutcome = 'ok' | 'partial' | 'failed';
+/** The part of an audit row its ending is read from. */
+export interface OutcomeFields {
+    readonly action: string;
+    readonly details?: Readonly<Record<string, unknown>> | null | undefined;
+}
+/**
+ * How a row's action ended, as far as the row says: its recorded outcome, or
+ * `failed` for an action named as a failure (`node.upgrade.failed`). `null`
+ * for a row that records neither — most rows, written after an action that
+ * worked by a writer that records nothing else; `null` says that without
+ * claiming more.
+ */
+export declare function outcomeOf(row: OutcomeFields): AuditOutcome | null;
+/** What a row says of its ending beyond the word, and the `details` key it said it under. */
+export interface OutcomeReason {
+    readonly key: string;
+    readonly text: string;
+}
+/**
+ * Why a row ended the way it did, when it says: for `partial`, what did not
+ * come up (`details.notUp`, as `stack.start` records it); for `failed`, what
+ * went wrong (`details.error`, or `details.message` in the older rows that
+ * named the failure in the action). `null` when the row says nothing more.
+ *
+ * With its key, so a reader listing the rest of `details` need not repeat it.
+ */
+export declare function outcomeReason(row: OutcomeFields): OutcomeReason | null;
+//# sourceMappingURL=audit-outcome.d.ts.map

package/dist/shared/audit-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-outcome.d.ts","sourceRoot":"","sources":["../../src/shared/audit-outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yGAAyG;AACzG,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CACzE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAIjE;AAED,6FAA6F;AAC7F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI,CAatE"}

package/dist/shared/audit-outcome.js

@@ -0,0 +1,45 @@
+/**
+ * How an audit row's action ended — one reading for `omnitron audit`, which
+ * colours it, and the console's audit page, which showed none: its rows
+ * carried `outcome=partial` as one more `key=value` among the details, so a
+ * stack start in which apps did not come up read like any other.
+ *
+ * Imported by the console through `@omnitron-dev/omnitron/audit-outcome`, so
+ * nothing here may need Node.
+ */
+/**
+ * How a row's action ended, as far as the row says: its recorded outcome, or
+ * `failed` for an action named as a failure (`node.upgrade.failed`). `null`
+ * for a row that records neither — most rows, written after an action that
+ * worked by a writer that records nothing else; `null` says that without
+ * claiming more.
+ */
+export function outcomeOf(row) {
+    const recorded = row.details?.['outcome'];
+    if (recorded === 'ok' || recorded === 'partial' || recorded === 'failed')
+        return recorded;
+    return row.action.endsWith('.failed') ? 'failed' : null;
+}
+/**
+ * Why a row ended the way it did, when it says: for `partial`, what did not
+ * come up (`details.notUp`, as `stack.start` records it); for `failed`, what
+ * went wrong (`details.error`, or `details.message` in the older rows that
+ * named the failure in the action). `null` when the row says nothing more.
+ *
+ * With its key, so a reader listing the rest of `details` need not repeat it.
+ */
+export function outcomeReason(row) {
+    const said = (key, words = (text) => text) => {
+        const value = row.details?.[key];
+        return typeof value === 'string' && value !== '' ? { key, text: words(value) } : null;
+    };
+    switch (outcomeOf(row)) {
+        case 'partial':
+            return said('notUp', (apps) => `not up: ${apps}`);
+        case 'failed':
+            return said('error') ?? said('message');
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=audit-outcome.js.map

package/dist/shared/audit-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-outcome.js","sourceRoot":"","sources":["../../src/shared/audit-outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAkB;IAC1C,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC1F,OAAO,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAQD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,GAAkB;IAC9C,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,KAAK,GAA6B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAwB,EAAE;QACnG,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxF,CAAC,CAAC;IACF,QAAQ,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/shared/build-freshness.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Is the code that is running the code that was written?
+ *
+ * Every package here resolves through `dist`, and nothing checks that `dist`
+ * corresponds to `src`. Both test suites can be green while the application
+ * runs a build from months ago — the package's tests exercise `src`, the
+ * application's exercise `dist`, and neither one asks whether they are the
+ * same program. A change lands, the suite passes, and the change was never
+ * executed.
+ *
+ * That is not hypothetical. It was found by adding an export to a package's
+ * `src/index.ts` and watching a test keep failing with "is not a constructor"
+ * against a build four months old. And this daemon reproduces it in the small:
+ * it starts from `dist/`, so a rebuild after it started leaves it running code
+ * that no longer exists on disk.
+ *
+ * mtime is a proxy and it is a noisy one — copying a file back over itself
+ * marks it modified without changing a byte. The asymmetry is what justifies
+ * it: a false "rebuild needed" costs a rebuild, a false "all fresh" costs a
+ * session spent verifying the wrong program.
+ */
+export interface TreeEntry {
+    /** Path relative to the tree root, e.g. `services/backup.service.ts`. */
+    rel: string;
+    mtimeMs: number;
+}
+export interface FreshnessReport {
+    /** Sources whose build output is older than they are. */
+    stale: string[];
+    /** Sources with no build output at all — a file added since the last build. */
+    unbuilt: string[];
+    /** Newest source mtime, or 0 when there are no sources. */
+    newestSourceMs: number;
+    /** Newest artifact mtime, or 0 when there are no artifacts. */
+    newestArtifactMs: number;
+    /** False when there was nothing to compare — the caller must not read a verdict into that. */
+    comparable: boolean;
+}
+/** `services/backup.service.ts` → `services/backup.service.js` */
+export declare function artifactFor(rel: string): string;
+/** Sources that are not compiled into the shipped tree, and must not be compared. */
+export declare function isCompiledSource(rel: string): boolean;
+/**
+ * Compare a source tree against a build tree.
+ *
+ * Pure: the caller supplies both listings, so the comparison can be tested
+ * without a filesystem and without a build.
+ */
+export declare function compareTrees(sources: TreeEntry[], artifacts: TreeEntry[]): FreshnessReport;
+/**
+ * Did the process start before the build it loaded was written?
+ *
+ * `null` when either timestamp is unknown — the same rule as `comparable`:
+ * an unanswerable question does not get answered "no".
+ */
+export declare function processPredatesBuild(processStartedMs: number, newestArtifactMs: number): boolean | null;
+/** Walk a directory, returning every file relative to it. Missing root → []. */
+export declare function listTree(root: string): TreeEntry[];
+//# sourceMappingURL=build-freshness.d.ts.map

package/dist/shared/build-freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-freshness.d.ts","sourceRoot":"","sources":["../../src/shared/build-freshness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,8FAA8F;IAC9F,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKrD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,eAAe,CA0B1F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAIvG;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAyBlD"}