@nalvietnam/avatar-cli 1.9.0 → 1.11.0

package/dist/index.js

@@ -2311,7 +2311,7 @@ function registerGitnexusCommand(program2) {
 }
 
 // src/commands/init.ts
-import { basename, join as join24, relative as relative3, resolve } from "path";
+import { basename, join as join25, relative as relative3, resolve as resolve2 } from "path";
 import { confirm as confirm5, input as input5, select as select9 } from "@inquirer/prompts";
 import boxen6 from "boxen";
 
@@ -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;
@@ -3741,8 +3747,43 @@ async function findAlternativeWorkspaceName(parent, desiredName, maxAttempts = 1
   return null;
 }
 
+// src/lib/read-cli-version-from-package-json.ts
+import { readFileSync as readFileSync5 } from "fs";
+import { dirname as dirname6, join as join24, resolve } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+var cachedVersion = null;
+function readCliVersion() {
+  if (cachedVersion !== null) return cachedVersion;
+  const here = dirname6(fileURLToPath3(import.meta.url));
+  for (let i = 0; i < 5; i++) {
+    const candidate = resolve(here, ...Array(i).fill(".."), "package.json");
+    try {
+      const raw = readFileSync5(candidate, "utf8");
+      const pkg = JSON.parse(raw);
+      if (pkg.name === "@nalvietnam/avatar-cli" && typeof pkg.version === "string") {
+        cachedVersion = pkg.version;
+        return cachedVersion;
+      }
+    } catch {
+    }
+    if (i === 0) {
+      const sibling = join24(here, "..", "package.json");
+      try {
+        const raw = readFileSync5(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;
+}
+
 // src/commands/init-scaffold-variable-builders.ts
-var AVATAR_CLI_VERSION = "1.0.1";
 function inferWorkspaceName(repoUrl) {
   const trimmed = repoUrl.trim().replace(/\/+$/, "");
   const lastSegment = trimmed.split(/[/:]/).pop() ?? "";
@@ -3788,7 +3829,7 @@ function buildScaffoldVariables(args) {
     projectName: args.projectName,
     projectDescription: args.projectDescription,
     teamOwner: args.teamOwner,
-    avatarVersion: AVATAR_CLI_VERSION,
+    avatarVersion: readCliVersion(),
     packVersion: args.packVersion,
     lastScan: (/* @__PURE__ */ new Date()).toISOString(),
     mode: args.mode,
@@ -3983,7 +4024,7 @@ async function runLogin(opts) {
   log.success(`L\u01B0u credential v\xE0o ${USER_CONFIG_PATH} (chmod 600)`);
 }
 function sleep(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
 
 // src/commands/init.ts
@@ -3999,7 +4040,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(
@@ -4091,7 +4132,7 @@ async function runInitFromExistingRemote(opts, ownerEmail) {
   const teamOwner = opts.teamOwner ?? await promptTeamOwner(ownerEmail);
   const inferredName = inferWorkspaceName(remoteUrl);
   const workspaceName = opts.workspaceName ?? await input5({ message: "T\xEAn workspace:", default: inferredName });
-  const workspaceParent = resolve(opts.workspaceParent ?? ".");
+  const workspaceParent = resolve2(opts.workspaceParent ?? ".");
   const workspacePath = await resolveWorkspacePath(workspaceParent, workspaceName, opts.force);
   await scaffoldWorkspaceWithSrcSubmodule({
     workspacePath,
@@ -4101,6 +4142,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,
@@ -4113,7 +4155,7 @@ async function runInitFromExistingRemote(opts, ownerEmail) {
   });
 }
 async function runInitFromExistingFolder(opts, ownerEmail) {
-  const folderPath = resolve(
+  const folderPath = resolve2(
     opts.folderPath ?? await input5({
       message: "\u0110\u01B0\u1EDDng d\u1EABn folder hi\u1EC7n c\xF3:",
       validate: (v) => v.length > 0 ? true : "Path b\u1EAFt bu\u1ED9c"
@@ -4127,7 +4169,7 @@ async function runInitFromExistingFolder(opts, ownerEmail) {
   const teamOwner = opts.teamOwner ?? await promptTeamOwner(ownerEmail);
   const inferredName = opts.workspaceName ?? `${basename(folderPath)}-avatar-workspace`;
   const workspaceName = opts.workspaceName ?? await input5({ message: "T\xEAn workspace:", default: inferredName });
-  const workspaceParent = resolve(opts.workspaceParent ?? ".");
+  const workspaceParent = resolve2(opts.workspaceParent ?? ".");
   const workspacePath = await resolveWorkspacePath(workspaceParent, workspaceName, opts.force);
   await scaffoldWorkspaceWithSrcSubmodule({
     workspacePath,
@@ -4138,6 +4180,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,
@@ -4163,9 +4206,9 @@ async function runInitFromScratch(opts, ownerEmail) {
     ]
   });
   const teamOwner = opts.teamOwner ?? await promptTeamOwner(ownerEmail);
-  const workspaceParent = resolve(opts.workspaceParent ?? ".");
+  const workspaceParent = resolve2(opts.workspaceParent ?? ".");
   const workspacePath = await resolveWorkspacePath(workspaceParent, projectName, opts.force);
-  const srcPath = join24(workspacePath, "src");
+  const srcPath = join25(workspacePath, "src");
   await ensureDir(workspacePath);
   await ensureDir(srcPath);
   await safeBootstrapGitInFolder(srcPath, { autoYes: true });
@@ -4187,7 +4230,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}`);
@@ -4263,7 +4308,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}`);
@@ -4303,10 +4350,10 @@ async function finalizeWorkspaceScaffold(args) {
   await writeRootClaudeMd(args.workspacePath, vars);
   await writeProjectSettings(args.workspacePath, vars);
   await appendGitignoreEntries(args.workspacePath);
-  await ensureDir(join24(args.workspacePath, "notes"));
-  await ensureDir(join24(args.workspacePath, "scripts"));
-  await installGitHook(join24(args.workspacePath, ".git"), "post-merge");
-  await installGitHook(join24(args.workspacePath, ".git", "modules", "src"), "pre-push");
+  await ensureDir(join25(args.workspacePath, "notes"));
+  await ensureDir(join25(args.workspacePath, "scripts"));
+  await installGitHook(join25(args.workspacePath, ".git"), "post-merge");
+  await installGitHook(join25(args.workspacePath, ".git", "modules", "src"), "pre-push");
   log.success("C\xE0i post-merge (workspace) + pre-push (src/)");
   await autoSyncPackOnInit(args.workspacePath);
   await appendAuditEntry("init", `flow=${args.flow},workspace=${args.workspaceName}`);
@@ -4344,12 +4391,12 @@ async function finalizeWorkspaceScaffold(args) {
   await printInitSuccessBox(args.workspacePath, args.flow, aiResult, gitnexusResult);
 }
 async function autoSyncPackOnInit(workspacePath) {
-  const packDir = join24(workspacePath, TEAM_PACK_RELATIVE_PATH);
+  const packDir = join25(workspacePath, TEAM_PACK_RELATIVE_PATH);
   if (!await pathExists(packDir)) {
     log.dim("Pack submodule kh\xF4ng t\u1ED3n t\u1EA1i (skip auto-sync). C\xF3 th\u1EC3 ch\u1EA1y `avatar sync` sau.");
     return;
   }
-  const claudeDir = join24(workspacePath, ".claude");
+  const claudeDir = join25(workspacePath, ".claude");
   log.info("Auto-sync pack content v\xE0o .claude/ (symlinks + settings merge)...");
   try {
     const results = await syncAllMountDirs(packDir, claudeDir, false);
@@ -4463,7 +4510,7 @@ async function maybeCreateWorkspaceRemote(args) {
   }
 }
 async function resolveWorkspacePath(parent, desiredName, force) {
-  const desired = join24(parent, desiredName);
+  const desired = join25(parent, desiredName);
   if (await isEmptyOrMissing(desired)) return desired;
   log.warn(`Workspace path "${desired}" \u0111\xE3 c\xF3 n\u1ED9i dung.`);
   while (true) {
@@ -4494,7 +4541,7 @@ async function resolveWorkspacePath(parent, desiredName, force) {
       message: "T\xEAn workspace m\u1EDBi:",
       validate: (v) => v.trim().length > 0 ? true : "T\xEAn kh\xF4ng \u0111\u01B0\u1EE3c r\u1ED7ng"
     });
-    const newPath = join24(parent, newName.trim());
+    const newPath = join25(parent, newName.trim());
     if (await isEmptyOrMissing(newPath)) return newPath;
     log.warn(`"${newPath}" c\u0169ng \u0111\xE3 c\xF3 n\u1ED9i dung. Th\u1EED t\xEAn kh\xE1c.`);
   }
@@ -4551,7 +4598,7 @@ async function printInitSuccessBox(rootPath, flow, aiResult = null, gitnexusResu
   ];
   process.stdout.write(`${boxen6(lines.join("\n"), { padding: 1, borderStyle: "round" })}
 `);
-  const packDir = join24(rootPath, TEAM_PACK_RELATIVE_PATH);
+  const packDir = join25(rootPath, TEAM_PACK_RELATIVE_PATH);
   if (await pathExists(packDir)) {
     process.stdout.write(`
 ${formatPackCommandsCheatsheetBox()}
@@ -4580,6 +4627,91 @@ function registerMcpRunCommand(program2) {
   program2.command("mcp-run <tool-id>", { hidden: true }).description("[internal] Spawn MCP v\u1EDBi secrets injected (M09)").action(notImplementedYet("mcp-run", "Milestone 09"));
 }
 
+// src/commands/pack-status-and-version-check.ts
+import { join as join26 } from "path";
+import boxen7 from "boxen";
+var PACK_RELATIVE_PATH = ".claude/pack";
+function registerPackCommand(program2) {
+  const pack = program2.command("pack").description("Qu\u1EA3n l\xFD team-ai-pack submodule (status, ...)");
+  pack.command("status").description("Hi\u1EC3n th\u1ECB tag pack \u0111ang pin + tag m\u1EDBi nh\u1EA5t t\u1EEB remote").option("--json", "Output JSON cho script").option("--no-fetch", "B\u1ECF qua fetch remote (ch\u1EC9 \u0111\u1ECDc local tags)").action(async (opts) => {
+    try {
+      const snap = await gatherPackStatus(process.cwd(), opts.fetch !== false);
+      if (opts.json) {
+        process.stdout.write(`${JSON.stringify(snap, null, 2)}
+`);
+      } else {
+        renderPackStatus(snap);
+      }
+    } catch (err) {
+      log.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+}
+async function gatherPackStatus(cwd, doFetch) {
+  const packDir = join26(cwd, PACK_RELATIVE_PATH);
+  if (!await pathExists(packDir) || !await isGitRepo(packDir)) {
+    return {
+      installed: false,
+      currentTag: null,
+      latestTag: null,
+      upToDate: null,
+      fetched: false
+    };
+  }
+  const currentTag = await readPinnedPackVersion(cwd).catch(() => null);
+  let fetched = false;
+  if (doFetch) {
+    try {
+      await git(packDir).fetch(["--tags", "origin"]);
+      fetched = true;
+    } catch {
+      fetched = false;
+    }
+  }
+  const allTags = await listTags(packDir).catch(() => []);
+  const latestTag = pickLatestStableSemVerTag(allTags);
+  const upToDate = currentTag && latestTag ? currentTag === latestTag : null;
+  return {
+    installed: true,
+    currentTag,
+    latestTag,
+    upToDate,
+    fetched
+  };
+}
+function renderPackStatus(s) {
+  if (!s.installed) {
+    const lines2 = [
+      `${chalk.bold("team-ai-pack")} \xB7 ${chalk.yellow("ch\u01B0a c\xE0i")}`,
+      "\u2500".repeat(48),
+      chalk.dim("Ch\u1EA1y `avatar init` ho\u1EB7c `avatar sync` \u0111\u1EC3 c\xE0i pack.")
+    ];
+    process.stdout.write(`${boxen7(lines2.join("\n"), { padding: 1, borderStyle: "round" })}
+`);
+    return;
+  }
+  const current = s.currentTag ?? chalk.yellow("(unknown)");
+  const latest = s.latestTag ?? chalk.dim(s.fetched ? "(no tags)" : "(kh\xF4ng fetch)");
+  let verdict;
+  if (s.upToDate === true) {
+    verdict = chalk.green("\u2713 \u0110ang d\xF9ng tag m\u1EDBi nh\u1EA5t");
+  } else if (s.upToDate === false) {
+    verdict = `${chalk.yellow("\u26A0 C\xF3 version m\u1EDBi")} ${chalk.dim("\u2192 avatar sync")}`;
+  } else {
+    verdict = chalk.dim("(kh\xF4ng so s\xE1nh \u0111\u01B0\u1EE3c)");
+  }
+  const lines = [
+    `${chalk.bold("team-ai-pack status")}`,
+    "\u2500".repeat(48),
+    `${chalk.dim("Tag hi\u1EC7n t\u1EA1i:")}    ${current}`,
+    `${chalk.dim("Tag m\u1EDBi nh\u1EA5t:")}    ${latest}`,
+    `${chalk.dim("Tr\u1EA1ng th\xE1i:")}      ${verdict}`
+  ];
+  process.stdout.write(`${boxen7(lines.join("\n"), { padding: 1, borderStyle: "round" })}
+`);
+}
+
 // src/commands/restore.ts
 function registerRestoreCommand(program2) {
   program2.command("restore").description("Kh\xF4i ph\u1EE5c .claude/pack/ t\u1EEB backup (M08)").option("--backup <name>", "T\xEAn backup folder trong .claude/_backup/").option("--list", "Li\u1EC7t k\xEA c\xE1c backup hi\u1EC7n c\xF3").action(notImplementedYet("restore", "Milestone 08"));
@@ -4607,22 +4739,21 @@ function registerSecretsCommand(program2) {
 
 // src/commands/status.ts
 import { promises as fs13 } from "fs";
-import { join as join26 } from "path";
-import boxen7 from "boxen";
+import { join as join28 } from "path";
+import boxen8 from "boxen";
 
 // src/lib/pack-backup-manager.ts
 import { promises as fs12 } from "fs";
-import { join as join25 } from "path";
+import { join as join27 } from "path";
 var BACKUP_DIR_NAME = "_backup";
 async function listBackups(projectRoot) {
-  const dir = join25(projectRoot, ".claude", BACKUP_DIR_NAME);
+  const dir = join27(projectRoot, ".claude", BACKUP_DIR_NAME);
   if (!await pathExists(dir)) return [];
   const entries = await fs12.readdir(dir, { withFileTypes: true });
   return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort().reverse();
 }
 
 // src/commands/status.ts
-var AVATAR_CLI_VERSION2 = "1.0.1";
 function registerStatusCommand(program2) {
   program2.command("status").description("Snapshot t\u1EE9c th\xEC: project, pack version, pending, backup").option("--json", "Output JSON cho script").action(async (opts) => {
     try {
@@ -4641,12 +4772,12 @@ function registerStatusCommand(program2) {
 }
 async function gatherStatus(cwd) {
   const projectName = cwd.split("/").filter(Boolean).pop() ?? "unknown";
-  const claudeRoot = join26(cwd, ".claude");
+  const claudeRoot = join28(cwd, ".claude");
   const hasAvatar = await pathExists(claudeRoot);
   if (!hasAvatar) {
     return {
       projectName,
-      cliVersion: AVATAR_CLI_VERSION2,
+      cliVersion: readCliVersion(),
       packVersion: null,
       pendingCount: 0,
       backupCount: 0,
@@ -4654,14 +4785,14 @@ async function gatherStatus(cwd) {
       hasAvatar: false
     };
   }
-  const packVersion = await isGitRepo(join26(claudeRoot, "pack")) ? await readPinnedPackVersion(cwd).catch(() => null) : null;
-  const pendingDir = join26(claudeRoot, "_pending");
+  const packVersion = await isGitRepo(join28(claudeRoot, "pack")) ? await readPinnedPackVersion(cwd).catch(() => null) : null;
+  const pendingDir = join28(claudeRoot, "_pending");
   const pendingCount = await pathExists(pendingDir) ? (await fs13.readdir(pendingDir)).filter((n) => n.endsWith(".diff.md")).length : 0;
   const backupCount = (await listBackups(cwd)).length;
   const techStackSummary = await readTechStackFirstLine(claudeRoot);
   return {
     projectName,
-    cliVersion: AVATAR_CLI_VERSION2,
+    cliVersion: AVATAR_CLI_VERSION,
     packVersion,
     pendingCount,
     backupCount,
@@ -4670,7 +4801,7 @@ async function gatherStatus(cwd) {
   };
 }
 async function readTechStackFirstLine(claudeRoot) {
-  const techStackPath = join26(claudeRoot, "project", "tech-stack.md");
+  const techStackPath = join28(claudeRoot, "project", "tech-stack.md");
   if (!await pathExists(techStackPath)) return "(no tech-stack.md)";
   const content = await readText(techStackPath);
   const firstNonHeaderLine = content.split("\n").find((l) => l.trim() && !l.startsWith("#") && !l.startsWith(">"));
@@ -4686,18 +4817,18 @@ function renderStatusBox(s) {
     `${chalk.dim("Backups:")}            ${s.backupCount}`,
     `${chalk.dim("Tech stack:")}         ${s.techStackSummary}`
   ];
-  process.stdout.write(`${boxen7(lines.join("\n"), { padding: 1, borderStyle: "round" })}
+  process.stdout.write(`${boxen8(lines.join("\n"), { padding: 1, borderStyle: "round" })}
 `);
 }
 
 // src/commands/sync.ts
-import { join as join28 } from "path";
+import { join as join30 } from "path";
 
 // src/lib/preview-team-pack-sync-changes-for-dry-run.ts
-import { join as join27 } from "path";
+import { join as join29 } from "path";
 async function inspectMountDir(packDir, claudeDir, dir) {
-  const source = join27(packDir, dir);
-  const dest = join27(claudeDir, dir);
+  const source = join29(packDir, dir);
+  const dest = join29(claudeDir, dir);
   if (!await pathExists(source)) return "source-missing";
   if (!await pathExists(dest)) return "needs-creation";
   const { promises: fs14 } = await import("fs");
@@ -4736,11 +4867,11 @@ 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");
-  const packDir = join28(projectRoot, TEAM_PACK_RELATIVE_PATH);
+  const claudeDir = join30(projectRoot, ".claude");
+  const packDir = join30(projectRoot, TEAM_PACK_RELATIVE_PATH);
   if (!await pathExists(packDir)) {
     log.error(
       `team-ai-pack submodule ch\u01B0a \u0111\u01B0\u1EE3c kh\u1EDFi t\u1EA1o \u1EDF ${TEAM_PACK_RELATIVE_PATH}/.
@@ -4760,14 +4891,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;
@@ -4797,8 +4928,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(
@@ -4878,32 +5009,32 @@ function registerToolsCommand(program2) {
 // src/commands/uninstall.ts
 import { relative as relative4 } from "path";
 import { confirm as confirm6 } from "@inquirer/prompts";
-import boxen8 from "boxen";
+import boxen9 from "boxen";
 
 // src/lib/create-uninstall-backup-snapshot.ts
 import { cp, mkdir, writeFile } from "fs/promises";
 import { homedir as homedir4 } from "os";
-import { basename as basename2, join as join29 } from "path";
-var UNINSTALL_BACKUPS_DIR = join29(homedir4(), ".avatar", "uninstall-backups");
+import { basename as basename2, join as join31 } from "path";
+var UNINSTALL_BACKUPS_DIR = join31(homedir4(), ".avatar", "uninstall-backups");
 async function createUninstallBackupSnapshot(projectRoot, artifacts, avatarVersion) {
   const projectName = basename2(projectRoot);
   const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  const backupDir = join29(UNINSTALL_BACKUPS_DIR, `${projectName}-${timestamp2}`);
+  const backupDir = join31(UNINSTALL_BACKUPS_DIR, `${projectName}-${timestamp2}`);
   await mkdir(backupDir, { recursive: true, mode: 448 });
   if (artifacts.claudeDir) {
-    await cp(artifacts.claudeDir, join29(backupDir, ".claude"), { recursive: true });
+    await cp(artifacts.claudeDir, join31(backupDir, ".claude"), { recursive: true });
   }
   if (artifacts.claudeMd) {
-    await cp(artifacts.claudeMd, join29(backupDir, "CLAUDE.md"));
+    await cp(artifacts.claudeMd, join31(backupDir, "CLAUDE.md"));
   }
   if (artifacts.postMergeHook || artifacts.prePushHook) {
-    const hooksBackupDir = join29(backupDir, "hooks");
+    const hooksBackupDir = join31(backupDir, "hooks");
     await mkdir(hooksBackupDir, { recursive: true });
     if (artifacts.postMergeHook) {
-      await cp(artifacts.postMergeHook, join29(hooksBackupDir, "post-merge"));
+      await cp(artifacts.postMergeHook, join31(hooksBackupDir, "post-merge"));
     }
     if (artifacts.prePushHook) {
-      await cp(artifacts.prePushHook, join29(hooksBackupDir, "pre-push"));
+      await cp(artifacts.prePushHook, join31(hooksBackupDir, "pre-push"));
     }
   }
   const manifest = {
@@ -4918,27 +5049,27 @@ async function createUninstallBackupSnapshot(projectRoot, artifacts, avatarVersi
       prePushHook: !!artifacts.prePushHook
     }
   };
-  await writeFile(join29(backupDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
+  await writeFile(join31(backupDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
   return backupDir;
 }
 
 // src/lib/detect-avatar-project-artifacts.ts
 import { existsSync as existsSync9 } from "fs";
-import { join as join30 } from "path";
+import { join as join32 } from "path";
 function existsOrNull(path) {
   return existsSync9(path) ? path : null;
 }
 function detectAvatarProjectArtifacts(projectRoot) {
-  const claudeDir = existsOrNull(join30(projectRoot, ".claude"));
-  const claudeMd = existsOrNull(join30(projectRoot, "CLAUDE.md"));
-  const postMergeHook = existsOrNull(join30(projectRoot, ".git", "hooks", "post-merge"));
+  const claudeDir = existsOrNull(join32(projectRoot, ".claude"));
+  const claudeMd = existsOrNull(join32(projectRoot, "CLAUDE.md"));
+  const postMergeHook = existsOrNull(join32(projectRoot, ".git", "hooks", "post-merge"));
   const prePushHook = existsOrNull(
-    join30(projectRoot, ".git", "modules", "src", "hooks", "pre-push")
+    join32(projectRoot, ".git", "modules", "src", "hooks", "pre-push")
   );
-  const gitignorePath = existsOrNull(join30(projectRoot, ".gitignore"));
-  const gitmodulesPath = existsOrNull(join30(projectRoot, ".gitmodules"));
-  const notesDir = existsOrNull(join30(projectRoot, "notes"));
-  const scriptsDir = existsOrNull(join30(projectRoot, "scripts"));
+  const gitignorePath = existsOrNull(join32(projectRoot, ".gitignore"));
+  const gitmodulesPath = existsOrNull(join32(projectRoot, ".gitmodules"));
+  const notesDir = existsOrNull(join32(projectRoot, "notes"));
+  const scriptsDir = existsOrNull(join32(projectRoot, "scripts"));
   const hasAnyArtifact = !!(claudeDir || claudeMd || postMergeHook || prePushHook);
   return {
     hasAnyArtifact,
@@ -4959,11 +5090,11 @@ async function executeUninstallDeletion(artifacts, flags) {
   if (artifacts.claudeDir) {
     if (flags.keepSubmodule) {
       const { readdir: readdir2 } = await import("fs/promises");
-      const { join: join31 } = await import("path");
+      const { join: join33 } = await import("path");
       const entries = await readdir2(artifacts.claudeDir);
       for (const entry of entries) {
         if (entry === "pack") continue;
-        await rm(join31(artifacts.claudeDir, entry), { recursive: true, force: true });
+        await rm(join33(artifacts.claudeDir, entry), { recursive: true, force: true });
       }
     } else {
       await rm(artifacts.claudeDir, { recursive: true, force: true });
@@ -5032,7 +5163,7 @@ async function removeSubmoduleEntry(gitmodulesPath, submodulePath) {
 }
 
 // src/commands/uninstall.ts
-var CLI_VERSION = "1.9.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 {
@@ -5109,12 +5240,12 @@ function printUninstallSuccessBox(backupPath) {
     lines.push(`  ${chalk.dim("Backup:")} ${backupPath}`);
     lines.push(`  ${chalk.dim("Restore:")} ${chalk.cyan(`cp -r "${backupPath}"/* .`)}`);
   }
-  process.stdout.write(`${boxen8(lines.join("\n"), { padding: 1, borderStyle: "round" })}
+  process.stdout.write(`${boxen9(lines.join("\n"), { padding: 1, borderStyle: "round" })}
 `);
 }
 
 // src/index.ts
-var CLI_VERSION2 = "1.9.0";
+var CLI_VERSION2 = readCliVersion();
 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",
@@ -5142,6 +5273,7 @@ registerSecretsCommand(program);
 registerMcpRunCommand(program);
 registerAiCommand(program);
 registerGitnexusCommand(program);
+registerPackCommand(program);
 registerUninstallCommand(program);
 program.parseAsync(process.argv).catch((err) => {
   const msg = err instanceof Error ? err.message : String(err);