@nalvietnam/avatar-cli 1.7.0 → 1.8.0

package/dist/index.js

@@ -1297,13 +1297,22 @@ async function checkoutTagInSubmodule(submodulePath, tag, cwd = process.cwd()) {
   await git(submoduleCwd).fetch(["--tags"]);
   await git(submoduleCwd).checkout(tag);
 }
+async function checkoutBranchHeadInSubmodule(submodulePath, branch, cwd = process.cwd()) {
+  const submoduleCwd = join8(cwd, submodulePath);
+  await git(submoduleCwd).fetch(["origin"]);
+  await git(submoduleCwd).checkout(["-B", branch, `origin/${branch}`]);
+}
 async function listTags(cwd = process.cwd()) {
   const result = await git(cwd).tags();
   return result.all;
 }
-async function latestTag(cwd = process.cwd()) {
-  const tags = await listTags(cwd);
-  return tags.length > 0 ? tags[tags.length - 1] ?? null : null;
+async function tagAtHead(cwd = process.cwd()) {
+  try {
+    const result = await git(cwd).raw(["describe", "--tags", "--exact-match", "HEAD"]);
+    return result.trim() || null;
+  } catch {
+    return null;
+  }
 }
 async function currentCommitSha(cwd = process.cwd()) {
   const result = await git(cwd).revparse(["HEAD"]);
@@ -2430,6 +2439,31 @@ async function ensureTeamPackAccessWithRetry(args) {
   }
 }
 
+// src/lib/pick-latest-stable-semver-tag.ts
+var SEMVER_REGEX3 = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/;
+function parseSemVerTag(tag) {
+  const match = tag.match(SEMVER_REGEX3);
+  if (!match) return null;
+  const [, major, minor, patch, prerelease] = match;
+  return {
+    raw: tag,
+    major: Number.parseInt(major ?? "0", 10),
+    minor: Number.parseInt(minor ?? "0", 10),
+    patch: Number.parseInt(patch ?? "0", 10),
+    prerelease: prerelease ?? null
+  };
+}
+function pickLatestStableSemVerTag(tags, includePrerelease = false) {
+  const parsed = tags.map(parseSemVerTag).filter((t) => t !== null).filter((t) => includePrerelease || t.prerelease === null);
+  if (parsed.length === 0) return null;
+  parsed.sort((a, b) => {
+    if (a.major !== b.major) return a.major - b.major;
+    if (a.minor !== b.minor) return a.minor - b.minor;
+    return a.patch - b.patch;
+  });
+  return parsed[parsed.length - 1]?.raw ?? null;
+}
+
 // src/lib/resolve-team-pack-repo-url.ts
 var ORG_DEFAULT = "git@github.com:nalvn/team-ai-pack.git";
 function resolveTeamPackRepoUrl() {
@@ -2476,7 +2510,9 @@ async function addTeamPackSubmodule(projectRoot, tag, ssoEmail) {
   }
   let target = tag ?? null;
   if (!target) {
-    target = await latestTag(join16(projectRoot, TEAM_PACK_RELATIVE_PATH));
+    const submoduleDir = join16(projectRoot, TEAM_PACK_RELATIVE_PATH);
+    const allTags = await listTags(submoduleDir);
+    target = pickLatestStableSemVerTag(allTags);
   }
   if (target) {
     await checkoutTagInSubmodule(TEAM_PACK_RELATIVE_PATH, target, projectRoot);
@@ -2485,7 +2521,7 @@ async function addTeamPackSubmodule(projectRoot, tag, ssoEmail) {
 }
 async function readPinnedPackVersion(projectRoot) {
   const submoduleRoot = join16(projectRoot, TEAM_PACK_RELATIVE_PATH);
-  const tag = await latestTag(submoduleRoot);
+  const tag = await tagAtHead(submoduleRoot);
   if (tag) return tag;
   const sha = await currentCommitSha(submoduleRoot);
   return sha.slice(0, 7);
@@ -4636,9 +4672,11 @@ async function listCommitsBetween(packDir, fromSha, toRef) {
   }
 }
 async function buildSyncPreview(packDir, claudeDir, targetVersion) {
+  const currentTagOrNull = await tagAtHead(packDir);
   const currentSha = await currentCommitSha(packDir);
-  const currentVersion = currentSha.slice(0, 7);
-  const target = targetVersion ?? await latestTag(packDir) ?? "HEAD";
+  const currentVersion = currentTagOrNull ?? currentSha.slice(0, 7);
+  const allTags = await listTags(packDir);
+  const target = targetVersion ?? pickLatestStableSemVerTag(allTags) ?? "HEAD";
   const commits = await listCommitsBetween(packDir, currentSha, target);
   const mountStatuses = [];
   for (const dir of TEAM_PACK_MOUNT_DIRS) {
@@ -4656,6 +4694,7 @@ async function buildSyncPreview(packDir, claudeDir, targetVersion) {
 }
 
 // src/commands/sync.ts
+var DEFAULT_PACK_BRANCH = "main";
 async function syncAction(opts) {
   const projectRoot = process.cwd();
   const claudeDir = join28(projectRoot, ".claude");
@@ -4675,13 +4714,23 @@ async function syncAction(opts) {
       `Kh\xF4ng fetch \u0111\u01B0\u1EE3c tags t\u1EEB origin (${err instanceof Error ? err.message : err}). S\u1EBD d\xF9ng tag local hi\u1EC7n c\xF3.`
     );
   }
-  const targetVersion = opts.version ?? await latestTag(packDir);
-  if (!targetVersion) {
-    log.error(
-      "Kh\xF4ng t\xECm th\u1EA5y tag n\xE0o trong team-ai-pack submodule. Pass --version <tag> r\xF5 r\xE0ng, ho\u1EB7c ki\u1EC3m tra repo c\xF3 tag \u0111\u01B0\u1EE3c kh\xF4ng."
-    );
-    process.exit(1);
-    return;
+  const useLatestMode = opts.latest === true && !opts.version;
+  const allTags = await listTags(packDir);
+  let targetVersion;
+  if (useLatestMode) {
+    targetVersion = `${DEFAULT_PACK_BRANCH} (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}.`
+      );
+      process.exit(1);
+      return;
+    }
+    targetVersion = picked;
   }
   if (opts.dryRun) {
     const preview = await buildSyncPreview(packDir, claudeDir, targetVersion);
@@ -4705,8 +4754,18 @@ async function syncAction(opts) {
     log.info("\nDry-run done. Kh\xF4ng apply thay \u0111\u1ED5i. B\u1ECF --dry-run \u0111\u1EC3 th\u1EF1c thi.");
     return;
   }
-  log.info(`Checking out ${targetVersion} trong submodule...`);
-  await checkoutTagInSubmodule(TEAM_PACK_RELATIVE_PATH, targetVersion, projectRoot);
+  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);
+    const sha = await currentCommitSha(packDir);
+    log.dim(`  HEAD = ${sha.slice(0, 7)}`);
+    log.warn(
+      "\u26A0 --latest mode: workspace pin v\xE0o commit floating, kh\xF4ng reproducible. Chuy\u1EC3n v\u1EC1 tag stable: avatar sync (no flag)."
+    );
+  } else {
+    log.info(`Checking out ${targetVersion} trong submodule...`);
+    await checkoutTagInSubmodule(TEAM_PACK_RELATIVE_PATH, targetVersion, projectRoot);
+  }
   log.info("Creating symlink farm...");
   const results = await syncAllMountDirs(packDir, claudeDir, opts.force === true);
   reportResults(results, opts.force === true);
@@ -4763,7 +4822,7 @@ function reportResults(results, force) {
   }
 }
 function registerSyncCommand(program2) {
-  program2.command("sync").description("Pull team-ai-pack m\u1EDBi nh\u1EA5t + t\u1EA1o symlink farm v\xE0o .claude/").option("--force", "Override .claude/<dir>/ n\u1EBFu l\xE0 real dir (backup tr\u01B0\u1EDBc)").option("--version <tag>", "Pin v\xE0o version c\u1EE5 th\u1EC3 (vd: v0.2.0)").option("--dry-run", "Hi\u1EC3n th\u1ECB preview, kh\xF4ng apply thay \u0111\u1ED5i").action(syncAction);
+  program2.command("sync").description("Pull team-ai-pack m\u1EDBi nh\u1EA5t + t\u1EA1o symlink farm v\xE0o .claude/").option("--force", "Override .claude/<dir>/ n\u1EBFu l\xE0 real dir (backup tr\u01B0\u1EDBc)").option("--version <tag>", "Pin v\xE0o version c\u1EE5 th\u1EC3 (vd: v0.2.0)").option("--latest", "Bleeding-edge: pull HEAD c\u1EE7a main branch (b\u1ECF qua tag SemVer)").option("--dry-run", "Hi\u1EC3n th\u1ECB preview, kh\xF4ng apply thay \u0111\u1ED5i").action(syncAction);
 }
 
 // src/commands/tools.ts
@@ -4931,7 +4990,7 @@ async function removeSubmoduleEntry(gitmodulesPath, submodulePath) {
 }
 
 // src/commands/uninstall.ts
-var CLI_VERSION = "1.7.0";
+var CLI_VERSION = "1.8.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 {
@@ -5013,7 +5072,7 @@ function printUninstallSuccessBox(backupPath) {
 }
 
 // src/index.ts
-var CLI_VERSION2 = "1.7.0";
+var CLI_VERSION2 = "1.8.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",