@1mcp/agent 0.39.0-beta.2 → 0.39.0-beta.3

package/build/index.js

@@ -1,134 +1,10 @@
 #!/usr/bin/env node
-import { MCP_SERVER_VERSION } from './constants.js';
-import { globalOptions } from './globalOptions.js';
-import logger from './logger/logger.js';
-import { normalizeCliArgv, normalizedArgv } from './utils/cli/normalizedArgv.js';
-import 'source-map-support/register.js';
-import yargs from 'yargs';
-import { setupAdminCommands } from './commands/admin/index.js';
-import { setupAppCommands } from './commands/app/index.js';
-import { setupAuthCommands } from './commands/auth/index.js';
-import { setupCliSetupCommand } from './commands/cliSetup/index.js';
-import { setupInspectCommand } from './commands/inspect/index.js';
-import { setupInstructionsCommand } from './commands/instructions/index.js';
-import { setupMcpCommands } from './commands/mcp/index.js';
-import { setupPresetCommands } from './commands/preset/index.js';
-import { setupProxyCommand } from './commands/proxy/index.js';
-import { setupRegistryCommands } from './commands/registry/index.js';
-import { setupRunCommand } from './commands/run/index.js';
-import { serverOptions, setupServeCommand } from './commands/serve/index.js';
-import { setupTargetCommands } from './commands/target/index.js';
-import { setupWaitCommand } from './commands/wait/index.js';
-import { configureGlobalLogger } from './logger/configureGlobalLogger.js';
-export { normalizeCliArgv, normalizedArgv };
-// Parse command line arguments and set up commands
-let yargsInstance = yargs(normalizedArgv);
-// Set up base yargs with global options
-yargsInstance = yargsInstance
-    .usage('Usage: $0 [command] [options]')
-    .options(globalOptions)
-    .command('$0', 'Start the 1mcp server (default)', serverOptions, async (argv) => {
-    // Default command - redirect to serve command
-    configureGlobalLogger(argv, argv.transport);
-    const { serveCommand } = await import('./commands/serve/serve.js');
-    await serveCommand(argv);
-})
-    .version(MCP_SERVER_VERSION)
-    .env('ONE_MCP') // Enable environment variable parsing with ONE_MCP prefix
-    .help()
-    .alias('help', 'h')
-    .strict() // Enable strict mode to reject unknown commands
-    .fail((msg, err, yargs) => {
-    // Custom error handler for unknown commands
-    if (msg) {
-        console.error(`❌ Error: ${msg}\n`);
-    }
-    if (err) {
-        console.error(`❌ ${err.message}\n`);
-    }
-    yargs.showHelp();
-    process.exit(1);
-});
-// Register command groups with global options
-yargsInstance = setupAdminCommands(yargsInstance);
-yargsInstance = setupAppCommands(yargsInstance);
-yargsInstance = setupAuthCommands(yargsInstance);
-yargsInstance = setupCliSetupCommand(yargsInstance);
-yargsInstance = setupInstructionsCommand(yargsInstance);
-yargsInstance = setupMcpCommands(yargsInstance);
-yargsInstance = setupPresetCommands(yargsInstance);
-yargsInstance = setupServeCommand(yargsInstance);
-yargsInstance = setupProxyCommand(yargsInstance);
-yargsInstance = setupInspectCommand(yargsInstance);
-yargsInstance = setupRunCommand(yargsInstance);
-yargsInstance = setupWaitCommand(yargsInstance);
-yargsInstance = setupRegistryCommands(yargsInstance);
-yargsInstance = setupTargetCommands(yargsInstance);
-/**
- * Check for conflicting global options (options specified both before and after the command)
- */
-function checkGlobalOptionConflicts(argv) {
-    const globalOptionNames = Object.keys(globalOptions).map((key) => (key.startsWith('--') ? key.slice(2) : key));
-    const globalOptionAliases = Object.values(globalOptions)
-        .map((opt) => ('alias' in opt ? opt.alias : null))
-        .filter(Boolean);
-    const allGlobalOptions = [...globalOptionNames, ...globalOptionAliases];
-    const commandIndex = argv.findIndex((arg) => arg === 'app' ||
-        arg === 'admin' ||
-        arg === 'auth' ||
-        arg === 'cli-setup' ||
-        arg === 'instructions' ||
-        arg === 'mcp' ||
-        arg === 'preset' ||
-        arg === 'serve' ||
-        arg === 'proxy' ||
-        arg === 'inspect' ||
-        arg === 'run' ||
-        arg === 'wait' ||
-        arg === 'target');
-    if (commandIndex === -1)
-        return;
-    const beforeCommandArgs = argv.slice(0, commandIndex);
-    const afterCommandArgs = argv.slice(commandIndex + 1);
-    const beforeGlobalOptions = new Set();
-    const afterGlobalOptions = new Set();
-    // Parse global options before command
-    for (let i = 0; i < beforeCommandArgs.length; i++) {
-        const arg = beforeCommandArgs[i];
-        const optionName = arg.replace(/^--?/, '');
-        if (allGlobalOptions.includes(optionName)) {
-            beforeGlobalOptions.add(optionName);
-        }
-    }
-    // Parse global options after command
-    for (let i = 0; i < afterCommandArgs.length; i++) {
-        const arg = afterCommandArgs[i];
-        const optionName = arg.replace(/^--?/, '');
-        if (allGlobalOptions.includes(optionName)) {
-            afterGlobalOptions.add(optionName);
-        }
-    }
-    // Check for conflicts
-    const conflicts = Array.from(beforeGlobalOptions).filter((opt) => afterGlobalOptions.has(opt));
-    if (conflicts.length > 0) {
-        console.error(`❌ Error: Cannot specify the following global options both before and after the command: ${conflicts.map((opt) => `--${opt}`).join(', ')}`);
-        console.error('   Please specify global options either before OR after the command, not both.');
-        console.error('   Example: 1mcp --config test.json mcp list');
-        console.error('   OR:      1mcp mcp list --config test.json');
-        process.exit(1);
-    }
-}
-/**
- * Main CLI entry point
- */
-async function main() {
-    // Check for global option conflicts before parsing
-    checkGlobalOptionConflicts(['node', 'cli', ...normalizedArgv]);
-    // Let yargs handle all command processing
-    await yargsInstance.parse();
-}
-main().catch((error) => {
-    logger.error('CLI error:', error);
-    process.exit(1);
+import { bootstrapTracing } from './observability/tracing/bootstrap.js';
+export { normalizeCliArgv, normalizedArgv } from './utils/cli/normalizedArgv.js';
+bootstrapTracing();
+// Runtime modules are evaluated only after propagation is installed. esbuild preserves this order in SEA.
+void import('./cli.js').catch(() => {
+    process.stderr.write('CLI bootstrap failed\n');
+    process.exitCode = 1;
 });
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEjF,gBAAgB,EAAE,CAAC;AACnB,0GAA0G;AAC1G,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC/C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/build/logger/backgroundSupervisorLogger.d.ts

@@ -0,0 +1,4 @@
+import type { BackgroundSupervisorEvent } from '../core/server/backgroundRuntimeSupervisor.js';
+/** Supervisor startup precedes worker logging configuration; retain the same typed local boundary. */
+export declare function appendSupervisorEvent(logFile: string, event: BackgroundSupervisorEvent): void;
+//# sourceMappingURL=backgroundSupervisorLogger.d.ts.map

package/build/logger/backgroundSupervisorLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundSupervisorLogger.d.ts","sourceRoot":"","sources":["../../src/logger/backgroundSupervisorLogger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAIjG,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAa7F"}

package/build/logger/backgroundSupervisorLogger.js

@@ -0,0 +1,21 @@
+import fs from 'node:fs';
+import { normalizeEvent } from '../observability/events/normalize.js';
+import { ownData } from '../observability/privacy/fields.js';
+/** Supervisor startup precedes worker logging configuration; retain the same typed local boundary. */
+export function appendSupervisorEvent(logFile, event) {
+    const kind = ownData(event, 'event');
+    if (typeof kind !== 'string')
+        return;
+    const exit = ownData(event, 'exit');
+    const normalized = normalizeEvent(`supervisor.${kind}`, {
+        supervisorPid: ownData(event, 'supervisorPid'),
+        runtimePid: ownData(event, 'runtimePid'),
+        restartAttempt: ownData(event, 'restartAttempt'),
+        delayMs: ownData(event, 'delayMs'),
+        exitCode: ownData(exit, 'code'),
+        error: ownData(exit, 'error'),
+    });
+    if (normalized)
+        fs.appendFileSync(logFile, `${JSON.stringify(normalized)}\n`, { encoding: 'utf8', mode: 0o600 });
+}
+//# sourceMappingURL=backgroundSupervisorLogger.js.map

package/build/logger/backgroundSupervisorLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundSupervisorLogger.js","sourceRoot":"","sources":["../../src/logger/backgroundSupervisorLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAE/D,sGAAsG;AACtG,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,KAAgC;IACrF,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,cAAc,CAAC,cAAc,IAAI,EAAE,EAAE;QACtD,aAAa,EAAE,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC;QAC9C,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC;QACxC,cAAc,EAAE,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC;QAChD,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC;QAClC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;QAC/B,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;KAC9B,CAAC,CAAC;IACH,IAAI,UAAU;QAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACnH,CAAC"}

package/build/logger/logger.d.ts

@@ -1,5 +1,10 @@
+import type { BackendLogEntry } from '../domains/backend-logs/backendLogTypes.js';
+import { type EventFields } from '../observability/events/normalize.js';
+import { type EventName } from '../observability/events/registry.js';
+import { ManagedStdioStderrEvent } from '../transport/managedStdioStderrEvent.js';
+import type { ManagedStdioStderrMetadata } from '../transport/managedStdioStderrMetadata.js';
 import winston from 'winston';
-declare const logger: winston.Logger;
+declare const sink: winston.Logger;
 /**
  * Enable the console transport
  */
@@ -41,42 +46,32 @@ export declare function isInfoEnabled(): boolean;
  * Use this to avoid expensive operations when warn logging is disabled
  */
 export declare function isWarnEnabled(): boolean;
-/**
- * Conditional debug logging - only executes the message function if debug is enabled
- * @param messageOrFunc Message string or function that returns message and metadata
- */
-export declare function debugIf(messageOrFunc: string | (() => {
-    message: string;
-    meta?: Record<string, unknown>;
-})): void;
-/**
- * Conditional info logging - only executes the message function if info is enabled
- * @param messageOrFunc Message string or function that returns message and metadata
- */
-export declare function infoIf(messageOrFunc: string | (() => {
-    message: string;
-    meta?: Record<string, unknown>;
-})): void;
-/**
- * Conditional warn logging - only executes the message function if warn is enabled
- * @param messageOrFunc Message string or function that returns message and metadata
- */
-export declare function warnIf(messageOrFunc: string | (() => {
-    message: string;
-    meta?: Record<string, unknown>;
-})): void;
-/**
- * Check if error logging is enabled
- * Use this to avoid expensive operations when error logging is disabled
- */
+declare const logger: {
+    debug: <E extends EventName>(event: E, fields?: EventFields<E>) => void;
+    info: <E extends EventName>(event: E, fields?: EventFields<E>) => void;
+    warn: <E extends EventName>(event: E, fields?: EventFields<E>) => void;
+    error: <E extends EventName>(event: E, fields?: EventFields<E>) => void;
+    isDebugEnabled: () => boolean;
+    isInfoEnabled: () => boolean;
+    isWarnEnabled: () => boolean;
+    isErrorEnabled: () => boolean;
+    level: string;
+    readonly transports: winston.transport[];
+    clear: () => void;
+    add: (transport: Parameters<typeof sink.add>[0]) => void;
+};
+interface LazyEvent<E extends EventName> {
+    message: E;
+    meta?: EventFields<E>;
+}
+export declare function debugIf<E extends EventName>(input: E | (() => LazyEvent<E>)): void;
+export declare function infoIf<E extends EventName>(input: E | (() => LazyEvent<E>)): void;
+export declare function warnIf<E extends EventName>(input: E | (() => LazyEvent<E>)): void;
+export declare function errorIf<E extends EventName>(input: E | (() => LazyEvent<E>)): void;
 export declare function isErrorEnabled(): boolean;
-/**
- * Conditional error logging - only executes the message function if error is enabled
- * @param messageOrFunc Message string or function that returns message and metadata
- */
-export declare function errorIf(messageOrFunc: string | (() => {
-    message: string;
-    meta?: Record<string, unknown>;
-})): void;
+/** ADR 0011 local diagnostic projection. Never normalize or correlate backend records. */
+export declare function writeBackendDiagnostic(entry: BackendLogEntry): void;
+/** Legacy managed-stderr fallback is also a diagnostic-only local sink. */
+export declare function writeManagedStderrDiagnostic(event: ManagedStdioStderrEvent, metadata: ManagedStdioStderrMetadata): void;
 export default logger;
 //# sourceMappingURL=logger.d.ts.map

package/build/logger/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAgD9B,QAAA,MAAM,MAAM,gBAYV,CAAC;AAEH;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CASlD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAgE5D;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,CAAC,MAAM;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAAG,IAAI,CA8BjH;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,CAAC,MAAM;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAAG,IAAI,CA8BhH;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,CAAC,MAAM;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAAG,IAAI,CAyBhH;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,CAAC,MAAM;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAAG,IAAI,CAyBjH;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,wCAAwC,CAAC;AAC1F,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAG/F,OAAO,OAAO,MAAM,SAAS,CAAC;AAgD9B,QAAA,MAAM,IAAI,gBAYR,CAAC;AAEH;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CASlD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CA8D5D;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAYD,QAAA,MAAM,MAAM;YACF,CAAC,SAAS,SAAS,SAAS,CAAC,WAAW,WAAW,CAAC,CAAC,CAAC;WACvD,CAAC,SAAS,SAAS,SAAS,CAAC,WAAW,WAAW,CAAC,CAAC,CAAC;WACtD,CAAC,SAAS,SAAS,SAAS,CAAC,WAAW,WAAW,CAAC,CAAC,CAAC;YACrD,CAAC,SAAS,SAAS,SAAS,CAAC,WAAW,WAAW,CAAC,CAAC,CAAC;;;;;WAQ7C,MAAM;;;qBASN,UAAU,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAGhD,CAAC;AAEF,UAAU,SAAS,CAAC,CAAC,SAAS,SAAS;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACvB;AA2BD,wBAAgB,OAAO,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAElF;AACD,wBAAgB,MAAM,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAEjF;AACD,wBAAgB,MAAM,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAEjF;AACD,wBAAgB,OAAO,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAElF;AACD,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAWnE;AAED,2EAA2E;AAC3E,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,EAAE,0BAA0B,GACnC,IAAI,CAgBN;AAED,eAAe,MAAM,CAAC"}

package/build/logger/logger.js

@@ -1,3 +1,9 @@
+import { isBackendDiagnosticEntry } from '../domains/backend-logs/backendLogBroker.js';
+import { sanitizeBackendLogContent } from '../domains/backend-logs/backendLogSanitizer.js';
+import { normalizeEvent } from '../observability/events/normalize.js';
+import { EVENT_REGISTRY } from '../observability/events/registry.js';
+import { ownData } from '../observability/privacy/fields.js';
+import { ManagedStdioStderrEvent } from '../transport/managedStdioStderrEvent.js';
 import chalk from 'chalk';
 import winston from 'winston';
 // Map MCP log levels to Winston log levels
@@ -34,7 +40,7 @@ const consoleFormat = winston.format.combine(winston.format.timestamp(), winston
     return `${colorizedTimestamp} ${colorizedLevel} message=${JSON.stringify(message)}${metaStr}`;
 }));
 // Create the logger without the MCP transport initially
-const logger = winston.createLogger({
+const sink = winston.createLogger({
     level: process.env.LOG_LEVEL || 'info',
     format: customFormat,
     transports: [
@@ -51,8 +57,8 @@ const logger = winston.createLogger({
  * Enable the console transport
  */
 export function enableConsoleTransport() {
-    if (logger.transports.length > 0) {
-        logger.transports[0].silent = false;
+    if (sink.transports.length > 0) {
+        sink.transports[0].silent = false;
     }
 }
 /**
@@ -63,8 +69,8 @@ export function setLogLevel(mcpLevel) {
     // Convert MCP log level to Winston log level
     const winstonLevel = MCP_TO_WINSTON_LEVEL[mcpLevel] || 'info';
     // Set the log level for all transports
-    logger.level = winstonLevel;
-    logger.transports.forEach((transport) => {
+    sink.level = winstonLevel;
+    sink.transports.forEach((transport) => {
         transport.level = winstonLevel;
     });
 }
@@ -81,7 +87,7 @@ export function configureLogger(options) {
     if (!logLevel) {
         logLevel = process.env.LOG_LEVEL;
         if (logLevel) {
-            logger.warn('LOG_LEVEL environment variable is deprecated. Please use ONE_MCP_LOG_LEVEL or --log-level CLI option instead.');
+            logger.warn('logger.deprecated-level');
         }
     }
     logLevel = logLevel || 'info';
@@ -90,7 +96,7 @@ export function configureLogger(options) {
     // Clear existing transports
     logger.clear();
     // Set logger level
-    logger.level = winstonLevel;
+    sink.level = winstonLevel;
     // Configure transports based on options
     if (options.logFile) {
         // Add file transport, with native size-based rotation when configured.
@@ -127,174 +133,120 @@ export function configureLogger(options) {
  * Use this to avoid expensive operations when debug logging is disabled
  */
 export function isDebugEnabled() {
-    return logger.isDebugEnabled();
+    return sink.isDebugEnabled();
 }
 /**
  * Check if info logging is enabled
  * Use this to avoid expensive operations when info logging is disabled
  */
 export function isInfoEnabled() {
-    return logger.isInfoEnabled();
+    return sink.isInfoEnabled();
 }
 /**
  * Check if warn logging is enabled
  * Use this to avoid expensive operations when warn logging is disabled
  */
 export function isWarnEnabled() {
-    return logger.isWarnEnabled();
+    return sink.isWarnEnabled();
 }
-/**
- * Conditional debug logging - only executes the message function if debug is enabled
- * @param messageOrFunc Message string or function that returns message and metadata
- */
-export function debugIf(messageOrFunc) {
-    if (isDebugEnabled()) {
-        if (typeof messageOrFunc === 'string') {
-            logger.debug(messageOrFunc);
-        }
-        else {
-            try {
-                const result = messageOrFunc();
-                if (result && typeof result === 'object' && 'message' in result) {
-                    const { message, meta } = result;
-                    if (meta) {
-                        logger.debug(message, meta);
-                    }
-                    else {
-                        logger.debug(message);
-                    }
-                }
-                else {
-                    // Fallback for malformed callback results
-                    logger.debug('[debugIf: Invalid callback result]', { callbackResult: result });
-                }
-            }
-            catch (error) {
-                // Never let logging errors crash the application
-                // Use logger.warn to avoid infinite recursion if debugIf were to call itself
-                if (logger.isWarnEnabled()) {
-                    logger.warn('debugIf callback failed', {
-                        error: error instanceof Error ? error.message : String(error),
-                        stack: error instanceof Error ? error.stack : undefined,
-                    });
-                }
-            }
-        }
-    }
+/** Typed runtime logger. Raw Winston transports are kept inside this module. */
+function emit(level, event, fields) {
+    const normalized = normalizeEvent(event, fields);
+    if (normalized)
+        sink.log({ ...normalized, level });
 }
-/**
- * Conditional info logging - only executes the message function if info is enabled
- * @param messageOrFunc Message string or function that returns message and metadata
- */
-export function infoIf(messageOrFunc) {
-    if (isInfoEnabled()) {
-        if (typeof messageOrFunc === 'string') {
-            logger.info(messageOrFunc);
+const logger = {
+    debug: (event, fields) => emit('debug', event, fields),
+    info: (event, fields) => emit('info', event, fields),
+    warn: (event, fields) => emit('warn', event, fields),
+    error: (event, fields) => emit('error', event, fields),
+    isDebugEnabled: () => sink.isDebugEnabled(),
+    isInfoEnabled: () => sink.isInfoEnabled(),
+    isWarnEnabled: () => sink.isWarnEnabled(),
+    isErrorEnabled: () => sink.isErrorEnabled(),
+    get level() {
+        return sink.level;
+    },
+    set level(value) {
+        sink.level = value;
+    },
+    get transports() {
+        return sink.transports;
+    },
+    clear: () => {
+        sink.clear();
+    },
+    add: (transport) => {
+        sink.add(transport);
+    },
+};
+function conditional(level, input) {
+    if (!sink.isLevelEnabled(level))
+        return;
+    try {
+        if (typeof input === 'string') {
+            logger[level](input);
+            return;
         }
-        else {
-            try {
-                const result = messageOrFunc();
-                if (result && typeof result === 'object' && 'message' in result) {
-                    const { message, meta } = result;
-                    if (meta) {
-                        logger.info(message, meta);
-                    }
-                    else {
-                        logger.info(message);
-                    }
-                }
-                else {
-                    // Fallback for malformed callback results
-                    logger.info('[infoIf: Invalid callback result]', { callbackResult: result });
-                }
-            }
-            catch (error) {
-                // Never let logging errors crash the application
-                // Use logger.warn to avoid infinite recursion if infoIf were to call itself
-                if (logger.isWarnEnabled()) {
-                    logger.warn('infoIf callback failed', {
-                        error: error instanceof Error ? error.message : String(error),
-                        stack: error instanceof Error ? error.stack : undefined,
-                    });
-                }
-            }
+        const result = input();
+        if (!result || typeof result !== 'object') {
+            logger.warn('logger.callback-invalid');
+            return;
         }
-    }
-}
-/**
- * Conditional warn logging - only executes the message function if warn is enabled
- * @param messageOrFunc Message string or function that returns message and metadata
- */
-export function warnIf(messageOrFunc) {
-    if (isWarnEnabled()) {
-        if (typeof messageOrFunc === 'string') {
-            logger.warn(messageOrFunc);
-        }
-        else {
-            try {
-                const result = messageOrFunc();
-                if (result && typeof result === 'object' && 'message' in result) {
-                    const { message, meta } = result;
-                    if (meta) {
-                        logger.warn(message, meta);
-                    }
-                    else {
-                        logger.warn(message);
-                    }
-                }
-                else {
-                    // Fallback for malformed callback results
-                    logger.warn('[warnIf: Invalid callback result]', { callbackResult: result });
-                }
-            }
-            catch (error) {
-                // Never let logging errors crash the application
-                // For warnIf, we use console.error as last resort to avoid recursion
-                console.error('warnIf callback failed:', error instanceof Error ? error.message : String(error));
-            }
+        const event = ownData(result, 'message');
+        const fields = ownData(result, 'meta');
+        if (typeof event !== 'string' || !Object.hasOwn(EVENT_REGISTRY, event)) {
+            logger.warn('logger.callback-invalid');
+            return;
         }
+        logger[level](event, fields);
+    }
+    catch (error) {
+        logger.warn('logger.callback-failed', { error });
     }
 }
-/**
- * Check if error logging is enabled
- * Use this to avoid expensive operations when error logging is disabled
- */
+export function debugIf(input) {
+    conditional('debug', input);
+}
+export function infoIf(input) {
+    conditional('info', input);
+}
+export function warnIf(input) {
+    conditional('warn', input);
+}
+export function errorIf(input) {
+    conditional('error', input);
+}
 export function isErrorEnabled() {
-    return logger.isErrorEnabled();
+    return sink.isErrorEnabled();
 }
-/**
- * Conditional error logging - only executes the message function if error is enabled
- * @param messageOrFunc Message string or function that returns message and metadata
- */
-export function errorIf(messageOrFunc) {
-    if (isErrorEnabled()) {
-        if (typeof messageOrFunc === 'string') {
-            logger.error(messageOrFunc);
-        }
-        else {
-            try {
-                const result = messageOrFunc();
-                if (result && typeof result === 'object' && 'message' in result) {
-                    const { message, meta } = result;
-                    if (meta) {
-                        logger.error(message, meta);
-                    }
-                    else {
-                        logger.error(message);
-                    }
-                }
-                else {
-                    // Fallback for malformed callback results
-                    logger.error('[errorIf: Invalid callback result]', { callbackResult: result });
-                }
-            }
-            catch (error) {
-                // Never let logging errors crash the application
-                // For errorIf, we use console.error as last resort to avoid recursion
-                console.error('errorIf callback failed:', error instanceof Error ? error.message : String(error));
-            }
-        }
-    }
+/** ADR 0011 local diagnostic projection. Never normalize or correlate backend records. */
+export function writeBackendDiagnostic(entry) {
+    if (!isBackendDiagnosticEntry(entry))
+        return;
+    sink.warn(`[${entry.displayName}] ${entry.content}`, {
+        serverName: entry.canonicalName,
+        source: 'backend-stderr',
+        backendLogSequence: entry.sequence,
+        backendLogSourceId: entry.sourceId,
+        backendLogEventKind: entry.kind,
+        ...(entry.count === undefined ? {} : { count: entry.count }),
+        ...(entry.truncated ? { truncated: true } : {}),
+    });
+}
+/** Legacy managed-stderr fallback is also a diagnostic-only local sink. */
+export function writeManagedStderrDiagnostic(event, metadata) {
+    if (![ManagedStdioStderrEvent.Line, ManagedStdioStderrEvent.Repeated, ManagedStdioStderrEvent.Suppressed].includes(event))
+        return;
+    const line = typeof metadata.line === 'string' ? sanitizeBackendLogContent(metadata.line) : '';
+    sink.warn(event, {
+        source: 'backend-stderr',
+        serverName: sanitizeBackendLogContent(metadata.serverName),
+        ...(line ? { line } : {}),
+        ...(metadata.repeatCount === undefined ? {} : { repeatCount: metadata.repeatCount }),
+        ...(metadata.suppressedCount === undefined ? {} : { suppressedCount: metadata.suppressedCount }),
+        ...(metadata.truncated ? { truncated: true } : {}),
+    });
 }
 export default logger;
 //# sourceMappingURL=logger.js.map