@simplysm/core-node 14.0.15 → 14.0.17

package/README.md

@@ -1,6 +1,6 @@
 # @simplysm/core-node
 
-Node.js-specific core utilities for the Simplysm framework. Provides enhanced file system operations, child process execution, path utilities, file watching, and a type-safe worker thread abstraction.
+Node.js-specific core utilities for the Simplysm framework. Provides enhanced file system operations, child process execution, path utilities, file watching, consola logging configuration, and a type-safe worker thread abstraction.
 
 ## Installation
 
@@ -26,8 +26,8 @@ Namespace `fsx` -- Enhanced file system functions (sync and async pairs).
 | `copySync` | function | Copy file/directory with filter (sync) |
 | `read` | function | Read file as UTF-8 string (async) |
 | `readSync` | function | Read file as UTF-8 string (sync) |
-| `readBuffer` | function | Read file as Buffer (async) |
-| `readBufferSync` | function | Read file as Buffer (sync) |
+| `readBytes` | function | Read file as Uint8Array (async) |
+| `readBytesSync` | function | Read file as Uint8Array (sync) |
 | `readJson` | function | Read and parse JSON file (async) |
 | `readJsonSync` | function | Read and parse JSON file (sync) |
 | `write` | function | Write data to file (async) |
@@ -54,15 +54,14 @@ Namespace `cpx` -- Child process execution utilities.
 
 | API | Type | Description |
 |-----|------|-------------|
-| `ExecOptions` | interface | Options for `exec` |
-| `ExecSyncOptions` | type | Options for `execSync` (same as `ExecOptions` without `reject`) |
-| `ExecResult` | interface | Result of a child process execution |
-| `ExecProcess` | class | `PromiseLike<ExecResult>` wrapper with `kill()` support |
-| `exec` | function | Spawn a child process (async, returns `ExecProcess`) |
-| `execSync` | function | Spawn a child process (sync) |
+| `SpawnResult` | interface | Result of a spawned child process |
+| `SpawnProcess` | class | `PromiseLike<SpawnResult>` wrapper with `kill()` support |
+| `spawn` | function | Spawn a child process (async, returns `SpawnProcess`) |
+| `spawnSync` | function | Spawn a child process (sync) |
 | `codePageToEncoding` | function | Convert Windows code page number to encoding name |
 | `getSystemEncoding` | function | Detect system console encoding (cached) |
 | `resetEncodingCache` | function | Clear the cached system encoding |
+| `resolveStdioPipe` | function | Determine which stdio channels are piped |
 | `decodeBytes` | function | Decode `Uint8Array` output with system encoding fallback |
 
 > See [docs/cpx.md](./docs/cpx.md) for details.
@@ -83,7 +82,7 @@ Namespace `pathx` -- Path manipulation utilities.
 
 > See [docs/pathx.md](./docs/pathx.md) for details.
 
-### Features
+### Features / FsWatcher
 
 | API | Type | Description |
 |-----|------|-------------|
@@ -93,6 +92,19 @@ Namespace `pathx` -- Path manipulation utilities.
 
 > See [docs/fs-watcher.md](./docs/fs-watcher.md) for details.
 
+### Features / Consola
+
+| API | Type | Description |
+|-----|------|-------------|
+| `PrettyReporter` | class | Terminal consola reporter with icons, colors, and error stack formatting |
+| `FileReporterOptions` | interface | Options for `createFileReporter` (maxSize, maxDays) |
+| `createFileReporter` | function | Create a file-based consola reporter (JSON lines, date rotation) |
+| `withMaxLevel` | function | Wrap a reporter to filter out log entries above a max level |
+| `SetupConsolaOptions` | interface | Options for `setupConsola` |
+| `setupConsola` | function | Configure consola reporters based on environment (prod/dev/debug) |
+
+> See [docs/consola.md](./docs/consola.md) for details.
+
 ### Worker
 
 | API | Type | Description |
@@ -118,6 +130,9 @@ import { fsx } from "@simplysm/core-node";
 const content = await fsx.read("/path/to/file.txt");
 await fsx.write("/path/to/output.txt", "hello");
 
+// Binary read
+const rawBytes = await fsx.readBytes("/path/to/image.png");
+
 // JSON
 const data = await fsx.readJson<{ name: string }>("/path/to/config.json");
 await fsx.writeJson("/path/to/out.json", data, { space: 2 });
@@ -135,15 +150,18 @@ const tsFiles = await fsx.glob("/project/src/**/*.ts");
 import { cpx } from "@simplysm/core-node";
 
 // Await result
-const result = await cpx.exec("git", ["status"], { cwd: "/project" });
+const result = await cpx.spawn("git", ["status"], { cwd: "/project" });
 // result: { stdout, stderr, exitCode }
 
 // Kill a running process
-const proc = cpx.exec("long-running-cmd", []);
+const proc = cpx.spawn("long-running-cmd", []);
 proc.kill();
 
 // Inherit stdio, don't reject on non-zero exit
-await cpx.exec("make", ["build"], { stdio: "inherit", reject: false });
+await cpx.spawn("make", ["build"], { stdio: "inherit", reject: false });
+
+// Synchronous execution
+const syncResult = cpx.spawnSync("node", ["--version"]);
 ```
 
 ### Path utilities
@@ -157,6 +175,18 @@ const name = pathx.basenameWithoutExt("file.spec.ts"); // "file.spec"
 const isChild = pathx.isChildPath("/a/b/c", "/a/b"); // true
 ```
 
+### Consola logging
+
+```typescript
+import { setupConsola } from "@simplysm/core-node";
+
+// Auto-configure based on environment (prod → file only, dev → file + terminal)
+setupConsola();
+
+// CLI mode — always use terminal output regardless of environment
+setupConsola({ cli: true });
+```
+
 ### File watcher
 
 ```typescript

package/dist/features/consola/file-reporter.d.ts

@@ -0,0 +1,9 @@
+import type { ConsolaReporter } from "consola";
+export interface FileReporterOptions {
+    /** @default 20MB */
+    maxSize?: number;
+    /** @default 14 */
+    maxDays?: number;
+}
+export declare function createFileReporter(options?: FileReporterOptions): ConsolaReporter;
+//# sourceMappingURL=file-reporter.d.ts.map

package/dist/features/consola/file-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reporter.d.ts","sourceRoot":"","sources":["../../../src/features/consola/file-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,eAAe,EAAa,MAAM,SAAS,CAAC;AAI1E,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,eAAe,CAyEjF"}

package/dist/features/consola/file-reporter.js

@@ -0,0 +1,108 @@
+import fs from "fs";
+import path from "path";
+const DEFAULT_MAX_SIZE = 20 * 1024 * 1024;
+const DEFAULT_MAX_DAYS = 14;
+export function createFileReporter(options) {
+    const maxSize = options?.maxSize ?? DEFAULT_MAX_SIZE;
+    const maxDays = options?.maxDays ?? DEFAULT_MAX_DAYS;
+    const outDir = path.resolve(process.cwd(), ".logs");
+    let dirEnsured = false;
+    let stream = null;
+    let currentDate = "";
+    let currentSize = 0;
+    let lastCleanDate = "";
+    function rotate(dateStr) {
+        if (stream != null) {
+            stream.end();
+            stream = null;
+        }
+        if (!dirEnsured) {
+            fs.mkdirSync(outDir, { recursive: true });
+            dirEnsured = true;
+        }
+        const filePath = resolveLogFilePath(outDir, dateStr, maxSize);
+        try {
+            currentSize = fs.statSync(filePath).size;
+        }
+        catch {
+            currentSize = 0;
+        }
+        stream = fs.createWriteStream(filePath, { flags: "a" });
+        currentDate = dateStr;
+    }
+    return {
+        log(logObj, _ctx) {
+            const entry = {
+                time: logObj.date.toISOString(),
+                level: logObj.type.toUpperCase(),
+            };
+            if (logObj.tag) {
+                entry["tag"] = logObj.tag;
+            }
+            const msgs = [];
+            for (const a of logObj.args) {
+                if (a instanceof Error) {
+                    entry["err"] = { message: a.message, stack: a.stack };
+                }
+                else {
+                    msgs.push(typeof a === "string" ? a : String(a));
+                }
+            }
+            if (msgs.length > 0) {
+                entry["msg"] = msgs.join(" ");
+            }
+            const line = JSON.stringify(entry) + "\n";
+            const date = logObj.date;
+            const dateStr = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+            if (dateStr !== currentDate || currentSize + line.length >= maxSize) {
+                rotate(dateStr);
+            }
+            stream.write(line);
+            currentSize += line.length;
+            if (lastCleanDate !== dateStr) {
+                lastCleanDate = dateStr;
+                cleanOldFiles(outDir, maxDays);
+            }
+        },
+    };
+}
+function resolveLogFilePath(outDir, dateStr, maxSize) {
+    const basePath = path.join(outDir, `app.${dateStr}.log`);
+    if (!fs.existsSync(basePath))
+        return basePath;
+    if (fs.statSync(basePath).size < maxSize)
+        return basePath;
+    let seq = 1;
+    while (true) {
+        const seqPath = path.join(outDir, `app.${dateStr}.${seq}.log`);
+        if (!fs.existsSync(seqPath))
+            return seqPath;
+        if (fs.statSync(seqPath).size < maxSize)
+            return seqPath;
+        seq++;
+    }
+}
+function cleanOldFiles(outDir, maxDays) {
+    let entries;
+    try {
+        entries = fs.readdirSync(outDir);
+    }
+    catch {
+        return;
+    }
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - maxDays);
+    const cutoffStr = `${cutoff.getFullYear()}-${String(cutoff.getMonth() + 1).padStart(2, "0")}-${String(cutoff.getDate()).padStart(2, "0")}`;
+    for (const entry of entries) {
+        const match = /^app\.(\d{4}-\d{2}-\d{2})(?:\.\d+)?\.log$/.exec(entry);
+        if (match != null && match[1] < cutoffStr) {
+            try {
+                fs.unlinkSync(path.join(outDir, entry));
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+//# sourceMappingURL=file-reporter.js.map

package/dist/features/consola/file-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reporter.js","sourceRoot":"","sources":["../../../src/features/consola/file-reporter.ts"],"names":[],"mappings":"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"}

package/dist/features/consola/pretty-reporter.d.ts

@@ -0,0 +1,14 @@
+import type { ConsolaReporter, LogObject, ConsolaOptions } from "consola";
+export declare class PrettyReporter implements ConsolaReporter {
+    log(logObj: LogObject, ctx: {
+        options: ConsolaOptions;
+    }): void;
+    private _formatLogObj;
+    private _formatArgs;
+    private _formatError;
+    private _formatStack;
+    private _formatIcon;
+    private _formatDate;
+    private _formatBox;
+}
+//# sourceMappingURL=pretty-reporter.d.ts.map

package/dist/features/consola/pretty-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty-reporter.d.ts","sourceRoot":"","sources":["../../../src/features/consola/pretty-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA4E1E,qBAAa,cAAe,YAAW,eAAe;IACpD,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE,GAAG,IAAI;IAe9D,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,UAAU;CAMnB"}

package/dist/features/consola/pretty-reporter.js

@@ -0,0 +1,139 @@
+import { formatWithOptions } from "node:util";
+import { sep } from "node:path";
+import { env } from "@simplysm/core-common";
+// -- Constants ----------------------------------------------------------------
+const TYPE_ICONS = {
+    error: "\u2716",
+    fatal: "\u2716",
+    ready: "\u2714",
+    warn: "\u26A0",
+    info: "\u2139",
+    success: "\u2714",
+    debug: "\u2699",
+    trace: "\u2192",
+    fail: "\u2716",
+    start: "\u25D0",
+    log: "",
+};
+const TYPE_COLORS = {
+    info: "cyan",
+    fail: "red",
+    success: "green",
+    ready: "green",
+    start: "magenta",
+};
+const LEVEL_COLORS = {
+    0: "red",
+    1: "yellow",
+};
+const ANSI_CODES = {
+    gray: "\x1b[90m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    cyan: "\x1b[36m",
+    magenta: "\x1b[35m",
+};
+const ANSI_RESET = "\x1b[0m";
+// -- Helpers ------------------------------------------------------------------
+function colorize(color, text, enabled) {
+    if (!enabled)
+        return text;
+    return `${ANSI_CODES[color]}${text}${ANSI_RESET}`;
+}
+function writeStream(data, stream) {
+    const s = stream;
+    const write = s.__write ?? s.write;
+    write.call(stream, data);
+}
+function detectColorSupport() {
+    if (env("NO_COLOR") != null)
+        return false;
+    if (env("FORCE_COLOR") != null)
+        return true;
+    if (process.stdout.isTTY === true)
+        return true;
+    return process.platform === "win32";
+}
+export class PrettyReporter {
+    log(logObj, ctx) {
+        const opts = {
+            ...ctx.options.formatOptions,
+            colors: detectColorSupport(),
+        };
+        const line = this._formatLogObj(logObj, opts);
+        const stream = logObj.level < 2
+            ? ctx.options.stderr ?? process.stderr
+            : ctx.options.stdout ?? process.stdout;
+        writeStream(line + "\n", stream);
+    }
+    _formatLogObj(logObj, opts) {
+        const formattedArgs = this._formatArgs(logObj.args, opts);
+        const [message, ...additional] = formattedArgs.split("\n");
+        if (logObj.type === "box") {
+            return this._formatBox(logObj, formattedArgs);
+        }
+        const tag = logObj.tag !== "" ? colorize("gray", `[${logObj.tag}]`, opts.colors) : "";
+        const icon = this._formatIcon(logObj, opts.colors);
+        const date = this._formatDate(logObj.date, opts);
+        const coloredDate = date !== "" ? colorize("gray", date, opts.colors) : "";
+        let fullLine = [tag, icon, message, coloredDate].filter(Boolean).join(" ");
+        if (additional.length > 0) {
+            fullLine += "\n" + additional.join("\n");
+        }
+        if (logObj.type === "trace") {
+            const err = new Error("Trace: " + logObj.message);
+            fullLine += this._formatStack(err.stack ?? "", err.message);
+        }
+        const isBadge = logObj.badge ?? logObj.level < 2;
+        return isBadge ? "\n" + fullLine + "\n" : fullLine;
+    }
+    _formatArgs(args, opts) {
+        const processed = args.map((arg) => {
+            if (arg != null && typeof arg === "object" && typeof arg.stack === "string") {
+                return this._formatError(arg, opts);
+            }
+            return arg;
+        });
+        return formatWithOptions({ colors: opts.colors, compact: opts.compact }, ...processed);
+    }
+    _formatError(err, opts) {
+        const message = err.message;
+        const stack = err.stack != null ? this._formatStack(err.stack, message, opts) : "";
+        const level = opts.errorLevel ?? 0;
+        const prefix = level > 0 ? `${"  ".repeat(level)}[cause]: ` : "";
+        const cause = err.cause instanceof Error
+            ? "\n\n" + this._formatError(err.cause, { ...opts, errorLevel: level + 1 })
+            : "";
+        return prefix + message + "\n" + stack + cause;
+    }
+    _formatStack(stack, message, opts) {
+        const cwd = process.cwd() + sep;
+        const indent = "  ".repeat((opts?.errorLevel ?? 0) + 1);
+        const lines = stack
+            .split("\n")
+            .splice(message.split("\n").length)
+            .map((l) => l.trim().replace("file://", "").replace(cwd, ""));
+        return `\n${indent}` + lines.map((l) => `  ${l}`).join(`\n${indent}`);
+    }
+    _formatIcon(logObj, useColors) {
+        const icon = TYPE_ICONS[logObj.type] ?? "";
+        if (icon === "")
+            return "";
+        const color = TYPE_COLORS[logObj.type] ?? LEVEL_COLORS[logObj.level] ?? "gray";
+        return colorize(color, icon, useColors);
+    }
+    _formatDate(date, opts) {
+        if (!opts.date)
+            return "";
+        const base = date.toLocaleTimeString();
+        return `${base}.${String(date.getMilliseconds()).padStart(3, "0")}`;
+    }
+    _formatBox(logObj, message) {
+        const tag = logObj.tag !== "" ? `[${logObj.tag}]` : "";
+        const title = logObj.title;
+        const lines = [tag, title, ...message.split("\n")].filter(Boolean);
+        return "\n" + lines.map((l) => ` > ${l}`).join("\n") + "\n";
+    }
+}
+//# sourceMappingURL=pretty-reporter.js.map

package/dist/features/consola/pretty-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty-reporter.js","sourceRoot":"","sources":["../../../src/features/consola/pretty-reporter.ts"],"names":[],"mappings":"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"}

package/dist/features/consola/setup-consola.d.ts

@@ -0,0 +1,7 @@
+import type { ConsolaReporter } from "consola";
+export declare function withMaxLevel(reporter: ConsolaReporter, maxLevel: number): ConsolaReporter;
+export interface SetupConsolaOptions {
+    cli?: boolean;
+}
+export declare function setupConsola(opts?: SetupConsolaOptions): void;
+//# sourceMappingURL=setup-consola.d.ts.map

package/dist/features/consola/setup-consola.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-consola.d.ts","sourceRoot":"","sources":["../../../src/features/consola/setup-consola.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,eAAe,EAAa,MAAM,SAAS,CAAC;AAM1E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAOzF;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAoB7D"}

package/dist/features/consola/setup-consola.js

@@ -0,0 +1,35 @@
+import consola, { LogLevels } from "consola";
+import { env, parseBoolEnv } from "@simplysm/core-common";
+import { PrettyReporter } from "./pretty-reporter.js";
+import { createFileReporter } from "./file-reporter.js";
+export function withMaxLevel(reporter, maxLevel) {
+    return {
+        log(logObj, ctx) {
+            if (logObj.level > maxLevel)
+                return;
+            reporter.log(logObj, ctx);
+        },
+    };
+}
+export function setupConsola(opts) {
+    if (!opts?.cli && !parseBoolEnv(env("DEV"))) {
+        // prod: debug 포함 FileReporter
+        consola.level = LogLevels.debug;
+        consola.options.reporters = [createFileReporter()];
+        return;
+    }
+    if (parseBoolEnv(env("SD_DEBUG"))) {
+        // dev + SD_DEBUG: debug 포함 PrettyReporter
+        consola.level = LogLevels.debug;
+        consola.options.reporters = [new PrettyReporter()];
+    }
+    else {
+        // dev: debug 포함 FileReporter + debug 비포함 PrettyReporter
+        consola.level = LogLevels.debug;
+        consola.options.reporters = [
+            createFileReporter(),
+            withMaxLevel(new PrettyReporter(), LogLevels.info),
+        ];
+    }
+}
+//# sourceMappingURL=setup-consola.js.map

package/dist/features/consola/setup-consola.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-consola.js","sourceRoot":"","sources":["../../../src/features/consola/setup-consola.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,UAAU,YAAY,CAAC,QAAyB,EAAE,QAAgB;IACtE,OAAO;QACL,GAAG,CAAC,MAAiB,EAAE,GAAgC;YACrD,IAAI,MAAM,CAAC,KAAK,GAAG,QAAQ;gBAAE,OAAO;YACpC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,YAAY,CAAC,IAA0B;IACrD,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC5C,8BAA8B;QAC9B,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IAED,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAClC,0CAA0C;QAC1C,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,wDAAwD;QACxD,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,SAAS,GAAG;YAC1B,kBAAkB,EAAE;YACpB,YAAY,CAAC,IAAI,cAAc,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC;SACnD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -2,6 +2,9 @@ export * as cpx from "./utils/cp";
 export * as fsx from "./utils/fs";
 export * as pathx from "./utils/path";
 export * from "./features/fs-watcher";
+export * from "./features/consola/pretty-reporter";
+export * from "./features/consola/file-reporter";
+export * from "./features/consola/setup-consola";
 export * from "./worker/types";
 export * from "./worker/worker";
 export * from "./worker/create-worker";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AAGjD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -4,6 +4,9 @@ export * as fsx from "./utils/fs.js";
 export * as pathx from "./utils/path.js";
 // 기능
 export * from "./features/fs-watcher.js";
+export * from "./features/consola/pretty-reporter.js";
+export * from "./features/consola/file-reporter.js";
+export * from "./features/consola/setup-consola.js";
 // 워커
 export * from "./worker/types.js";
 export * from "./worker/worker.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,KAAK;AACL,cAAc,uBAAuB,CAAC;AAEtC,KAAK;AACL,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,KAAK;AACL,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AAEjD,KAAK;AACL,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}

package/dist/utils/cp.js

@@ -1,5 +1,5 @@
 import { execSync as cpExecSync, spawn as cpSpawn, spawnSync as cpSpawnSync } from "child_process";
-import { bytes } from "@simplysm/core-common";
+import { bytes, env } from "@simplysm/core-common";
 const CODE_PAGE_MAP = {
     65001: "utf-8",
     949: "euc-kr",
@@ -31,7 +31,7 @@ export function getSystemEncoding() {
             }
         }
         else {
-            const lang = process.env["LANG"] ?? process.env["LC_ALL"] ?? "";
+            const lang = env("LANG") ?? env("LC_ALL") ?? "";
             const dotIndex = lang.indexOf(".");
             if (dotIndex >= 0) {
                 let encoding = lang.slice(dotIndex + 1).split("@")[0].toLowerCase();

package/dist/utils/cp.js.map

@@ -1 +1 @@
-{"version":3,"file":"cp.js","sourceRoot":"","sources":["../../src/utils/cp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cp.js","sourceRoot":"","sources":["../../src/utils/cp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,KAAK,IAAI,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,aAAa,GAA2B;IAC5C,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,cAAc;IACpB,GAAG,EAAE,aAAa;CACnB,CAAC;AAEF,IAAI,eAAmC,CAAC;AAExC,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,eAAe,GAAG,SAAS,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,eAAe,IAAI,IAAI;QAAE,OAAO,eAAe,CAAC;IAEpD,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,KAAK,EAAE,CAAC;gBACV,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,eAAe,CAAC;YACzB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;gBAClB,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;gBACpE,IAAI,QAAQ,KAAK,MAAM;oBAAE,QAAQ,GAAG,OAAO,CAAC;gBAC5C,eAAe,GAAG,QAAQ,CAAC;gBAC3B,OAAO,eAAe,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IAED,eAAe,GAAG,OAAO,CAAC;IAC1B,OAAO,eAAe,CAAC;AACzB,CAAC;AAUD,YAAY;AAEZ,0BAA0B;AAE1B,MAAM,UAAU,gBAAgB,CAC9B,KAA4B;IAE5B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;IACtE,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,KAAK,MAAM,IAAI,KAAK,IAAI,IAAI,CAAC;IACjD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED,YAAY;AAEZ,qBAAqB;AAErB,MAAM,UAAU,WAAW,CAAC,GAAe,EAAE,cAAuB;IAClE,MAAM,QAAQ,GAAG,cAAc,IAAI,iBAAiB,EAAE,CAAC;IAEvD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,YAAY;AAEZ,sBAAsB;AAEtB,MAAM,OAAO,YAAY;IACN,QAAQ,CAAe;IACvB,QAAQ,CAAuB;IAEhD,YAAY,EAAgB,EAAE,OAA6B;QACzD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;IAC3B,CAAC;IAED,IAAI,CACF,WAA+E,EAC/E,UAA2E;QAE3E,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CACH,UAAyE;QAEzE,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,MAAgC;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED,YAAY;AAEZ,2BAA2B;AAE3B,MAAM,UAAU,KAAK,CACnB,GAAW,EACX,IAAc,EACd,OAA6C;IAE7C,MAAM,IAAI,GAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;IAEnG,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAEpC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEpF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3D,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACrB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,MAAM,YAAY,GAAiB,EAAE,CAAC;QACtC,MAAM,YAAY,GAAiB,EAAE,CAAC;QAEtC,IAAI,YAAY,EAAE,CAAC;YACjB,EAAE,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YACjB,EAAE,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAC9B,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,MAAM,MAAM,GAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAEzD,IAAI,QAAQ,KAAK,CAAC,IAAI,OAAO,EAAE,MAAM,KAAK,KAAK,EAAE,CAAC;gBAChD,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,IAAc,EACd,OAAiD;IAEjD,MAAM,IAAI,GAAqB;QAC7B,KAAK,EAAE,MAAM;QACb,GAAG,OAAO;QACV,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE;KACzC,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAE5C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEpF,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,MAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,MAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IAEpC,IAAI,QAAQ,KAAK,CAAC,IAAI,OAAO,EAAE,MAAM,KAAK,KAAK,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED,YAAY"}

package/docs/consola.md

@@ -0,0 +1,141 @@
+# Consola
+
+Consola logging utilities for environment-aware reporter configuration. Provides a terminal pretty-printer, a file-based JSON logger with rotation, and a one-call setup function.
+
+```ts
+import {
+  setupConsola,
+  withMaxLevel,
+  PrettyReporter,
+  createFileReporter,
+} from "@simplysm/core-node";
+import type { SetupConsolaOptions, FileReporterOptions } from "@simplysm/core-node";
+```
+
+## Types
+
+### SetupConsolaOptions
+
+```ts
+interface SetupConsolaOptions {
+  cli?: boolean;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `cli` | `boolean` | When `true`, always use `PrettyReporter` regardless of environment (for CLI tools) |
+
+### FileReporterOptions
+
+```ts
+interface FileReporterOptions {
+  maxSize?: number;
+  maxDays?: number;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `maxSize` | `number` | Maximum size per log file in bytes. Default: `20 * 1024 * 1024` (20 MB). When exceeded, a new sequenced file is created (e.g., `app.2026-04-03.1.log`). |
+| `maxDays` | `number` | Number of days to retain log files. Default: `14`. Files older than this are deleted on the next log write. |
+
+## PrettyReporter
+
+```ts
+class PrettyReporter implements ConsolaReporter {
+  log(logObj: LogObject, ctx: { options: ConsolaOptions }): void;
+}
+```
+
+A terminal-oriented consola reporter. Formats log output with:
+- Type-specific icons (e.g., checkmark for success, cross for error, gear for debug)
+- ANSI color coding based on log type and level (respects `NO_COLOR`/`FORCE_COLOR` env vars)
+- Error stack trace formatting with relative paths and cause chain support
+- Badge-style formatting (extra newlines) for error/fatal level messages
+- Box formatting for `box` type log entries
+- Timestamp display when `formatOptions.date` is enabled
+
+Errors at level < 2 are written to stderr; all others to stdout.
+
+## Functions
+
+### setupConsola
+
+```ts
+function setupConsola(opts?: SetupConsolaOptions): void
+```
+
+Configure the global `consola` instance with appropriate reporters based on the runtime environment. Sets the log level to `debug` in all cases.
+
+| Environment | Behavior |
+|-------------|----------|
+| Production (`env.DEV` is falsy, `cli` not set) | `FileReporter` only -- all logs (including debug) go to `.logs/` |
+| Development + `SD_DEBUG` env var | `PrettyReporter` only -- all logs (including debug) to terminal |
+| Development (default) | `FileReporter` (all levels) + `PrettyReporter` (info and below only) |
+| `cli: true` | Same as `SD_DEBUG` mode -- always uses `PrettyReporter` |
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `opts` | `SetupConsolaOptions` | Optional configuration |
+
+### createFileReporter
+
+```ts
+function createFileReporter(options?: FileReporterOptions): ConsolaReporter
+```
+
+Create a file-based consola reporter that writes JSON-line entries to `.logs/` directory.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `options` | `FileReporterOptions` | Optional size and retention settings |
+
+File naming: `app.YYYY-MM-DD.log`, with sequential suffix (`app.YYYY-MM-DD.1.log`) when size limit is reached.
+
+Each log entry is a single JSON line with fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `time` | `string` | ISO 8601 timestamp |
+| `level` | `string` | Uppercase log type (e.g., `"INFO"`, `"ERROR"`) |
+| `tag` | `string` | Log tag (omitted if empty) |
+| `msg` | `string` | Concatenated message arguments (omitted if none) |
+| `err` | `{ message, stack }` | Error details (present when an Error argument is logged) |
+
+Log rotation: when the date changes or file size exceeds `maxSize`, a new file is opened. Files older than `maxDays` are automatically cleaned up.
+
+### withMaxLevel
+
+```ts
+function withMaxLevel(reporter: ConsolaReporter, maxLevel: number): ConsolaReporter
+```
+
+Wrap a consola reporter to suppress log entries above a specified level. Log entries with `logObj.level > maxLevel` are silently dropped.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `reporter` | `ConsolaReporter` | The reporter to wrap |
+| `maxLevel` | `number` | Maximum log level to pass through (e.g., `LogLevels.info` for info and below) |
+
+## Usage
+
+```ts
+import { setupConsola, createFileReporter, PrettyReporter, withMaxLevel } from "@simplysm/core-node";
+import consola, { LogLevels } from "consola";
+
+// One-call setup (recommended)
+setupConsola();
+
+// Manual configuration example
+consola.level = LogLevels.debug;
+consola.options.reporters = [
+  createFileReporter({ maxSize: 10 * 1024 * 1024, maxDays: 7 }),
+  withMaxLevel(new PrettyReporter(), LogLevels.info),
+];
+
+// Then use consola as usual
+consola.info("Server started on port 3000");
+consola.debug("Connection pool initialized");
+consola.error(new Error("Database connection failed"));
+```

package/docs/cpx.md

@@ -9,38 +9,10 @@ import { cpx } from "@simplysm/core-node";
 
 ## Types
 
-### ExecOptions
+### SpawnResult
 
 ```ts
-interface ExecOptions {
-  cwd?: string;
-  env?: Record<string, string>;
-  stdio?: "pipe" | "inherit";
-  shell?: boolean;
-  reject?: boolean;
-}
-```
-
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| `cwd` | `string` | `undefined` | Working directory for the child process |
-| `env` | `Record<string, string>` | `undefined` | Extra environment variables (merged with `process.env`) |
-| `stdio` | `"pipe" \| "inherit"` | `"pipe"` | `"pipe"` captures stdout/stderr; `"inherit"` passes them through |
-| `shell` | `boolean` | `false` | Run the command in a shell |
-| `reject` | `boolean` | `true` | If `false`, the promise resolves even on non-zero exit codes |
-
-### ExecSyncOptions
-
-```ts
-type ExecSyncOptions = Omit<ExecOptions, "reject">
-```
-
-Same as `ExecOptions` without the `reject` field. `execSync` always returns a result regardless of exit code.
-
-### ExecResult
-
-```ts
-interface ExecResult {
+interface SpawnResult {
   stdout: string;
   stderr: string;
   exitCode: number;
@@ -49,27 +21,27 @@ interface ExecResult {
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `stdout` | `string` | Captured standard output (empty when `stdio: "inherit"`) |
-| `stderr` | `string` | Captured standard error (empty when `stdio: "inherit"`) |
+| `stdout` | `string` | Captured standard output (empty when stdio is not `"pipe"`) |
+| `stderr` | `string` | Captured standard error (empty when stdio is not `"pipe"`) |
 | `exitCode` | `number` | Process exit code |
 
-## ExecProcess
+## SpawnProcess
 
 ```ts
-class ExecProcess implements PromiseLike<ExecResult> {
+class SpawnProcess implements PromiseLike<SpawnResult> {
   get pid(): number | undefined;
   then<TResult1, TResult2>(
-    onfulfilled?: ((value: ExecResult) => TResult1 | PromiseLike<TResult1>) | null,
+    onfulfilled?: ((value: SpawnResult) => TResult1 | PromiseLike<TResult1>) | null,
     onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,
   ): Promise<TResult1 | TResult2>;
   catch<TResult>(
     onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null,
-  ): Promise<ExecResult | TResult>;
+  ): Promise<SpawnResult | TResult>;
   kill(signal?: NodeJS.Signals | number): boolean;
 }
 ```
 
-A `PromiseLike<ExecResult>` wrapper around `ChildProcess`. Can be `await`ed for the result or `kill()`ed to terminate the process.
+A `PromiseLike<SpawnResult>` wrapper around `ChildProcess`. Can be `await`ed for the result or `kill()`ed to terminate the process.
 
 | Property/Method | Description |
 |-----------------|-------------|
@@ -80,35 +52,61 @@ A `PromiseLike<ExecResult>` wrapper around `ChildProcess`. Can be `await`ed for
 
 ## Functions
 
-### exec
+### spawn
 
 ```ts
-function exec(cmd: string, args: string[], options?: ExecOptions): ExecProcess
+function spawn(
+  cmd: string,
+  args: string[],
+  options?: SpawnOptions & { reject?: boolean },
+): SpawnProcess
 ```
 
-Spawn a child process asynchronously. Returns an `ExecProcess` that can be awaited or killed.
+Spawn a child process asynchronously. Returns a `SpawnProcess` that can be awaited or killed. Options extend Node.js `SpawnOptions` with an additional `reject` field.
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `cmd` | `string` | Command to execute |
 | `args` | `string[]` | Command arguments |
-| `options` | `ExecOptions` | Execution options |
+| `options` | `SpawnOptions & { reject?: boolean }` | Node.js spawn options plus `reject` (default `true`) |
 
-By default, rejects if exit code is non-zero. Set `options.reject: false` to always resolve. Output is decoded using system encoding detection (UTF-8 with fallback).
+By default, rejects if exit code is non-zero. Set `options.reject: false` to always resolve. The `env` option is merged with `process.env`. Output is decoded using system encoding detection (UTF-8 with fallback).
 
-### execSync
+### spawnSync
 
 ```ts
-function execSync(cmd: string, args: string[], options?: ExecSyncOptions): ExecResult
+function spawnSync(
+  cmd: string,
+  args: string[],
+  options?: SpawnSyncOptions & { reject?: boolean },
+): SpawnResult
 ```
 
-Spawn a child process synchronously. Always returns an `ExecResult` regardless of exit code.
+Spawn a child process synchronously. Options extend Node.js `SpawnSyncOptions` with an additional `reject` field.
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `cmd` | `string` | Command to execute |
 | `args` | `string[]` | Command arguments |
-| `options` | `ExecSyncOptions` | Execution options |
+| `options` | `SpawnSyncOptions & { reject?: boolean }` | Node.js spawn sync options plus `reject` (default `true`) |
+
+By default, throws if exit code is non-zero. Set `options.reject: false` to always return the result.
+
+### resolveStdioPipe
+
+```ts
+function resolveStdioPipe(
+  stdio: SpawnOptions["stdio"],
+): { stdout: boolean; stderr: boolean }
+```
+
+Determine whether stdout and stderr are piped based on the `stdio` option value.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `stdio` | `SpawnOptions["stdio"]` | The stdio configuration (string or array) |
+
+Returns `{ stdout: true, stderr: true }` when `stdio` is `"pipe"` or `undefined`. For array form, checks `stdio[1]` and `stdio[2]` individually.
 
 ### codePageToEncoding
 
@@ -155,19 +153,19 @@ Decode a `Uint8Array` to a string. First tries UTF-8 (with `fatal: true`); if th
 import { cpx } from "@simplysm/core-node";
 
 // Basic execution
-const result = await cpx.exec("git", ["status"], { cwd: "/project" });
+const result = await cpx.spawn("git", ["status"], { cwd: "/project" });
 // result.stdout, result.stderr, result.exitCode
 
 // Inherit stdio
-await cpx.exec("make", ["build"], { stdio: "inherit" });
+await cpx.spawn("make", ["build"], { stdio: "inherit" });
 
 // Don't reject on failure
-const { exitCode } = await cpx.exec("test-cmd", [], { reject: false });
+const { exitCode } = await cpx.spawn("test-cmd", [], { reject: false });
 
 // Kill a long-running process
-const proc = cpx.exec("long-cmd", []);
+const proc = cpx.spawn("long-cmd", []);
 proc.kill();
 
 // Synchronous execution
-const syncResult = cpx.execSync("node", ["--version"]);
+const syncResult = cpx.spawnSync("node", ["--version"]);
 ```

package/docs/fsx.md

@@ -111,21 +111,21 @@ async function read(targetPath: string): Promise<string>
 
 Read a file as a UTF-8 string (async).
 
-### readBufferSync
+### readBytesSync
 
 ```ts
-function readBufferSync(targetPath: string): Buffer
+function readBytesSync(targetPath: string): Uint8Array
 ```
 
-Read a file as a Buffer (sync).
+Read a file as a Uint8Array (sync).
 
-### readBuffer
+### readBytes
 
 ```ts
-async function readBuffer(targetPath: string): Promise<Buffer>
+async function readBytes(targetPath: string): Promise<Uint8Array>
 ```
 
-Read a file as a Buffer (async).
+Read a file as a Uint8Array (async).
 
 ### readJsonSync
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/core-node",
-  "version": "14.0.15",
+  "version": "14.0.17",
   "description": "심플리즘 패키지 - 코어 (node)",
   "author": "심플리즘",
   "license": "Apache-2.0",
@@ -25,9 +25,9 @@
     "glob": "^13.0.6",
     "minimatch": "^10.2.5",
     "tsx": "^4.21.0",
-    "@simplysm/core-common": "14.0.15"
+    "@simplysm/core-common": "14.0.17"
   },
   "devDependencies": {
-    "@types/node": "^20.19.37"
+    "@types/node": "^20.19.39"
   }
 }

package/src/features/consola/file-reporter.ts

@@ -0,0 +1,127 @@
+import type { ConsolaOptions, ConsolaReporter, LogObject } from "consola";
+import fs from "fs";
+import path from "path";
+
+export interface FileReporterOptions {
+  /** @default 20MB */
+  maxSize?: number;
+  /** @default 14 */
+  maxDays?: number;
+}
+
+const DEFAULT_MAX_SIZE = 20 * 1024 * 1024;
+const DEFAULT_MAX_DAYS = 14;
+
+export function createFileReporter(options?: FileReporterOptions): ConsolaReporter {
+  const maxSize = options?.maxSize ?? DEFAULT_MAX_SIZE;
+  const maxDays = options?.maxDays ?? DEFAULT_MAX_DAYS;
+  const outDir = path.resolve(process.cwd(), ".logs");
+
+  let dirEnsured = false;
+  let stream: fs.WriteStream | null = null;
+  let currentDate = "";
+  let currentSize = 0;
+  let lastCleanDate = "";
+
+  function rotate(dateStr: string): void {
+    if (stream != null) {
+      stream.end();
+      stream = null;
+    }
+
+    if (!dirEnsured) {
+      fs.mkdirSync(outDir, { recursive: true });
+      dirEnsured = true;
+    }
+
+    const filePath = resolveLogFilePath(outDir, dateStr, maxSize);
+    try {
+      currentSize = fs.statSync(filePath).size;
+    } catch {
+      currentSize = 0;
+    }
+
+    stream = fs.createWriteStream(filePath, { flags: "a" });
+    currentDate = dateStr;
+  }
+
+  return {
+    log(logObj: LogObject, _ctx: { options: ConsolaOptions }) {
+      const entry: Record<string, unknown> = {
+        time: logObj.date.toISOString(),
+        level: logObj.type.toUpperCase(),
+      };
+      if (logObj.tag) {
+        entry["tag"] = logObj.tag;
+      }
+
+      const msgs: string[] = [];
+      for (const a of logObj.args) {
+        if (a instanceof Error) {
+          entry["err"] = { message: a.message, stack: a.stack };
+        } else {
+          msgs.push(typeof a === "string" ? a : String(a));
+        }
+      }
+      if (msgs.length > 0) {
+        entry["msg"] = msgs.join(" ");
+      }
+
+      const line = JSON.stringify(entry) + "\n";
+
+      const date = logObj.date;
+      const dateStr = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+
+      if (dateStr !== currentDate || currentSize + line.length >= maxSize) {
+        rotate(dateStr);
+      }
+
+      stream!.write(line);
+      currentSize += line.length;
+
+      if (lastCleanDate !== dateStr) {
+        lastCleanDate = dateStr;
+        cleanOldFiles(outDir, maxDays);
+      }
+    },
+  };
+}
+
+function resolveLogFilePath(outDir: string, dateStr: string, maxSize: number): string {
+  const basePath = path.join(outDir, `app.${dateStr}.log`);
+
+  if (!fs.existsSync(basePath)) return basePath;
+  if (fs.statSync(basePath).size < maxSize) return basePath;
+
+  let seq = 1;
+  while (true) {
+    const seqPath = path.join(outDir, `app.${dateStr}.${seq}.log`);
+    if (!fs.existsSync(seqPath)) return seqPath;
+    if (fs.statSync(seqPath).size < maxSize) return seqPath;
+    seq++;
+  }
+}
+
+function cleanOldFiles(outDir: string, maxDays: number): void {
+  let entries: string[];
+  try {
+    entries = fs.readdirSync(outDir);
+  } catch {
+    return;
+  }
+
+  const cutoff = new Date();
+  cutoff.setDate(cutoff.getDate() - maxDays);
+  const cutoffStr = `${cutoff.getFullYear()}-${String(cutoff.getMonth() + 1).padStart(2, "0")}-${String(cutoff.getDate()).padStart(2, "0")}`;
+
+  for (const entry of entries) {
+    const match = /^app\.(\d{4}-\d{2}-\d{2})(?:\.\d+)?\.log$/.exec(entry);
+    if (match != null && match[1] < cutoffStr) {
+      try {
+        fs.unlinkSync(path.join(outDir, entry));
+      } catch {
+        // ignore
+      }
+    }
+  }
+}

package/src/features/consola/pretty-reporter.ts

@@ -0,0 +1,172 @@
+import type { ConsolaReporter, LogObject, ConsolaOptions } from "consola";
+import { formatWithOptions } from "node:util";
+import { sep } from "node:path";
+import { env } from "@simplysm/core-common";
+
+// -- Constants ----------------------------------------------------------------
+
+const TYPE_ICONS: Record<string, string> = {
+  error: "\u2716",
+  fatal: "\u2716",
+  ready: "\u2714",
+  warn: "\u26A0",
+  info: "\u2139",
+  success: "\u2714",
+  debug: "\u2699",
+  trace: "\u2192",
+  fail: "\u2716",
+  start: "\u25D0",
+  log: "",
+};
+
+type AnsiColor = "gray" | "red" | "green" | "yellow" | "cyan" | "magenta";
+
+const TYPE_COLORS: Record<string, AnsiColor | undefined> = {
+  info: "cyan",
+  fail: "red",
+  success: "green",
+  ready: "green",
+  start: "magenta",
+};
+
+const LEVEL_COLORS: Record<number, AnsiColor | undefined> = {
+  0: "red",
+  1: "yellow",
+};
+
+const ANSI_CODES: Record<AnsiColor, string> = {
+  gray: "\x1b[90m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  cyan: "\x1b[36m",
+  magenta: "\x1b[35m",
+};
+
+const ANSI_RESET = "\x1b[0m";
+
+// -- Helpers ------------------------------------------------------------------
+
+function colorize(color: AnsiColor, text: string, enabled: boolean): string {
+  if (!enabled) return text;
+  return `${ANSI_CODES[color]}${text}${ANSI_RESET}`;
+}
+
+function writeStream(data: string, stream: NodeJS.WritableStream): void {
+  const s = stream as NodeJS.WritableStream & { __write?: typeof stream.write };
+  const write = s.__write ?? s.write;
+  write.call(stream, data);
+}
+
+function detectColorSupport(): boolean {
+  if (env("NO_COLOR") != null) return false;
+  if (env("FORCE_COLOR") != null) return true;
+  if (process.stdout.isTTY === true) return true;
+  return process.platform === "win32";
+}
+
+// -- Reporter -----------------------------------------------------------------
+
+interface FormatOpts {
+  date?: boolean;
+  colors: boolean;
+  compact?: boolean | number;
+  errorLevel?: number;
+}
+
+export class PrettyReporter implements ConsolaReporter {
+  log(logObj: LogObject, ctx: { options: ConsolaOptions }): void {
+    const opts: FormatOpts = {
+      ...ctx.options.formatOptions,
+      colors: detectColorSupport(),
+    };
+
+    const line = this._formatLogObj(logObj, opts);
+    const stream =
+      logObj.level < 2
+        ? ctx.options.stderr ?? process.stderr
+        : ctx.options.stdout ?? process.stdout;
+
+    writeStream(line + "\n", stream);
+  }
+
+  private _formatLogObj(logObj: LogObject, opts: FormatOpts): string {
+    const formattedArgs = this._formatArgs(logObj.args, opts);
+    const [message, ...additional] = formattedArgs.split("\n");
+
+    if (logObj.type === "box") {
+      return this._formatBox(logObj, formattedArgs);
+    }
+
+    const tag = logObj.tag !== "" ? colorize("gray", `[${logObj.tag}]`, opts.colors) : "";
+    const icon = this._formatIcon(logObj, opts.colors);
+    const date = this._formatDate(logObj.date, opts);
+    const coloredDate = date !== "" ? colorize("gray", date, opts.colors) : "";
+
+    let fullLine = [tag, icon, message, coloredDate].filter(Boolean).join(" ");
+
+    if (additional.length > 0) {
+      fullLine += "\n" + additional.join("\n");
+    }
+
+    if (logObj.type === "trace") {
+      const err = new Error("Trace: " + logObj.message);
+      fullLine += this._formatStack(err.stack ?? "", err.message);
+    }
+
+    const isBadge = (logObj as LogObject & { badge?: boolean }).badge ?? logObj.level < 2;
+    return isBadge ? "\n" + fullLine + "\n" : fullLine;
+  }
+
+  private _formatArgs(args: unknown[], opts: FormatOpts): string {
+    const processed = args.map((arg) => {
+      if (arg != null && typeof arg === "object" && typeof (arg as Error).stack === "string") {
+        return this._formatError(arg as Error, opts);
+      }
+      return arg;
+    });
+    return formatWithOptions({ colors: opts.colors, compact: opts.compact }, ...processed);
+  }
+
+  private _formatError(err: Error, opts: FormatOpts): string {
+    const message = err.message;
+    const stack = err.stack != null ? this._formatStack(err.stack, message, opts) : "";
+    const level = opts.errorLevel ?? 0;
+    const prefix = level > 0 ? `${"  ".repeat(level)}[cause]: ` : "";
+    const cause =
+      err.cause instanceof Error
+        ? "\n\n" + this._formatError(err.cause, { ...opts, errorLevel: level + 1 })
+        : "";
+    return prefix + message + "\n" + stack + cause;
+  }
+
+  private _formatStack(stack: string, message: string, opts?: FormatOpts): string {
+    const cwd = process.cwd() + sep;
+    const indent = "  ".repeat((opts?.errorLevel ?? 0) + 1);
+    const lines = stack
+      .split("\n")
+      .splice(message.split("\n").length)
+      .map((l) => l.trim().replace("file://", "").replace(cwd, ""));
+    return `\n${indent}` + lines.map((l) => `  ${l}`).join(`\n${indent}`);
+  }
+
+  private _formatIcon(logObj: LogObject, useColors: boolean): string {
+    const icon = TYPE_ICONS[logObj.type] ?? "";
+    if (icon === "") return "";
+    const color: AnsiColor = TYPE_COLORS[logObj.type] ?? LEVEL_COLORS[logObj.level] ?? "gray";
+    return colorize(color, icon, useColors);
+  }
+
+  private _formatDate(date: Date, opts: FormatOpts): string {
+    if (!opts.date) return "";
+    const base = date.toLocaleTimeString();
+    return `${base}.${String(date.getMilliseconds()).padStart(3, "0")}`;
+  }
+
+  private _formatBox(logObj: LogObject, message: string): string {
+    const tag = logObj.tag !== "" ? `[${logObj.tag}]` : "";
+    const title = (logObj as LogObject & { title?: string }).title;
+    const lines = [tag, title, ...message.split("\n")].filter(Boolean);
+    return "\n" + lines.map((l) => ` > ${l}`).join("\n") + "\n";
+  }
+}

package/src/features/consola/setup-consola.ts

@@ -0,0 +1,40 @@
+import type { ConsolaOptions, ConsolaReporter, LogObject } from "consola";
+import consola, { LogLevels } from "consola";
+import { env, parseBoolEnv } from "@simplysm/core-common";
+import { PrettyReporter } from "./pretty-reporter";
+import { createFileReporter } from "./file-reporter";
+
+export function withMaxLevel(reporter: ConsolaReporter, maxLevel: number): ConsolaReporter {
+  return {
+    log(logObj: LogObject, ctx: { options: ConsolaOptions }) {
+      if (logObj.level > maxLevel) return;
+      reporter.log(logObj, ctx);
+    },
+  };
+}
+
+export interface SetupConsolaOptions {
+  cli?: boolean;
+}
+
+export function setupConsola(opts?: SetupConsolaOptions): void {
+  if (!opts?.cli && !parseBoolEnv(env("DEV"))) {
+    // prod: debug 포함 FileReporter
+    consola.level = LogLevels.debug;
+    consola.options.reporters = [createFileReporter()];
+    return;
+  }
+
+  if (parseBoolEnv(env("SD_DEBUG"))) {
+    // dev + SD_DEBUG: debug 포함 PrettyReporter
+    consola.level = LogLevels.debug;
+    consola.options.reporters = [new PrettyReporter()];
+  } else {
+    // dev: debug 포함 FileReporter + debug 비포함 PrettyReporter
+    consola.level = LogLevels.debug;
+    consola.options.reporters = [
+      createFileReporter(),
+      withMaxLevel(new PrettyReporter(), LogLevels.info),
+    ];
+  }
+}

package/src/index.ts

@@ -5,6 +5,9 @@ export * as pathx from "./utils/path";
 
 // 기능
 export * from "./features/fs-watcher";
+export * from "./features/consola/pretty-reporter";
+export * from "./features/consola/file-reporter";
+export * from "./features/consola/setup-consola";
 
 // 워커
 export * from "./worker/types";

package/src/utils/cp.ts

@@ -1,6 +1,6 @@
 import type { ChildProcess, SpawnOptions, SpawnSyncOptions } from "child_process";
 import { execSync as cpExecSync, spawn as cpSpawn, spawnSync as cpSpawnSync } from "child_process";
-import { bytes } from "@simplysm/core-common";
+import { bytes, env } from "@simplysm/core-common";
 
 const CODE_PAGE_MAP: Record<number, string> = {
   65001: "utf-8",
@@ -36,7 +36,7 @@ export function getSystemEncoding(): string {
         return _cachedEncoding;
       }
     } else {
-      const lang = process.env["LANG"] ?? process.env["LC_ALL"] ?? "";
+      const lang = env("LANG") ?? env("LC_ALL") ?? "";
       const dotIndex = lang.indexOf(".");
       if (dotIndex >= 0) {
         let encoding = lang.slice(dotIndex + 1).split("@")[0].toLowerCase();