@nalvietnam/avatar-cli 1.8.0 → 1.10.0

package/dist/index.js

@@ -2313,7 +2313,7 @@ function registerGitnexusCommand(program2) {
 // src/commands/init.ts
 import { basename, join as join24, relative as relative3, resolve } from "path";
 import { confirm as confirm5, input as input5, select as select9 } from "@inquirer/prompts";
-import boxen5 from "boxen";
+import boxen6 from "boxen";
 
 // src/lib/add-team-pack-submodule-with-retry-on-network-fail.ts
 import { spawnSync as spawnSync13 } from "child_process";
@@ -2482,7 +2482,8 @@ var TeamPackAccessAbortedError = class extends Error {
     this.name = "TeamPackAccessAbortedError";
   }
 };
-async function addTeamPackSubmodule(projectRoot, tag, ssoEmail) {
+var DEFAULT_PACK_BRANCH = "main";
+async function addTeamPackSubmodule(projectRoot, tag, ssoEmail, latest = false) {
   const url = resolveTeamPackRepoUrl();
   const repoSlug = parseRepoSlugFromGitUrl(url);
   if (repoSlug) {
@@ -2508,12 +2509,17 @@ async function addTeamPackSubmodule(projectRoot, tag, ssoEmail) {
     }
     throw err;
   }
-  let target = tag ?? null;
-  if (!target) {
-    const submoduleDir = join16(projectRoot, TEAM_PACK_RELATIVE_PATH);
-    const allTags = await listTags(submoduleDir);
-    target = pickLatestStableSemVerTag(allTags);
+  if (tag) {
+    await checkoutTagInSubmodule(TEAM_PACK_RELATIVE_PATH, tag, projectRoot);
+    return { pinnedTag: tag };
   }
+  if (latest) {
+    await checkoutBranchHeadInSubmodule(TEAM_PACK_RELATIVE_PATH, DEFAULT_PACK_BRANCH, projectRoot);
+    return { pinnedTag: `${DEFAULT_PACK_BRANCH} (HEAD)` };
+  }
+  const submoduleDir = join16(projectRoot, TEAM_PACK_RELATIVE_PATH);
+  const allTags = await listTags(submoduleDir);
+  const target = pickLatestStableSemVerTag(allTags);
   if (target) {
     await checkoutTagInSubmodule(TEAM_PACK_RELATIVE_PATH, target, projectRoot);
   }
@@ -2573,10 +2579,10 @@ async function handleSshPermissionError() {
     ]
   });
 }
-async function addTeamPackSubmoduleWithRetryOnNetworkFail(projectRoot, tag, ssoEmail) {
+async function addTeamPackSubmoduleWithRetryOnNetworkFail(projectRoot, tag, ssoEmail, latest = false) {
   while (true) {
     try {
-      const result = await addTeamPackSubmodule(projectRoot, tag, ssoEmail);
+      const result = await addTeamPackSubmodule(projectRoot, tag, ssoEmail, latest);
       return { pinnedTag: result.pinnedTag, skipped: false };
     } catch (err) {
       if (err instanceof TeamPackAccessAbortedError) throw err;
@@ -3201,6 +3207,42 @@ function linkExistingRemoteToWorkspace(args) {
   return { sshUrl, httpsUrl };
 }
 
+// src/lib/format-pack-commands-cheatsheet-box.ts
+import boxen4 from "boxen";
+var PACK_COMMAND_CHEATSHEET = [
+  { cmd: "/avatar:help", desc: "H\u01B0\u1EDBng d\u1EABn s\u1EED d\u1EE5ng Avatar \u2014 ch\u1EC9 c\u1EA7n g\xF5 t\u1EF1 nhi\xEAn" },
+  { cmd: "/avatar:brainstorm", desc: "Brainstorm \xFD t\u01B0\u1EDFng cho m\u1ED9t feature" },
+  { cmd: "/avatar:plan", desc: "T\u1EA1o plan th\xF4ng minh v\u1EDBi prompt enhancement" },
+  { cmd: "/avatar:scout", desc: "T\xECm file li\xEAn quan trong codebase, ti\u1EBFt ki\u1EC7m token" },
+  { cmd: "/avatar:implement", desc: "B\u1EAFt \u0111\u1EA7u code & test theo plan c\xF3 s\u1EB5n" },
+  { cmd: "/avatar:build-full-flow", desc: "Implement m\u1ED9t feature t\u1EEBng b\u01B0\u1EDBc (end-to-end)" },
+  { cmd: "/avatar:fix", desc: "Ph\xE2n t\xEDch v\xE0 fix v\u1EA5n \u0111\u1EC1 t\u1EF1 \u0111i\u1EC1u h\u01B0\u1EDBng" },
+  { cmd: "/avatar:debug", desc: "Debug v\u1EA5n \u0111\u1EC1 k\u1EF9 thu\u1EADt + \u0111\u01B0a ra gi\u1EA3i ph\xE1p" },
+  { cmd: "/avatar:test", desc: "Ch\u1EA1y test tr\xEAn m\xE1y + ph\xE2n t\xEDch b\xE1o c\xE1o t\u1ED5ng h\u1EE3p" },
+  { cmd: "/avatar:design:good", desc: "T\u1EA1o thi\u1EBFt k\u1EBF ch\u1EC9n chu, s\u1ED1ng \u0111\u1ED9ng" },
+  { cmd: "/avatar:docs:init", desc: "Ph\xE2n t\xEDch codebase + t\u1EA1o t\xE0i li\u1EC7u kh\u1EDFi \u0111\u1EA7u" },
+  { cmd: "/avatar:status", desc: "Xem l\u1EA1i thay \u0111\u1ED5i g\u1EA7n \u0111\xE2y + t\u1ED5ng k\u1EBFt c\xF4ng vi\u1EC7c" },
+  { cmd: "/avatar:journal", desc: "Ghi nh\u1EADt k\xFD session" }
+];
+function formatPackCommandsCheatsheetBox() {
+  const maxCmdWidth = Math.max(...PACK_COMMAND_CHEATSHEET.map((e) => e.cmd.length));
+  const header = chalk.bold("\u{1F3AF} Slash commands t\u1EEB team-ai-pack");
+  const subheader = chalk.dim("G\xF5 trong Claude Code session \u0111\u1EC3 g\u1ECDi capability c\u1EE7a pack:");
+  const lines = PACK_COMMAND_CHEATSHEET.map((e) => {
+    const cmdPadded = chalk.cyan(e.cmd.padEnd(maxCmdWidth));
+    return `  ${cmdPadded}  ${chalk.dim(e.desc)}`;
+  });
+  const footer = chalk.dim(
+    "Catalog \u0111\u1EA7y \u0111\u1EE7 46 commands: cat .claude/pack/scripts/commands_data.yaml"
+  );
+  const content = [header, subheader, "", ...lines, "", footer].join("\n");
+  return boxen4(content, {
+    padding: 1,
+    borderStyle: "round",
+    borderColor: "cyan"
+  });
+}
+
 // src/lib/merge-pack-settings-into-project-settings.ts
 import { promises as fs9 } from "fs";
 import { join as join17 } from "path";
@@ -3761,7 +3803,7 @@ function buildScaffoldVariables(args) {
 }
 
 // src/commands/login.ts
-import boxen4 from "boxen";
+import boxen5 from "boxen";
 import open from "open";
 
 // src/lib/google-oauth-device-flow.ts
@@ -3908,7 +3950,7 @@ async function runLogin(opts) {
     "",
     `Ho\u1EB7c Avatar t\u1EF1 m\u1EDF browser, click ${chalk.green("Allow")}...`
   ].join("\n");
-  process.stdout.write(`${boxen4(instructions, { padding: 1, borderStyle: "round" })}
+  process.stdout.write(`${boxen5(instructions, { padding: 1, borderStyle: "round" })}
 `);
   void open(verificationUrl).catch(() => {
     log.dim("(Kh\xF4ng m\u1EDF \u0111\u01B0\u1EE3c browser t\u1EF1 \u0111\u1ED9ng \u2014 copy URL \u1EDF tr\xEAn)");
@@ -3963,7 +4005,7 @@ function parseBootstrapStrategyOpts(opts) {
   );
 }
 function registerInitCommand(program2) {
-  program2.command("init").description("Kh\u1EDFi t\u1EA1o Avatar \u2014 3 flow t\u1EF1 nh\u1EADn di\u1EC7n (repo / folder / new)").option("--project-status <val>", "existing-remote | existing-folder | new-project").option("--folder-path <path>", "\u0110\u01B0\u1EDDng d\u1EABn folder hi\u1EC7n c\xF3 (flow existing-folder)").option("--create-remote", "Force t\u1EA1o remote qua gh (flow existing-folder ho\u1EB7c new-project)").option("--repo-visibility <val>", "private (m\u1EB7c \u0111\u1ECBnh) | public").option("--repo-org <name>", "GitHub org/owner cho repo m\u1EDBi").option("--client-repo <url>", "URL git remote (flow existing-remote)").option("--workspace-name <name>", "T\xEAn workspace").option("--workspace-parent <path>", "Th\u01B0 m\u1EE5c cha t\u1EA1o workspace (m\u1EB7c \u0111\u1ECBnh . \u2014 CWD)").option("--pack-version <tag>", "Pin team-ai-pack v\xE0o tag c\u1EE5 th\u1EC3").option("--team-owner <email>", "Email team owner (b\u1ECF qua prompt)").option("--description <text>", "M\xF4 t\u1EA3 1 d\xF2ng c\u1EE7a d\u1EF1 \xE1n").option("--skip-scan", "B\u1ECF qua project-scanner sau scaffold").option("--skip-team-pack", "B\u1ECF qua submodule team-ai-pack (test mode)").option("--force", "B\u1ECF qua prompt khi workspace path \u0111\xE3 t\u1ED3n t\u1EA1i").option("--yes", "Auto-confirm t\u1EA5t c\u1EA3 prompt").option("--no-commit", "Skip commit workspace initial state (m\u1EB7c \u0111\u1ECBnh LU\xD4N commit)").option("--workspace-remote", "T\u1EA1o GitHub remote cho workspace root (default: prompt)").option("--ai-skip", "B\u1ECF qua phase AI setup (CI/test mode \u2014 ch\u1EA1y `avatar ai setup` sau)").option(
+  program2.command("init").description("Kh\u1EDFi t\u1EA1o Avatar \u2014 3 flow t\u1EF1 nh\u1EADn di\u1EC7n (repo / folder / new)").option("--project-status <val>", "existing-remote | existing-folder | new-project").option("--folder-path <path>", "\u0110\u01B0\u1EDDng d\u1EABn folder hi\u1EC7n c\xF3 (flow existing-folder)").option("--create-remote", "Force t\u1EA1o remote qua gh (flow existing-folder ho\u1EB7c new-project)").option("--repo-visibility <val>", "private (m\u1EB7c \u0111\u1ECBnh) | public").option("--repo-org <name>", "GitHub org/owner cho repo m\u1EDBi").option("--client-repo <url>", "URL git remote (flow existing-remote)").option("--workspace-name <name>", "T\xEAn workspace").option("--workspace-parent <path>", "Th\u01B0 m\u1EE5c cha t\u1EA1o workspace (m\u1EB7c \u0111\u1ECBnh . \u2014 CWD)").option("--pack-version <tag>", "Pin team-ai-pack v\xE0o tag c\u1EE5 th\u1EC3").option("--latest", "Pull HEAD c\u1EE7a team-ai-pack main branch (b\u1ECF qua tag SemVer, bleeding-edge)").option("--team-owner <email>", "Email team owner (b\u1ECF qua prompt)").option("--description <text>", "M\xF4 t\u1EA3 1 d\xF2ng c\u1EE7a d\u1EF1 \xE1n").option("--skip-scan", "B\u1ECF qua project-scanner sau scaffold").option("--skip-team-pack", "B\u1ECF qua submodule team-ai-pack (test mode)").option("--force", "B\u1ECF qua prompt khi workspace path \u0111\xE3 t\u1ED3n t\u1EA1i").option("--yes", "Auto-confirm t\u1EA5t c\u1EA3 prompt").option("--no-commit", "Skip commit workspace initial state (m\u1EB7c \u0111\u1ECBnh LU\xD4N commit)").option("--workspace-remote", "T\u1EA1o GitHub remote cho workspace root (default: prompt)").option("--ai-skip", "B\u1ECF qua phase AI setup (CI/test mode \u2014 ch\u1EA1y `avatar ai setup` sau)").option(
     "--gitnexus-skip",
     "B\u1ECF qua phase GitNexus setup (M10 \u2014 ch\u1EA1y `avatar gitnexus install` sau)"
   ).option(
@@ -4065,6 +4107,7 @@ async function runInitFromExistingRemote(opts, ownerEmail) {
     skipTeamPack: opts.skipTeamPack,
     description: opts.description ?? `Avatar workspace cho ${remoteUrl}`,
     packVersion: opts.packVersion,
+    packLatest: opts.latest,
     autoYes: opts.yes,
     skipCommit: opts.commit === false,
     createWorkspaceRemote: opts.workspaceRemote,
@@ -4102,6 +4145,7 @@ async function runInitFromExistingFolder(opts, ownerEmail) {
     skipTeamPack: opts.skipTeamPack,
     description: opts.description ?? `Avatar workspace cho folder ${folderPath}`,
     packVersion: opts.packVersion,
+    packLatest: opts.latest,
     autoYes: opts.yes,
     skipCommit: opts.commit === false,
     createWorkspaceRemote: opts.workspaceRemote,
@@ -4151,7 +4195,9 @@ async function runInitFromScratch(opts, ownerEmail) {
       const result = await addTeamPackSubmoduleWithRetryOnNetworkFail(
         workspacePath,
         opts.packVersion,
-        ownerEmail
+        ownerEmail,
+        opts.latest === true && !opts.packVersion
+        // v1.10.0: latest mode khi flag set + không có explicit tag
       );
       pinnedTag = result.pinnedTag ?? "HEAD";
       sp.succeed(`Pin team-ai-pack v\xE0o ${pinnedTag}`);
@@ -4227,7 +4273,9 @@ async function scaffoldWorkspaceWithSrcSubmodule(args) {
       const result = await addTeamPackSubmoduleWithRetryOnNetworkFail(
         args.workspacePath,
         args.packVersion,
-        args.ssoEmail
+        args.ssoEmail,
+        args.packLatest === true && !args.packVersion
+        // v1.10.0
       );
       pinnedTag = result.pinnedTag ?? "HEAD";
       sp.succeed(`Pin team-ai-pack v\xE0o ${pinnedTag}`);
@@ -4305,7 +4353,7 @@ async function finalizeWorkspaceScaffold(args) {
     await writeRootClaudeMd(args.workspacePath, updatedVars);
     log.dim("Updated CLAUDE.md v\u1EDBi GitNexus section");
   }
-  printInitSuccessBox(args.workspacePath, args.flow, aiResult, gitnexusResult);
+  await printInitSuccessBox(args.workspacePath, args.flow, aiResult, gitnexusResult);
 }
 async function autoSyncPackOnInit(workspacePath) {
   const packDir = join24(workspacePath, TEAM_PACK_RELATIVE_PATH);
@@ -4499,7 +4547,7 @@ function formatGitnexusStatusLine(result) {
   }
   return `  ${chalk.yellow("GitNexus:")} skipped (${(result.reason ?? "unknown").slice(0, 40)}) \xB7 th\u1EED ${chalk.cyan("avatar gitnexus install")}`;
 }
-function printInitSuccessBox(rootPath, flow, aiResult = null, gitnexusResult = null) {
+async function printInitSuccessBox(rootPath, flow, aiResult = null, gitnexusResult = null) {
   const lines = [
     `${chalk.green("\u2713")} Workspace s\u1EB5n s\xE0ng: ${relative3(process.cwd(), rootPath) || rootPath}`,
     `  ${chalk.dim(`(flow: ${flow})`)}`,
@@ -4513,8 +4561,14 @@ function printInitSuccessBox(rootPath, flow, aiResult = null, gitnexusResult = n
     `  ${chalk.cyan("avatar sync")}               Pull team-ai-pack m\u1EDBi`,
     `  ${chalk.cyan("avatar uninstall")}          G\u1EE1 Avatar (gi\u1EEF code)`
   ];
-  process.stdout.write(`${boxen5(lines.join("\n"), { padding: 1, borderStyle: "round" })}
+  process.stdout.write(`${boxen6(lines.join("\n"), { padding: 1, borderStyle: "round" })}
+`);
+  const packDir = join24(rootPath, TEAM_PACK_RELATIVE_PATH);
+  if (await pathExists(packDir)) {
+    process.stdout.write(`
+${formatPackCommandsCheatsheetBox()}
 `);
+  }
 }
 
 // src/lib/not-implemented-stub.ts
@@ -4566,7 +4620,7 @@ function registerSecretsCommand(program2) {
 // src/commands/status.ts
 import { promises as fs13 } from "fs";
 import { join as join26 } from "path";
-import boxen6 from "boxen";
+import boxen7 from "boxen";
 
 // src/lib/pack-backup-manager.ts
 import { promises as fs12 } from "fs";
@@ -4644,7 +4698,7 @@ function renderStatusBox(s) {
     `${chalk.dim("Backups:")}            ${s.backupCount}`,
     `${chalk.dim("Tech stack:")}         ${s.techStackSummary}`
   ];
-  process.stdout.write(`${boxen6(lines.join("\n"), { padding: 1, borderStyle: "round" })}
+  process.stdout.write(`${boxen7(lines.join("\n"), { padding: 1, borderStyle: "round" })}
 `);
 }
 
@@ -4694,7 +4748,7 @@ async function buildSyncPreview(packDir, claudeDir, targetVersion) {
 }
 
 // src/commands/sync.ts
-var DEFAULT_PACK_BRANCH = "main";
+var DEFAULT_PACK_BRANCH2 = "main";
 async function syncAction(opts) {
   const projectRoot = process.cwd();
   const claudeDir = join28(projectRoot, ".claude");
@@ -4718,14 +4772,14 @@ async function syncAction(opts) {
   const allTags = await listTags(packDir);
   let targetVersion;
   if (useLatestMode) {
-    targetVersion = `${DEFAULT_PACK_BRANCH} (HEAD)`;
+    targetVersion = `${DEFAULT_PACK_BRANCH2} (HEAD)`;
   } else {
     const picked = opts.version ?? pickLatestStableSemVerTag(allTags);
     if (!picked) {
       log.error(
         `Kh\xF4ng t\xECm th\u1EA5y stable SemVer tag (vMAJOR.MINOR.PATCH) trong team-ai-pack submodule.
   Tags hi\u1EC7n c\xF3: ${allTags.length > 0 ? allTags.join(", ") : "(none)"}
-  Pass --version <tag> r\xF5 r\xE0ng, ho\u1EB7c d\xF9ng --latest \u0111\u1EC3 pull HEAD branch ${DEFAULT_PACK_BRANCH}.`
+  Pass --version <tag> r\xF5 r\xE0ng, ho\u1EB7c d\xF9ng --latest \u0111\u1EC3 pull HEAD branch ${DEFAULT_PACK_BRANCH2}.`
       );
       process.exit(1);
       return;
@@ -4755,8 +4809,8 @@ async function syncAction(opts) {
     return;
   }
   if (useLatestMode) {
-    log.info(`Pulling HEAD c\u1EE7a branch ${DEFAULT_PACK_BRANCH} (bleeding-edge mode)...`);
-    await checkoutBranchHeadInSubmodule(TEAM_PACK_RELATIVE_PATH, DEFAULT_PACK_BRANCH, projectRoot);
+    log.info(`Pulling HEAD c\u1EE7a branch ${DEFAULT_PACK_BRANCH2} (bleeding-edge mode)...`);
+    await checkoutBranchHeadInSubmodule(TEAM_PACK_RELATIVE_PATH, DEFAULT_PACK_BRANCH2, projectRoot);
     const sha = await currentCommitSha(packDir);
     log.dim(`  HEAD = ${sha.slice(0, 7)}`);
     log.warn(
@@ -4836,7 +4890,7 @@ function registerToolsCommand(program2) {
 // src/commands/uninstall.ts
 import { relative as relative4 } from "path";
 import { confirm as confirm6 } from "@inquirer/prompts";
-import boxen7 from "boxen";
+import boxen8 from "boxen";
 
 // src/lib/create-uninstall-backup-snapshot.ts
 import { cp, mkdir, writeFile } from "fs/promises";
@@ -4990,7 +5044,7 @@ async function removeSubmoduleEntry(gitmodulesPath, submodulePath) {
 }
 
 // src/commands/uninstall.ts
-var CLI_VERSION = "1.8.0";
+var CLI_VERSION = "1.10.0";
 function registerUninstallCommand(program2) {
   program2.command("uninstall").description("G\u1EE1 Avatar kh\u1ECFi project \u2014 backup t\u1EF1 \u0111\u1ED9ng (M11)").option("--yes", "Skip confirm prompt").option("--no-backup", "Kh\xF4ng t\u1EA1o backup tr\u01B0\u1EDBc khi x\xF3a (nguy hi\u1EC3m)").option("--keep-submodule", "Gi\u1EEF submodule .claude/pack/").option("--keep-hooks", "Gi\u1EEF git hooks post-merge, pre-push").option("--dry-run", "Hi\u1EC3n th\u1ECB danh s\xE1ch s\u1EBD x\xF3a, kh\xF4ng th\u1EF1c thi").action(async (opts) => {
     try {
@@ -5067,12 +5121,12 @@ function printUninstallSuccessBox(backupPath) {
     lines.push(`  ${chalk.dim("Backup:")} ${backupPath}`);
     lines.push(`  ${chalk.dim("Restore:")} ${chalk.cyan(`cp -r "${backupPath}"/* .`)}`);
   }
-  process.stdout.write(`${boxen7(lines.join("\n"), { padding: 1, borderStyle: "round" })}
+  process.stdout.write(`${boxen8(lines.join("\n"), { padding: 1, borderStyle: "round" })}
 `);
 }
 
 // src/index.ts
-var CLI_VERSION2 = "1.8.0";
+var CLI_VERSION2 = "1.10.0";
 var program = new Command();
 program.name("avatar").description("AI harness CLI for NAL Vietnam engineering").version(CLI_VERSION2, "-v, --version", "Hi\u1EC3n th\u1ECB phi\xEAn b\u1EA3n Avatar CLI").addHelpText(
   "beforeAll",