wangchuan 2.9.0 → 2.11.0

package/dist/src/utils/logger.d.ts

@@ -1,6 +1,13 @@
 /**
- * logger.ts — 统一日志输出，支持着色与级别过滤
+ * logger.ts — Structured logging with level filtering, timestamps, and JSON output
+ *
+ * Supports:
+ *   WANGCHUAN_LOG_LEVEL env: silent | error | warn | info | debug (default: info)
+ *   WANGCHUAN_LOG_FORMAT env: json — outputs JSON lines for machine parsing
+ *   Timestamp prefix in debug mode: [ISO8601] [LEVEL] message
+ *   trace() method for very verbose output (only emitted in debug level)
  */
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
 export declare const logger: {
     readonly info: (...a: unknown[]) => void;
     readonly ok: (...a: unknown[]) => void;
@@ -8,6 +15,8 @@ export declare const logger: {
     readonly error: (...a: unknown[]) => void;
     readonly debug: (...a: unknown[]) => void;
     readonly step: (...a: unknown[]) => void;
+    /** Very verbose tracing — only emitted when log level is debug */
+    readonly trace: (...a: unknown[]) => void;
     readonly banner: (text: string) => void;
 };
 //# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,eAAO,MAAM,MAAM;0BACH,OAAO,EAAE;wBACT,OAAO,EAAE;0BACT,OAAO,EAAE;2BACT,OAAO,EAAE;2BACT,OAAO,EAAE;0BACT,OAAO,EAAE;4BAEV,MAAM,KAAG,IAAI;CAKlB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AA4CtE,eAAO,MAAM,MAAM;0BACH,OAAO,EAAE;wBACT,OAAO,EAAE;0BACT,OAAO,EAAE;2BACT,OAAO,EAAE;2BACT,OAAO,EAAE;0BACT,OAAO,EAAE;IAEvB,kEAAkE;2BACpD,OAAO,EAAE;4BAEV,MAAM,KAAG,IAAI;CAUlB,CAAC"}

package/dist/src/utils/logger.js

@@ -1,21 +1,46 @@
 /**
- * logger.ts — 统一日志输出，支持着色与级别过滤
+ * logger.ts — Structured logging with level filtering, timestamps, and JSON output
+ *
+ * Supports:
+ *   WANGCHUAN_LOG_LEVEL env: silent | error | warn | info | debug (default: info)
+ *   WANGCHUAN_LOG_FORMAT env: json — outputs JSON lines for machine parsing
+ *   Timestamp prefix in debug mode: [ISO8601] [LEVEL] message
+ *   trace() method for very verbose output (only emitted in debug level)
  */
 import chalk from 'chalk';
-const LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
-const rawLevel = process.env['WANGCHUAN_LOG_LEVEL'] ?? 'info';
+const LEVELS = { silent: -1, error: 3, warn: 2, info: 1, debug: 0 };
+const rawLevel = (process.env['WANGCHUAN_LOG_LEVEL'] ?? 'info');
 const currentLevel = LEVELS[rawLevel] ?? LEVELS.info;
+const isJsonFormat = process.env['WANGCHUAN_LOG_FORMAT'] === 'json';
+const isDebugLevel = currentLevel === LEVELS.debug;
 const prefix = {
-    info: chalk.cyan('ℹ'),
-    ok: chalk.green('✔'),
-    warn: chalk.yellow('⚠'),
-    error: chalk.red('✖'),
-    debug: chalk.gray('·'),
-    step: chalk.blue('›'),
+    info: chalk.cyan('\u2139'),
+    ok: chalk.green('\u2714'),
+    warn: chalk.yellow('\u26A0'),
+    error: chalk.red('\u2716'),
+    debug: chalk.gray('\u00B7'),
+    step: chalk.blue('\u203A'),
+    trace: chalk.gray('\u2026'),
 };
+/** Emit a JSON line to stdout */
+function emitJson(level, args) {
+    const msg = args.map(a => (typeof a === 'string' ? a : JSON.stringify(a))).join(' ');
+    const line = JSON.stringify({ level, msg, ts: new Date().toISOString() });
+    console.log(line);
+}
 function log(level, symbol, ...args) {
     if (LEVELS[level] < currentLevel)
         return;
+    if (isJsonFormat) {
+        emitJson(level, args);
+        return;
+    }
+    if (isDebugLevel) {
+        const ts = chalk.gray(`[${new Date().toISOString()}]`);
+        const tag = chalk.gray(`[${level.toUpperCase()}]`);
+        console.log(ts, tag, symbol, ...args);
+        return;
+    }
     console.log(symbol, ...args);
 }
 export const logger = {
@@ -25,9 +50,17 @@ export const logger = {
     error: (...a) => log('error', prefix['error'], chalk.red(String(a[0])), ...a.slice(1)),
     debug: (...a) => log('debug', prefix['debug'], chalk.gray(String(a[0])), ...a.slice(1)),
     step: (...a) => log('info', prefix['step'], ...a),
+    /** Very verbose tracing — only emitted when log level is debug */
+    trace: (...a) => log('debug', prefix['trace'], chalk.gray(String(a[0])), ...a.slice(1)),
     banner(text) {
+        if (currentLevel === LEVELS.silent)
+            return;
+        if (isJsonFormat) {
+            emitJson('info', [`\u2554\u2550\u2550 ${text} \u2550\u2550\u2557`]);
+            return;
+        }
         console.log();
-        console.log(chalk.bold.cyan(`  ╔══ ${text} ══╗`));
+        console.log(chalk.bold.cyan(`  \u2554\u2550\u2550 ${text} \u2550\u2550\u2557`));
         console.log();
     },
 };

package/dist/src/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,MAAM,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAElF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,MAAM,CAAC;AAC9D,MAAM,YAAY,GAAW,MAAM,CAAC,QAAoB,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;AAEzE,MAAM,MAAM,GAA2B;IACrC,IAAI,EAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACtB,EAAE,EAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;IACvB,IAAI,EAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACtB,IAAI,EAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;CACvB,CAAC;AAEF,SAAS,GAAG,CAAC,KAAe,EAAE,MAAc,EAAE,GAAG,IAAe;IAC9D,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY;QAAE,OAAO;IACzC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAG,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAG,MAAM,CAAC,MAAM,CAAE,EAAG,GAAG,CAAC,CAAC;IAChE,EAAE,EAAK,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAG,MAAM,CAAC,IAAI,CAAE,EAAK,GAAG,CAAC,CAAC;IAChE,IAAI,EAAG,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAG,MAAM,CAAC,MAAM,CAAE,EAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrG,KAAK,EAAE,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAE,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrG,KAAK,EAAE,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAE,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrG,IAAI,EAAG,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAG,MAAM,CAAC,MAAM,CAAE,EAAG,GAAG,CAAC,CAAC;IAEhE,MAAM,CAAC,IAAY;QACjB,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;CACO,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wangchuan",
-  "version": "2.9.0",
+  "version": "2.11.0",
   "description": "忘川 · AI 记忆同步系统 — 智能体记忆永不遗失",
   "bin": {
     "wangchuan": "./dist/bin/wangchuan.js"