cg-code-graph 0.14.0__tar.gz → 0.16.0__tar.gz

{cg_code_graph-0.14.0/cg_code_graph.egg-info → cg_code_graph-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cg-code-graph
-Version: 0.14.0
+Version: 0.16.0
 Summary: cg: a code graph of routes, calls, data access and platform boundaries for agents and humans (CLI + MCP server)
 Author: cyberchronos00
 License-Expression: MIT
@@ -72,7 +72,7 @@ dependents: 18 nodes  (code: 6, entry points: 9, other: 3)
 | Language | Frameworks and facts | Calls | Docs |
 |---|---|---|---|
 | ![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white) | Django (+ DRF, django-ninja), FastAPI / Starlette, Flask, Celery | exact (stdlib `ast`) | [Python](https://code-graph.cyberchronos00.workers.dev/docs/python) |
-| ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black) | Nuxt / Vue, NestJS, Next.js, Express, Fastify, Koa, Hono | exact (TypeScript compiler API) | [TS frameworks](https://code-graph.cyberchronos00.workers.dev/docs/ts-frameworks) |
+| ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black) | Nuxt / Vue, NestJS, Next.js, Astro, Express, Fastify, Koa, Hono | exact (TypeScript compiler API) | [TS frameworks](https://code-graph.cyberchronos00.workers.dev/docs/ts-frameworks) |
 | ![PHP](https://img.shields.io/badge/PHP-777BB4?logo=php&logoColor=white) | Laravel (routes and middleware, queues, broadcasting) | exact (nikic/php-parser; needs PHP 8.2+) | [PHP](https://code-graph.cyberchronos00.workers.dev/docs/php) |
 | ![Dart](https://img.shields.io/badge/Dart-0175C2?logo=dart&logoColor=white) | Flutter | exact (Dart analyzer; needs the Dart SDK) | [Platforms](https://code-graph.cyberchronos00.workers.dev/docs/platforms) |
 | ![Kotlin](https://img.shields.io/badge/Kotlin-7F52FF?logo=kotlin&logoColor=white) | Android, Kotlin Multiplatform | heuristic; exact with scip-java (opt-in) | [Kotlin](https://code-graph.cyberchronos00.workers.dev/docs/kotlin) |

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/README.md

@@ -46,7 +46,7 @@ dependents: 18 nodes  (code: 6, entry points: 9, other: 3)
 | Language | Frameworks and facts | Calls | Docs |
 |---|---|---|---|
 | ![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white) | Django (+ DRF, django-ninja), FastAPI / Starlette, Flask, Celery | exact (stdlib `ast`) | [Python](https://code-graph.cyberchronos00.workers.dev/docs/python) |
-| ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black) | Nuxt / Vue, NestJS, Next.js, Express, Fastify, Koa, Hono | exact (TypeScript compiler API) | [TS frameworks](https://code-graph.cyberchronos00.workers.dev/docs/ts-frameworks) |
+| ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black) | Nuxt / Vue, NestJS, Next.js, Astro, Express, Fastify, Koa, Hono | exact (TypeScript compiler API) | [TS frameworks](https://code-graph.cyberchronos00.workers.dev/docs/ts-frameworks) |
 | ![PHP](https://img.shields.io/badge/PHP-777BB4?logo=php&logoColor=white) | Laravel (routes and middleware, queues, broadcasting) | exact (nikic/php-parser; needs PHP 8.2+) | [PHP](https://code-graph.cyberchronos00.workers.dev/docs/php) |
 | ![Dart](https://img.shields.io/badge/Dart-0175C2?logo=dart&logoColor=white) | Flutter | exact (Dart analyzer; needs the Dart SDK) | [Platforms](https://code-graph.cyberchronos00.workers.dev/docs/platforms) |
 | ![Kotlin](https://img.shields.io/badge/Kotlin-7F52FF?logo=kotlin&logoColor=white) | Android, Kotlin Multiplatform | heuristic; exact with scip-java (opt-in) | [Kotlin](https://code-graph.cyberchronos00.workers.dev/docs/kotlin) |

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0/cg_code_graph.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cg-code-graph
-Version: 0.14.0
+Version: 0.16.0
 Summary: cg: a code graph of routes, calls, data access and platform boundaries for agents and humans (CLI + MCP server)
 Author: cyberchronos00
 License-Expression: MIT
@@ -72,7 +72,7 @@ dependents: 18 nodes  (code: 6, entry points: 9, other: 3)
 | Language | Frameworks and facts | Calls | Docs |
 |---|---|---|---|
 | ![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white) | Django (+ DRF, django-ninja), FastAPI / Starlette, Flask, Celery | exact (stdlib `ast`) | [Python](https://code-graph.cyberchronos00.workers.dev/docs/python) |
-| ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black) | Nuxt / Vue, NestJS, Next.js, Express, Fastify, Koa, Hono | exact (TypeScript compiler API) | [TS frameworks](https://code-graph.cyberchronos00.workers.dev/docs/ts-frameworks) |
+| ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black) | Nuxt / Vue, NestJS, Next.js, Astro, Express, Fastify, Koa, Hono | exact (TypeScript compiler API) | [TS frameworks](https://code-graph.cyberchronos00.workers.dev/docs/ts-frameworks) |
 | ![PHP](https://img.shields.io/badge/PHP-777BB4?logo=php&logoColor=white) | Laravel (routes and middleware, queues, broadcasting) | exact (nikic/php-parser; needs PHP 8.2+) | [PHP](https://code-graph.cyberchronos00.workers.dev/docs/php) |
 | ![Dart](https://img.shields.io/badge/Dart-0175C2?logo=dart&logoColor=white) | Flutter | exact (Dart analyzer; needs the Dart SDK) | [Platforms](https://code-graph.cyberchronos00.workers.dev/docs/platforms) |
 | ![Kotlin](https://img.shields.io/badge/Kotlin-7F52FF?logo=kotlin&logoColor=white) | Android, Kotlin Multiplatform | heuristic; exact with scip-java (opt-in) | [Kotlin](https://code-graph.cyberchronos00.workers.dev/docs/kotlin) |

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/cg_code_graph.egg-info/SOURCES.txt

@@ -71,6 +71,9 @@ codegraph/core/plugin.py
 codegraph/core/store.py
 codegraph/core/syntax_errors.py
 codegraph/plugins/__init__.py
+codegraph/plugins/astro/__init__.py
+codegraph/plugins/astro/content.py
+codegraph/plugins/astro/plugin.py
 codegraph/plugins/cfamily/__init__.py
 codegraph/plugins/cfamily/plugin.py
 codegraph/plugins/cfamily/syntax.py
@@ -206,6 +209,9 @@ tests/test_agents_md.py
 tests/test_ai_tools.py
 tests/test_android_ipc.py
 tests/test_apple_ipc.py
+tests/test_astro.py
+tests/test_astro_content.py
+tests/test_astro_server.py
 tests/test_bridges.py
 tests/test_bridges_pigeon_monorepo.py
 tests/test_brokers.py
@@ -233,6 +239,7 @@ tests/test_index_isolation.py
 tests/test_inherited_overrides.py
 tests/test_jobs.py
 tests/test_js_refs.py
+tests/test_js_runtime.py
 tests/test_kotlin.py
 tests/test_kotlin_binding.py
 tests/test_kotlin_exact.py

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/codegraph/__init__.py

@@ -1,2 +1,2 @@
 """code-graph: deterministic code knowledge graph (beta)."""
-__version__ = "0.14.0"
+__version__ = "0.16.0"

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/codegraph/blindspots.py

@@ -34,7 +34,7 @@ KINDS = {
     "nuxt_unevaluable_import_dirs": ("handler", "typescript",
                                      "Nuxt imports.dirs entry that is not a literal path or glob"),
     "vue_unresolved_navigation": ("route", "typescript",
-                                  "Nuxt / Vue navigation target that matches no page or several pages"),
+                                  "Nuxt / Vue / Astro navigation target that matches no page or several pages"),
 }
 
 

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/codegraph/config.py

@@ -61,7 +61,7 @@ KNOWN_KEYS = set(SCHEMA)
 PYTHON_KEYS = SCHEMA["python"]
 VIZ_MODES = ("reaches", "impact", "downstream", "path", "plan")
 # framework plugins of codegraph/indexer.py FRAMEWORK_PLUGINS (frameworks.add / remove also take preset names)
-FRAMEWORK_PLUGIN_NAMES = ("laravel", "nuxt", "django", "fastapi", "flask", "flutter", "nest", "nextjs", "express")
+FRAMEWORK_PLUGIN_NAMES = ("laravel", "nuxt", "django", "fastapi", "flask", "flutter", "nest", "nextjs", "express", "astro")
 
 
 class ConfigError(ValueError):

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/codegraph/core/detect.py

@@ -51,6 +51,9 @@ def detect(root: Path) -> dict:
     deps = _pkg_deps(root)
     if "nuxt" in deps or any((root / n).exists() for n in ("nuxt.config.ts", "nuxt.config.js")):
         fw["nuxt"] = {"version": deps.get("nuxt")}
+    if "astro" in deps or any((root / n).exists() for n in (
+            "astro.config.mjs", "astro.config.js", "astro.config.ts", "astro.config.mts", "astro.config.cjs")):
+        fw["astro"] = {"version": deps.get("astro")}
     if "vue" in deps:
         fw["vue"] = {"version": deps.get("vue")}
     from ..plugins.tsweb.common import SERVER_DEPS   # TS / JS servers (NestJS, Next.js, Express / Koa / Fastify / Hono ...)

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/codegraph/core/extractors.py

@@ -103,10 +103,64 @@ def status(lang: str) -> dict:
     return {"installed": _installed(d, spec), "dir": str(d), "where": "cache"}
 
 
+JS_RUNTIME_MISSING = (
+    "node not installed (the TypeScript extractor needs Node.js 20+ or Bun on PATH, "
+    "or CODEGRAPH_NODE=/path/to/node)"
+)
+
+
+def _runtime_kind(path: str) -> str:
+    """`bun` when the binary (or what a `node` symlink points at, as in Bun images) is Bun, else `node`."""
+    names = (Path(path).name, Path(os.path.realpath(path)).name)
+    return "bun" if any(n.lower().startswith("bun") for n in names) else "node"
+
+
+def _override() -> str | None:
+    v = (os.environ.get("CODEGRAPH_NODE") or "").strip()
+    return os.path.expanduser(v) if v else None
+
+
+def js_runtime() -> dict | None:
+    """Node.js or Bun for the TypeScript extractor.
+
+    ``CODEGRAPH_NODE`` (a name on PATH or a path) wins, then ``node`` on PATH, then ``bun``.
+    """
+    override = _override()
+    if override:
+        path = shutil.which(override)
+        if not path:
+            return None
+        return {"path": path, "kind": _runtime_kind(path), "source": "CODEGRAPH_NODE"}
+    node = shutil.which("node")
+    if node:
+        return {"path": node, "kind": _runtime_kind(node), "source": "PATH"}
+    bun = shutil.which("bun")
+    if bun:
+        return {"path": bun, "kind": "bun", "source": "PATH"}
+    return None
+
+
+def js_runtime_problem() -> str | None:
+    """Why the TypeScript extractor cannot start, or None when a runtime resolves."""
+    override = _override()
+    if override and not shutil.which(override):
+        return (f"CODEGRAPH_NODE={os.environ.get('CODEGRAPH_NODE')} is not an executable on PATH or a path to one "
+                "(set it to a node or bun binary, or unset it to use node / bun from PATH)")
+    if js_runtime() is None:
+        return JS_RUNTIME_MISSING
+    return None
+
+
 def install_command(lang: str, dart: str | None = None) -> list[str]:
     if lang == "typescript":
-        npm = shutil.which("npm") or "npm"
-        return [npm, "ci", "--no-audit", "--no-fund", "--loglevel=error"]
+        npm = shutil.which("npm")
+        if npm:
+            return [npm, "ci", "--no-audit", "--no-fund", "--loglevel=error"]
+        rt = js_runtime()
+        bun = rt["path"] if rt and rt["kind"] == "bun" else shutil.which("bun")
+        if bun:
+            return [bun, "install", "--frozen-lockfile", "--no-progress"]
+        return ["npm", "ci", "--no-audit", "--no-fund", "--loglevel=error"]
     if lang == "php":
         return [shutil.which("composer") or "composer", "install", "--no-dev", "--no-interaction", "--no-progress", "--quiet"]
     return [dart or shutil.which("dart") or "dart", "pub", "get"]
@@ -180,7 +234,8 @@ def prune(dry_run: bool = False) -> list[tuple[Path, int]]:
 
 def _run(cmd: list[str], d: Path, spec: Spec) -> None:
     if not shutil.which(cmd[0]) and not Path(cmd[0]).exists():
-        raise RuntimeError(f"{spec.label} extractor dependencies missing and `{spec.tool}` is not installed")
+        tool = "`npm` (or `bun`)" if spec.tool == "npm" else f"`{spec.tool}`"
+        raise RuntimeError(f"{spec.label} extractor dependencies missing and {tool} is not installed")
     r = subprocess.run(cmd, cwd=d, capture_output=True, text=True)
     if r.returncode != 0:
         raise RuntimeError(f"{spec.label} extractor dependency install failed ({' '.join(cmd[:2])} in {d}): "

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/codegraph/coverage.py

@@ -16,7 +16,7 @@ from pathlib import Path
 # source extensions per language plugin (key = plugin name in stats["plugins"])
 SUPPORTED = {
     "php": (".php",),
-    "typescript": (".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs", ".vue"),
+    "typescript": (".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs", ".vue", ".astro"),
     "python": (".py",),
     "dart": (".dart",),
     "rust": (".rs",),
@@ -33,7 +33,7 @@ UNSUPPORTED = {
     ".pl": "perl", ".pm": "perl", ".clj": "clojure", ".erl": "erlang", ".hrl": "erlang", ".hs": "haskell", ".fs": "fsharp",
     ".fsx": "fsharp", ".groovy": "groovy", ".r": "r", ".jl": "julia", ".zig": "zig", ".sol": "solidity",
     ".qml": "qml", ".sh": "sh", ".bash": "sh", ".zsh": "sh", ".ksh": "sh", ".fish": "fish", ".ps1": "powershell",
-    ".psm1": "powershell", ".bat": "batch", ".cmd": "batch", ".svelte": "svelte", ".astro": "astro",
+    ".psm1": "powershell", ".bat": "batch", ".cmd": "batch", ".svelte": "svelte",
     ".coffee": "coffeescript", ".elm": "elm", ".ml": "ocaml", ".mli": "ocaml", ".nim": "nim", ".cr": "crystal",
     ".rkt": "racket", ".tcl": "tcl", ".vb": "visual-basic", ".cu": "cuda", ".cuh": "cuda", ".gd": "gdscript",
     ".hx": "haxe", ".pas": "pascal", ".f90": "fortran", ".f95": "fortran", ".adb": "ada", ".ads": "ada", ".vala": "vala",
@@ -58,7 +58,7 @@ MAX_PATHS = 500      # file paths stored per bucket in the index (counts are alw
 SHOW_PATHS = 5       # shown per bucket by default (`cg coverage --all-files` / coverage(all_files=true) for all)
 HINTS = {
     "php": "install PHP 8.2+ and Composer, then run `cg setup php` (`cg doctor` checks the toolchains)",
-    "typescript": "install Node.js 20+ (with npm), then run `cg setup typescript` (`cg doctor` checks the toolchains)",
+    "typescript": "install Node.js 20+ (with npm) or Bun, or set CODEGRAPH_NODE, then run `cg setup typescript` (`cg doctor` checks the toolchains)",
     "dart": "install the Dart SDK 3.x (`dart` on PATH or $DART), then run `cg setup dart`",
     "rust": "exact mode needs rust-analyzer (`rustup component add rust-analyzer`){layer}",
     "c_cpp": "exact mode needs scip-clang and a compile_commands.json (docs/native.md){layer}",

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/codegraph/doctor.py

@@ -104,7 +104,8 @@ def _tools() -> dict:
     from .plugins.swift.exact import find_swift
     home = Path.home()
     found = {
-        "node": shutil.which("node"), "npm": shutil.which("npm"), "php": shutil.which("php"),
+        "node": shutil.which(extractors._override() or "node"),
+        "npm": shutil.which("npm"), "bun": shutil.which("bun"), "php": shutil.which("php"),
         "composer": shutil.which("composer"), "dart": find_dart(),
         "rust-analyzer": find_tool("CODEGRAPH_RUST_ANALYZER", ["rust-analyzer"], [home / ".cargo" / "bin"]),
         "cargo": os.environ.get("CODEGRAPH_CARGO") or shutil.which("cargo") or
@@ -143,14 +144,17 @@ def _languages(tools: dict, root: Path | None, cfg: dict) -> list[dict]:
 
     add("python", "exact", "built-in parser (Python ast)")
     st = extractors.status("typescript")
-    if not has("node"):
-        add("typescript", "unavailable", "node not installed (Node.js 20+ runs the TypeScript extractor)",
-            "install Node.js 20+ (https://nodejs.org or your package manager), then `cg setup typescript`")
-    elif not st["installed"] and not has("npm"):
-        add("typescript", "unavailable", "extractor dependencies missing and npm not installed", "install npm, then `cg setup typescript`")
+    rt = extractors.js_runtime()
+    if rt is None:
+        add("typescript", "unavailable", extractors.js_runtime_problem(),
+            "install Node.js 20+ or Bun (or set CODEGRAPH_NODE), then `cg setup typescript`")
+    elif not st["installed"] and not has("npm") and not has("bun"):
+        add("typescript", "unavailable", "extractor dependencies missing and npm not installed",
+            "install npm, then `cg setup typescript`")
     else:
-        add("typescript", "exact", "TypeScript compiler API" + ("" if st["installed"] else
-            "; its npm dependencies install on the first index (or now: `cg setup typescript`)"))
+        add("typescript", "exact", f"TypeScript compiler API (runtime: {rt['kind']} {rt['path']})" + (
+            "" if st["installed"] else "; its npm dependencies install on the first index (or now: `cg setup typescript`)"),
+            runtime={"kind": rt["kind"], "path": rt["path"], "source": rt["source"]})
     st = extractors.status("php")
     if not has("php"):
         add("php", "unavailable", "php not installed (PHP 8.2+ runs the PHP extractor)", "install PHP 8.2+ and Composer, then `cg setup php`")
@@ -434,9 +438,17 @@ def setup(langs: list[str] | None = None, quiet: bool = False) -> int:
         tool = {"typescript": "npm", "php": "composer", "dart": None}[lang]
         need = {"typescript": "node", "php": "php", "dart": None}[lang]
         dart = find_dart() if lang == "dart" else None
-        if (need and not shutil.which(need)) or (tool and not shutil.which(tool) and not extractors.status(lang)["installed"]) \
-                or (lang == "dart" and not dart):
-            msg = f"{lang}: skipped ({'dart' if lang == 'dart' else need if need and not shutil.which(need) else tool} not installed)"
+        if lang == "typescript":
+            rt = extractors.js_runtime()
+            can_install = extractors.status(lang)["installed"] or bool(shutil.which("npm") or shutil.which("bun"))
+            skip = rt is None or not can_install
+            detail = extractors.js_runtime_problem() if rt is None else "npm or bun not installed"
+        else:
+            skip = (need and not shutil.which(need)) or (tool and not shutil.which(tool) and not extractors.status(lang)["installed"]) \
+                or (lang == "dart" and not dart)
+            detail = f"{'dart' if lang == 'dart' else need if need and not shutil.which(need) else tool} not installed"
+        if skip:
+            msg = f"{lang}: skipped ({detail})"
             print(msg, file=sys.stderr)
             rc = rc or (1 if langs else 0)
             continue

{cg_code_graph-0.14.0 → cg_code_graph-0.16.0}/codegraph/indexer.py

@@ -26,12 +26,13 @@ from .plugins.flutter.plugin import FlutterPlugin
 from .plugins.nest.plugin import NestPlugin
 from .plugins.nextjs.plugin import NextPlugin
 from .plugins.express.plugin import ExpressPlugin
+from .plugins.astro.plugin import AstroPlugin
 from .plugins.kotlin.plugin import KotlinPlugin
 from .plugins.swift.plugin import SwiftPlugin
 
 LANGUAGE_PLUGINS = [PhpPlugin(), TypeScriptPlugin(), PythonPlugin(), DartPlugin(), RustPlugin(), CFamilyPlugin(), KotlinPlugin(), SwiftPlugin(),
                     *SCIP_PLUGINS]
-FRAMEWORK_PLUGINS = [LaravelPlugin(), NuxtPlugin(), DjangoPlugin(), FastAPIPlugin(), FlaskPlugin(), FlutterPlugin(), NestPlugin(), NextPlugin(), ExpressPlugin()]
+FRAMEWORK_PLUGINS = [LaravelPlugin(), NuxtPlugin(), DjangoPlugin(), FastAPIPlugin(), FlaskPlugin(), FlutterPlugin(), NestPlugin(), NextPlugin(), ExpressPlugin(), AstroPlugin()]
 
 
 def _crash_site(ex: BaseException) -> str | None: