From c716479a4ed490ccd55d107b484dd6ebbeb5d4ea Mon Sep 17 00:00:00 2001
From: ty <786220806@qq.com>
Date: Sun, 22 Mar 2026 14:42:11 +0800
Subject: [PATCH] feat(cli): add output formatting helpers

---
 packages/cli/src/output.ts | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 packages/cli/src/output.ts

diff --git a/packages/cli/src/output.ts b/packages/cli/src/output.ts
new file mode 100644
index 0000000..9cee3da
--- /dev/null
+++ b/packages/cli/src/output.ts
@@ -0,0 +1,27 @@
+/**
+ * Print JSON to stdout (for --json mode).
+ */
+export function printJson(data: unknown): void {
+  console.log(JSON.stringify(data));
+}
+
+/**
+ * Print human-readable text to stdout.
+ */
+export function printText(text: string): void {
+  console.log(text);
+}
+
+/**
+ * Log to stderr (progress, errors — never pollutes stdout).
+ */
+export function log(message: string): void {
+  console.error(message);
+}
+
+/**
+ * Convert epoch ms timestamp to ISO 8601 string.
+ */
+export function msToIso(ms: number): string {
+  return new Date(ms).toISOString();
+}