monarbor 0.1.0__tar.gz

monarbor-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

monarbor-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+*.so
+.env
+.venv
+venv/
+*.swp
+.DS_Store

monarbor-0.1.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: monarbor
+Version: 0.1.0
+Summary: Monarbor - AI 友好的逻辑大仓命令行工具
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+
+# Monarbor
+
+AI 友好的逻辑大仓命令行工具。一个 `mona.yaml` 配置文件描述所有仓库，一套命令统一管理。
+
+## 安装
+
+```bash
+pip install monarbor
+```
+
+开发模式安装：
+
+```bash
+pip install -e .
+```
+
+## 快速开始
+
+```bash
+# 初始化一个逻辑大仓
+monarbor init
+
+# 添加仓库
+monarbor add --path business-a/frontend --name "前端项目" --url "https://git.example.com/org/frontend.git"
+
+# 拉取所有代码
+monarbor clone
+
+# 查看状态
+monarbor status
+```
+
+## 命令一览
+
+| 命令 | 说明 |
+|------|------|
+| `monarbor clone` | 拉取大仓下所有项目代码 |
+| `monarbor pull` | 更新所有已 clone 仓库的代码 |
+| `monarbor status` | 显示所有仓库的分支、改动、同步状态 |
+| `monarbor list` | 以树形结构列出所有仓库 |
+| `monarbor exec <cmd>` | 在所有仓库中执行命令 |
+| `monarbor checkout <dev\|test\|prod>` | 批量切换到指定分支类型 |
+| `monarbor init` | 初始化新的逻辑大仓 |
+| `monarbor add` | 向当前大仓添加仓库 |
+
+## 常用场景
+
+### 拉取所有代码
+
+```bash
+# 默认 clone dev 分支
+monarbor clone
+
+# clone 测试分支
+monarbor clone -b test
+
+# 递归 clone（包括嵌套的子逻辑大仓）
+monarbor clone -r
+
+# 只 clone 某个业务线
+monarbor clone --filter business-a
+```
+
+### 批量切换分支
+
+```bash
+# 全部切到测试分支
+monarbor checkout test
+
+# 全部切到生产分支
+monarbor checkout prod
+```
+
+### 批量执行命令
+
+```bash
+# 查看每个仓库最近 5 条提交
+monarbor exec "git log --oneline -5"
+
+# 全部安装依赖
+monarbor exec "npm install"
+
+# 只在某个业务线执行
+monarbor exec "pnpm build" --filter business-a
+```
+
+### 嵌套逻辑大仓
+
+当子目录下存在自己的 `mona.yaml` 时，带 `-r` 参数即可递归处理：
+
+```bash
+monarbor clone -r      # 递归 clone
+monarbor status -r     # 递归查看状态
+monarbor list -r       # 递归列出树形结构
+```
+
+## mona.yaml 格式
+
+```yaml
+name: "我的大仓"
+description: "大仓描述"
+owner: your-name
+
+repos:
+  - path: business-a/frontend
+    name: "前端项目"
+    repo_url: "https://git.example.com/org/frontend.git"
+    tech_stack: [typescript, react]
+    branches:
+      dev: develop
+      test: release/test
+      prod: main
+```
+
+## License
+
+MIT

monarbor-0.1.0/README.md

@@ -0,0 +1,117 @@
+# Monarbor
+
+AI 友好的逻辑大仓命令行工具。一个 `mona.yaml` 配置文件描述所有仓库，一套命令统一管理。
+
+## 安装
+
+```bash
+pip install monarbor
+```
+
+开发模式安装：
+
+```bash
+pip install -e .
+```
+
+## 快速开始
+
+```bash
+# 初始化一个逻辑大仓
+monarbor init
+
+# 添加仓库
+monarbor add --path business-a/frontend --name "前端项目" --url "https://git.example.com/org/frontend.git"
+
+# 拉取所有代码
+monarbor clone
+
+# 查看状态
+monarbor status
+```
+
+## 命令一览
+
+| 命令 | 说明 |
+|------|------|
+| `monarbor clone` | 拉取大仓下所有项目代码 |
+| `monarbor pull` | 更新所有已 clone 仓库的代码 |
+| `monarbor status` | 显示所有仓库的分支、改动、同步状态 |
+| `monarbor list` | 以树形结构列出所有仓库 |
+| `monarbor exec <cmd>` | 在所有仓库中执行命令 |
+| `monarbor checkout <dev\|test\|prod>` | 批量切换到指定分支类型 |
+| `monarbor init` | 初始化新的逻辑大仓 |
+| `monarbor add` | 向当前大仓添加仓库 |
+
+## 常用场景
+
+### 拉取所有代码
+
+```bash
+# 默认 clone dev 分支
+monarbor clone
+
+# clone 测试分支
+monarbor clone -b test
+
+# 递归 clone（包括嵌套的子逻辑大仓）
+monarbor clone -r
+
+# 只 clone 某个业务线
+monarbor clone --filter business-a
+```
+
+### 批量切换分支
+
+```bash
+# 全部切到测试分支
+monarbor checkout test
+
+# 全部切到生产分支
+monarbor checkout prod
+```
+
+### 批量执行命令
+
+```bash
+# 查看每个仓库最近 5 条提交
+monarbor exec "git log --oneline -5"
+
+# 全部安装依赖
+monarbor exec "npm install"
+
+# 只在某个业务线执行
+monarbor exec "pnpm build" --filter business-a
+```
+
+### 嵌套逻辑大仓
+
+当子目录下存在自己的 `mona.yaml` 时，带 `-r` 参数即可递归处理：
+
+```bash
+monarbor clone -r      # 递归 clone
+monarbor status -r     # 递归查看状态
+monarbor list -r       # 递归列出树形结构
+```
+
+## mona.yaml 格式
+
+```yaml
+name: "我的大仓"
+description: "大仓描述"
+owner: your-name
+
+repos:
+  - path: business-a/frontend
+    name: "前端项目"
+    repo_url: "https://git.example.com/org/frontend.git"
+    tech_stack: [typescript, react]
+    branches:
+      dev: develop
+      test: release/test
+      prod: main
+```
+
+## License
+
+MIT

monarbor-0.1.0/monarbor/__init__.py

@@ -0,0 +1,3 @@
+"""Monarbor - AI 友好的逻辑大仓命令行工具"""
+
+__version__ = "0.1.0"

monarbor-0.1.0/monarbor/cli.py

@@ -0,0 +1,323 @@
+"""Monarbor 命令行入口。"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+from rich.console import Console
+from rich.table import Table
+from rich.tree import Tree as RichTree
+
+from . import __version__
+from .config import CONFIG_FILENAME, MonorepoConfig, RepoDef, find_nested_monorepos, walk_monorepos
+from .git_ops import (
+    ahead_behind,
+    checkout,
+    clone,
+    current_branch,
+    fetch,
+    is_dirty,
+    pull,
+    run_in_repo,
+)
+
+console = Console()
+
+
+def find_root(start: Path | None = None) -> Path:
+    """向上查找最近的 mona.yaml 所在目录。"""
+    current = (start or Path.cwd()).resolve()
+    while True:
+        if (current / CONFIG_FILENAME).exists():
+            return current
+        parent = current.parent
+        if parent == current:
+            break
+        current = parent
+    raise click.ClickException(f"未找到 {CONFIG_FILENAME}，请在逻辑大仓目录下运行，或使用 monarbor init 初始化")
+
+
+@click.group()
+@click.version_option(__version__, prog_name="monarbor")
+def main():
+    """Monarbor - AI 友好的逻辑大仓命令行工具"""
+    pass
+
+
+# ── monarbor clone ───────────────────────────────────────────
+
+
+@main.command(name="clone")
+@click.option("-r", "--recursive", is_flag=True, help="递归 clone 嵌套的子逻辑大仓")
+@click.option("-b", "--branch-type", type=click.Choice(["dev", "test", "prod"]), default="dev", help="clone 哪个分支类型 (默认 dev)")
+@click.option("--filter", "path_filter", default=None, help="只 clone 路径前缀匹配的仓库 (如 business-a)")
+def clone_repos(recursive: bool, branch_type: str, path_filter: str | None):
+    """拉取大仓下所有项目代码。"""
+    root = find_root()
+    configs = list(walk_monorepos(root, recursive=recursive))
+    total, success, skipped = 0, 0, 0
+
+    for config in configs:
+        if config.root != root:
+            console.rule(f"[bold]嵌套大仓: {config.name}[/bold] ({config.root.relative_to(root)})")
+
+        for repo in config.repos:
+            if path_filter and not repo.path.startswith(path_filter):
+                continue
+            total += 1
+            target = config.root / repo.path
+            if target.exists() and (target / ".git").exists():
+                console.print(f"  [dim]跳过[/dim] {repo.path} (已存在)")
+                skipped += 1
+                continue
+
+            branch = repo.branches.get(branch_type)
+            console.print(f"  [cyan]克隆[/cyan] {repo.name} → {repo.path} [dim](branch: {branch})[/dim]")
+            result = clone(repo.repo_url, target, branch=branch)
+            if result.ok:
+                success += 1
+                console.print(f"       [green]✓[/green]")
+            else:
+                console.print(f"       [red]✗ {result.error}[/red]")
+
+    console.print(f"\n[bold]完成:[/bold] {success} 克隆, {skipped} 跳过, {total - success - skipped} 失败 (共 {total})")
+
+
+# ── monarbor pull ────────────────────────────────────────────
+
+
+@main.command(name="pull")
+@click.option("-r", "--recursive", is_flag=True, help="递归 pull 嵌套大仓")
+def pull_repos(recursive: bool):
+    """拉取所有已 clone 仓库的最新代码。"""
+    root = find_root()
+    configs = list(walk_monorepos(root, recursive=recursive))
+    total, success = 0, 0
+
+    for config in configs:
+        for repo in config.repos:
+            target = config.root / repo.path
+            if not (target / ".git").exists():
+                continue
+            total += 1
+            console.print(f"  [cyan]拉取[/cyan] {repo.name} ({repo.path})")
+            result = pull(target)
+            if result.ok:
+                success += 1
+                console.print(f"       [green]✓[/green] {result.output or 'Already up to date.'}")
+            else:
+                console.print(f"       [red]✗ {result.error}[/red]")
+
+    console.print(f"\n[bold]完成:[/bold] {success}/{total} 成功")
+
+
+# ── monarbor status ──────────────────────────────────────────
+
+
+@main.command()
+@click.option("-r", "--recursive", is_flag=True, help="递归显示嵌套大仓")
+@click.option("--fetch/--no-fetch", default=False, help="先 fetch 远端再显示状态")
+def status(recursive: bool, fetch: bool):
+    """显示所有仓库的当前状态。"""
+    root = find_root()
+    configs = list(walk_monorepos(root, recursive=recursive))
+
+    table = Table(title="仓库状态")
+    table.add_column("项目", style="bold")
+    table.add_column("路径", style="dim")
+    table.add_column("分支", style="cyan")
+    table.add_column("状态")
+    table.add_column("同步")
+
+    for config in configs:
+        for repo in config.repos:
+            target = config.root / repo.path
+            rel_path = str(target.relative_to(root))
+            if not (target / ".git").exists():
+                table.add_row(repo.name, rel_path, "-", "[dim]未 clone[/dim]", "-")
+                continue
+
+            if fetch:
+                from .git_ops import fetch as git_fetch
+                git_fetch(target)
+
+            branch = current_branch(target)
+            dirty = is_dirty(target)
+            dirty_label = "[red]有改动[/red]" if dirty else "[green]干净[/green]"
+            a, b = ahead_behind(target)
+            sync_parts = []
+            if a:
+                sync_parts.append(f"[yellow]↑{a}[/yellow]")
+            if b:
+                sync_parts.append(f"[yellow]↓{b}[/yellow]")
+            sync_label = " ".join(sync_parts) if sync_parts else "[green]同步[/green]"
+
+            table.add_row(repo.name, rel_path, branch, dirty_label, sync_label)
+
+    console.print(table)
+
+
+# ── monarbor list ────────────────────────────────────────────
+
+
+@main.command(name="list")
+@click.option("-r", "--recursive", is_flag=True, help="递归显示嵌套大仓")
+def list_repos(recursive: bool):
+    """以树形结构列出所有仓库。"""
+    root = find_root()
+    configs = list(walk_monorepos(root, recursive=recursive))
+
+    for config in configs:
+        tree = RichTree(f"[bold]{config.name}[/bold] [dim]({config.root.relative_to(root) if config.root != root else '.'})[/dim]")
+        groups: dict[str, list[RepoDef]] = {}
+        for repo in config.repos:
+            parts = repo.path.split("/")
+            group = parts[0] if len(parts) > 1 else "."
+            groups.setdefault(group, []).append(repo)
+
+        for group_name, repos in sorted(groups.items()):
+            if group_name == ".":
+                for repo in repos:
+                    tree.add(f"{repo.name} [dim]{repo.path}[/dim] [cyan]{'|'.join(repo.tech_stack)}[/cyan]")
+            else:
+                branch = tree.add(f"[bold]{group_name}/[/bold]")
+                for repo in repos:
+                    sub_path = "/".join(repo.path.split("/")[1:])
+                    branch.add(f"{repo.name} [dim]{sub_path}[/dim] [cyan]{'|'.join(repo.tech_stack)}[/cyan]")
+
+        nested = find_nested_monorepos(config.root)
+        for n in nested:
+            tree.add(f"[bold magenta]📦 {n.name}/[/bold magenta] [dim](嵌套大仓)[/dim]")
+
+        console.print(tree)
+
+
+# ── monarbor exec ────────────────────────────────────────────
+
+
+@main.command()
+@click.argument("command")
+@click.option("-r", "--recursive", is_flag=True, help="递归执行到嵌套大仓")
+@click.option("--filter", "path_filter", default=None, help="只在路径前缀匹配的仓库中执行")
+def exec_cmd(command: str, recursive: bool, path_filter: str | None):
+    """在所有已 clone 的仓库中执行命令。
+
+    示例: monarbor exec "git log --oneline -5"
+    """
+    root = find_root()
+    configs = list(walk_monorepos(root, recursive=recursive))
+
+    for config in configs:
+        for repo in config.repos:
+            if path_filter and not repo.path.startswith(path_filter):
+                continue
+            target = config.root / repo.path
+            if not (target / ".git").exists():
+                continue
+            console.rule(f"[bold]{repo.name}[/bold] ({repo.path})")
+            result = run_in_repo(target, command)
+            if result.output:
+                console.print(result.output)
+            if result.error:
+                console.print(f"[red]{result.error}[/red]")
+
+
+# ── monarbor checkout ────────────────────────────────────────
+
+
+@main.command(name="checkout")
+@click.argument("branch_type", type=click.Choice(["dev", "test", "prod"]))
+@click.option("-r", "--recursive", is_flag=True, help="递归切换嵌套大仓")
+@click.option("--filter", "path_filter", default=None, help="只切换路径前缀匹配的仓库")
+def checkout_repos(branch_type: str, recursive: bool, path_filter: str | None):
+    """将所有仓库切换到指定分支类型 (dev/test/prod)。"""
+    root = find_root()
+    configs = list(walk_monorepos(root, recursive=recursive))
+
+    for config in configs:
+        for repo in config.repos:
+            if path_filter and not repo.path.startswith(path_filter):
+                continue
+            target = config.root / repo.path
+            if not (target / ".git").exists():
+                continue
+            branch = repo.branches.get(branch_type)
+            if not branch:
+                console.print(f"  [yellow]跳过[/yellow] {repo.name}: 未配置 {branch_type} 分支")
+                continue
+            console.print(f"  [cyan]切换[/cyan] {repo.name} → {branch}")
+            result = checkout(target, branch)
+            if result.ok:
+                console.print(f"       [green]✓[/green]")
+            else:
+                console.print(f"       [red]✗ {result.error}[/red]")
+
+
+# ── monarbor init ────────────────────────────────────────────
+
+
+@main.command()
+@click.option("--name", prompt="大仓名称", help="逻辑大仓名称")
+@click.option("--owner", prompt="负责人", help="负责人")
+def init(name: str, owner: str):
+    """在当前目录初始化一个新的逻辑大仓。"""
+    config_path = Path.cwd() / CONFIG_FILENAME
+    if config_path.exists():
+        raise click.ClickException(f"{CONFIG_FILENAME} 已存在")
+
+    content = f"""name: "{name}"
+description: ""
+owner: {owner}
+
+repos: []
+"""
+    config_path.write_text(content, encoding="utf-8")
+    console.print(f"[green]✓[/green] 已创建 {CONFIG_FILENAME}")
+
+
+# ── monarbor add ─────────────────────────────────────────────
+
+
+@main.command()
+@click.option("--path", "repo_path", prompt="仓库路径 (如 business-a/frontend)", help="仓库在大仓中的相对路径")
+@click.option("--name", "repo_name", prompt="项目名称", help="项目显示名称")
+@click.option("--url", "repo_url", prompt="Git 仓库地址", help="Git 仓库 URL")
+@click.option("--dev-branch", default="develop", help="开发分支 (默认 develop)")
+@click.option("--test-branch", default="release/test", help="测试分支 (默认 release/test)")
+@click.option("--prod-branch", default="main", help="生产分支 (默认 main)")
+def add(repo_path: str, repo_name: str, repo_url: str, dev_branch: str, test_branch: str, prod_branch: str):
+    """向当前大仓添加一个仓库。"""
+    import yaml
+
+    root = find_root()
+    config_path = root / CONFIG_FILENAME
+    with open(config_path, "r", encoding="utf-8") as f:
+        data = yaml.safe_load(f)
+
+    repos = data.get("repos", [])
+    for r in repos:
+        if r.get("path") == repo_path:
+            raise click.ClickException(f"路径 {repo_path} 已存在于配置中")
+
+    new_repo = {
+        "path": repo_path,
+        "name": repo_name,
+        "repo_url": repo_url,
+        "branches": {
+            "dev": dev_branch,
+            "test": test_branch,
+            "prod": prod_branch,
+        },
+    }
+    repos.append(new_repo)
+    data["repos"] = repos
+
+    with open(config_path, "w", encoding="utf-8") as f:
+        yaml.dump(data, f, allow_unicode=True, default_flow_style=False, sort_keys=False)
+
+    console.print(f"[green]✓[/green] 已添加 {repo_name} ({repo_path})")
+
+
+if __name__ == "__main__":
+    main()

monarbor-0.1.0/monarbor/config.py

@@ -0,0 +1,91 @@
+"""mona.yaml 配置的加载与解析。"""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Iterator
+
+import yaml
+
+CONFIG_FILENAME = "mona.yaml"
+
+
+@dataclass
+class RepoDef:
+    """一个仓库的定义。"""
+
+    path: str
+    name: str
+    repo_url: str
+    description: str = ""
+    tech_stack: list[str] = field(default_factory=list)
+    branches: dict[str, str] = field(default_factory=dict)
+
+    @property
+    def dev_branch(self) -> str:
+        return self.branches.get("dev", "develop")
+
+    @property
+    def test_branch(self) -> str:
+        return self.branches.get("test", "release/test")
+
+    @property
+    def prod_branch(self) -> str:
+        return self.branches.get("prod", "main")
+
+
+@dataclass
+class MonorepoConfig:
+    """一个逻辑大仓的配置。"""
+
+    name: str
+    owner: str
+    root: Path
+    description: str = ""
+    repos: list[RepoDef] = field(default_factory=list)
+
+    @classmethod
+    def load(cls, root: Path) -> MonorepoConfig:
+        config_path = root / CONFIG_FILENAME
+        if not config_path.exists():
+            raise FileNotFoundError(f"未找到配置文件: {config_path}")
+        with open(config_path, "r", encoding="utf-8") as f:
+            data = yaml.safe_load(f)
+        repos = [RepoDef(**r) for r in data.get("repos", [])]
+        return cls(
+            name=data.get("name", ""),
+            owner=data.get("owner", ""),
+            description=data.get("description", ""),
+            root=root.resolve(),
+            repos=repos,
+        )
+
+
+def find_nested_monorepos(root: Path, exclude_paths: set[str] | None = None) -> list[Path]:
+    """扫描子目录，找到所有嵌套的逻辑大仓。"""
+    nested = []
+    exclude = exclude_paths or set()
+    for entry in sorted(root.iterdir()):
+        if not entry.is_dir() or entry.name.startswith("."):
+            continue
+        if entry.name in exclude:
+            continue
+        config = entry / CONFIG_FILENAME
+        if config.exists():
+            nested.append(entry)
+        else:
+            nested.extend(find_nested_monorepos(entry, exclude))
+    return nested
+
+
+def walk_monorepos(root: Path, recursive: bool = False) -> Iterator[MonorepoConfig]:
+    """遍历当前大仓，可选递归加载嵌套大仓。"""
+    config = MonorepoConfig.load(root)
+    yield config
+
+    if recursive:
+        repo_paths = {r.path.split("/")[0] for r in config.repos}
+        for nested_root in find_nested_monorepos(root, exclude_paths=repo_paths):
+            yield from walk_monorepos(nested_root, recursive=True)

monarbor-0.1.0/monarbor/git_ops.py

@@ -0,0 +1,98 @@
+"""Git 操作封装。"""
+
+from __future__ import annotations
+
+import subprocess
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass
+class GitResult:
+    ok: bool
+    output: str
+    error: str = ""
+
+
+def run_git(args: list[str], cwd: Path | None = None) -> GitResult:
+    try:
+        result = subprocess.run(
+            ["git", *args],
+            cwd=cwd,
+            capture_output=True,
+            text=True,
+            timeout=300,
+        )
+        return GitResult(
+            ok=result.returncode == 0,
+            output=result.stdout.strip(),
+            error=result.stderr.strip(),
+        )
+    except subprocess.TimeoutExpired:
+        return GitResult(ok=False, output="", error="操作超时 (300s)")
+    except FileNotFoundError:
+        return GitResult(ok=False, output="", error="未找到 git 命令，请确认已安装 git")
+
+
+def clone(repo_url: str, target: Path, branch: str | None = None) -> GitResult:
+    args = ["clone"]
+    if branch:
+        args.extend(["-b", branch])
+    args.extend([repo_url, str(target)])
+    return run_git(args)
+
+
+def pull(repo_path: Path) -> GitResult:
+    return run_git(["pull"], cwd=repo_path)
+
+
+def current_branch(repo_path: Path) -> str:
+    result = run_git(["rev-parse", "--abbrev-ref", "HEAD"], cwd=repo_path)
+    return result.output if result.ok else "(unknown)"
+
+
+def is_dirty(repo_path: Path) -> bool:
+    result = run_git(["status", "--porcelain"], cwd=repo_path)
+    return bool(result.output)
+
+
+def checkout(repo_path: Path, branch: str) -> GitResult:
+    return run_git(["checkout", branch], cwd=repo_path)
+
+
+def fetch(repo_path: Path) -> GitResult:
+    return run_git(["fetch", "--all", "--prune"], cwd=repo_path)
+
+
+def ahead_behind(repo_path: Path) -> tuple[int, int]:
+    """返回 (ahead, behind) 相对于上游的提交数。"""
+    result = run_git(
+        ["rev-list", "--left-right", "--count", "HEAD...@{upstream}"],
+        cwd=repo_path,
+    )
+    if not result.ok:
+        return (0, 0)
+    parts = result.output.split()
+    if len(parts) == 2:
+        return (int(parts[0]), int(parts[1]))
+    return (0, 0)
+
+
+def run_in_repo(repo_path: Path, command: str) -> GitResult:
+    """在仓库目录下执行任意 shell 命令。"""
+    try:
+        result = subprocess.run(
+            command,
+            cwd=repo_path,
+            capture_output=True,
+            text=True,
+            timeout=120,
+            shell=True,
+        )
+        return GitResult(
+            ok=result.returncode == 0,
+            output=result.stdout.strip(),
+            error=result.stderr.strip(),
+        )
+    except subprocess.TimeoutExpired:
+        return GitResult(ok=False, output="", error="命令超时 (120s)")

monarbor-0.1.0/monarbor.egg-info/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: monarbor
+Version: 0.1.0
+Summary: Monarbor - AI 友好的逻辑大仓命令行工具
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+
+# Monarbor
+
+AI 友好的逻辑大仓命令行工具。一个 `mona.yaml` 配置文件描述所有仓库，一套命令统一管理。
+
+## 安装
+
+```bash
+pip install monarbor
+```
+
+开发模式安装：
+
+```bash
+pip install -e .
+```
+
+## 快速开始
+
+```bash
+# 初始化一个逻辑大仓
+monarbor init
+
+# 添加仓库
+monarbor add --path business-a/frontend --name "前端项目" --url "https://git.example.com/org/frontend.git"
+
+# 拉取所有代码
+monarbor clone
+
+# 查看状态
+monarbor status
+```
+
+## 命令一览
+
+| 命令 | 说明 |
+|------|------|
+| `monarbor clone` | 拉取大仓下所有项目代码 |
+| `monarbor pull` | 更新所有已 clone 仓库的代码 |
+| `monarbor status` | 显示所有仓库的分支、改动、同步状态 |
+| `monarbor list` | 以树形结构列出所有仓库 |
+| `monarbor exec <cmd>` | 在所有仓库中执行命令 |
+| `monarbor checkout <dev\|test\|prod>` | 批量切换到指定分支类型 |
+| `monarbor init` | 初始化新的逻辑大仓 |
+| `monarbor add` | 向当前大仓添加仓库 |
+
+## 常用场景
+
+### 拉取所有代码
+
+```bash
+# 默认 clone dev 分支
+monarbor clone
+
+# clone 测试分支
+monarbor clone -b test
+
+# 递归 clone（包括嵌套的子逻辑大仓）
+monarbor clone -r
+
+# 只 clone 某个业务线
+monarbor clone --filter business-a
+```
+
+### 批量切换分支
+
+```bash
+# 全部切到测试分支
+monarbor checkout test
+
+# 全部切到生产分支
+monarbor checkout prod
+```
+
+### 批量执行命令
+
+```bash
+# 查看每个仓库最近 5 条提交
+monarbor exec "git log --oneline -5"
+
+# 全部安装依赖
+monarbor exec "npm install"
+
+# 只在某个业务线执行
+monarbor exec "pnpm build" --filter business-a
+```
+
+### 嵌套逻辑大仓
+
+当子目录下存在自己的 `mona.yaml` 时，带 `-r` 参数即可递归处理：
+
+```bash
+monarbor clone -r      # 递归 clone
+monarbor status -r     # 递归查看状态
+monarbor list -r       # 递归列出树形结构
+```
+
+## mona.yaml 格式
+
+```yaml
+name: "我的大仓"
+description: "大仓描述"
+owner: your-name
+
+repos:
+  - path: business-a/frontend
+    name: "前端项目"
+    repo_url: "https://git.example.com/org/frontend.git"
+    tech_stack: [typescript, react]
+    branches:
+      dev: develop
+      test: release/test
+      prod: main
+```
+
+## License
+
+MIT

monarbor-0.1.0/monarbor.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+.gitignore
+README.md
+pyproject.toml
+.github/workflows/publish.yml
+monarbor/__init__.py
+monarbor/cli.py
+monarbor/config.py
+monarbor/git_ops.py
+monarbor.egg-info/PKG-INFO
+monarbor.egg-info/SOURCES.txt
+monarbor.egg-info/dependency_links.txt
+monarbor.egg-info/entry_points.txt
+monarbor.egg-info/requires.txt
+monarbor.egg-info/top_level.txt

monarbor-0.1.0/monarbor.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

monarbor-0.1.0/monarbor.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+monarbor = monarbor.cli:main

monarbor-0.1.0/monarbor.egg-info/requires.txt

@@ -0,0 +1,3 @@
+click>=8.0
+pyyaml>=6.0
+rich>=13.0

monarbor-0.1.0/monarbor.egg-info/top_level.txt

@@ -0,0 +1 @@
+monarbor

monarbor-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=68.0", "setuptools-scm"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "monarbor"
+version = "0.1.0"
+description = "Monarbor - AI 友好的逻辑大仓命令行工具"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "click>=8.0",
+    "pyyaml>=6.0",
+    "rich>=13.0",
+]
+
+[project.scripts]
+monarbor = "monarbor.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["monarbor*"]

monarbor-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+