@zintrust/core 0.4.75 → 0.4.77

package/bin/zintrust-main.d.ts

@@ -4,6 +4,18 @@
  * This module contains the CLI implementation without a hashbang so that it can
  * be imported by other bin shortcuts (zin/z/zt) without parse errors.
  */
+type ProjectLocalCliTarget = {
+    binPath: string;
+    packageRoot: string;
+};
 export declare function run(): Promise<void>;
+export declare const CliLauncherInternal: Readonly<{
+    CLI_HANDOFF_ENV_KEY: "ZINTRUST_CLI_HANDOFF";
+    findProjectLocalCliTarget: (cwd: string) => ProjectLocalCliTarget | undefined;
+    getCurrentPackageRoot: () => string;
+    getRealPath: (targetPath: string) => string;
+    isWithinDirectory: (targetPath: string, possibleParentPath: string) => boolean;
+    resolveProjectLocalCliHandoff: (cwd: string, currentPackageRoot: string, env?: NodeJS.ProcessEnv) => ProjectLocalCliTarget | undefined;
+}>;
 export {};
 //# sourceMappingURL=zintrust-main.d.ts.map

package/bin/zintrust-main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqIH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAgFzC;AAED,OAAO,EAAE,CAAC"}
+{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAmTF,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAMzC;AAED,eAAO,MAAM,mBAAmB;;qCAjSQ,MAAM,KAAG,qBAAqB,GAAG,SAAS;iCAtBhD,MAAM;8BAIP,MAAM,KAAG,MAAM;oCAQT,MAAM,sBAAsB,MAAM,KAAG,OAAO;yCAqC5E,MAAM,sBACS,MAAM,QACrB,MAAM,CAAC,UAAU,KACrB,qBAAqB,GAAG,SAAS;EA0QlC,CAAC;AAEH,OAAO,EAAE,CAAC"}

package/bin/zintrust-main.js

@@ -5,9 +5,86 @@
  * be imported by other bin shortcuts (zin/z/zt) without parse errors.
  */
 import { Logger } from '../src/config/logger.js';
+import { spawnSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+const CLI_HANDOFF_ENV_KEY = 'ZINTRUST_CLI_HANDOFF';
+const getCurrentPackageRoot = () => {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+};
+const getRealPath = (targetPath) => {
+    try {
+        return fs.realpathSync(targetPath);
+    }
+    catch {
+        return path.resolve(targetPath);
+    }
+};
+const isWithinDirectory = (targetPath, possibleParentPath) => {
+    const normalizedTarget = getRealPath(targetPath);
+    const normalizedParent = getRealPath(possibleParentPath);
+    if (normalizedTarget === normalizedParent)
+        return true;
+    const relativePath = path.relative(normalizedParent, normalizedTarget);
+    return relativePath !== '' && !relativePath.startsWith('..') && !path.isAbsolute(relativePath);
+};
+const findProjectLocalCliTarget = (cwd) => {
+    let currentDir = path.resolve(cwd);
+    while (true) {
+        const packageRoot = path.join(currentDir, 'node_modules', '@zintrust', 'core');
+        const packageJsonPath = path.join(packageRoot, 'package.json');
+        const binCandidates = [
+            path.join(packageRoot, 'bin', 'zin.js'),
+            path.join(packageRoot, 'bin', 'zin.mjs'),
+            path.join(packageRoot, 'bin', 'zin.cjs'),
+            path.join(packageRoot, 'bin', 'zin.ts'),
+        ];
+        if (fs.existsSync(packageJsonPath)) {
+            const binPath = binCandidates.find((candidate) => fs.existsSync(candidate));
+            if (binPath !== undefined) {
+                return { binPath, packageRoot };
+            }
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            return undefined;
+        currentDir = parentDir;
+    }
+};
+const resolveProjectLocalCliHandoff = (cwd, currentPackageRoot, env = process.env) => {
+    if (env[CLI_HANDOFF_ENV_KEY] === '1')
+        return undefined;
+    if (isWithinDirectory(cwd, currentPackageRoot))
+        return undefined;
+    const target = findProjectLocalCliTarget(cwd);
+    if (target === undefined)
+        return undefined;
+    if (getRealPath(target.packageRoot) === getRealPath(currentPackageRoot)) {
+        return undefined;
+    }
+    return target;
+};
+const handoffToProjectLocalCli = (target, rawArgs) => {
+    const result = spawnSync(process.execPath, [target.binPath, ...rawArgs], {
+        stdio: 'inherit',
+        env: {
+            ...process.env,
+            [CLI_HANDOFF_ENV_KEY]: '1',
+        },
+    });
+    if (result.error !== undefined) {
+        throw result.error;
+    }
+    process.exit(typeof result.status === 'number' ? result.status : 1);
+};
+const maybeHandoffToProjectLocalCli = (rawArgs) => {
+    const localCliTarget = resolveProjectLocalCliHandoff(process.cwd(), getCurrentPackageRoot());
+    if (localCliTarget === undefined)
+        return false;
+    handoffToProjectLocalCli(localCliTarget, rawArgs);
+    return true;
+};
 const loadPackageVersionFast = () => {
     try {
         const here = path.dirname(fileURLToPath(import.meta.url));
@@ -33,6 +110,12 @@ const getArgsFromProcess = () => {
 const isVersionRequest = (args) => {
     return args.includes('-v') || args.includes('--version');
 };
+const maybePrintVersionAndExit = (args) => {
+    if (!isVersionRequest(args))
+        return false;
+    printFancyVersion(loadPackageVersionFast());
+    return true;
+};
 const printFancyVersion = (version) => {
     const framework = 'ZinTrust Framework';
     const bannerWidth = 46;
@@ -110,69 +193,81 @@ const handleCliFatal = async (error, context) => {
     }
     process.exit(1);
 };
-export async function run() {
+const runCliInternal = async () => {
+    const { rawArgs: rawArgs0, args: args0 } = getArgsFromProcess();
+    if (maybeHandoffToProjectLocalCli(rawArgs0)) {
+        return;
+    }
+    // Fast path: print version and exit without bootstrapping the CLI.
+    // This keeps `zin -v` / `zin --version` snappy and avoids any debug output.
+    if (maybePrintVersionAndExit(args0)) {
+        return;
+    }
+    const { EnvFileLoader } = await import('../src/cli/utils/EnvFileLoader.js');
+    EnvFileLoader.ensureLoaded();
+    // Auto-load install-only CLI extension packages that self-register commands.
+    let optionalCliExtensions;
+    let optionalCliStatuses = [];
     try {
-        // Fast path: print version and exit without bootstrapping the CLI.
-        // This keeps `zin -v` / `zin --version` snappy and avoids any debug output.
-        const { rawArgs: _rawArgs0, args: args0 } = getArgsFromProcess();
-        if (isVersionRequest(args0)) {
-            printFancyVersion(loadPackageVersionFast());
-            return;
-        }
-        const { EnvFileLoader } = await import('../src/cli/utils/EnvFileLoader.js');
-        EnvFileLoader.ensureLoaded();
-        // Auto-load install-only CLI extension packages that self-register commands.
-        let optionalCliExtensions;
-        let optionalCliStatuses = [];
-        try {
-            ({ OptionalCliExtensions: optionalCliExtensions } =
-                await import('../src/cli/OptionalCliExtensions.js'));
-            optionalCliStatuses = await optionalCliExtensions.loadForArgs(args0);
-        }
-        catch {
-            // best-effort; missing optional extensions must not block the CLI
+        ({ OptionalCliExtensions: optionalCliExtensions } = await import('../src/cli/OptionalCliExtensions.js'));
+        optionalCliStatuses = await optionalCliExtensions.loadForArgs(args0);
+    }
+    catch {
+        // best-effort; missing optional extensions must not block the CLI
+    }
+    const missingOptionalExtension = optionalCliExtensions?.findMissingExtensionForArgs(args0, optionalCliStatuses);
+    if (missingOptionalExtension !== undefined) {
+        const { ErrorFactory } = await import('../src/exceptions/ZintrustError.js');
+        throw ErrorFactory.createCliError(optionalCliExtensions?.getMissingExtensionMessage(missingOptionalExtension) ??
+            `Missing optional CLI package: ${missingOptionalExtension.packageName}`);
+    }
+    // Ensure project-installed adapters/drivers are registered for CLI commands.
+    // (This is driven by src/zintrust.plugins.ts generated by `zin plugin install`.)
+    try {
+        const { PluginAutoImports } = await import('../src/runtime/PluginAutoImports.js');
+        const runtimeImportMode = process.env['DOCKER_WORKER'] === 'true' ? 'worker' : 'base';
+        const officialImports = await PluginAutoImports.tryImportRuntimeAutoImports(runtimeImportMode);
+        if (!officialImports.ok) {
+            logPluginAutoImportFailure(args0, 'Official', officialImports.errorMessage);
         }
-        const missingOptionalExtension = optionalCliExtensions?.findMissingExtensionForArgs(args0, optionalCliStatuses);
-        if (missingOptionalExtension !== undefined) {
-            const { ErrorFactory } = await import('../src/exceptions/ZintrustError.js');
-            throw ErrorFactory.createCliError(optionalCliExtensions?.getMissingExtensionMessage(missingOptionalExtension) ??
-                `Missing optional CLI package: ${missingOptionalExtension.packageName}`);
+        const projectImports = await PluginAutoImports.tryImportProjectAutoImports();
+        if (!projectImports.ok && projectImports.reason !== 'not-found') {
+            logPluginAutoImportFailure(args0, 'Project', projectImports.errorMessage);
         }
-        // Ensure project-installed adapters/drivers are registered for CLI commands.
-        // (This is driven by src/zintrust.plugins.ts generated by `zin plugin install`.)
+    }
+    catch {
+        // best-effort; CLI should still run even if plugins file is missing
+    }
+    const { CLI } = await import('../src/cli/CLI.js');
+    const cli = CLI.create();
+    // When executing via tsx (e.g. `npx tsx bin/zin.ts ...`), the script path can
+    // appear as the first element of `process.argv.slice(2)`. Commander expects
+    // args to start at the command name, so we strip a leading script path if present.
+    const { rawArgs, args } = getArgsFromProcess();
+    if (shouldDebugArgs(rawArgs)) {
         try {
-            const { PluginAutoImports } = await import('../src/runtime/PluginAutoImports.js');
-            const runtimeImportMode = process.env['DOCKER_WORKER'] === 'true' ? 'worker' : 'base';
-            const officialImports = await PluginAutoImports.tryImportRuntimeAutoImports(runtimeImportMode);
-            if (!officialImports.ok) {
-                logPluginAutoImportFailure(args0, 'Official', officialImports.errorMessage);
-            }
-            const projectImports = await PluginAutoImports.tryImportProjectAutoImports();
-            if (!projectImports.ok && projectImports.reason !== 'not-found') {
-                logPluginAutoImportFailure(args0, 'Project', projectImports.errorMessage);
-            }
+            process.stderr.write(`[zintrust-cli] process.argv=${JSON.stringify(process.argv)}\n`);
+            process.stderr.write(`[zintrust-cli] rawArgs=${JSON.stringify(rawArgs)}\n`);
         }
         catch {
-            // best-effort; CLI should still run even if plugins file is missing
-        }
-        const { CLI } = await import('../src/cli/CLI.js');
-        const cli = CLI.create();
-        // When executing via tsx (e.g. `npx tsx bin/zin.ts ...`), the script path can
-        // appear as the first element of `process.argv.slice(2)`. Commander expects
-        // args to start at the command name, so we strip a leading script path if present.
-        const { rawArgs, args } = getArgsFromProcess();
-        if (shouldDebugArgs(rawArgs)) {
-            try {
-                process.stderr.write(`[zintrust-cli] process.argv=${JSON.stringify(process.argv)}\n`);
-                process.stderr.write(`[zintrust-cli] rawArgs=${JSON.stringify(rawArgs)}\n`);
-            }
-            catch {
-                // ignore
-            }
+            // ignore
         }
-        await cli.run(normalizeProxyTargetArgs(args));
+    }
+    await cli.run(normalizeProxyTargetArgs(args));
+};
+export async function run() {
+    try {
+        await runCliInternal();
     }
     catch (error) {
         await handleCliFatal(error, 'CLI execution failed');
     }
 }
+export const CliLauncherInternal = Object.freeze({
+    CLI_HANDOFF_ENV_KEY,
+    findProjectLocalCliTarget,
+    getCurrentPackageRoot,
+    getRealPath,
+    isWithinDirectory,
+    resolveProjectLocalCliHandoff,
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.75",
+  "version": "0.4.77",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {

package/src/boot/registry/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AASvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAuO9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA6BlF,CAAC;AAyRF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CA0F7D,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AASvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA2O9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA6BlF,CAAC;AAqUF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CA0F7D,CAAC"}

package/src/boot/registry/runtime.js

@@ -40,18 +40,18 @@ const importFromExistingCandidates = async (moduleCandidates) => {
     }
     return undefined;
 };
-const loadLocalSystemDebuggerModule = async () => {
-    const globalDebuggerPluginState = globalThis;
-    if (globalDebuggerPluginState.__zintrust_system_debugger_runtime__ !== undefined) {
-        return globalDebuggerPluginState.__zintrust_system_debugger_runtime__;
+const loadLocalSystemTraceModule = async () => {
+    const globalTracePluginState = globalThis;
+    if (globalTracePluginState.__zintrust_system_trace_runtime__ !== undefined) {
+        return globalTracePluginState.__zintrust_system_trace_runtime__;
     }
     const projectRoot = typeof process !== 'undefined' && typeof process.cwd === 'function' ? process.cwd() : '';
     if (projectRoot !== '') {
         const moduleCandidates = [
-            path.join(projectRoot, 'src', 'runtime', 'plugins', 'system-debugger-runtime.ts'),
-            path.join(projectRoot, 'src', 'runtime', 'plugins', 'system-debugger-runtime.js'),
-            path.join(projectRoot, 'dist', 'runtime', 'plugins', 'system-debugger-runtime.js'),
-            path.join(projectRoot, 'dist', 'src', 'runtime', 'plugins', 'system-debugger-runtime.js'),
+            path.join(projectRoot, 'src', 'runtime', 'plugins', 'trace-runtime.ts'),
+            path.join(projectRoot, 'src', 'runtime', 'plugins', 'trace-runtime.js'),
+            path.join(projectRoot, 'dist', 'runtime', 'plugins', 'trace-runtime.js'),
+            path.join(projectRoot, 'dist', 'src', 'runtime', 'plugins', 'trace-runtime.js'),
         ];
         const localModule = await importFromExistingCandidates(moduleCandidates);
         if (localModule !== undefined) {
@@ -61,7 +61,7 @@ const loadLocalSystemDebuggerModule = async () => {
             return localModule;
         }
     }
-    return tryImportOptional('@runtime/plugins/system-debugger-runtime');
+    return tryImportOptional('@runtime/plugins/trace-runtime');
 };
 const loadRuntimeQueueConfig = async () => {
     const startupQueueConfig = getStartupQueueConfig();
@@ -380,32 +380,67 @@ const initializeScheduleHttpGateway = async (router) => {
         Logger.warn('Failed to register Schedule HTTP gateway routes', error);
     }
 };
-const isDebuggerEnabled = () => {
-    const raw = readEnvString('DEBUGGER_ENABLED').trim().toLowerCase();
+const isTraceEnabled = () => {
+    const raw = readEnvString('TRACE_ENABLED').trim().toLowerCase();
     return raw === '1' || raw === 'true';
 };
-const isSystemDebuggerPluginRequested = () => {
-    const globalDebuggerPluginState = globalThis;
-    return globalDebuggerPluginState.__zintrust_system_debugger_plugin_requested__ === true;
+const isTraceDashboardAutoMountEnabled = () => {
+    const raw = readEnvString('TRACE_AUTO_MOUNT').trim().toLowerCase();
+    return raw === '1' || raw === 'true';
+};
+const resolveTraceDashboardBasePath = () => {
+    const raw = readEnvString('TRACE_BASE_PATH').trim();
+    if (raw === '')
+        return '/trace';
+    return raw.startsWith('/') ? raw : `/${raw}`;
+};
+const resolveTraceDashboardMiddleware = () => {
+    return readEnvString('TRACE_MIDDLEWARE')
+        .split(',')
+        .map((value) => value.trim())
+        .filter(isNonEmptyString);
 };
-const initializeSystemDebugger = async () => {
-    if (!isSystemDebuggerPluginRequested()) {
-        Logger.debug('System Debugger plugin is not enabled in zintrust.plugins.*. Skipping init.');
+const isSystemTracePluginRequested = () => {
+    const globalTracePluginState = globalThis;
+    return globalTracePluginState.__zintrust_system_trace_plugin_requested__ === true;
+};
+const initializeSystemTrace = async (router) => {
+    if (!isSystemTracePluginRequested()) {
+        Logger.debug('System Trace plugin is not enabled in zintrust.plugins.*. Skipping init.');
         return;
     }
-    if (!isDebuggerEnabled())
+    if (!isTraceEnabled())
         return;
-    const debuggerModule = (await tryImportOptional('@runtime/plugins/system-debugger-runtime')) ?? (await loadLocalSystemDebuggerModule());
-    if (debuggerModule === undefined || debuggerModule.isAvailable?.() === false) {
-        Logger.debug('System Debugger is enabled but the optional package is unavailable.');
+    const traceModule = (await tryImportOptional('@runtime/plugins/trace-runtime')) ??
+        (await loadLocalSystemTraceModule());
+    if (traceModule === undefined) {
+        Logger.debug('System Trace is enabled but the optional package is unavailable.');
         return;
     }
     try {
-        await debuggerModule.ensureSystemDebuggerRegistered();
-        Logger.info('System Debugger runtime activated. Register dashboard routes manually if needed.');
+        await traceModule.ensureSystemTraceRegistered();
+        if (traceModule.isAvailable?.() === false) {
+            Logger.debug('System Trace is enabled but the optional package is unavailable.');
+            return;
+        }
+        if (!isTraceDashboardAutoMountEnabled()) {
+            Logger.info('System Trace runtime activated. Set TRACE_AUTO_MOUNT=true or register dashboard routes manually if needed.');
+            return;
+        }
+        if (typeof traceModule.registerTraceDashboard !== 'function') {
+            Logger.warn('System Trace auto-mount requested but the optional package does not expose registerTraceDashboard.');
+            return;
+        }
+        const basePath = resolveTraceDashboardBasePath();
+        const middleware = resolveTraceDashboardMiddleware();
+        traceModule.registerTraceDashboard(router, {
+            basePath,
+            ...(middleware.length > 0 ? { middleware } : {}),
+        });
+        Logger.info(`System Trace dashboard auto-mounted at ${basePath}.`);
     }
     catch (error) {
-        Logger.warn('Failed to initialize System Debugger runtime', error);
+        Logger.warn('Failed to initialize System Trace runtime', error);
     }
 };
 const initializeSockets = (router) => {
@@ -473,7 +508,7 @@ export const createLifecycle = (params) => {
         await initializeArtifactDirectories(params.resolvedBasePath);
         await registerMasterRoutes(params.resolvedBasePath, params.router);
         initializeSockets(params.router);
-        await initializeSystemDebugger();
+        await initializeSystemTrace(params.router);
         if (Cloudflare.getWorkersEnv() === null && appConfig.dockerWorker === false) {
             await initializeWorkers(params.router);
             await initializeQueueMonitor(params.router);

package/src/cache/Cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/Cache.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA8JtD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,WAAW,CAAC;CAC9B,CAAC,CAAC;AA8DH,eAAO,MAAM,KAAK;UA5HC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAWlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAUjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAUtB,OAAO,CAAC,IAAI,CAAC;eASb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAW3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuDvB,IAAI;EAcpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;UA1IC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAWlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAUjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAUtB,OAAO,CAAC,IAAI,CAAC;eASb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAW3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuDvB,IAAI;EAmBI,CAAC"}
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/Cache.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA6JtD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,WAAW,CAAC;CAC9B,CAAC,CAAC;AA8DH,eAAO,MAAM,KAAK;UA5HC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAWlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAUjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAUtB,OAAO,CAAC,IAAI,CAAC;eASb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAW3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuDvB,IAAI;EAcpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;UA1IC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAWlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAUjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAUtB,OAAO,CAAC,IAAI,CAAC;eASb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAW3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuDvB,IAAI;EAmBI,CAAC"}

package/src/cache/Cache.js

@@ -4,6 +4,7 @@
  * Central cache management and driver resolution
  * Sealed namespace pattern - all exports through Cache namespace
  */
+import { SystemTraceBridge } from '../trace/SystemTraceBridge.js';
 import { CacheDriverRegistry } from './CacheDriverRegistry.js';
 import { KVDriver } from './drivers/KVDriver.js';
 import { KVRemoteDriver } from './drivers/KVRemoteDriver.js';
@@ -11,7 +12,6 @@ import { MemoryDriver } from './drivers/MemoryDriver.js';
 import { MongoDriver } from './drivers/MongoDriver.js';
 import { RedisDriver } from './drivers/RedisDriver.js';
 import { cacheConfig } from '../config/cache.js';
-import { SystemDebuggerBridge } from '../debugger/SystemDebuggerBridge.js';
 import { Env } from '../config/env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 const instances = new Map();
@@ -88,7 +88,7 @@ const get = async (key) => {
     const prefixedKey = autoPrefixKey(key);
     const startedAt = Date.now();
     const value = await getDriverInstance().get(prefixedKey);
-    SystemDebuggerBridge.emitCache('get', prefixedKey, Date.now() - startedAt, value !== null);
+    SystemTraceBridge.emitCache('get', prefixedKey, Date.now() - startedAt, value !== null);
     return value;
 };
 /**
@@ -98,7 +98,7 @@ const set = async (key, value, ttl) => {
     const prefixedKey = autoPrefixKey(key);
     const startedAt = Date.now();
     await getDriverInstance().set(prefixedKey, value, ttl);
-    SystemDebuggerBridge.emitCache('set', prefixedKey, Date.now() - startedAt);
+    SystemTraceBridge.emitCache('set', prefixedKey, Date.now() - startedAt);
 };
 /**
  * Remove an item from the cache
@@ -107,7 +107,7 @@ const del = async (key) => {
     const prefixedKey = autoPrefixKey(key);
     const startedAt = Date.now();
     await getDriverInstance().delete(prefixedKey);
-    SystemDebuggerBridge.emitCache('delete', prefixedKey, Date.now() - startedAt);
+    SystemTraceBridge.emitCache('delete', prefixedKey, Date.now() - startedAt);
 };
 /**
  * Clear all items from the cache
@@ -115,7 +115,7 @@ const del = async (key) => {
 const clear = async () => {
     const startedAt = Date.now();
     await getDriverInstance().clear();
-    SystemDebuggerBridge.emitCache('clear', 'zt:*', Date.now() - startedAt);
+    SystemTraceBridge.emitCache('clear', 'zt:*', Date.now() - startedAt);
 };
 /**
  * Check if an item exists in the cache
@@ -124,7 +124,7 @@ const has = async (key) => {
     const prefixedKey = autoPrefixKey(key);
     const startedAt = Date.now();
     const exists = await getDriverInstance().has(prefixedKey);
-    SystemDebuggerBridge.emitCache('has', prefixedKey, Date.now() - startedAt, exists);
+    SystemTraceBridge.emitCache('has', prefixedKey, Date.now() - startedAt, exists);
     return exists;
 };
 /**
@@ -138,31 +138,31 @@ const store = (name) => {
         const prefixedKey = autoPrefixKey(key);
         const startedAt = Date.now();
         const value = await getDriverInstance(name).get(prefixedKey);
-        SystemDebuggerBridge.emitCache('get', prefixedKey, Date.now() - startedAt, value !== null);
+        SystemTraceBridge.emitCache('get', prefixedKey, Date.now() - startedAt, value !== null);
         return value;
     };
     const setInStore = async (key, value, ttl) => {
         const prefixedKey = autoPrefixKey(key);
         const startedAt = Date.now();
         await getDriverInstance(name).set(prefixedKey, value, ttl);
-        SystemDebuggerBridge.emitCache('set', prefixedKey, Date.now() - startedAt);
+        SystemTraceBridge.emitCache('set', prefixedKey, Date.now() - startedAt);
     };
     const delFromStore = async (key) => {
         const prefixedKey = autoPrefixKey(key);
         const startedAt = Date.now();
         await getDriverInstance(name).delete(prefixedKey);
-        SystemDebuggerBridge.emitCache('delete', prefixedKey, Date.now() - startedAt);
+        SystemTraceBridge.emitCache('delete', prefixedKey, Date.now() - startedAt);
     };
     const clearStore = async () => {
         const startedAt = Date.now();
         await getDriverInstance(name).clear();
-        SystemDebuggerBridge.emitCache('clear', `store:${String(name ?? 'default')}`, Date.now() - startedAt);
+        SystemTraceBridge.emitCache('clear', `store:${String(name ?? 'default')}`, Date.now() - startedAt);
     };
     const hasInStore = async (key) => {
         const prefixedKey = autoPrefixKey(key);
         const startedAt = Date.now();
         const exists = await getDriverInstance(name).has(prefixedKey);
-        SystemDebuggerBridge.emitCache('has', prefixedKey, Date.now() - startedAt, exists);
+        SystemTraceBridge.emitCache('has', prefixedKey, Date.now() - startedAt, exists);
         return exists;
     };
     const getStoreDriver = () => {

package/src/cli/BaseCommand.js

@@ -2,7 +2,7 @@
  * Base Command - Abstract Command Class
  * All CLI commands extend this class
  */
-import { SystemDebuggerBridge } from '../debugger/SystemDebuggerBridge.js';
+import { SystemTraceBridge } from '../trace/SystemTraceBridge.js';
 import { ErrorHandler } from './ErrorHandler.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { Command } from 'commander';
@@ -44,11 +44,11 @@ export const BaseCommand = Object.freeze({
                 const startedAt = Date.now();
                 try {
                     await config.execute(options);
-                    SystemDebuggerBridge.emitCommand(config.name, toCommandArguments(options), 0, Date.now() - startedAt);
+                    SystemTraceBridge.emitCommand(config.name, toCommandArguments(options), 0, Date.now() - startedAt);
                 }
                 catch (error) {
                     const message = error instanceof Error ? error.message : String(error);
-                    SystemDebuggerBridge.emitCommand(config.name, toCommandArguments(options), 1, Date.now() - startedAt, message);
+                    SystemTraceBridge.emitCommand(config.name, toCommandArguments(options), 1, Date.now() - startedAt, message);
                     if (error instanceof Error) {
                         ErrorFactory.createTryCatchError('Command execution failed', error);
                         ErrorHandler.handle(error, undefined, false);

package/src/cli/OptionalCliExtensions.js

@@ -64,15 +64,15 @@ const OPTIONAL_CLI_EXTENSIONS = Object.freeze([
         ],
     },
     {
-        packageName: '@zintrust/system-debugger',
-        specifier: '@zintrust/system-debugger/cli-register',
-        commands: ['debugger:prune', 'debugger:clear', 'debugger:status', 'migrate:debugger'],
-        installCommand: 'npm install @zintrust/system-debugger',
+        packageName: '@zintrust/trace',
+        specifier: '@zintrust/trace/cli-register',
+        commands: ['trace:prune', 'trace:clear', 'trace:status', 'migrate:trace'],
+        installCommand: 'npm install @zintrust/trace',
         localCandidates: [
-            path.join(packageRoot, 'packages', 'system-debugger', 'src', 'cli-register.ts'),
-            path.join(packageRoot, 'packages', 'system-debugger', 'src', 'cli-register.js'),
-            path.join(packageRoot, 'packages', 'system-debugger', 'dist', 'cli-register.js'),
-            path.join(packageRoot, 'dist', 'packages', 'system-debugger', 'src', 'cli-register.js'),
+            path.join(packageRoot, 'packages', 'trace', 'src', 'cli-register.ts'),
+            path.join(packageRoot, 'packages', 'trace', 'src', 'cli-register.js'),
+            path.join(packageRoot, 'packages', 'trace', 'dist', 'cli-register.js'),
+            path.join(packageRoot, 'dist', 'packages', 'trace', 'src', 'cli-register.js'),
         ],
     },
     {

package/src/cli/commands/MigrateCommand.js

@@ -215,7 +215,7 @@ const warnIfAdapterMissing = (cmd, conn) => {
     if (conn.driver === 'mysql' && DatabaseAdapterRegistry.get('mysql') === undefined) {
         cmd.warn('MySQL adapter is not installed/registered; migrations may not hit a real MySQL DB.');
         cmd.warn('Install via `zin plugin install adapter:mysql` (or `zin add db:mysql`).');
-        cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "@zintrust/db-mysql/register";');
+        cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "../../../packages/db-mysql/src/register";');
     }
     if (conn.driver === 'postgresql' && DatabaseAdapterRegistry.get('postgresql') === undefined) {
         cmd.warn('PostgreSQL adapter is not installed/registered; migrations may not hit a real PostgreSQL DB.');

package/src/cli/commands/TraceCommand.d.ts

@@ -0,0 +1,18 @@
+export { TraceCommands } from '../commands/TraceCommands';
+export declare const TracePruneCommand: Readonly<{
+    name: string;
+    getCommand: () => import("commander").Command;
+}>;
+export declare const TraceClearCommand: Readonly<{
+    name: string;
+    getCommand: () => import("commander").Command;
+}>;
+export declare const TraceStatusCommand: Readonly<{
+    name: string;
+    getCommand: () => import("commander").Command;
+}>;
+export declare const TraceMigrateCommand: Readonly<{
+    name: string;
+    getCommand: () => import("commander").Command;
+}>;
+//# sourceMappingURL=TraceCommand.d.ts.map

package/src/cli/commands/TraceCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/TraceCommand.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,eAAO,MAAM,iBAAiB;;;EAA2C,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;EAA2C,CAAC;AAE1E,eAAO,MAAM,kBAAkB;;;EAA4C,CAAC;AAE5E,eAAO,MAAM,mBAAmB;;;EAA6C,CAAC"}

package/src/cli/commands/TraceCommand.js

@@ -0,0 +1,6 @@
+import { TraceCommands } from '../commands/TraceCommands.js';
+export { TraceCommands } from '../commands/TraceCommands.js';
+export const TracePruneCommand = TraceCommands.createTracePruneProvider();
+export const TraceClearCommand = TraceCommands.createTraceClearProvider();
+export const TraceStatusCommand = TraceCommands.createTraceStatusProvider();
+export const TraceMigrateCommand = TraceCommands.createTraceMigrateProvider();

package/src/cli/commands/TraceCommands.d.ts

@@ -0,0 +1,25 @@
+import type { IBaseCommand } from '../BaseCommand';
+import type { Command } from 'commander';
+export declare const TraceCommands: Readonly<{
+    createTracePruneCommand: () => IBaseCommand;
+    createTraceClearCommand: () => IBaseCommand;
+    createTraceStatusCommand: () => IBaseCommand;
+    createTraceMigrateCommand: () => IBaseCommand;
+    createTracePruneProvider: () => Readonly<{
+        name: string;
+        getCommand: () => Command;
+    }>;
+    createTraceClearProvider: () => Readonly<{
+        name: string;
+        getCommand: () => Command;
+    }>;
+    createTraceStatusProvider: () => Readonly<{
+        name: string;
+        getCommand: () => Command;
+    }>;
+    createTraceMigrateProvider: () => Readonly<{
+        name: string;
+        getCommand: () => Command;
+    }>;
+}>;
+//# sourceMappingURL=TraceCommands.d.ts.map

package/src/cli/commands/TraceCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceCommands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/TraceCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAsBrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgqBzC,eAAO,MAAM,aAAa;mCACK,YAAY;mCAQZ,YAAY;oCAQX,YAAY;qCAQX,YAAY;;cAhCzB,MAAM;oBAAc,MAAM,OAAO;;;cAAjC,MAAM;oBAAc,MAAM,OAAO;;;cAAjC,MAAM;oBAAc,MAAM,OAAO;;;cAAjC,MAAM;oBAAc,MAAM,OAAO;;EAmDnD,CAAC"}