leetkit-manager 0.1.1__tar.gz

leetkit_manager-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,153 @@
+name: Release
+
+# 태그 푸시(v*) 시 자동:
+# 1. Python 빌드 (wheel + sdist) — Ubuntu
+# 2. 독립 실행 Windows exe 빌드(LeetKitManager.exe) — Windows 러너(PyInstaller는
+#    빌드하는 OS의 실행 파일만 만들 수 있어서 이 작업만 별도 러너가 필요하다)
+# 3. PyPI 업로드 + GitHub Release 생성(wheel/tar.gz/exe 전부 첨부)
+
+on:
+  push:
+    tags:
+      - 'v*'  # v0.1.0, v0.2.0 등
+
+jobs:
+  build-wheel:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Verify version matches tag
+        run: |
+          TAG_VER="${GITHUB_REF_NAME#v}"
+          PKG_VER=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          if [ "$TAG_VER" != "$PKG_VER" ]; then
+            echo "::error::Tag version ($TAG_VER) does not match pyproject.toml version ($PKG_VER)"
+            exit 1
+          fi
+          echo "Version OK: $PKG_VER"
+
+      - name: Build distribution
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Verify distribution
+        run: |
+          python -m pip install --upgrade twine
+          twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheel-dist
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+
+  build-exe:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build dependencies
+        run: python -m pip install -e ".[build]"
+
+      # 구매자에게 "exe 하나만 받으면 끝"을 실제로 제공하는 핵심 산출물 — 지금까지는
+      # 이 작업 자체가 워크플로에 없어서 GitHub Release에 exe가 절대 안 올라갔다.
+      - name: Build standalone exe
+        shell: pwsh
+        run: .\packaging\build_exe.ps1
+
+      # 자체 업데이트는 실행 중인 exe를 통째로 교체한다 — 받은 파일이 여기서 빌드된
+      # 그 파일이 맞는지 앱이 대조할 수 있게 체크섬을 같이 올린다(package_service의
+      # fetch_expected_sha256/sha256_of_file이 이 파일을 읽는다).
+      - name: Write exe checksum
+        shell: pwsh
+        run: |
+          $hash = (Get-FileHash dist_exe\LeetKitManager.exe -Algorithm SHA256).Hash.ToLower()
+          "$hash  LeetKitManager.exe" | Out-File -FilePath dist_exe\LeetKitManager.exe.sha256 -Encoding ascii -NoNewline
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: windows-exe
+          path: |
+            dist_exe/LeetKitManager.exe
+            dist_exe/LeetKitManager.exe.sha256
+
+  release:
+    needs: [build-wheel, build-exe]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write  # GitHub Release 생성용
+      id-token: write  # PyPI Trusted Publishing (OIDC) 용
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheel-dist
+          path: dist
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: windows-exe
+          path: dist_exe
+
+      # Trusted Publishing (OIDC) — PyPI에 등록된 publisher가 자동 인증
+      # https://docs.pypi.org/trusted-publishers/
+      # 설정: PyPI > Account > Publishing > Add pending publisher
+      #   Project: leetkit-manager / Owner: Johnhyeon / Repo: leetkit-manager
+      #   Workflow: release.yml / Environment: (비워둠)
+      # PyPI 업로드가 실패해도(예: pending publisher 미등록, 이미 올라간 버전) 아래
+      # GitHub Release는 반드시 만들어져야 한다 — 구매자가 실제로 받는 건 거기 붙는
+      # exe이고, PyPI는 명령줄 사용자용 부가 경로다. 실패는 워크플로에 경고로 남는다.
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1
+        continue-on-error: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+            dist_exe/LeetKitManager.exe
+            dist_exe/LeetKitManager.exe.sha256
+          generate_release_notes: true
+          body: |
+            > StockLens/DartLens/TelegramLens 설치·진단·업데이트를 한 창에서. 별도 라이선스 키 없이 무료로 씁니다.
+
+            ---
+
+            ## 📥 설치
+
+            **Windows · 명령줄이 익숙하지 않다면** — 아래 `LeetKitManager.exe`를 받아 더블클릭하면 바로 실행됩니다. Lens 설치·업데이트에 필요한 `uv`가 없으면 자동으로 설치합니다.
+
+            **macOS** — 현재 전용 앱이 없어 명령줄로 설치합니다.
+            ```
+            uv tool install leetkit-manager
+            leetkit-manager gui
+            ```
+
+            **Windows에서도 명령줄이 편하다면**
+            ```
+            uv tool install leetkit-manager
+            ```
+
+            > **처음 실행할 때 경고가 뜰 수 있습니다.** 서명 안 된 프로그램이라 그렇습니다.
+            > - SmartScreen: "추가 정보" → "실행"
+            > - 백신이 차단하는 경우: 오탐입니다. 예외 등록 방법은 [백신 안내](https://github.com/Johnhyeon/leetkit-manager/blob/main/packaging/ANTIVIRUS_GUIDE.md) 참고
+            > - 파일이 맞는지 확인하려면 위 `LeetKitManager.exe.sha256`의 값과 대조하세요
+
+            ## 📚 링크
+            - [stocklens-mcp](https://github.com/Johnhyeon/stocklens-mcp)
+            - [dartlens-mcp](https://github.com/Johnhyeon/dartlens-mcp)
+            - [telegramlens-mcp](https://github.com/Johnhyeon/telegramlens-mcp)

leetkit_manager-0.1.1/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+dist/
+build/
+dist_exe/
+build_exe/
+*.spec
+.env

leetkit_manager-0.1.1/LICENSE

@@ -0,0 +1,24 @@
+LeetKit Manager 라이선스 (Proprietary License)
+Copyright (c) 2026 Johnhyeon. All rights reserved.
+
+본 소프트웨어(LeetKit Manager, 이하 "소프트웨어")는 저작권자 Johnhyeon의 독점
+저작물입니다. 오픈소스가 아니며, 아래 조건으로 누구나 사용할 수 있습니다
+(StockLens/DartLens/TelegramLens와 달리 별도의 라이선스 키가 필요하지 않습니다).
+
+1. 사용 허가
+   - 누구나 소프트웨어를 설치·실행할 수 있습니다.
+
+2. 금지 사항
+   - 소프트웨어의 전부 또는 일부를 재배포, 재판매, 대여, 양도, 공개 게시하는 행위.
+   - 소프트웨어를 기반으로 한 2차적 저작물을 제작·배포하는 행위.
+
+3. 권리 유보
+   - 본 라이선스에 명시적으로 부여되지 않은 모든 권리는 저작권자에게 유보됩니다.
+
+4. 보증 부인 및 책임 제한
+   - 소프트웨어는 "있는 그대로(AS IS)" 제공되며, 명시적이든 묵시적이든 어떠한
+     보증도 하지 않습니다.
+   - 저작권자는 소프트웨어의 사용 또는 사용 불능으로 인한 어떠한 손해에 대해서도
+     책임지지 않습니다.
+
+문의: 저작권자(Johnhyeon)

leetkit_manager-0.1.1/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: leetkit-manager
+Version: 0.1.1
+Summary: StockLens/DartLens/TelegramLens 통합 설치·진단·업데이트 Manager
+Project-URL: Homepage, https://github.com/Johnhyeon/leetkit-manager
+Project-URL: Repository, https://github.com/Johnhyeon/leetkit-manager
+Project-URL: Issues, https://github.com/Johnhyeon/leetkit-manager/issues
+Author: Johnhyeon
+License: Proprietary
+License-File: LICENSE
+Keywords: claude,dartlens,manager,mcp,stocklens,telegramlens
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: Other/Proprietary License
+Classifier: Natural Language :: Korean
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: psutil>=5.9
+Requires-Dist: pywebview>=5.0
+Requires-Dist: pywin32>=306; sys_platform == 'win32'
+Provides-Extra: build
+Requires-Dist: pyinstaller>=6.0; extra == 'build'
+Description-Content-Type: text/markdown
+
+# LeetKit Manager
+
+**StockLens · DartLens · TelegramLens 통합 진단·설치·업데이트 도구**
+
+세 Lens를 하나씩 터미널 명령으로 관리하는 대신, 창 하나에서 상태를 보고 고치는
+무료 데스크톱 앱입니다. Lens 자체(라이선스 키가 필요한 유료 상품)는 별매이며,
+이 도구는 그 설치·진단·업데이트 과정을 도와주는 companion 앱입니다.
+
+## 할 수 있는 것
+
+- **진단** — 세 Lens 모두 설치 여부·버전·MCP 등록 상태·라이선스 상태를 한 화면에서 확인
+- **MCP 등록** — Claude Desktop/Claude Code에 자동 등록
+- **활성화** — 라이선스 키 입력(창을 벗어나지 않고 붙여넣기)
+- **복구** — 각 Lens가 스스로 안전하다고 판단한 문제만 자동으로 고침(라이선스·세션·수집 데이터는 건드리지 않음)
+- **설치/업데이트** — PyPI 최신 버전으로 설치, 실패 시 이전 버전으로 롤백 명령 안내
+- **지원 문의** — 로그를 안전 목록만 모아 zip으로 만들고, 메일 받는사람/제목/내용을 복사해서 어떤 메일 앱에든 붙여넣기
+- **자기 자신 업데이트** — LeetKit Manager 새 버전이 있으면 상단에 업데이트 버튼이 나타남
+
+## 설치
+
+```
+uv tool install leetkit-manager
+leetkit-manager
+```
+
+인자 없이 실행하면 대시보드 창이 뜹니다. 최초 실행 시 바탕화면에 바로가기가
+자동으로 만들어져서, 다음부터는 명령어 없이 아이콘 더블클릭으로 켤 수 있습니다.
+
+### 독립 실행 exe (명령어 없이 배포)
+
+컴퓨터·명령줄에 익숙하지 않은 사용자에게는 `uv tool install` 대신 exe 파일
+하나를 바로 건넬 수도 있습니다. Python/uv 설치 여부와 무관하게 더블클릭으로
+바로 실행됩니다.
+
+```
+pip install -e ".[build]"
+powershell -File packaging\build_exe.ps1
+```
+
+`dist_exe\LeetKitManager.exe` 하나가 나옵니다. 서명되지 않은 exe라 스마트스크린
+경고가 뜰 수 있으니, 실제 배포 전에는 코드사이닝 인증서 적용을 검토하세요.
+
+## 요구 사항
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/) — Lens 설치·업데이트에 사용
+- Windows (현재 1차 지원 플랫폼)
+
+## 라이선스
+
+[LICENSE](LICENSE) 참고 — 별도 키 없이 누구나 설치·실행 가능하지만, 재배포·2차
+저작물 제작은 금지됩니다.

leetkit_manager-0.1.1/README.md

@@ -0,0 +1,52 @@
+# LeetKit Manager
+
+**StockLens · DartLens · TelegramLens 통합 진단·설치·업데이트 도구**
+
+세 Lens를 하나씩 터미널 명령으로 관리하는 대신, 창 하나에서 상태를 보고 고치는
+무료 데스크톱 앱입니다. Lens 자체(라이선스 키가 필요한 유료 상품)는 별매이며,
+이 도구는 그 설치·진단·업데이트 과정을 도와주는 companion 앱입니다.
+
+## 할 수 있는 것
+
+- **진단** — 세 Lens 모두 설치 여부·버전·MCP 등록 상태·라이선스 상태를 한 화면에서 확인
+- **MCP 등록** — Claude Desktop/Claude Code에 자동 등록
+- **활성화** — 라이선스 키 입력(창을 벗어나지 않고 붙여넣기)
+- **복구** — 각 Lens가 스스로 안전하다고 판단한 문제만 자동으로 고침(라이선스·세션·수집 데이터는 건드리지 않음)
+- **설치/업데이트** — PyPI 최신 버전으로 설치, 실패 시 이전 버전으로 롤백 명령 안내
+- **지원 문의** — 로그를 안전 목록만 모아 zip으로 만들고, 메일 받는사람/제목/내용을 복사해서 어떤 메일 앱에든 붙여넣기
+- **자기 자신 업데이트** — LeetKit Manager 새 버전이 있으면 상단에 업데이트 버튼이 나타남
+
+## 설치
+
+```
+uv tool install leetkit-manager
+leetkit-manager
+```
+
+인자 없이 실행하면 대시보드 창이 뜹니다. 최초 실행 시 바탕화면에 바로가기가
+자동으로 만들어져서, 다음부터는 명령어 없이 아이콘 더블클릭으로 켤 수 있습니다.
+
+### 독립 실행 exe (명령어 없이 배포)
+
+컴퓨터·명령줄에 익숙하지 않은 사용자에게는 `uv tool install` 대신 exe 파일
+하나를 바로 건넬 수도 있습니다. Python/uv 설치 여부와 무관하게 더블클릭으로
+바로 실행됩니다.
+
+```
+pip install -e ".[build]"
+powershell -File packaging\build_exe.ps1
+```
+
+`dist_exe\LeetKitManager.exe` 하나가 나옵니다. 서명되지 않은 exe라 스마트스크린
+경고가 뜰 수 있으니, 실제 배포 전에는 코드사이닝 인증서 적용을 검토하세요.
+
+## 요구 사항
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/) — Lens 설치·업데이트에 사용
+- Windows (현재 1차 지원 플랫폼)
+
+## 라이선스
+
+[LICENSE](LICENSE) 참고 — 별도 키 없이 누구나 설치·실행 가능하지만, 재배포·2차
+저작물 제작은 금지됩니다.

leetkit_manager-0.1.1/dev/demo_stub.py

@@ -0,0 +1,92 @@
+"""온보딩 마법사(및 전체 GUI)를 "방금 산 컴퓨터" 상태로 눈으로 확인하기 위한 개발용 실행기.
+
+새 Windows 계정이나 VM을 따로 만드는 대신, HOME만 임시 폴더로 돌려서 격리한다
+(USERPROFILE/HOME/APPDATA 환경변수) — `~/.leetkit-manager`, webview localStorage,
+`~/.claude.json`/`%APPDATA%/Claude/...`/`~/.codex/config.toml` 전부 이 프로세스 안에서만
+격리된 새 경로를 보고, 실제 계정의 어떤 파일도 안 건드린다.
+
+주의: 이 격리는 파일 기반 경로에만 적용된다. DartLens의 DART API 키처럼 OS 키체인
+(Windows Credential Manager 등, `keyring` 라이브러리)에 저장되는 자격증명은 HOME과
+무관하게 Windows 로그인 계정 단위로 공유된다 — 이 데모에서 API 키 등록을 실제로
+끝까지 진행하면 실제 프로덕션 키를 덮어쓸 수 있다는 뜻이다. 라이선스 키는 파일
+기반이라 격리되지만, API 키 등록 단계는 이 사실을 알고(가짜 키만 넣어 실패 경로만
+확인하거나, 실제 키로 덮어써도 상관없다고 판단한 경우에만) 진행할 것.
+
+Lens 설치는 PyPI가 아니라 이 리포의 형제 디렉터리(D:/project/stocklens/mcp,
+mcp-dart, telegramlens)에서 직접 uv tool install한다 — 지금 세션에서 만든
+Codex 타겟·텔레그램 로그인 스테퍼 같은 기능은 아직 PyPI에 배포 전이라, PyPI 최신
+버전만 받으면 이 기능들이 전혀 동작하지 않는 걸 그대로 보게 된다(실제로 처음
+버전에서 "호환되지 않는 Lens 버전"/"setup 응답을 파싱할 수 없습니다 (exit=2)"로
+드러난 문제 — Manager 버그가 아니라 Lens 쪽 배포 지연이었다). 로컬 소스로 설치하면
+지금 작업 중인 코드까지 포함해서 실제 배포될 물건과 동일하게 검증할 수 있다.
+
+- 라이선스/DART API 키 입력은 실제 activate/setup 바이너리가 검증한다 — 가짜 키를 넣으면
+  실제 실패 메시지가, 진짜 보유한 키를 넣으면 실제 성공이 뜬다.
+- 텔레그램 로그인도 실제 `telegramlens-login --stepper`가 뜬다 — my.telegram.org에서 받은
+  진짜 API_ID/HASH와 실제 전화번호·SMS 코드가 있어야 완주된다(없으면 중간에 취소하고
+  화면만 확인하면 됨).
+
+uv가 이 컴퓨터에 없으면 설치 과정에서 공식 설치 스크립트로 자동 부트스트랩된다(실제
+신규 구매자와 동일한 경로 — package_service.ensure_uv_available 참고).
+
+실행: `python dev/demo_stub.py` (leetkit-manager 리포 루트에서)
+배포용 leetkit-manager 패키지에는 포함되지 않는다(pyproject.toml의 wheel 대상이
+`leetkit_manager` 패키지 하나뿐이므로 dev/ 는 자동으로 제외됨).
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+import tempfile
+from pathlib import Path
+from unittest.mock import patch
+
+if sys.stdout.encoding and sys.stdout.encoding.lower() != "utf-8":
+    sys.stdout.reconfigure(encoding="utf-8")
+
+_DEMO_HOME = tempfile.mkdtemp(prefix="leetkit-demo-home-")
+os.environ["USERPROFILE"] = _DEMO_HOME
+os.environ["HOME"] = _DEMO_HOME
+os.environ["APPDATA"] = os.path.join(_DEMO_HOME, "AppData", "Roaming")
+os.makedirs(os.environ["APPDATA"], exist_ok=True)
+print(f"[demo_stub] 격리된 가짜 HOME: {_DEMO_HOME}")
+print("[demo_stub] uv 설치/라이선스 검증은 전부 실제로 동작합니다 — 네트워크 필요, 설치에 시간이 걸립니다.")
+print("[demo_stub] 주의: DartLens DART API 키는 OS 키체인에 저장되어 HOME 격리를 안 받습니다 (실제 계정과 공유).")
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+
+_REPO_ROOT = Path(__file__).parent.parent
+_LOCAL_LENS_PATHS = {
+    "stocklens-mcp": _REPO_ROOT.parent / "mcp",
+    "dartlens-mcp": _REPO_ROOT.parent / "mcp-dart",
+    "telegramlens-mcp": _REPO_ROOT.parent / "telegramlens",
+}
+
+
+def _install_from_local_repo(package_name: str, _version: str, *, timeout=None):
+    """package_service.install_version 대신 — PyPI가 아니라 형제 리포 소스에서 설치해
+    이 세션에서 아직 배포 안 한 변경사항(Codex 타겟, 텔레그램 로그인 스테퍼 등)까지
+    포함해서 검증한다. _version은 로컬 설치엔 의미가 없어 무시(실제 버전은 각 리포
+    pyproject.toml이 결정)."""
+    from leetkit_manager import package_service
+
+    local_path = _LOCAL_LENS_PATHS.get(package_name)
+    if local_path is None or not local_path.exists():
+        return package_service.install_version(package_name, _version, timeout=timeout or 120.0)
+    return package_service.run_cli(
+        ["uv", "tool", "install", "--force", str(local_path)],
+        timeout=timeout or 120.0,
+    )
+
+
+def main() -> None:
+    from leetkit_manager import package_service
+    from leetkit_manager.ui import app
+
+    with patch.object(package_service, "install_version", side_effect=_install_from_local_repo):
+        app.run()
+
+
+if __name__ == "__main__":
+    main()

leetkit_manager-0.1.1/leetkit_manager/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

leetkit_manager-0.1.1/leetkit_manager/cli.py

@@ -0,0 +1,91 @@
+"""LeetKit Manager CLI 진입점.
+
+    leetkit-manager                        데스크톱 대시보드(pywebview) 실행 — 기본 동작
+    leetkit-manager gui                    위와 동일(명시적으로)
+    leetkit-manager diagnose [--online]   전체 진단 대시보드(텍스트)
+    leetkit-manager check-updates          세 Lens 최신 버전 조회
+
+인자 없이 실행(바탕화면 바로가기 더블클릭 포함)하면 gui로 간다 — 설치 후에는 터미널
+명령을 몰라도 아이콘만 누르면 되게 하기 위함(uv tool install이 만드는 leetkit-manager.exe
+자체가 이미 실행 파일이라 별도 빌드 없이 바로가기만 놓으면 된다. shortcut.py 참고).
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from leetkit_manager import orchestrator
+from leetkit_manager.lens_contract import LENSES
+
+
+def _cmd_diagnose(args: argparse.Namespace) -> int:
+    diagnoses = orchestrator.run_full_diagnosis(online=args.online)
+    summary = orchestrator.summarize(diagnoses)
+
+    print(f"{summary['total']}개 중 {summary['ok']}개 정상", end="")
+    if summary["update_available"]:
+        print(f" · 업데이트 {summary['update_available']}개", end="")
+    if summary["action_needed"]:
+        print(f" · 조치 필요 {summary['action_needed']}개", end="")
+    print()
+    print()
+
+    for d in diagnoses:
+        version = d.report.installed_version if d.report else "?"
+        print(f"[{d.readiness}] {d.lens.display_name} (v{version})")
+        if d.report:
+            for c in d.report.checks:
+                if c.status in ("ok", "skip", "info-skip"):
+                    continue
+                label = "진행중" if c.status == "active" else "문제"
+                print(f"    - [{label}] {c.id}: {c.summary}")
+                if c.action:
+                    print(f"      action: {c.action}")
+        print()
+
+    any_action_needed = summary["action_needed"] > 0
+    return 1 if any_action_needed else 0
+
+
+def _cmd_check_updates(args: argparse.Namespace) -> int:
+    latest = orchestrator.check_for_updates()
+    for lens in LENSES:
+        v = latest.get(lens.name)
+        print(f"{lens.display_name}: {v if v else '확인 실패'}")
+    return 0
+
+
+def _cmd_gui(args: argparse.Namespace) -> int:
+    from leetkit_manager.ui.app import run
+
+    run()
+    return 0
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(prog="leetkit-manager")
+    sub = p.add_subparsers(dest="command")
+
+    diagnose = sub.add_parser("diagnose", help="전체 Lens 진단 대시보드(텍스트)")
+    diagnose.add_argument("--online", action="store_true", help="실제 외부 연결 검사 포함")
+    diagnose.set_defaults(func=_cmd_diagnose)
+
+    check_updates = sub.add_parser("check-updates", help="세 Lens 최신 버전 조회(PyPI)")
+    check_updates.set_defaults(func=_cmd_check_updates)
+
+    gui = sub.add_parser("gui", help="데스크톱 대시보드(pywebview) 실행")
+    gui.set_defaults(func=_cmd_gui)
+
+    return p
+
+
+def main() -> None:
+    args = _build_parser().parse_args()
+    # 서브커맨드 없이 실행(바로가기 더블클릭 등)하면 gui가 기본 동작.
+    func = getattr(args, "func", _cmd_gui)
+    sys.exit(func(args))
+
+
+if __name__ == "__main__":
+    main()

leetkit_manager-0.1.1/leetkit_manager/config_backup.py

@@ -0,0 +1,42 @@
+"""Claude Desktop/Code 설정 파일 백업·복원.
+
+각 Lens의 `<lens>-setup`도 자기 몫의 백업(`.json.backup`, 고정 이름 — 매번 덮어씀)을
+따로 만들지만, 그건 그 Lens 한 번의 변경만 되돌릴 수 있다. 이 모듈은 "여러 Lens를
+순차 설치·업데이트하는 배치 작업을 시작하는 시점"의 통짜 스냅샷을 시각이 포함된
+이름(`.bak-YYYYMMDD-HHMMSS`)으로 남겨, 배치 중간에 무엇이 잘못돼도 최초 상태로
+되돌릴 수 있게 하는 바깥쪽 안전망이다.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+from pathlib import Path
+
+
+def backup_path_for(config_path: Path, *, at: datetime | None = None) -> Path:
+    at = at or datetime.now()
+    stamp = at.strftime("%Y%m%d-%H%M%S")
+    return config_path.with_name(config_path.name + f".bak-{stamp}")
+
+
+def backup_config(config_path: Path, *, at: datetime | None = None) -> Path | None:
+    """config_path가 존재하면 타임스탬프 백업을 만들고 그 경로를 반환한다.
+
+    파일이 아직 없으면(해당 클라이언트를 안 쓰는 경우) 백업할 것이 없으므로 None —
+    "백업 없이 설정을 덮어쓰지 않는다"는 새 파일 생성까지 막는 규칙이 아니라, 기존
+    내용을 잃을 위험이 있을 때만 적용된다.
+    """
+    if not config_path.exists():
+        return None
+    backup = backup_path_for(config_path, at=at)
+    backup.write_bytes(config_path.read_bytes())
+    return backup
+
+
+def restore_config(config_path: Path, backup_path: Path) -> bool:
+    """백업 내용을 원래 경로에 되돌려 쓴다. 백업이 없으면 아무 것도 하지 않고 False —
+    Manager는 장애 복구를 이유로 파일을 임의로 만들거나 지우지 않는다."""
+    if not backup_path.exists():
+        return False
+    config_path.write_bytes(backup_path.read_bytes())
+    return True