Mô hình hóa Lệnh Git: Cấu trúc 80+ Lệnh cho việc Học & Tương tác

interface GitCommand {
  command: string // Tên lệnh thực tế
  description: string // Mô tả chức năng của lệnh
  usage: string // Cú pháp đầy đủ với các tùy chọn
  examples: string[] // Các ví dụ sử dụng trong thực tế
  relatedCommands: string[] // Các lệnh thường được sử dụng cùng nhau
  category: CommandCategory // Phân nhóm để tổ chức
}

type CommandCategory =
  | 'main' // Các lệnh trong quy trình làm việc cốt lõi
  | 'ancillary' // Các lệnh hỗ trợ
  | 'plumbing' // Các lệnh cấp thấp

"git commit": {
  command: "git commit",
  description: "Ghi lại các thay đổi vào kho chứa",
  usage: "git commit [options]",
  examples: [
    'git commit -m "Add new feature"',
    'git commit -am "Fix bug and update docs"',
    "git commit --amend",
    "git commit --no-verify",
  ],
  relatedCommands: ["git add", "git status", "git log", "git push"],
  category: "main",
}

const mainCommands = [
  'git add',
  'git commit',
  'git push',
  'git pull',
  'git branch',
  'git checkout',
  'git merge',
  'git status',
  'git log',
  'git diff',
  'git clone',
  'git init',
]

const ancillaryCommands = [
  'git config',
  'git remote',
  'git tag',
  'git stash',
  'git rebase',
  'git cherry-pick',
  'git bisect',
  'git blame',
]

const plumbingCommands = [
  'git hash-object',
  'git cat-file',
  'git update-index',
  'git write-tree',
  'git commit-tree',
  'git show-ref',
]

export function parseGitCommand(input: string): string | null {
  const trimmed = input.trim()

  // Khớp trực tiếp
  if (gitCommands[trimmed]) {
    return trimmed
  }

  // Xử lý tiền tố 'git'
  const withGit = trimmed.startsWith('git ') ? trimmed : `git ${trimmed}`
  if (gitCommands[withGit]) {
    return withGit
  }

  // Khớp tương đối cho lỗi gõ sai
  const fuzzyMatch = findFuzzyMatch(trimmed)
  if (fuzzyMatch) {
    return fuzzyMatch
  }

  return null
}

export function getCommandSuggestions(input: string): string[] {
  const query = input.toLowerCase().trim()

  if (!query) return []

  const suggestions: Array<{ command: string; score: number }> = []

  Object.keys(gitCommands).forEach((command) => {
    let score = 0

    // Khớp tiền tố chính xác (ưu tiên cao nhất)
    if (command.toLowerCase().startsWith(query)) {
      score += 100
    }

    // Chứa từ khóa truy vấn
    else if (command.toLowerCase().includes(query)) {
      score += 50
    }

    // Mô tả chứa từ khóa truy vấn
    else if (gitCommands[command].description.toLowerCase().includes(query)) {
      score += 25
    }

    // Điểm thưởng cho danh mục lệnh chính
    if (gitCommands[command].category === 'main') {
      score += 10
    }

    if (score > 0) {
      suggestions.push({ command, score })
    }
  })

  return suggestions
    .sort((a, b) => b.score - a.score)
    .slice(0, 5)
    .map((s) => s.command)
}

// Quy trình phân nhánh điển hình
const branchingWorkflow = [
  'git branch feature-login',
  'git checkout feature-login',
  // ... làm việc ...
  'git add .',
  'git commit -m "Add login feature"',
  'git push origin feature-login'
];

// Các lệnh lưu trữ những mối quan hệ này
"git branch": {
  // ...
  relatedCommands: ["git checkout", "git switch", "git merge", "git push"],
}

export function getContextualRelatedCommands(command: string, recentCommands: string[]): string[] {
  const baseRelated = gitCommands[command]?.relatedCommands || []

  // Thêm các lệnh thường được sử dụng sau lệnh này
  const contextual = getSequentialCommands(command, recentCommands)

  return [...new Set([...baseRelated, ...contextual])]
}

interface CommandDetail {
  basic: {
    description: string
    commonExample: string
  }
  intermediate: {
    allExamples: string[]
    usageNotes: string[]
  }
  advanced: {
    fullSyntax: string
    internalBehavior: string
    scriptingTips: string[]
  }
}

// Ví dụ hay cho git reset
examples: [
  'git reset HEAD~1', // Trường hợp đơn giản
  'git reset --soft HEAD~1', // Giữ lại các thay đổi
  'git reset --hard HEAD~1', // Cảnh báo: có thể phá hủy dữ liệu
  'git reset HEAD file.txt', // Bỏ một file cụ thể khỏi khu vực chờ (unstage)
]