codebeacon 0.5.0__tar.gz → 0.6.1__tar.gz

codebeacon-0.6.1/.cursorrules

@@ -0,0 +1,74 @@
+<!-- codebeacon:start -->
+# Project Context
+
+## Lookup strategy
+
+> A pre-built index lives in `.codebeacon/`. Use the 3-step lookup below
+> before reaching for Glob or Grep.
+
+> **Repo type:** `single` — Single-project repo.
+
+### Step 1 — codebeacon wiki
+Routes, controllers, services, entities.
+```
+.codebeacon/wiki/index.md                    ← global index
+.codebeacon/wiki/{project}/controllers/{Name}.md  ← controller logic
+.codebeacon/wiki/{project}/services/{Name}.md     ← service methods
+.codebeacon/wiki/{project}/entities/{Name}.md     ← data models
+.codebeacon/wiki/routes.md                   ← all API routes across projects
+```
+
+### Step 2 — obsidian notes
+Class-level detail (methods, fields, incoming/outgoing edges) the wiki omits.
+Look up by class name — replace `{project}` with the relevant folder:
+```
+.codebeacon/obsidian/{project}/{ClassName}.md
+```
+
+| Project | Notes | Example |
+| --- | --- | --- |
+| codebeacon | 398 services, 3 entities | `affected_from_paths.py.md` |
+
+### Step 3 — source file
+Open the paths surfaced by Steps 1–2.
+
+---
+
+## Projects
+
+| Project | Framework | Routes | Services | Entities | Components |
+| --- | --- | --- | --- | --- | --- |
+| codebeacon | python | 5 | 398 | 3 | 0 |
+
+---
+
+## Common Commands
+
+### codebeacon (python)
+```bash
+# see project README  # build
+# see project README  # run
+# see project README  # all tests
+```
+
+---
+
+## Architecture
+
+**codebeacon**: **python** · python
+  Routes: 5 | Services: 398 | Entities: 3 | Components: 0
+
+## High-Impact Files
+
+Changes here affect many other files:
+
+- `codebeacon/semantic_pipeline.py` (imported by 56 files)
+- `codebeacon/pipeline.py` (imported by 12 files)
+- `tests/test_graph.py` (imported by 6 files)
+- `tests/integration/test_full_pipeline.py` (imported by 3 files)
+- `tests/test_known_bugs.py` (imported by 2 files)
+
+---
+
+_Generated by [codebeacon](https://github.com/codebeacon/codebeacon) · 2026-05-31_
+<!-- codebeacon:end -->

codebeacon-0.6.1/AGENTS.md

@@ -0,0 +1,74 @@
+<!-- codebeacon:start -->
+# AGENTS.md
+
+## Lookup strategy
+
+> A pre-built index lives in `.codebeacon/`. Follow the 3-step lookup below
+> so parallel agents converge on the same answer.
+
+> **Repo type:** `single` — Single-project repo.
+
+### Step 1 — codebeacon wiki
+Routes, controllers, services, entities.
+```
+.codebeacon/wiki/index.md                    ← global index
+.codebeacon/wiki/{project}/controllers/{Name}.md  ← controller logic
+.codebeacon/wiki/{project}/services/{Name}.md     ← service methods
+.codebeacon/wiki/{project}/entities/{Name}.md     ← data models
+.codebeacon/wiki/routes.md                   ← all API routes across projects
+```
+
+### Step 2 — obsidian notes
+Class-level detail (methods, fields, incoming/outgoing edges) the wiki omits.
+Look up by class name — replace `{project}` with the relevant folder:
+```
+.codebeacon/obsidian/{project}/{ClassName}.md
+```
+
+| Project | Notes | Example |
+| --- | --- | --- |
+| codebeacon | 398 services, 3 entities | `affected_from_paths.py.md` |
+
+### Step 3 — source file
+Open the paths surfaced by Steps 1–2.
+
+---
+
+## Projects
+
+| Project | Framework | Routes | Services | Entities | Components |
+| --- | --- | --- | --- | --- | --- |
+| codebeacon | python | 5 | 398 | 3 | 0 |
+
+---
+
+## Common Commands
+
+### codebeacon (python)
+```bash
+# see project README  # build
+# see project README  # run
+# see project README  # all tests
+```
+
+---
+
+## Architecture
+
+**codebeacon**: **python** · python
+  Routes: 5 | Services: 398 | Entities: 3 | Components: 0
+
+## High-Impact Files
+
+Changes here affect many other files:
+
+- `codebeacon/semantic_pipeline.py` (imported by 56 files)
+- `codebeacon/pipeline.py` (imported by 12 files)
+- `tests/test_graph.py` (imported by 6 files)
+- `tests/integration/test_full_pipeline.py` (imported by 3 files)
+- `tests/test_known_bugs.py` (imported by 2 files)
+
+---
+
+_Generated by [codebeacon](https://github.com/codebeacon/codebeacon) · 2026-05-31_
+<!-- codebeacon:end -->

codebeacon-0.6.1/CLAUDE.md

@@ -0,0 +1,79 @@
+<!-- codebeacon:start -->
+# CLAUDE.md
+
+## Lookup strategy
+
+> This repo ships a pre-built index in `.codebeacon/`. Check it first —
+> most "where is X" questions resolve in one read without a full-repo search.
+
+> **Repo type:** `single` — Single-project repo.
+
+### Step 1 — codebeacon wiki
+Routes, controllers, services, entities.
+```
+.codebeacon/wiki/index.md                    ← global index
+.codebeacon/wiki/{project}/controllers/{Name}.md  ← controller logic
+.codebeacon/wiki/{project}/services/{Name}.md     ← service methods
+.codebeacon/wiki/{project}/entities/{Name}.md     ← data models
+.codebeacon/wiki/routes.md                   ← all API routes across projects
+```
+
+### Step 2 — obsidian notes
+Class-level detail (methods, fields, incoming/outgoing edges) the wiki omits.
+Look up by class name — replace `{project}` with the relevant folder:
+```
+.codebeacon/obsidian/{project}/{ClassName}.md
+```
+
+| Project | Notes | Example |
+| --- | --- | --- |
+| codebeacon | 398 services, 3 entities | `affected_from_paths.py.md` |
+
+### Step 3 — source file
+Open the paths surfaced by Steps 1–2.
+
+### Fall back to direct search
+Reach for Glob, Grep, or the Explore agent when the index does not cover
+what you need — new files, deep implementation details, or cross-cutting
+searches that span projects.
+
+---
+
+## Projects
+
+| Project | Framework | Routes | Services | Entities | Components |
+| --- | --- | --- | --- | --- | --- |
+| codebeacon | python | 5 | 398 | 3 | 0 |
+
+---
+
+## Common Commands
+
+### codebeacon (python)
+```bash
+# see project README  # build
+# see project README  # run
+# see project README  # all tests
+```
+
+---
+
+## Architecture
+
+**codebeacon**: **python** · python
+  Routes: 5 | Services: 398 | Entities: 3 | Components: 0
+
+## High-Impact Files
+
+Changes here affect many other files:
+
+- `codebeacon/semantic_pipeline.py` (imported by 56 files)
+- `codebeacon/pipeline.py` (imported by 12 files)
+- `tests/test_graph.py` (imported by 6 files)
+- `tests/integration/test_full_pipeline.py` (imported by 3 files)
+- `tests/test_known_bugs.py` (imported by 2 files)
+
+---
+
+_Generated by [codebeacon](https://github.com/codebeacon/codebeacon) · 2026-05-31_
+<!-- codebeacon:end -->

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

@@ -1,3 +1,96 @@
+Metadata-Version: 2.4
+Name: codebeacon
+Version: 0.6.1
+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,39 @@
 
 ---
 
+## What's new in 0.6.1
+
+Patch release — extraction correctness and reproducible output.
+
+- **Six framework extractors restored** — the `laravel`, `angular`, `aspnet`, `actix`, `ktor`, and `vapor` tree-sitter queries had drifted out of sync with current grammar versions and silently extracted **nothing**: the query failed to compile and the error was swallowed as a warning. All six now compile and extract against the shipped grammars (Laravel `scope:`/`name:` fields, Angular `export class` decorators, ASP.NET `invocation_expression` fields, Actix sibling-anchored attributes, Kotlin 1.x node renames, Swift 0.0.1 node set), each with a regression test so they can't silently break again.
+- **Reproducible `beacon.json`** — node `source_file` paths are rewritten relative to each project root before serialization, so scanning the same commit on two machines produces a byte-identical graph instead of churning absolute paths in diffs.
+- **`affected` no longer over-reports** — changed-file seed matching is path-segment aligned, so `src/user.py` no longer drags in unrelated nodes such as `foosrc/user.py`.
+- **`semantic-apply` crash fix** — a `confidence_score: null` in an archived/migrated JSONL edge no longer aborts the run with a `TypeError`; it coerces to the safe default like the rest of the pipeline.
+- **NetworkX 3.6 forward-compat** — `beacon.json` is written with an explicit `edges="links"` key so an upstream default change can't silently alter the on-disk format; the MCP server now loads through the same compatibility shim.
+- **Obsidian vault hygiene** — stale-note cleanup sweeps the whole vault (root + nested), and the cross-language import filter keys off the note's real source language instead of a filename suffix that never matched.
+- **gitignore semantics** — anchored patterns like `build/*.js` no longer let `*` cross `/`, so nested files are not wrongly ignored.
+- **Next.js App Router** — JS-based `page.js` / `page.jsx` routes are now discovered (previously only `.ts` / `.tsx`).
+- **DI attribution fixes** — FastAPI `Depends()` and Angular constructor injection are attributed to the enclosing function/class by byte range instead of the first/last one in the file; Razor `@using` no longer emits duplicate edges.
+
+---
+
+## 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 +218,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 +440,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 +483,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.1}/README.de.md

@@ -27,6 +27,39 @@
 
 ---
 
+## Neu in 0.6.1
+
+Patch-Release — Extraktionskorrektheit und reproduzierbare Ausgabe.
+
+- **Sechs Framework-Extraktoren wiederhergestellt** — die tree-sitter-Queries für `laravel`, `angular`, `aspnet`, `actix`, `ktor` und `vapor` waren mit aktuellen Grammatik-Versionen aus dem Takt geraten und extrahierten **nichts**: die Query ließ sich nicht kompilieren und der Fehler wurde als Warnung verschluckt. Alle sechs kompilieren und extrahieren nun gegen die mitgelieferten Grammatiken (Laravel `scope:`/`name:`-Felder, Angular `export class`-Dekoratoren, ASP.NET `invocation_expression`-Felder, Actix geschwister-verankerte Attribute, Kotlin-1.x-Knotenumbenennungen, Swift-0.0.1-Knotensatz) — jeweils mit Regressionstest gegen erneutes stilles Brechen.
+- **Reproduzierbare `beacon.json`** — `source_file`-Pfade der Knoten werden vor der Serialisierung relativ zum jeweiligen Projekt-Root umgeschrieben, sodass das Scannen desselben Commits auf zwei Maschinen einen byte-identischen Graphen erzeugt statt absolute Pfade im Diff zu wälzen.
+- **`affected` meldet nicht mehr zu viel** — der Seed-Abgleich geänderter Dateien ist nun pfadsegment-ausgerichtet, sodass `src/user.py` keine fremden Knoten wie `foosrc/user.py` mehr hineinzieht.
+- **`semantic-apply`-Absturz behoben** — ein `confidence_score: null` in einer archivierten/migrierten JSONL-Kante bricht den Lauf nicht mehr mit `TypeError` ab, sondern wird wie im Rest der Pipeline auf den sicheren Standard normalisiert.
+- **NetworkX-3.6-Vorwärtskompatibilität** — `beacon.json` wird mit explizitem `edges="links"`-Schlüssel geschrieben, damit eine geänderte Upstream-Voreinstellung das Festplattenformat nicht still verändert; der MCP-Server lädt über dieselbe Kompatibilitätsschicht.
+- **Obsidian-Vault-Hygiene** — die Bereinigung veralteter Notizen erfasst den gesamten Vault (Root + verschachtelt), und der Cross-Language-Import-Filter richtet sich nach der echten Quellsprache der Notiz statt nach einem Dateinamen-Suffix, das nie passte.
+- **gitignore-Semantik** — verankerte Muster wie `build/*.js` lassen `*` nicht mehr über `/` greifen, sodass verschachtelte Dateien nicht fälschlich ignoriert werden.
+- **Next.js App Router** — JS-basierte `page.js` / `page.jsx`-Routen werden nun erkannt (zuvor nur `.ts` / `.tsx`).
+- **DI-Zuordnungskorrekturen** — FastAPI `Depends()` und Angular-Konstruktor-Injektion werden per Byte-Range der umschließenden Funktion/Klasse zugeordnet statt der ersten/letzten in der Datei; Razor `@using` erzeugt keine doppelten Kanten mehr.
+
+---
+
+## 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 +127,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 +404,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 +441,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.1}/README.es.md

@@ -27,6 +27,39 @@
 
 ---
 
+## Novedades en 0.6.1
+
+Versión de parche — corrección de extracción y salida reproducible.
+
+- **Seis extractores de frameworks restaurados** — las queries tree-sitter de `laravel`, `angular`, `aspnet`, `actix`, `ktor` y `vapor` se habían desincronizado de las versiones actuales de las gramáticas y no extraían **nada**: la query no compilaba y el error se silenciaba como advertencia. Las seis ahora compilan y extraen contra las gramáticas incluidas (campos `scope:`/`name:` de Laravel, decoradores `export class` de Angular, campos `invocation_expression` de ASP.NET, atributos anclados a hermanos de Actix, renombrados de nodos de Kotlin 1.x, conjunto de nodos de Swift 0.0.1), cada una con un test de regresión para que no vuelvan a romperse en silencio.
+- **`beacon.json` reproducible** — las rutas `source_file` de los nodos se reescriben relativas a la raíz de cada proyecto antes de serializar, así escanear el mismo commit en dos máquinas produce un grafo idéntico byte a byte en lugar de remover rutas absolutas en los diffs.
+- **`affected` ya no sobre-reporta** — la coincidencia de archivos cambiados está alineada por segmentos de ruta, de modo que `src/user.py` ya no arrastra nodos ajenos como `foosrc/user.py`.
+- **Corrección de fallo en `semantic-apply`** — un `confidence_score: null` en una arista JSONL archivada/migrada ya no aborta la ejecución con `TypeError`; se normaliza al valor seguro por defecto como el resto del pipeline.
+- **Compatibilidad futura con NetworkX 3.6** — `beacon.json` se escribe con la clave explícita `edges="links"` para que un cambio de valor por defecto upstream no altere en silencio el formato en disco; el servidor MCP carga a través de la misma capa de compatibilidad.
+- **Higiene del vault de Obsidian** — la limpieza de notas obsoletas barre todo el vault (raíz + anidado), y el filtro de imports entre lenguajes se basa en el lenguaje real de la nota en vez de un sufijo de nombre de archivo que nunca coincidía.
+- **Semántica de gitignore** — los patrones anclados como `build/*.js` ya no permiten que `*` cruce `/`, así los archivos anidados no se ignoran por error.
+- **App Router de Next.js** — ahora se descubren las rutas `page.js` / `page.jsx` basadas en JS (antes solo `.ts` / `.tsx`).
+- **Correcciones de atribución de DI** — `Depends()` de FastAPI y la inyección por constructor de Angular se atribuyen a la función/clase contenedora por rango de bytes en vez de la primera/última del archivo; `@using` de Razor ya no emite aristas duplicadas.
+
+---
+
+## 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 +127,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 +402,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 +439,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)
 ```