@better-openclaw/core 1.0.26 → 1.0.30

package/dist/logger/__tests__/logger.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.mjs","names":["expect"],"sources":["../../../src/logger/__tests__/logger.test.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, rmSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { OperationsLogger } from \"../logger.js\";\nimport { CallbackSink } from \"../sinks/callback-sink.js\";\nimport { ConsoleSink } from \"../sinks/console-sink.js\";\nimport { FileSink } from \"../sinks/file-sink.js\";\nimport type { OperationsLogEntry } from \"../types.js\";\n\ndescribe(\"OperationsLogger\", () => {\n\tit(\"creates log entries with auto-generated fields\", () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"cli\",\n\t\t\tsinks: [new CallbackSink((e) => entries.push(e))],\n\t\t});\n\n\t\tlogger.info(\"generation\", \"test message\", { key: \"value\" });\n\n\t\texpect(entries).toHaveLength(1);\n\t\tconst entry = entries[0];\n\t\texpect(entry.id).toBeTruthy();\n\t\texpect(entry.timestamp).toBeTruthy();\n\t\texpect(entry.source).toBe(\"cli\");\n\t\texpect(entry.correlationId).toBeTruthy();\n\t\texpect(entry.sessionId).toBeTruthy();\n\t\texpect(entry.level).toBe(\"info\");\n\t\texpect(entry.category).toBe(\"generation\");\n\t\texpect(entry.message).toBe(\"test message\");\n\t\texpect(entry.context).toEqual({ key: \"value\" });\n\t});\n\n\tit(\"respects minLevel filtering\", () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"api\",\n\t\t\tsinks: [new CallbackSink((e) => entries.push(e))],\n\t\t\tminLevel: \"warn\",\n\t\t});\n\n\t\tlogger.debug(\"system\", \"should be filtered\");\n\t\tlogger.info(\"system\", \"should be filtered\");\n\t\tlogger.warn(\"system\", \"should pass\");\n\t\tlogger.error(\"system\", \"should pass\");\n\n\t\texpect(entries).toHaveLength(2);\n\t\texpect(entries[0].level).toBe(\"warn\");\n\t\texpect(entries[1].level).toBe(\"error\");\n\t});\n\n\tit(\"child logger preserves correlationId and sessionId\", () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst sink = new CallbackSink((e) => entries.push(e));\n\t\tconst parent = new OperationsLogger({\n\t\t\tsource: \"cli\",\n\t\t\tsinks: [sink],\n\t\t\tcorrelationId: \"test-corr-id\",\n\t\t\tsessionId: \"test-sess-id\",\n\t\t});\n\n\t\tconst child = parent.child({ source: \"core\" });\n\t\tchild.info(\"generation\", \"child message\");\n\n\t\texpect(entries).toHaveLength(1);\n\t\texpect(entries[0].source).toBe(\"core\");\n\t\texpect(entries[0].correlationId).toBe(\"test-corr-id\");\n\t\texpect(entries[0].sessionId).toBe(\"test-sess-id\");\n\t});\n\n\tit(\"sanitizes sensitive context keys\", () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"api\",\n\t\t\tsinks: [new CallbackSink((e) => entries.push(e))],\n\t\t});\n\n\t\tlogger.info(\"deployment\", \"deploying\", {\n\t\t\tapiKey: \"sk-secret-123\",\n\t\t\tpassword: \"hunter2\",\n\t\t\ttoken: \"tok_abc\",\n\t\t\tprojectName: \"my-stack\",\n\t\t\turl: \"https://example.com\",\n\t\t});\n\n\t\tconst ctx = entries[0].context!;\n\t\texpect(ctx.apiKey).toBe(\"[REDACTED]\");\n\t\texpect(ctx.password).toBe(\"[REDACTED]\");\n\t\texpect(ctx.token).toBe(\"[REDACTED]\");\n\t\texpect(ctx.projectName).toBe(\"my-stack\");\n\t\texpect(ctx.url).toBe(\"https://example.com\");\n\t});\n\n\tit(\"error() logs error details\", () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"core\",\n\t\t\tsinks: [new CallbackSink((e) => entries.push(e))],\n\t\t});\n\n\t\tconst err = new Error(\"something broke\");\n\t\t(err as any).code = \"ECONNREFUSED\";\n\t\tlogger.error(\"deployment\", \"deploy failed\", err);\n\n\t\texpect(entries[0].level).toBe(\"error\");\n\t\texpect(entries[0].error?.name).toBe(\"Error\");\n\t\texpect(entries[0].error?.message).toBe(\"something broke\");\n\t\texpect(entries[0].error?.code).toBe(\"ECONNREFUSED\");\n\t\texpect(entries[0].error?.stack).toBeTruthy();\n\t});\n\n\tit(\"timed() logs start and success with duration\", async () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"cli\",\n\t\t\tsinks: [new CallbackSink((e) => entries.push(e))],\n\t\t});\n\n\t\tconst result = await logger.timed(\"generation\", \"generate stack\", async () => {\n\t\t\treturn 42;\n\t\t});\n\n\t\texpect(result).toBe(42);\n\t\texpect(entries).toHaveLength(2);\n\t\texpect(entries[0].outcome).toBe(\"in_progress\");\n\t\texpect(entries[1].outcome).toBe(\"success\");\n\t\texpect(entries[1].durationMs).toBeGreaterThanOrEqual(0);\n\t});\n\n\tit(\"timed() logs failure and re-throws\", async () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"api\",\n\t\t\tsinks: [new CallbackSink((e) => entries.push(e))],\n\t\t});\n\n\t\tawait expect(\n\t\t\tlogger.timed(\"deployment\", \"deploy\", async () => {\n\t\t\t\tthrow new Error(\"boom\");\n\t\t\t}),\n\t\t).rejects.toThrow(\"boom\");\n\n\t\texpect(entries).toHaveLength(2);\n\t\texpect(entries[0].outcome).toBe(\"in_progress\");\n\t\texpect(entries[1].outcome).toBe(\"failure\");\n\t\texpect(entries[1].error?.message).toBe(\"boom\");\n\t});\n\n\tit(\"silently handles sink errors\", () => {\n\t\tconst failingSink = {\n\t\t\twrite: () => {\n\t\t\t\tthrow new Error(\"sink exploded\");\n\t\t\t},\n\t\t};\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"cli\",\n\t\t\tsinks: [failingSink, new CallbackSink((e) => entries.push(e))],\n\t\t});\n\n\t\t// Should not throw — second sink should still receive the entry\n\t\tlogger.info(\"system\", \"test\");\n\t\texpect(entries).toHaveLength(1);\n\t});\n\n\tit(\"silently handles async sink errors\", () => {\n\t\tconst failingSink = {\n\t\t\twrite: () => Promise.reject(new Error(\"async boom\")),\n\t\t};\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"cli\",\n\t\t\tsinks: [failingSink, new CallbackSink((e) => entries.push(e))],\n\t\t});\n\n\t\t// Should not throw\n\t\tlogger.info(\"system\", \"test\");\n\t\texpect(entries).toHaveLength(1);\n\t});\n});\n\ndescribe(\"StepTracker\", () => {\n\tit(\"tracks steps and finalizes with summary\", () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"core\",\n\t\t\tsinks: [new CallbackSink((e) => entries.push(e))],\n\t\t});\n\n\t\tconst tracker = logger.createStepTracker(\"deployment\", \"Deploy to Dokploy\");\n\n\t\ttracker.begin(\"Find project\");\n\t\ttracker.complete(\"Project ID: abc123\");\n\n\t\ttracker.begin(\"Create compose service\");\n\t\ttracker.complete();\n\n\t\ttracker.skip(\"Set custom domain\", \"No domain configured\");\n\n\t\ttracker.begin(\"Trigger deployment\");\n\t\ttracker.complete();\n\n\t\tconst steps = tracker.finalize(\"success\");\n\n\t\texpect(steps).toHaveLength(4);\n\t\texpect(steps[0].name).toBe(\"Find project\");\n\t\texpect(steps[0].status).toBe(\"success\");\n\t\texpect(steps[0].detail).toBe(\"Project ID: abc123\");\n\t\texpect(steps[1].name).toBe(\"Create compose service\");\n\t\texpect(steps[1].status).toBe(\"success\");\n\t\texpect(steps[2].name).toBe(\"Set custom domain\");\n\t\texpect(steps[2].status).toBe(\"skipped\");\n\t\texpect(steps[3].name).toBe(\"Trigger deployment\");\n\t\texpect(steps[3].status).toBe(\"success\");\n\n\t\t// Summary entry should be logged\n\t\tconst summary = entries.find((e) => e.message === \"Deploy to Dokploy success\");\n\t\texpect(summary).toBeTruthy();\n\t\texpect(summary!.outcome).toBe(\"success\");\n\t\texpect(summary!.steps).toHaveLength(4);\n\t});\n\n\tit(\"auto-completes previous step when beginning a new one\", () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"core\",\n\t\t\tsinks: [new CallbackSink((e) => entries.push(e))],\n\t\t\tminLevel: \"info\", // filter out debug step logs\n\t\t});\n\n\t\tconst tracker = logger.createStepTracker(\"generation\", \"Generate\");\n\n\t\ttracker.begin(\"Step 1\");\n\t\ttracker.begin(\"Step 2\"); // should auto-complete Step 1\n\t\ttracker.begin(\"Step 3\"); // should auto-complete Step 2\n\n\t\tconst steps = tracker.finalize(\"success\");\n\t\texpect(steps[0].status).toBe(\"success\"); // auto-completed\n\t\texpect(steps[1].status).toBe(\"success\"); // auto-completed\n\t\texpect(steps[2].status).toBe(\"success\"); // closed by finalize\n\t});\n\n\tit(\"marks open step as failure when finalized with failure\", () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst logger = new OperationsLogger({\n\t\t\tsource: \"core\",\n\t\t\tsinks: [new CallbackSink((e) => entries.push(e))],\n\t\t});\n\n\t\tconst tracker = logger.createStepTracker(\"deployment\", \"Deploy\");\n\t\ttracker.begin(\"Connect\");\n\t\ttracker.fail(\"Connection refused\");\n\n\t\tconst steps = tracker.finalize(\"failure\");\n\t\texpect(steps[0].status).toBe(\"failure\");\n\t\texpect(steps[0].detail).toBe(\"Connection refused\");\n\t});\n});\n\ndescribe(\"ConsoleSink\", () => {\n\tit(\"writes formatted output to console\", () => {\n\t\tconst logSpy = vi.spyOn(console, \"log\").mockImplementation(() => {});\n\t\tconst sink = new ConsoleSink();\n\n\t\tsink.write({\n\t\t\tid: \"test-id\",\n\t\t\ttimestamp: \"2026-03-14T10:30:00.123Z\",\n\t\t\tlevel: \"info\",\n\t\t\tsource: \"cli\",\n\t\t\tcategory: \"generation\",\n\t\t\tmessage: \"Stack generated\",\n\t\t\toutcome: \"success\",\n\t\t\tcorrelationId: \"corr-1\",\n\t\t\tdurationMs: 150,\n\t\t});\n\n\t\texpect(logSpy).toHaveBeenCalledWith(\n\t\t\t\"[10:30:00] [INFO ] [cli] generation: Stack generated (success) [150ms]\",\n\t\t);\n\t\tlogSpy.mockRestore();\n\t});\n\n\tit(\"uses console.error for error level\", () => {\n\t\tconst errorSpy = vi.spyOn(console, \"error\").mockImplementation(() => {});\n\t\tconst sink = new ConsoleSink();\n\n\t\tsink.write({\n\t\t\tid: \"test-id\",\n\t\t\ttimestamp: \"2026-03-14T10:30:00.123Z\",\n\t\t\tlevel: \"error\",\n\t\t\tsource: \"api\",\n\t\t\tcategory: \"deployment\",\n\t\t\tmessage: \"Deploy failed\",\n\t\t\tcorrelationId: \"corr-1\",\n\t\t\terror: { name: \"Error\", message: \"timeout\" },\n\t\t});\n\n\t\texpect(errorSpy).toHaveBeenCalledTimes(2); // line + error detail\n\t\terrorSpy.mockRestore();\n\t});\n});\n\ndescribe(\"FileSink\", () => {\n\tlet testDir: string;\n\n\tbeforeEach(() => {\n\t\ttestDir = join(tmpdir(), `openclaw-test-logs-${Date.now()}`);\n\t\tmkdirSync(testDir, { recursive: true });\n\t});\n\n\tafterEach(() => {\n\t\tif (existsSync(testDir)) {\n\t\t\trmSync(testDir, { recursive: true, force: true });\n\t\t}\n\t});\n\n\tit(\"writes NDJSON entries to file\", () => {\n\t\tconst sink = new FileSink({ logDir: testDir, filename: \"test\" });\n\t\tconst entry: OperationsLogEntry = {\n\t\t\tid: \"test-1\",\n\t\t\ttimestamp: \"2026-03-14T10:30:00.123Z\",\n\t\t\tlevel: \"info\",\n\t\t\tsource: \"cli\",\n\t\t\tcategory: \"generation\",\n\t\t\tmessage: \"test entry\",\n\t\t\tcorrelationId: \"corr-1\",\n\t\t};\n\n\t\tsink.write(entry);\n\n\t\tconst logFile = join(testDir, \"test.log\");\n\t\texpect(existsSync(logFile)).toBe(true);\n\n\t\tconst content = readFileSync(logFile, \"utf-8\").trim();\n\t\tconst parsed = JSON.parse(content);\n\t\texpect(parsed.id).toBe(\"test-1\");\n\t\texpect(parsed.message).toBe(\"test entry\");\n\t});\n\n\tit(\"rotates files when size limit is exceeded\", () => {\n\t\tconst sink = new FileSink({\n\t\t\tlogDir: testDir,\n\t\t\tfilename: \"rot\",\n\t\t\tmaxFileSize: 200, // tiny limit for testing\n\t\t\tmaxFiles: 3,\n\t\t});\n\n\t\tconst entry: OperationsLogEntry = {\n\t\t\tid: \"x\",\n\t\t\ttimestamp: \"2026-03-14T10:30:00Z\",\n\t\t\tlevel: \"info\",\n\t\t\tsource: \"cli\",\n\t\t\tcategory: \"system\",\n\t\t\tmessage: \"a\".repeat(100), // each entry > 200 bytes as JSON\n\t\t\tcorrelationId: \"c\",\n\t\t};\n\n\t\t// Write enough entries to trigger rotation\n\t\tfor (let i = 0; i < 5; i++) {\n\t\t\tsink.write({ ...entry, id: `entry-${i}` });\n\t\t}\n\n\t\t// Should have created rotated files\n\t\tconst rotated1 = join(testDir, \"rot.1.log\");\n\t\texpect(existsSync(rotated1)).toBe(true);\n\t});\n});\n\ndescribe(\"CallbackSink\", () => {\n\tit(\"calls the provided function with each entry\", () => {\n\t\tconst entries: OperationsLogEntry[] = [];\n\t\tconst sink = new CallbackSink((e) => entries.push(e));\n\n\t\tconst entry: OperationsLogEntry = {\n\t\t\tid: \"test-1\",\n\t\t\ttimestamp: \"2026-03-14T10:30:00Z\",\n\t\t\tlevel: \"info\",\n\t\t\tsource: \"mcp\",\n\t\t\tcategory: \"mcp_tool_call\",\n\t\t\tmessage: \"generate-stack\",\n\t\t\tcorrelationId: \"c\",\n\t\t};\n\n\t\tsink.write(entry);\n\t\texpect(entries).toHaveLength(1);\n\t\texpect(entries[0]).toBe(entry);\n\t});\n});\n"],"mappings":"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"}

package/dist/logger/index.cjs

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_logger_logger = require("./logger.cjs");
+const require_logger_sinks_callback_sink = require("./sinks/callback-sink.cjs");
+const require_logger_sinks_console_sink = require("./sinks/console-sink.cjs");
+const require_logger_sinks_file_sink = require("./sinks/file-sink.cjs");
+exports.CallbackSink = require_logger_sinks_callback_sink.CallbackSink;
+exports.ConsoleSink = require_logger_sinks_console_sink.ConsoleSink;
+exports.FileSink = require_logger_sinks_file_sink.FileSink;
+exports.OperationsLogger = require_logger_logger.OperationsLogger;
+exports.StepTracker = require_logger_logger.StepTracker;

package/dist/logger/index.d.cts

@@ -0,0 +1,6 @@
+import { a as OperationOutcome, c as OperationsLoggerOptions, i as OperationCategory, n as LogSink, o as OperationStep, r as LogSource, s as OperationsLogEntry, t as LogLevel } from "../types-CyZ5mn6w.cjs";
+import { n as StepTracker, t as OperationsLogger } from "../logger-DDfwai-A.cjs";
+import { t as CallbackSink } from "../callback-sink-iNThWRnQ.cjs";
+import { t as ConsoleSink } from "../console-sink-BHQpRyCt.cjs";
+import { FileSink } from "./sinks/file-sink.cjs";
+export { CallbackSink, ConsoleSink, FileSink, type LogLevel, type LogSink, type LogSource, type OperationCategory, type OperationOutcome, type OperationStep, type OperationsLogEntry, OperationsLogger, type OperationsLoggerOptions, StepTracker };

package/dist/logger/index.d.mts

@@ -0,0 +1,6 @@
+import { a as OperationOutcome, c as OperationsLoggerOptions, i as OperationCategory, n as LogSink, o as OperationStep, r as LogSource, s as OperationsLogEntry, t as LogLevel } from "../types-BREUfzzq.mjs";
+import { n as StepTracker, t as OperationsLogger } from "../logger-CZ0Qnyiu.mjs";
+import { t as CallbackSink } from "../callback-sink-CdMKYayY.mjs";
+import { t as ConsoleSink } from "../console-sink-bouG_M1K.mjs";
+import { FileSink } from "./sinks/file-sink.mjs";
+export { CallbackSink, ConsoleSink, FileSink, type LogLevel, type LogSink, type LogSource, type OperationCategory, type OperationOutcome, type OperationStep, type OperationsLogEntry, OperationsLogger, type OperationsLoggerOptions, StepTracker };

package/dist/logger/index.mjs

@@ -0,0 +1,5 @@
+import { OperationsLogger, StepTracker } from "./logger.mjs";
+import { CallbackSink } from "./sinks/callback-sink.mjs";
+import { ConsoleSink } from "./sinks/console-sink.mjs";
+import { FileSink } from "./sinks/file-sink.mjs";
+export { CallbackSink, ConsoleSink, FileSink, OperationsLogger, StepTracker };

package/dist/logger/logger.cjs

@@ -0,0 +1,270 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../skills-uPxJVmKk.cjs");
+let node_crypto = require("node:crypto");
+//#region src/logger/logger.ts
+/** Keys that must never appear in logged context. */
+const SENSITIVE_KEYS = new Set([
+	"apikey",
+	"api_key",
+	"password",
+	"token",
+	"secret",
+	"authorization",
+	"credentials",
+	"private_key",
+	"privatekey"
+]);
+const LEVEL_ORDER = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
+};
+/** Strip sensitive keys from a context object (shallow). */
+function sanitizeContext(ctx) {
+	if (!ctx) return ctx;
+	const clean = {};
+	for (const [key, value] of Object.entries(ctx)) if (SENSITIVE_KEYS.has(key.toLowerCase())) clean[key] = "[REDACTED]";
+	else clean[key] = value;
+	return clean;
+}
+/**
+* Tracks individual steps within a multi-step operation (e.g. deploy, generate).
+*/
+var StepTracker = class {
+	steps = [];
+	currentStep = null;
+	operationStart = Date.now();
+	constructor(logger, category, operationName) {
+		this.logger = logger;
+		this.category = category;
+		this.operationName = operationName;
+	}
+	/** Start a new step. Automatically completes the previous step if still open. */
+	begin(name, detail) {
+		if (this.currentStep && this.currentStep.status === "in_progress") {
+			this.currentStep.status = "success";
+			this.currentStep.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+			this.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();
+		}
+		this.currentStep = {
+			name,
+			status: "in_progress",
+			detail,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		this.steps.push(this.currentStep);
+		this.logger.debug(this.category, `[${this.operationName}] ${name}`, {
+			step: name,
+			detail
+		});
+	}
+	/** Mark the current step as completed. */
+	complete(detail) {
+		if (!this.currentStep) return;
+		this.currentStep.status = "success";
+		this.currentStep.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+		this.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();
+		if (detail) this.currentStep.detail = detail;
+	}
+	/** Mark the current step as failed. */
+	fail(error) {
+		if (!this.currentStep) return;
+		this.currentStep.status = "failure";
+		this.currentStep.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+		this.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();
+		this.currentStep.detail = error;
+	}
+	/** Record a skipped step. */
+	skip(name, reason) {
+		this.steps.push({
+			name,
+			status: "skipped",
+			detail: reason,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			durationMs: 0
+		});
+	}
+	/** Finalize and log the full operation summary. Returns all steps. */
+	finalize(outcome) {
+		if (this.currentStep && this.currentStep.status === "in_progress") {
+			this.currentStep.status = outcome === "failure" ? "failure" : "success";
+			this.currentStep.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+			this.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();
+		}
+		this.logger.log({
+			level: outcome === "failure" ? "error" : "info",
+			category: this.category,
+			message: `${this.operationName} ${outcome}`,
+			outcome,
+			durationMs: Date.now() - this.operationStart,
+			steps: this.steps
+		});
+		return this.steps;
+	}
+	/** Get the current list of steps (snapshot). */
+	getSteps() {
+		return [...this.steps];
+	}
+};
+/**
+* Centralized operations logger.
+*
+* Follows fire-and-forget semantics — sink errors are silently caught and
+* logging never blocks or crashes the main flow.
+*/
+var OperationsLogger = class OperationsLogger {
+	source;
+	sinks;
+	correlationId;
+	sessionId;
+	minLevel;
+	constructor(options) {
+		this.source = options.source;
+		this.sinks = options.sinks ?? [];
+		this.correlationId = options.correlationId ?? (0, node_crypto.randomUUID)();
+		this.sessionId = options.sessionId ?? (0, node_crypto.randomUUID)();
+		this.minLevel = options.minLevel ?? "info";
+	}
+	/** Create a child logger that inherits correlation/session but can override source or sinks. */
+	child(overrides) {
+		return new OperationsLogger({
+			source: overrides.source ?? this.source,
+			sinks: overrides.sinks ?? this.sinks,
+			correlationId: overrides.correlationId ?? this.correlationId,
+			sessionId: overrides.sessionId ?? this.sessionId,
+			minLevel: overrides.minLevel ?? this.minLevel
+		});
+	}
+	/** Log an operation with full context. Fire-and-forget to all sinks. */
+	log(entry) {
+		if (!this.shouldLog(entry.level)) return;
+		const full = {
+			id: (0, node_crypto.randomUUID)(),
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			source: this.source,
+			correlationId: this.correlationId,
+			sessionId: this.sessionId,
+			...entry,
+			context: sanitizeContext(entry.context)
+		};
+		for (const sink of this.sinks) try {
+			const result = sink.write(full);
+			if (result instanceof Promise) result.catch(() => {});
+		} catch {}
+	}
+	info(category, message, context) {
+		this.log({
+			level: "info",
+			category,
+			message,
+			context
+		});
+	}
+	warn(category, message, context) {
+		this.log({
+			level: "warn",
+			category,
+			message,
+			context
+		});
+	}
+	error(category, message, err, context) {
+		this.log({
+			level: "error",
+			category,
+			message,
+			context,
+			error: err ? {
+				name: err.name,
+				message: err.message,
+				stack: err.stack,
+				code: err.code
+			} : void 0
+		});
+	}
+	debug(category, message, context) {
+		this.log({
+			level: "debug",
+			category,
+			message,
+			context
+		});
+	}
+	/**
+	* Log a timed operation. Wraps an async/sync function with start/end/duration logging.
+	* Re-throws the original error on failure.
+	*/
+	async timed(category, message, fn, context) {
+		const start = Date.now();
+		this.log({
+			level: "info",
+			category,
+			message,
+			outcome: "in_progress",
+			context
+		});
+		try {
+			const result = await fn();
+			this.log({
+				level: "info",
+				category,
+				message,
+				outcome: "success",
+				durationMs: Date.now() - start,
+				context
+			});
+			return result;
+		} catch (err) {
+			this.log({
+				level: "error",
+				category,
+				message,
+				outcome: "failure",
+				durationMs: Date.now() - start,
+				error: err instanceof Error ? {
+					name: err.name,
+					message: err.message,
+					stack: err.stack,
+					code: err.code
+				} : {
+					name: "UnknownError",
+					message: String(err)
+				},
+				context
+			});
+			throw err;
+		}
+	}
+	/** Create a step tracker for multi-step operations (deploy, generate pipeline). */
+	createStepTracker(category, operationName) {
+		return new StepTracker(this, category, operationName);
+	}
+	/** Flush all sinks. */
+	async flush() {
+		for (const sink of this.sinks) if (sink.flush) try {
+			await sink.flush();
+		} catch {}
+	}
+	/** Destroy all sinks (cleanup timers, close streams). */
+	async destroy() {
+		for (const sink of this.sinks) if (sink.destroy) try {
+			await sink.destroy();
+		} catch {}
+	}
+	getCorrelationId() {
+		return this.correlationId;
+	}
+	getSessionId() {
+		return this.sessionId;
+	}
+	shouldLog(level) {
+		return LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevel];
+	}
+};
+//#endregion
+exports.OperationsLogger = OperationsLogger;
+exports.StepTracker = StepTracker;
+
+//# sourceMappingURL=logger.cjs.map

package/dist/logger/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.cjs","names":[],"sources":["../../src/logger/logger.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type {\n\tLogLevel,\n\tLogSink,\n\tLogSource,\n\tOperationCategory,\n\tOperationOutcome,\n\tOperationStep,\n\tOperationsLogEntry,\n\tOperationsLoggerOptions,\n} from \"./types.js\";\n\n/** Keys that must never appear in logged context. */\nconst SENSITIVE_KEYS = new Set([\n\t\"apikey\",\n\t\"api_key\",\n\t\"password\",\n\t\"token\",\n\t\"secret\",\n\t\"authorization\",\n\t\"credentials\",\n\t\"private_key\",\n\t\"privatekey\",\n]);\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n\tdebug: 0,\n\tinfo: 1,\n\twarn: 2,\n\terror: 3,\n};\n\n/** Strip sensitive keys from a context object (shallow). */\nfunction sanitizeContext(\n\tctx: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined {\n\tif (!ctx) return ctx;\n\tconst clean: Record<string, unknown> = {};\n\tfor (const [key, value] of Object.entries(ctx)) {\n\t\tif (SENSITIVE_KEYS.has(key.toLowerCase())) {\n\t\t\tclean[key] = \"[REDACTED]\";\n\t\t} else {\n\t\t\tclean[key] = value;\n\t\t}\n\t}\n\treturn clean;\n}\n\n/**\n * Tracks individual steps within a multi-step operation (e.g. deploy, generate).\n */\nexport class StepTracker {\n\tprivate steps: OperationStep[] = [];\n\tprivate currentStep: OperationStep | null = null;\n\tprivate readonly operationStart = Date.now();\n\n\tconstructor(\n\t\tprivate readonly logger: OperationsLogger,\n\t\tprivate readonly category: OperationCategory,\n\t\tprivate readonly operationName: string,\n\t) {}\n\n\t/** Start a new step. Automatically completes the previous step if still open. */\n\tbegin(name: string, detail?: string): void {\n\t\tif (this.currentStep && this.currentStep.status === \"in_progress\") {\n\t\t\tthis.currentStep.status = \"success\";\n\t\t\tthis.currentStep.completedAt = new Date().toISOString();\n\t\t\tthis.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();\n\t\t}\n\t\tthis.currentStep = {\n\t\t\tname,\n\t\t\tstatus: \"in_progress\",\n\t\t\tdetail,\n\t\t\tstartedAt: new Date().toISOString(),\n\t\t};\n\t\tthis.steps.push(this.currentStep);\n\t\tthis.logger.debug(this.category, `[${this.operationName}] ${name}`, {\n\t\t\tstep: name,\n\t\t\tdetail,\n\t\t});\n\t}\n\n\t/** Mark the current step as completed. */\n\tcomplete(detail?: string): void {\n\t\tif (!this.currentStep) return;\n\t\tthis.currentStep.status = \"success\";\n\t\tthis.currentStep.completedAt = new Date().toISOString();\n\t\tthis.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();\n\t\tif (detail) this.currentStep.detail = detail;\n\t}\n\n\t/** Mark the current step as failed. */\n\tfail(error: string): void {\n\t\tif (!this.currentStep) return;\n\t\tthis.currentStep.status = \"failure\";\n\t\tthis.currentStep.completedAt = new Date().toISOString();\n\t\tthis.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();\n\t\tthis.currentStep.detail = error;\n\t}\n\n\t/** Record a skipped step. */\n\tskip(name: string, reason?: string): void {\n\t\tthis.steps.push({\n\t\t\tname,\n\t\t\tstatus: \"skipped\",\n\t\t\tdetail: reason,\n\t\t\tstartedAt: new Date().toISOString(),\n\t\t\tcompletedAt: new Date().toISOString(),\n\t\t\tdurationMs: 0,\n\t\t});\n\t}\n\n\t/** Finalize and log the full operation summary. Returns all steps. */\n\tfinalize(outcome: OperationOutcome): OperationStep[] {\n\t\t// Close any open step\n\t\tif (this.currentStep && this.currentStep.status === \"in_progress\") {\n\t\t\tthis.currentStep.status = outcome === \"failure\" ? \"failure\" : \"success\";\n\t\t\tthis.currentStep.completedAt = new Date().toISOString();\n\t\t\tthis.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();\n\t\t}\n\n\t\tthis.logger.log({\n\t\t\tlevel: outcome === \"failure\" ? \"error\" : \"info\",\n\t\t\tcategory: this.category,\n\t\t\tmessage: `${this.operationName} ${outcome}`,\n\t\t\toutcome,\n\t\t\tdurationMs: Date.now() - this.operationStart,\n\t\t\tsteps: this.steps,\n\t\t});\n\t\treturn this.steps;\n\t}\n\n\t/** Get the current list of steps (snapshot). */\n\tgetSteps(): OperationStep[] {\n\t\treturn [...this.steps];\n\t}\n}\n\n/**\n * Centralized operations logger.\n *\n * Follows fire-and-forget semantics — sink errors are silently caught and\n * logging never blocks or crashes the main flow.\n */\nexport class OperationsLogger {\n\tprivate readonly source: LogSource;\n\tprivate readonly sinks: LogSink[];\n\tprivate readonly correlationId: string;\n\tprivate readonly sessionId: string;\n\tprivate readonly minLevel: LogLevel;\n\n\tconstructor(options: OperationsLoggerOptions) {\n\t\tthis.source = options.source;\n\t\tthis.sinks = options.sinks ?? [];\n\t\tthis.correlationId = options.correlationId ?? randomUUID();\n\t\tthis.sessionId = options.sessionId ?? randomUUID();\n\t\tthis.minLevel = options.minLevel ?? \"info\";\n\t}\n\n\t/** Create a child logger that inherits correlation/session but can override source or sinks. */\n\tchild(overrides: Partial<OperationsLoggerOptions>): OperationsLogger {\n\t\treturn new OperationsLogger({\n\t\t\tsource: overrides.source ?? this.source,\n\t\t\tsinks: overrides.sinks ?? this.sinks,\n\t\t\tcorrelationId: overrides.correlationId ?? this.correlationId,\n\t\t\tsessionId: overrides.sessionId ?? this.sessionId,\n\t\t\tminLevel: overrides.minLevel ?? this.minLevel,\n\t\t});\n\t}\n\n\t/** Log an operation with full context. Fire-and-forget to all sinks. */\n\tlog(\n\t\tentry: Omit<OperationsLogEntry, \"id\" | \"timestamp\" | \"source\" | \"correlationId\" | \"sessionId\">,\n\t): void {\n\t\tif (!this.shouldLog(entry.level)) return;\n\n\t\tconst full: OperationsLogEntry = {\n\t\t\tid: randomUUID(),\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tsource: this.source,\n\t\t\tcorrelationId: this.correlationId,\n\t\t\tsessionId: this.sessionId,\n\t\t\t...entry,\n\t\t\tcontext: sanitizeContext(entry.context),\n\t\t};\n\n\t\tfor (const sink of this.sinks) {\n\t\t\ttry {\n\t\t\t\tconst result = sink.write(full);\n\t\t\t\tif (result instanceof Promise) {\n\t\t\t\t\tresult.catch(() => {});\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Sink failures must never crash the main flow\n\t\t\t}\n\t\t}\n\t}\n\n\tinfo(category: OperationCategory, message: string, context?: Record<string, unknown>): void {\n\t\tthis.log({ level: \"info\", category, message, context });\n\t}\n\n\twarn(category: OperationCategory, message: string, context?: Record<string, unknown>): void {\n\t\tthis.log({ level: \"warn\", category, message, context });\n\t}\n\n\terror(\n\t\tcategory: OperationCategory,\n\t\tmessage: string,\n\t\terr?: Error | null,\n\t\tcontext?: Record<string, unknown>,\n\t): void {\n\t\tthis.log({\n\t\t\tlevel: \"error\",\n\t\t\tcategory,\n\t\t\tmessage,\n\t\t\tcontext,\n\t\t\terror: err\n\t\t\t\t? {\n\t\t\t\t\t\tname: err.name,\n\t\t\t\t\t\tmessage: err.message,\n\t\t\t\t\t\tstack: err.stack,\n\t\t\t\t\t\tcode: (err as { code?: string }).code,\n\t\t\t\t\t}\n\t\t\t\t: undefined,\n\t\t});\n\t}\n\n\tdebug(category: OperationCategory, message: string, context?: Record<string, unknown>): void {\n\t\tthis.log({ level: \"debug\", category, message, context });\n\t}\n\n\t/**\n\t * Log a timed operation. Wraps an async/sync function with start/end/duration logging.\n\t * Re-throws the original error on failure.\n\t */\n\tasync timed<T>(\n\t\tcategory: OperationCategory,\n\t\tmessage: string,\n\t\tfn: () => T | Promise<T>,\n\t\tcontext?: Record<string, unknown>,\n\t): Promise<T> {\n\t\tconst start = Date.now();\n\t\tthis.log({\n\t\t\tlevel: \"info\",\n\t\t\tcategory,\n\t\t\tmessage,\n\t\t\toutcome: \"in_progress\",\n\t\t\tcontext,\n\t\t});\n\t\ttry {\n\t\t\tconst result = await fn();\n\t\t\tthis.log({\n\t\t\t\tlevel: \"info\",\n\t\t\t\tcategory,\n\t\t\t\tmessage,\n\t\t\t\toutcome: \"success\",\n\t\t\t\tdurationMs: Date.now() - start,\n\t\t\t\tcontext,\n\t\t\t});\n\t\t\treturn result;\n\t\t} catch (err) {\n\t\t\tthis.log({\n\t\t\t\tlevel: \"error\",\n\t\t\t\tcategory,\n\t\t\t\tmessage,\n\t\t\t\toutcome: \"failure\",\n\t\t\t\tdurationMs: Date.now() - start,\n\t\t\t\terror:\n\t\t\t\t\terr instanceof Error\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tname: err.name,\n\t\t\t\t\t\t\t\tmessage: err.message,\n\t\t\t\t\t\t\t\tstack: err.stack,\n\t\t\t\t\t\t\t\tcode: (err as { code?: string }).code,\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: { name: \"UnknownError\", message: String(err) },\n\t\t\t\tcontext,\n\t\t\t});\n\t\t\tthrow err;\n\t\t}\n\t}\n\n\t/** Create a step tracker for multi-step operations (deploy, generate pipeline). */\n\tcreateStepTracker(category: OperationCategory, operationName: string): StepTracker {\n\t\treturn new StepTracker(this, category, operationName);\n\t}\n\n\t/** Flush all sinks. */\n\tasync flush(): Promise<void> {\n\t\tfor (const sink of this.sinks) {\n\t\t\tif (sink.flush) {\n\t\t\t\ttry {\n\t\t\t\t\tawait sink.flush();\n\t\t\t\t} catch {\n\t\t\t\t\t// Silent\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Destroy all sinks (cleanup timers, close streams). */\n\tasync destroy(): Promise<void> {\n\t\tfor (const sink of this.sinks) {\n\t\t\tif (sink.destroy) {\n\t\t\t\ttry {\n\t\t\t\t\tawait sink.destroy();\n\t\t\t\t} catch {\n\t\t\t\t\t// Silent\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tgetCorrelationId(): string {\n\t\treturn this.correlationId;\n\t}\n\n\tgetSessionId(): string {\n\t\treturn this.sessionId;\n\t}\n\n\tprivate shouldLog(level: LogLevel): boolean {\n\t\treturn LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevel];\n\t}\n}\n"],"mappings":";;;;;AAaA,MAAM,iBAAiB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAC;AAEF,MAAM,cAAwC;CAC7C,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP;;AAGD,SAAS,gBACR,KACsC;AACtC,KAAI,CAAC,IAAK,QAAO;CACjB,MAAM,QAAiC,EAAE;AACzC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,CAC7C,KAAI,eAAe,IAAI,IAAI,aAAa,CAAC,CACxC,OAAM,OAAO;KAEb,OAAM,OAAO;AAGf,QAAO;;;;;AAMR,IAAa,cAAb,MAAyB;CACxB,QAAiC,EAAE;CACnC,cAA4C;CAC5C,iBAAkC,KAAK,KAAK;CAE5C,YACC,QACA,UACA,eACC;AAHgB,OAAA,SAAA;AACA,OAAA,WAAA;AACA,OAAA,gBAAA;;;CAIlB,MAAM,MAAc,QAAuB;AAC1C,MAAI,KAAK,eAAe,KAAK,YAAY,WAAW,eAAe;AAClE,QAAK,YAAY,SAAS;AAC1B,QAAK,YAAY,+BAAc,IAAI,MAAM,EAAC,aAAa;AACvD,QAAK,YAAY,aAAa,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,YAAY,UAAU,CAAC,SAAS;;AAE1F,OAAK,cAAc;GAClB;GACA,QAAQ;GACR;GACA,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC;AACD,OAAK,MAAM,KAAK,KAAK,YAAY;AACjC,OAAK,OAAO,MAAM,KAAK,UAAU,IAAI,KAAK,cAAc,IAAI,QAAQ;GACnE,MAAM;GACN;GACA,CAAC;;;CAIH,SAAS,QAAuB;AAC/B,MAAI,CAAC,KAAK,YAAa;AACvB,OAAK,YAAY,SAAS;AAC1B,OAAK,YAAY,+BAAc,IAAI,MAAM,EAAC,aAAa;AACvD,OAAK,YAAY,aAAa,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,YAAY,UAAU,CAAC,SAAS;AACzF,MAAI,OAAQ,MAAK,YAAY,SAAS;;;CAIvC,KAAK,OAAqB;AACzB,MAAI,CAAC,KAAK,YAAa;AACvB,OAAK,YAAY,SAAS;AAC1B,OAAK,YAAY,+BAAc,IAAI,MAAM,EAAC,aAAa;AACvD,OAAK,YAAY,aAAa,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,YAAY,UAAU,CAAC,SAAS;AACzF,OAAK,YAAY,SAAS;;;CAI3B,KAAK,MAAc,QAAuB;AACzC,OAAK,MAAM,KAAK;GACf;GACA,QAAQ;GACR,QAAQ;GACR,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,8BAAa,IAAI,MAAM,EAAC,aAAa;GACrC,YAAY;GACZ,CAAC;;;CAIH,SAAS,SAA4C;AAEpD,MAAI,KAAK,eAAe,KAAK,YAAY,WAAW,eAAe;AAClE,QAAK,YAAY,SAAS,YAAY,YAAY,YAAY;AAC9D,QAAK,YAAY,+BAAc,IAAI,MAAM,EAAC,aAAa;AACvD,QAAK,YAAY,aAAa,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,YAAY,UAAU,CAAC,SAAS;;AAG1F,OAAK,OAAO,IAAI;GACf,OAAO,YAAY,YAAY,UAAU;GACzC,UAAU,KAAK;GACf,SAAS,GAAG,KAAK,cAAc,GAAG;GAClC;GACA,YAAY,KAAK,KAAK,GAAG,KAAK;GAC9B,OAAO,KAAK;GACZ,CAAC;AACF,SAAO,KAAK;;;CAIb,WAA4B;AAC3B,SAAO,CAAC,GAAG,KAAK,MAAM;;;;;;;;;AAUxB,IAAa,mBAAb,MAAa,iBAAiB;CAC7B;CACA;CACA;CACA;CACA;CAEA,YAAY,SAAkC;AAC7C,OAAK,SAAS,QAAQ;AACtB,OAAK,QAAQ,QAAQ,SAAS,EAAE;AAChC,OAAK,gBAAgB,QAAQ,kBAAA,GAAA,YAAA,aAA6B;AAC1D,OAAK,YAAY,QAAQ,cAAA,GAAA,YAAA,aAAyB;AAClD,OAAK,WAAW,QAAQ,YAAY;;;CAIrC,MAAM,WAA+D;AACpE,SAAO,IAAI,iBAAiB;GAC3B,QAAQ,UAAU,UAAU,KAAK;GACjC,OAAO,UAAU,SAAS,KAAK;GAC/B,eAAe,UAAU,iBAAiB,KAAK;GAC/C,WAAW,UAAU,aAAa,KAAK;GACvC,UAAU,UAAU,YAAY,KAAK;GACrC,CAAC;;;CAIH,IACC,OACO;AACP,MAAI,CAAC,KAAK,UAAU,MAAM,MAAM,CAAE;EAElC,MAAM,OAA2B;GAChC,KAAA,GAAA,YAAA,aAAgB;GAChB,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,QAAQ,KAAK;GACb,eAAe,KAAK;GACpB,WAAW,KAAK;GAChB,GAAG;GACH,SAAS,gBAAgB,MAAM,QAAQ;GACvC;AAED,OAAK,MAAM,QAAQ,KAAK,MACvB,KAAI;GACH,MAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,OAAI,kBAAkB,QACrB,QAAO,YAAY,GAAG;UAEhB;;CAMV,KAAK,UAA6B,SAAiB,SAAyC;AAC3F,OAAK,IAAI;GAAE,OAAO;GAAQ;GAAU;GAAS;GAAS,CAAC;;CAGxD,KAAK,UAA6B,SAAiB,SAAyC;AAC3F,OAAK,IAAI;GAAE,OAAO;GAAQ;GAAU;GAAS;GAAS,CAAC;;CAGxD,MACC,UACA,SACA,KACA,SACO;AACP,OAAK,IAAI;GACR,OAAO;GACP;GACA;GACA;GACA,OAAO,MACJ;IACA,MAAM,IAAI;IACV,SAAS,IAAI;IACb,OAAO,IAAI;IACX,MAAO,IAA0B;IACjC,GACA,KAAA;GACH,CAAC;;CAGH,MAAM,UAA6B,SAAiB,SAAyC;AAC5F,OAAK,IAAI;GAAE,OAAO;GAAS;GAAU;GAAS;GAAS,CAAC;;;;;;CAOzD,MAAM,MACL,UACA,SACA,IACA,SACa;EACb,MAAM,QAAQ,KAAK,KAAK;AACxB,OAAK,IAAI;GACR,OAAO;GACP;GACA;GACA,SAAS;GACT;GACA,CAAC;AACF,MAAI;GACH,MAAM,SAAS,MAAM,IAAI;AACzB,QAAK,IAAI;IACR,OAAO;IACP;IACA;IACA,SAAS;IACT,YAAY,KAAK,KAAK,GAAG;IACzB;IACA,CAAC;AACF,UAAO;WACC,KAAK;AACb,QAAK,IAAI;IACR,OAAO;IACP;IACA;IACA,SAAS;IACT,YAAY,KAAK,KAAK,GAAG;IACzB,OACC,eAAe,QACZ;KACA,MAAM,IAAI;KACV,SAAS,IAAI;KACb,OAAO,IAAI;KACX,MAAO,IAA0B;KACjC,GACA;KAAE,MAAM;KAAgB,SAAS,OAAO,IAAI;KAAE;IAClD;IACA,CAAC;AACF,SAAM;;;;CAKR,kBAAkB,UAA6B,eAAoC;AAClF,SAAO,IAAI,YAAY,MAAM,UAAU,cAAc;;;CAItD,MAAM,QAAuB;AAC5B,OAAK,MAAM,QAAQ,KAAK,MACvB,KAAI,KAAK,MACR,KAAI;AACH,SAAM,KAAK,OAAO;UACX;;;CAQX,MAAM,UAAyB;AAC9B,OAAK,MAAM,QAAQ,KAAK,MACvB,KAAI,KAAK,QACR,KAAI;AACH,SAAM,KAAK,SAAS;UACb;;CAOX,mBAA2B;AAC1B,SAAO,KAAK;;CAGb,eAAuB;AACtB,SAAO,KAAK;;CAGb,UAAkB,OAA0B;AAC3C,SAAO,YAAY,UAAU,YAAY,KAAK"}

package/dist/logger/logger.d.cts

@@ -0,0 +1,2 @@
+import { n as StepTracker, t as OperationsLogger } from "../logger-DDfwai-A.cjs";
+export { OperationsLogger, StepTracker };

package/dist/logger/logger.d.mts

@@ -0,0 +1,2 @@
+import { n as StepTracker, t as OperationsLogger } from "../logger-CZ0Qnyiu.mjs";
+export { OperationsLogger, StepTracker };

package/dist/logger/logger.mjs

@@ -0,0 +1,267 @@
+import { randomUUID } from "node:crypto";
+//#region src/logger/logger.ts
+/** Keys that must never appear in logged context. */
+const SENSITIVE_KEYS = new Set([
+	"apikey",
+	"api_key",
+	"password",
+	"token",
+	"secret",
+	"authorization",
+	"credentials",
+	"private_key",
+	"privatekey"
+]);
+const LEVEL_ORDER = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
+};
+/** Strip sensitive keys from a context object (shallow). */
+function sanitizeContext(ctx) {
+	if (!ctx) return ctx;
+	const clean = {};
+	for (const [key, value] of Object.entries(ctx)) if (SENSITIVE_KEYS.has(key.toLowerCase())) clean[key] = "[REDACTED]";
+	else clean[key] = value;
+	return clean;
+}
+/**
+* Tracks individual steps within a multi-step operation (e.g. deploy, generate).
+*/
+var StepTracker = class {
+	steps = [];
+	currentStep = null;
+	operationStart = Date.now();
+	constructor(logger, category, operationName) {
+		this.logger = logger;
+		this.category = category;
+		this.operationName = operationName;
+	}
+	/** Start a new step. Automatically completes the previous step if still open. */
+	begin(name, detail) {
+		if (this.currentStep && this.currentStep.status === "in_progress") {
+			this.currentStep.status = "success";
+			this.currentStep.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+			this.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();
+		}
+		this.currentStep = {
+			name,
+			status: "in_progress",
+			detail,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		this.steps.push(this.currentStep);
+		this.logger.debug(this.category, `[${this.operationName}] ${name}`, {
+			step: name,
+			detail
+		});
+	}
+	/** Mark the current step as completed. */
+	complete(detail) {
+		if (!this.currentStep) return;
+		this.currentStep.status = "success";
+		this.currentStep.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+		this.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();
+		if (detail) this.currentStep.detail = detail;
+	}
+	/** Mark the current step as failed. */
+	fail(error) {
+		if (!this.currentStep) return;
+		this.currentStep.status = "failure";
+		this.currentStep.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+		this.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();
+		this.currentStep.detail = error;
+	}
+	/** Record a skipped step. */
+	skip(name, reason) {
+		this.steps.push({
+			name,
+			status: "skipped",
+			detail: reason,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			durationMs: 0
+		});
+	}
+	/** Finalize and log the full operation summary. Returns all steps. */
+	finalize(outcome) {
+		if (this.currentStep && this.currentStep.status === "in_progress") {
+			this.currentStep.status = outcome === "failure" ? "failure" : "success";
+			this.currentStep.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+			this.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();
+		}
+		this.logger.log({
+			level: outcome === "failure" ? "error" : "info",
+			category: this.category,
+			message: `${this.operationName} ${outcome}`,
+			outcome,
+			durationMs: Date.now() - this.operationStart,
+			steps: this.steps
+		});
+		return this.steps;
+	}
+	/** Get the current list of steps (snapshot). */
+	getSteps() {
+		return [...this.steps];
+	}
+};
+/**
+* Centralized operations logger.
+*
+* Follows fire-and-forget semantics — sink errors are silently caught and
+* logging never blocks or crashes the main flow.
+*/
+var OperationsLogger = class OperationsLogger {
+	source;
+	sinks;
+	correlationId;
+	sessionId;
+	minLevel;
+	constructor(options) {
+		this.source = options.source;
+		this.sinks = options.sinks ?? [];
+		this.correlationId = options.correlationId ?? randomUUID();
+		this.sessionId = options.sessionId ?? randomUUID();
+		this.minLevel = options.minLevel ?? "info";
+	}
+	/** Create a child logger that inherits correlation/session but can override source or sinks. */
+	child(overrides) {
+		return new OperationsLogger({
+			source: overrides.source ?? this.source,
+			sinks: overrides.sinks ?? this.sinks,
+			correlationId: overrides.correlationId ?? this.correlationId,
+			sessionId: overrides.sessionId ?? this.sessionId,
+			minLevel: overrides.minLevel ?? this.minLevel
+		});
+	}
+	/** Log an operation with full context. Fire-and-forget to all sinks. */
+	log(entry) {
+		if (!this.shouldLog(entry.level)) return;
+		const full = {
+			id: randomUUID(),
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			source: this.source,
+			correlationId: this.correlationId,
+			sessionId: this.sessionId,
+			...entry,
+			context: sanitizeContext(entry.context)
+		};
+		for (const sink of this.sinks) try {
+			const result = sink.write(full);
+			if (result instanceof Promise) result.catch(() => {});
+		} catch {}
+	}
+	info(category, message, context) {
+		this.log({
+			level: "info",
+			category,
+			message,
+			context
+		});
+	}
+	warn(category, message, context) {
+		this.log({
+			level: "warn",
+			category,
+			message,
+			context
+		});
+	}
+	error(category, message, err, context) {
+		this.log({
+			level: "error",
+			category,
+			message,
+			context,
+			error: err ? {
+				name: err.name,
+				message: err.message,
+				stack: err.stack,
+				code: err.code
+			} : void 0
+		});
+	}
+	debug(category, message, context) {
+		this.log({
+			level: "debug",
+			category,
+			message,
+			context
+		});
+	}
+	/**
+	* Log a timed operation. Wraps an async/sync function with start/end/duration logging.
+	* Re-throws the original error on failure.
+	*/
+	async timed(category, message, fn, context) {
+		const start = Date.now();
+		this.log({
+			level: "info",
+			category,
+			message,
+			outcome: "in_progress",
+			context
+		});
+		try {
+			const result = await fn();
+			this.log({
+				level: "info",
+				category,
+				message,
+				outcome: "success",
+				durationMs: Date.now() - start,
+				context
+			});
+			return result;
+		} catch (err) {
+			this.log({
+				level: "error",
+				category,
+				message,
+				outcome: "failure",
+				durationMs: Date.now() - start,
+				error: err instanceof Error ? {
+					name: err.name,
+					message: err.message,
+					stack: err.stack,
+					code: err.code
+				} : {
+					name: "UnknownError",
+					message: String(err)
+				},
+				context
+			});
+			throw err;
+		}
+	}
+	/** Create a step tracker for multi-step operations (deploy, generate pipeline). */
+	createStepTracker(category, operationName) {
+		return new StepTracker(this, category, operationName);
+	}
+	/** Flush all sinks. */
+	async flush() {
+		for (const sink of this.sinks) if (sink.flush) try {
+			await sink.flush();
+		} catch {}
+	}
+	/** Destroy all sinks (cleanup timers, close streams). */
+	async destroy() {
+		for (const sink of this.sinks) if (sink.destroy) try {
+			await sink.destroy();
+		} catch {}
+	}
+	getCorrelationId() {
+		return this.correlationId;
+	}
+	getSessionId() {
+		return this.sessionId;
+	}
+	shouldLog(level) {
+		return LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevel];
+	}
+};
+//#endregion
+export { OperationsLogger, StepTracker };
+
+//# sourceMappingURL=logger.mjs.map