@gobing-ai/ts-infra 0.5.21 → 0.5.23

package/README.md

@@ -621,7 +621,7 @@ bootstrap:
   logging:
     level: info
     console: true
-    filePath: ./logs/app.jsonl
+    filePath: ./logs/app.jsonl   # a directory (e.g. ./logs/) writes daily spur{YYYYMMDD}.log files
   telemetry:
     enabled: true
     serviceName: billing-api
@@ -775,7 +775,9 @@ never opens files: it calls `attachFileObserver(lifecycleBus, filePath, writer)`
 only when `services.fileObserverWriter` is provided; its portable default path is
 `.spur/logs/system-events.jsonl`. The Node subpath `runNodeApplication` constructs a
 Node writer and uses `createNodeFileSystem()` to resolve the path to
-`<projectRoot>/.spur/logs/system-events.jsonl`. Set `config.events.fileObserver: false`
+`<projectRoot>/.spur/logs/system-events{YYYYMM}.jsonl` (one file per month). The Node
+writer expands `{YYYYMM}` / `{YYYYMMDD}` (local date) in any `filePath` on each write, so a
+long-running process rolls over without a restart. Set `config.events.fileObserver: false`
 to disable; supply a custom `filePath` (or a test-stub writer via
 `services.fileObserverWriter`) to override.
 

package/dist/application-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-node.d.ts","sourceRoot":"","sources":["../src/application-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,OAAO,KAAK,EACR,2BAA2B,EAC3B,uBAAuB,EAEvB,kBAAkB,EAClB,qBAAqB,EAGrB,QAAQ,EACR,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,qBAAqB,CAAC;AAS7B,kGAAkG;AAClG,qBAAa,qBAAsB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI9B;AAwOD;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,gBAAgB;IACnE,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW;IAChG,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC5D,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAChC,SAAS,CAAC,EAAE,6BAA6B,CAAC;QAC1C,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAChC,CAAC;IACF,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IACjF,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvF,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,CACZ,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,EAC5C,MAAM,EAAE,qBAAqB,KAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW,EACjG,OAAO,EAAE,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,GACrD,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAyJlD"}
+{"version":3,"file":"application-node.d.ts","sourceRoot":"","sources":["../src/application-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,OAAO,KAAK,EACR,2BAA2B,EAC3B,uBAAuB,EAEvB,kBAAkB,EAClB,qBAAqB,EAGrB,QAAQ,EACR,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,qBAAqB,CAAC;AAS7B,kGAAkG;AAClG,qBAAa,qBAAsB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI9B;AA8PD;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,gBAAgB;IACnE,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW;IAChG,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC5D,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAChC,SAAS,CAAC,EAAE,6BAA6B,CAAC;QAC1C,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAChC,CAAC;IACF,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IACjF,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvF,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,CACZ,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,EAC5C,MAAM,EAAE,qBAAqB,KAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW,EACjG,OAAO,EAAE,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,GACrD,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CA6JlD"}

package/dist/application-node.js

@@ -14,8 +14,8 @@
  *
  * @module application-node
  */
-import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
-import { dirname } from 'node:path';
+import { appendFileSync, mkdirSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 import { createDbAdapter } from '@gobing-ai/ts-db';
 import { createNodeFileSystem, interpolateTree, parseYamlObject } from '@gobing-ai/ts-runtime';
 import { runApplication } from './application/index.js';
@@ -159,11 +159,33 @@ function normalizeSchedulerJobs(raw) {
     return jobs;
 }
 // ── File sink helper ──────────────────────────────────────────────────────
+/**
+ * Expand `{YYYYMMDD}` / `{YYYYMM}` (local date) in a file path. Resolved per write,
+ * so a long-running process rolls over to the next file without a restart.
+ */
+function expandDateTokens(path, now = new Date()) {
+    const yyyymm = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, '0')}`;
+    const dd = String(now.getDate()).padStart(2, '0');
+    return path.replaceAll('{YYYYMMDD}', `${yyyymm}${dd}`).replaceAll('{YYYYMM}', yyyymm);
+}
+function isDirectoryPath(path) {
+    if (path.endsWith('/') || path.endsWith('\\'))
+        return true;
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** A directory `filePath` gets the daily-rotated `spur{YYYYMMDD}.log` inside it; a file path is used as-is. */
 function createFileSink(filePath) {
+    const pattern = isDirectoryPath(filePath) ? join(filePath, 'spur{YYYYMMDD}.log') : filePath;
     return (line) => {
         try {
-            mkdirSync(dirname(filePath), { recursive: true });
-            appendFileSync(filePath, line);
+            const target = expandDateTokens(pattern);
+            mkdirSync(dirname(target), { recursive: true });
+            appendFileSync(target, line);
         }
         catch {
             // Best-effort — don't crash on log write failure
@@ -347,7 +369,7 @@ export async function runNodeApplication(options) {
     const fileObserverWriter = options.services?.fileObserverWriter ?? {
         ensureDir: (dir) => {
             try {
-                mkdirSync(dir, { recursive: true });
+                mkdirSync(expandDateTokens(dir), { recursive: true });
             }
             catch (error) {
                 // ensureDir contract: an existing directory is success. Node
@@ -359,10 +381,13 @@ export async function runNodeApplication(options) {
             }
         },
         appendFile: (path, content) => {
-            appendFileSync(path, content);
+            const target = expandDateTokens(path);
+            mkdirSync(dirname(target), { recursive: true });
+            appendFileSync(target, content);
         },
     };
-    const eventsFilePath = eventsOpts.filePath ?? injectedFileSystem.resolve('.spur', 'logs', 'system-events.jsonl');
+    // Monthly file by default so the raw bus trace never grows unbounded in one file.
+    const eventsFilePath = eventsOpts.filePath ?? injectedFileSystem.resolve('.spur', 'logs', 'system-events{YYYYMM}.jsonl');
     const eventsConfig = {
         ...eventsOpts,
         filePath: eventsFilePath,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-infra",
-    "version": "0.5.21",
+    "version": "0.5.23",
     "description": "@gobing-ai/ts-infra — Infrastructure backbone: event bus, job queue, scheduler, telemetry, API client, and logging.",
     "keywords": [
         "typescript",
@@ -78,12 +78,12 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-infra-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-utils": "^0.5.21",
+        "@gobing-ai/ts-utils": "^0.5.23",
         "@logtape/logtape": "^2.0.0"
     },
     "peerDependencies": {
-        "@gobing-ai/ts-db": "^0.5.21",
-        "@gobing-ai/ts-runtime": "^0.5.21",
+        "@gobing-ai/ts-db": "^0.5.23",
+        "@gobing-ai/ts-runtime": "^0.5.23",
         "@opentelemetry/api": "^1.9.0",
         "@opentelemetry/sdk-trace-node": "^2.0.0",
         "@opentelemetry/sdk-metrics": "^2.0.0",
@@ -116,8 +116,8 @@
         }
     },
     "devDependencies": {
-        "@gobing-ai/ts-db": "^0.5.21",
-        "@gobing-ai/ts-runtime": "^0.5.21",
+        "@gobing-ai/ts-db": "^0.5.23",
+        "@gobing-ai/ts-runtime": "^0.5.23",
         "@types/bun": "1.3.14",
         "@opentelemetry/api": "^1.9.0",
         "@opentelemetry/sdk-trace-node": "^2.0.0",

package/src/application-node.ts

@@ -15,8 +15,8 @@
  * @module application-node
  */
 
-import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
-import { dirname } from 'node:path';
+import { appendFileSync, mkdirSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 
 import { createDbAdapter, type DbAdapter } from '@gobing-ai/ts-db';
 import { createNodeFileSystem, interpolateTree, parseYamlObject } from '@gobing-ai/ts-runtime';
@@ -217,11 +217,33 @@ function normalizeSchedulerJobs(raw: unknown): readonly SchedulerJobConfig[] {
 
 // ── File sink helper ──────────────────────────────────────────────────────
 
+/**
+ * Expand `{YYYYMMDD}` / `{YYYYMM}` (local date) in a file path. Resolved per write,
+ * so a long-running process rolls over to the next file without a restart.
+ */
+function expandDateTokens(path: string, now = new Date()): string {
+    const yyyymm = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, '0')}`;
+    const dd = String(now.getDate()).padStart(2, '0');
+    return path.replaceAll('{YYYYMMDD}', `${yyyymm}${dd}`).replaceAll('{YYYYMM}', yyyymm);
+}
+
+function isDirectoryPath(path: string): boolean {
+    if (path.endsWith('/') || path.endsWith('\\')) return true;
+    try {
+        return statSync(path).isDirectory();
+    } catch {
+        return false;
+    }
+}
+
+/** A directory `filePath` gets the daily-rotated `spur{YYYYMMDD}.log` inside it; a file path is used as-is. */
 function createFileSink(filePath: string): (line: string) => void {
+    const pattern = isDirectoryPath(filePath) ? join(filePath, 'spur{YYYYMMDD}.log') : filePath;
     return (line: string) => {
         try {
-            mkdirSync(dirname(filePath), { recursive: true });
-            appendFileSync(filePath, line);
+            const target = expandDateTokens(pattern);
+            mkdirSync(dirname(target), { recursive: true });
+            appendFileSync(target, line);
         } catch {
             // Best-effort — don't crash on log write failure
         }
@@ -470,7 +492,7 @@ export async function runNodeApplication<TAppConfig = unknown, TEvents extends E
     const fileObserverWriter = options.services?.fileObserverWriter ?? {
         ensureDir: (dir: string) => {
             try {
-                mkdirSync(dir, { recursive: true });
+                mkdirSync(expandDateTokens(dir), { recursive: true });
             } catch (error) {
                 // ensureDir contract: an existing directory is success. Node
                 // semantics already suppress EEXIST with `recursive: true`, but
@@ -480,10 +502,14 @@ export async function runNodeApplication<TAppConfig = unknown, TEvents extends E
             }
         },
         appendFile: (path: string, content: string) => {
-            appendFileSync(path, content);
+            const target = expandDateTokens(path);
+            mkdirSync(dirname(target), { recursive: true });
+            appendFileSync(target, content);
         },
     };
-    const eventsFilePath = eventsOpts.filePath ?? injectedFileSystem.resolve('.spur', 'logs', 'system-events.jsonl');
+    // Monthly file by default so the raw bus trace never grows unbounded in one file.
+    const eventsFilePath =
+        eventsOpts.filePath ?? injectedFileSystem.resolve('.spur', 'logs', 'system-events{YYYYMM}.jsonl');
     const eventsConfig: EventsOptions<TEvents> = {
         ...eventsOpts,
         filePath: eventsFilePath,