codebeacon 0.3.2__tar.gz → 0.3.3__tar.gz

{codebeacon-0.3.2 → codebeacon-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codebeacon
-Version: 0.3.2
+Version: 0.3.3
 Summary: Source code AST analysis tool for AI context generation — unified multi-framework knowledge graph
 Project-URL: Homepage, https://github.com/codebeacon/codebeacon
 Project-URL: Repository, https://github.com/codebeacon/codebeacon
@@ -259,10 +259,21 @@ This copies `SKILL.md` to `~/.claude/skills/codebeacon/` and registers the `/cod
 /codebeacon serve <path>          # start MCP server pointing at .codebeacon/
 /codebeacon query <term>          # search the graph
 /codebeacon path <src> <tgt>      # shortest path
+/codebeacon upgrade               # pip upgrade + refresh this skill (then restart Claude Code)
 ```
 
 By default `scan` and `sync` invocations automatically run the **AI-semantic** pipeline at the end (see the [AI-Semantic Enrichment](#ai-semantic-enrichment-via-the-codebeacon-skill) section). The agent uses whatever model your Claude Code session is currently running on — Opus, Sonnet, Haiku — codebeacon never hardcodes a model and never needs an API key.
 
+### Updating to a new version
+
+Run **one** command from anywhere:
+
+```bash
+codebeacon upgrade
+```
+
+This pip-upgrades the package, then re-runs `codebeacon install` so `~/.claude/skills/codebeacon/SKILL.md` is overwritten with the new release's copy. Restart your Claude Code session for the new SKILL.md to load. If codebeacon is installed in editable mode (`pip install -e .`), the pip step is skipped — pass `--force` to upgrade anyway.
+
 ### MCP Server
 
 Run codebeacon as a persistent MCP server so any MCP-compatible client can query your knowledge graph directly.
@@ -365,6 +376,8 @@ codebeacon merge-driver <base> <cur> <other>  # invoked by git after `hook insta
 # Integrations
 codebeacon serve [--dir .codebeacon]      # start MCP server (stdio)
 codebeacon install                        # install Claude Code skill
+codebeacon upgrade                        # pip install --upgrade + refresh ~/.claude/skills/codebeacon/SKILL.md
+                                          # (`--force` to upgrade even when installed in editable mode)
 ```
 
 ---

{codebeacon-0.3.2 → codebeacon-0.3.3}/README.de.md

@@ -391,6 +391,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
 
 codebeacon serve [--dir .codebeacon]      # MCP-Server starten (stdio)
 codebeacon install                        # Claude-Code-Skill installieren
+codebeacon upgrade                        # pip-Upgrade + ~/.claude/skills/codebeacon/SKILL.md aktualisieren
+                                          # (`--force` falls editable-Installation)
 ```
 
 ---

{codebeacon-0.3.2 → codebeacon-0.3.3}/README.es.md

@@ -389,6 +389,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
 
 codebeacon serve [--dir .codebeacon]      # servidor MCP (stdio)
 codebeacon install                        # instalar skill de Claude Code
+codebeacon upgrade                        # pip upgrade + refrescar ~/.claude/skills/codebeacon/SKILL.md
+                                          # (use `--force` si está instalado en modo editable)
 ```
 
 ---

{codebeacon-0.3.2 → codebeacon-0.3.3}/README.fr.md

@@ -390,6 +390,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
 
 codebeacon serve [--dir .codebeacon]      # serveur MCP (stdio)
 codebeacon install                        # installer le skill Claude Code
+codebeacon upgrade                        # pip upgrade + rafraîchir ~/.claude/skills/codebeacon/SKILL.md
+                                          # (`--force` si installé en mode éditable)
 ```
 
 ---

{codebeacon-0.3.2 → codebeacon-0.3.3}/README.ja.md

@@ -300,6 +300,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
 # インテグレーション
 codebeacon serve [--dir .codebeacon]      # MCP サーバー起動 (stdio)
 codebeacon install                        # Claude Code スキルをインストール
+codebeacon upgrade                        # pip で更新 + ~/.claude/skills/codebeacon/SKILL.md を再生成
+                                          # (`--force` で editable インストール時も強制実行)
 ```
 
 ---

{codebeacon-0.3.2 → codebeacon-0.3.3}/README.ko.md

@@ -217,10 +217,21 @@ codebeacon install
 /codebeacon serve <path>          # .codebeacon/ 을 가리키는 MCP 서버 시작
 /codebeacon query <term>          # 그래프 검색
 /codebeacon path <src> <tgt>      # 최단 경로
+/codebeacon upgrade               # pip 업그레이드 + 이 스킬 SKILL.md 갱신 (이후 Claude Code 재시작)
 ```
 
 기본적으로 `scan` 과 `sync` 호출은 마지막에 **AI-시맨틱** 파이프라인을 자동 실행합니다 ([AI-시맨틱 보강](#ai-시맨틱-보강-codebeacon-스킬에서-자동) 섹션 참고). 에이전트는 Claude Code 세션이 **현재 실행 중인 모델**을 그대로 사용 — Opus, Sonnet, Haiku — codebeacon 은 절대 모델을 하드코딩하지 않고 API 키도 필요 없습니다.
 
+### 새 버전으로 업그레이드
+
+어디서든 한 줄:
+
+```bash
+codebeacon upgrade
+```
+
+이 명령은 pip 으로 패키지를 업그레이드한 뒤 `codebeacon install` 을 다시 실행해 `~/.claude/skills/codebeacon/SKILL.md` 을 새 릴리스의 사본으로 덮어씁니다. 새 SKILL.md 가 로드되려면 Claude Code 세션을 재시작하세요. editable 모드 (`pip install -e .`) 로 설치되어 있다면 pip 단계는 스킵됩니다 — 강제로 진행하려면 `--force` 를 붙이세요.
+
 ### MCP 서버
 
 codebeacon을 MCP 서버로 실행하면 MCP 호환 클라이언트에서 지식 그래프를 직접 조회할 수 있습니다.
@@ -324,6 +335,8 @@ codebeacon merge-driver <base> <cur> <other>  # `hook install` 후 git이 자동
 # 통합
 codebeacon serve [--dir .codebeacon]      # MCP 서버 시작 (stdio)
 codebeacon install                        # Claude Code 스킬 설치
+codebeacon upgrade                        # pip 으로 업그레이드 + ~/.claude/skills/codebeacon/SKILL.md 갱신
+                                          # (`--force` 로 editable 설치 환경에서도 강제 업그레이드)
 ```
 
 ---

{codebeacon-0.3.2 → codebeacon-0.3.3}/README.md

@@ -216,10 +216,21 @@ This copies `SKILL.md` to `~/.claude/skills/codebeacon/` and registers the `/cod
 /codebeacon serve <path>          # start MCP server pointing at .codebeacon/
 /codebeacon query <term>          # search the graph
 /codebeacon path <src> <tgt>      # shortest path
+/codebeacon upgrade               # pip upgrade + refresh this skill (then restart Claude Code)
 ```
 
 By default `scan` and `sync` invocations automatically run the **AI-semantic** pipeline at the end (see the [AI-Semantic Enrichment](#ai-semantic-enrichment-via-the-codebeacon-skill) section). The agent uses whatever model your Claude Code session is currently running on — Opus, Sonnet, Haiku — codebeacon never hardcodes a model and never needs an API key.
 
+### Updating to a new version
+
+Run **one** command from anywhere:
+
+```bash
+codebeacon upgrade
+```
+
+This pip-upgrades the package, then re-runs `codebeacon install` so `~/.claude/skills/codebeacon/SKILL.md` is overwritten with the new release's copy. Restart your Claude Code session for the new SKILL.md to load. If codebeacon is installed in editable mode (`pip install -e .`), the pip step is skipped — pass `--force` to upgrade anyway.
+
 ### MCP Server
 
 Run codebeacon as a persistent MCP server so any MCP-compatible client can query your knowledge graph directly.
@@ -322,6 +333,8 @@ codebeacon merge-driver <base> <cur> <other>  # invoked by git after `hook insta
 # Integrations
 codebeacon serve [--dir .codebeacon]      # start MCP server (stdio)
 codebeacon install                        # install Claude Code skill
+codebeacon upgrade                        # pip install --upgrade + refresh ~/.claude/skills/codebeacon/SKILL.md
+                                          # (`--force` to upgrade even when installed in editable mode)
 ```
 
 ---

{codebeacon-0.3.2 → codebeacon-0.3.3}/README.pt-BR.md

@@ -389,6 +389,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
 
 codebeacon serve [--dir .codebeacon]      # servidor MCP (stdio)
 codebeacon install                        # instalar skill do Claude Code
+codebeacon upgrade                        # pip upgrade + atualizar ~/.claude/skills/codebeacon/SKILL.md
+                                          # (use `--force` se instalado em modo editable)
 ```
 
 ---

{codebeacon-0.3.2 → codebeacon-0.3.3}/README.zh-CN.md

@@ -299,6 +299,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
 # 集成
 codebeacon serve [--dir .codebeacon]      # 启动 MCP 服务器（stdio）
 codebeacon install                        # 安装 Claude Code 技能
+codebeacon upgrade                        # pip 升级 + 刷新 ~/.claude/skills/codebeacon/SKILL.md
+                                          # （editable 安装下用 `--force` 强制升级）
 ```
 
 ---

codebeacon-0.3.3/codebeacon/__init__.py

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

{codebeacon-0.3.2 → codebeacon-0.3.3}/codebeacon/cli.py

@@ -758,6 +758,60 @@ def _cmd_install(args: argparse.Namespace) -> int:
     return 0
 
 
+def _cmd_upgrade(args: argparse.Namespace) -> int:
+    """``codebeacon upgrade`` — pip upgrade the package + refresh SKILL.md.
+
+    Runs `pip install --upgrade codebeacon` in the current interpreter, then
+    reinvokes `codebeacon install` so ~/.claude/skills/codebeacon/SKILL.md is
+    refreshed to whatever shipped in the new release. Editable installs are
+    detected and skipped (pip upgrade would be a no-op anyway).
+    """
+    import subprocess
+    import sys as _sys
+    from codebeacon import __version__ as _current
+
+    print(f"Current version: codebeacon {_current}", flush=True)
+
+    is_editable = False
+    try:
+        from importlib.metadata import Distribution
+        dist = Distribution.from_name("codebeacon")
+        direct_url = dist.read_text("direct_url.json") or ""
+        if "\"editable\": true" in direct_url:
+            is_editable = True
+    except Exception:
+        pass
+
+    if is_editable and not getattr(args, "force", False):
+        print(
+            "Detected an editable (pip install -e .) install — skipping pip upgrade.\n"
+            "Use `git pull` to get new code, or pass --force to upgrade anyway.",
+            file=_sys.stderr,
+        )
+    else:
+        cmd = [_sys.executable, "-m", "pip", "install", "--upgrade", "codebeacon"]
+        print(f"$ {' '.join(cmd)}")
+        rc = subprocess.call(cmd)
+        if rc != 0:
+            print("pip upgrade failed.", file=_sys.stderr)
+            return rc
+
+    # Refresh SKILL.md by reinvoking the install command. We exec it in a
+    # subprocess so the freshly-installed entry point is used (the current
+    # process is still running the OLD code from before pip upgrade).
+    print("\nRefreshing /codebeacon Claude Code skill ...", flush=True)
+    rc = subprocess.call([_sys.executable, "-m", "codebeacon", "install"])
+    if rc != 0:
+        return rc
+
+    print(
+        "\nUpgrade complete. Restart your Claude Code session so the new "
+        "SKILL.md is loaded.",
+        flush=True,
+    )
+    return 0
+
+
 def _cmd_semantic_prepare(args: argparse.Namespace) -> int:
     from codebeacon.semantic_pipeline import prepare
 
@@ -874,6 +928,17 @@ def build_parser() -> argparse.ArgumentParser:
     install_p = sub.add_parser("install", help="Install Claude Code skill")
     install_p.set_defaults(func=_cmd_install)
 
+    # upgrade (pip upgrade + refresh skill)
+    upgrade_p = sub.add_parser(
+        "upgrade",
+        help="Upgrade codebeacon via pip and refresh ~/.claude/skills/codebeacon/SKILL.md",
+    )
+    upgrade_p.add_argument(
+        "--force", action="store_true",
+        help="Upgrade even when codebeacon is installed in editable (-e) mode",
+    )
+    upgrade_p.set_defaults(func=_cmd_upgrade)
+
     # semantic-prepare
     sem_prep = sub.add_parser(
         "semantic-prepare",

{codebeacon-0.3.2 → codebeacon-0.3.3/codebeacon}/skill/SKILL.md

@@ -24,6 +24,7 @@ Scan source code with AST analysis → build a knowledge graph → generate a na
 /codebeacon path <src> <tgt>             # shortest path
 /codebeacon init [<path>]                # interactive codebeacon.yaml
 /codebeacon install                      # install/update this skill
+/codebeacon upgrade                      # pip upgrade codebeacon + refresh this SKILL.md (then restart Claude Code)
 ```
 
 If no path was given, use `.` (current directory). Do not ask the user for a path.

{codebeacon-0.3.2 → codebeacon-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codebeacon"
-version = "0.3.2"
+version = "0.3.3"
 description = "Source code AST analysis tool for AI context generation — unified multi-framework knowledge graph"
 readme = "README.md"
 license = { text = "MIT" }

{codebeacon-0.3.2 → codebeacon-0.3.3}/skill/install.py

@@ -17,7 +17,7 @@ import sys
 from pathlib import Path
 
 
-SKILL_SRC = Path(__file__).parent / "SKILL.md"
+SKILL_SRC = Path(__file__).parent.parent / "codebeacon" / "skill" / "SKILL.md"
 
 CLAUDE_TRIGGER_BLOCK = """\
 # codebeacon

codebeacon-0.3.2/codebeacon/__init__.py

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

codebeacon-0.3.2/codebeacon/skill/SKILL.md

@@ -1,129 +0,0 @@
----
-name: codebeacon
-description: Scan a codebase → AST extraction → knowledge graph → wiki + CLAUDE.md context map. Supports 27 frameworks (Spring Boot, NestJS, Django, FastAPI, Flask, Rails, Express, Fastify, Koa, React, Next.js, Vue, Nuxt, Angular, SvelteKit, Gin, Echo, Fiber, Laravel, Actix-Web, Axum, Tauri, Rocket, Warp, ASP.NET Core, Vapor, Ktor).
-trigger: /codebeacon
----
-
-# /codebeacon
-
-Scan source code with AST analysis → build a knowledge graph → generate a navigable wiki + `CLAUDE.md` context map ready for AI agents.
-
-## Usage
-
-```
-/codebeacon                         # scan current directory
-/codebeacon <path>                  # scan specific path or workspace root
-/codebeacon <path> --update         # incremental: only reprocess changed files
-/codebeacon <path> --wiki-only      # regenerate wiki without re-extracting
-/codebeacon <path> --deep-dive      # per-project outputs + combined workspace
-/codebeacon sync                    # sync from codebeacon.yaml (multi-project)
-/codebeacon serve <path>            # start MCP server pointing at .codebeacon/
-```
-
-## What You Must Do When Invoked
-
-If no path was given, use `.` (current directory). Do not ask the user for a path.
-
-Follow these steps in order.
-
-### Step 1 — Ensure codebeacon is installed
-
-```bash
-python3 -c "import codebeacon" 2>/dev/null || pip install codebeacon -q --break-system-packages 2>&1 | tail -5
-python3 -c "import sys; open('.codebeacon_python', 'w').write(sys.executable)"
-```
-
-In every subsequent bash block, replace `python3` with `$(cat .codebeacon_python)`.
-
-If import succeeds, print nothing and move to Step 2.
-
-### Step 2 — Detect mode and run
-
-Check if `codebeacon.yaml` exists in the target directory:
-
-```bash
-TARGET="${1:-.}"
-
-if [ -f "$TARGET/codebeacon.yaml" ]; then
-    echo "Found codebeacon.yaml — running sync mode"
-    $(cat .codebeacon_python) -m codebeacon sync --config "$TARGET/codebeacon.yaml"
-else
-    echo "Scanning $TARGET ..."
-    $(cat .codebeacon_python) -m codebeacon scan "$TARGET"
-fi
-```
-
-The command prints wave progress as it goes:
-- Framework detection per project
-- `[pct%] done/total files processed` (wave progress per project)
-- Route / Service / Entity / Component counts after each project
-- Final: `Nodes: N, Edges: E, Communities: K`
-
-Let it run to completion. Do not interrupt.
-
-### Step 3 — Report results
-
-After the command exits, read the REPORT.md:
-
-```bash
-TARGET="${1:-.}"
-OUTPUT_DIR="$TARGET/.codebeacon"
-[ -f "$OUTPUT_DIR/REPORT.md" ] && head -40 "$OUTPUT_DIR/REPORT.md"
-```
-
-Then summarise for the user:
-- Which projects/frameworks were detected
-- Total nodes, edges, communities
-- Output location (`CLAUDE.md` at project root, `.codebeacon/wiki/`, `.codebeacon/beacon.json`, etc.)
-- Any god nodes or surprising connections worth mentioning
-
-### Step 4 — (Optional) MCP serve
-
-If the user asked for `serve`:
-
-```bash
-TARGET="${1:-.}"
-$(cat .codebeacon_python) -m codebeacon serve --dir "$TARGET/.codebeacon"
-```
-
-This blocks — run it only when the user explicitly wants an MCP server.
-
-## Output structure
-
-```
-project-root/
-  CLAUDE.md              ← AI context map (codebeacon block merged; user content preserved)
-  .cursorrules           ← Cursor IDE context (same merge strategy)
-  AGENTS.md              ← OpenAI Agents context (same merge strategy)
-  .codebeacon/
-    beacon.json          ← full knowledge graph (node-link JSON)
-    REPORT.md            ← god nodes, surprising connections, hub files
-    wiki/
-      index.md           ← global index (~200 tokens)
-      overview.md        ← platform stats + cross-project connections
-      routes.md          ← all routes table
-      cross-project/
-        connections.md   ← cross-service edges
-      <project>/
-        index.md
-        routes.md
-        controllers/<Name>.md
-        services/<Name>.md
-        entities/<Name>.md
-        components/<Name>.md
-    obsidian/            ← Obsidian vault (one note per node)
-```
-
-## Supported frameworks
-
-| Language | Frameworks |
-|----------|-----------|
-| Java/Kotlin | Spring Boot, Ktor |
-| Python | Django, FastAPI, Flask |
-| JavaScript/TypeScript | Express, Fastify, Koa, NestJS, React, Next.js, Vue, Nuxt, Angular, SvelteKit |
-| Go | Gin, Echo, Fiber |
-| Ruby | Rails |
-| PHP | Laravel |
-| Rust | Actix-Web, Axum, Tauri, Rocket, Warp |
-| C# | ASP.NET Core |
-| Swift | Vapor |