@owlmeans/viable-log 0.1.18-rc.0

package/README.md

@@ -0,0 +1,15 @@
+<!-- owlmeans:agent-guidance:start -->
+## Agent guidance
+
+This package ships embedded agent skills under `agent-meta/`. After installing your
+`@owlmeans/*` packages, run the OwlMeans agent-skills installer to place them into
+your project's skill store (`.agents/skills/`):
+
+```sh
+npx @owlmeans/agent-skills@^0.1.18-rc.47
+```
+
+The embedded files are version-matched to this package release. Do not edit them
+directly — they are regenerated on each publish. To contribute guidance edits,
+open a PR against the source monorepo.
+<!-- owlmeans:agent-guidance:end -->

package/agent-meta/manifest.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 2,
+  "package": "@owlmeans/viable-log",
+  "version": "0.1.18-rc.0",
+  "generatedAt": "2026-10-03T20:03:44.509Z",
+  "canonicalRepo": "https://github.com/owlmeans/common",
+  "entries": [
+    {
+      "kind": "skill",
+      "name": "viable-log",
+      "category": "package-specific",
+      "file": "skills/viable-log/SKILL.md",
+      "canonicalPath": ".agents/skills/viable-log/SKILL.md"
+    }
+  ]
+}

package/agent-meta/skills/viable-log/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: viable-log
+description: How to use @owlmeans/viable-log — a generated (target) application's link to the OwlMeans Viable platform, as two @owlmeans/log plugins. viablePreviewPlugin sends the target web's analytics events to the manager frame through the preview reporter's channel; viableSlotPlugin writes the target backend's error records and analytics events as marked JSON stdout lines for the publisher to relay. Also the shared contract the platform reads them with (TARGET_EVENT_MARKER, parseTargetEventLine, PREVIEW_REPORTER_FLAG). Auto-invoked when wiring the platform link into a generated app's web or backend, importing viablePreviewPlugin, viableSlotPlugin or parseTargetEventLine, or changing how the preview reporter or the publisher takes events from a target.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/viable-log
+
+**Layer:** Domain (depends on `@owlmeans/log` only)
+**Install:** `"@owlmeans/viable-log": "^0.1.18-rc.0"` in `dependencies`
+
+The platform is "just one of the plugins" of a target's logging: a generated app logs through
+`@owlmeans/log`, and registers these two plugins so what it says reaches Viable. Both are inert
+wherever the platform is absent — a production runtime, a laptop, a framed-less page — so they are
+registered unconditionally.
+
+```ts
+// web: once, at startup
+addLogPlugin(viablePreviewPlugin())
+// backend (api, worker): once, at startup
+addLogPlugin(viableSlotPlugin())
+```
+
+| Plugin | Sends | Through | Active when |
+|---|---|---|---|
+| `viablePreviewPlugin()` | analytics events | `window[PREVIEW_REPORTER_FLAG].post` — the channel the publisher's injected reporter owns, which attaches the document's identity and posts to the manager frame | the page is a framed preview (the reporter installed the channel) |
+| `viableSlotPlugin()` | error-level records and analytics events | one stdout line per event: `TARGET_EVENT_MARKER` + JSON (`TargetEvent`) | the publisher that runs the process set `OWLMEANS_SLOT_EVENTS=1` |
+
+Errors in the **browser** need no plugin: a record carrying an `Error` reaches the reporter's own
+`console.error` hook through the logger's sink, exactly as a bare `console.error(error)` did.
+
+## The contract
+
+`parseTargetEventLine(line)` is how the platform's publisher reads a stdout line — **the input is
+untrusted, written by generated code**: the marker, JSON, version
+(`TARGET_EVENT_VERSION`), kind and level are checked, every text field is clipped, unknown fields are
+dropped. `targetEventLine(event)` writes one, cutting a stack and then data to stay under
+`TARGET_EVENT_MAX`. Change a field's shape only with a new `TARGET_EVENT_VERSION`. An application writes events only
+through `@owlmeans/log` (`log.error(…)`, or a call with an `analytics` option) — never by building a
+marked line or posting a preview message itself.

package/build/consts.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The property of the preview document's `window` that the platform's injected reporter claims.
+ * It holds the reporter's channel ({@link PreviewChannel}) once installed — in a framed preview
+ * only, never in a production runtime.
+ */
+export declare const PREVIEW_REPORTER_FLAG = "__owlmeansPreviewReporter";
+/** The `type` of a preview message that carries an analytics event. Mirrors `PreviewEventType.Analytics`. */
+export declare const PREVIEW_ANALYTICS_TYPE = "OWLMEANS_PREVIEW_ANALYTICS";
+/** The prefix of a stdout line that carries a {@link TargetEvent}. */
+export declare const TARGET_EVENT_MARKER = "[owl:event] ";
+/** Set to `1` by the platform's publisher in the environment of a target's backend process. */
+export declare const SLOT_EVENTS_ENV = "OWLMEANS_SLOT_EVENTS";
+/** Format version of {@link TargetEvent}. */
+export declare const TARGET_EVENT_VERSION = 1;
+/** The longest line a backend writes and the publisher accepts: a stack is cut, never a boundary. */
+export declare const TARGET_EVENT_MAX: number;
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,8BAA8B,CAAA;AAEhE,6GAA6G;AAC7G,eAAO,MAAM,sBAAsB,+BAA+B,CAAA;AAElE,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,iBAAiB,CAAA;AAEjD,+FAA+F;AAC/F,eAAO,MAAM,eAAe,yBAAyB,CAAA;AAErD,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,qGAAqG;AACrG,eAAO,MAAM,gBAAgB,QAAY,CAAA"}

package/build/consts.js

@@ -0,0 +1,17 @@
+/**
+ * The property of the preview document's `window` that the platform's injected reporter claims.
+ * It holds the reporter's channel ({@link PreviewChannel}) once installed — in a framed preview
+ * only, never in a production runtime.
+ */
+export const PREVIEW_REPORTER_FLAG = '__owlmeansPreviewReporter';
+/** The `type` of a preview message that carries an analytics event. Mirrors `PreviewEventType.Analytics`. */
+export const PREVIEW_ANALYTICS_TYPE = 'OWLMEANS_PREVIEW_ANALYTICS';
+/** The prefix of a stdout line that carries a {@link TargetEvent}. */
+export const TARGET_EVENT_MARKER = '[owl:event] ';
+/** Set to `1` by the platform's publisher in the environment of a target's backend process. */
+export const SLOT_EVENTS_ENV = 'OWLMEANS_SLOT_EVENTS';
+/** Format version of {@link TargetEvent}. */
+export const TARGET_EVENT_VERSION = 1;
+/** The longest line a backend writes and the publisher accepts: a stack is cut, never a boundary. */
+export const TARGET_EVENT_MAX = 16 * 1024;
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAA;AAEhE,6GAA6G;AAC7G,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAA;AAElE,sEAAsE;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAA;AAEjD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAA;AAErD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAErC,qGAAqG;AACrG,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,CAAA"}

package/build/event.d.ts

@@ -0,0 +1,10 @@
+import type { TargetEvent } from './types.js';
+/** The stdout line of an event. Over-long ones lose their stack, then their data — never their head. */
+export declare const targetEventLine: (event: TargetEvent) => string;
+/**
+ * The event a stdout line carries, or `undefined` when the line is not one — absent marker, broken
+ * JSON, unknown version, or a shape the platform does not accept. The input is untrusted: it is
+ * written by generated code, and nothing outside this function may read fields of it unchecked.
+ */
+export declare const parseTargetEventLine: (line: string) => TargetEvent | undefined;
+//# sourceMappingURL=event.d.ts.map

package/build/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAI7C,wGAAwG;AACxG,eAAO,MAAM,eAAe,UAAW,WAAW,KAAG,MASpD,CAAA;AAKD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,SAAU,MAAM,KAAG,WAAW,GAAG,SAqCjE,CAAA"}

package/build/event.js

@@ -0,0 +1,58 @@
+import { TARGET_EVENT_MARKER, TARGET_EVENT_MAX, TARGET_EVENT_VERSION } from './consts.js';
+const LEVELS = ['debug', 'info', 'warn', 'error'];
+/** The stdout line of an event. Over-long ones lose their stack, then their data — never their head. */
+export const targetEventLine = (event) => {
+    let line = TARGET_EVENT_MARKER + JSON.stringify(event);
+    if (line.length > TARGET_EVENT_MAX && event.error?.stack != null) {
+        line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, error: { ...event.error, stack: undefined } });
+    }
+    if (line.length > TARGET_EVENT_MAX) {
+        line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, data: undefined });
+    }
+    return line.length > TARGET_EVENT_MAX ? line.slice(0, TARGET_EVENT_MAX) : line;
+};
+const text = (value, max) => typeof value === 'string' ? value.slice(0, max) : undefined;
+/**
+ * The event a stdout line carries, or `undefined` when the line is not one — absent marker, broken
+ * JSON, unknown version, or a shape the platform does not accept. The input is untrusted: it is
+ * written by generated code, and nothing outside this function may read fields of it unchecked.
+ */
+export const parseTargetEventLine = (line) => {
+    const at = line.indexOf(TARGET_EVENT_MARKER);
+    if (at < 0 || line.length > TARGET_EVENT_MAX + 64) {
+        return undefined;
+    }
+    let raw;
+    try {
+        raw = JSON.parse(line.slice(at + TARGET_EVENT_MARKER.length));
+    }
+    catch {
+        return undefined;
+    }
+    if (raw == null || typeof raw !== 'object') {
+        return undefined;
+    }
+    const event = raw;
+    if (event.v !== TARGET_EVENT_VERSION || (event.kind !== 'error' && event.kind !== 'analytics')
+        || typeof event.ts !== 'number' || !LEVELS.includes(event.level)) {
+        return undefined;
+    }
+    const error = event.error != null && typeof event.error === 'object' ? event.error : undefined;
+    return {
+        v: TARGET_EVENT_VERSION,
+        kind: event.kind,
+        ts: event.ts,
+        level: event.level,
+        scope: text(event.scope, 200) ?? 'target',
+        message: text(event.message, 2000) ?? '',
+        event: text(event.event, 200),
+        data: event.data,
+        error: error != null
+            ? {
+                name: text(error.name, 200) ?? 'Error', message: text(error.message, 2000) ?? '',
+                stack: text(error.stack, 8000), incidentId: text(error.incidentId, 100),
+            }
+            : undefined,
+    };
+};
+//# sourceMappingURL=event.js.map

package/build/event.js.map

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

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export type * from './types.js';
+export * from './consts.js';
+export * from './event.js';
+export * from './plugins.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/build/index.js

@@ -0,0 +1,4 @@
+export * from './consts.js';
+export * from './event.js';
+export * from './plugins.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/build/plugins.d.ts

@@ -0,0 +1,22 @@
+import type { LogPlugin } from '@owlmeans/log';
+import type { PreviewChannel } from './types.js';
+/** The reporter's channel of the current document, or `undefined` outside a framed preview. */
+export declare const previewChannel: () => PreviewChannel | undefined;
+/**
+ * The target web's link to the platform: analytics events go to the manager frame that embeds the
+ * preview, through the channel the platform's injected reporter owns.
+ *
+ * It is inert wherever that channel is absent — a production runtime, an unframed page, a server —
+ * so it is registered unconditionally and costs nothing for real users. Errors need no help from
+ * here: a record carrying an `Error` reaches the reporter's own `console.error` hook through the
+ * logger's console sink.
+ */
+export declare const viablePreviewPlugin: () => LogPlugin;
+/**
+ * The target backend's link to the platform. When the publisher that runs the process asks for it
+ * (`OWLMEANS_SLOT_EVENTS=1`), every error-level record and every analytics event becomes one marked
+ * JSON line on stdout; the publisher takes it from there. Elsewhere — a production pod, a laptop —
+ * the plugin does nothing.
+ */
+export declare const viableSlotPlugin: () => LogPlugin;
+//# sourceMappingURL=plugins.d.ts.map

package/build/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,eAAe,CAAA;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAA;AAE7D,+FAA+F;AAC/F,eAAO,MAAM,cAAc,QAAO,cAAc,GAAG,SAOlD,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,QAAO,SAKrC,CAAA;AAsBF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAO,SAyBnC,CAAA"}

package/build/plugins.js

@@ -0,0 +1,72 @@
+import { PREVIEW_ANALYTICS_TYPE, PREVIEW_REPORTER_FLAG, SLOT_EVENTS_ENV, TARGET_EVENT_VERSION } from './consts.js';
+import { targetEventLine } from './event.js';
+/** The reporter's channel of the current document, or `undefined` outside a framed preview. */
+export const previewChannel = () => {
+    if (typeof window === 'undefined') {
+        return undefined;
+    }
+    const channel = window[PREVIEW_REPORTER_FLAG];
+    return channel != null && typeof channel === 'object' && typeof channel.post === 'function'
+        ? channel : undefined;
+};
+/**
+ * The target web's link to the platform: analytics events go to the manager frame that embeds the
+ * preview, through the channel the platform's injected reporter owns.
+ *
+ * It is inert wherever that channel is absent — a production runtime, an unframed page, a server —
+ * so it is registered unconditionally and costs nothing for real users. Errors need no help from
+ * here: a record carrying an `Error` reaches the reporter's own `console.error` hook through the
+ * logger's console sink.
+ */
+export const viablePreviewPlugin = () => ({
+    name: 'viable-preview',
+    track: event => {
+        previewChannel()?.post(PREVIEW_ANALYTICS_TYPE, event);
+    },
+});
+const stdout = () => globalThis.process?.stdout;
+const slotEventsEnabled = () => globalThis.process?.env?.[SLOT_EVENTS_ENV] === '1';
+const errorOf = (record) => {
+    const error = record.error;
+    if (error == null) {
+        return undefined;
+    }
+    const incidentId = error.incidentId;
+    return {
+        name: error.name, message: error.message, stack: error.stack,
+        incidentId: typeof incidentId === 'string' ? incidentId : undefined,
+    };
+};
+/**
+ * The target backend's link to the platform. When the publisher that runs the process asks for it
+ * (`OWLMEANS_SLOT_EVENTS=1`), every error-level record and every analytics event becomes one marked
+ * JSON line on stdout; the publisher takes it from there. Elsewhere — a production pod, a laptop —
+ * the plugin does nothing.
+ */
+export const viableSlotPlugin = () => {
+    const emit = (event) => {
+        const out = stdout();
+        if (out != null && slotEventsEnabled()) {
+            out.write(`${targetEventLine(event)}\n`);
+        }
+    };
+    return {
+        name: 'viable-slot',
+        log: record => {
+            if (record.level !== 'error') {
+                return;
+            }
+            emit({
+                v: TARGET_EVENT_VERSION, kind: 'error', ts: record.time, level: 'error', scope: record.scope,
+                message: record.message, event: record.event, data: record.data, error: errorOf(record),
+            });
+        },
+        track: event => {
+            emit({
+                v: TARGET_EVENT_VERSION, kind: 'analytics', ts: event.time, level: event.level, scope: event.scope,
+                message: event.message, event: event.event, data: event.data,
+            });
+        },
+    };
+};
+//# sourceMappingURL=plugins.js.map

package/build/plugins.js.map

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

package/build/types.d.ts

@@ -0,0 +1,34 @@
+import type { AnalyticsEvent } from '@owlmeans/log';
+/** What a preview document's reporter offers a plugin: send one message to the manager frame. */
+export interface PreviewChannel {
+    v: number;
+    post: (type: string, payload: unknown) => void;
+}
+export type TargetEventKind = 'error' | 'analytics';
+/**
+ * One event of a target's BACKEND process, as a single stdout line (`TARGET_EVENT_MARKER` + JSON).
+ *
+ * The publisher runs the process, so the line is the only channel it needs: it is parsed there,
+ * kept out of the application's own output and relayed to the platform.
+ */
+export interface TargetEvent {
+    v: number;
+    kind: TargetEventKind;
+    /** Epoch milliseconds. */
+    ts: number;
+    level: 'debug' | 'info' | 'warn' | 'error';
+    scope: string;
+    message: string;
+    /** The analytics event name, or the `event` an error record carried. */
+    event?: string;
+    data?: unknown;
+    error?: {
+        name: string;
+        message: string;
+        stack?: string;
+        incidentId?: string;
+    };
+}
+/** The payload of a preview `Analytics` message (browser → manager). */
+export type PreviewAnalyticsPayload = AnalyticsEvent;
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/C;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,EAAE,eAAe,CAAA;IACrB,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/E;AAED,wEAAwE;AACxE,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAA"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@owlmeans/viable-log",
+  "version": "0.1.18-rc.0",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 2 && nodemon -e ts,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty",
+    "test": "bun test ./tests"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@owlmeans/log": "^0.1.18-rc.0"
+  },
+  "devDependencies": {
+    "@owlmeans/dep-config": "workspace:*",
+    "@types/bun": "^1.4.0",
+    "nodemon": "^3.1.14",
+    "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/consts.ts

@@ -0,0 +1,21 @@
+/**
+ * The property of the preview document's `window` that the platform's injected reporter claims.
+ * It holds the reporter's channel ({@link PreviewChannel}) once installed — in a framed preview
+ * only, never in a production runtime.
+ */
+export const PREVIEW_REPORTER_FLAG = '__owlmeansPreviewReporter'
+
+/** The `type` of a preview message that carries an analytics event. Mirrors `PreviewEventType.Analytics`. */
+export const PREVIEW_ANALYTICS_TYPE = 'OWLMEANS_PREVIEW_ANALYTICS'
+
+/** The prefix of a stdout line that carries a {@link TargetEvent}. */
+export const TARGET_EVENT_MARKER = '[owl:event] '
+
+/** Set to `1` by the platform's publisher in the environment of a target's backend process. */
+export const SLOT_EVENTS_ENV = 'OWLMEANS_SLOT_EVENTS'
+
+/** Format version of {@link TargetEvent}. */
+export const TARGET_EVENT_VERSION = 1
+
+/** The longest line a backend writes and the publisher accepts: a stack is cut, never a boundary. */
+export const TARGET_EVENT_MAX = 16 * 1024

package/src/event.ts

@@ -0,0 +1,63 @@
+import { TARGET_EVENT_MARKER, TARGET_EVENT_MAX, TARGET_EVENT_VERSION } from './consts.js'
+import type { TargetEvent } from './types.js'
+
+const LEVELS = ['debug', 'info', 'warn', 'error']
+
+/** The stdout line of an event. Over-long ones lose their stack, then their data — never their head. */
+export const targetEventLine = (event: TargetEvent): string => {
+  let line = TARGET_EVENT_MARKER + JSON.stringify(event)
+  if (line.length > TARGET_EVENT_MAX && event.error?.stack != null) {
+    line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, error: { ...event.error, stack: undefined } })
+  }
+  if (line.length > TARGET_EVENT_MAX) {
+    line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, data: undefined })
+  }
+  return line.length > TARGET_EVENT_MAX ? line.slice(0, TARGET_EVENT_MAX) : line
+}
+
+const text = (value: unknown, max: number): string | undefined =>
+  typeof value === 'string' ? value.slice(0, max) : undefined
+
+/**
+ * The event a stdout line carries, or `undefined` when the line is not one — absent marker, broken
+ * JSON, unknown version, or a shape the platform does not accept. The input is untrusted: it is
+ * written by generated code, and nothing outside this function may read fields of it unchecked.
+ */
+export const parseTargetEventLine = (line: string): TargetEvent | undefined => {
+  const at = line.indexOf(TARGET_EVENT_MARKER)
+  if (at < 0 || line.length > TARGET_EVENT_MAX + 64) {
+    return undefined
+  }
+  let raw: unknown
+  try {
+    raw = JSON.parse(line.slice(at + TARGET_EVENT_MARKER.length))
+  } catch {
+    return undefined
+  }
+  if (raw == null || typeof raw !== 'object') {
+    return undefined
+  }
+  const event = raw as Record<string, unknown>
+  if (event.v !== TARGET_EVENT_VERSION || (event.kind !== 'error' && event.kind !== 'analytics')
+    || typeof event.ts !== 'number' || !LEVELS.includes(event.level as string)) {
+    return undefined
+  }
+  const error = event.error != null && typeof event.error === 'object' ? event.error as Record<string, unknown> : undefined
+
+  return {
+    v: TARGET_EVENT_VERSION,
+    kind: event.kind,
+    ts: event.ts,
+    level: event.level as TargetEvent['level'],
+    scope: text(event.scope, 200) ?? 'target',
+    message: text(event.message, 2000) ?? '',
+    event: text(event.event, 200),
+    data: event.data,
+    error: error != null
+      ? {
+        name: text(error.name, 200) ?? 'Error', message: text(error.message, 2000) ?? '',
+        stack: text(error.stack, 8000), incidentId: text(error.incidentId, 100),
+      }
+      : undefined,
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+
+export type * from './types.js'
+export * from './consts.js'
+export * from './event.js'
+export * from './plugins.js'

package/src/plugins.ts

@@ -0,0 +1,83 @@
+import type { LogPlugin, LogRecord } from '@owlmeans/log'
+import { PREVIEW_ANALYTICS_TYPE, PREVIEW_REPORTER_FLAG, SLOT_EVENTS_ENV, TARGET_EVENT_VERSION } from './consts.js'
+import { targetEventLine } from './event.js'
+import type { PreviewChannel, TargetEvent } from './types.js'
+
+/** The reporter's channel of the current document, or `undefined` outside a framed preview. */
+export const previewChannel = (): PreviewChannel | undefined => {
+  if (typeof window === 'undefined') {
+    return undefined
+  }
+  const channel = (window as unknown as Record<string, unknown>)[PREVIEW_REPORTER_FLAG] as Partial<PreviewChannel> | undefined
+  return channel != null && typeof channel === 'object' && typeof channel.post === 'function'
+    ? channel as PreviewChannel : undefined
+}
+
+/**
+ * The target web's link to the platform: analytics events go to the manager frame that embeds the
+ * preview, through the channel the platform's injected reporter owns.
+ *
+ * It is inert wherever that channel is absent — a production runtime, an unframed page, a server —
+ * so it is registered unconditionally and costs nothing for real users. Errors need no help from
+ * here: a record carrying an `Error` reaches the reporter's own `console.error` hook through the
+ * logger's console sink.
+ */
+export const viablePreviewPlugin = (): LogPlugin => ({
+  name: 'viable-preview',
+  track: event => {
+    previewChannel()?.post(PREVIEW_ANALYTICS_TYPE, event)
+  },
+})
+
+interface Stdout { write: (chunk: string) => unknown }
+
+const stdout = (): Stdout | undefined =>
+  (globalThis as { process?: { stdout?: Stdout } }).process?.stdout
+
+const slotEventsEnabled = (): boolean =>
+  (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[SLOT_EVENTS_ENV] === '1'
+
+const errorOf = (record: LogRecord): TargetEvent['error'] => {
+  const error = record.error
+  if (error == null) {
+    return undefined
+  }
+  const incidentId = (error as { incidentId?: unknown }).incidentId
+  return {
+    name: error.name, message: error.message, stack: error.stack,
+    incidentId: typeof incidentId === 'string' ? incidentId : undefined,
+  }
+}
+
+/**
+ * The target backend's link to the platform. When the publisher that runs the process asks for it
+ * (`OWLMEANS_SLOT_EVENTS=1`), every error-level record and every analytics event becomes one marked
+ * JSON line on stdout; the publisher takes it from there. Elsewhere — a production pod, a laptop —
+ * the plugin does nothing.
+ */
+export const viableSlotPlugin = (): LogPlugin => {
+  const emit = (event: TargetEvent): void => {
+    const out = stdout()
+    if (out != null && slotEventsEnabled()) {
+      out.write(`${targetEventLine(event)}\n`)
+    }
+  }
+  return {
+    name: 'viable-slot',
+    log: record => {
+      if (record.level !== 'error') {
+        return
+      }
+      emit({
+        v: TARGET_EVENT_VERSION, kind: 'error', ts: record.time, level: 'error', scope: record.scope,
+        message: record.message, event: record.event, data: record.data, error: errorOf(record),
+      })
+    },
+    track: event => {
+      emit({
+        v: TARGET_EVENT_VERSION, kind: 'analytics', ts: event.time, level: event.level, scope: event.scope,
+        message: event.message, event: event.event, data: event.data,
+      })
+    },
+  }
+}

package/src/types.ts

@@ -0,0 +1,32 @@
+import type { AnalyticsEvent } from '@owlmeans/log'
+
+/** What a preview document's reporter offers a plugin: send one message to the manager frame. */
+export interface PreviewChannel {
+  v: number
+  post: (type: string, payload: unknown) => void
+}
+
+export type TargetEventKind = 'error' | 'analytics'
+
+/**
+ * One event of a target's BACKEND process, as a single stdout line (`TARGET_EVENT_MARKER` + JSON).
+ *
+ * The publisher runs the process, so the line is the only channel it needs: it is parsed there,
+ * kept out of the application's own output and relayed to the platform.
+ */
+export interface TargetEvent {
+  v: number
+  kind: TargetEventKind
+  /** Epoch milliseconds. */
+  ts: number
+  level: 'debug' | 'info' | 'warn' | 'error'
+  scope: string
+  message: string
+  /** The analytics event name, or the `event` an error record carried. */
+  event?: string
+  data?: unknown
+  error?: { name: string, message: string, stack?: string, incidentId?: string }
+}
+
+/** The payload of a preview `Analytics` message (browser → manager). */
+export type PreviewAnalyticsPayload = AnalyticsEvent

package/tests/viable-log.spec.ts

@@ -0,0 +1,112 @@
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
+import { addLogPlugin, logger, nativeConsole, resetLog } from '@owlmeans/log'
+import {
+  PREVIEW_ANALYTICS_TYPE, PREVIEW_REPORTER_FLAG, SLOT_EVENTS_ENV, TARGET_EVENT_MARKER, TARGET_EVENT_MAX,
+  parseTargetEventLine, targetEventLine, viablePreviewPlugin, viableSlotPlugin,
+} from '@owlmeans/viable-log'
+import type { TargetEvent } from '@owlmeans/viable-log'
+
+const sample = (patch: Partial<TargetEvent> = {}): TargetEvent => ({
+  v: 1, kind: 'error', ts: 1, level: 'error', scope: 'api', message: 'boom', ...patch,
+})
+
+describe('target event line', () => {
+  test('round-trips through targetEventLine and parseTargetEventLine', () => {
+    const event = sample({ data: { id: 1 }, error: { name: 'Error', message: 'x', stack: 's', incidentId: 'i' }, event: 'e' })
+    expect(parseTargetEventLine(targetEventLine(event))).toEqual(event)
+  })
+
+  test('finds the marker anywhere in a line (prefixed stdout)', () => {
+    expect(parseTargetEventLine(`12:00 ${targetEventLine(sample())}`)?.message).toBe('boom')
+  })
+
+  test('rejects a line without a marker, broken JSON, a wrong version or kind, a bad level', () => {
+    expect(parseTargetEventLine('plain')).toBeUndefined()
+    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}{nope`)).toBeUndefined()
+    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), v: 2 })}`)).toBeUndefined()
+    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), kind: 'x' })}`)).toBeUndefined()
+    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), level: 'fatal' })}`)).toBeUndefined()
+    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}null`)).toBeUndefined()
+  })
+
+  test('clips untrusted text fields and ignores unknown fields', () => {
+    const line = `${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), message: 'm'.repeat(5000), extra: 'x', scope: 7 })}`
+    const parsed = parseTargetEventLine(line)!
+    expect(parsed.message.length).toBe(2000)
+    expect(parsed.scope).toBe('target')
+    expect('extra' in parsed).toBe(false)
+  })
+
+  test('an over-long event loses its stack first, then its data, and stays under the cap', () => {
+    const stackless = targetEventLine(sample({ error: { name: 'E', message: 'm', stack: 's'.repeat(TARGET_EVENT_MAX * 2) } }))
+    expect(stackless.length).toBeLessThanOrEqual(TARGET_EVENT_MAX)
+    expect(parseTargetEventLine(stackless)?.error?.message).toBe('m')
+    const dataless = targetEventLine(sample({ data: 'd'.repeat(TARGET_EVENT_MAX * 2) }))
+    expect(dataless.length).toBeLessThanOrEqual(TARGET_EVENT_MAX)
+    expect(parseTargetEventLine(dataless)?.message).toBe('boom')
+  })
+})
+
+describe('viablePreviewPlugin', () => {
+  const win = globalThis as unknown as { window?: Record<string, unknown> }
+  beforeEach(() => { resetLog() })
+  afterEach(() => { delete win.window; resetLog() })
+
+  test('posts analytics events through the reporter channel', () => {
+    const posted: unknown[][] = []
+    win.window = { [PREVIEW_REPORTER_FLAG]: { v: 2, post: (...args: unknown[]) => posted.push(args) } }
+    addLogPlugin(viablePreviewPlugin())
+    logger('ui').info('Opened', { page: 'home' }, { analytics: 'page_view' })
+    expect(posted).toHaveLength(1)
+    expect(posted[0][0]).toBe(PREVIEW_ANALYTICS_TYPE)
+    expect(posted[0][1]).toMatchObject({ event: 'page_view', scope: 'ui', data: { page: 'home' } })
+  })
+
+  test('is inert without the channel — a flag that is a bare `true` is not a channel', () => {
+    addLogPlugin(viablePreviewPlugin())
+    expect(() => logger('ui').info('x', undefined, { analytics: true })).not.toThrow()
+    win.window = { [PREVIEW_REPORTER_FLAG]: true }
+    expect(() => logger('ui').info('x', undefined, { analytics: true })).not.toThrow()
+  })
+})
+
+describe('viableSlotPlugin', () => {
+  const written: string[] = []
+  const proc = globalThis.process
+  const realWrite = proc.stdout.write.bind(proc.stdout)
+  let saved: ReturnType<typeof nativeConsole>
+
+  beforeEach(() => {
+    resetLog()
+    written.length = 0
+    saved = { ...nativeConsole() }
+    for (const key of Object.keys(nativeConsole()) as (keyof ReturnType<typeof nativeConsole>)[]) nativeConsole()[key] = () => undefined
+    ;(proc.stdout as { write: unknown }).write = (chunk: string) => { written.push(String(chunk)); return true }
+  })
+  afterEach(() => {
+    ;(proc.stdout as { write: unknown }).write = realWrite
+    Object.assign(nativeConsole(), saved)
+    delete proc.env[SLOT_EVENTS_ENV]
+    resetLog()
+  })
+
+  test('writes nothing unless the publisher asked for it', () => {
+    addLogPlugin(viableSlotPlugin())
+    logger('api').error('boom', new Error('x'))
+    expect(written).toEqual([])
+  })
+
+  test('writes error records and analytics events as marked lines when asked', () => {
+    proc.env[SLOT_EVENTS_ENV] = '1'
+    addLogPlugin(viableSlotPlugin())
+    const error = Object.assign(new Error('db down'), { incidentId: 'inc-1' })
+    logger('api').error('Request failed', error)
+    logger('api').info('Signed up', { plan: 'free' }, { analytics: 'signup' })
+    logger('api').info('plain info')
+    logger('api').warn('plain warn')
+    const events = written.map(line => parseTargetEventLine(line)!)
+    expect(events.map(e => [e.kind, e.event ?? e.message])).toEqual([['error', 'Request failed'], ['analytics', 'signup']])
+    expect(events[0].error).toMatchObject({ name: 'Error', message: 'db down', incidentId: 'inc-1' })
+    expect(events[1].data).toEqual({ plan: 'free' })
+  })
+})

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": [
+    "@owlmeans/dep-config/tsconfig.base.json"
+  ],
+  "compilerOptions": {
+    "lib": ["ESNext", "DOM"],
+    "rootDir": "./src/",
+    "outDir": "./build/"
+  },
+  "exclude": ["./dist/**/*", "./build/**/*", "./tests/**/*", "./*.ts"]
+}