@yeseh/cortex-cli 0.6.3 → 0.6.4

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@yeseh/cortex-cli",
-    "version": "0.6.3",
+    "version": "0.6.4",
     "license": "MIT",
     "type": "module",
     "repository": {

package/src/observability.spec.ts

@@ -27,22 +27,17 @@ describe('createCliLogger', () => {
     });
 
     describe('info()', () => {
-        it('should write info log to stderr as JSON', () => {
+        it('should write human-friendly info log to stderr', () => {
             const logger = createCliLogger();
             logger.info('hello world');
             expect(stderrLines.length).toBe(1);
-            const parsed = JSON.parse(stderrLines[0]!);
-            expect(parsed.level).toBe('info');
-            expect(parsed.msg).toBe('hello world');
-            expect(parsed.ts).toBeDefined();
+            expect(stderrLines[0]).toBe('INFO: hello world\n');
         });
 
         it('should include metadata in the log line', () => {
             const logger = createCliLogger();
             logger.info('test', { store: 'default', count: 5 });
-            const parsed = JSON.parse(stderrLines[0]!);
-            expect(parsed.store).toBe('default');
-            expect(parsed.count).toBe(5);
+            expect(stderrLines[0]).toBe('INFO: test store=default count=5\n');
         });
     });
 
@@ -51,9 +46,7 @@ describe('createCliLogger', () => {
             const logger = createCliLogger();
             logger.warn('warning message');
             expect(stderrLines.length).toBe(1);
-            const parsed = JSON.parse(stderrLines[0]!);
-            expect(parsed.level).toBe('warn');
-            expect(parsed.msg).toBe('warning message');
+            expect(stderrLines[0]).toBe('WARN: warning message\n');
         });
     });
 
@@ -62,25 +55,20 @@ describe('createCliLogger', () => {
             const logger = createCliLogger();
             logger.error('something failed', new Error('boom'));
             expect(stderrLines.length).toBe(1);
-            const parsed = JSON.parse(stderrLines[0]!);
-            expect(parsed.level).toBe('error');
-            expect(parsed.msg).toBe('something failed');
-            expect(parsed.error).toBe('boom');
+            expect(stderrLines[0]).toBe('ERROR: something failed error=boom\n');
         });
 
         it('should handle string error argument', () => {
             const logger = createCliLogger();
             logger.error('failed', 'string error');
-            const parsed = JSON.parse(stderrLines[0]!);
-            expect(parsed.error).toBe('string error');
+            expect(stderrLines[0]).toBe('ERROR: failed error="string error"\n');
         });
 
         it('should handle missing error argument', () => {
             const logger = createCliLogger();
             logger.error('failed');
             expect(stderrLines.length).toBe(1);
-            const parsed = JSON.parse(stderrLines[0]!);
-            expect(parsed.error).toBeUndefined();
+            expect(stderrLines[0]).toBe('ERROR: failed\n');
         });
     });
 
@@ -97,8 +85,7 @@ describe('createCliLogger', () => {
             const logger = createCliLogger();
             logger.debug('debug message');
             expect(stderrLines.length).toBe(1);
-            const parsed = JSON.parse(stderrLines[0]!);
-            expect(parsed.level).toBe('debug');
+            expect(stderrLines[0]).toBe('DEBUG: debug message\n');
         });
 
         it('should write debug output when DEBUG includes cortex alongside other values', () => {

package/src/observability.ts

@@ -1,5 +1,5 @@
 /**
- * CLI observability — plain ConsoleLogger writing structured JSON to stderr.
+ * CLI observability — plain ConsoleLogger writing human-readable lines to stderr.
  *
  * No OTel SDK dependency — keeps the CLI binary small.
  * Debug output is gated by the `DEBUG=cortex` environment variable.
@@ -11,7 +11,7 @@ import type { Logger } from '@yeseh/cortex-core';
 /**
  * Creates a plain console logger for CLI usage.
  *
- * Writes structured JSON log lines to stderr (not stdout) to avoid
+ * Writes human-readable log lines to stderr (not stdout) to avoid
  * polluting piped command output. Debug output is gated by the
  * `DEBUG=cortex` environment variable.
  *
@@ -21,7 +21,7 @@ import type { Logger } from '@yeseh/cortex-core';
  * ```typescript
  * const logger = createCliLogger();
  * logger.info('Starting command', { store: 'global' });
- * // → {"ts":"2024-01-01T00:00:00.000Z","level":"info","msg":"Starting command","store":"global"}
+ * // → INFO: Starting command store=global
  * ```
  *
  * @example
@@ -34,10 +34,27 @@ export const createCliLogger = (): Logger => {
     const debugEnabled =
         typeof process.env.DEBUG === 'string' && process.env.DEBUG.includes('cortex');
 
+    const stringifyMetaValue = (value: unknown): string => {
+        if (typeof value === 'string') {
+            return value.includes(' ') ? JSON.stringify(value) : value;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean' || value === null) {
+            return String(value);
+        }
+        return JSON.stringify(value);
+    };
+
+    const formatMeta = (meta?: Record<string, unknown>): string => {
+        if (!meta || Object.keys(meta).length === 0) return '';
+        return Object.entries(meta)
+            .map(([key, value]) => `${key}=${stringifyMetaValue(value)}`)
+            .join(' ');
+    };
+
     const write = (level: string, msg: string, meta?: Record<string, unknown>): void => {
-        process.stderr.write(
-            JSON.stringify({ ts: new Date().toISOString(), level, msg, ...meta }) + '\n'
-        );
+        const line = `${level.toUpperCase()}: ${msg}`;
+        const metaText = formatMeta(meta);
+        process.stderr.write(metaText.length > 0 ? `${line} ${metaText}\n` : `${line}\n`);
     };
 
     return {
@@ -53,7 +70,9 @@ export const createCliLogger = (): Logger => {
         error(msg: string, err?: Error | unknown, meta?: Record<string, unknown>): void {
             const errMeta =
                 err instanceof Error
-                    ? { error: err.message, stack: err.stack }
+                    ? debugEnabled
+                        ? { error: err.message, stack: err.stack }
+                        : { error: err.message }
                     : err !== null && err !== undefined
                       ? { error: String(err) }
                       : {};

package/src/program.ts

@@ -65,7 +65,7 @@ export const runProgram = async (): Promise<void> => {
         // This catch handles any unexpected errors that slip through.
         const logger = createCliLogger();
         if (error instanceof Error) {
-            logger.error(`Error: ${error.message}`, error);
+            logger.error(error.message);
         }
         else {
             logger.error('An unexpected error occurred');