Stack Root 作为 Git 仓库

stack-root/                    ← 这是一个 Git 仓库
├── .git/                      ← stack root 的 Git 历史
├── repostack.yaml             ← 声明：stack 包含哪些 repo
├── repostack.lock.yaml        ← 状态：repo 当前的精确 revision
└── repos/                     ← 子目录（不是子模块）
    ├── foo/                   ← 独立的 Git 仓库
    └── bar/                  ← 独立的 Git 仓库

# 1. 当前在开发新功能
cd ~/my-stack
repostack list
# foo @ main a79cd2d
# bar @ main 1234567

# 2. 记录当前状态并提交
repostack snapshot
git add repostack.yaml repostack.lock.yaml
git commit -m "checkpoint: before v2 refactor"

# 3. 继续开发（各种修改、提交）
# ... 几天后 ...

# 4. 需要回到之前的版本组合
git log --oneline
# abc123 checkpoint: before v2 refactor
git checkout abc123
repostack sync       # foo 和 bar 都回到当时的 revision

# 场景 1：已经是 Git 仓库
cd ~/existing-project
repostack init
# 输出：Initialized repostack.yaml
# （不会重复初始化 Git）

# 场景 2：不是 Git 仓库，自动初始化
cd ~/new-stack
repostack init --yes
# 输出：
# Initialized repostack.yaml
# Initialized git repository

# 场景 3：不是 Git 仓库，手动处理
cd ~/new-stack
repostack init
# 输出：Initialized repostack.yaml
# （提示：当前目录不是 Git 仓库，建议手动 git init）

# 创建新的 stack 目录
mkdir ~/my-stack
cd ~/my-stack

# 方案 1：全自动（推荐用于新仓库）
repostack init --yes

# 方案 2：手动控制（推荐用于已有目录）
repostack init
git init
git add repostack.yaml
git commit -m "init repostack"

# 不要提交子 repo（它们是独立 Git 仓库）
foo/
bar/
baz/
qux/

# 依赖和缓存
node_modules/
*.log
.DS_Store

# 1. 克隆 stack root
git clone git@github.com:team/stack-root.git
cd stack-root

# 2. 下载所有子 repo
repostack pull

# 3. 同步到锁定版本
repostack sync

# 4. 验证状态
repostack list

# A 成员更新了 foo 和 bar
cd ~/stack-root
cd foo && git pull && cd ..
cd bar && git pull && cd ..

# 记录新状态
repostack snapshot

# 提交变更
git diff repostack.lock.yaml
git add repostack.lock.yaml
git commit -m "update: foo to v2.1, bar to v1.5"
git push

# B 成员获取更新
git pull
repostack sync