@pristine-ts/observability 2.0.16

package/dist/lib/cjs/paths/observability-paths.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityPaths = void 0;
+const path = __importStar(require("path"));
+/**
+ * Resolves every path inside the observability store from the configured store directory.
+ * Pure and stateless past construction — instantiate once with the configured directory
+ * and reuse.
+ *
+ * Layout:
+ * ```
+ * <root>/
+ *   <instanceId>/logs.jsonl
+ *   <instanceId>/requests.jsonl
+ *   <instanceId>/traces/<traceId>.json
+ * ```
+ *
+ * Each `<instanceId>` is one pristine process lifetime (= the kernel instantiation id).
+ * No metadata sidecars, no `latest.json` pointer — directory `mtime` answers "which is
+ * most recent."
+ */
+class ObservabilityPaths {
+    constructor(configuredDirectory) {
+        this.root = path.isAbsolute(configuredDirectory)
+            ? configuredDirectory
+            : path.resolve(process.cwd(), configuredDirectory);
+    }
+    instanceDirectory(instanceId) {
+        return path.join(this.root, instanceId);
+    }
+    logsFile(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "logs.jsonl");
+    }
+    requestsFile(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "requests.jsonl");
+    }
+    tracesDirectory(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "traces");
+    }
+    traceFile(instanceId, traceId) {
+        return path.join(this.tracesDirectory(instanceId), `${traceId}.json`);
+    }
+}
+exports.ObservabilityPaths = ObservabilityPaths;
+//# sourceMappingURL=observability-paths.js.map

package/dist/lib/cjs/paths/observability-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-paths.js","sourceRoot":"","sources":["../../../../src/paths/observability-paths.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,kBAAkB;IAO7B,YAAY,mBAA2B;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC;YAC9C,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACvD,CAAC;IAED,iBAAiB,CAAC,UAAkB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC;IAED,YAAY,CAAC,UAAkB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACzE,CAAC;IAED,eAAe,CAAC,UAAkB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,SAAS,CAAC,UAAkB,EAAE,OAAe;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;IACxE,CAAC;CACF;AAhCD,gDAgCC"}

package/dist/lib/cjs/paths/paths.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./observability-paths"), exports);
+//# sourceMappingURL=paths.js.map

package/dist/lib/cjs/paths/paths.js.map

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

package/dist/lib/cjs/serializers/serialized-span.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=serialized-span.interface.js.map

package/dist/lib/cjs/serializers/serialized-span.interface.js.map

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

package/dist/lib/cjs/serializers/serialized-trace.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=serialized-trace.interface.js.map

package/dist/lib/cjs/serializers/serialized-trace.interface.js.map

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

package/dist/lib/cjs/serializers/serializers.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./span-deserializer"), exports);
+__exportStar(require("./trace-deserializer"), exports);
+//# sourceMappingURL=serializers.js.map

package/dist/lib/cjs/serializers/serializers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.js","sourceRoot":"","sources":["../../../../src/serializers/serializers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,uDAAqC"}

package/dist/lib/cjs/serializers/span-deserializer.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpanDeserializer = void 0;
+const common_1 = require("@pristine-ts/common");
+/**
+ * Rebuilds a `Span` (with its full child tree) from the stored plain object. Used by
+ * `TraceDeserializer` for the trace's root span and recursively for every descendant —
+ * so `traceRenderer.renderTree`/`renderFlat`, which call instance methods like
+ * `getDuration()`, work unchanged on stored traces.
+ */
+class SpanDeserializer {
+    static deserialize(serialized, trace) {
+        var _a, _b;
+        const span = new common_1.Span(serialized.keyname, serialized.id, (_a = serialized.context) !== null && _a !== void 0 ? _a : {});
+        span.trace = trace;
+        span.startDate = serialized.startDate;
+        span.endDate = serialized.endDate;
+        span.inProgress = serialized.endDate === undefined;
+        for (const child of (_b = serialized.children) !== null && _b !== void 0 ? _b : []) {
+            span.addChild(SpanDeserializer.deserialize(child, trace));
+        }
+        return span;
+    }
+}
+exports.SpanDeserializer = SpanDeserializer;
+//# sourceMappingURL=span-deserializer.js.map

package/dist/lib/cjs/serializers/span-deserializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-deserializer.js","sourceRoot":"","sources":["../../../../src/serializers/span-deserializer.ts"],"names":[],"mappings":";;;AAAA,gDAAgD;AAGhD;;;;;GAKG;AACH,MAAa,gBAAgB;IAC3B,MAAM,CAAC,WAAW,CAAC,UAA0B,EAAE,KAAY;;QACzD,MAAM,IAAI,GAAG,IAAI,aAAI,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,MAAA,UAAU,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC;QAEnD,KAAK,MAAM,KAAK,IAAI,MAAA,UAAU,CAAC,QAAQ,mCAAI,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAdD,4CAcC"}

package/dist/lib/cjs/serializers/trace-deserializer.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceDeserializer = void 0;
+const common_1 = require("@pristine-ts/common");
+const span_deserializer_1 = require("./span-deserializer");
+/**
+ * Rehydrates a stored trace JSON (the shape written by `ObservabilityTracer`) back into
+ * a `Trace` instance, with its full span tree rebuilt via `SpanDeserializer`.
+ */
+class TraceDeserializer {
+    static deserialize(serialized) {
+        var _a;
+        const trace = new common_1.Trace(serialized.id, (_a = serialized.context) !== null && _a !== void 0 ? _a : {});
+        trace.startDate = serialized.startDate;
+        trace.endDate = serialized.endDate;
+        trace.hasEnded = serialized.endDate !== undefined;
+        if (serialized.rootSpan !== undefined) {
+            trace.rootSpan = span_deserializer_1.SpanDeserializer.deserialize(serialized.rootSpan, trace);
+        }
+        return trace;
+    }
+}
+exports.TraceDeserializer = TraceDeserializer;
+//# sourceMappingURL=trace-deserializer.js.map

package/dist/lib/cjs/serializers/trace-deserializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-deserializer.js","sourceRoot":"","sources":["../../../../src/serializers/trace-deserializer.ts"],"names":[],"mappings":";;;AAAA,gDAA0C;AAE1C,2DAAqD;AAErD;;;GAGG;AACH,MAAa,iBAAiB;IAC5B,MAAM,CAAC,WAAW,CAAC,UAA2B;;QAC5C,MAAM,KAAK,GAAG,IAAI,cAAK,CAAC,UAAU,CAAC,EAAE,EAAE,MAAA,UAAU,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC;QACjE,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACvC,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QACnC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC;QAElD,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACtC,KAAK,CAAC,QAAQ,GAAG,oCAAgB,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAbD,8CAaC"}

package/dist/lib/cjs/store/log-store.js

@@ -0,0 +1,249 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var LogStore_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogStore = void 0;
+const fs = __importStar(require("fs"));
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const observability_module_keyname_1 = require("../observability.module.keyname");
+const observability_configuration_keys_1 = require("../observability.configuration-keys");
+const observability_paths_1 = require("../paths/observability-paths");
+const log_tailer_1 = require("../tailers/log-tailer");
+/**
+ * The read/write layer for captured logs. The `ObservabilityLogger` (a `Logger`-tagged
+ * transport) calls `append` on every log it sees. The CLI's `logs` command calls `read`
+ * / `tail` — addressed by event/trace/request id, never by a partition selector.
+ *
+ * Internally, each pristine process writes to its own per-process directory (keyed by
+ * the kernel instantiation id) so concurrent processes never race on the same file.
+ * That partition is invisible to callers: `read` walks every directory newest-first and
+ * concatenates; `tail` follows the most-recently-written directory.
+ *
+ * Singleton so both the writer (logger) and any reader resolved during the same
+ * process see the same in-memory state.
+ */
+let LogStore = LogStore_1 = class LogStore {
+    constructor(enabled, directory, retainedInstances, partitionId) {
+        this.enabled = enabled;
+        this.retainedInstances = retainedInstances;
+        this.partitionId = partitionId;
+        this.directoryEnsured = false;
+        this.pruned = false;
+        this.paths = new observability_paths_1.ObservabilityPaths(directory);
+    }
+    /**
+     * Whether capture is on. The `LoggerInterface` contract surfaces this through the
+     * adapter so `LogHandler` can skip dispatch entirely for disabled stores.
+     */
+    isCaptureEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Appends one log entry to the current process's `logs.jsonl`. No-op when
+     * observability is disabled.
+     *
+     * The on-disk shape is the JSON-serialized `LogModel` itself — `severity` stays a
+     * numeric `SeverityEnum`, `date` becomes an ISO string — so the `logs` command can
+     * round-trip through `PrettyLogFormatter`. Stringification is cycle-safe because
+     * `log.extra` routinely holds `Span`/`Trace` objects whose `parentSpan` ↔ `children`
+     * back-references would otherwise blow up a naive serializer.
+     */
+    append(log) {
+        if (this.enabled === false) {
+            return;
+        }
+        this.ensurePartitionDirectory();
+        const line = LogStore_1.safeStringify(log) + "\n";
+        fs.appendFileSync(this.paths.logsFile(this.partitionId), line);
+    }
+    /**
+     * Every captured log entry across every partition, in write order within each
+     * partition and partitions concatenated newest-first. When `id` is provided, only
+     * entries whose `traceId` / `eventId` / `requestId` match are returned — useful for
+     * `pristine logs <id>`.
+     */
+    read(id) {
+        const entries = [];
+        for (const partition of this.partitionsNewestFirst()) {
+            for (const entry of this.readJsonl(this.paths.logsFile(partition))) {
+                if (id === undefined || LogStore_1.entryMatchesId(entry, id)) {
+                    entries.push(entry);
+                }
+            }
+        }
+        return entries;
+    }
+    /**
+     * Follows the most-recently-written partition's `logs.jsonl`, emitting each newly-
+     * appended line until the returned handle's `stop()` is called. When `id` is
+     * provided, only matching entries surface. Returns a no-op handle when the store
+     * has no partitions yet.
+     */
+    tail(id, onLine) {
+        const partition = this.latestPartition();
+        if (partition === undefined) {
+            return { stop: () => undefined };
+        }
+        const tailer = new log_tailer_1.LogTailer(this.paths.logsFile(partition));
+        tailer.follow(line => {
+            if (id === undefined) {
+                onLine(line);
+                return;
+            }
+            try {
+                if (LogStore_1.entryMatchesId(JSON.parse(line), id)) {
+                    onLine(line);
+                }
+            }
+            catch (_a) {
+                // Skip malformed lines rather than aborting the follow.
+            }
+        });
+        return { stop: () => tailer.stop() };
+    }
+    ensurePartitionDirectory() {
+        if (this.directoryEnsured) {
+            return;
+        }
+        fs.mkdirSync(this.paths.instanceDirectory(this.partitionId), { recursive: true });
+        this.directoryEnsured = true;
+        this.pruneOldPartitions();
+    }
+    /**
+     * Drops partition directories beyond the retained limit, ordered by `mtime`. Once
+     * per process — additional appends are zero-cost. Best-effort: a failure to prune
+     * never blocks a write.
+     */
+    pruneOldPartitions() {
+        if (this.pruned) {
+            return;
+        }
+        this.pruned = true;
+        try {
+            const ordered = this.partitionsNewestFirst();
+            for (const stale of ordered.slice(Math.max(this.retainedInstances, 1))) {
+                fs.rmSync(this.paths.instanceDirectory(stale), { recursive: true, force: true });
+            }
+        }
+        catch (_a) {
+            // Best-effort.
+        }
+    }
+    partitionsNewestFirst() {
+        try {
+            return fs.readdirSync(this.paths.root, { withFileTypes: true })
+                .filter(entry => entry.isDirectory())
+                .map(entry => ({ name: entry.name, mtime: this.directoryMtime(entry.name) }))
+                .sort((a, b) => b.mtime - a.mtime)
+                .map(entry => entry.name);
+        }
+        catch (_a) {
+            return [];
+        }
+    }
+    latestPartition() {
+        return this.partitionsNewestFirst()[0];
+    }
+    directoryMtime(name) {
+        try {
+            return fs.statSync(this.paths.instanceDirectory(name)).mtimeMs;
+        }
+        catch (_a) {
+            return 0;
+        }
+    }
+    readJsonl(filePath) {
+        try {
+            return fs.readFileSync(filePath, "utf8")
+                .split("\n")
+                .filter(line => line.trim().length > 0)
+                .map(line => JSON.parse(line));
+        }
+        catch (_a) {
+            return [];
+        }
+    }
+    /**
+     * True when any of the entry's correlation fields match the requested id.
+     * `requestId` is checked too even though `LogModel` doesn't define it as a field
+     * today — JSON deserialization is permissive, so a custom mapper that does set it
+     * will round-trip and match.
+     */
+    static entryMatchesId(entry, id) {
+        return entry.traceId === id || entry.eventId === id || entry.requestId === id;
+    }
+    /**
+     * `JSON.stringify` with a cycle guard — an object seen earlier in the walk is rendered
+     * as `"[Circular]"` rather than recursed into. Faithful at any depth, and immune to the
+     * `Span.parentSpan` ↔ `Span.children` cycles common in `log.extra`.
+     */
+    static safeStringify(value) {
+        const seen = new WeakSet();
+        return JSON.stringify(value, (_key, val) => {
+            if (typeof val === "object" && val !== null) {
+                if (seen.has(val)) {
+                    return "[Circular]";
+                }
+                seen.add(val);
+            }
+            return val;
+        });
+    }
+};
+exports.LogStore = LogStore;
+exports.LogStore = LogStore = LogStore_1 = __decorate([
+    (0, common_1.moduleScoped)(observability_module_keyname_1.ObservabilityModuleKeyname),
+    (0, tsyringe_1.singleton)(),
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, common_1.injectConfig)(observability_configuration_keys_1.ObservabilityConfigurationKeys.Enabled)),
+    __param(1, (0, common_1.injectConfig)(observability_configuration_keys_1.ObservabilityConfigurationKeys.Directory)),
+    __param(2, (0, common_1.injectConfig)(observability_configuration_keys_1.ObservabilityConfigurationKeys.RetainedInstances)),
+    __param(3, (0, tsyringe_1.inject)(common_1.InternalContainerParameterEnum.KernelInstantiationId)),
+    __metadata("design:paramtypes", [Boolean, String, Number, String])
+], LogStore);
+//# sourceMappingURL=log-store.js.map

package/dist/lib/cjs/store/log-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-store.js","sourceRoot":"","sources":["../../../../src/store/log-store.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,uCAAuD;AACvD,gDAA+F;AAE/F,kFAA2E;AAC3E,0FAAmF;AACnF,sEAAgE;AAChE,sDAAgD;AAEhD;;;;;;;;;;;;GAYG;AAII,IAAM,QAAQ,gBAAd,MAAM,QAAQ;IAKnB,YACwD,OAAiC,EAC/B,SAAiB,EACT,iBAA0C,EAC5C,WAAoC;QAH3B,YAAO,GAAP,OAAO,CAAS;QAEN,sBAAiB,GAAjB,iBAAiB,CAAQ;QAC3B,gBAAW,GAAX,WAAW,CAAQ;QAP5F,qBAAgB,GAAG,KAAK,CAAC;QACzB,WAAM,GAAG,KAAK,CAAC;QAQrB,IAAI,CAAC,KAAK,GAAG,IAAI,wCAAkB,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,GAAa;QAClB,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,UAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAChD,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,EAAW;QACd,MAAM,OAAO,GAA0B,EAAE,CAAC;QAC1C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;YACrD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACnE,IAAI,EAAE,KAAK,SAAS,IAAI,UAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;oBAC3D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,EAAsB,EAAE,MAA8B;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,EAAC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAC,CAAC;QACjC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,sBAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YACnB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,CAAC;gBACb,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,UAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;oBAClD,MAAM,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC;YACH,CAAC;YAAC,WAAM,CAAC;gBACP,wDAAwD;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,EAAC,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAC,CAAC;IACrC,CAAC;IAEO,wBAAwB;QAC9B,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;QAChF,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACK,kBAAkB;QACxB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC7C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAAC,WAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAEO,qBAAqB;QAC3B,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAC,aAAa,EAAE,IAAI,EAAC,CAAC;iBAC1D,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;iBACpC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC;iBAC1E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;iBACjC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,eAAe;QACrB,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QACjE,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,QAAgB;QAChC,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC;iBACrC,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;iBACtC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwB,CAAC,CAAC;QAC1D,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,cAAc,CAAC,KAA0B,EAAE,EAAU;QAClE,OAAO,KAAK,CAAC,OAAO,KAAK,EAAE,IAAI,KAAK,CAAC,OAAO,KAAK,EAAE,IAAI,KAAK,CAAC,SAAS,KAAK,EAAE,CAAC;IAChF,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,aAAa,CAAC,KAAc;QACzC,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;QACnC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClB,OAAO,YAAY,CAAC;gBACtB,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAlLY,4BAAQ;mBAAR,QAAQ;IAHpB,IAAA,qBAAY,EAAC,yDAA0B,CAAC;IACxC,IAAA,oBAAS,GAAE;IACX,IAAA,qBAAU,GAAE;IAOR,WAAA,IAAA,qBAAY,EAAC,iEAA8B,CAAC,OAAO,CAAC,CAAA;IACpD,WAAA,IAAA,qBAAY,EAAC,iEAA8B,CAAC,SAAS,CAAC,CAAA;IACtD,WAAA,IAAA,qBAAY,EAAC,iEAA8B,CAAC,iBAAiB,CAAC,CAAA;IAC9D,WAAA,IAAA,iBAAM,EAAC,uCAA8B,CAAC,qBAAqB,CAAC,CAAA;;GATpD,QAAQ,CAkLpB"}

package/dist/lib/cjs/store/log-tailer.js

@@ -0,0 +1,110 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogTailer = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Follows a growing `.jsonl` file and emits each newly-appended complete line. The
+ * `logs --follow` command and the REPL use this for a `tail -f`-style live view.
+ *
+ * Watches the file's parent directory (watching a not-yet-created file directly is
+ * unreliable across platforms) and reads the byte delta on each change. Partial trailing
+ * lines are buffered until their terminating newline arrives.
+ *
+ * Not a DI service — a plain utility. Instantiate, `follow()`, and `stop()` when done.
+ */
+class LogTailer {
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.offset = 0;
+        this.buffer = "";
+    }
+    /**
+     * Starts following. Existing content is skipped — only lines appended after this call
+     * are emitted. Call `stop()` to release the watch.
+     */
+    follow(onLine) {
+        this.offset = fs.existsSync(this.filePath) ? fs.statSync(this.filePath).size : 0;
+        const directory = path.dirname(this.filePath);
+        const filename = path.basename(this.filePath);
+        this.watcher = fs.watch(directory, (_eventType, changed) => {
+            if (changed !== null && changed !== filename) {
+                return;
+            }
+            this.drain(onLine);
+        });
+    }
+    /**
+     * Stops following and releases the filesystem watch.
+     */
+    stop() {
+        var _a;
+        (_a = this.watcher) === null || _a === void 0 ? void 0 : _a.close();
+        this.watcher = undefined;
+    }
+    drain(onLine) {
+        var _a;
+        if (fs.existsSync(this.filePath) === false) {
+            return;
+        }
+        const size = fs.statSync(this.filePath).size;
+        if (size <= this.offset) {
+            // Truncated or unchanged — reset to the new end so we don't replay stale bytes.
+            this.offset = size;
+            return;
+        }
+        const fd = fs.openSync(this.filePath, "r");
+        try {
+            const length = size - this.offset;
+            const chunk = Buffer.alloc(length);
+            fs.readSync(fd, chunk, 0, length, this.offset);
+            this.offset = size;
+            this.buffer += chunk.toString("utf8");
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        const lines = this.buffer.split("\n");
+        this.buffer = (_a = lines.pop()) !== null && _a !== void 0 ? _a : "";
+        for (const line of lines) {
+            if (line.length > 0) {
+                onLine(line);
+            }
+        }
+    }
+}
+exports.LogTailer = LogTailer;
+//# sourceMappingURL=log-tailer.js.map

package/dist/lib/cjs/store/log-tailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-tailer.js","sourceRoot":"","sources":["../../../../src/store/log-tailer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAE7B;;;;;;;;;GASG;AACH,MAAa,SAAS;IAKpB,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAHrC,WAAM,GAAG,CAAC,CAAC;QACX,WAAM,GAAG,EAAE,CAAC;IAGpB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAA8B;QACnC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE;YACzD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7C,OAAO;YACT,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI;;QACF,MAAA,IAAI,CAAC,OAAO,0CAAE,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,MAA8B;;QAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;QAC7C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACxB,gFAAgF;YAChF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;YAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACnC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAA,KAAK,CAAC,GAAG,EAAE,mCAAI,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAjED,8BAiEC"}

package/dist/lib/cjs/store/observability-paths.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityPaths = void 0;
+const path = __importStar(require("path"));
+/**
+ * Resolves every path inside the observability store from the configured store directory.
+ * Pure and stateless past construction — instantiate once with the configured directory
+ * and reuse.
+ *
+ * Layout:
+ * ```
+ * <root>/
+ *   <instanceId>/logs.jsonl
+ *   <instanceId>/requests.jsonl
+ *   <instanceId>/traces/<traceId>.json
+ * ```
+ *
+ * Each `<instanceId>` is one pristine process lifetime (= the kernel instantiation id).
+ * No metadata sidecars, no `latest.json` pointer — directory `mtime` answers "which is
+ * most recent."
+ */
+class ObservabilityPaths {
+    constructor(configuredDirectory) {
+        this.root = path.isAbsolute(configuredDirectory)
+            ? configuredDirectory
+            : path.resolve(process.cwd(), configuredDirectory);
+    }
+    instanceDirectory(instanceId) {
+        return path.join(this.root, instanceId);
+    }
+    logsFile(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "logs.jsonl");
+    }
+    requestsFile(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "requests.jsonl");
+    }
+    tracesDirectory(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "traces");
+    }
+    traceFile(instanceId, traceId) {
+        return path.join(this.tracesDirectory(instanceId), `${traceId}.json`);
+    }
+}
+exports.ObservabilityPaths = ObservabilityPaths;
+//# sourceMappingURL=observability-paths.js.map