@better-openclaw/core 1.0.26 → 1.0.31

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":"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"}

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

package/dist/logger/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","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":"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"}

package/dist/logger/sinks/callback-sink.cjs

@@ -0,0 +1,18 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/logger/sinks/callback-sink.ts
+/**
+* Callback sink — delegates to a user-provided function.
+* Useful for tests, Sentry breadcrumbs, WebSocket streaming, etc.
+*/
+var CallbackSink = class {
+	constructor(onEntry) {
+		this.onEntry = onEntry;
+	}
+	write(entry) {
+		return this.onEntry(entry);
+	}
+};
+//#endregion
+exports.CallbackSink = CallbackSink;
+
+//# sourceMappingURL=callback-sink.cjs.map

package/dist/logger/sinks/callback-sink.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-sink.cjs","names":[],"sources":["../../../src/logger/sinks/callback-sink.ts"],"sourcesContent":["import type { LogSink, OperationsLogEntry } from \"../types.js\";\n\n/**\n * Callback sink — delegates to a user-provided function.\n * Useful for tests, Sentry breadcrumbs, WebSocket streaming, etc.\n */\nexport class CallbackSink implements LogSink {\n\tconstructor(private readonly onEntry: (entry: OperationsLogEntry) => void | Promise<void>) {}\n\n\twrite(entry: OperationsLogEntry): void | Promise<void> {\n\t\treturn this.onEntry(entry);\n\t}\n}\n"],"mappings":";;;;;;AAMA,IAAa,eAAb,MAA6C;CAC5C,YAAY,SAA+E;AAA9D,OAAA,UAAA;;CAE7B,MAAM,OAAiD;AACtD,SAAO,KAAK,QAAQ,MAAM"}

package/dist/logger/sinks/callback-sink.d.cts

@@ -0,0 +1,2 @@
+import { t as CallbackSink } from "../../callback-sink-iNThWRnQ.cjs";
+export { CallbackSink };

package/dist/logger/sinks/callback-sink.d.mts

@@ -0,0 +1,2 @@
+import { t as CallbackSink } from "../../callback-sink-CdMKYayY.mjs";
+export { CallbackSink };

package/dist/logger/sinks/callback-sink.mjs

@@ -0,0 +1,17 @@
+//#region src/logger/sinks/callback-sink.ts
+/**
+* Callback sink — delegates to a user-provided function.
+* Useful for tests, Sentry breadcrumbs, WebSocket streaming, etc.
+*/
+var CallbackSink = class {
+	constructor(onEntry) {
+		this.onEntry = onEntry;
+	}
+	write(entry) {
+		return this.onEntry(entry);
+	}
+};
+//#endregion
+export { CallbackSink };
+
+//# sourceMappingURL=callback-sink.mjs.map

package/dist/logger/sinks/callback-sink.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-sink.mjs","names":[],"sources":["../../../src/logger/sinks/callback-sink.ts"],"sourcesContent":["import type { LogSink, OperationsLogEntry } from \"../types.js\";\n\n/**\n * Callback sink — delegates to a user-provided function.\n * Useful for tests, Sentry breadcrumbs, WebSocket streaming, etc.\n */\nexport class CallbackSink implements LogSink {\n\tconstructor(private readonly onEntry: (entry: OperationsLogEntry) => void | Promise<void>) {}\n\n\twrite(entry: OperationsLogEntry): void | Promise<void> {\n\t\treturn this.onEntry(entry);\n\t}\n}\n"],"mappings":";;;;;AAMA,IAAa,eAAb,MAA6C;CAC5C,YAAY,SAA+E;AAA9D,OAAA,UAAA;;CAE7B,MAAM,OAAiD;AACtD,SAAO,KAAK,QAAQ,MAAM"}