codebeacon 0.3.0__tar.gz → 0.3.1__tar.gz

{codebeacon-0.3.0 → codebeacon-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codebeacon
-Version: 0.3.0
+Version: 0.3.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
@@ -96,6 +96,7 @@ Existing tools solve this partially. Route analyzers map your controllers but mi
 - **gitignore-style `.codebeaconignore`** — last-match-wins with `!` negation, dir patterns (`build/`), anchored patterns (`/secrets.txt`), trailing-whitespace rules
 - **Zero configuration** — auto-detects frameworks and languages; generates `codebeacon.yaml` for repeat runs
 - **Deep-dive mode** — `--deep-dive` generates per-project `.codebeacon/` + `CLAUDE.md` for every sub-project; running `codebeacon scan . --update` from any sub-project folder automatically syncs all projects in the workspace
+- **Workspace auto-rediscovery** — on every `scan` / `sync`, codebeacon re-scans the workspace and appends any new project folders to `codebeacon.yaml` before extraction, so freshly added sub-projects are never silently skipped; pass `--no-rediscover` to opt out for hand-curated configs
 
 ---
 
@@ -324,8 +325,9 @@ codebeacon scan /workspace --deep-dive    # per-project + combined workspace out
 
 # Config-driven mode
 codebeacon init [path]                    # auto-generate codebeacon.yaml
-codebeacon sync                           # run from 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)
 
 # Query the knowledge graph
 codebeacon query <term> [--dir .codebeacon] [--limit N]   # search nodes by label substring

{codebeacon-0.3.0 → codebeacon-0.3.1}/README.de.md

@@ -55,6 +55,7 @@ Bestehende Tools lösen dieses Problem nur teilweise. Route-Analyzer erfassen Ih
 - **`.codebeaconignore` im gitignore-Stil** — last-match-wins mit `!`-Negation, Verzeichnis-Patterns (`build/`), verankerte Patterns (`/secrets.txt`), Trailing-Whitespace-Regeln
 - **Keine Konfiguration notwendig** — erkennt Frameworks und Sprachen automatisch; generiert `codebeacon.yaml` für Folgeläufe
 - **Deep-Dive-Modus** — `--deep-dive` erzeugt für jedes Sub-Projekt eigene `.codebeacon/` + `CLAUDE.md`; ein Update-Aufruf aus **beliebigem** Sub-Projekt-Ordner synchronisiert automatisch alle Projekte im Workspace
+- **Automatische Workspace-Wiedererkennung** — bei jedem `scan`/`sync` scannt codebeacon den Workspace erneut und hängt vor der Extraktion automatisch neue Projekte an die `codebeacon.yaml` an, sodass frisch hinzugefügte Sub-Projekte nicht unbemerkt übersprungen werden; `--no-rediscover` deaktiviert dies für handgepflegte Konfigurationen
 
 ---
 
@@ -363,7 +364,8 @@ codebeacon scan . --list-only             # nur Frameworks erkennen
 codebeacon scan /workspace --deep-dive    # Pro-Projekt- + kombinierte Workspace-Ausgabe
 
 codebeacon init [pfad]                    # codebeacon.yaml generieren
-codebeacon sync                           # von codebeacon.yaml ausführen
+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 query <Begriff> [--dir .codebeacon] [--limit N]   # Knoten per Label-Substring suchen
 codebeacon path <Quelle> <Ziel> [--dir .codebeacon]          # kürzester Abhängigkeitspfad

{codebeacon-0.3.0 → codebeacon-0.3.1}/README.es.md

@@ -55,6 +55,7 @@ Las herramientas existentes resuelven esto de forma parcial. Los analizadores de
 - **`.codebeaconignore` estilo gitignore** — last-match-wins con negación `!`, patrones de directorio (`build/`), patrones anclados (`/secrets.txt`), reglas de espacio final
 - **Cero configuración** — detecta frameworks y lenguajes automáticamente; genera `codebeacon.yaml` para ejecuciones posteriores
 - **Modo Deep Dive** — `--deep-dive` genera `.codebeacon/` + `CLAUDE.md` propios para cada sub-proyecto; ejecutar el comando de actualización desde **cualquier** sub-proyecto sincroniza automáticamente todos los proyectos del workspace
+- **Auto-redescubrimiento del workspace** — en cada `scan`/`sync`, codebeacon re-escanea el workspace y añade automáticamente al `codebeacon.yaml` los nuevos proyectos antes de extraer, de modo que los sub-proyectos recién añadidos nunca se omitan silenciosamente; usa `--no-rediscover` para optar por el modo de configuración curada manualmente
 
 ---
 
@@ -362,7 +363,8 @@ codebeacon scan . --list-only             # solo detectar frameworks
 codebeacon scan /workspace --deep-dive    # salida por proyecto + workspace combinado
 
 codebeacon init [ruta]                    # generar codebeacon.yaml
-codebeacon sync                           # ejecutar desde 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 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

{codebeacon-0.3.0 → codebeacon-0.3.1}/README.fr.md

@@ -55,6 +55,7 @@ Les outils existants ne résolvent ce problème qu'en partie. Les analyseurs de
 - **`.codebeaconignore` style gitignore** — last-match-wins avec négation `!`, patterns de répertoire (`build/`), patterns ancrés (`/secrets.txt`), règles sur espaces de fin
 - **Zéro configuration** — détecte automatiquement les frameworks et langages ; génère `codebeacon.yaml` pour les exécutions suivantes
 - **Mode Deep Dive** — `--deep-dive` génère un `.codebeacon/` + `CLAUDE.md` propre à chaque sous-projet ; une commande de mise à jour depuis **n'importe quel** sous-projet synchronise automatiquement tous les projets du workspace
+- **Redécouverte automatique du workspace** — à chaque `scan`/`sync`, codebeacon réanalyse le workspace et ajoute automatiquement les nouveaux projets au `codebeacon.yaml` avant l'extraction, de sorte que les sous-projets fraîchement ajoutés ne soient jamais oubliés en silence ; utilisez `--no-rediscover` pour conserver une configuration yaml gérée manuellement
 
 ---
 
@@ -362,7 +363,8 @@ codebeacon scan . --list-only             # détecter les frameworks uniquement
 codebeacon scan /workspace --deep-dive    # sortie par projet + workspace combiné
 
 codebeacon init [chemin]                  # générer codebeacon.yaml
-codebeacon sync                           # exécuter depuis 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 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

{codebeacon-0.3.0 → codebeacon-0.3.1}/README.ja.md

@@ -55,6 +55,7 @@ AI コーディングセッションを新しく開くたびに、アシスタ
 - **gitignore 互換 `.codebeaconignore`** — last-match-wins、`!` 否定、ディレクトリパターン(`build/`)、アンカーパターン(`/secrets.txt`)、末尾空白処理
 - **ゼロ設定** — フレームワークと言語を自動検出；繰り返し実行のために `codebeacon.yaml` を自動生成
 - **ディープダイブモード** — `--deep-dive` で各サブプロジェクトに専用の `.codebeacon/` + `CLAUDE.md` を生成；**どのサブプロジェクトからでも**更新コマンドを実行するだけでワークスペース全体が自動同期
+- **ワークスペース自動再検出** — `scan`/`sync` 実行のたびにワークスペースを再スキャンし、`codebeacon.yaml` に未登録の新規プロジェクトを自動追加してから抽出を開始するため、新しく追加されたサブプロジェクトが見落とされることがない；yaml を手動で管理している場合は `--no-rediscover` でオプトアウト可能
 
 ---
 
@@ -271,8 +272,9 @@ codebeacon scan /workspace --deep-dive    # プロジェクト別 + 統合ワー
 
 # 設定ベースモード
 codebeacon init [path]                    # codebeacon.yaml を自動生成
-codebeacon sync                           # codebeacon.yaml ベースで実行
+codebeacon sync                           # codebeacon.yaml ベースで実行 (新規ワークスペースプロジェクトを自動追加)
 codebeacon sync --config <file>           # 特定の設定ファイルを使用
+codebeacon sync --no-rediscover           # 新規プロジェクトの自動追加を無効化 (手動キュレーションモード)
 
 # ナレッジグラフのクエリ
 codebeacon query <term> [--dir .codebeacon] [--limit N]   # ラベル部分文字列でノード検索

{codebeacon-0.3.0 → codebeacon-0.3.1}/README.ko.md

@@ -55,6 +55,7 @@ AI 코딩 세션을 새로 열 때마다 어시스턴트는 백지 상태에서
 - **gitignore 호환 `.codebeaconignore`** — last-match-wins, `!` 부정, 디렉토리 패턴(`build/`), 앵커 패턴(`/secrets.txt`), 트레일링 공백 처리
 - **제로 설정** — 프레임워크와 언어 자동 감지; 반복 실행을 위한 `codebeacon.yaml` 자동 생성
 - **딥다이브 모드** — `--deep-dive`는 각 서브 프로젝트에 개별 `.codebeacon/` + `CLAUDE.md`를 생성; 어느 서브 프로젝트 폴더에서든 `codebeacon scan . --update`를 실행하면 워크스페이스의 모든 프로젝트가 자동으로 업데이트됨
+- **워크스페이스 자동 재발견** — `scan`/`sync` 실행마다 워크스페이스를 다시 훑어 `codebeacon.yaml`에 없는 신규 프로젝트를 자동으로 yaml에 추가한 뒤 추출 시작 — 새로 추가된 서브 프로젝트가 조용히 누락되지 않음; 수동으로 yaml을 큐레이션 중이라면 `--no-rediscover`로 옵트아웃
 
 ---
 
@@ -282,8 +283,9 @@ codebeacon scan /workspace --deep-dive    # 프로젝트별 + 통합 워크스
 
 # 설정 기반 모드
 codebeacon init [path]                    # codebeacon.yaml 자동 생성
-codebeacon sync                           # codebeacon.yaml 기반 실행
+codebeacon sync                           # codebeacon.yaml 기반 실행 (신규 워크스페이스 프로젝트 자동 추가)
 codebeacon sync --config <file>           # 특정 설정 파일 사용
+codebeacon sync --no-rediscover           # 신규 프로젝트 자동 추가 비활성화 (수동 큐레이션 모드)
 
 # 지식 그래프 쿼리
 codebeacon query <term> [--dir .codebeacon] [--limit N]   # 라벨 부분 문자열로 노드 검색

{codebeacon-0.3.0 → codebeacon-0.3.1}/README.md

@@ -53,6 +53,7 @@ Existing tools solve this partially. Route analyzers map your controllers but mi
 - **gitignore-style `.codebeaconignore`** — last-match-wins with `!` negation, dir patterns (`build/`), anchored patterns (`/secrets.txt`), trailing-whitespace rules
 - **Zero configuration** — auto-detects frameworks and languages; generates `codebeacon.yaml` for repeat runs
 - **Deep-dive mode** — `--deep-dive` generates per-project `.codebeacon/` + `CLAUDE.md` for every sub-project; running `codebeacon scan . --update` from any sub-project folder automatically syncs all projects in the workspace
+- **Workspace auto-rediscovery** — on every `scan` / `sync`, codebeacon re-scans the workspace and appends any new project folders to `codebeacon.yaml` before extraction, so freshly added sub-projects are never silently skipped; pass `--no-rediscover` to opt out for hand-curated configs
 
 ---
 
@@ -281,8 +282,9 @@ codebeacon scan /workspace --deep-dive    # per-project + combined workspace out
 
 # Config-driven mode
 codebeacon init [path]                    # auto-generate codebeacon.yaml
-codebeacon sync                           # run from 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)
 
 # Query the knowledge graph
 codebeacon query <term> [--dir .codebeacon] [--limit N]   # search nodes by label substring

{codebeacon-0.3.0 → codebeacon-0.3.1}/README.pt-BR.md

@@ -55,6 +55,7 @@ As ferramentas existentes resolvem isso apenas parcialmente. Analisadores de rot
 - **`.codebeaconignore` estilo gitignore** — last-match-wins com negação `!`, padrões de diretório (`build/`), padrões ancorados (`/secrets.txt`), regras de espaço final
 - **Zero configuração** — detecta frameworks e linguagens automaticamente; gera `codebeacon.yaml` para execuções futuras
 - **Modo Deep Dive** — `--deep-dive` gera `.codebeacon/` + `CLAUDE.md` próprios para cada sub-projeto; executar o comando de atualização de **qualquer** sub-projeto sincroniza automaticamente todos os projetos do workspace
+- **Auto-redescoberta do workspace** — a cada `scan`/`sync`, o codebeacon re-escaneia o workspace e adiciona automaticamente os novos projetos ao `codebeacon.yaml` antes da extração, evitando que sub-projetos recém-criados sejam silenciosamente ignorados; use `--no-rediscover` para manter uma configuração yaml curada manualmente
 
 ---
 
@@ -362,7 +363,8 @@ codebeacon scan . --list-only             # apenas detectar frameworks
 codebeacon scan /workspace --deep-dive    # saída por projeto + workspace combinado
 
 codebeacon init [caminho]                 # gerar codebeacon.yaml
-codebeacon sync                           # executar a partir do codebeacon.yaml
+codebeacon sync                           # executar a partir do codebeacon.yaml (adiciona novos projetos do workspace automaticamente)
+codebeacon sync --no-rediscover           # não adicionar novos projetos automaticamente (modo yaml curado à mão)
 
 codebeacon query <termo> [--dir .codebeacon] [--limit N]   # buscar nós por substring do label
 codebeacon path <origem> <destino> [--dir .codebeacon]     # caminho de dependências mais curto

{codebeacon-0.3.0 → codebeacon-0.3.1}/README.zh-CN.md

@@ -55,6 +55,7 @@
 - **gitignore 风格 `.codebeaconignore`** — last-match-wins、`!` 否定、目录模式（`build/`）、锚定模式（`/secrets.txt`）、行尾空白处理
 - **零配置** — 自动检测框架和语言；自动生成 `codebeacon.yaml` 供后续运行
 - **深度扫描模式** — `--deep-dive` 为每个子项目生成专属 `.codebeacon/` + `CLAUDE.md`；从**任意**子项目目录执行更新命令，即可自动同步整个工作区的所有项目
+- **工作区自动重新发现** — 每次执行 `scan`/`sync` 时,codebeacon 会重新扫描工作区,并将 `codebeacon.yaml` 中尚未登记的新项目自动追加后再进行抽取,新增子项目不会被静默跳过;若手动维护 yaml,可通过 `--no-rediscover` 退出此行为
 
 ---
 
@@ -270,8 +271,9 @@ codebeacon scan /workspace --deep-dive    # 各项目独立输出 + 工作区合
 
 # 配置驱动模式
 codebeacon init [path]                    # 自动生成 codebeacon.yaml
-codebeacon sync                           # 基于 codebeacon.yaml 运行
+codebeacon sync                           # 基于 codebeacon.yaml 运行(自动追加工作区中的新项目)
 codebeacon sync --config <file>           # 使用指定配置文件
+codebeacon sync --no-rediscover           # 不自动追加新项目(手动维护 yaml 模式)
 
 # 查询知识图谱
 codebeacon query <term> [--dir .codebeacon] [--limit N]   # 通过标签子串搜索节点

codebeacon-0.3.1/codebeacon/__init__.py

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

{codebeacon-0.3.0 → codebeacon-0.3.1}/codebeacon/cli.py

@@ -561,7 +561,9 @@ def _write_project_artifact_outputs(G, communities, project, proj_output_dir: st
 
 
 def _cmd_sync(args: argparse.Namespace) -> int:
-    from codebeacon.config import load_config, find_config
+    from codebeacon.config import (
+        load_config, find_config, discover_new_projects, append_projects_to_yaml,
+    )
     from codebeacon.discover.detector import detect_framework
     from codebeacon.common.types import ProjectInfo
 
@@ -580,6 +582,18 @@ def _cmd_sync(args: argparse.Namespace) -> int:
         print(f"Error loading config: {e}", file=sys.stderr)
         return 1
 
+    # Auto-discover projects added to the workspace since the yaml was last written.
+    # Skip when `--no-rediscover` is set so users with hand-curated yaml configs
+    # can opt out.
+    if not getattr(args, "no_rediscover", False):
+        new_projects = discover_new_projects(config)
+        if new_projects:
+            print(f"Found {len(new_projects)} new project(s); adding to {config.config_file}:")
+            for p in new_projects:
+                print(f"  + {p.name:<20}  {p.framework:<15}  {p.path}")
+            append_projects_to_yaml(config.config_file, new_projects)
+            config = load_config(config.config_file)
+
     print(f"Using {config.config_file}")
     print(f"Processing {len(config.projects)} project(s)...")
 
@@ -768,6 +782,11 @@ def build_parser() -> argparse.ArgumentParser:
         action="store_true",
         help="Generate per-project .codebeacon/ + CLAUDE.md for each sub-project, plus a combined workspace output",
     )
+    scan_p.add_argument(
+        "--no-rediscover",
+        action="store_true",
+        help="When auto-switching to sync mode, do NOT scan the workspace for newly added projects",
+    )
     scan_p.set_defaults(func=_cmd_scan)
 
     # sync
@@ -780,6 +799,11 @@ def build_parser() -> argparse.ArgumentParser:
         action="store_true",
         help="Override config: force deep-dive mode",
     )
+    sync_p.add_argument(
+        "--no-rediscover",
+        action="store_true",
+        help="Skip scanning the workspace for newly added projects",
+    )
     sync_p.set_defaults(func=_cmd_sync)
 
     # init

{codebeacon-0.3.0 → codebeacon-0.3.1}/codebeacon/config.py

@@ -158,3 +158,60 @@ def generate_config(
         data["deep_dive"] = True
     with open(config_path, "w") as f:
         yaml.dump(data, f, default_flow_style=False, allow_unicode=True, sort_keys=False)
+
+
+def discover_new_projects(config: CodebeaconConfig) -> list:
+    """Re-scan the workspace around the loaded config for newly added projects.
+
+    Compares the freshly discovered project list (rooted at the yaml's parent
+    directory) against the projects already tracked in ``config.projects``,
+    using resolved absolute paths for de-duplication. Returns ``ProjectInfo``
+    entries that are NOT yet in the yaml so callers can append them.
+    """
+    from codebeacon.discover.detector import discover_projects
+
+    workspace_root = Path(config.config_file).parent
+    try:
+        found = discover_projects([str(workspace_root)])
+    except (FileNotFoundError, ValueError):
+        return []
+
+    known_paths = {Path(p.path).resolve() for p in config.projects}
+    new_projects: list = []
+    for p in found:
+        resolved = Path(p.path).resolve()
+        if resolved in known_paths:
+            continue
+        # Skip projects nested inside a project already tracked in the yaml —
+        # the parent entry already covers them, so adding a child would
+        # double-count files and clutter the config (e.g. `dring-mobile/android`
+        # inside a `dring-mobile` rails app).
+        if any(known == resolved or known in resolved.parents for known in known_paths):
+            continue
+        new_projects.append(p)
+    return new_projects
+
+
+def append_projects_to_yaml(config_path: str | Path, new_projects: list) -> None:
+    """Append discovered projects to an existing codebeacon.yaml in place.
+
+    Preserves all unrelated keys (output, wave, semantic, deep_dive, etc.) and
+    existing project entries. Re-serializes via pyyaml so any comments in the
+    original file are lost — acceptable trade-off because the file is normally
+    machine-generated by :func:`generate_config`.
+    """
+    config_path = Path(config_path)
+    with open(config_path) as f:
+        raw = yaml.safe_load(f) or {}
+
+    projects_list = raw.get("projects") or []
+    for p in new_projects:
+        projects_list.append({
+            "name": p.name,
+            "path": p.path,
+            "type": p.framework,
+        })
+    raw["projects"] = projects_list
+
+    with open(config_path, "w") as f:
+        yaml.dump(raw, f, default_flow_style=False, allow_unicode=True, sort_keys=False)

{codebeacon-0.3.0 → codebeacon-0.3.1}/codebeacon/discover/detector.py

@@ -187,11 +187,19 @@ def _has_project_signature(directory: Path) -> bool:
         "svelte.config.js", "svelte.config.ts",
     ]
     for sig in signature_files:
-        if (directory / sig).exists():
-            return True
+        try:
+            if (directory / sig).exists():
+                return True
+        except OSError:
+            # Permission-restricted siblings (e.g. macOS semaphore dirs in /tmp)
+            # would otherwise crash the whole discover pass.
+            continue
     # Check for *.csproj
-    if list(directory.glob("*.csproj")):
-        return True
+    try:
+        if list(directory.glob("*.csproj")):
+            return True
+    except OSError:
+        pass
     return False
 
 

{codebeacon-0.3.0 → codebeacon-0.3.1}/pyproject.toml

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

codebeacon-0.3.0/codebeacon/__init__.py

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