@zintrust/core 1.5.5 → 1.6.1

package/bin/launcher.d.ts

@@ -0,0 +1,6 @@
+type RunCliWrapperInput = {
+    traceName?: string;
+};
+export declare const runCliWrapper: (input?: RunCliWrapperInput) => Promise<void>;
+export {};
+//# sourceMappingURL=launcher.d.ts.map

package/bin/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../bin/launcher.ts"],"names":[],"mappings":"AAMA,KAAK,kBAAkB,GAAG;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA6LF,eAAO,MAAM,aAAa,GAAU,QAAO,kBAAuB,KAAG,OAAO,CAAC,IAAI,CAoBhF,CAAC"}

package/bin/launcher.js

@@ -0,0 +1,167 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const CLI_SPAWN_TRACE_ENV_KEYS = ['CLI_SPAWN_TRACE', 'ZIN_SPAWN_TRACE'];
+const here = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const isCliSpawnTraceEnabled = () => {
+    return CLI_SPAWN_TRACE_ENV_KEYS.some((key) => {
+        const raw = process.env[key];
+        if (typeof raw !== 'string')
+            return false;
+        const normalized = raw.trim().toLowerCase();
+        return (normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on');
+    });
+};
+const writeCliSpawnTrace = (input, label, details = {}) => {
+    if (input.traceName === undefined || !isCliSpawnTraceEnabled())
+        return;
+    process.stderr.write(`${JSON.stringify({ trace: input.traceName, label, pid: process.pid, details })}\n`);
+};
+const resolveNodeArgs = () => {
+    const tsTarget = path.join(here, 'zintrust-main.ts');
+    const jsTarget = path.join(here, 'zintrust-main.js');
+    const target = existsSync(tsTarget) ? tsTarget : jsTarget;
+    if (!target.endsWith('.ts')) {
+        return [target, ...process.argv.slice(2)];
+    }
+    return ['--import', require.resolve('tsx'), target, ...process.argv.slice(2)];
+};
+const getExitCode = (exitCode, signal) => {
+    if (typeof exitCode === 'number')
+        return exitCode;
+    if (signal === 'SIGINT' || signal === 'SIGTERM')
+        return 0;
+    return 1;
+};
+const attachOutputRelay = (input, child, stream) => {
+    const childStream = child[stream];
+    const targetStream = stream === 'stdout' ? process.stdout : process.stderr;
+    childStream?.on('data', (chunk) => {
+        writeCliSpawnTrace(input, `wrapper.child.${stream}.data`, {
+            childPid: child.pid,
+            bytes: typeof chunk === 'string' ? Buffer.byteLength(chunk) : chunk.length,
+        });
+        targetStream.write(chunk);
+    });
+};
+const waitForChildClose = async (input, child, onBeforeResolve) => {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let childResult = {
+            exitCode: null,
+            signal: null,
+        };
+        const finalize = () => {
+            if (settled)
+                return;
+            settled = true;
+            onBeforeResolve();
+            child.off?.('error', reject);
+            child.off?.('exit', handleExit);
+            child.off?.('close', handleClose);
+            writeCliSpawnTrace(input, 'wrapper.child.finalize', {
+                childPid: child.pid,
+                exitCode: childResult.exitCode,
+                signal: childResult.signal,
+            });
+            resolve(childResult);
+        };
+        const handleExit = (exitCode, signal) => {
+            childResult = { exitCode, signal };
+        };
+        const handleClose = (exitCode, signal) => {
+            childResult = {
+                exitCode: childResult.exitCode ?? exitCode,
+                signal: childResult.signal ?? signal,
+            };
+            finalize();
+        };
+        child.once('error', reject);
+        child.once('exit', handleExit);
+        child.once('close', handleClose);
+    });
+};
+const registerSignalHandlers = (input, child) => {
+    let childClosed = false;
+    let delayedSignalTimer;
+    const clearDelayedSignal = () => {
+        if (delayedSignalTimer === undefined)
+            return;
+        clearTimeout(delayedSignalTimer);
+        delayedSignalTimer = undefined;
+    };
+    const forwardSignal = (signal) => {
+        if (childClosed)
+            return;
+        try {
+            writeCliSpawnTrace(input, 'wrapper.signal.forward', {
+                childPid: child.pid,
+                signal,
+            });
+            child.kill(signal);
+        }
+        catch {
+            // best-effort
+        }
+    };
+    const scheduleSignalForward = (signal) => {
+        if (childClosed || delayedSignalTimer !== undefined)
+            return;
+        delayedSignalTimer = globalThis.setTimeout(() => {
+            delayedSignalTimer = undefined;
+            writeCliSpawnTrace(input, 'wrapper.signal.delay.fire', {
+                childPid: child.pid,
+                signal,
+            });
+            forwardSignal(signal);
+        }, 1500);
+        writeCliSpawnTrace(input, 'wrapper.signal.delay.schedule', {
+            childPid: child.pid,
+            signal,
+            delayMs: 1500,
+        });
+        delayedSignalTimer.unref?.();
+    };
+    const onSigint = () => {
+        if (process.stdin.isTTY === true) {
+            scheduleSignalForward('SIGINT');
+            return;
+        }
+        forwardSignal('SIGINT');
+    };
+    const onSigterm = () => {
+        if (process.stdin.isTTY === true) {
+            scheduleSignalForward('SIGTERM');
+            return;
+        }
+        forwardSignal('SIGTERM');
+    };
+    process.on('SIGINT', onSigint);
+    process.on('SIGTERM', onSigterm);
+    return () => {
+        childClosed = true;
+        clearDelayedSignal();
+        process.off('SIGINT', onSigint);
+        process.off('SIGTERM', onSigterm);
+    };
+};
+export const runCliWrapper = async (input = {}) => {
+    const nodeArgs = resolveNodeArgs();
+    const child = spawn(process.execPath, nodeArgs, {
+        stdio: ['inherit', 'pipe', 'pipe'],
+        env: process.env,
+    });
+    writeCliSpawnTrace(input, 'wrapper.child.started', {
+        childPid: child.pid,
+        command: process.execPath,
+        args: nodeArgs,
+    });
+    attachOutputRelay(input, child, 'stdout');
+    attachOutputRelay(input, child, 'stderr');
+    const unregisterSignalHandlers = registerSignalHandlers(input, child);
+    const result = await waitForChildClose(input, child, unregisterSignalHandlers);
+    process.exit(getExitCode(result.exitCode, result.signal));
+};

package/bin/z.js

@@ -3,105 +3,5 @@
  * ZinTrust CLI Shortcut - 'z'
  * Mirrors bin/zintrust.ts for convenience
  */
-import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-const here = path.dirname(fileURLToPath(import.meta.url));
-const require = createRequire(import.meta.url);
-const tsTarget = path.join(here, 'zintrust-main.ts');
-const jsTarget = path.join(here, 'zintrust-main.js');
-const target = existsSync(tsTarget) ? tsTarget : jsTarget;
-const tsxImportPath = require.resolve('tsx');
-const nodeArgs = target.endsWith('.ts')
-    ? ['--import', tsxImportPath, target, ...process.argv.slice(2)]
-    : [target, ...process.argv.slice(2)];
-const child = spawn(process.execPath, nodeArgs, {
-    stdio: ['inherit', 'pipe', 'pipe'],
-    env: process.env,
-});
-child.stdout?.on('data', (chunk) => {
-    process.stdout.write(chunk);
-});
-child.stderr?.on('data', (chunk) => {
-    process.stderr.write(chunk);
-});
-let childClosed = false;
-let delayedSignalTimer;
-const clearDelayedSignal = () => {
-    if (delayedSignalTimer === undefined)
-        return;
-    clearTimeout(delayedSignalTimer);
-    delayedSignalTimer = undefined;
-};
-const forwardSignal = (signal) => {
-    if (childClosed)
-        return;
-    try {
-        child.kill(signal);
-    }
-    catch {
-        // best-effort
-    }
-};
-const scheduleSignalForward = (signal) => {
-    if (childClosed || delayedSignalTimer !== undefined)
-        return;
-    delayedSignalTimer = globalThis.setTimeout(() => {
-        delayedSignalTimer = undefined;
-        forwardSignal(signal);
-    }, 1500);
-    delayedSignalTimer.unref?.();
-};
-const onSigint = () => {
-    if (process.stdin.isTTY === true) {
-        scheduleSignalForward('SIGINT');
-        return;
-    }
-    forwardSignal('SIGINT');
-};
-const onSigterm = () => {
-    if (process.stdin.isTTY === true) {
-        scheduleSignalForward('SIGTERM');
-        return;
-    }
-    forwardSignal('SIGTERM');
-};
-process.on('SIGINT', onSigint);
-process.on('SIGTERM', onSigterm);
-const result = await new Promise((resolve, reject) => {
-    let settled = false;
-    let childResult = {
-        exitCode: null,
-        signal: null,
-    };
-    const finalize = () => {
-        if (settled) {
-            return;
-        }
-        settled = true;
-        childClosed = true;
-        clearDelayedSignal();
-        process.off('SIGINT', onSigint);
-        process.off('SIGTERM', onSigterm);
-        child.off?.('error', reject);
-        child.off?.('exit', handleExit);
-        child.off?.('close', handleClose);
-        resolve(childResult);
-    };
-    const handleExit = (exitCode, signal) => {
-        childResult = { exitCode, signal };
-    };
-    const handleClose = (exitCode, signal) => {
-        childResult = {
-            exitCode: childResult.exitCode ?? exitCode,
-            signal: childResult.signal ?? signal,
-        };
-        finalize();
-    };
-    child.once('error', reject);
-    child.once('exit', handleExit);
-    child.once('close', handleClose);
-});
-process.exit(result.exitCode ?? (result.signal === 'SIGINT' || result.signal === 'SIGTERM' ? 0 : 1));
+import { runCliWrapper } from './launcher.js';
+await runCliWrapper();

package/bin/zin.js

@@ -3,195 +3,5 @@
  * ZinTrust CLI Shortcut - 'zin'
  * Mirrors bin/zintrust.ts for convenience
  */
-import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-const CLI_SPAWN_TRACE_ENV_KEYS = ['CLI_SPAWN_TRACE', 'ZIN_SPAWN_TRACE'];
-const isCliSpawnTraceEnabled = () => {
-    return CLI_SPAWN_TRACE_ENV_KEYS.some((key) => {
-        const raw = process.env[key];
-        if (typeof raw !== 'string')
-            return false;
-        const normalized = raw.trim().toLowerCase();
-        return (normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on');
-    });
-};
-const writeCliSpawnTrace = (label, details = {}) => {
-    if (!isCliSpawnTraceEnabled())
-        return;
-    process.stderr.write(`${JSON.stringify({ trace: 'cli-wrapper', label, pid: process.pid, details })}\n`);
-};
-const here = path.dirname(fileURLToPath(import.meta.url));
-const require = createRequire(import.meta.url);
-const tsTarget = path.join(here, 'zintrust-main.ts');
-const jsTarget = path.join(here, 'zintrust-main.js');
-const target = existsSync(tsTarget) ? tsTarget : jsTarget;
-const tsxImportPath = require.resolve('tsx');
-const nodeArgs = target.endsWith('.ts')
-    ? ['--import', tsxImportPath, target, ...process.argv.slice(2)]
-    : [target, ...process.argv.slice(2)];
-const child = spawn(process.execPath, nodeArgs, {
-    stdio: ['inherit', 'pipe', 'pipe'],
-    env: process.env,
-});
-writeCliSpawnTrace('wrapper.child.started', {
-    childPid: child.pid,
-    command: process.execPath,
-    args: nodeArgs,
-});
-child.stdout?.on('data', (chunk) => {
-    writeCliSpawnTrace('wrapper.child.stdout.data', {
-        childPid: child.pid,
-        bytes: typeof chunk === 'string' ? Buffer.byteLength(chunk) : chunk.length,
-    });
-    process.stdout.write(chunk);
-});
-child.stdout?.on('end', () => {
-    writeCliSpawnTrace('wrapper.child.stdout.end', {
-        childPid: child.pid,
-    });
-});
-child.stdout?.on('close', () => {
-    writeCliSpawnTrace('wrapper.child.stdout.close', {
-        childPid: child.pid,
-    });
-});
-child.stderr?.on('data', (chunk) => {
-    writeCliSpawnTrace('wrapper.child.stderr.data', {
-        childPid: child.pid,
-        bytes: typeof chunk === 'string' ? Buffer.byteLength(chunk) : chunk.length,
-    });
-    process.stderr.write(chunk);
-});
-child.stderr?.on('end', () => {
-    writeCliSpawnTrace('wrapper.child.stderr.end', {
-        childPid: child.pid,
-    });
-});
-child.stderr?.on('close', () => {
-    writeCliSpawnTrace('wrapper.child.stderr.close', {
-        childPid: child.pid,
-    });
-});
-let childClosed = false;
-let delayedSignalTimer;
-const clearDelayedSignal = () => {
-    if (delayedSignalTimer === undefined)
-        return;
-    clearTimeout(delayedSignalTimer);
-    delayedSignalTimer = undefined;
-};
-const forwardSignal = (signal) => {
-    if (childClosed)
-        return;
-    try {
-        writeCliSpawnTrace('wrapper.signal.forward.attempt', {
-            childPid: child.pid,
-            signal,
-        });
-        child.kill(signal);
-        writeCliSpawnTrace('wrapper.signal.forward.complete', {
-            childPid: child.pid,
-            signal,
-        });
-    }
-    catch {
-        // best-effort
-    }
-};
-const scheduleSignalForward = (signal) => {
-    if (childClosed || delayedSignalTimer !== undefined)
-        return;
-    delayedSignalTimer = globalThis.setTimeout(() => {
-        delayedSignalTimer = undefined;
-        writeCliSpawnTrace('wrapper.signal.delay.fire', {
-            childPid: child.pid,
-            signal,
-        });
-        forwardSignal(signal);
-    }, 1500);
-    writeCliSpawnTrace('wrapper.signal.delay.schedule', {
-        childPid: child.pid,
-        signal,
-        delayMs: 1500,
-    });
-    delayedSignalTimer.unref?.();
-};
-const onSigint = () => {
-    writeCliSpawnTrace('wrapper.signal.received', {
-        childPid: child.pid,
-        signal: 'SIGINT',
-        tty: process.stdin.isTTY === true,
-    });
-    if (process.stdin.isTTY === true) {
-        scheduleSignalForward('SIGINT');
-        return;
-    }
-    forwardSignal('SIGINT');
-};
-const onSigterm = () => {
-    writeCliSpawnTrace('wrapper.signal.received', {
-        childPid: child.pid,
-        signal: 'SIGTERM',
-        tty: process.stdin.isTTY === true,
-    });
-    if (process.stdin.isTTY === true) {
-        scheduleSignalForward('SIGTERM');
-        return;
-    }
-    forwardSignal('SIGTERM');
-};
-process.on('SIGINT', onSigint);
-process.on('SIGTERM', onSigterm);
-const result = await new Promise((resolve, reject) => {
-    let settled = false;
-    let childResult = {
-        exitCode: null,
-        signal: null,
-    };
-    const finalize = () => {
-        if (settled) {
-            return;
-        }
-        settled = true;
-        writeCliSpawnTrace('wrapper.child.finalize', {
-            childPid: child.pid,
-            exitCode: childResult.exitCode,
-            signal: childResult.signal,
-        });
-        childClosed = true;
-        clearDelayedSignal();
-        process.off('SIGINT', onSigint);
-        process.off('SIGTERM', onSigterm);
-        child.off?.('error', reject);
-        child.off?.('exit', handleExit);
-        child.off?.('close', handleClose);
-        resolve(childResult);
-    };
-    const handleExit = (exitCode, signal) => {
-        writeCliSpawnTrace('wrapper.child.exit', {
-            childPid: child.pid,
-            exitCode,
-            signal,
-        });
-        childResult = { exitCode, signal };
-    };
-    const handleClose = (exitCode, signal) => {
-        writeCliSpawnTrace('wrapper.child.close', {
-            childPid: child.pid,
-            exitCode,
-            signal,
-        });
-        childResult = {
-            exitCode: childResult.exitCode ?? exitCode,
-            signal: childResult.signal ?? signal,
-        };
-        finalize();
-    };
-    child.once('error', reject);
-    child.once('exit', handleExit);
-    child.once('close', handleClose);
-});
-process.exit(result.exitCode ?? (result.signal === 'SIGINT' || result.signal === 'SIGTERM' ? 0 : 1));
+import { runCliWrapper } from './launcher.js';
+await runCliWrapper({ traceName: 'cli-wrapper' });

package/bin/zintrust.d.ts

@@ -4,7 +4,7 @@
  *
  * This bin script is a thin wrapper around the hashbang-free implementation in
  * bin/zintrust-main.ts. Keeping the implementation hashbang-free allows other
- * shortcuts (zin/z/zt) to import it without parse issues.
+ * shortcuts (zin/z/zt) to reuse the same launcher behavior.
  */
 export {};
 //# sourceMappingURL=zintrust.d.ts.map

package/bin/zintrust.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust.d.ts","sourceRoot":"","sources":["../../bin/zintrust.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AA6HH,OAAO,EAAE,CAAC"}
+{"version":3,"file":"zintrust.d.ts","sourceRoot":"","sources":["../../bin/zintrust.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}

package/bin/zintrust.js

@@ -4,107 +4,7 @@
  *
  * This bin script is a thin wrapper around the hashbang-free implementation in
  * bin/zintrust-main.ts. Keeping the implementation hashbang-free allows other
- * shortcuts (zin/z/zt) to import it without parse issues.
+ * shortcuts (zin/z/zt) to reuse the same launcher behavior.
  */
-import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-const here = path.dirname(fileURLToPath(import.meta.url));
-const require = createRequire(import.meta.url);
-const tsTarget = path.join(here, 'zintrust-main.ts');
-const jsTarget = path.join(here, 'zintrust-main.js');
-const target = existsSync(tsTarget) ? tsTarget : jsTarget;
-const tsxImportPath = require.resolve('tsx');
-const nodeArgs = target.endsWith('.ts')
-    ? ['--import', tsxImportPath, target, ...process.argv.slice(2)]
-    : [target, ...process.argv.slice(2)];
-const child = spawn(process.execPath, nodeArgs, {
-    stdio: ['inherit', 'pipe', 'pipe'],
-    env: process.env,
-});
-child.stdout?.on('data', (chunk) => {
-    process.stdout.write(chunk);
-});
-child.stderr?.on('data', (chunk) => {
-    process.stderr.write(chunk);
-});
-let childClosed = false;
-let delayedSignalTimer;
-const clearDelayedSignal = () => {
-    if (delayedSignalTimer === undefined)
-        return;
-    clearTimeout(delayedSignalTimer);
-    delayedSignalTimer = undefined;
-};
-const forwardSignal = (signal) => {
-    if (childClosed)
-        return;
-    try {
-        child.kill(signal);
-    }
-    catch {
-        // best-effort
-    }
-};
-const scheduleSignalForward = (signal) => {
-    if (childClosed || delayedSignalTimer !== undefined)
-        return;
-    delayedSignalTimer = globalThis.setTimeout(() => {
-        delayedSignalTimer = undefined;
-        forwardSignal(signal);
-    }, 1500);
-    delayedSignalTimer.unref?.();
-};
-const onSigint = () => {
-    if (process.stdin.isTTY === true) {
-        scheduleSignalForward('SIGINT');
-        return;
-    }
-    forwardSignal('SIGINT');
-};
-const onSigterm = () => {
-    if (process.stdin.isTTY === true) {
-        scheduleSignalForward('SIGTERM');
-        return;
-    }
-    forwardSignal('SIGTERM');
-};
-process.on('SIGINT', onSigint);
-process.on('SIGTERM', onSigterm);
-const result = await new Promise((resolve, reject) => {
-    let settled = false;
-    let childResult = {
-        exitCode: null,
-        signal: null,
-    };
-    const finalize = () => {
-        if (settled) {
-            return;
-        }
-        settled = true;
-        childClosed = true;
-        clearDelayedSignal();
-        process.off('SIGINT', onSigint);
-        process.off('SIGTERM', onSigterm);
-        child.off?.('error', reject);
-        child.off?.('exit', handleExit);
-        child.off?.('close', handleClose);
-        resolve(childResult);
-    };
-    const handleExit = (exitCode, signal) => {
-        childResult = { exitCode, signal };
-    };
-    const handleClose = (exitCode, signal) => {
-        childResult = {
-            exitCode: childResult.exitCode ?? exitCode,
-            signal: childResult.signal ?? signal,
-        };
-        finalize();
-    };
-    child.once('error', reject);
-    child.once('exit', handleExit);
-    child.once('close', handleClose);
-});
-process.exit(result.exitCode ?? (result.signal === 'SIGINT' || result.signal === 'SIGTERM' ? 0 : 1));
+import { runCliWrapper } from './launcher.js';
+await runCliWrapper();

package/bin/zt.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S node --import tsx
 /**
- * ZinTrust CLI Shortcut - 'z'
+ * ZinTrust CLI Shortcut - 'zt'
  * Mirrors bin/zintrust.ts for convenience
  */
 export {};

package/bin/zt.js

@@ -1,104 +1,7 @@
 #!/usr/bin/env node
 /**
- * ZinTrust CLI Shortcut - 'z'
+ * ZinTrust CLI Shortcut - 'zt'
  * Mirrors bin/zintrust.ts for convenience
  */
-import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-const here = path.dirname(fileURLToPath(import.meta.url));
-const tsTarget = path.join(here, 'zintrust-main.ts');
-const jsTarget = path.join(here, 'zintrust-main.js');
-const target = existsSync(tsTarget) ? tsTarget : jsTarget;
-const nodeArgs = target.endsWith('.ts')
-    ? ['--import', 'tsx', target, ...process.argv.slice(2)]
-    : [target, ...process.argv.slice(2)];
-const child = spawn(process.execPath, nodeArgs, {
-    stdio: ['inherit', 'pipe', 'pipe'],
-    env: process.env,
-});
-child.stdout?.on('data', (chunk) => {
-    process.stdout.write(chunk);
-});
-child.stderr?.on('data', (chunk) => {
-    process.stderr.write(chunk);
-});
-let childClosed = false;
-let delayedSignalTimer;
-const clearDelayedSignal = () => {
-    if (delayedSignalTimer === undefined)
-        return;
-    clearTimeout(delayedSignalTimer);
-    delayedSignalTimer = undefined;
-};
-const forwardSignal = (signal) => {
-    if (childClosed)
-        return;
-    try {
-        child.kill(signal);
-    }
-    catch {
-        // best-effort
-    }
-};
-const scheduleSignalForward = (signal) => {
-    if (childClosed || delayedSignalTimer !== undefined)
-        return;
-    delayedSignalTimer = globalThis.setTimeout(() => {
-        delayedSignalTimer = undefined;
-        forwardSignal(signal);
-    }, 1500);
-    delayedSignalTimer.unref?.();
-};
-const onSigint = () => {
-    if (process.stdin.isTTY === true) {
-        scheduleSignalForward('SIGINT');
-        return;
-    }
-    forwardSignal('SIGINT');
-};
-const onSigterm = () => {
-    if (process.stdin.isTTY === true) {
-        scheduleSignalForward('SIGTERM');
-        return;
-    }
-    forwardSignal('SIGTERM');
-};
-process.on('SIGINT', onSigint);
-process.on('SIGTERM', onSigterm);
-const result = await new Promise((resolve, reject) => {
-    let settled = false;
-    let childResult = {
-        exitCode: null,
-        signal: null,
-    };
-    const finalize = () => {
-        if (settled) {
-            return;
-        }
-        settled = true;
-        childClosed = true;
-        clearDelayedSignal();
-        process.off('SIGINT', onSigint);
-        process.off('SIGTERM', onSigterm);
-        child.off?.('error', reject);
-        child.off?.('exit', handleExit);
-        child.off?.('close', handleClose);
-        resolve(childResult);
-    };
-    const handleExit = (exitCode, signal) => {
-        childResult = { exitCode, signal };
-    };
-    const handleClose = (exitCode, signal) => {
-        childResult = {
-            exitCode: childResult.exitCode ?? exitCode,
-            signal: childResult.signal ?? signal,
-        };
-        finalize();
-    };
-    child.once('error', reject);
-    child.once('exit', handleExit);
-    child.once('close', handleClose);
-});
-process.exit(result.exitCode ?? (result.signal === 'SIGINT' || result.signal === 'SIGTERM' ? 0 : 1));
+import { runCliWrapper } from './launcher.js';
+await runCliWrapper();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "1.5.5",
+  "version": "1.6.1",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -57,14 +57,14 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@cloudflare/containers": "^0.3.2",
+    "@cloudflare/containers": "^0.3.3",
     "bcryptjs": "^3.0.3",
-    "bullmq": "^5.76.1",
+    "bullmq": "^5.76.4",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
-    "inquirer": "^13.4.1",
+    "inquirer": "^13.4.2",
     "jsonwebtoken": "^9.0.3",
-    "mysql2": "^3.22.1",
+    "mysql2": "^3.22.3",
     "pg": "^8.20.0",
     "tsx": "^4.21.0"
   },

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

@@ -1,15 +1,17 @@
 import type { IShutdownManager } from './type';
 import type { IRouter } from '../../index.js';
 export declare const registerFrameworkShutdownHooks: (shutdownManager: IShutdownManager) => void;
-export declare const createLifecycle: (params: {
+type LifecycleParams = {
     environment: string;
     resolvedBasePath: string;
     router: IRouter;
     shutdownManager: IShutdownManager;
     getBooted: () => boolean;
     setBooted: (value: boolean) => void;
-}) => {
+};
+export declare const createLifecycle: (params: LifecycleParams) => {
     boot: () => Promise<void>;
     shutdown: () => Promise<void>;
 };
+export {};
 //# sourceMappingURL=runtime.d.ts.map

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;AAUvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAkQ9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA6BlF,CAAC;AA8UF,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;CAsH7D,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;AAUvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAkQ9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA6BlF,CAAC;AAyVF,KAAK,eAAe,GAAG;IACrB,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,CAAC;AA4HF,eAAO,MAAM,eAAe,GAC1B,QAAQ,eAAe,KACtB;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAK5D,CAAC"}

package/src/boot/registry/runtime.js

@@ -411,6 +411,12 @@ const isTraceDashboardAutoMountEnabled = () => {
     const raw = readEnvString('TRACE_AUTO_MOUNT').trim().toLowerCase();
     return raw === '1' || raw === 'true';
 };
+const isTraceProxySenderEnabled = () => {
+    const proxyEnabled = readEnvString('TRACE_PROXY').trim().toLowerCase();
+    if (proxyEnabled !== '1' && proxyEnabled !== 'true')
+        return false;
+    return readEnvString('TRACE_PROXY_URL').trim() !== '';
+};
 const resolveTraceDashboardBasePath = () => {
     const raw = readEnvString('TRACE_BASE_PATH').trim();
     if (raw === '')
@@ -447,6 +453,9 @@ const initializeSystemTrace = async (router) => {
             return;
         }
         if (!isTraceDashboardAutoMountEnabled()) {
+            if (isTraceProxySenderEnabled()) {
+                return;
+            }
             Logger.info('System Trace runtime activated. Set TRACE_AUTO_MOUNT=true or register dashboard routes manually if needed.');
             return;
         }
@@ -495,8 +504,34 @@ const initializeSockets = (router) => {
     Logger.info(`Transport: ${diagnostics.transport}`);
     Logger.info(`Path: ${diagnostics.path}`);
 };
-export const createLifecycle = (params) => {
-    const boot = async () => {
+const initializeRuntimeRoutes = async (params) => {
+    await initializeArtifactDirectories(params.resolvedBasePath);
+    await registerMasterRoutes(params.resolvedBasePath, params.router);
+    initializeSockets(params.router);
+    await initializeSystemTrace(params.router);
+    if (Cloudflare.getWorkersEnv() === null && appConfig.dockerWorker === false) {
+        if (appConfig.worker === true) {
+            await initializeWorkers(params.router);
+        }
+        else {
+            Logger.info('Skipping worker route registration (WORKER_ENABLED=false).');
+        }
+        await initializeQueueMonitor(params.router);
+        if (appConfig.worker === true) {
+            await initializeQueueHttpGateway(params.router);
+            await initializeScheduleHttpGateway(params.router);
+        }
+        else {
+            Logger.info('Skipping worker execution/gateway initialization (WORKER_ENABLED=false).');
+        }
+        return;
+    }
+    if (!appConfig.dockerWorker) {
+        Logger.info('Skipping local worker dashboards in Cloudflare Workers runtime.');
+    }
+};
+const createBootLifecycle = (params) => {
+    return async () => {
         if (params.getBooted())
             return;
         Logger.info(`🚀 Booting ZinTrust Application in ${params.environment} mode...`);
@@ -515,7 +550,6 @@ export const createLifecycle = (params) => {
                 warnings: startupConfigValidation.warnings,
             });
         }
-        // Preload project-owned config overrides that must be available synchronously.
         await StartupConfigFileRegistry.preload([
             StartupConfigFile.Middleware,
             StartupConfigFile.Cache,
@@ -529,35 +563,13 @@ export const createLifecycle = (params) => {
         FeatureFlags.initialize();
         await StartupHealthChecks.assertHealthy();
         await registerFromRuntimeConfig();
-        await initializeArtifactDirectories(params.resolvedBasePath);
-        await registerMasterRoutes(params.resolvedBasePath, params.router);
-        initializeSockets(params.router);
-        await initializeSystemTrace(params.router);
-        if (Cloudflare.getWorkersEnv() === null && appConfig.dockerWorker === false) {
-            if (appConfig.worker === true) {
-                await initializeWorkers(params.router);
-            }
-            else {
-                Logger.info('Skipping worker route registration (WORKER_ENABLED=false).');
-            }
-            await initializeQueueMonitor(params.router);
-            if (appConfig.worker === true) {
-                await initializeQueueHttpGateway(params.router);
-                await initializeScheduleHttpGateway(params.router);
-            }
-            else {
-                Logger.info('Skipping worker execution/gateway initialization (WORKER_ENABLED=false).');
-            }
-        }
-        else if (!appConfig.dockerWorker) {
-            Logger.info('Skipping local worker dashboards in Cloudflare Workers runtime.');
-        }
-        // Register service providers
-        // Bootstrap services
+        await initializeRuntimeRoutes(params);
         Logger.info('✅ Application booted successfully');
         params.setBooted(true);
     };
-    const shutdown = async () => {
+};
+const createShutdownLifecycle = (params) => {
+    return async () => {
         Logger.info('🛑 Shutting down application...');
         ShutdownTrace.logHandles('runtime.lifecycle.shutdown.start');
         QueueReliabilityOrchestrator.stop();
@@ -588,7 +600,6 @@ export const createLifecycle = (params) => {
                 error: error instanceof Error ? error.message : String(error),
             });
         }
-        // Ensure FileLogWriter.flush is attempted even if dynamic registration failed.
         try {
             const fileLogWriter = await tryImportOptional('@config/FileLogWriter');
             fileLogWriter?.FileLogWriter?.flush?.();
@@ -599,5 +610,9 @@ export const createLifecycle = (params) => {
         params.setBooted(false);
         ShutdownTrace.logHandles('runtime.lifecycle.shutdown.complete');
     };
+};
+export const createLifecycle = (params) => {
+    const boot = createBootLifecycle(params);
+    const shutdown = createShutdownLifecycle(params);
     return { boot, shutdown };
 };

package/src/cli/cloudflare/CloudflareWranglerDevEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudflareWranglerDevEnv.d.ts","sourceRoot":"","sources":["../../../../src/cli/cloudflare/CloudflareWranglerDevEnv.ts"],"names":[],"mappings":"AAUA,KAAK,kBAAkB,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAyJF,eAAO,MAAM,0BAA0B,GACrC,MAAM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAmB7C,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAU,CAAC,EACjD,MAAM,kBAAkB,EACxB,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CA8BX,CAAC;;uCAvDM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAAC;kCAqBG,CAAC,QAC3C,kBAAkB,MACpB,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CAAC;;AAgCb,wBAGG"}
+{"version":3,"file":"CloudflareWranglerDevEnv.d.ts","sourceRoot":"","sources":["../../../../src/cli/cloudflare/CloudflareWranglerDevEnv.ts"],"names":[],"mappings":"AAUA,KAAK,kBAAkB,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AA+KF,eAAO,MAAM,0BAA0B,GACrC,MAAM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAmB7C,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAU,CAAC,EACjD,MAAM,kBAAkB,EACxB,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CAkCX,CAAC;;uCA3DM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAAC;kCAqBG,CAAC,QAC3C,kBAAkB,MACpB,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CAAC;;AAoCb,wBAGG"}

package/src/cli/cloudflare/CloudflareWranglerDevEnv.js

@@ -70,6 +70,24 @@ const resolveRuntimeEnvMap = (runtimeEnv) => {
         return typeof entry[1] === 'string';
     }));
 };
+const isTruthyEnvValue = (value) => {
+    if (!isNonEmptyString(value))
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
+};
+const shouldUseEnvFileDirectly = async (args) => {
+    const runtimeEnv = resolveRuntimeEnvMap(args.runtimeEnv ?? process.env);
+    if (isTruthyEnvValue(runtimeEnv['USE_ENV'])) {
+        return true;
+    }
+    const envPath = isNonEmptyString(args.envPath) ? args.envPath.trim() : '.env';
+    const envFileValues = await EnvFile.read({
+        cwd: args.projectRoot,
+        path: envPath,
+    });
+    return isTruthyEnvValue(envFileValues['USE_ENV']);
+};
 const resolveSelectedKeys = (args) => {
     const zintrustConfigPath = path.join(args.projectRoot, '.zintrust.json');
     if (!existsSync(zintrustConfigPath)) {
@@ -136,6 +154,9 @@ export const materializeWranglerDevVars = async (args) => {
     };
 };
 export const withWranglerDevVarsSnapshot = async (args, fn) => {
+    if (await shouldUseEnvFileDirectly(args)) {
+        return fn();
+    }
     const targetPath = path.join(args.cwd, getWranglerDevVarsFileName(args.envName));
     const backupPath = getWranglerDevVarsBackupPath(targetPath);
     try {

package/src/cli/scaffolding/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/env.ts"],"names":[],"mappings":"AAmiBA,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,QAAQ,MAAM,EACd,oBAAoB,MAAM,EAC1B,SAAS,MAAM,EAAE,EACjB,cAAc,MAAM,KACnB,MAAM,EAWR,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/env.ts"],"names":[],"mappings":"AAqiBA,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,QAAQ,MAAM,EACd,oBAAoB,MAAM,EAC1B,SAAS,MAAM,EAAE,EACjB,cAAc,MAAM,KACnB,MAAM,EAWR,CAAC"}

package/src/cli/scaffolding/env.js

@@ -26,6 +26,8 @@ const HeaderAndApp = (name, port, baseUrl, appKey) => [
     '',
     '# Cloudflare Workers (TCP sockets) — set true if using TCP adapters on Workers.',
     'ENABLE_CLOUDFLARE_SOCKETS=false',
+    '# When true, Wrangler reads .env directly and ZinTrust will not materialize .dev.vars files.',
+    'USE_ENV=false',
     '',
     '# CLI / tooling',
     'ZINTRUST_RUN_FROM_SOURCE=0',

package/src/helper/ShutdownTrace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShutdownTrace.d.ts","sourceRoot":"","sources":["../../../src/helper/ShutdownTrace.ts"],"names":[],"mappings":"AAKA,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAwMpD,eAAO,MAAM,aAAa;qBAlLJ,OAAO;iBAwFT,MAAM,YAAW,oBAAoB,KAAQ,IAAI;wBAY1C,MAAM,YAAW,oBAAoB,KAAQ,IAAI;6BA6CnE,MAAM,UACL,OAAO,YACN,oBAAoB,KAC5B,IAAI;EAmCL,CAAC"}
+{"version":3,"file":"ShutdownTrace.d.ts","sourceRoot":"","sources":["../../../src/helper/ShutdownTrace.ts"],"names":[],"mappings":"AAKA,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoLpD,eAAO,MAAM,aAAa;qBAnKJ,OAAO;iBAwFT,MAAM,YAAW,oBAAoB,KAAQ,IAAI;wBAY1C,MAAM,YAAW,oBAAoB,KAAQ,IAAI;6BA8BnE,MAAM,UACL,OAAO,YACN,oBAAoB,KAC5B,IAAI;EAmCL,CAAC"}

package/src/helper/ShutdownTrace.js

@@ -4,16 +4,12 @@ const writeLine = (line) => {
     const nodeProcess = getNodeProcess();
     if (nodeProcess?.stderr && typeof nodeProcess.stderr.write === 'function') {
         nodeProcess.stderr.write(`${line}\n`);
-        return;
-    }
-    if (typeof console !== 'undefined' && typeof console.info === 'function') {
-        console.info(line);
     }
 };
 const getNodeProcess = () => {
     if (typeof process === 'undefined')
         return null;
-    return process;
+    return process; // NOSONAR
 };
 const isEnabled = () => {
     const nodeProcess = getNodeProcess();
@@ -99,20 +95,7 @@ const log = (label, details = {}) => {
 const logHandles = (label, details = {}) => {
     if (!isEnabled())
         return;
-    const nodeProcess = getNodeProcess();
-    if (nodeProcess === null) {
-        writeLine(JSON.stringify({
-            level: 'info',
-            trace: 'shutdown',
-            label,
-            details: {
-                ...details,
-                available: false,
-                reason: 'process unavailable',
-            },
-        }));
-        return;
-    }
+    const nodeProcess = getNodeProcess(); //NOSONAR
     const handles = typeof nodeProcess._getActiveHandles === 'function' ? nodeProcess._getActiveHandles() : [];
     const requests = typeof nodeProcess._getActiveRequests === 'function' ? nodeProcess._getActiveRequests() : [];
     writeLine(JSON.stringify({

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v1.5.5
+ * @zintrust/core v1.6.1
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-29T11:25:34.011Z
+ *   Built: 2026-04-30T12:31:49.571Z
  *   Node: >=20.0.0
  *   License: MIT
  *
@@ -21,7 +21,7 @@
  * Available at runtime for debugging and health checks
  */
 export const ZINTRUST_VERSION = '0.1.41';
-export const ZINTRUST_BUILD_DATE = '2026-04-29T11:25:33.975Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-30T12:31:49.535Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/templates/project/basic/config/database.ts.tpl

@@ -17,7 +17,7 @@ const parseReadHosts = (raw: string): string[] | undefined => {
 };
 
 export default {
-  default: Env.get('DB_CONNECTION', 'mysql'),
+  default: Env.get('DB_CONNECTION', Env.getBool('CLOUDFLARE_WORKER', false) ? 'd1' : 'sqlite'),
   connections: {
     sqlite: {
       driver: 'sqlite' as const,