@nalvietnam/avatar-cli 1.11.1 → 1.12.0

package/dist/lib/print-welcome-screen.js

@@ -66,7 +66,7 @@ ${renderAvatarBanner(opts)}
 
 // src/lib/read-cli-version-from-package-json.ts
 import { readFileSync } from "fs";
-import { dirname, join, resolve } from "path";
+import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
 var cachedVersion = null;
 function readCliVersion() {
@@ -83,18 +83,6 @@ function readCliVersion() {
       }
     } catch {
     }
-    if (i === 0) {
-      const sibling = join(here, "..", "package.json");
-      try {
-        const raw = readFileSync(sibling, "utf8");
-        const pkg = JSON.parse(raw);
-        if (pkg.name === "@nalvietnam/avatar-cli" && typeof pkg.version === "string") {
-          cachedVersion = pkg.version;
-          return cachedVersion;
-        }
-      } catch {
-      }
-    }
   }
   cachedVersion = "unknown";
   return cachedVersion;

package/dist/lib/print-welcome-screen.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/print-welcome-screen.ts","../../src/lib/avatar-ascii-banner.ts","../../src/lib/read-cli-version-from-package-json.ts","../../src/lib/terminal-logger.ts"],"sourcesContent":["// Welcome screen in ra sau `npm install -g` (qua postinstall hook) hoặc khi\n// user gọi `avatar welcome` thủ công. Mục đích: cho user thấy banner + 13\n// commands + next step gợi ý ngay sau khi cài.\nimport boxen from \"boxen\";\nimport { printAvatarBanner } from \"./avatar-ascii-banner.js\";\nimport { readCliVersion } from \"./read-cli-version-from-package-json.js\";\nimport { chalk } from \"./terminal-logger.js\";\n\ninterface CommandSummary {\n  name: string;\n  desc: string;\n}\n\n// Danh sách 13 commands user-facing (mcp-run là hidden, bỏ qua).\nconst COMMANDS: CommandSummary[] = [\n  { name: \"login\", desc: \"Đăng nhập Google SSO (@nal.vn)\" },\n  { name: \"init\", desc: \"Khởi tạo Avatar — 3 flow tự nhận diện\" },\n  { name: \"sync\", desc: \"Pull team-ai-pack mới nhất\" },\n  { name: \"scan\", desc: \"Project scanner + knowledge proposal\" },\n  { name: \"review\", desc: \"Duyệt pending proposals\" },\n  { name: \"status\", desc: \"Snapshot project, pack, pending, backup\" },\n  { name: \"doctor\", desc: \"Chẩn đoán cài đặt Avatar\" },\n  { name: \"restore\", desc: \"Khôi phục .claude/pack/ từ backup\" },\n  { name: \"commit\", desc: \"Commit src/ hoặc Avatar state (client mode)\" },\n  { name: \"tools\", desc: \"Quản lý system tools + MCP servers\" },\n  { name: \"secrets\", desc: \"Quản lý secrets trong OS keychain\" },\n  { name: \"uninstall\", desc: \"Gỡ Avatar khỏi project + backup\" },\n  { name: \"help\", desc: \"Hiển thị help cho từng lệnh\" },\n];\n\nexport function printWelcomeScreen(): void {\n  printAvatarBanner({ tagline: `v${readCliVersion()} · AI harness CLI for NAL Vietnam` });\n\n  // Tính độ rộng max của tên command để align cột.\n  const maxNameWidth = Math.max(...COMMANDS.map((c) => c.name.length));\n\n  const commandLines = COMMANDS.map((c) => {\n    const padded = c.name.padEnd(maxNameWidth);\n    return `  ${chalk.cyan(padded)}   ${chalk.dim(c.desc)}`;\n  }).join(\"\\n\");\n\n  const nextSteps = [\n    \"\",\n    chalk.bold(\"13 lệnh sẵn sàng:\"),\n    \"\",\n    commandLines,\n    \"\",\n    chalk.bold(\"Next steps:\"),\n    \"\",\n    `  ${chalk.green(\"1.\")} ${chalk.cyan(\"avatar login\")}                    Đăng nhập SSO`,\n    `  ${chalk.green(\"2.\")} ${chalk.cyan(\"avatar init\")}                     Khởi tạo dự án`,\n    `  ${chalk.green(\"?.\")} ${chalk.cyan(\"avatar <command> --help\")}         Xem chi tiết lệnh`,\n    \"\",\n    chalk.dim(\"Docs: https://www.npmjs.com/package/@nalvietnam/avatar-cli\"),\n  ].join(\"\\n\");\n\n  process.stdout.write(\n    `${boxen(nextSteps, { padding: 1, borderStyle: \"round\", borderColor: \"magenta\" })}\\n`,\n  );\n}\n\n// Caller (bin/postinstall.js) chịu trách nhiệm gọi printWelcomeScreen() —\n// không auto-execute ở đây để tránh in trùng khi module được import từ postinstall.\n","// Avatar ASCII banner — gradient màu cam → tím để in ở các entry point chính:\n// `avatar --version`, `avatar init`, `avatar login`.\n//\n// Style: ANSI Shadow block characters (Unicode box-drawing).\n// Tự fallback sang plain text khi không phải TTY (CI, pipe ra file).\nimport chalk from \"chalk\";\n\n// 6 dòng chính của logo, mỗi dòng giữ độ rộng đồng nhất 50 ký tự để gradient đẹp.\nconst BANNER_LINES: readonly string[] = [\n  \" █████╗ ██╗   ██╗ █████╗ ████████╗ █████╗ ██████╗ \",\n  \"██╔══██╗██║   ██║██╔══██╗╚══██╔══╝██╔══██╗██╔══██╗\",\n  \"███████║██║   ██║███████║   ██║   ███████║██████╔╝\",\n  \"██╔══██║╚██╗ ██╔╝██╔══██║   ██║   ██╔══██║██╔══██╗\",\n  \"██║  ██║ ╚████╔╝ ██║  ██║   ██║   ██║  ██║██║  ██║\",\n  \"╚═╝  ╚═╝  ╚═══╝  ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝\",\n] as const;\n\n// Gradient stops cam → tím (RGB triples). Mỗi dòng nội suy theo % chiều cao.\nconst GRADIENT_STOPS: ReadonlyArray<readonly [number, number, number]> = [\n  [217, 79, 30], // cam-cháy (#d94f1e)\n  [200, 70, 80], // cam-hồng\n  [170, 70, 140], // hồng-tím\n  [125, 88, 217], // tím (#7d58d9)\n];\n\n// Nội suy tuyến tính 1 kênh màu giữa 2 stop.\nfunction lerpChannel(a: number, b: number, t: number): number {\n  return Math.round(a + (b - a) * t);\n}\n\n// Lấy màu RGB tại vị trí [0,1] trên gradient.\nfunction gradientAt(t: number): readonly [number, number, number] {\n  const clamped = Math.max(0, Math.min(1, t));\n  const scaled = clamped * (GRADIENT_STOPS.length - 1);\n  const lo = Math.floor(scaled);\n  const hi = Math.min(GRADIENT_STOPS.length - 1, lo + 1);\n  const localT = scaled - lo;\n  const a = GRADIENT_STOPS[lo];\n  const b = GRADIENT_STOPS[hi];\n  return [\n    lerpChannel(a[0], b[0], localT),\n    lerpChannel(a[1], b[1], localT),\n    lerpChannel(a[2], b[2], localT),\n  ];\n}\n\n// Build banner string đã tô màu sẵn. Trả empty khi terminal không hỗ trợ màu.\nexport function renderAvatarBanner(opts?: { tagline?: string }): string {\n  const isTty = process.stdout.isTTY ?? false;\n  const supportsColor = isTty && chalk.level > 0;\n\n  // Plain fallback cho CI hoặc pipe.\n  if (!supportsColor) {\n    return [...BANNER_LINES, ...(opts?.tagline ? [\"\", opts.tagline] : [])].join(\"\\n\");\n  }\n\n  const colored = BANNER_LINES.map((line, idx) => {\n    const t = BANNER_LINES.length === 1 ? 0 : idx / (BANNER_LINES.length - 1);\n    const [r, g, b] = gradientAt(t);\n    return chalk.rgb(r, g, b).bold(line);\n  });\n\n  if (opts?.tagline) {\n    colored.push(\"\");\n    colored.push(chalk.dim(opts.tagline));\n  }\n\n  return colored.join(\"\\n\");\n}\n\n// Tiện ích: in banner ra stdout với newline phía trước/sau cho thoáng.\nexport function printAvatarBanner(opts?: { tagline?: string }): void {\n  process.stdout.write(`\\n${renderAvatarBanner(opts)}\\n\\n`);\n}\n","// Single source of truth cho CLI version — đọc runtime từ package.json.\n//\n// Lý do: trước đây version hardcode ở nhiều file (index.ts, status.ts,\n// init-scaffold-variable-builders.ts, print-welcome-screen.ts) → drift bug khi\n// bump version chỉ ở 1 chỗ, các chỗ khác in version cũ.\n//\n// Layout runtime:\n//   bin/avatar.js → dist/index.js (bundled) → package.json ở \"../package.json\"\n//   từ dist/. Dev mode (vitest) → src/lib/*.ts → package.json ở \"../../package.json\".\n// Caller dùng helper này không cần biết path, chỉ gọi readCliVersion().\n\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n// Cache để tránh đọc disk mỗi lần gọi (CLI có thể gọi nhiều lần trong 1 process).\nlet cachedVersion: string | null = null;\n\nexport function readCliVersion(): string {\n  if (cachedVersion !== null) return cachedVersion;\n\n  // Tìm package.json bằng cách đi ngược lên từ vị trí file này.\n  // Production (bundled): dist/index.js → ../package.json\n  // Dev (vitest): src/lib/this-file.ts → ../../package.json\n  // Walk up tối đa 5 level để robust với cả 2 layout.\n  const here = dirname(fileURLToPath(import.meta.url));\n  for (let i = 0; i < 5; i++) {\n    const candidate = resolve(here, ...Array(i).fill(\"..\"), \"package.json\");\n    try {\n      const raw = readFileSync(candidate, \"utf8\");\n      const pkg = JSON.parse(raw) as { name?: string; version?: string };\n      // Verify đúng package (tránh nhặt nhầm package.json của repo cha).\n      if (pkg.name === \"@nalvietnam/avatar-cli\" && typeof pkg.version === \"string\") {\n        cachedVersion = pkg.version;\n        return cachedVersion;\n      }\n    } catch {\n      // File không tồn tại hoặc JSON invalid → thử level tiếp theo.\n    }\n    // Bundled case: package.json ngay cạnh dist/, không cần walk thêm.\n    if (i === 0) {\n      const sibling = join(here, \"..\", \"package.json\");\n      try {\n        const raw = readFileSync(sibling, \"utf8\");\n        const pkg = JSON.parse(raw) as { name?: string; version?: string };\n        if (pkg.name === \"@nalvietnam/avatar-cli\" && typeof pkg.version === \"string\") {\n          cachedVersion = pkg.version;\n          return cachedVersion;\n        }\n      } catch {\n        // Skip — fallback continue.\n      }\n    }\n  }\n\n  // Fallback: nếu không tìm thấy (case edge — symlink lạ, sandbox), trả \"unknown\"\n  // thay vì throw. Status command vẫn hoạt động, chỉ in \"unknown\" thay vì version.\n  cachedVersion = \"unknown\";\n  return cachedVersion;\n}\n","// Terminal logging helpers — chalk for color, ora for spinners.\n// All Avatar CLI output should funnel through here for consistent UX.\nimport chalk from \"chalk\";\nimport ora, { type Ora } from \"ora\";\n\ntype LogFn = (message: string) => void;\n\nexport const log: {\n  info: LogFn;\n  success: LogFn;\n  warn: LogFn;\n  error: LogFn;\n  dim: LogFn;\n  plain: LogFn;\n} = {\n  info: (m) => process.stdout.write(`${chalk.blue(\"ℹ\")} ${m}\\n`),\n  success: (m) => process.stdout.write(`${chalk.green(\"✓\")} ${m}\\n`),\n  warn: (m) => process.stdout.write(`${chalk.yellow(\"⚠\")} ${m}\\n`),\n  error: (m) => process.stderr.write(`${chalk.red(\"✗\")} ${m}\\n`),\n  dim: (m) => process.stdout.write(`${chalk.dim(m)}\\n`),\n  plain: (m) => process.stdout.write(`${m}\\n`),\n};\n\n// Spinner wrapper — handles non-TTY by degrading to plain output.\nexport function spinner(text: string): Ora {\n  return ora({\n    text,\n    spinner: \"dots\",\n    isEnabled: process.stdout.isTTY ?? false,\n  }).start();\n}\n\n// Long-running spinner với elapsed time — update text mỗi giây.\n// Trả về { stop } để caller clear interval + stop spinner đúng cách.\n// Format: \"⠋ <prefix> (1:23)\" — user biết tool alive + chạy bao lâu.\nexport function spinnerWithElapsed(prefix: string): {\n  succeed: (text: string) => void;\n  fail: (text: string) => void;\n  stop: () => void;\n} {\n  const startMs = Date.now();\n  const sp = spinner(`${prefix} (0:00)`);\n  const formatElapsed = (): string => {\n    const sec = Math.floor((Date.now() - startMs) / 1000);\n    const m = Math.floor(sec / 60);\n    const s = sec % 60;\n    return `${m}:${String(s).padStart(2, \"0\")}`;\n  };\n  const interval = setInterval(() => {\n    sp.text = `${prefix} (${formatElapsed()})`;\n  }, 1000);\n  return {\n    succeed: (text: string) => {\n      clearInterval(interval);\n      sp.succeed(`${text} (${formatElapsed()})`);\n    },\n    fail: (text: string) => {\n      clearInterval(interval);\n      sp.fail(`${text} (${formatElapsed()})`);\n    },\n    stop: () => {\n      clearInterval(interval);\n      sp.stop();\n    },\n  };\n}\n\n// Chalk re-export so commands don't all import chalk separately.\nexport { chalk };\n"],"mappings":";;;AAGA,OAAO,WAAW;;;ACElB,OAAO,WAAW;AAGlB,IAAM,eAAkC;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,IAAM,iBAAmE;AAAA,EACvE,CAAC,KAAK,IAAI,EAAE;AAAA;AAAA,EACZ,CAAC,KAAK,IAAI,EAAE;AAAA;AAAA,EACZ,CAAC,KAAK,IAAI,GAAG;AAAA;AAAA,EACb,CAAC,KAAK,IAAI,GAAG;AAAA;AACf;AAGA,SAAS,YAAY,GAAW,GAAW,GAAmB;AAC5D,SAAO,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC;AACnC;AAGA,SAAS,WAAW,GAA8C;AAChE,QAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC;AAC1C,QAAM,SAAS,WAAW,eAAe,SAAS;AAClD,QAAM,KAAK,KAAK,MAAM,MAAM;AAC5B,QAAM,KAAK,KAAK,IAAI,eAAe,SAAS,GAAG,KAAK,CAAC;AACrD,QAAM,SAAS,SAAS;AACxB,QAAM,IAAI,eAAe,EAAE;AAC3B,QAAM,IAAI,eAAe,EAAE;AAC3B,SAAO;AAAA,IACL,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM;AAAA,IAC9B,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM;AAAA,IAC9B,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM;AAAA,EAChC;AACF;AAGO,SAAS,mBAAmB,MAAqC;AACtE,QAAM,QAAQ,QAAQ,OAAO,SAAS;AACtC,QAAM,gBAAgB,SAAS,MAAM,QAAQ;AAG7C,MAAI,CAAC,eAAe;AAClB,WAAO,CAAC,GAAG,cAAc,GAAI,MAAM,UAAU,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAE,EAAE,KAAK,IAAI;AAAA,EAClF;AAEA,QAAM,UAAU,aAAa,IAAI,CAAC,MAAM,QAAQ;AAC9C,UAAM,IAAI,aAAa,WAAW,IAAI,IAAI,OAAO,aAAa,SAAS;AACvE,UAAM,CAAC,GAAG,GAAG,CAAC,IAAI,WAAW,CAAC;AAC9B,WAAO,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,KAAK,IAAI;AAAA,EACrC,CAAC;AAED,MAAI,MAAM,SAAS;AACjB,YAAQ,KAAK,EAAE;AACf,YAAQ,KAAK,MAAM,IAAI,KAAK,OAAO,CAAC;AAAA,EACtC;AAEA,SAAO,QAAQ,KAAK,IAAI;AAC1B;AAGO,SAAS,kBAAkB,MAAmC;AACnE,UAAQ,OAAO,MAAM;AAAA,EAAK,mBAAmB,IAAI,CAAC;AAAA;AAAA,CAAM;AAC1D;;;AC9DA,SAAS,oBAAoB;AAC7B,SAAS,SAAS,MAAM,eAAe;AACvC,SAAS,qBAAqB;AAG9B,IAAI,gBAA+B;AAE5B,SAAS,iBAAyB;AACvC,MAAI,kBAAkB,KAAM,QAAO;AAMnC,QAAM,OAAO,QAAQ,cAAc,YAAY,GAAG,CAAC;AACnD,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,YAAY,QAAQ,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,GAAG,cAAc;AACtE,QAAI;AACF,YAAM,MAAM,aAAa,WAAW,MAAM;AAC1C,YAAM,MAAM,KAAK,MAAM,GAAG;AAE1B,UAAI,IAAI,SAAS,4BAA4B,OAAO,IAAI,YAAY,UAAU;AAC5E,wBAAgB,IAAI;AACpB,eAAO;AAAA,MACT;AAAA,IACF,QAAQ;AAAA,IAER;AAEA,QAAI,MAAM,GAAG;AACX,YAAM,UAAU,KAAK,MAAM,MAAM,cAAc;AAC/C,UAAI;AACF,cAAM,MAAM,aAAa,SAAS,MAAM;AACxC,cAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,YAAI,IAAI,SAAS,4BAA4B,OAAO,IAAI,YAAY,UAAU;AAC5E,0BAAgB,IAAI;AACpB,iBAAO;AAAA,QACT;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAIA,kBAAgB;AAChB,SAAO;AACT;;;ACzDA,OAAOA,YAAW;AAClB,OAAO,SAAuB;;;AHW9B,IAAM,WAA6B;AAAA,EACjC,EAAE,MAAM,SAAS,MAAM,gDAAiC;AAAA,EACxD,EAAE,MAAM,QAAQ,MAAM,sEAAwC;AAAA,EAC9D,EAAE,MAAM,QAAQ,MAAM,uCAA6B;AAAA,EACnD,EAAE,MAAM,QAAQ,MAAM,uCAAuC;AAAA,EAC7D,EAAE,MAAM,UAAU,MAAM,+BAA0B;AAAA,EAClD,EAAE,MAAM,UAAU,MAAM,0CAA0C;AAAA,EAClE,EAAE,MAAM,UAAU,MAAM,qDAA2B;AAAA,EACnD,EAAE,MAAM,WAAW,MAAM,iDAAoC;AAAA,EAC7D,EAAE,MAAM,UAAU,MAAM,mDAA8C;AAAA,EACtE,EAAE,MAAM,SAAS,MAAM,6CAAqC;AAAA,EAC5D,EAAE,MAAM,WAAW,MAAM,4CAAoC;AAAA,EAC7D,EAAE,MAAM,aAAa,MAAM,4CAAkC;AAAA,EAC7D,EAAE,MAAM,QAAQ,MAAM,kDAA8B;AACtD;AAEO,SAAS,qBAA2B;AACzC,oBAAkB,EAAE,SAAS,IAAI,eAAe,CAAC,uCAAoC,CAAC;AAGtF,QAAM,eAAe,KAAK,IAAI,GAAG,SAAS,IAAI,CAAC,MAAM,EAAE,KAAK,MAAM,CAAC;AAEnE,QAAM,eAAe,SAAS,IAAI,CAAC,MAAM;AACvC,UAAM,SAAS,EAAE,KAAK,OAAO,YAAY;AACzC,WAAO,KAAKC,OAAM,KAAK,MAAM,CAAC,MAAMA,OAAM,IAAI,EAAE,IAAI,CAAC;AAAA,EACvD,CAAC,EAAE,KAAK,IAAI;AAEZ,QAAM,YAAY;AAAA,IAChB;AAAA,IACAA,OAAM,KAAK,gCAAmB;AAAA,IAC9B;AAAA,IACA;AAAA,IACA;AAAA,IACAA,OAAM,KAAK,aAAa;AAAA,IACxB;AAAA,IACA,KAAKA,OAAM,MAAM,IAAI,CAAC,IAAIA,OAAM,KAAK,cAAc,CAAC;AAAA,IACpD,KAAKA,OAAM,MAAM,IAAI,CAAC,IAAIA,OAAM,KAAK,aAAa,CAAC;AAAA,IACnD,KAAKA,OAAM,MAAM,IAAI,CAAC,IAAIA,OAAM,KAAK,yBAAyB,CAAC;AAAA,IAC/D;AAAA,IACAA,OAAM,IAAI,4DAA4D;AAAA,EACxE,EAAE,KAAK,IAAI;AAEX,UAAQ,OAAO;AAAA,IACb,GAAG,MAAM,WAAW,EAAE,SAAS,GAAG,aAAa,SAAS,aAAa,UAAU,CAAC,CAAC;AAAA;AAAA,EACnF;AACF;","names":["chalk","chalk"]}
+{"version":3,"sources":["../../src/lib/print-welcome-screen.ts","../../src/lib/avatar-ascii-banner.ts","../../src/lib/read-cli-version-from-package-json.ts","../../src/lib/terminal-logger.ts"],"sourcesContent":["// Welcome screen in ra sau `npm install -g` (qua postinstall hook) hoặc khi\n// user gọi `avatar welcome` thủ công. Mục đích: cho user thấy banner + 13\n// commands + next step gợi ý ngay sau khi cài.\nimport boxen from \"boxen\";\nimport { printAvatarBanner } from \"./avatar-ascii-banner.js\";\nimport { readCliVersion } from \"./read-cli-version-from-package-json.js\";\nimport { chalk } from \"./terminal-logger.js\";\n\ninterface CommandSummary {\n  name: string;\n  desc: string;\n}\n\n// Danh sách 13 commands user-facing (mcp-run là hidden, bỏ qua).\nconst COMMANDS: CommandSummary[] = [\n  { name: \"login\", desc: \"Đăng nhập Google SSO (@nal.vn)\" },\n  { name: \"init\", desc: \"Khởi tạo Avatar — 3 flow tự nhận diện\" },\n  { name: \"sync\", desc: \"Pull team-ai-pack mới nhất\" },\n  { name: \"scan\", desc: \"Project scanner + knowledge proposal\" },\n  { name: \"review\", desc: \"Duyệt pending proposals\" },\n  { name: \"status\", desc: \"Snapshot project, pack, pending, backup\" },\n  { name: \"doctor\", desc: \"Chẩn đoán cài đặt Avatar\" },\n  { name: \"restore\", desc: \"Khôi phục .claude/pack/ từ backup\" },\n  { name: \"commit\", desc: \"Commit src/ hoặc Avatar state (client mode)\" },\n  { name: \"tools\", desc: \"Quản lý system tools + MCP servers\" },\n  { name: \"secrets\", desc: \"Quản lý secrets trong OS keychain\" },\n  { name: \"uninstall\", desc: \"Gỡ Avatar khỏi project + backup\" },\n  { name: \"help\", desc: \"Hiển thị help cho từng lệnh\" },\n];\n\nexport function printWelcomeScreen(): void {\n  printAvatarBanner({ tagline: `v${readCliVersion()} · AI harness CLI for NAL Vietnam` });\n\n  // Tính độ rộng max của tên command để align cột.\n  const maxNameWidth = Math.max(...COMMANDS.map((c) => c.name.length));\n\n  const commandLines = COMMANDS.map((c) => {\n    const padded = c.name.padEnd(maxNameWidth);\n    return `  ${chalk.cyan(padded)}   ${chalk.dim(c.desc)}`;\n  }).join(\"\\n\");\n\n  const nextSteps = [\n    \"\",\n    chalk.bold(\"13 lệnh sẵn sàng:\"),\n    \"\",\n    commandLines,\n    \"\",\n    chalk.bold(\"Next steps:\"),\n    \"\",\n    `  ${chalk.green(\"1.\")} ${chalk.cyan(\"avatar login\")}                    Đăng nhập SSO`,\n    `  ${chalk.green(\"2.\")} ${chalk.cyan(\"avatar init\")}                     Khởi tạo dự án`,\n    `  ${chalk.green(\"?.\")} ${chalk.cyan(\"avatar <command> --help\")}         Xem chi tiết lệnh`,\n    \"\",\n    chalk.dim(\"Docs: https://www.npmjs.com/package/@nalvietnam/avatar-cli\"),\n  ].join(\"\\n\");\n\n  process.stdout.write(\n    `${boxen(nextSteps, { padding: 1, borderStyle: \"round\", borderColor: \"magenta\" })}\\n`,\n  );\n}\n\n// Caller (bin/postinstall.js) chịu trách nhiệm gọi printWelcomeScreen() —\n// không auto-execute ở đây để tránh in trùng khi module được import từ postinstall.\n","// Avatar ASCII banner — gradient màu cam → tím để in ở các entry point chính:\n// `avatar --version`, `avatar init`, `avatar login`.\n//\n// Style: ANSI Shadow block characters (Unicode box-drawing).\n// Tự fallback sang plain text khi không phải TTY (CI, pipe ra file).\nimport chalk from \"chalk\";\n\n// 6 dòng chính của logo, mỗi dòng giữ độ rộng đồng nhất 50 ký tự để gradient đẹp.\nconst BANNER_LINES: readonly string[] = [\n  \" █████╗ ██╗   ██╗ █████╗ ████████╗ █████╗ ██████╗ \",\n  \"██╔══██╗██║   ██║██╔══██╗╚══██╔══╝██╔══██╗██╔══██╗\",\n  \"███████║██║   ██║███████║   ██║   ███████║██████╔╝\",\n  \"██╔══██║╚██╗ ██╔╝██╔══██║   ██║   ██╔══██║██╔══██╗\",\n  \"██║  ██║ ╚████╔╝ ██║  ██║   ██║   ██║  ██║██║  ██║\",\n  \"╚═╝  ╚═╝  ╚═══╝  ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝\",\n] as const;\n\n// Gradient stops cam → tím (RGB triples). Mỗi dòng nội suy theo % chiều cao.\nconst GRADIENT_STOPS: ReadonlyArray<readonly [number, number, number]> = [\n  [217, 79, 30], // cam-cháy (#d94f1e)\n  [200, 70, 80], // cam-hồng\n  [170, 70, 140], // hồng-tím\n  [125, 88, 217], // tím (#7d58d9)\n];\n\n// Nội suy tuyến tính 1 kênh màu giữa 2 stop.\nfunction lerpChannel(a: number, b: number, t: number): number {\n  return Math.round(a + (b - a) * t);\n}\n\n// Lấy màu RGB tại vị trí [0,1] trên gradient.\nfunction gradientAt(t: number): readonly [number, number, number] {\n  const clamped = Math.max(0, Math.min(1, t));\n  const scaled = clamped * (GRADIENT_STOPS.length - 1);\n  const lo = Math.floor(scaled);\n  const hi = Math.min(GRADIENT_STOPS.length - 1, lo + 1);\n  const localT = scaled - lo;\n  // Non-null safe: lo ∈ [0, len-1] qua Math.floor + clamp, hi ∈ [0, len-1] qua Math.min.\n  // TS strict mode không narrow tuple index → assert.\n  const a = GRADIENT_STOPS[lo]!;\n  const b = GRADIENT_STOPS[hi]!;\n  return [\n    lerpChannel(a[0], b[0], localT),\n    lerpChannel(a[1], b[1], localT),\n    lerpChannel(a[2], b[2], localT),\n  ];\n}\n\n// Build banner string đã tô màu sẵn. Trả empty khi terminal không hỗ trợ màu.\nexport function renderAvatarBanner(opts?: { tagline?: string }): string {\n  const isTty = process.stdout.isTTY ?? false;\n  const supportsColor = isTty && chalk.level > 0;\n\n  // Plain fallback cho CI hoặc pipe.\n  if (!supportsColor) {\n    return [...BANNER_LINES, ...(opts?.tagline ? [\"\", opts.tagline] : [])].join(\"\\n\");\n  }\n\n  const colored = BANNER_LINES.map((line, idx) => {\n    const t = BANNER_LINES.length === 1 ? 0 : idx / (BANNER_LINES.length - 1);\n    const [r, g, b] = gradientAt(t);\n    return chalk.rgb(r, g, b).bold(line);\n  });\n\n  if (opts?.tagline) {\n    colored.push(\"\");\n    colored.push(chalk.dim(opts.tagline));\n  }\n\n  return colored.join(\"\\n\");\n}\n\n// Tiện ích: in banner ra stdout với newline phía trước/sau cho thoáng.\nexport function printAvatarBanner(opts?: { tagline?: string }): void {\n  process.stdout.write(`\\n${renderAvatarBanner(opts)}\\n\\n`);\n}\n","// Single source of truth cho CLI version — đọc runtime từ package.json.\n//\n// Lý do: trước đây version hardcode ở nhiều file (index.ts, status.ts,\n// init-scaffold-variable-builders.ts, print-welcome-screen.ts) → drift bug khi\n// bump version chỉ ở 1 chỗ, các chỗ khác in version cũ.\n//\n// Layout runtime:\n//   bin/avatar.js → dist/index.js (bundled) → package.json ở \"../package.json\"\n//   từ dist/. Dev mode (vitest) → src/lib/*.ts → package.json ở \"../../package.json\".\n// Caller dùng helper này không cần biết path, chỉ gọi readCliVersion().\n\nimport { readFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n// Cache để tránh đọc disk mỗi lần gọi (CLI có thể gọi nhiều lần trong 1 process).\nlet cachedVersion: string | null = null;\n\nexport function readCliVersion(): string {\n  if (cachedVersion !== null) return cachedVersion;\n\n  // Tìm package.json bằng cách đi ngược lên từ vị trí file này.\n  // Production (bundled): dist/index.js → ../package.json\n  // Dev (vitest): src/lib/this-file.ts → ../../package.json\n  // Walk up tối đa 5 level để robust với cả 2 layout:\n  //   - Bundled (production): dist/index.js → ../package.json (i=1)\n  //   - Dev (vitest/tsx): src/lib/*.ts → ../../package.json (i=2)\n  // i=0 (cùng dir) cover trường hợp file move ngang sang root tương lai.\n  const here = dirname(fileURLToPath(import.meta.url));\n  for (let i = 0; i < 5; i++) {\n    const candidate = resolve(here, ...Array(i).fill(\"..\"), \"package.json\");\n    try {\n      const raw = readFileSync(candidate, \"utf8\");\n      const pkg = JSON.parse(raw) as { name?: string; version?: string };\n      // Verify đúng package (tránh nhặt nhầm package.json của repo cha).\n      if (pkg.name === \"@nalvietnam/avatar-cli\" && typeof pkg.version === \"string\") {\n        cachedVersion = pkg.version;\n        return cachedVersion;\n      }\n    } catch {\n      // File không tồn tại hoặc JSON invalid → thử level tiếp theo.\n    }\n  }\n\n  // Fallback: nếu không tìm thấy (case edge — symlink lạ, sandbox), trả \"unknown\"\n  // thay vì throw. Status command vẫn hoạt động, chỉ in \"unknown\" thay vì version.\n  cachedVersion = \"unknown\";\n  return cachedVersion;\n}\n","// Terminal logging helpers — chalk for color, ora for spinners.\n// All Avatar CLI output should funnel through here for consistent UX.\nimport chalk from \"chalk\";\nimport ora, { type Ora } from \"ora\";\n\ntype LogFn = (message: string) => void;\n\nexport const log: {\n  info: LogFn;\n  success: LogFn;\n  warn: LogFn;\n  error: LogFn;\n  dim: LogFn;\n  plain: LogFn;\n} = {\n  info: (m) => process.stdout.write(`${chalk.blue(\"ℹ\")} ${m}\\n`),\n  success: (m) => process.stdout.write(`${chalk.green(\"✓\")} ${m}\\n`),\n  warn: (m) => process.stdout.write(`${chalk.yellow(\"⚠\")} ${m}\\n`),\n  error: (m) => process.stderr.write(`${chalk.red(\"✗\")} ${m}\\n`),\n  dim: (m) => process.stdout.write(`${chalk.dim(m)}\\n`),\n  plain: (m) => process.stdout.write(`${m}\\n`),\n};\n\n// Spinner wrapper — handles non-TTY by degrading to plain output.\nexport function spinner(text: string): Ora {\n  return ora({\n    text,\n    spinner: \"dots\",\n    isEnabled: process.stdout.isTTY ?? false,\n  }).start();\n}\n\n// Long-running spinner với elapsed time — update text mỗi giây.\n// Trả về { stop } để caller clear interval + stop spinner đúng cách.\n// Format: \"⠋ <prefix> (1:23)\" — user biết tool alive + chạy bao lâu.\nexport function spinnerWithElapsed(prefix: string): {\n  succeed: (text: string) => void;\n  fail: (text: string) => void;\n  stop: () => void;\n} {\n  const startMs = Date.now();\n  const sp = spinner(`${prefix} (0:00)`);\n  const formatElapsed = (): string => {\n    const sec = Math.floor((Date.now() - startMs) / 1000);\n    const m = Math.floor(sec / 60);\n    const s = sec % 60;\n    return `${m}:${String(s).padStart(2, \"0\")}`;\n  };\n  const interval = setInterval(() => {\n    sp.text = `${prefix} (${formatElapsed()})`;\n  }, 1000);\n  return {\n    succeed: (text: string) => {\n      clearInterval(interval);\n      sp.succeed(`${text} (${formatElapsed()})`);\n    },\n    fail: (text: string) => {\n      clearInterval(interval);\n      sp.fail(`${text} (${formatElapsed()})`);\n    },\n    stop: () => {\n      clearInterval(interval);\n      sp.stop();\n    },\n  };\n}\n\n// Chalk re-export so commands don't all import chalk separately.\nexport { chalk };\n"],"mappings":"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","names":["chalk","chalk"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nalvietnam/avatar-cli",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "AI harness CLI for NAL Vietnam engineering",
   "type": "module",
   "bin": {
@@ -26,7 +26,7 @@
     "lint": "biome check src test",
     "format": "biome format --write src test",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build && npm run test:all",
+    "prepublishOnly": "npm run typecheck && npm run build && npm run test:all",
     "postinstall": "node ./bin/postinstall.js"
   },
   "dependencies": {