@zjex/git-workflow 0.0.1

package/src/commands/branch.ts

@@ -0,0 +1,227 @@
+import { execSync } from "child_process";
+import { select, input } from "@inquirer/prompts";
+import ora from "ora";
+import {
+  colors,
+  TODAY,
+  theme,
+  exec,
+  execOutput,
+  getMainBranch,
+  divider,
+  type BranchType,
+} from "../utils.js";
+import { getConfig } from "../config.js";
+
+export async function getBranchName(type: BranchType): Promise<string | null> {
+  const config = getConfig();
+
+  const idLabel =
+    type === "feature" ? config.featureIdLabel : config.hotfixIdLabel;
+  const branchPrefix =
+    type === "feature" ? config.featurePrefix : config.hotfixPrefix;
+
+  const idMessage = config.requireId
+    ? `请输入${idLabel}:`
+    : `请输入${idLabel} (可跳过):`;
+
+  const id = await input({ message: idMessage, theme });
+
+  if (config.requireId && !id) {
+    console.log(colors.red(`${idLabel}不能为空`));
+    return null;
+  }
+
+  const description = await input({ message: "请输入描述:", theme });
+  if (!description) {
+    console.log(colors.red("描述不能为空"));
+    return null;
+  }
+
+  return id
+    ? `${branchPrefix}/${TODAY}-${id}-${description}`
+    : `${branchPrefix}/${TODAY}-${description}`;
+}
+
+export async function createBranch(
+  type: BranchType,
+  baseBranchArg?: string | null
+): Promise<void> {
+  const config = getConfig();
+
+  const branchName = await getBranchName(type);
+  if (!branchName) return;
+
+  divider();
+
+  // 优先使用参数，其次配置文件，最后自动检测
+  let baseBranch: string;
+  if (baseBranchArg) {
+    baseBranch = `origin/${baseBranchArg}`;
+  } else if (config.baseBranch) {
+    baseBranch = `origin/${config.baseBranch}`;
+  } else {
+    baseBranch = getMainBranch();
+  }
+
+  const spinner = ora(`正在从 ${baseBranch} 创建分支...`).start();
+
+  try {
+    exec(`git fetch origin ${baseBranch.replace("origin/", "")}`, true);
+    exec(`git checkout -b "${branchName}" ${baseBranch}`);
+    spinner.succeed(`分支创建成功: ${branchName}`);
+
+    divider();
+
+    // 根据配置决定是否询问推送
+    let shouldPush: boolean;
+    if (config.autoPush !== undefined) {
+      shouldPush = config.autoPush;
+      if (shouldPush) {
+        console.log(colors.dim("(自动推送已启用)"));
+      }
+    } else {
+      shouldPush = await select({
+        message: "是否推送到远程?",
+        choices: [
+          { name: "是", value: true },
+          { name: "否", value: false },
+        ],
+        theme,
+      });
+    }
+
+    if (shouldPush) {
+      const pushSpinner = ora("正在推送到远程...").start();
+      try {
+        execSync(`git push -u origin "${branchName}"`, { stdio: "pipe" });
+        pushSpinner.succeed(`已推送到远程: origin/${branchName}`);
+      } catch {
+        pushSpinner.warn(
+          "远程推送失败，可稍后手动执行: git push -u origin " + branchName
+        );
+      }
+    }
+  } catch {
+    spinner.fail("分支创建失败");
+  }
+}
+
+export async function deleteBranch(branchArg?: string): Promise<void> {
+  const fetchSpinner = ora("正在获取分支信息...").start();
+  exec("git fetch --all --prune", true);
+  fetchSpinner.succeed("分支信息已更新");
+
+  divider();
+
+  const currentBranch = execOutput("git branch --show-current");
+
+  let branch = branchArg;
+
+  if (!branch) {
+    const recentBranches = execOutput(
+      "git for-each-ref --sort=-committerdate refs/heads/ --format='%(refname:short)'"
+    )
+      .split("\n")
+      .filter((b) => b && b !== currentBranch);
+
+    if (recentBranches.length === 0) {
+      console.log(colors.yellow("没有可删除的本地分支"));
+      return;
+    }
+
+    interface BranchChoice {
+      name: string;
+      value: string;
+    }
+
+    const choices: BranchChoice[] = recentBranches.map((b) => {
+      const hasRemote = execOutput(`git branch -r | grep "origin/${b}$"`);
+      return {
+        name: hasRemote ? `${b} (本地+远程)` : `${b} (仅本地)`,
+        value: b,
+      };
+    });
+    choices.push({ name: "取消", value: "__cancel__" });
+
+    branch = await select({
+      message: "选择要删除的分支 (按最近使用排序):",
+      choices,
+      theme,
+    });
+
+    if (branch === "__cancel__") {
+      console.log(colors.yellow("已取消"));
+      return;
+    }
+  }
+
+  if (branch === currentBranch) {
+    console.log(colors.red("不能删除当前所在分支"));
+    return;
+  }
+
+  const localExists = execOutput(`git branch --list "${branch}"`);
+  const hasRemote = execOutput(`git branch -r | grep "origin/${branch}$"`);
+
+  if (!localExists) {
+    if (hasRemote) {
+      console.log(
+        colors.yellow(`本地分支不存在，但远程分支存在: origin/${branch}`)
+      );
+      const deleteRemote = await select({
+        message: `是否删除远程分支 origin/${branch}?`,
+        choices: [
+          { name: "是", value: true },
+          { name: "否", value: false },
+        ],
+        theme,
+      });
+
+      if (deleteRemote) {
+        const spinner = ora(`正在删除远程分支: origin/${branch}`).start();
+        try {
+          execSync(`git push origin --delete "${branch}"`, { stdio: "pipe" });
+          spinner.succeed(`远程分支已删除: origin/${branch}`);
+        } catch {
+          spinner.fail("远程分支删除失败");
+        }
+      }
+    } else {
+      console.log(colors.red(`分支不存在: ${branch}`));
+    }
+    return;
+  }
+
+  const localSpinner = ora(`正在删除本地分支: ${branch}`).start();
+  try {
+    execSync(`git branch -D "${branch}"`, { stdio: "pipe" });
+    localSpinner.succeed(`本地分支已删除: ${branch}`);
+  } catch {
+    localSpinner.fail("本地分支删除失败");
+    return;
+  }
+
+  if (hasRemote) {
+    divider();
+
+    const deleteRemote = await select({
+      message: `是否同时删除远程分支 origin/${branch}?`,
+      choices: [
+        { name: "是", value: true },
+        { name: "否", value: false },
+      ],
+      theme,
+    });
+
+    if (deleteRemote) {
+      const remoteSpinner = ora(`正在删除远程分支: origin/${branch}`).start();
+      try {
+        execSync(`git push origin --delete "${branch}"`, { stdio: "pipe" });
+        remoteSpinner.succeed(`远程分支已删除: origin/${branch}`);
+      } catch {
+        remoteSpinner.fail("远程分支删除失败");
+      }
+    }
+  }
+}

package/src/commands/help.ts

@@ -0,0 +1,49 @@
+import { TODAY } from "../utils.js";
+
+export function showHelp(): string {
+  return `
+分支命令:
+  gw feature [--base <branch>]    创建 feature 分支
+  gw feat [--base <branch>]       同上 (简写)
+  gw f [--base <branch>]          同上 (简写)
+
+  gw hotfix [--base <branch>]     创建 hotfix 分支
+  gw fix [--base <branch>]        同上 (简写)
+  gw h [--base <branch>]          同上 (简写)
+
+  gw delete [branch]              删除本地/远程分支
+  gw del [branch]                 同上 (简写)
+  gw d [branch]                   同上 (简写)
+
+Tag 命令:
+  gw tags [prefix]                列出所有 tag，可按前缀过滤
+  gw ts [prefix]                  同上 (简写)
+
+  gw tag [prefix]                 交互式选择版本类型并创建 tag
+  gw t [prefix]                   同上 (简写)
+
+发布命令:
+  gw release                      交互式选择版本号并更新 package.json
+  gw r                            同上 (简写)
+
+配置命令:
+  gw init                         初始化配置文件 .gwrc.json
+
+Stash 命令:
+  gw stash                        交互式管理 stash
+  gw s                            同上 (简写)
+
+示例:
+  gw feat                         基于 main/master 创建 feature 分支
+  gw feat --base develop          基于 develop 分支创建 feature 分支
+  gw fix --base release           基于 release 分支创建 hotfix 分支
+  gw del                          交互式选择并删除分支
+  gw del feature/xxx              直接删除指定分支
+  gw tags v                       列出所有 v 开头的 tag
+  gw tag                          交互式创建 tag
+
+分支命名格式:
+  feature/${TODAY}-<Story ID>-<描述>
+  hotfix/${TODAY}-<Issue ID>-<描述>
+`;
+}

package/src/commands/init.ts

@@ -0,0 +1,103 @@
+import { existsSync, writeFileSync } from "fs";
+import { select, input, confirm } from "@inquirer/prompts";
+import { colors, theme, divider } from "../utils.js";
+import type { GwConfig } from "../config.js";
+
+const CONFIG_FILE = ".gwrc.json";
+
+export async function init(): Promise<void> {
+  if (existsSync(CONFIG_FILE)) {
+    const overwrite = await confirm({
+      message: `${CONFIG_FILE} 已存在，是否覆盖?`,
+      default: false,
+      theme,
+    });
+    if (!overwrite) {
+      console.log(colors.yellow("已取消"));
+      return;
+    }
+  }
+
+  console.log(colors.dim("配置 git-workflow，直接回车使用默认值\n"));
+
+  const config: Partial<GwConfig> = {};
+
+  // 基础分支
+  const baseBranch = await input({
+    message: "默认基础分支 (留空自动检测 main/master):",
+    theme,
+  });
+  if (baseBranch) config.baseBranch = baseBranch;
+
+  divider();
+
+  // 分支前缀
+  const featurePrefix = await input({
+    message: "Feature 分支前缀:",
+    default: "feature",
+    theme,
+  });
+  if (featurePrefix !== "feature") config.featurePrefix = featurePrefix;
+
+  const hotfixPrefix = await input({
+    message: "Hotfix 分支前缀:",
+    default: "hotfix",
+    theme,
+  });
+  if (hotfixPrefix !== "hotfix") config.hotfixPrefix = hotfixPrefix;
+
+  divider();
+
+  // ID 配置
+  const requireId = await confirm({
+    message: "是否要求必填 ID (Story ID / Issue ID)?",
+    default: false,
+    theme,
+  });
+  if (requireId) config.requireId = true;
+
+  const featureIdLabel = await input({
+    message: "Feature 分支 ID 标签:",
+    default: "Story ID",
+    theme,
+  });
+  if (featureIdLabel !== "Story ID") config.featureIdLabel = featureIdLabel;
+
+  const hotfixIdLabel = await input({
+    message: "Hotfix 分支 ID 标签:",
+    default: "Issue ID",
+    theme,
+  });
+  if (hotfixIdLabel !== "Issue ID") config.hotfixIdLabel = hotfixIdLabel;
+
+  divider();
+
+  // Tag 配置
+  const defaultTagPrefix = await input({
+    message: "默认 Tag 前缀 (留空则每次选择):",
+    theme,
+  });
+  if (defaultTagPrefix) config.defaultTagPrefix = defaultTagPrefix;
+
+  // 自动推送
+  const autoPushChoice = await select({
+    message: "创建分支后是否自动推送?",
+    choices: [
+      { name: "每次询问", value: "ask" },
+      { name: "自动推送", value: "yes" },
+      { name: "不推送", value: "no" },
+    ],
+    theme,
+  });
+  if (autoPushChoice === "yes") config.autoPush = true;
+  if (autoPushChoice === "no") config.autoPush = false;
+
+  divider();
+
+  // 写入配置
+  const content = JSON.stringify(config, null, 2);
+  writeFileSync(CONFIG_FILE, content + "\n");
+
+  console.log(colors.green(`✓ 配置已保存到 ${CONFIG_FILE}`));
+  console.log(colors.dim("\n" + content));
+}

package/src/commands/release.ts

@@ -0,0 +1,118 @@
+import { readFileSync, writeFileSync } from "fs";
+import { select } from "@inquirer/prompts";
+import { colors, theme, divider } from "../utils.js";
+
+interface VersionChoice {
+  name: string;
+  value: string;
+}
+
+function getPackageVersion(): string {
+  const pkg = JSON.parse(readFileSync("package.json", "utf-8"));
+  return pkg.version || "0.0.0";
+}
+
+function setPackageVersion(version: string): void {
+  const pkg = JSON.parse(readFileSync("package.json", "utf-8"));
+  pkg.version = version;
+  writeFileSync("package.json", JSON.stringify(pkg, null, "\t") + "\n");
+}
+
+function generateChoices(current: string): VersionChoice[] {
+  const preReleaseMatch = current.match(
+    /^(\d+)\.(\d+)\.(\d+)-([a-zA-Z]+)\.(\d+)$/
+  );
+  const match = current.match(/^(\d+)\.(\d+)\.(\d+)$/);
+
+  if (preReleaseMatch) {
+    const [, majorStr, minorStr, patchStr, preTag, preNumStr] = preReleaseMatch;
+    const major = Number(majorStr);
+    const minor = Number(minorStr);
+    const patch = Number(patchStr);
+    const preNum = Number(preNumStr);
+    const baseVersion = `${major}.${minor}.${patch}`;
+
+    return [
+      {
+        name: `pre     → ${baseVersion}-${preTag}.${preNum + 1}`,
+        value: `${baseVersion}-${preTag}.${preNum + 1}`,
+      },
+      { name: `release → ${baseVersion}`, value: baseVersion },
+      {
+        name: `patch   → ${major}.${minor}.${patch + 1}`,
+        value: `${major}.${minor}.${patch + 1}`,
+      },
+      {
+        name: `minor   → ${major}.${minor + 1}.0`,
+        value: `${major}.${minor + 1}.0`,
+      },
+      { name: `major   → ${major + 1}.0.0`, value: `${major + 1}.0.0` },
+    ];
+  }
+
+  if (match) {
+    const [, majorStr, minorStr, patchStr] = match;
+    const major = Number(majorStr);
+    const minor = Number(minorStr);
+    const patch = Number(patchStr);
+
+    return [
+      {
+        name: `patch   → ${major}.${minor}.${patch + 1}`,
+        value: `${major}.${minor}.${patch + 1}`,
+      },
+      {
+        name: `minor   → ${major}.${minor + 1}.0`,
+        value: `${major}.${minor + 1}.0`,
+      },
+      { name: `major   → ${major + 1}.0.0`, value: `${major + 1}.0.0` },
+      {
+        name: `alpha   → ${major}.${minor}.${patch + 1}-alpha.1`,
+        value: `${major}.${minor}.${patch + 1}-alpha.1`,
+      },
+      {
+        name: `beta    → ${major}.${minor}.${patch + 1}-beta.1`,
+        value: `${major}.${minor}.${patch + 1}-beta.1`,
+      },
+      {
+        name: `rc      → ${major}.${minor}.${patch + 1}-rc.1`,
+        value: `${major}.${minor}.${patch + 1}-rc.1`,
+      },
+    ];
+  }
+
+  // fallback
+  return [
+    { name: `patch   → 0.0.1`, value: "0.0.1" },
+    { name: `minor   → 0.1.0`, value: "0.1.0" },
+    { name: `major   → 1.0.0`, value: "1.0.0" },
+  ];
+}
+
+export async function release(): Promise<void> {
+  const currentVersion = getPackageVersion();
+  console.log(colors.yellow(`当前版本: ${currentVersion}`));
+
+  divider();
+
+  const choices = generateChoices(currentVersion);
+  choices.push({ name: "取消", value: "__cancel__" });
+
+  const nextVersion = await select({
+    message: "选择新版本:",
+    choices,
+    theme,
+  });
+
+  if (nextVersion === "__cancel__") {
+    console.log(colors.yellow("已取消"));
+    return;
+  }
+
+  setPackageVersion(nextVersion);
+
+  divider();
+  console.log(
+    colors.green(`✓ 版本号已更新: ${currentVersion} → ${nextVersion}`)
+  );
+}