@omnitron-dev/omnitron 0.3.0 → 0.3.2

package/dist/monitoring/log-journal.d.ts

@@ -0,0 +1,40 @@
+export interface JournalItem<T> {
+    id: string;
+    digest: string;
+    value: T;
+}
+export interface LogFileIntent {
+    offset: number;
+    inode: number;
+    prefix: string;
+}
+export interface LogJournalStats {
+    pending: number;
+    assembling: number;
+    bytes: number;
+    error: string | null;
+}
+/** Private, restart-safe delivery journal. Unacknowledged records are never evicted. */
+export declare class LogJournal<T> {
+    readonly filename: string;
+    private readonly requireMirror;
+    private readonly db;
+    private error;
+    private recoveryError;
+    private lastRecovery;
+    private readonly writerIdentity;
+    constructor(filename: string, requireMirror?: boolean);
+    put(id: string, value: T, ready?: boolean): void;
+    peek(limit?: number, maxBytes?: number, consumer?: 'database' | 'file'): JournalItem<T>[];
+    /** A lost acknowledgment may be retried. A changed or unfinished record cannot be acknowledged. */
+    acknowledge(items: Array<Pick<JournalItem<T>, 'id' | 'digest'>>, consumer?: 'database' | 'file'): void;
+    fileIntent(id: string, file: string): LogFileIntent | undefined;
+    prepareFile(id: string, file: string, intent: LogFileIntent): void;
+    hasFileIntent(file: string): boolean;
+    importedFile(name: string): string | undefined;
+    importFile(name: string, digest: string, id: string, value: T): void;
+    stats(): LogJournalStats;
+    private recoverPending;
+    close(): void;
+}
+//# sourceMappingURL=log-journal.d.ts.map

package/dist/monitoring/log-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-journal.d.ts","sourceRoot":"","sources":["../../src/monitoring/log-journal.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW,CAAC,CAAC;IAAI,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE;AACxE,MAAM,WAAW,aAAa;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAChF,MAAM,WAAW,eAAe;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAE7G,wFAAwF;AACxF,qBAAa,UAAU,CAAC,CAAC;IAOX,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,OAAO,CAAC,QAAQ,CAAC,aAAa;IANrE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAwC;IAC3D,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,YAAqB,QAAQ,EAAE,MAAM,EAAmB,aAAa,UAAQ,EAgC5E;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,UAAO,GAAG,IAAI,CAgB5C;IAED,IAAI,CAAC,KAAK,SAAM,EAAE,QAAQ,SAAkB,EAAE,QAAQ,GAAE,UAAU,GAAG,MAAmB,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAe1G;IAED,mGAAmG;IACnG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAE,UAAU,GAAG,MAAmB,GAAG,IAAI,CAWjH;IAED,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE9D;IAED,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAGjE;IAED,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnC;IAED,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7C;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAUnE;IAED,KAAK,IAAI,eAAe,CAKvB;IAED,OAAO,CAAC,cAAc;IAkBtB,KAAK,IAAI,IAAI,CAAqB;CACnC"}

package/dist/monitoring/log-journal.js

@@ -0,0 +1,158 @@
+import { createHash, randomUUID } from 'node:crypto';
+import path from 'node:path';
+import { openSqliteDatabase } from '@omnitron-dev/titan-database/sqlite';
+import { ensurePrivateDir, sealSqliteFiles } from '../shared/private-files.js';
+import { readProcessLifetime } from './process-lifetime.js';
+import { compareProcessLifetimes } from '../shared/host-boot-identity.js';
+/** Private, restart-safe delivery journal. Unacknowledged records are never evicted. */
+export class LogJournal {
+    filename;
+    requireMirror;
+    db;
+    error = null;
+    recoveryError = null;
+    lastRecovery = -Infinity;
+    writerIdentity;
+    constructor(filename, requireMirror = false) {
+        this.filename = filename;
+        this.requireMirror = requireMirror;
+        const lifetime = readProcessLifetime(process.pid);
+        this.writerIdentity = lifetime.state === 'alive' ? lifetime.identity : `unverified:${randomUUID()}`;
+        if (filename !== ':memory:')
+            ensurePrivateDir(path.dirname(filename));
+        this.db = openSqliteDatabase(filename);
+        this.db.pragma('busy_timeout = 5000');
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = FULL');
+        this.db.exec(`CREATE TABLE IF NOT EXISTS records (
+      sequence INTEGER PRIMARY KEY AUTOINCREMENT, id TEXT NOT NULL UNIQUE,
+      payload TEXT NOT NULL, digest TEXT NOT NULL, writer INTEGER NOT NULL, delivered INTEGER NOT NULL DEFAULT 0, mirrored INTEGER NOT NULL DEFAULT 1, ready INTEGER NOT NULL CHECK(ready IN (0,1))
+    ); CREATE INDEX IF NOT EXISTS records_ready ON records(ready, sequence);`);
+        this.db.transaction(() => {
+            if (!this.db.pragma('table_info(records)').some(column => column.name === 'writer_identity')) {
+                this.db.exec('ALTER TABLE records ADD COLUMN writer_identity TEXT');
+            }
+        }).immediate();
+        this.db.exec(`CREATE TABLE IF NOT EXISTS file_intents (
+      id TEXT NOT NULL, file TEXT NOT NULL, offset INTEGER NOT NULL, inode INTEGER NOT NULL, prefix TEXT NOT NULL,
+      PRIMARY KEY(id,file)
+    );`);
+        this.db.exec('CREATE TABLE IF NOT EXISTS imported_files (name TEXT PRIMARY KEY, digest TEXT NOT NULL)');
+        this.recoverPending();
+        this.db.exec(`CREATE TABLE IF NOT EXISTS totals (singleton INTEGER PRIMARY KEY CHECK(singleton=1), pending INTEGER NOT NULL, assembling INTEGER NOT NULL, bytes INTEGER NOT NULL);
+      INSERT OR IGNORE INTO totals SELECT 1, COUNT(*), COALESCE(SUM(1-ready),0), COALESCE(SUM(LENGTH(CAST(payload AS BLOB))),0) FROM records;
+      CREATE TRIGGER IF NOT EXISTS log_added AFTER INSERT ON records BEGIN
+        UPDATE totals SET pending=pending+1, assembling=assembling+1-new.ready, bytes=bytes+LENGTH(CAST(new.payload AS BLOB)); END;
+      CREATE TRIGGER IF NOT EXISTS log_changed AFTER UPDATE ON records BEGIN
+        UPDATE totals SET assembling=assembling+old.ready-new.ready, bytes=bytes-LENGTH(CAST(old.payload AS BLOB))+LENGTH(CAST(new.payload AS BLOB)); END;
+      CREATE TRIGGER IF NOT EXISTS log_removed AFTER DELETE ON records BEGIN
+        UPDATE totals SET pending=pending-1, assembling=assembling-1+old.ready, bytes=bytes-LENGTH(CAST(old.payload AS BLOB)); END;`);
+        if (filename !== ':memory:')
+            sealSqliteFiles(filename);
+    }
+    put(id, value, ready = true) {
+        const payload = JSON.stringify(value);
+        const digest = createHash('sha256').update(payload).digest('hex');
+        try {
+            this.db.transaction(() => {
+                const old = this.db.prepare('SELECT ready, digest FROM records WHERE id = ?').get(id);
+                if (old?.ready && old.digest !== digest)
+                    throw new Error(`Immutable log identity conflict: ${id}`);
+                this.db.prepare(`INSERT INTO records(id, payload, digest, ready, writer, mirrored, writer_identity) VALUES (?, ?, ?, ?, ?, ?, ?)
+          ON CONFLICT(id) DO UPDATE SET payload=excluded.payload, digest=excluded.digest, ready=MAX(records.ready,excluded.ready)`)
+                    .run(id, payload, digest, ready ? 1 : 0, process.pid, this.requireMirror ? 0 : 1, this.writerIdentity);
+            })();
+            this.error = null;
+        }
+        catch (error) {
+            this.error = error instanceof Error ? error.message : String(error);
+            throw error;
+        }
+    }
+    peek(limit = 500, maxBytes = 2 * 1024 * 1024, consumer = 'database') {
+        this.recoverPending();
+        const result = [];
+        let bytes = 0;
+        for (const row of this.db.prepare(`SELECT id, payload, digest FROM records WHERE ready = 1 AND ${consumer === 'file' ? 'mirrored' : 'delivered'} = 0 ORDER BY sequence LIMIT ?`).iterate(limit)) {
+            const item = row;
+            if (createHash('sha256').update(item.payload).digest('hex') !== item.digest) {
+                this.error = `Captured log checksum mismatch: ${item.id}`;
+                throw new Error(this.error);
+            }
+            if (result.length && bytes + Buffer.byteLength(item.payload) > maxBytes)
+                break;
+            bytes += Buffer.byteLength(item.payload);
+            result.push({ id: item.id, digest: item.digest, value: JSON.parse(item.payload) });
+        }
+        return result;
+    }
+    /** A lost acknowledgment may be retried. A changed or unfinished record cannot be acknowledged. */
+    acknowledge(items, consumer = 'database') {
+        this.db.transaction(() => {
+            for (const item of items) {
+                const old = this.db.prepare('SELECT ready, digest FROM records WHERE id = ?').get(item.id);
+                if (!old)
+                    continue;
+                if (!old.ready || old.digest !== item.digest)
+                    throw new Error(`Log acknowledgment does not match captured bytes: ${item.id}`);
+                this.db.prepare(`UPDATE records SET ${consumer === 'file' ? 'mirrored' : 'delivered'} = 1 WHERE id = ?`).run(item.id);
+                this.db.prepare('DELETE FROM records WHERE id = ? AND mirrored = 1 AND delivered = 1').run(item.id);
+                if (consumer === 'file')
+                    this.db.prepare('DELETE FROM file_intents WHERE id = ?').run(item.id);
+            }
+        })();
+    }
+    fileIntent(id, file) {
+        return this.db.prepare('SELECT offset, inode, prefix FROM file_intents WHERE id = ? AND file = ?').get(id, file);
+    }
+    prepareFile(id, file, intent) {
+        this.db.prepare('INSERT INTO file_intents(id,file,offset,inode,prefix) VALUES(?,?,?,?,?)')
+            .run(id, file, intent.offset, intent.inode, intent.prefix);
+    }
+    hasFileIntent(file) {
+        return !!this.db.prepare('SELECT 1 FROM file_intents WHERE file = ? LIMIT 1').get(file);
+    }
+    importedFile(name) {
+        return this.db.prepare('SELECT digest FROM imported_files WHERE name = ?').get(name)?.digest;
+    }
+    importFile(name, digest, id, value) {
+        this.db.transaction(() => {
+            const previous = this.importedFile(name);
+            if (previous) {
+                if (previous !== digest)
+                    throw new Error(`Imported startup evidence changed: ${name}`);
+                return;
+            }
+            this.put(id, value);
+            this.db.prepare('INSERT INTO imported_files(name,digest) VALUES(?,?)').run(name, digest);
+        })();
+    }
+    stats() {
+        this.recoverPending();
+        const row = this.db.prepare('SELECT pending, assembling, bytes FROM totals WHERE singleton=1')
+            .get();
+        return { ...row, error: this.error ?? this.recoveryError };
+    }
+    recoverPending() {
+        if (Date.now() - this.lastRecovery < 5000)
+            return;
+        this.lastRecovery = Date.now();
+        this.recoveryError = null;
+        const writers = this.db.prepare('SELECT DISTINCT writer, writer_identity FROM records WHERE ready = 0').all();
+        for (const row of writers) {
+            if (row.writer === process.pid && row.writer_identity === this.writerIdentity)
+                continue;
+            const current = readProcessLifetime(row.writer);
+            const verifiedIdentity = row.writer_identity && !row.writer_identity.startsWith('unverified:');
+            const comparison = current.state === 'alive' && verifiedIdentity ? compareProcessLifetimes(row.writer_identity, current.identity) : 'unknown';
+            if (current.state === 'dead' || (current.state === 'alive' && comparison === 'different')) {
+                this.db.prepare('UPDATE records SET ready = 1 WHERE ready = 0 AND writer = ? AND writer_identity IS ?').run(row.writer, row.writer_identity);
+            }
+            else if (current.state === 'unknown' || !verifiedIdentity || comparison === 'unknown') {
+                this.recoveryError = `Unfinished logs retained: cannot verify the original writer lifetime for PID ${row.writer}`;
+            }
+        }
+    }
+    close() { this.db.close(); }
+}
+//# sourceMappingURL=log-journal.js.map

package/dist/monitoring/log-journal.js.map

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

package/dist/monitoring/log-line.d.ts

@@ -1,3 +1,5 @@
+import type { ProcessOutputContext } from '@omnitron-dev/titan-pm';
+export { LEVEL_RANK, UNKNOWN_LEVEL, levelRank, type KnownLevel } from '../shared/log-levels.js';
 /**
  * What one line of an application's output says about itself — the single
  * reading of a log line that every consumer of app output shares.
@@ -10,13 +12,13 @@
  *   - `LogCollectorService.ingestPinoLine` (the `logs` table)
  *   - `commands/logs.ts parseLine` (the file fallback)
  *
- * Measured 2026-09-23. paysys wrote pino-pretty. Its `app.log` held 95
+ * Measured 2026-09-23. payments wrote pino-pretty. Its `app.log` held 95
  * «Monero chain has not advanced» records at ERROR and `error.log` held none
  * of them; in the table all 88 such rows of the last day were `info`. On the
- * master, the test node's paysys had 3 `error` rows and 1 264 995 `info` rows
+ * master, the test node's payments had 3 `error` rows and 1 264 995 `info` rows
  * in a day, 1 216 292 of them the indented lines of multi-line dumps, each a
  * row of its own. And the time was stamped when the line was READ: `omnitron
- * logs paysys -f` printed 26 distinct lines 304 times in 7 seconds, because
+ * logs payments -f` printed 26 distinct lines 304 times in 7 seconds, because
  * every poll re-dated the same lines to the moment of the poll, and `--json
  * logs -n 200` returned 195 records dated at the query while the lines
  * themselves said 08:56:19–09:03:02.
@@ -46,14 +48,6 @@
  * line of its own (`fileLineOf`) carrying the level and time decided here,
  * and read back from there as the JSON it now is.
  */
-/** A level this module can name. Other JSON level strings are kept as written. */
-export type KnownLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
-/** Pino's numbers for the levels it names — the file and the filters speak these. */
-export declare const LEVEL_RANK: Readonly<Record<KnownLevel, number>>;
-/** The level of a line that says nothing about its level. */
-export declare const UNKNOWN_LEVEL = "unknown";
-/** The rank of a level, or `undefined` for one that has no place in the order. */
-export declare function levelRank(level: string): number | undefined;
 /**
  * The level a JSON record states.
  *
@@ -87,6 +81,15 @@ export type LineClass = {
 };
 /** A record: a line, or a header and the lines that continue it. */
 export interface LogRecord {
+    id?: string;
+    app?: string;
+    capture?: Omit<ProcessOutputContext, 'timeBasis'> & {
+        timeBasis: 'reported' | 'captured' | 'inferred' | 'observed';
+        reportedTime?: string | number;
+        continuationOf?: string;
+    };
+    /** Original timestamp string, including its supplied fractional precision. */
+    timestamp?: string;
     kind: 'json' | 'pretty' | 'text';
     level: string;
     /** Epoch ms: the record's own time, or the time it was captured. */
@@ -118,7 +121,7 @@ export declare function recordOf(klass: Exclude<LineClass, {
 /**
  * The line a record occupies in an app's log file.
  *
- * A JSON record is written exactly as the app wrote it. Anything else is
+ * A JSON record retains its fields and gains capture metadata. Anything else is
  * written as a JSON line of its own — the level this module read (absent when
  * unknown, so `jq 'select(.level >= 50)'` does not take a string for a number),
  * the time it decided, the text — because a raw line in a file carries no time
@@ -134,6 +137,9 @@ export interface LineAssemblerOptions {
      */
     idleMs?: number;
     now?: () => number;
+    /** Persist the current message BEFORE acknowledging any of its input lines. */
+    onPending?: (app: string, record: LogRecord) => void;
+    onError?: (error: unknown) => void;
 }
 /**
  * Joins the lines of a capture into records, in order, per key.
@@ -141,17 +147,17 @@ export interface LineAssemblerOptions {
  * A JSON line is a whole record and is delivered at once. A header or a plain
  * line is held until a line that is not its continuation arrives, or until
  * nothing has arrived for `idleMs` — then delivered with every indented line
- * after it. The key is what the caller can tell apart; the capture hands the
- * daemon an app's lines without saying which stream each came from, so that is
- * the app.
+ * after it. Capture identity isolates every process and stream; legacy callers
+ * without capture context are grouped by application.
  */
 export declare class LineAssembler {
     private readonly deliver;
+    private readonly options;
     private readonly held;
     private readonly idleMs;
     private readonly now;
     constructor(deliver: (key: string, record: LogRecord) => void, options?: LineAssemblerOptions);
-    push(key: string, line: string): void;
+    push(app: string, line: string, context?: ProcessOutputContext): void;
     /** Deliver every held record now — before a flush, a read, or shutdown. */
     sealAll(): void;
     dispose(): void;
@@ -159,7 +165,6 @@ export declare class LineAssembler {
     private hold;
     private arm;
     private seal;
-    private emit;
 }
 /**
  * Joins a file's lines into records while reading it BACKWARDS.

package/dist/monitoring/log-line.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-line.d.ts","sourceRoot":"","sources":["../../src/monitoring/log-line.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"log-line.d.ts","sourceRoot":"","sources":["../../src/monitoring/log-line.ts"],"names":[],"mappings":"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"}

package/dist/monitoring/log-line.js

@@ -1,3 +1,6 @@
+import { generateUuidV7 } from '@omnitron-dev/titan/utils';
+import { UNKNOWN_LEVEL, levelRank } from '../shared/log-levels.js';
+export { LEVEL_RANK, UNKNOWN_LEVEL, levelRank } from '../shared/log-levels.js';
 /**
  * What one line of an application's output says about itself — the single
  * reading of a log line that every consumer of app output shares.
@@ -10,13 +13,13 @@
  *   - `LogCollectorService.ingestPinoLine` (the `logs` table)
  *   - `commands/logs.ts parseLine` (the file fallback)
  *
- * Measured 2026-09-23. paysys wrote pino-pretty. Its `app.log` held 95
+ * Measured 2026-09-23. payments wrote pino-pretty. Its `app.log` held 95
  * «Monero chain has not advanced» records at ERROR and `error.log` held none
  * of them; in the table all 88 such rows of the last day were `info`. On the
- * master, the test node's paysys had 3 `error` rows and 1 264 995 `info` rows
+ * master, the test node's payments had 3 `error` rows and 1 264 995 `info` rows
  * in a day, 1 216 292 of them the indented lines of multi-line dumps, each a
  * row of its own. And the time was stamped when the line was READ: `omnitron
- * logs paysys -f` printed 26 distinct lines 304 times in 7 seconds, because
+ * logs payments -f` printed 26 distinct lines 304 times in 7 seconds, because
  * every poll re-dated the same lines to the moment of the poll, and `--json
  * logs -n 200` returned 195 records dated at the query while the lines
  * themselves said 08:56:19–09:03:02.
@@ -46,21 +49,6 @@
  * line of its own (`fileLineOf`) carrying the level and time decided here,
  * and read back from there as the JSON it now is.
  */
-/** Pino's numbers for the levels it names — the file and the filters speak these. */
-export const LEVEL_RANK = {
-    trace: 10,
-    debug: 20,
-    info: 30,
-    warn: 40,
-    error: 50,
-    fatal: 60,
-};
-/** The level of a line that says nothing about its level. */
-export const UNKNOWN_LEVEL = 'unknown';
-/** The rank of a level, or `undefined` for one that has no place in the order. */
-export function levelRank(level) {
-    return Object.prototype.hasOwnProperty.call(LEVEL_RANK, level) ? LEVEL_RANK[level] : undefined;
-}
 /**
  * The level a JSON record states.
  *
@@ -87,6 +75,8 @@ export function levelOf(value) {
         return value.trim().toLowerCase();
     return UNKNOWN_LEVEL;
 }
+// ESC is intentional: remove terminal colour sequences from stored log records.
+// eslint-disable-next-line no-control-regex
 const ANSI = /\u001b\[[0-9;]*m/g;
 /** Colour is for a terminal; in a record it is noise between the letters. */
 export function stripAnsi(text) {
@@ -239,11 +229,15 @@ export function recordOf(klass, line, reference) {
             };
         case 'text':
             return { kind: 'text', level: UNKNOWN_LEVEL, time: reference, timeFromLine: false, message: stripAnsi(raw), lines: 1 };
+        default: {
+            const unsupported = klass;
+            throw new TypeError(`Unsupported log record: ${JSON.stringify(unsupported)}`);
+        }
     }
 }
 /** A continuation line as it joins a record: colour stripped, indentation kept. */
 function continuationText(line) {
-    return stripAnsi(line.endsWith('\r') ? line.slice(0, -1) : line).trimEnd();
+    return stripAnsi(line.endsWith('\r') ? line.slice(0, -1) : line);
 }
 /** Trailing blank continuation lines end a dump, they are not part of it. */
 function trimRecord(record) {
@@ -254,7 +248,7 @@ function trimRecord(record) {
 /**
  * The line a record occupies in an app's log file.
  *
- * A JSON record is written exactly as the app wrote it. Anything else is
+ * A JSON record retains its fields and gains capture metadata. Anything else is
  * written as a JSON line of its own — the level this module read (absent when
  * unknown, so `jq 'select(.level >= 50)'` does not take a string for a number),
  * the time it decided, the text — because a raw line in a file carries no time
@@ -262,13 +256,19 @@ function trimRecord(record) {
  * module exists to end. `format` says what the app actually wrote.
  */
 export function fileLineOf(record) {
-    if (record.kind === 'json' && record.raw !== undefined)
+    if (record.kind === 'json' && record.raw !== undefined && !record.capture)
         return record.raw;
+    if (record.kind === 'json' && record.data)
+        return JSON.stringify({ ...record.data,
+            time: record.data['time'] ?? record.timestamp ?? new Date(record.time).toISOString(),
+            _omnitron: record.capture });
     const envelope = {};
     const rank = levelRank(record.level);
     if (rank !== undefined)
         envelope['level'] = rank;
-    envelope['time'] = new Date(record.time).toISOString();
+    envelope['time'] = record.timestamp ?? new Date(record.time).toISOString();
+    if (record.capture)
+        envelope['_omnitron'] = record.capture;
     envelope['msg'] = record.message;
     if (record.source)
         envelope['source'] = record.source;
@@ -288,34 +288,49 @@ const MAX_RECORD_CHARS = 256 * 1024;
  * A JSON line is a whole record and is delivered at once. A header or a plain
  * line is held until a line that is not its continuation arrives, or until
  * nothing has arrived for `idleMs` — then delivered with every indented line
- * after it. The key is what the caller can tell apart; the capture hands the
- * daemon an app's lines without saying which stream each came from, so that is
- * the app.
+ * after it. Capture identity isolates every process and stream; legacy callers
+ * without capture context are grouped by application.
  */
 export class LineAssembler {
     deliver;
+    options;
     held = new Map();
     idleMs;
     now;
     constructor(deliver, options = {}) {
         this.deliver = deliver;
+        this.options = options;
         this.idleMs = options.idleMs ?? 100;
         this.now = options.now ?? Date.now;
     }
-    push(key, line) {
-        const now = this.now();
+    push(app, line, context) {
+        const now = context ? Date.parse(context.capturedAt) : this.now();
+        const key = context ? JSON.stringify([app, context.processId, context.stream]) : app;
         const klass = classifyLine(line, now);
-        if (klass.kind === 'continuation') {
-            this.continueWith(key, line, now);
+        const held = this.held.get(key);
+        // Re-delivery after a consumer/storage failure must not append a line twice.
+        if (context && held?.lastId === context.id)
+            return;
+        if (!context?.fragmentOf && held && (klass.kind === 'continuation' || (klass.kind === 'text' && context?.stream === 'stderr' && held.record.kind === 'text'))) {
+            this.continueWith(key, line, now, context);
             return;
         }
         this.seal(key);
-        const record = recordOf(klass, line, now);
-        if (record.kind === 'json') {
-            this.emit(key, record);
+        const record = recordOf(klass.kind === 'continuation' ? { kind: 'text' } : klass, line, now);
+        const timeOnly = klass.kind === 'pretty' && /^\[\d{2}:/.test(stripAnsi(line));
+        const sourceTime = record.data?.['time'];
+        record.id = context?.id ?? generateUuidV7();
+        record.app = app;
+        record.timestamp = typeof sourceTime === 'string' && Number.isFinite(Date.parse(sourceTime))
+            ? sourceTime : new Date(record.time).toISOString();
+        record.capture = { ...(context ?? { id: record.id, processId: `collector:${process.pid}`, stream: 'stdout', sequence: 0,
+                capturedAt: new Date(now).toISOString() }), timeBasis: context?.timeBasis ?? (timeOnly ? 'inferred' : record.timeFromLine ? 'reported' : 'captured'),
+            ...(typeof sourceTime === 'string' || typeof sourceTime === 'number' ? { reportedTime: sourceTime } : {}) };
+        if (record.kind === 'json' || context?.fragmentOf) {
+            this.deliver(app, record);
             return;
         }
-        this.hold(key, record, now);
+        this.hold(key, record, now, context?.id);
     }
     /** Deliver every held record now — before a flush, a read, or shutdown. */
     sealAll() {
@@ -325,31 +340,29 @@ export class LineAssembler {
     dispose() {
         this.sealAll();
     }
-    continueWith(key, line, now) {
+    continueWith(key, line, now, context) {
         const text = continuationText(line);
         const held = this.held.get(key);
-        if (!held) {
-            // Nothing to continue: a JSON record is always one line, so an indented
-            // line after one — or at the start of a capture — is a record of its
-            // own. Further indented lines join it. A blank line is nothing at all.
-            if (text.trim() === '')
-                return;
-            this.hold(key, { kind: 'text', level: UNKNOWN_LEVEL, time: now, timeFromLine: false, message: text, lines: 1 }, now);
+        if (!held)
             return;
-        }
         if (held.chars + text.length + 1 > MAX_RECORD_CHARS) {
-            const { kind, level, time, timeFromLine, source } = held.record;
+            const next = { ...held.record, id: context?.id ?? generateUuidV7(), message: text, lines: 1 };
+            if (next.capture)
+                next.capture = { ...next.capture, id: next.id, continuationOf: next.capture.continuationOf ?? held.record.id };
             this.seal(key);
-            this.hold(key, { kind, level, time, timeFromLine, message: text, lines: 1, ...(source ? { source } : {}) }, now);
+            this.hold(key, next, now, context?.id);
             return;
         }
-        held.record.message += `\n${text}`;
-        held.record.lines += 1;
+        const next = { ...held.record, message: `${held.record.message}\n${text}`, lines: held.record.lines + 1 };
+        this.options.onPending?.(next.app ?? key, next);
+        held.record = next;
         held.chars += text.length + 1;
-        held.lastAt = now;
+        held.lastAt = this.now();
+        held.lastId = context?.id;
     }
-    hold(key, record, now) {
-        const held = { record, chars: record.message.length, lastAt: now, timer: null };
+    hold(key, record, _now, lastId) {
+        this.options.onPending?.(record.app ?? key, record);
+        const held = { record, chars: record.message.length, lastAt: this.now(), timer: null, lastId };
         this.held.set(key, held);
         this.arm(key, held, this.idleMs);
     }
@@ -364,8 +377,15 @@ export class LineAssembler {
                 if (this.held.get(key) !== held)
                     return;
                 const idle = this.now() - held.lastAt;
-                if (idle >= this.idleMs)
-                    this.seal(key);
+                if (idle >= this.idleMs) {
+                    try {
+                        this.seal(key);
+                    }
+                    catch (error) {
+                        this.options.onError?.(error);
+                        this.arm(key, held, 1000);
+                    }
+                }
                 else
                     this.arm(key, held, this.idleMs - idle);
             });
@@ -376,20 +396,11 @@ export class LineAssembler {
         const held = this.held.get(key);
         if (!held)
             return;
+        // Leave the held record available for retry until the consumer accepts it.
+        this.deliver(held.record.app ?? key, held.record);
         this.held.delete(key);
         if (held.timer)
             clearTimeout(held.timer);
-        this.emit(key, trimRecord(held.record));
-    }
-    emit(key, record) {
-        try {
-            this.deliver(key, record);
-        }
-        catch {
-            // A consumer's failure must not reach the capture path: a seal can fire
-            // from a timer, where a throw would be the daemon's uncaught exception.
-            // The orchestrator guards its handlers for the same reason.
-        }
     }
 }
 /**