agent-confhub-cli 0.1.0__py3-none-any.whl

agent_confhub_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: agent-confhub-cli
+Version: 0.1.0
+Summary: AI 에이전트 설정 중앙 관리 CLI 프레임워크
+Requires-Python: >=3.10
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pre-commit>=3.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.9.0; extra == 'dev'

agent_confhub_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+nexus/__init__.py,sha256=4iQaH0qMlBPNJzsRQpypERULNrK4mAMdJ2276uBug8Q,94
+nexus/cli.py,sha256=zeipobflE-yOP8d8QSaJb543IkqmXovpVeyNyYjIWD0,3432
+nexus/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nexus/commands/agent.py,sha256=VEyYvYCtd3pnRMC87cRDPO-e-Thf4EEoLE0bsUTXGDM,11549
+nexus/commands/app.py,sha256=SbOI55I1RKyb-GACOqRnwA7QEAWx-wh-x2r2G0W6Uuc,7690
+nexus/commands/init.py,sha256=hh5YTOvxaeeUzh1NfUorGTHDxcYW4ij6WZcU-dqjzOY,5368
+nexus/commands/install.py,sha256=IoL-NtQBKeEWJ8IdUsOmBQXF_L12jiNyEEGNAUVS0gU,5177
+nexus/commands/link.py,sha256=g6EiriBflpFqTvjh3l1S3xdqa9OXc4tsT0UEIhrU6Ho,4885
+nexus/commands/resolve.py,sha256=HRbohWpQH4yAJbx2T9Y1ocfpy2V2kjW13hh5-Yc5o7w,4550
+nexus/commands/status.py,sha256=cHw9BIyrmg99rVGRpzRw1xaCi3KheXDb3DaWf6InHCY,4033
+nexus/commands/submodule.py,sha256=g7JvocO1ML_vNsUfVegUq7Wxe4R3mhk-iyYPHiRYWiE,12569
+nexus/commands/sync.py,sha256=5bXBE_OV5_WJ0b5vLNDhuBQuStK6FWqC4Jo2sdgIv6E,4350
+nexus/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nexus/core/agents.py,sha256=qCiy1Z4UFiWrOXWmrqovnQmijDp4ZCOVUGyNeAzEmkw,3222
+nexus/core/linker.py,sha256=Ep1EjVOJ5g1atUkWrtOPQjX2wc1Fih5CSX2AuEKBQmg,7350
+nexus/core/merger.py,sha256=6hyQ8LEk_U7eMvyzu68FHhbIqG9q_7Zu5UmRpuL0Mcg,7245
+nexus/core/registry.py,sha256=qrWdZO97ed_fOsVduH71Z5eLrmF-rclAecu9tjpuOnk,5191
+nexus/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nexus/utils/console.py,sha256=YI_MoKmzRrpICVM6Po1tc1yg2g0D9m3vur7_jj1EqSQ,1110
+nexus/utils/git.py,sha256=-Adeyoo3ol2UJuzHySsTtR8Y0BamZNexZ9SHOVcdIEc,3671
+agent_confhub_cli-0.1.0.dist-info/METADATA,sha256=PMXOcA0D1ogYMt1ffgictcL_wcMScRWwyFFiMbnUgWM,495
+agent_confhub_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+agent_confhub_cli-0.1.0.dist-info/entry_points.txt,sha256=xxn5ixCInjp86tT55MXem9N7gmJ78cSq0BZnVftcc1s,38
+agent_confhub_cli-0.1.0.dist-info/RECORD,,

agent_confhub_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

agent_confhub_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nxs = nexus.cli:app

nexus/__init__.py

@@ -0,0 +1,3 @@
+"""Nexus CLI - AI 에이전트 설정 중앙 관리 프레임워크"""
+
+__version__ = "0.1.0"

nexus/cli.py

@@ -0,0 +1,113 @@
+"""Nexus CLI - 진입점 모듈"""
+
+from pathlib import Path
+
+import typer
+
+from nexus import __version__
+from nexus.commands import agent as agent_cmd
+from nexus.commands import app as app_cmd
+from nexus.commands.link import link_app
+from nexus.commands.submodule import submodule_app
+from nexus.commands.sync import sync_app
+
+app = typer.Typer(
+    name="nxs",
+    help="Nexus CLI - AI 에이전트 설정 관리",
+    add_completion=False,
+)
+
+app.add_typer(app_cmd.app, name="app")
+app.add_typer(agent_cmd.app, name="agent")
+app.add_typer(link_app, name="link")
+app.add_typer(submodule_app, name="submodule")
+app.add_typer(sync_app, name="sync")
+
+
+def version_callback(value: bool):
+    """버전 정보 출력 콜백"""
+    if value:
+        typer.echo(f"nexus-cli version: {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    version: bool | None = typer.Option(
+        None,
+        "--version",
+        "-v",
+        help="현재 버전을 출력합니다.",
+        callback=version_callback,
+        is_eager=True,
+    ),
+):
+    """Nexus CLI - AI 에이전트 설정 중앙 관리 프레임워크"""
+
+
+@app.command("init")
+def init_command(
+    path: Path | None = typer.Option(None, "--path", "-p", help="Registry 경로"),
+    from_repo: str | None = typer.Option(None, "--from-repo", help="Git 레포 URL에서 초기화"),
+):
+    """Nexus Registry를 초기화합니다."""
+    from nexus.commands.init import do_init
+
+    do_init(path, from_repo)
+
+
+@app.command("resolve")
+def resolve_command(
+    app_name: str | None = typer.Argument(None, help="앱 이름 (생략시 --all 필요)"),
+    all_apps: bool = typer.Option(False, "--all", "-a", help="모든 앱 빌드"),
+    dry_run: bool = typer.Option(False, "--dry-run", help="결과 미리보기 (파일 미생성)"),
+):
+    """설정을 병합하여 resolved 디렉토리에 저장합니다."""
+    from nexus.commands.resolve import do_resolve
+
+    do_resolve(app_name, all_apps, dry_run)
+
+
+@app.command("unlink")
+def unlink_command(
+    app_name: str = typer.Argument(..., help="앱 이름"),
+    target: Path | None = typer.Option(
+        None, "--target", "-t", help="링크 해제할 프로젝트 경로 (기본: 현재 디렉토리)"
+    ),
+    agent: str | None = typer.Option(
+        None, "--agent", help="특정 에이전트만 해제 (쉼표 구분: claude,gemini)"
+    ),
+):
+    """프로젝트의 심볼릭 링크를 해제합니다."""
+    from nexus.commands.link import do_unlink
+
+    do_unlink(app_name, target, agent)
+
+
+@app.command("status")
+def status_command(
+    app_name: str | None = typer.Option(None, "--app", help="특정 앱 이름"),
+    with_links: bool = typer.Option(False, "--with-links", help="링크 상태 포함"),
+):
+    """Registry 상태를 표시합니다."""
+    from nexus.commands.status import do_status
+
+    do_status(app_name, with_links)
+
+
+@app.command("install")
+def install_command(
+    from_repo: str | None = typer.Option(None, "--from-repo", help="Git 레포 URL에서 설치"),
+    verify: bool = typer.Option(False, "--verify", help="설치 상태 확인"),
+    apps: str | None = typer.Option(
+        None, "--apps", help="특정 앱만 설치 (쉼표 구분: web-frontend,api-server)"
+    ),
+):
+    """Git 레포에서 Registry를 설치합니다."""
+    from nexus.commands.install import do_install
+
+    do_install(from_repo, verify, apps)
+
+
+if __name__ == "__main__":
+    app()

nexus/commands/agent.py

@@ -0,0 +1,325 @@
+"""nxs agent 명령어 - 에이전트 설정 관리"""
+
+import shutil
+from pathlib import Path
+
+import typer
+import yaml
+from rich.panel import Panel
+from rich.syntax import Syntax
+
+from nexus.core.agents import get_agent
+from nexus.core.registry import Registry, RegistryNotFoundError
+from nexus.utils.console import (
+    console,
+    make_table,
+    print_error,
+    print_info,
+    print_success,
+    print_warning,
+)
+
+app = typer.Typer(help="에이전트 설정 관리")
+
+
+# ── 에이전트 config.yaml 템플릿 ────────────────────────────────────────────────
+
+
+def _build_agent_config(agent_id: str, scope: str) -> dict:
+    """agent.config.yaml 템플릿 생성"""
+    agent = get_agent(agent_id)
+    merge_dict = {}
+    for filename in agent.default_files:
+        base = Path(filename).name
+        if base.endswith(".md"):
+            merge_dict[base] = "append"
+        elif base.endswith(".json"):
+            merge_dict[base] = "deep-merge"
+        else:
+            merge_dict[base] = "overwrite"
+
+    return {
+        "agent": agent_id,
+        "version": "1.0.0",
+        "scope": scope,
+        "merge": merge_dict,
+    }
+
+
+# ── 유틸리티 ───────────────────────────────────────────────────────────────────
+
+
+def _get_registry() -> Registry:
+    """기본 Registry를 반환하고, 초기화 여부를 확인한다."""
+    registry = Registry.get_default()
+    registry.require_initialized()
+    return registry
+
+
+def _resolve_scope_and_dir(
+    registry: Registry,
+    agent_id: str,
+    app_name: str | None,
+    root: bool,
+) -> tuple[str, Path]:
+    """(scope, agent_dir) 튜플 반환. 유효성 검사도 포함."""
+    if root and app_name:
+        print_error("--root 와 --app 옵션을 동시에 사용할 수 없습니다.")
+        raise typer.Exit(1)
+    if not root and not app_name:
+        print_error("--app <앱이름> 또는 --root 중 하나를 지정해야 합니다.")
+        raise typer.Exit(1)
+
+    if root:
+        scope = "root"
+        agent_dir = registry.get_root_agent_path(agent_id)
+    else:
+        assert app_name is not None
+        if not registry.app_exists(app_name):
+            print_error(f"앱 '{app_name}'을(를) 찾을 수 없습니다. (not found)")
+            raise typer.Exit(1)
+        scope = "app"
+        agent_dir = registry.get_app_agent_path(app_name, agent_id)
+
+    return scope, agent_dir
+
+
+# ── 명령어 ─────────────────────────────────────────────────────────────────────
+
+
+@app.command("add")
+def agent_add(
+    agent_id: str = typer.Argument(
+        ..., help="에이전트 식별자 (claude, gemini, codex, cursor, copilot)"
+    ),
+    app_name: str | None = typer.Option(None, "--app", "-a", help="앱 이름"),
+    root: bool = typer.Option(False, "--root", "-r", help="루트 레벨에 추가"),
+):
+    """에이전트 설정을 추가합니다."""
+    try:
+        registry = _get_registry()
+    except RegistryNotFoundError as exc:
+        print_error(str(exc))
+        raise typer.Exit(1)
+
+    # 에이전트 유효성 검사
+    try:
+        agent_cfg = get_agent(agent_id)
+    except ValueError as exc:
+        print_error(str(exc))
+        raise typer.Exit(1)
+
+    # 스코프 결정
+    try:
+        scope, agent_dir = _resolve_scope_and_dir(registry, agent_id, app_name, root)
+    except typer.Exit:
+        raise
+
+    # 이미 존재 여부 확인
+    if (agent_dir / "agent.config.yaml").exists():
+        print_warning(f"에이전트 '{agent_id}' 설정이 이미 존재합니다. ({agent_dir})")
+        raise typer.Exit(1)
+
+    try:
+        # 디렉토리 생성
+        agent_dir.mkdir(parents=True, exist_ok=True)
+
+        # agent.config.yaml 생성
+        config = _build_agent_config(agent_id, scope)
+        with open(agent_dir / "agent.config.yaml", "w", encoding="utf-8") as f:
+            yaml.dump(config, f, default_flow_style=False, allow_unicode=True, sort_keys=False)
+
+        # 기본 파일들 생성
+        for rel_path, content in agent_cfg.default_files.items():
+            file_path = agent_dir / rel_path
+            file_path.parent.mkdir(parents=True, exist_ok=True)
+            file_path.write_text(content, encoding="utf-8")
+
+        # app scope이면 app.config.yaml의 agents 리스트에 추가
+        if scope == "app" and app_name:
+            app_config = registry.load_app_config(app_name)
+            agents_list = app_config.get("agents", [])
+            if agent_id not in agents_list:
+                agents_list.append(agent_id)
+                app_config["agents"] = agents_list
+                registry.save_app_config(app_name, app_config)
+
+        print_success(f"에이전트 '{agent_id}' ({agent_cfg.display_name}) 추가 완료")
+
+    except OSError as exc:
+        print_error(f"파일 시스템 오류: {exc}")
+        raise typer.Exit(1)
+
+
+@app.command("list")
+def agent_list(
+    app_name: str | None = typer.Option(None, "--app", "-a", help="앱 이름"),
+    root: bool = typer.Option(False, "--root", "-r", help="루트 레벨 목록"),
+):
+    """에이전트 목록을 표시합니다."""
+    try:
+        registry = _get_registry()
+    except RegistryNotFoundError as exc:
+        print_error(str(exc))
+        raise typer.Exit(1)
+
+    if root and app_name:
+        print_error("--root 와 --app 옵션을 동시에 사용할 수 없습니다.")
+        raise typer.Exit(1)
+    if not root and not app_name:
+        print_error("--app <앱이름> 또는 --root 중 하나를 지정해야 합니다.")
+        raise typer.Exit(1)
+
+    if root:
+        scope_label = "루트"
+        agents_base = registry.root_agents_path
+    else:
+        assert app_name is not None
+        if not registry.app_exists(app_name):
+            print_error(f"앱 '{app_name}'을(를) 찾을 수 없습니다. (not found)")
+            raise typer.Exit(1)
+        scope_label = f"앱: {app_name}"
+        agents_base = registry.get_app_path(app_name) / "agents"
+
+    if not agents_base.exists():
+        print_info(f"등록된 에이전트가 없습니다. ({scope_label})")
+        return
+
+    found_agents = []
+    for agent_dir in sorted(agents_base.iterdir()):
+        if agent_dir.is_dir() and (agent_dir / "agent.config.yaml").exists():
+            found_agents.append(agent_dir.name)
+
+    if not found_agents:
+        print_info(f"등록된 에이전트가 없습니다. ({scope_label})")
+        return
+
+    table = make_table(f"에이전트 목록 ({scope_label})", ["Agent", "Display Name", "Files"])
+
+    for agent_id in found_agents:
+        try:
+            agent_cfg = get_agent(agent_id)
+            display_name = agent_cfg.display_name
+        except ValueError:
+            display_name = "(알 수 없음)"
+
+        agent_dir = agents_base / agent_id
+        actual_files = []
+        for item in sorted(agent_dir.rglob("*")):
+            if item.is_file() and item.name != "agent.config.yaml":
+                actual_files.append(item.relative_to(agent_dir).as_posix())
+        files_str = ", ".join(actual_files) if actual_files else "-"
+        table.add_row(agent_id, display_name, files_str)
+
+    console.print(table)
+
+
+@app.command("show")
+def agent_show(
+    agent_id: str = typer.Argument(..., help="에이전트 식별자"),
+    app_name: str | None = typer.Option(None, "--app", "-a", help="앱 이름"),
+    root: bool = typer.Option(False, "--root", "-r", help="루트 레벨"),
+    resolved: bool = typer.Option(False, "--resolved", help="상속 병합 후 최종값 조회"),
+):
+    """에이전트 설정을 표시합니다."""
+    try:
+        registry = _get_registry()
+    except RegistryNotFoundError as exc:
+        print_error(str(exc))
+        raise typer.Exit(1)
+
+    if resolved:
+        print_info("--resolved 옵션은 Phase 5에서 지원 예정입니다.")
+        raise typer.Exit(0)
+
+    # 에이전트 유효성 검사
+    try:
+        agent_cfg = get_agent(agent_id)
+    except ValueError as exc:
+        print_error(str(exc))
+        raise typer.Exit(1)
+
+    try:
+        scope, agent_dir = _resolve_scope_and_dir(registry, agent_id, app_name, root)
+    except typer.Exit:
+        raise
+
+    if not (agent_dir / "agent.config.yaml").exists():
+        print_error(f"에이전트 '{agent_id}' 설정을 찾을 수 없습니다. ({agent_dir})")
+        raise typer.Exit(1)
+
+    # agent.config.yaml 내용 표시
+    config_content = (agent_dir / "agent.config.yaml").read_text(encoding="utf-8")
+    syntax = Syntax(config_content, "yaml", theme="monokai", line_numbers=True)
+    console.print(
+        Panel(syntax, title=f"에이전트: {agent_id} ({agent_cfg.display_name})", style="blue")
+    )
+
+    # 기본 파일들도 표시
+    for rel_path in agent_cfg.default_files:
+        file_path = agent_dir / rel_path
+        if file_path.exists():
+            content = file_path.read_text(encoding="utf-8")
+            ext = Path(rel_path).suffix.lstrip(".") or "text"
+            lang_map = {"md": "markdown", "json": "json", "yaml": "yaml", "yml": "yaml"}
+            lang = lang_map.get(ext, "text")
+            file_syntax = Syntax(content, lang, theme="monokai", line_numbers=True)
+            console.print(Panel(file_syntax, title=f"파일: {rel_path}", style="cyan"))
+
+
+@app.command("remove")
+def agent_remove(
+    agent_id: str = typer.Argument(..., help="에이전트 식별자"),
+    app_name: str | None = typer.Option(None, "--app", "-a", help="앱 이름"),
+    root: bool = typer.Option(False, "--root", "-r", help="루트 레벨"),
+    force: bool = typer.Option(False, "--force", "-f", help="확인 없이 삭제"),
+):
+    """에이전트 설정을 삭제합니다."""
+    try:
+        registry = _get_registry()
+    except RegistryNotFoundError as exc:
+        print_error(str(exc))
+        raise typer.Exit(1)
+
+    # 에이전트 유효성 검사
+    try:
+        get_agent(agent_id)
+    except ValueError as exc:
+        print_error(str(exc))
+        raise typer.Exit(1)
+
+    try:
+        scope, agent_dir = _resolve_scope_and_dir(registry, agent_id, app_name, root)
+    except typer.Exit:
+        raise
+
+    if not agent_dir.exists():
+        print_error(f"에이전트 '{agent_id}' 설정을 찾을 수 없습니다. ({agent_dir})")
+        raise typer.Exit(1)
+
+    if not force:
+        confirmed = typer.confirm(f"에이전트 '{agent_id}' 설정을 삭제하시겠습니까?")
+        if not confirmed:
+            print_info("삭제가 취소되었습니다.")
+            raise typer.Exit(0)
+
+    try:
+        shutil.rmtree(agent_dir)
+
+        # app scope이면 app.config.yaml의 agents 리스트에서 제거
+        if scope == "app" and app_name:
+            try:
+                app_config = registry.load_app_config(app_name)
+                agents_list = app_config.get("agents", [])
+                if agent_id in agents_list:
+                    agents_list.remove(agent_id)
+                    app_config["agents"] = agents_list
+                    registry.save_app_config(app_name, app_config)
+            except FileNotFoundError:
+                pass
+
+        print_success(f"에이전트 '{agent_id}' 설정 삭제 완료")
+
+    except OSError as exc:
+        print_error(f"파일 시스템 오류: {exc}")
+        raise typer.Exit(1)