feat: add check command to show how many git commits repos are behind remote

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: yuWorm

src/commands/check.ts

@@ -0,0 +1,69 @@
+// check.ts — 检查项目仓库落后远程多少 git 提交
+import chalk from 'chalk'
+import { existsSync } from 'fs'
+import { resolveProjectDir, getBackendDir, getFrontendDir } from '../lib/config.js'
+import { run } from '../lib/process.js'
+import { t } from '../lib/i18n.js'
+
+interface CheckOptions {
+  project?: string
+}
+
+async function getRepoBehindCount(repoDir: string): Promise<{ behind: number; branch: string } | null> {
+  if (!existsSync(repoDir)) return null
+
+  // fetch latest from remote
+  const fetchResult = await run('git', ['fetch'], { cwd: repoDir, spinner: true, label: `${t('checkFetching')} ${repoDir}`, showErrorOutput: false })
+  if (fetchResult.exitCode !== 0) return null
+
+  // get current branch name
+  const branchResult = await run('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: repoDir, stdio: 'pipe', showErrorOutput: false })
+  if (branchResult.exitCode !== 0) return null
+  const branch = branchResult.stdout.trim()
+
+  // check if upstream tracking branch exists
+  const upstreamResult = await run('git', ['rev-parse', '--abbrev-ref', `${branch}@{upstream}`], { cwd: repoDir, stdio: 'pipe', showErrorOutput: false })
+  if (upstreamResult.exitCode !== 0) return null
+
+  // count commits behind
+  const countResult = await run('git', ['rev-list', '--count', `HEAD..${branch}@{upstream}`], { cwd: repoDir, stdio: 'pipe', showErrorOutput: false })
+  if (countResult.exitCode !== 0) return null
+
+  return { behind: parseInt(countResult.stdout.trim(), 10), branch }
+}
+
+export async function checkAction(options: CheckOptions = {}) {
+  const projectDir = resolveProjectDir(options.project)
+  if (!projectDir || !existsSync(projectDir)) {
+    console.log(chalk.red(t('projectDirNotExist')))
+    console.log(chalk.dim(t('hintRunCreate')))
+    return
+  }
+
+  const backendDir = getBackendDir(projectDir)
+  const frontendDir = getFrontendDir(projectDir)
+
+  console.log(chalk.bold(t('checkTitle')))
+  console.log()
+
+  const dirs = [
+    { label: t('labelBackend'), dir: backendDir },
+    { label: t('labelFrontend'), dir: frontendDir },
+  ]
+
+  for (const { label, dir } of dirs) {
+    if (!existsSync(dir)) {
+      console.log(`  ${label}: ${chalk.dim(t('checkDirNotFound'))}`)
+      continue
+    }
+
+    const result = await getRepoBehindCount(dir)
+    if (result === null) {
+      console.log(`  ${label}: ${chalk.yellow(t('checkFetchFailed'))}`)
+    } else if (result.behind === 0) {
+      console.log(`  ${label} ${chalk.dim(`(${result.branch})`)}: ${chalk.green(t('checkUpToDate'))}`)
+    } else {
+      console.log(`  ${label} ${chalk.dim(`(${result.branch})`)}: ${chalk.yellow(`${t('checkBehind')} ${result.behind} ${t('checkCommits')}`)}`)
+    }
+  }
+}

src/index.ts

@@ -219,6 +219,15 @@ program
     await goAction(options)
   })
 
+// ─── check ───
+program
+  .command('check')
+  .description(t('cmdCheck'))
+  .action(async () => {
+    const { checkAction } = await import('./commands/check.js')
+    await checkAction({ project: program.opts().project })
+  })
+
 // ─── infra ───
 const infraCmd = program
   .command('infra')

src/lib/i18n.ts

@@ -205,6 +205,16 @@ const messages = {
       '运行 "fba-cli remove" 清理，或运行 "fba-cli create" 创建新项目',
     hintRunUse: '运行 "fba-cli use" 设置默认项目',
 
+    // Check
+    checkTitle: "检查仓库更新状态",
+    checkFetching: "正在拉取远程更新",
+    checkDirNotFound: "目录不存在",
+    checkFetchFailed: "无法获取远程状态",
+    checkUpToDate: "已是最新",
+    checkBehind: "落后",
+    checkCommits: "个提交",
+    cmdCheck: "检查项目仓库落后远程多少 git 提交",
+
     // Dev server
     devStartingBackend: "正在启动后端服务器，端口:",
     devStartingFrontend: "正在启动前端开发服务器...",
@@ -497,6 +507,16 @@ const messages = {
       'Run "fba-cli remove" to clean up, or "fba-cli create" to create a new project',
     hintRunUse: 'Run "fba-cli use" to set a default project',
 
+    // Check
+    checkTitle: "Checking repository update status",
+    checkFetching: "Fetching remote updates",
+    checkDirNotFound: "directory not found",
+    checkFetchFailed: "Failed to fetch remote status",
+    checkUpToDate: "Up to date",
+    checkBehind: "behind",
+    checkCommits: "commits",
+    cmdCheck: "Check how many git commits the project repos are behind remote",
+
     devStartingBackend: "Starting backend server on port",
     devStartingFrontend: "Starting frontend dev server...",
     devStartingCelery: "Starting Celery",