cg-code-graph 0.12.0__tar.gz → 0.13.0__tar.gz

cg_code_graph-0.13.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: cg-code-graph
+Version: 0.13.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
+Project-URL: Homepage, https://github.com/cyberchronos00/code-graph
+Project-URL: Changelog, https://github.com/cyberchronos00/code-graph/blob/main/CHANGELOG.md
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=2.2
+Requires-Dist: pyyaml>=6
+Requires-Dist: protobuf>=4.21
+Requires-Dist: tree-sitter>=0.23
+Requires-Dist: tree-sitter-rust>=0.23
+Requires-Dist: tree-sitter-c>=0.23
+Requires-Dist: tree-sitter-cpp>=0.23
+Requires-Dist: tree-sitter-kotlin>=1.0
+Requires-Dist: tree-sitter-swift<0.7.4,>=0.6
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# code-graph
+
+**A deterministic dependency graph for Laravel, Django, FastAPI, Flask, NestJS, Next.js, Express, Nuxt, Flutter, Rust, C and C++ codebases, so you (and your AI agent) can see everything a change touches before you make it.**
+
+Ask "what depends on this table, connection, config key or method?" and get every caller, route, command and page that reaches it, each hop backed by `file:line` evidence. It runs locally on your source files. Answers are exact, deterministic and reproducible: the graph is built from parsers and the type checker, with no LLM in the graph. BloodHound-style: you walk real paths instead of grepping names.
+
+> **Status:** beta. Laravel (PHP), Django, FastAPI / Starlette and Flask (Python), TypeScript/JavaScript (Nuxt/Vue, NestJS, Next.js, Express/Fastify/Koa/Hono), Flutter (Dart), Rust, C and C++ are supported natively; other languages can be imported through SCIP.
+
+## Documentation
+
+**[code-graph docs](https://code-graph.cyberchronos00.workers.dev/)** — install, CLI, MCP, architecture, schema, languages and limitations.
+
+## Install
+
+`cg` is a user-level tool (no sudo, no checkout). The PyPI package is [`cg-code-graph`](https://pypi.org/project/cg-code-graph/); the commands are `cg` and `cg-mcp`.
+
+```bash
+pipx install cg-code-graph    # or: uv tool install cg-code-graph
+#   or the script (also installs exact-mode tools with --with c,rust,...):
+#     curl -fsSL https://raw.githubusercontent.com/cyberchronos00/code-graph/main/install.sh | sh
+#   or the latest commit: uv tool install git+https://github.com/cyberchronos00/code-graph
+cg doctor                     # what indexes exact / heuristic on this machine
+```
+
+Update with `uv tool upgrade cg-code-graph`, `pipx upgrade cg-code-graph` or `install.sh --update`. Caches live under `~/.cache/codegraph`; `cg clean` removes them. Windows, options and per-language toolchains: [install](https://code-graph.cyberchronos00.workers.dev/).
+
+## Quickstart
+
+Clone the repo for the bundled sample apps (a Laravel API and a Nuxt web app). Python 3.11+. PHP 8.2+ and Composer for the Laravel sample; Node.js 20+ for the TypeScript samples.
+
+```bash
+git clone https://github.com/cyberchronos00/code-graph.git && cd code-graph
+mkdir -p out
+cg index examples/bookstore-api --name bookstore-api --gates examples/bookstore.gates.json --db out/api.db
+cg index examples/bookstore-web --name bookstore-web --db out/web.db
+cg link --backend out/api.db --frontend out/web.db \
+        --backend-name bookstore-api --frontend-name bookstore-web --db out/graph.db
+
+cg reaches connection:warehouse table:warehouse_stock --db out/graph.db
+cg impact StockService::reserve --db out/graph.db
+cg path page:/reports/:id table:orders --db out/graph.db
+cg plan check preorders --plans-dir examples/plans --db out/graph.db
+```
+
+A workspace `.cg.yaml` can list several apps, including checkouts outside that directory, and `cg index` builds one combined graph. `cg link --repo` merges graphs you already indexed. Other samples in `examples/` (Nest, Next, Express, Django, Flutter, Rust, C, C++) index the same way. Queries, MCP (`cg-mcp --db out/graph.db`) and `cg serve` are in the [docs](https://code-graph.cyberchronos00.workers.dev/).
+
+## Preview
+
+[![cg visual view: the graph around the warehouse connection, a selected node with its evidence paths and source, then the planned-change overlay for the preorders plan](docs/media/cg-view-preview.gif)](docs/media/cg-view-demo.mp4)
+
+[![Terminal demo: cg indexes the bundled Laravel and Nuxt sample apps, links them, then runs reaches, path, impact and plan check](docs/media/cg-terminal-demo.gif)](docs/media/cg-terminal-demo.mp4)
+
+More recordings (setup, visual view, agent over MCP): [docs/media/](docs/media).
+
+## Links
+
+- [Documentation](https://code-graph.cyberchronos00.workers.dev/)
+- [PyPI: cg-code-graph](https://pypi.org/project/cg-code-graph/)
+- [GitHub releases](https://github.com/cyberchronos00/code-graph/releases)
+- [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [License: MIT](LICENSE)

cg_code_graph-0.13.0/README.md

@@ -0,0 +1,60 @@
+# code-graph
+
+**A deterministic dependency graph for Laravel, Django, FastAPI, Flask, NestJS, Next.js, Express, Nuxt, Flutter, Rust, C and C++ codebases, so you (and your AI agent) can see everything a change touches before you make it.**
+
+Ask "what depends on this table, connection, config key or method?" and get every caller, route, command and page that reaches it, each hop backed by `file:line` evidence. It runs locally on your source files. Answers are exact, deterministic and reproducible: the graph is built from parsers and the type checker, with no LLM in the graph. BloodHound-style: you walk real paths instead of grepping names.
+
+> **Status:** beta. Laravel (PHP), Django, FastAPI / Starlette and Flask (Python), TypeScript/JavaScript (Nuxt/Vue, NestJS, Next.js, Express/Fastify/Koa/Hono), Flutter (Dart), Rust, C and C++ are supported natively; other languages can be imported through SCIP.
+
+## Documentation
+
+**[code-graph docs](https://code-graph.cyberchronos00.workers.dev/)** — install, CLI, MCP, architecture, schema, languages and limitations.
+
+## Install
+
+`cg` is a user-level tool (no sudo, no checkout). The PyPI package is [`cg-code-graph`](https://pypi.org/project/cg-code-graph/); the commands are `cg` and `cg-mcp`.
+
+```bash
+pipx install cg-code-graph    # or: uv tool install cg-code-graph
+#   or the script (also installs exact-mode tools with --with c,rust,...):
+#     curl -fsSL https://raw.githubusercontent.com/cyberchronos00/code-graph/main/install.sh | sh
+#   or the latest commit: uv tool install git+https://github.com/cyberchronos00/code-graph
+cg doctor                     # what indexes exact / heuristic on this machine
+```
+
+Update with `uv tool upgrade cg-code-graph`, `pipx upgrade cg-code-graph` or `install.sh --update`. Caches live under `~/.cache/codegraph`; `cg clean` removes them. Windows, options and per-language toolchains: [install](https://code-graph.cyberchronos00.workers.dev/).
+
+## Quickstart
+
+Clone the repo for the bundled sample apps (a Laravel API and a Nuxt web app). Python 3.11+. PHP 8.2+ and Composer for the Laravel sample; Node.js 20+ for the TypeScript samples.
+
+```bash
+git clone https://github.com/cyberchronos00/code-graph.git && cd code-graph
+mkdir -p out
+cg index examples/bookstore-api --name bookstore-api --gates examples/bookstore.gates.json --db out/api.db
+cg index examples/bookstore-web --name bookstore-web --db out/web.db
+cg link --backend out/api.db --frontend out/web.db \
+        --backend-name bookstore-api --frontend-name bookstore-web --db out/graph.db
+
+cg reaches connection:warehouse table:warehouse_stock --db out/graph.db
+cg impact StockService::reserve --db out/graph.db
+cg path page:/reports/:id table:orders --db out/graph.db
+cg plan check preorders --plans-dir examples/plans --db out/graph.db
+```
+
+A workspace `.cg.yaml` can list several apps, including checkouts outside that directory, and `cg index` builds one combined graph. `cg link --repo` merges graphs you already indexed. Other samples in `examples/` (Nest, Next, Express, Django, Flutter, Rust, C, C++) index the same way. Queries, MCP (`cg-mcp --db out/graph.db`) and `cg serve` are in the [docs](https://code-graph.cyberchronos00.workers.dev/).
+
+## Preview
+
+[![cg visual view: the graph around the warehouse connection, a selected node with its evidence paths and source, then the planned-change overlay for the preorders plan](docs/media/cg-view-preview.gif)](docs/media/cg-view-demo.mp4)
+
+[![Terminal demo: cg indexes the bundled Laravel and Nuxt sample apps, links them, then runs reaches, path, impact and plan check](docs/media/cg-terminal-demo.gif)](docs/media/cg-terminal-demo.mp4)
+
+More recordings (setup, visual view, agent over MCP): [docs/media/](docs/media).
+
+## Links
+
+- [Documentation](https://code-graph.cyberchronos00.workers.dev/)
+- [PyPI: cg-code-graph](https://pypi.org/project/cg-code-graph/)
+- [GitHub releases](https://github.com/cyberchronos00/code-graph/releases)
+- [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [License: MIT](LICENSE)

cg_code_graph-0.13.0/cg_code_graph.egg-info/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: cg-code-graph
+Version: 0.13.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
+Project-URL: Homepage, https://github.com/cyberchronos00/code-graph
+Project-URL: Changelog, https://github.com/cyberchronos00/code-graph/blob/main/CHANGELOG.md
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=2.2
+Requires-Dist: pyyaml>=6
+Requires-Dist: protobuf>=4.21
+Requires-Dist: tree-sitter>=0.23
+Requires-Dist: tree-sitter-rust>=0.23
+Requires-Dist: tree-sitter-c>=0.23
+Requires-Dist: tree-sitter-cpp>=0.23
+Requires-Dist: tree-sitter-kotlin>=1.0
+Requires-Dist: tree-sitter-swift<0.7.4,>=0.6
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# code-graph
+
+**A deterministic dependency graph for Laravel, Django, FastAPI, Flask, NestJS, Next.js, Express, Nuxt, Flutter, Rust, C and C++ codebases, so you (and your AI agent) can see everything a change touches before you make it.**
+
+Ask "what depends on this table, connection, config key or method?" and get every caller, route, command and page that reaches it, each hop backed by `file:line` evidence. It runs locally on your source files. Answers are exact, deterministic and reproducible: the graph is built from parsers and the type checker, with no LLM in the graph. BloodHound-style: you walk real paths instead of grepping names.
+
+> **Status:** beta. Laravel (PHP), Django, FastAPI / Starlette and Flask (Python), TypeScript/JavaScript (Nuxt/Vue, NestJS, Next.js, Express/Fastify/Koa/Hono), Flutter (Dart), Rust, C and C++ are supported natively; other languages can be imported through SCIP.
+
+## Documentation
+
+**[code-graph docs](https://code-graph.cyberchronos00.workers.dev/)** — install, CLI, MCP, architecture, schema, languages and limitations.
+
+## Install
+
+`cg` is a user-level tool (no sudo, no checkout). The PyPI package is [`cg-code-graph`](https://pypi.org/project/cg-code-graph/); the commands are `cg` and `cg-mcp`.
+
+```bash
+pipx install cg-code-graph    # or: uv tool install cg-code-graph
+#   or the script (also installs exact-mode tools with --with c,rust,...):
+#     curl -fsSL https://raw.githubusercontent.com/cyberchronos00/code-graph/main/install.sh | sh
+#   or the latest commit: uv tool install git+https://github.com/cyberchronos00/code-graph
+cg doctor                     # what indexes exact / heuristic on this machine
+```
+
+Update with `uv tool upgrade cg-code-graph`, `pipx upgrade cg-code-graph` or `install.sh --update`. Caches live under `~/.cache/codegraph`; `cg clean` removes them. Windows, options and per-language toolchains: [install](https://code-graph.cyberchronos00.workers.dev/).
+
+## Quickstart
+
+Clone the repo for the bundled sample apps (a Laravel API and a Nuxt web app). Python 3.11+. PHP 8.2+ and Composer for the Laravel sample; Node.js 20+ for the TypeScript samples.
+
+```bash
+git clone https://github.com/cyberchronos00/code-graph.git && cd code-graph
+mkdir -p out
+cg index examples/bookstore-api --name bookstore-api --gates examples/bookstore.gates.json --db out/api.db
+cg index examples/bookstore-web --name bookstore-web --db out/web.db
+cg link --backend out/api.db --frontend out/web.db \
+        --backend-name bookstore-api --frontend-name bookstore-web --db out/graph.db
+
+cg reaches connection:warehouse table:warehouse_stock --db out/graph.db
+cg impact StockService::reserve --db out/graph.db
+cg path page:/reports/:id table:orders --db out/graph.db
+cg plan check preorders --plans-dir examples/plans --db out/graph.db
+```
+
+A workspace `.cg.yaml` can list several apps, including checkouts outside that directory, and `cg index` builds one combined graph. `cg link --repo` merges graphs you already indexed. Other samples in `examples/` (Nest, Next, Express, Django, Flutter, Rust, C, C++) index the same way. Queries, MCP (`cg-mcp --db out/graph.db`) and `cg serve` are in the [docs](https://code-graph.cyberchronos00.workers.dev/).
+
+## Preview
+
+[![cg visual view: the graph around the warehouse connection, a selected node with its evidence paths and source, then the planned-change overlay for the preorders plan](docs/media/cg-view-preview.gif)](docs/media/cg-view-demo.mp4)
+
+[![Terminal demo: cg indexes the bundled Laravel and Nuxt sample apps, links them, then runs reaches, path, impact and plan check](docs/media/cg-terminal-demo.gif)](docs/media/cg-terminal-demo.mp4)
+
+More recordings (setup, visual view, agent over MCP): [docs/media/](docs/media).
+
+## Links
+
+- [Documentation](https://code-graph.cyberchronos00.workers.dev/)
+- [PyPI: cg-code-graph](https://pypi.org/project/cg-code-graph/)
+- [GitHub releases](https://github.com/cyberchronos00/code-graph/releases)
+- [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [License: MIT](LICENSE)

{cg_code_graph-0.12.0 → cg_code_graph-0.13.0}/cg_code_graph.egg-info/SOURCES.txt

@@ -48,6 +48,7 @@ codegraph/realtime_ws.py
 codegraph/roundtrip.py
 codegraph/routes.py
 codegraph/rpc.py
+codegraph/sdk_systems.py
 codegraph/sockets.py
 codegraph/starters.py
 codegraph/tests_index.py
@@ -214,6 +215,7 @@ tests/test_coverage_ts_hint.py
 tests/test_dart_isolates.py
 tests/test_dispatch_interfaces.py
 tests/test_django_flutter.py
+tests/test_docs_links.py
 tests/test_enum_constants.py
 tests/test_external.py
 tests/test_gating.py
@@ -276,6 +278,7 @@ tests/test_route_tables.py
 tests/test_routes_search_explain.py
 tests/test_rpc.py
 tests/test_scip_health.py
+tests/test_sdk_external.py
 tests/test_snippet.py
 tests/test_sockets.py
 tests/test_starters_budget.py
@@ -302,4 +305,5 @@ tests/test_values.py
 tests/test_viz.py
 tests/test_vue_nav.py
 tests/test_webhooks.py
-tests/test_websockets.py
+tests/test_websockets.py
+tests/test_workspace_link.py

{cg_code_graph-0.12.0 → cg_code_graph-0.13.0}/codegraph/__init__.py

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

cg_code_graph-0.13.0/codegraph/apps.py

@@ -0,0 +1,88 @@
+"""Workspace apps (`.cg.yaml` `apps`): one `cg index <root>` indexes every app into one combined graph.
+
+    apps:
+      - {name: api, root: apps/api, role: backend}
+      - {name: web, root: apps/web, role: frontend, links: [api]}    # links: the backends it calls (default: all)
+      - {name: other, root: ../other-repo, role: backend}            # root may sit outside this checkout
+
+`cg index <root> --db out/mono.db` writes `out/mono.<app>.db` per app and one combined `out/mono.db`.
+Client HTTP calls in every app are matched against every other backend; a frontend `links:` list limits that app.
+Each app is indexed with its own `.cg.yaml` (at the app root), like a separate checkout.
+"""
+from __future__ import annotations
+
+import shutil
+import time
+from pathlib import Path
+
+from .config import ConfigError
+
+
+def app_dbs(db: str | Path, apps: list[dict]) -> dict:
+    """App name -> per-app DB path next to `db`."""
+    db = Path(db)
+    stem = db.name[:-3] if db.name.endswith(".db") else db.name
+    return {a["name"]: db.parent / f"{stem}.{a['name']}.db" for a in apps}
+
+
+def app_path(root: Path, rel: str) -> Path:
+    """Directory for an app root: empty means the workspace root; absolute is used as-is; `../x` resolves."""
+    if not rel:
+        return root
+    p = Path(rel)
+    return p if p.is_absolute() else (root / rel).resolve()
+
+
+def index_apps(root: str | Path, db: str | Path, cfg: dict, scip=None, python_roots=None,
+               include_generated: bool = False) -> dict:
+    """Index each app of `cfg["apps"]` and link them into one graph. Returns per-app and per-pair stats."""
+    from .indexer import index_project
+    from .link import link_many
+    t0 = time.time()
+    root = Path(root).resolve()
+    apps = cfg["apps"]
+    fname = cfg.get("file", ".cg.yaml")
+    located = []
+    for a in apps:
+        d = app_path(root, a["root"]) if a["root"] else root
+        if not d.is_dir():
+            raise ConfigError(f"{fname}: apps[{a['name']}].root: {a['root']!r} is not a directory under {root.name}")
+        located.append(d)
+    per_app = app_dbs(db, apps)
+    Path(db).parent.mkdir(parents=True, exist_ok=True)
+    out = {"project": root.name, "config": fname, "apps": [], "links": []}
+    for a, d in zip(apps, located):
+        st = index_project(d, per_app[a["name"]], a["name"], scip, python_roots=python_roots,
+                           include_generated=include_generated)
+        out["apps"].append({"name": a["name"], "root": a["root"] or ".", "role": a["role"], "db": str(per_app[a["name"]]),
+                            "nodes": st.get("nodes"), "edges": st.get("edges"), "index_seconds": st.get("index_seconds"),
+                            "frameworks": sorted(((st.get("presets") or {}).get("frameworks") or {}))})
+    if len(apps) == 1:
+        shutil.copyfile(per_app[apps[0]["name"]], db)
+        out["db_is"] = f"graph of app {apps[0]['name']}"
+    else:
+        allow = {a["name"]: a["links"] for a in apps if "links" in a}
+        res = link_many([(a["name"], str(per_app[a["name"]]), a["role"]) for a in apps], str(db), allow=allow)
+        s = res["stats"]
+        for p in s.get("pairs") or []:
+            out["links"].append({"frontend": p["client"], "backend": p["server"], "db": str(db),
+                                 "endpoints": p.get("endpoints"), "endpoints_matched": p.get("endpoints_matched"),
+                                 "call_sites": p.get("call_sites"), "call_sites_matched": p.get("call_sites_matched"),
+                                 "link_seconds": s.get("link_seconds")})
+        out["db_is"] = "combined graph of " + ", ".join(a["name"] for a in apps)
+    out["db"] = str(db)
+    out["index_seconds"] = round(time.time() - t0, 2)
+    return out
+
+
+def render(summary: dict) -> str:
+    lines = [f"apps of {summary['project']} ({summary['config']}): {len(summary['apps'])} indexed, "
+             f"{len(summary['links'])} link pairs in {summary['index_seconds']} s"]
+    for a in summary["apps"]:
+        lines.append(f"  {a['name']:<16} {a['role']:<8} {a['root']:<28} {a['nodes']} nodes, {a['edges']} edges, "
+                     f"{a['index_seconds']} s -> {Path(a['db']).name}")
+    for ln in summary["links"]:
+        lines.append(f"  {ln['frontend']} -> {ln['backend']}: {ln['endpoints_matched']}/{ln['endpoints']} endpoints, "
+                     f"{ln['call_sites_matched']}/{ln['call_sites']} call sites matched")
+    lines.append(f"  {Path(summary['db']).name}: {summary['db_is']}")
+    return "\n".join(lines)

{cg_code_graph-0.12.0 → cg_code_graph-0.13.0}/codegraph/cli.py

@@ -37,6 +37,23 @@ from . import query as Q
 from .bridges import PROTOCOLS as BRIDGE_PROTOCOLS
 
 
+def _parse_repo(spec: str) -> tuple[str, str, str]:
+    """`NAME=DB[:role]` with role backend, frontend or both (default both)."""
+    if "=" not in spec:
+        raise ValueError(f"--repo {spec!r} must be NAME=DB[:role]")
+    name, rest = spec.split("=", 1)
+    if not name or not rest:
+        raise ValueError(f"--repo {spec!r} must be NAME=DB[:role]")
+    role = "both"
+    for r in ("backend", "frontend", "both"):
+        if rest.endswith(":" + r):
+            role, rest = r, rest[:-(len(r) + 1)]
+            break
+    if not rest:
+        raise ValueError(f"--repo {spec!r} must be NAME=DB[:role]")
+    return name, rest, role
+
+
 def main(argv=None):
     from . import __version__
     ap = argparse.ArgumentParser(prog="cg")
@@ -93,9 +110,13 @@ def main(argv=None):
     p.add_argument("--details", action="store_true", help="the full report: file lists (the first 5 per bucket), fix hints, "
                                                           "syntax error lines, Python source roots (default: a short summary)")
     p.add_argument("--all-files", action="store_true", help="the full report with every file per bucket, excluded files too")
-    p = sub.add_parser("link", help="combine a backend and a frontend graph and match client HTTP calls to backend routes")
-    p.add_argument("--backend", required=True); p.add_argument("--frontend", required=True); p.add_argument("--db", required=True)
+    p = sub.add_parser("link", help="merge graphs and match client HTTP calls to routes (two repos, or N --repo)")
+    p.add_argument("--backend", help="backend graph (with --frontend; not with --repo)")
+    p.add_argument("--frontend", help="frontend graph (with --backend; not with --repo)")
+    p.add_argument("--db", required=True)
     p.add_argument("--backend-name", default="backend"); p.add_argument("--frontend-name", default="frontend")
+    p.add_argument("--repo", action="append", default=[], metavar="NAME=DB[:ROLE]",
+                   help="repeatable. ROLE is backend, frontend or both (default both). Not with --backend/--frontend")
     p.add_argument("--report", help="write <prefix>.json/.md match report")
     p = sub.add_parser("path", help="one shortest evidence chain from SRC to DST (exit status 1 when there is none)"); p.add_argument("src"); p.add_argument("dst"); p.add_argument("--db", required=True)
     p.add_argument("--min-confidence", default="heuristic", choices=["heuristic", "resolved", "exact"])
@@ -260,7 +281,7 @@ def main(argv=None):
         from .config import ConfigError, load as load_config
         try:
             cfg = load_config(a.root) if not a.no_apps else {}
-            if cfg.get("apps"):        # monorepo: index each app, link each frontend / backend pair
+            if cfg.get("apps"):        # workspace: index each app into one combined graph
                 from .apps import index_apps, render as render_apps
                 summary = index_apps(a.root, a.db, cfg, a.scip, python_roots=a.python_root,
                                      include_generated=a.include_generated)
@@ -341,8 +362,25 @@ def main(argv=None):
             print(render(covs, all_files=a.all_files) if a.details or a.all_files else render_summary(covs))
         return
     if a.cmd == "link":
-        from .link import link, write_match_report
-        res = link(a.backend, a.frontend, a.db, a.backend_name, a.frontend_name)
+        from .link import link, link_many, write_match_report
+        if a.repo and (a.backend or a.frontend):
+            print("cg link: --repo cannot be combined with --backend/--frontend", file=sys.stderr)
+            return 2
+        try:
+            if a.repo:
+                if len(a.repo) < 2:
+                    print("cg link: pass at least two --repo NAME=DB[:role]", file=sys.stderr)
+                    return 2
+                repos = [_parse_repo(s) for s in a.repo]
+                res = link_many(repos, a.db)
+            elif a.backend and a.frontend:
+                res = link(a.backend, a.frontend, a.db, a.backend_name, a.frontend_name)
+            else:
+                print("cg link: pass --backend and --frontend, or repeated --repo NAME=DB[:role]", file=sys.stderr)
+                return 2
+        except ValueError as ex:
+            print(f"cg link: {ex}", file=sys.stderr)
+            return 2
         if a.report:
             write_match_report(res, a.report)
         print(json.dumps(res["stats"], indent=2))

{cg_code_graph-0.12.0 → cg_code_graph-0.13.0}/codegraph/config.py

@@ -33,9 +33,10 @@ Records project-specific knowledge once, for the CLI, the MCP server and the vis
     viz:
       presets:                               # canned queries in the visual view's starter cards
         - {id: orders_writes, label: what writes the orders table, mode: reaches, specs: ["table:orders"]}
-    apps:                                    # monorepo: `cg index <root>` indexes each app and links each pair
+    apps:                                    # workspace: `cg index <root>` indexes each app into one combined graph
       - {name: api, root: apps/api, role: backend}
       - {name: web, root: apps/web, role: frontend, links: [api]}   # links: backends it calls (default: all)
+      # root may also be absolute or ../other-repo (a workspace of separate checkouts)
 
 Command-line flags take precedence over the file. Top-level keys this version does not read are kept and reported
 in the index stats (and as a warning by `cg config validate`), so a file written for a newer cg still indexes."""
@@ -75,6 +76,17 @@ def find(root: str | Path) -> Path | None:
     return None
 
 
+def norm_app_root(value: Any, where: str) -> str:
+    """An app directory: relative to the workspace (`apps/api`, `./src`, `.`), `../other-repo`, or absolute."""
+    if not isinstance(value, str) or not value.strip():
+        raise ConfigError(f"{where}: expected a directory path, got {value!r}")
+    v = value.strip().replace("\\", "/")
+    if re.match(r"^[A-Za-z]:/", v) or v.startswith("/"):
+        return v.rstrip("/") or "/"
+    s = str(PurePosixPath(v))
+    return "" if s == "." else s
+
+
 def norm_root(value: Any, where: str) -> str:
     """A repo-relative directory: 'lib', 'tools/scripts/', './src', '.'. Absolute paths and '..' are rejected."""
     if not isinstance(value, str) or not value.strip():
@@ -309,8 +321,8 @@ def parse(data: Any, fname: str = ".cg.yaml") -> dict:
 
 def _apps(v: Any, fname: str) -> list[dict]:
     """apps as a list of {name, root, role, links} (or a mapping name -> {root, role, links}), validated: unique names,
-    roots inside the indexed root, role backend / frontend, links naming backend apps. A frontend without `links`
-    links to every backend."""
+    role backend / frontend, links naming backend apps. `root` may be relative, `../other-repo` or absolute.
+    A frontend without `links` links to every backend."""
     if isinstance(v, dict):
         v = [dict(x or {}, name=k) if isinstance(x, dict) or x is None else x for k, x in v.items()]
     if not isinstance(v, list) or not v:
@@ -329,7 +341,7 @@ def _apps(v: Any, fname: str) -> list[dict]:
         if name in names:
             raise ConfigError(f"{where}.name: {name!r} is used by two apps")
         names.add(name)
-        root = norm_root(a.get("root") if a.get("root") is not None else name, f"{where}.root")
+        root = norm_app_root(a.get("root") if a.get("root") is not None else name, f"{where}.root")
         role = a.get("role", "backend")
         if role not in APP_ROLES:
             raise ConfigError(f"{where}.role: expected backend or frontend, got {role!r}")