@shetty4l/core 0.1.25 → 0.1.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shetty4l/core",
-  "version": "0.1.25",
+  "version": "0.1.28",
   "description": "Shared infrastructure primitives for Bun/TypeScript services",
   "repository": {
     "type": "git",
@@ -17,7 +17,8 @@
     "./cli": "./src/cli.ts",
     "./daemon": "./src/daemon.ts",
     "./db": "./src/db.ts",
-    "./http": "./src/http.ts"
+    "./http": "./src/http.ts",
+    "./log": "./src/log.ts"
   },
   "files": [
     "src/",

package/src/cli.ts

@@ -81,7 +81,9 @@ export function createLogsCommand(opts: LogsCommandOpts): CommandHandler {
       return 0;
     }
 
-    const text = await file.text();
+    const raw = await file.text();
+    // Strip null bytes that can appear from historical Bun.file() corruption
+    const text = raw.replaceAll("\0", "");
     const allLines = text.split("\n").filter((l) => l.length > 0);
 
     if (allLines.length === 0) {

package/src/daemon.ts

@@ -13,6 +13,7 @@ import {
   mkdirSync,
   openSync,
   readFileSync,
+  renameSync,
   unlinkSync,
 } from "fs";
 import { join } from "path";
@@ -160,10 +161,20 @@ export function createDaemonManager(opts: DaemonManagerOpts): DaemonManager {
         mkdirSync(configDir, { recursive: true });
       }
 
-      // Open log file in append mode so previous content is preserved
-      // and ongoing console.error output from the child is captured.
+      // Rotate previous log file so it doesn't grow unbounded.
+      // Keep one generation: service.log -> service.log.old
+      if (existsSync(logFile)) {
+        try {
+          renameSync(logFile, `${logFile}.old`);
+        } catch {
+          // Best-effort — if rotation fails, append to existing file
+        }
+      }
+
+      // Open log file in append mode so ongoing console.error output
+      // from the child is captured.
       // Bun.file() opens with O_WRONLY|O_CREAT (no append, no truncate)
-      // which writes from offset 0 and corrupts logs.
+      // which writes from offset 0 and corrupts logs — always use openSync("a").
       const logFd = openSync(logFile, "a");
 
       const proc = Bun.spawn(["bun", "run", cliPath, serveCommand], {

package/src/index.ts

@@ -4,7 +4,7 @@
  * Shared infrastructure primitives for Bun/TypeScript services.
  *
  * Import from the root for convenience, or from sub-paths for specificity:
- *   import { config, http } from "@shetty4l/core"
+ *   import { config, http, log } from "@shetty4l/core"
  *   import { parsePort } from "@shetty4l/core/config"
  */
 
@@ -14,6 +14,7 @@ export * as config from "./config";
 export * as daemon from "./daemon";
 export * as db from "./db";
 export * as http from "./http";
+export * as log from "./log";
 export type { Err, Ok, Port, Result } from "./result";
 export { err, ok } from "./result";
 export type { ShutdownOpts } from "./signals";

package/src/log.ts

@@ -0,0 +1,29 @@
+/**
+ * Lightweight structured logger for all services.
+ *
+ * Each service creates a named logger via `createLogger("serviceName")`.
+ * Output format: `[ISO timestamp] name: message`
+ * All output goes to stderr via console.error so stdout stays clean for
+ * structured CLI output (--json).
+ */
+
+export type Logger = (msg: string) => void;
+
+/**
+ * Create a prefixed logger that writes to stderr.
+ *
+ * @param name - Service or module name (e.g. "cortex", "synapse")
+ * @returns A function that logs `[timestamp] name: msg` to stderr
+ *
+ * @example
+ * ```ts
+ * const log = createLogger("cortex");
+ * log("processing loop started");
+ * // => [2026-02-20T11:36:00.000Z] cortex: processing loop started
+ * ```
+ */
+export function createLogger(name: string): Logger {
+  return (msg: string) => {
+    console.error(`[${new Date().toISOString()}] ${name}: ${msg}`);
+  };
+}