codebeacon 0.5.0__tar.gz → 0.6.0__tar.gz

codebeacon-0.5.0/README.md → codebeacon-0.6.0/PKG-INFO

@@ -1,3 +1,96 @@
+Metadata-Version: 2.4
+Name: codebeacon
+Version: 0.6.0
+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
+Project-URL: Issues, https://github.com/codebeacon/codebeacon/issues
+License: MIT
+License-File: LICENSE
+Keywords: ai-context,ast,claude,codebase,knowledge-graph,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: networkx>=3.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tree-sitter-javascript>=0.23
+Requires-Dist: tree-sitter-python>=0.23
+Requires-Dist: tree-sitter-typescript>=0.23
+Requires-Dist: tree-sitter>=0.23
+Provides-Extra: backend
+Requires-Dist: tree-sitter-c-sharp>=0.23; extra == 'backend'
+Requires-Dist: tree-sitter-go>=0.23; extra == 'backend'
+Requires-Dist: tree-sitter-java>=0.23; extra == 'backend'
+Requires-Dist: tree-sitter-kotlin>=0.23; extra == 'backend'
+Requires-Dist: tree-sitter-php>=0.23; extra == 'backend'
+Requires-Dist: tree-sitter-ruby>=0.23; extra == 'backend'
+Requires-Dist: tree-sitter-rust>=0.23; extra == 'backend'
+Provides-Extra: cluster
+Requires-Dist: graspologic>=1.0; extra == 'cluster'
+Provides-Extra: csharp
+Requires-Dist: tree-sitter-c-sharp>=0.23; extra == 'csharp'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: tree-sitter-c-sharp>=0.23; extra == 'dev'
+Requires-Dist: tree-sitter-go>=0.23; extra == 'dev'
+Requires-Dist: tree-sitter-html>=0.23; extra == 'dev'
+Requires-Dist: tree-sitter-java>=0.23; extra == 'dev'
+Requires-Dist: tree-sitter-kotlin>=0.23; extra == 'dev'
+Requires-Dist: tree-sitter-php>=0.23; extra == 'dev'
+Requires-Dist: tree-sitter-ruby>=0.23; extra == 'dev'
+Requires-Dist: tree-sitter-rust>=0.23; extra == 'dev'
+Requires-Dist: tree-sitter-svelte>=0.23; extra == 'dev'
+Requires-Dist: tree-sitter-swift>=0.0.1; extra == 'dev'
+Provides-Extra: dotnet
+Requires-Dist: tree-sitter-c-sharp>=0.23; extra == 'dotnet'
+Provides-Extra: full
+Requires-Dist: tree-sitter-c-sharp>=0.23; extra == 'full'
+Requires-Dist: tree-sitter-go>=0.23; extra == 'full'
+Requires-Dist: tree-sitter-html>=0.23; extra == 'full'
+Requires-Dist: tree-sitter-java>=0.23; extra == 'full'
+Requires-Dist: tree-sitter-kotlin>=0.23; extra == 'full'
+Requires-Dist: tree-sitter-php>=0.23; extra == 'full'
+Requires-Dist: tree-sitter-ruby>=0.23; extra == 'full'
+Requires-Dist: tree-sitter-rust>=0.23; extra == 'full'
+Requires-Dist: tree-sitter-svelte>=0.23; extra == 'full'
+Requires-Dist: tree-sitter-swift>=0.0.1; extra == 'full'
+Provides-Extra: go
+Requires-Dist: tree-sitter-go>=0.23; extra == 'go'
+Provides-Extra: html
+Requires-Dist: tree-sitter-html>=0.23; extra == 'html'
+Provides-Extra: java
+Requires-Dist: tree-sitter-java>=0.23; extra == 'java'
+Provides-Extra: jvm
+Requires-Dist: tree-sitter-java>=0.23; extra == 'jvm'
+Requires-Dist: tree-sitter-kotlin>=0.23; extra == 'jvm'
+Provides-Extra: kotlin
+Requires-Dist: tree-sitter-kotlin>=0.23; extra == 'kotlin'
+Provides-Extra: mobile
+Requires-Dist: tree-sitter-kotlin>=0.23; extra == 'mobile'
+Requires-Dist: tree-sitter-swift>=0.0.1; extra == 'mobile'
+Provides-Extra: php
+Requires-Dist: tree-sitter-php>=0.23; extra == 'php'
+Provides-Extra: ruby
+Requires-Dist: tree-sitter-ruby>=0.23; extra == 'ruby'
+Provides-Extra: rust
+Requires-Dist: tree-sitter-rust>=0.23; extra == 'rust'
+Provides-Extra: svelte
+Requires-Dist: tree-sitter-svelte>=0.23; extra == 'svelte'
+Provides-Extra: swift
+Requires-Dist: tree-sitter-swift>=0.0.1; extra == 'swift'
+Provides-Extra: web
+Requires-Dist: tree-sitter-html>=0.23; extra == 'web'
+Requires-Dist: tree-sitter-svelte>=0.23; extra == 'web'
+Description-Content-Type: text/markdown
+
 <p align="center">
   <a href="https://github.com/Wandererer/codebeacon/blob/main/README.md"><img src="https://img.shields.io/badge/lang-English-blue" alt="English"></a>
   <a href="https://github.com/Wandererer/codebeacon/blob/main/README.ko.md"><img src="https://img.shields.io/badge/lang-한국어-red" alt="Korean"></a>
@@ -25,6 +118,23 @@
 
 ---
 
+## What's new in 0.6.0
+
+- **`codebeacon affected`** — given a list of changed files (or a `--base <ref>` git diff), prints every graph node downstream of the change. Built for CI risk-scoring and PR review.
+- **`.NET` project files** — `.sln`, `.csproj`, `.fsproj`, `.vbproj`, `.razor`, `.cshtml` are now parsed: `<ProjectReference>` / `<PackageReference>` become graph edges, Razor `@inherits` / `@inject` / `@using` link Blazor pages to their backing types.
+- **JS/TS barrel re-exports** — `export { X } from './mod'` and `export * from './mod'` now produce explicit `re_exports` edges so Next.js / monorepo barrels stop showing zero imports.
+- **`--exclude PATTERN` flag** for `scan` / `sync`, plus automatic fallback to `.gitignore` when `.codebeaconignore` is absent.
+- **`codebeacon install --project [PATH]`** — install the `/codebeacon` skill into `<PATH>/.claude/` instead of `~/.claude/`, so teams can pin a SKILL.md version per repo.
+- **Wiki self-heals** — `--update` runs now prune `wiki/<project>/{controllers,services,entities,components}/*.md` files whose graph node no longer exists.
+- **Shrink-guard relaxed for explicit deletions** — `--update` mode no longer refuses to write a smaller `beacon.json` when the cache already accounted for deleted files; the guard still fires on silent corruption.
+- **Cross-file declaration merge** — Swift `extension Foo`, C# partial classes, Ruby reopened classes union their `fields` / `methods` into one canonical node instead of the last writer winning.
+- **Hardened query** — `BeaconIndex` uses `casefold()` so German `ß`, Turkish `i/İ`, Greek `σ/ς`, and CJK labels round-trip correctly.
+- **Richer semantic context** — each task chunk now ships graph callers + callees as `neighbors` so the LLM stays grounded in real node labels; `SKILL.md` adds **Step 0 — Constrained query expansion** so `/codebeacon query` flows can't invent phantom tokens.
+- **`semantic-apply` zero-yield guard** — if every chunk archived 0 edges, the CLI exits 1 so CI catches silent LLM failures.
+- **ArkTS (`.ets`) and worktree-safety** — `.ets` is collected; nested `worktrees/` dirs are skipped to stop double-counting linked worktrees.
+
+---
+
 ## Why codebeacon?
 
 Every time you open a new AI coding session, your assistant starts blind. It doesn't know your routes, your service layer, your entity model, or how your microservices call each other. You spend the first chunk of every session just getting the AI back up to speed — pasting files, explaining structure, re-establishing context.
@@ -92,8 +202,9 @@ codebeacon sync                      # subsequent runs via config
 | Ruby | Rails |
 | PHP | Laravel |
 | Rust | Actix-Web, Axum, Tauri, Rocket, Warp |
-| C# | ASP.NET Core |
+| C# | ASP.NET Core, Blazor (`.razor`, `.cshtml`); `.sln` / `.csproj` / `.fsproj` / `.vbproj` parsed for `ProjectReference` + `PackageReference` |
 | Swift | Vapor |
+| ArkTS | `.ets` (HarmonyOS) collected — extractors framework-agnostic |
 
 ---
 
@@ -313,12 +424,21 @@ codebeacon scan . --obsidian-dir <path>   # write Obsidian vault to custom locat
 codebeacon scan . --semantic              # enable structured-comment semantic extraction (Javadoc/JSDoc/docstring refs)
 codebeacon scan . --list-only             # detect frameworks only, don't extract
 codebeacon scan /workspace --deep-dive    # per-project + combined workspace outputs
+codebeacon scan . --exclude 'docs/**' --exclude '*.gen.ts'
+                                          # repeatable gitignore-style patterns merged with
+                                          # .codebeaconignore / .gitignore
 
 # Config-driven mode
 codebeacon init [path]                    # auto-generate codebeacon.yaml
 codebeacon sync                           # run from codebeacon.yaml (auto-appends new workspace projects)
 codebeacon sync --config <file>           # use a specific config file
 codebeacon sync --no-rediscover           # don't auto-append newly added projects (hand-curated yaml mode)
+codebeacon sync --exclude PATTERN         # same flag, same semantics
+
+# PR / CI: what does this diff actually break?
+codebeacon affected --base main           # walk upstream callers of every changed file
+codebeacon affected --base origin/main --head HEAD --depth 4 --limit 200
+codebeacon affected src/foo.py src/bar.py  # explicit paths, no git needed
 
 # AI-semantic enrichment (the agent does the LLM work, codebeacon does the bookkeeping)
 codebeacon semantic-prepare [--dir .codebeacon] [--max-tasks N] [--chunk-size N]
@@ -347,7 +467,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 install                        # install Claude Code skill (user scope: ~/.claude/)
+codebeacon install --project [PATH]       # install into <PATH>/.claude/ (team-shared, repo-pinned)
 codebeacon upgrade                        # pip install --upgrade + refresh ~/.claude/skills/codebeacon/SKILL.md
                                           # (`--force` to upgrade even when installed in editable mode)
 ```

{codebeacon-0.5.0 → codebeacon-0.6.0}/README.de.md

@@ -27,6 +27,23 @@
 
 ---
 
+## Neu in 0.6.0
+
+- **`codebeacon affected`** — nimmt eine Liste geänderter Dateien (oder via `--base <ref>` ein git diff) und gibt jeden nachgelagerten Graphknoten aus. Für CI-Risikoeinstufung und PR-Reviews.
+- **`.NET`-Projektdateien** — `.sln`, `.csproj`, `.fsproj`, `.vbproj`, `.razor`, `.cshtml` werden jetzt geparst: `<ProjectReference>` / `<PackageReference>` werden zu Graphkanten, Razor-Direktiven `@inherits` / `@inject` / `@using` verbinden Blazor-Seiten mit ihren Backing-Typen.
+- **JS/TS Barrel-Reexports** — `export { X } from './mod'` und `export * from './mod'` erzeugen jetzt explizite `re_exports`-Kanten, sodass Next.js-/Monorepo-Barrels nicht mehr mit 0 Imports erscheinen.
+- **`--exclude PATTERN`-Flag** für `scan` / `sync`, plus automatischer Fallback auf `.gitignore`, wenn `.codebeaconignore` fehlt.
+- **`codebeacon install --project [PATH]`** — installiert den `/codebeacon`-Skill nach `<PATH>/.claude/` statt `~/.claude/`, damit Teams eine SKILL.md-Version pro Repo festpinnen können.
+- **Wiki repariert sich selbst** — `--update`-Läufe entfernen jetzt `wiki/<project>/{controllers,services,entities,components}/*.md`-Dateien, deren Graphknoten nicht mehr existieren.
+- **Shrink-Guard bei expliziten Löschungen gelockert** — im `--update`-Modus wird ein kleineres `beacon.json` nicht mehr abgelehnt, wenn der Cache die Löschungen bereits berücksichtigt hat; bei stiller Korruption greift die Sperre weiterhin.
+- **Datei-übergreifende Deklarations-Union** — Swift `extension Foo`, C# partial classes, Ruby reopened classes vereinen ihre `fields` / `methods` zu einem kanonischen Knoten, statt vom letzten Schreiber überschrieben zu werden.
+- **Härtere Suche** — `BeaconIndex` nutzt `casefold()`, sodass deutsches `ß`, türkisches `i/İ`, griechisches `σ/ς` und CJK-Labels korrekt matchen.
+- **Reichhaltigerer Semantik-Kontext** — jeder Task-Chunk bringt jetzt Graph-Caller und -Callees als `neighbors` mit, damit das LLM bei echten Knotenlabels bleibt; `SKILL.md` ergänzt **Step 0 — Constrained query expansion**, sodass `/codebeacon query`-Flows keine Phantom-Tokens erfinden können.
+- **`semantic-apply` Zero-Yield-Guard** — wenn jeder Chunk mit 0 Kanten archiviert wurde, beendet die CLI mit Exit 1, sodass CI stille LLM-Fehler bemerkt.
+- **ArkTS (`.ets`) und Worktree-Sicherheit** — `.ets` wird eingesammelt; verschachtelte `worktrees/`-Verzeichnisse werden übersprungen, damit verlinkte Worktrees nicht doppelt indexiert werden.
+
+---
+
 ## Warum codebeacon?
 
 Jedes Mal, wenn Sie eine neue KI-Codiersitzung öffnen, beginnt der Assistent bei null. Er kennt weder Ihre Routes, noch Ihre Service-Schicht, noch Ihr Entitätsmodell, noch die Kommunikationswege zwischen Ihren Microservices. Sie verbringen den Beginn jeder Sitzung damit, Dateien einzufügen, die Struktur zu erklären und den Kontext wiederherzustellen.
@@ -94,8 +111,9 @@ codebeacon sync                       # Folgeläufe über Konfiguration
 | Ruby | Rails |
 | PHP | Laravel |
 | Rust | Actix-Web, Axum |
-| C# | ASP.NET Core |
+| C# | ASP.NET Core, Blazor (`.razor`, `.cshtml`); `.sln` / `.csproj` / `.fsproj` / `.vbproj` für `ProjectReference` + `PackageReference` geparst |
 | Swift | Vapor |
+| ArkTS | `.ets` (HarmonyOS) eingesammelt — Extraktoren framework-agnostisch |
 
 ---
 
@@ -370,10 +388,19 @@ codebeacon scan . --wiki-only             # Extraktion überspringen, Wiki/Obsid
 codebeacon scan . --semantic              # Extraktion strukturierter Kommentar-Referenzen (Javadoc/JSDoc/docstring)
 codebeacon scan . --list-only             # nur Frameworks erkennen
 codebeacon scan /workspace --deep-dive    # Pro-Projekt- + kombinierte Workspace-Ausgabe
+codebeacon scan . --exclude 'docs/**' --exclude '*.gen.ts'
+                                          # wiederholbare gitignore-Stil-Patterns
+                                          # mit .codebeaconignore / .gitignore vereint
 
 codebeacon init [pfad]                    # codebeacon.yaml generieren
 codebeacon sync                           # von codebeacon.yaml ausführen (hängt neue Workspace-Projekte automatisch an)
 codebeacon sync --no-rediscover           # neue Projekte nicht automatisch anhängen (handgepflegter yaml-Modus)
+codebeacon sync --exclude PATTERN         # gleiches Flag, gleiche Semantik
+
+# PR / CI: was bricht dieser Diff wirklich?
+codebeacon affected --base main           # die Aufrufer der geänderten Dateien stromaufwärts begehen
+codebeacon affected --base origin/main --head HEAD --depth 4 --limit 200
+codebeacon affected src/foo.py src/bar.py  # explizite Pfade — kein git nötig
 
 codebeacon query <Begriff> [--dir .codebeacon] [--limit N]   # Knoten per Label-Substring suchen
 codebeacon path <Quelle> <Ziel> [--dir .codebeacon]          # kürzester Abhängigkeitspfad
@@ -398,7 +425,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
                                           # (dauerhaftes Archiv). Results löschen, alles regenerieren.
 
 codebeacon serve [--dir .codebeacon]      # MCP-Server starten (stdio)
-codebeacon install                        # Claude-Code-Skill installieren
+codebeacon install                        # Claude-Code-Skill installieren (User-Scope: ~/.claude/)
+codebeacon install --project [PATH]       # nach <PATH>/.claude/ installieren (team-geteilt, repo-gepinnt)
 codebeacon upgrade                        # pip-Upgrade + ~/.claude/skills/codebeacon/SKILL.md aktualisieren
                                           # (`--force` falls editable-Installation)
 ```

{codebeacon-0.5.0 → codebeacon-0.6.0}/README.es.md

@@ -27,6 +27,23 @@
 
 ---
 
+## Novedades en 0.6.0
+
+- **`codebeacon affected`** — recibe una lista de archivos cambiados (o vía `--base <ref>` un git diff) e imprime todos los nodos del grafo aguas abajo. Pensado para puntuación de riesgo en CI y revisión de PR.
+- **Archivos de proyecto `.NET`** — ahora se analizan `.sln`, `.csproj`, `.fsproj`, `.vbproj`, `.razor`, `.cshtml`: `<ProjectReference>` / `<PackageReference>` se convierten en aristas del grafo, y las directivas Razor `@inherits` / `@inject` / `@using` vinculan las páginas Blazor con sus tipos de respaldo.
+- **Re-exports barrel JS/TS** — `export { X } from './mod'` y `export * from './mod'` producen aristas explícitas `re_exports`, para que los barrels de Next.js / monorepo dejen de mostrar 0 imports.
+- **Flag `--exclude PATTERN`** para `scan` / `sync`, más respaldo automático a `.gitignore` cuando falta `.codebeaconignore`.
+- **`codebeacon install --project [PATH]`** — instala el skill `/codebeacon` en `<PATH>/.claude/` en vez de `~/.claude/`, para que los equipos fijen una versión de SKILL.md por repositorio.
+- **El wiki se auto-repara** — las ejecuciones con `--update` ahora eliminan los archivos `wiki/<project>/{controllers,services,entities,components}/*.md` cuyo nodo del grafo ya no existe.
+- **Guarda anti-encogimiento relajada para borrados explícitos** — en modo `--update`, ya no se rechaza escribir un `beacon.json` más pequeño si la caché ya contabilizó los archivos eliminados; la guarda sigue activa frente a corrupción silenciosa.
+- **Unión de declaraciones cross-file** — `extension Foo` de Swift, `partial class` de C# y clases reabiertas de Ruby unen sus `fields` / `methods` en un único nodo canónico en lugar de que gane el último que escribe.
+- **Consulta endurecida** — `BeaconIndex` usa `casefold()`, por lo que `ß` alemán, `i/İ` turco, `σ/ς` griego y etiquetas CJK hacen match correctamente.
+- **Contexto semántico más rico** — cada chunk de tarea ahora lleva los llamadores y llamados del grafo en `neighbors`, manteniendo al LLM anclado en etiquetas reales. `SKILL.md` añade **Step 0 — Constrained query expansion** para que los flujos `/codebeacon query` no inventen tokens fantasma.
+- **Guarda «cero rendimiento» de `semantic-apply`** — si todos los chunks archivaron 0 aristas, la CLI termina con exit 1, para que CI detecte fallos silenciosos del LLM.
+- **ArkTS (`.ets`) y seguridad de worktree** — `.ets` se recoge; los directorios `worktrees/` anidados se omiten para evitar la indexación duplicada de worktrees enlazadas.
+
+---
+
 ## ¿Por qué codebeacon?
 
 Cada vez que se abre una nueva sesión de codificación con IA, el asistente comienza desde cero. No conoce sus rutas, su capa de servicios, su modelo de entidades ni cómo se comunican sus microservicios. Se pasa el inicio de cada sesión pegando archivos, explicando la estructura y restableciendo el contexto.
@@ -94,8 +111,9 @@ codebeacon sync                      # ejecuciones posteriores vía configuraci
 | Ruby | Rails |
 | PHP | Laravel |
 | Rust | Actix-Web, Axum, Tauri, Rocket, Warp |
-| C# | ASP.NET Core |
+| C# | ASP.NET Core, Blazor (`.razor`, `.cshtml`); `.sln` / `.csproj` / `.fsproj` / `.vbproj` analizados para `ProjectReference` + `PackageReference` |
 | Swift | Vapor |
+| ArkTS | `.ets` (HarmonyOS) recogido — los extractores son agnósticos al framework |
 
 ---
 
@@ -368,10 +386,19 @@ codebeacon scan . --wiki-only             # saltar extracción, regenerar wiki/o
 codebeacon scan . --semantic              # extracción de referencias de comentarios estructurados (Javadoc/JSDoc/docstring)
 codebeacon scan . --list-only             # solo detectar frameworks
 codebeacon scan /workspace --deep-dive    # salida por proyecto + workspace combinado
+codebeacon scan . --exclude 'docs/**' --exclude '*.gen.ts'
+                                          # patrones tipo gitignore repetibles
+                                          # fusionados con .codebeaconignore / .gitignore
 
 codebeacon init [ruta]                    # generar codebeacon.yaml
 codebeacon sync                           # ejecutar desde codebeacon.yaml (añade nuevos proyectos del workspace automáticamente)
 codebeacon sync --no-rediscover           # no añadir automáticamente nuevos proyectos (modo yaml curado a mano)
+codebeacon sync --exclude PATTERN         # mismo flag, misma semántica
+
+# PR / CI: ¿qué rompe realmente este diff?
+codebeacon affected --base main           # recorrer aguas arriba los llamadores de los archivos cambiados
+codebeacon affected --base origin/main --head HEAD --depth 4 --limit 200
+codebeacon affected src/foo.py src/bar.py  # rutas explícitas — sin git
 
 codebeacon query <término> [--dir .codebeacon] [--limit N]   # buscar nodos por substring de etiqueta
 codebeacon path <origen> <destino> [--dir .codebeacon]       # ruta más corta de dependencias
@@ -396,7 +423,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
                                           # durable). Borra los resultados y regenera todo.
 
 codebeacon serve [--dir .codebeacon]      # servidor MCP (stdio)
-codebeacon install                        # instalar skill de Claude Code
+codebeacon install                        # instalar skill de Claude Code (ámbito usuario: ~/.claude/)
+codebeacon install --project [PATH]       # instalar en <PATH>/.claude/ (compartido por el equipo, fijado al repo)
 codebeacon upgrade                        # pip upgrade + refrescar ~/.claude/skills/codebeacon/SKILL.md
                                           # (use `--force` si está instalado en modo editable)
 ```

{codebeacon-0.5.0 → codebeacon-0.6.0}/README.fr.md

@@ -27,6 +27,23 @@
 
 ---
 
+## Nouveautés en 0.6.0
+
+- **`codebeacon affected`** — prend une liste de fichiers modifiés (ou via `--base <ref>` un git diff) et imprime tous les nœuds du graphe en aval. Pensé pour le scoring de risque en CI et la revue de PR.
+- **Fichiers projet `.NET`** — `.sln`, `.csproj`, `.fsproj`, `.vbproj`, `.razor`, `.cshtml` sont désormais analysés : les balises `<ProjectReference>` / `<PackageReference>` deviennent des arêtes du graphe, et les directives Razor `@inherits` / `@inject` / `@using` relient les pages Blazor à leurs types sous-jacents.
+- **Re-exports barrel JS/TS** — `export { X } from './mod'` et `export * from './mod'` produisent maintenant des arêtes explicites `re_exports`, pour que les barrels Next.js / monorepo ne s'affichent plus avec 0 import.
+- **Drapeau `--exclude PATTERN`** pour `scan` / `sync`, plus repli automatique sur `.gitignore` lorsque `.codebeaconignore` est absent.
+- **`codebeacon install --project [PATH]`** — installe le skill `/codebeacon` dans `<PATH>/.claude/` plutôt que `~/.claude/`, pour permettre aux équipes de figer la version du SKILL.md par dépôt.
+- **Le wiki s'auto-répare** — les exécutions `--update` suppriment maintenant les fichiers `wiki/<project>/{controllers,services,entities,components}/*.md` dont le nœud de graphe n'existe plus.
+- **Garde anti-rétrécissement relâchée pour les suppressions explicites** — en mode `--update`, l'écriture d'un `beacon.json` plus petit n'est plus refusée si le cache a déjà tenu compte des fichiers supprimés ; la garde s'applique toujours en cas de corruption silencieuse.
+- **Fusion union des déclarations multi-fichiers** — les `extension Foo` Swift, les `partial class` C# et les classes Ruby réouvertes voient leurs `fields` / `methods` fusionnés dans un unique nœud canonique au lieu d'être écrasés.
+- **Recherche renforcée** — `BeaconIndex` utilise `casefold()`, ainsi l'allemand `ß`, le turc `i/İ`, le grec `σ/ς` et les libellés CJK matchent correctement.
+- **Contexte sémantique enrichi** — chaque chunk de tâche transporte désormais les appelants / appelés du graphe via `neighbors`, ce qui garde le LLM ancré sur de vrais libellés. `SKILL.md` ajoute **Step 0 — Constrained query expansion** pour que les flux `/codebeacon query` n'inventent pas de tokens fantômes.
+- **Garde « zéro rendement » de `semantic-apply`** — si tous les chunks ont archivé 0 arête, la CLI termine avec exit 1 pour que la CI détecte les échecs silencieux du LLM.
+- **ArkTS (`.ets`) et sécurité worktree** — `.ets` est collecté ; les dossiers `worktrees/` imbriqués sont ignorés pour éviter l'indexation en double des worktrees liées.
+
+---
+
 ## Pourquoi codebeacon ?
 
 À chaque nouvelle session de développement assisté par IA, l'assistant repart de zéro. Il ne connaît ni vos routes, ni votre couche de services, ni votre modèle d'entités, ni les relations entre vos microservices. Vous passez le début de chaque session à coller des fichiers, expliquer la structure et rétablir le contexte.
@@ -94,8 +111,9 @@ codebeacon sync                     # exécutions suivantes via la configuration
 | Ruby | Rails |
 | PHP | Laravel |
 | Rust | Actix-Web, Axum, Tauri, Rocket, Warp |
-| C# | ASP.NET Core |
+| C# | ASP.NET Core, Blazor (`.razor`, `.cshtml`) ; `.sln` / `.csproj` / `.fsproj` / `.vbproj` analysés pour `ProjectReference` + `PackageReference` |
 | Swift | Vapor |
+| ArkTS | `.ets` (HarmonyOS) collecté — les extracteurs sont framework-agnostiques |
 
 ---
 
@@ -369,10 +387,19 @@ codebeacon scan . --wiki-only             # ignorer la ré-extraction, régéné
 codebeacon scan . --semantic              # extraction des références dans commentaires structurés (Javadoc/JSDoc/docstring)
 codebeacon scan . --list-only             # détecter les frameworks uniquement
 codebeacon scan /workspace --deep-dive    # sortie par projet + workspace combiné
+codebeacon scan . --exclude 'docs/**' --exclude '*.gen.ts'
+                                          # motifs gitignore répétables
+                                          # fusionnés avec .codebeaconignore / .gitignore
 
 codebeacon init [chemin]                  # générer codebeacon.yaml
 codebeacon sync                           # exécuter depuis codebeacon.yaml (ajoute automatiquement les nouveaux projets du workspace)
 codebeacon sync --no-rediscover           # ne pas ajouter automatiquement les nouveaux projets (mode yaml géré manuellement)
+codebeacon sync --exclude PATTERN         # même drapeau, même sémantique
+
+# PR / CI : qu'est-ce que ce diff casse vraiment ?
+codebeacon affected --base main           # remonter les appelants des fichiers modifiés
+codebeacon affected --base origin/main --head HEAD --depth 4 --limit 200
+codebeacon affected src/foo.py src/bar.py  # chemins explicites — pas besoin de git
 
 codebeacon query <terme> [--dir .codebeacon] [--limit N]   # rechercher des nœuds par sous-chaîne de label
 codebeacon path <source> <cible> [--dir .codebeacon]       # chemin de dépendances le plus court
@@ -397,7 +424,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
                                           # durable). Supprime les résultats, régénère tout.
 
 codebeacon serve [--dir .codebeacon]      # serveur MCP (stdio)
-codebeacon install                        # installer le skill Claude Code
+codebeacon install                        # installer le skill Claude Code (portée utilisateur : ~/.claude/)
+codebeacon install --project [PATH]       # installer dans <PATH>/.claude/ (partagé en équipe, épinglé au dépôt)
 codebeacon upgrade                        # pip upgrade + rafraîchir ~/.claude/skills/codebeacon/SKILL.md
                                           # (`--force` si installé en mode éditable)
 ```

{codebeacon-0.5.0 → codebeacon-0.6.0}/README.ja.md

@@ -27,6 +27,23 @@
 
 ---
 
+## 0.6.0 の新機能
+
+- **`codebeacon affected`** — 変更されたファイル一覧（または `--base <ref>` で git diff）を受け取り、その影響範囲にあるグラフノードをすべて出力。CI のリスクスコアリングや PR レビュー向け。
+- **`.NET` プロジェクトファイル** — `.sln`, `.csproj`, `.fsproj`, `.vbproj`, `.razor`, `.cshtml` を解析。`<ProjectReference>` / `<PackageReference>` がグラフエッジとなり、Razor `@inherits` / `@inject` / `@using` が Blazor ページを背後の型に接続。
+- **JS/TS バレル re-export** — `export { X } from './mod'`, `export * from './mod'` が明示的な `re_exports` エッジを生成。Next.js / モノレポのバレルが import 0 と表示されなくなりました。
+- **`--exclude PATTERN` フラグ**（`scan` / `sync` 両方）+ `.codebeaconignore` がない場合は `.gitignore` を自動フォールバック。
+- **`codebeacon install --project [PATH]`** — `~/.claude/` ではなく `<PATH>/.claude/` に `/codebeacon` スキルをインストール。チームが SKILL.md のバージョンをリポジトリに固定できます。
+- **wiki の自動クリーンアップ** — `--update` 実行時、グラフに存在しなくなった `wiki/<project>/{controllers,services,entities,components}/*.md` を自動削除。
+- **明示的削除時は shrink-guard をバイパス** — `--update` モードでキャッシュが既に削除を反映している場合、より小さい `beacon.json` の書き込みを拒否しなくなりました。silent corruption へのガードは維持。
+- **Cross-file 宣言の union マージ** — Swift `extension Foo`, C# partial class, Ruby reopened class の `fields` / `methods` が最後の書き込みで上書きされず、単一の canonical ノードにマージされます。
+- **query の強化** — `BeaconIndex` が `casefold()` を使うので、ドイツ語 `ß`、トルコ語 `i/İ`、ギリシャ語 `σ/ς`、CJK ラベルのマッチが正しく動作。
+- **セマンティックコンテキストの強化** — 各タスクチャンクにグラフの caller / callee が `neighbors` として同梱され、LLM が実在ノードラベルから離れにくくなりました。`SKILL.md` に **Step 0 — Constrained query expansion** を追加し、`/codebeacon query` フローが phantom トークンを発明できないよう明示。
+- **`semantic-apply` zero-yield ガード** — すべてのチャンクが 0 エッジでアーカイブされた場合、CLI が exit 1 で終了し、CI が LLM のサイレント失敗を検出できます。
+- **ArkTS (`.ets`) と worktree 安全性** — `.ets` を収集、ネストされた `worktrees/` ディレクトリをスキップし、linked worktree の重複インデックスを防止。
+
+---
+
 ## なぜ codebeacon なのか
 
 AI コーディングセッションを新しく開くたびに、アシスタントは白紙の状態から始まります。ルート構造も、サービス層も、エンティティモデルも、マイクロサービス間の呼び出し関係も把握していません。毎回のセッションでファイルを貼り付け、構造を説明し、コンテキストを再設定するために多くの時間を費やすことになります。
@@ -94,8 +111,9 @@ codebeacon sync                      # 以降の実行は設定ファイルベ
 | Ruby | Rails |
 | PHP | Laravel |
 | Rust | Actix-Web、Axum、Tauri、Rocket、Warp |
-| C# | ASP.NET Core |
+| C# | ASP.NET Core, Blazor (`.razor`, `.cshtml`); `.sln` / `.csproj` / `.fsproj` / `.vbproj` から `ProjectReference` + `PackageReference` を解析 |
 | Swift | Vapor |
+| ArkTS | `.ets` (HarmonyOS) を収集 — extractor は framework-agnostic |
 
 ---
 
@@ -274,12 +292,21 @@ codebeacon scan . --obsidian-dir <path>   # Obsidian Vault をカスタム場所
 codebeacon scan . --semantic              # 構造化コメント参照（Javadoc/JSDoc/docstring）の抽出を有効化
 codebeacon scan . --list-only             # フレームワーク検出のみ、抽出なし
 codebeacon scan /workspace --deep-dive    # プロジェクト別 + 統合ワークスペース出力
+codebeacon scan . --exclude 'docs/**' --exclude '*.gen.ts'
+                                          # 繰り返し可能な gitignore スタイルパターン
+                                          # .codebeaconignore / .gitignore とマージ
 
 # 設定ベースモード
 codebeacon init [path]                    # codebeacon.yaml を自動生成
 codebeacon sync                           # codebeacon.yaml ベースで実行 (新規ワークスペースプロジェクトを自動追加)
 codebeacon sync --config <file>           # 特定の設定ファイルを使用
 codebeacon sync --no-rediscover           # 新規プロジェクトの自動追加を無効化 (手動キュレーションモード)
+codebeacon sync --exclude PATTERN         # 同じフラグ、同じ意味
+
+# PR / CI: この diff は実際に何を壊すのか?
+codebeacon affected --base main           # 変更ファイルの上流呼び出し元を walk
+codebeacon affected --base origin/main --head HEAD --depth 4 --limit 200
+codebeacon affected src/foo.py src/bar.py  # 明示パス — git なしでも動作
 
 # ナレッジグラフのクエリ
 codebeacon query <term> [--dir .codebeacon] [--limit N]   # ラベル部分文字列でノード検索
@@ -306,7 +333,8 @@ codebeacon semantic-apply   [--dir .codebeacon]
 
 # インテグレーション
 codebeacon serve [--dir .codebeacon]      # MCP サーバー起動 (stdio)
-codebeacon install                        # Claude Code スキルをインストール
+codebeacon install                        # Claude Code スキルをインストール (user スコープ: ~/.claude/)
+codebeacon install --project [PATH]       # <PATH>/.claude/ にインストール (チーム共有・リポジトリ固定)
 codebeacon upgrade                        # pip で更新 + ~/.claude/skills/codebeacon/SKILL.md を再生成
                                           # (`--force` で editable インストール時も強制実行)
 ```

{codebeacon-0.5.0 → codebeacon-0.6.0}/README.ko.md

@@ -27,6 +27,23 @@
 
 ---
 
+## 0.6.0 새 소식
+
+- **`codebeacon affected`** — 변경된 파일 목록(또는 `--base <ref>`로 git diff)을 받아 그 영향권에 있는 그래프 노드를 모두 출력. CI 리스크 스코어링·PR 리뷰용.
+- **`.NET` 프로젝트 파일** — `.sln`, `.csproj`, `.fsproj`, `.vbproj`, `.razor`, `.cshtml`가 이제 파싱됩니다. `<ProjectReference>` / `<PackageReference>`가 그래프 엣지로, Razor `@inherits` / `@inject` / `@using`이 Blazor 페이지를 백엔드 타입으로 연결합니다.
+- **JS/TS 배럴 re-export** — `export { X } from './mod'`, `export * from './mod'`가 명시적 `re_exports` 엣지가 됩니다. Next.js·모노레포 배럴이 더 이상 import 0으로 표시되지 않습니다.
+- **`--exclude PATTERN` 플래그** (`scan` / `sync`) + `.codebeaconignore`가 없을 때 자동 `.gitignore` 폴백.
+- **`codebeacon install --project [PATH]`** — `~/.claude/` 대신 `<PATH>/.claude/`에 `/codebeacon` 스킬 설치. 팀이 SKILL.md 버전을 레포에 핀할 수 있습니다.
+- **wiki 자동 정리** — `--update` 실행 시 더 이상 그래프에 없는 `wiki/<project>/{controllers,services,entities,components}/*.md` 파일을 자동 삭제.
+- **명시 삭제 시 shrink-guard 우회** — `--update` 모드에서 캐시가 이미 삭제된 파일을 추적했다면 더 작은 `beacon.json` 쓰기를 거부하지 않습니다. silent corruption에 대한 가드는 그대로.
+- **Cross-file 선언 union 머지** — Swift `extension Foo`, C# partial class, Ruby reopened class가 `fields` / `methods`를 마지막 파일에 덮어쓰지 않고 단일 canonical 노드로 합쳐집니다.
+- **query 강화** — `BeaconIndex`가 `casefold()`를 사용해 독일어 `ß`, 터키어 `i/İ`, 그리스어 `σ/ς`, CJK 라벨 매칭이 올바르게 동작합니다.
+- **시맨틱 컨텍스트 강화** — 각 task chunk에 그래프 caller·callee가 `neighbors`로 동봉되어 LLM이 실제 노드 라벨에서 벗어나기 어렵습니다. `SKILL.md`에 **Step 0 — Constrained query expansion** 추가로 `/codebeacon query` 흐름이 phantom 토큰을 만들지 못하도록 명시.
+- **`semantic-apply` zero-yield 가드** — 모든 chunk가 0 엣지로 archive되면 CLI가 exit 1로 종료해 CI가 LLM의 silent 실패를 잡습니다.
+- **ArkTS (`.ets`) + worktree 안전** — `.ets` 수집, 중첩 `worktrees/` 디렉토리는 스킵해 linked worktree가 중복 인덱싱되지 않습니다.
+
+---
+
 ## 왜 codebeacon인가?
 
 AI 코딩 세션을 새로 열 때마다 어시스턴트는 백지 상태에서 시작합니다. 라우트 구조도, 서비스 레이어도, 엔티티 모델도, 마이크로서비스 간 호출 관계도 모릅니다. 결국 세션마다 파일을 붙여넣고, 구조를 설명하고, 컨텍스트를 다시 세팅하는 데 상당한 시간을 씁니다.
@@ -94,8 +111,9 @@ codebeacon sync                      # 이후 실행은 설정 파일 기반
 | Ruby | Rails |
 | PHP | Laravel |
 | Rust | Actix-Web, Axum, Tauri, Rocket, Warp |
-| C# | ASP.NET Core |
+| C# | ASP.NET Core, Blazor (`.razor`, `.cshtml`); `.sln` / `.csproj` / `.fsproj` / `.vbproj`에서 `ProjectReference` + `PackageReference` 파싱 |
 | Swift | Vapor |
+| ArkTS | `.ets` (HarmonyOS) 수집 — extractor는 framework-agnostic |
 
 ---
 
@@ -314,12 +332,21 @@ codebeacon scan . --obsidian-dir <path>   # Obsidian 볼트를 커스텀 위치
 codebeacon scan . --semantic              # 구조화 주석 시맨틱 추출 활성화 (Javadoc/JSDoc/docstring 참조)
 codebeacon scan . --list-only             # 프레임워크 감지만, 추출 제외
 codebeacon scan /workspace --deep-dive    # 프로젝트별 + 통합 워크스페이스 출력
+codebeacon scan . --exclude 'docs/**' --exclude '*.gen.ts'
+                                          # gitignore-스타일 패턴, 반복 가능
+                                          # .codebeaconignore / .gitignore 와 병합
 
 # 설정 기반 모드
 codebeacon init [path]                    # codebeacon.yaml 자동 생성
 codebeacon sync                           # codebeacon.yaml 기반 실행 (신규 워크스페이스 프로젝트 자동 추가)
 codebeacon sync --config <file>           # 특정 설정 파일 사용
 codebeacon sync --no-rediscover           # 신규 프로젝트 자동 추가 비활성화 (수동 큐레이션 모드)
+codebeacon sync --exclude PATTERN         # 동일 플래그 동일 의미
+
+# PR / CI: 이 diff 가 실제로 무엇을 깰까?
+codebeacon affected --base main           # 변경 파일들의 업스트림 호출자 walk
+codebeacon affected --base origin/main --head HEAD --depth 4 --limit 200
+codebeacon affected src/foo.py src/bar.py  # 명시 경로 — git 없이도 동작
 
 # AI-시맨틱 보강 (LLM 작업은 에이전트가, 부기는 codebeacon이 담당)
 codebeacon semantic-prepare [--dir .codebeacon] [--max-tasks N] [--chunk-size N]
@@ -347,7 +374,8 @@ codebeacon merge-driver <base> <cur> <other>  # `hook install` 후 git이 자동
 
 # 통합
 codebeacon serve [--dir .codebeacon]      # MCP 서버 시작 (stdio)
-codebeacon install                        # Claude Code 스킬 설치
+codebeacon install                        # Claude Code 스킬 설치 (user 스코프: ~/.claude/)
+codebeacon install --project [PATH]       # <PATH>/.claude/ 에 설치 (팀 공유, 레포 핀)
 codebeacon upgrade                        # pip 으로 업그레이드 + ~/.claude/skills/codebeacon/SKILL.md 갱신
                                           # (`--force` 로 editable 설치 환경에서도 강제 업그레이드)
 ```

codebeacon-0.5.0/PKG-INFO → codebeacon-0.6.0/README.md

@@ -1,46 +1,3 @@
-Metadata-Version: 2.4
-Name: codebeacon
-Version: 0.5.0
-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
-Project-URL: Issues, https://github.com/codebeacon/codebeacon/issues
-License: MIT
-License-File: LICENSE
-Keywords: ai-context,ast,claude,codebase,knowledge-graph,mcp
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
-Requires-Dist: networkx>=3.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: tree-sitter-c-sharp>=0.23
-Requires-Dist: tree-sitter-go>=0.23
-Requires-Dist: tree-sitter-html>=0.23
-Requires-Dist: tree-sitter-java>=0.23
-Requires-Dist: tree-sitter-javascript>=0.23
-Requires-Dist: tree-sitter-kotlin>=0.23
-Requires-Dist: tree-sitter-php>=0.23
-Requires-Dist: tree-sitter-python>=0.23
-Requires-Dist: tree-sitter-ruby>=0.23
-Requires-Dist: tree-sitter-rust>=0.23
-Requires-Dist: tree-sitter-svelte>=0.23
-Requires-Dist: tree-sitter-swift>=0.0.1
-Requires-Dist: tree-sitter-typescript>=0.23
-Requires-Dist: tree-sitter>=0.23
-Provides-Extra: cluster
-Requires-Dist: graspologic>=1.0; extra == 'cluster'
-Provides-Extra: dev
-Requires-Dist: pytest-cov>=4.0; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Description-Content-Type: text/markdown
-
 <p align="center">
   <a href="https://github.com/Wandererer/codebeacon/blob/main/README.md"><img src="https://img.shields.io/badge/lang-English-blue" alt="English"></a>
   <a href="https://github.com/Wandererer/codebeacon/blob/main/README.ko.md"><img src="https://img.shields.io/badge/lang-한국어-red" alt="Korean"></a>
@@ -68,6 +25,23 @@ Description-Content-Type: text/markdown
 
 ---
 
+## What's new in 0.6.0
+
+- **`codebeacon affected`** — given a list of changed files (or a `--base <ref>` git diff), prints every graph node downstream of the change. Built for CI risk-scoring and PR review.
+- **`.NET` project files** — `.sln`, `.csproj`, `.fsproj`, `.vbproj`, `.razor`, `.cshtml` are now parsed: `<ProjectReference>` / `<PackageReference>` become graph edges, Razor `@inherits` / `@inject` / `@using` link Blazor pages to their backing types.
+- **JS/TS barrel re-exports** — `export { X } from './mod'` and `export * from './mod'` now produce explicit `re_exports` edges so Next.js / monorepo barrels stop showing zero imports.
+- **`--exclude PATTERN` flag** for `scan` / `sync`, plus automatic fallback to `.gitignore` when `.codebeaconignore` is absent.
+- **`codebeacon install --project [PATH]`** — install the `/codebeacon` skill into `<PATH>/.claude/` instead of `~/.claude/`, so teams can pin a SKILL.md version per repo.
+- **Wiki self-heals** — `--update` runs now prune `wiki/<project>/{controllers,services,entities,components}/*.md` files whose graph node no longer exists.
+- **Shrink-guard relaxed for explicit deletions** — `--update` mode no longer refuses to write a smaller `beacon.json` when the cache already accounted for deleted files; the guard still fires on silent corruption.
+- **Cross-file declaration merge** — Swift `extension Foo`, C# partial classes, Ruby reopened classes union their `fields` / `methods` into one canonical node instead of the last writer winning.
+- **Hardened query** — `BeaconIndex` uses `casefold()` so German `ß`, Turkish `i/İ`, Greek `σ/ς`, and CJK labels round-trip correctly.
+- **Richer semantic context** — each task chunk now ships graph callers + callees as `neighbors` so the LLM stays grounded in real node labels; `SKILL.md` adds **Step 0 — Constrained query expansion** so `/codebeacon query` flows can't invent phantom tokens.
+- **`semantic-apply` zero-yield guard** — if every chunk archived 0 edges, the CLI exits 1 so CI catches silent LLM failures.
+- **ArkTS (`.ets`) and worktree-safety** — `.ets` is collected; nested `worktrees/` dirs are skipped to stop double-counting linked worktrees.
+
+---
+
 ## Why codebeacon?
 
 Every time you open a new AI coding session, your assistant starts blind. It doesn't know your routes, your service layer, your entity model, or how your microservices call each other. You spend the first chunk of every session just getting the AI back up to speed — pasting files, explaining structure, re-establishing context.
@@ -135,8 +109,9 @@ codebeacon sync                      # subsequent runs via config
 | Ruby | Rails |
 | PHP | Laravel |
 | Rust | Actix-Web, Axum, Tauri, Rocket, Warp |
-| C# | ASP.NET Core |
+| C# | ASP.NET Core, Blazor (`.razor`, `.cshtml`); `.sln` / `.csproj` / `.fsproj` / `.vbproj` parsed for `ProjectReference` + `PackageReference` |
 | Swift | Vapor |
+| ArkTS | `.ets` (HarmonyOS) collected — extractors framework-agnostic |
 
 ---
 
@@ -356,12 +331,21 @@ codebeacon scan . --obsidian-dir <path>   # write Obsidian vault to custom locat
 codebeacon scan . --semantic              # enable structured-comment semantic extraction (Javadoc/JSDoc/docstring refs)
 codebeacon scan . --list-only             # detect frameworks only, don't extract
 codebeacon scan /workspace --deep-dive    # per-project + combined workspace outputs
+codebeacon scan . --exclude 'docs/**' --exclude '*.gen.ts'
+                                          # repeatable gitignore-style patterns merged with
+                                          # .codebeaconignore / .gitignore
 
 # Config-driven mode
 codebeacon init [path]                    # auto-generate codebeacon.yaml
 codebeacon sync                           # run from codebeacon.yaml (auto-appends new workspace projects)
 codebeacon sync --config <file>           # use a specific config file
 codebeacon sync --no-rediscover           # don't auto-append newly added projects (hand-curated yaml mode)
+codebeacon sync --exclude PATTERN         # same flag, same semantics
+
+# PR / CI: what does this diff actually break?
+codebeacon affected --base main           # walk upstream callers of every changed file
+codebeacon affected --base origin/main --head HEAD --depth 4 --limit 200
+codebeacon affected src/foo.py src/bar.py  # explicit paths, no git needed
 
 # AI-semantic enrichment (the agent does the LLM work, codebeacon does the bookkeeping)
 codebeacon semantic-prepare [--dir .codebeacon] [--max-tasks N] [--chunk-size N]
@@ -390,7 +374,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 install                        # install Claude Code skill (user scope: ~/.claude/)
+codebeacon install --project [PATH]       # install into <PATH>/.claude/ (team-shared, repo-pinned)
 codebeacon upgrade                        # pip install --upgrade + refresh ~/.claude/skills/codebeacon/SKILL.md
                                           # (`--force` to upgrade even when installed in editable mode)
 ```