codebeacon 0.1.5__tar.gz → 0.1.7__tar.gz

{codebeacon-0.1.5 → codebeacon-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codebeacon
-Version: 0.1.5
+Version: 0.1.7
 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

codebeacon-0.1.7/codebeacon/__init__.py

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

{codebeacon-0.1.5 → codebeacon-0.1.7}/codebeacon/contextmap/generator.py

@@ -273,40 +273,42 @@ def _build_content(
         lines = [
             "# CLAUDE.md",
             "",
-            "## MANDATORY: Lookup Strategy",
+            "## Lookup strategy",
             "",
-            "> **Read these before ANY code exploration. No exceptions.**",
-            ">",
-            "> Skipping these steps and reading source files directly is a rule violation.",
+            "> 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.",
             "",
         ]
     elif tool == "cursor":
         lines = [
             "# Project Context",
             "",
-            "## Lookup Strategy",
+            "## Lookup strategy",
             "",
-            "> Always follow this 3-step lookup before editing code.",
+            "> A pre-built index lives in `.codebeacon/`. Use the 3-step lookup below",
+            "> before reaching for Glob or Grep.",
             "",
         ]
     else:  # agents
         lines = [
             "# AGENTS.md",
             "",
-            "## Context Lookup Protocol",
+            "## Lookup strategy",
             "",
-            "> All agents MUST follow this 3-step lookup before writing or modifying code.",
+            "> A pre-built index lives in `.codebeacon/`. Follow the 3-step lookup below",
+            "> so parallel agents converge on the same answer.",
             "",
         ]
 
     # ── Step 1: wiki ──
     lines += [
-        "### Step 1 → codebeacon wiki (routes, controllers, services, entities) — ALWAYS",
+        "### Step 1 — codebeacon wiki",
+        "Routes, controllers, services, entities.",
         "```",
-        f"{codebeacon_dir}/wiki/index.md                    ← MUST read at session start",
-        f"{codebeacon_dir}/wiki/{{project}}/controllers/{{Name}}.md  ← for controller logic",
-        f"{codebeacon_dir}/wiki/{{project}}/services/{{Name}}.md     ← for service methods",
-        f"{codebeacon_dir}/wiki/{{project}}/entities/{{Name}}.md     ← for data models",
+        f"{codebeacon_dir}/wiki/index.md                    ← global index",
+        f"{codebeacon_dir}/wiki/{{project}}/controllers/{{Name}}.md  ← controller logic",
+        f"{codebeacon_dir}/wiki/{{project}}/services/{{Name}}.md     ← service methods",
+        f"{codebeacon_dir}/wiki/{{project}}/entities/{{Name}}.md     ← data models",
         f"{codebeacon_dir}/wiki/routes.md                   ← all API routes across projects",
         "```",
         "",
@@ -314,11 +316,9 @@ def _build_content(
 
     # ── Step 2: obsidian ──
     lines += [
-        "### Step 2 → codebeacon obsidian (methods, fields, connections) — ALWAYS",
-        "**MUST read even if Step 1 found results.** Obsidian notes contain method lists,",
-        "field definitions, and class-level connections that wiki articles do not have.",
-        "",
-        f"Look up by class name — replace `{{project}}` with the relevant folder:",
+        "### 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:",
         "```",
         f"{obsidian_path}/{{project}}/{{ClassName}}.md",
         "```",
@@ -351,21 +351,17 @@ def _build_content(
 
     # ── Step 3 ──
     lines += [
-        "### Step 3 → source file (ONLY files identified in Steps 1-2)",
-        "Read only the specific source files whose paths were found in Steps 1-2.",
-        "No directory exploration, no Glob scans, no broad Grep searches.",
+        "### Step 3 — source file",
+        "Open the paths surfaced by Steps 1–2.",
         "",
     ]
 
     if tool == "claude":
         lines += [
-            "### Prohibited actions (before completing Steps 1-2)",
-            "- **DO NOT use Explore agent**",
-            "- **DO NOT use Glob for directory scans**",
-            "- **DO NOT use Grep for broad searches**",
-            "- **DO NOT Read source files directly without checking Steps 1-2 first**",
-            "",
-            "Proceed to Step 3 only when Steps 1-2 are insufficient.",
+            "### 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.",
             "",
         ]
 

{codebeacon-0.1.5 → codebeacon-0.1.7}/codebeacon/discover/detector.py

@@ -228,6 +228,7 @@ _SKIP_DIRS = {
 }
 
 
+
 def _iter_subdirs(directory: Path) -> list[Path]:
     """Return immediate subdirectories, skipping common non-project dirs."""
     try:
@@ -268,13 +269,22 @@ def discover_projects(paths: list[str]) -> list[ProjectInfo]:
     # Level 2: if a subdir has no signature itself, scan its children
     #           (e.g. WaveLog/server, aptscore/frontend, murmur/landing)
     subprojects: list[ProjectInfo] = []
+    seen_paths: set[str] = set()
     for subdir in _iter_subdirs(single_path):
         if _has_project_signature(subdir):
             subprojects.append(_build_project_info(subdir, multi=True))
+            seen_paths.add(str(subdir))
+            # Scan children for embedded sub-projects with their own signature
+            # (e.g. Tauri: desktop/ has svelte.config.js + desktop/src-tauri/ has Cargo.toml)
+            for nested in _iter_subdirs(subdir):
+                if str(nested) not in seen_paths and _has_project_signature(nested):
+                    subprojects.append(_build_project_info(nested, multi=True))
+                    seen_paths.add(str(nested))
         else:
             for nested in _iter_subdirs(subdir):
-                if _has_project_signature(nested):
+                if str(nested) not in seen_paths and _has_project_signature(nested):
                     subprojects.append(_build_project_info(nested, multi=True))
+                    seen_paths.add(str(nested))
 
     if subprojects:
         return subprojects

{codebeacon-0.1.5 → codebeacon-0.1.7}/pyproject.toml

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

codebeacon-0.1.5/codebeacon/__init__.py

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