compass-code 0.1.0__py3-none-any.whl

compass_cli/result_views.py

@@ -0,0 +1,389 @@
+"""Rich views of query results, for a person reading them in a terminal.
+
+The query commands print these only when stdout is a terminal. Piped output (scripts,
+coding agents running ``compass`` in a shell) keeps the compact one-line-per-item text
+from ``compass_core.render``, which is cheaper to read and easy to grep. Both show the same
+facts; only the layout differs.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Iterable, Sequence
+
+from rich import box
+from rich.console import Group, RenderableType
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+
+from compass_cli.display import GOLD
+from compass_core.contract.models import Caveat, IndexStatus, ResultItem, SymbolRef
+from compass_core.contract.results import (
+    ImpactResult,
+    NodeDetail,
+    OverviewResult,
+    RankedSymbol,
+    SearchResult,
+)
+from compass_core.contract.types import CaveatCode
+from compass_core.render import local_name, location, match_reason, plural, via_text
+from compass_core.shared_types import EdgeType, SymbolKind
+
+EDGE_LABELS: dict[EdgeType, str] = {
+    EdgeType.CONTAINS: "Contains",
+    EdgeType.IMPORTS: "Imports",
+    EdgeType.INHERITS: "Inherits",
+    EdgeType.CALLS: "Calls",
+    EdgeType.CALLS_EXTERN: "External calls",
+}
+"""Row label for each edge type in the overview totals."""
+
+_NO_WRAP = frozenset({"Location", "File", "Kind", "Hops"})
+"""Columns kept on one line; narrow terminals wrap the others first."""
+
+_LABEL_WIDTH = 13
+"""Width of the dim label column in key/value grids, matching the ingest summary."""
+
+
+def _title(text: str) -> Text:
+    return Text(text, style=f"bold {GOLD}")
+
+
+def _location(symbol: SymbolRef) -> Text:
+    """``path:line`` with the directory dimmed, so the file name stands out."""
+    where = location(symbol)
+    directory, slash, rest = where.rpartition("/")
+    text = Text(overflow="fold")
+    if slash:
+        text.append(directory + slash, style="dim")
+    text.append(rest)
+    return text
+
+
+def _name(symbol: SymbolRef) -> Text:
+    """The name within its file, last part bold (``User.`` **save**); a file's base name."""
+    prefix, dot, last = local_name(symbol).rpartition(".")
+    text = Text(overflow="fold")
+    if dot and symbol.kind is not SymbolKind.FILE:
+        text.append(prefix + dot, style="dim")
+        text.append(last, style="bold")
+    else:
+        text.append(local_name(symbol).rpartition("/")[2], style="bold")
+    return text
+
+
+def _table(*headers: str, numeric: Sequence[str] = ()) -> Table:
+    table = Table(box=box.SIMPLE_HEAD, header_style="dim", show_edge=False, pad_edge=False)
+    for header in headers:
+        table.add_column(
+            header,
+            justify="right" if header in numeric else "left",
+            no_wrap=header in _NO_WRAP,
+        )
+    return table
+
+
+def _section(title: str, body: RenderableType) -> Group:
+    return Group(Text(""), _title(title), body)
+
+
+def _caveats(caveats: Iterable[Caveat]) -> list[Text]:
+    """Caveats in yellow; a stale index is already flagged by ``index_line``."""
+    return [
+        Text(f"! {caveat.message}", style="yellow")
+        for caveat in caveats
+        if caveat.code is not CaveatCode.STALE_INDEX
+    ]
+
+
+def _more(shown: int, total: int) -> list[Text]:
+    hidden = total - shown
+    if hidden <= 0:
+        return []
+    return [Text(f"… {hidden:,} more; raise --limit to see them", style="dim")]
+
+
+def _freshness(status: IndexStatus) -> Text:
+    if status.stale_file_count:
+        changed = plural(status.stale_file_count, "file")
+        return Text(f"⚠ {changed} changed since; run compass ingest", style="yellow")
+    return Text("✓ up to date", style="green")
+
+
+def index_line(status: IndexStatus) -> Text:
+    """One dim line saying which index answered and whether it is fresh.
+
+    Args:
+        status: The index status every result carries.
+
+    Returns:
+        The line, e.g. ``index 5610406 · built 2026-11-10 09:30 UTC · ✓ up to date``.
+    """
+    commit = status.indexed_commit[:7] if status.indexed_commit else "no git commit"
+    built = status.indexed_at.strftime("%Y-%m-%d %H:%M UTC")
+    line = Text(f"index {commit} · built {built} · ", style="dim")
+    line.append_text(_freshness(status))
+    return line
+
+
+def status_view(status: IndexStatus) -> Panel:
+    """The index: which repository, which commit, when it was built and if it is fresh.
+
+    Args:
+        status: The index status.
+
+    Returns:
+        A gold panel with one labelled row per fact.
+
+    Example:
+        ``Repository  /home/me/app``, ``Commit  5610406``, ``Built  2026-11-10 09:30 UTC``
+        and ``Status  ✓ up to date``.
+    """
+    grid = Table.grid(padding=(0, 3))
+    grid.add_column(style="dim", min_width=_LABEL_WIDTH)
+    grid.add_column()
+    grid.add_row("Repository", Text(str(status.repo_root), style="bold"))
+    grid.add_row("Commit", status.indexed_commit[:7] if status.indexed_commit else "no git commit")
+    grid.add_row("Built", status.indexed_at.strftime("%Y-%m-%d %H:%M UTC"))
+    grid.add_row("Status", _freshness(status))
+    return Panel(grid, title=_title("compass index"), border_style=GOLD, padding=(1, 2))
+
+
+def _totals(result: OverviewResult) -> Table:
+    counts, calls = result.counts, result.call_resolution
+    percent = round(100 * calls.resolved / calls.total) if calls.total else 0
+
+    left = Table.grid(padding=(0, 3))
+    left.add_column(style="dim", min_width=_LABEL_WIDTH)
+    left.add_column(style="bold")
+    left.add_row("Files", f"{counts.files:,}")
+    left.add_row("Classes", f"{counts.classes:,}")
+    left.add_row("Functions", f"{counts.functions:,}")
+    resolved = Text(f"{percent}%", style="bold")
+    resolved.append(f"  ({calls.resolved:,} of {calls.total:,})", style="dim")
+    left.add_row("Calls resolved", resolved)
+
+    right = Table.grid(padding=(0, 3))
+    right.add_column(style="dim", min_width=_LABEL_WIDTH)
+    right.add_column(style="bold")
+    for edge, count in counts.edges_by_type.items():
+        right.add_row(EDGE_LABELS[edge], f"{count:,}")
+
+    columns = Table.grid(padding=(0, 8))
+    columns.add_column()
+    columns.add_column()
+    columns.add_row(left, right)
+    return columns
+
+
+def _ranked(ranked: tuple[RankedSymbol, ...], count_header: str) -> Table:
+    """One row per symbol with its count; files show only their path."""
+    if all(item.symbol.kind is SymbolKind.FILE for item in ranked):
+        files = _table("File", count_header, numeric=(count_header,))
+        for item in ranked:
+            files.add_row(_location(item.symbol), f"{item.count:,}")
+        return files
+    table = _table("Name", "Location", count_header, numeric=(count_header,))
+    for item in ranked:
+        table.add_row(_name(item.symbol), _location(item.symbol), f"{item.count:,}")
+    return table
+
+
+def overview_view(result: OverviewResult) -> Group:
+    """The shape of the repository: totals, then one table per hot-spot list.
+
+    Args:
+        result: An overview result.
+
+    Returns:
+        The index line, a gold panel of totals, the entry points and the ranked tables,
+        then any caveats.
+
+    Example:
+        A panel with ``Files 147`` and ``Calls 225``, then ``Most called functions`` as a
+        table of ``Name``, ``Location`` and ``Callers``.
+    """
+    parts: list[RenderableType] = [
+        index_line(result.index),
+        Panel(_totals(result), title=_title("compass overview"), border_style=GOLD, padding=(1, 2)),
+    ]
+    if result.entry_points:
+        entries = _table("File", "Module")
+        for symbol in result.entry_points:
+            entries.add_row(_location(symbol), Text(symbol.qualified_name, style="dim"))
+        parts.append(_section("Entry points  (files nothing imports)", entries))
+    sections = (
+        ("Most imported files", result.most_imported_files, "Importers"),
+        ("Most called functions", result.most_called_functions, "Callers"),
+        ("Riskiest to change", result.riskiest_to_change, "Affected"),
+    )
+    for title, ranked, header in sections:
+        if ranked:
+            parts.append(_section(title, _ranked(ranked, header)))
+    if result.top_external_libraries:
+        libraries = _table("Library", "Calls", numeric=("Calls",))
+        for lib in result.top_external_libraries:
+            libraries.add_row(Text(lib.library, style="bold"), f"{lib.call_count:,}")
+        parts.append(_section("Top external libraries", libraries))
+    parts += _caveats(result.caveats)
+    return Group(*parts)
+
+
+def search_view(result: SearchResult) -> Group:
+    """Search hits as a table, best first, with why each matched.
+
+    Args:
+        result: A search result.
+
+    Returns:
+        The index line, a title with the hit count, the table and any caveats.
+
+    Example:
+        ``search "save" · 2 hits`` then rows like ``save  method  app/models.py:2  exact
+        name · 1 caller``.
+    """
+    table = _table("Name", "Kind", "Location", "Match")
+    for hit in result.hits:
+        table.add_row(
+            _name(hit.symbol),
+            Text(hit.symbol.kind.value, style="dim"),
+            _location(hit.symbol),
+            Text(match_reason(hit), style="dim"),
+        )
+    title = Text(f'search "{result.query}"', style=f"bold {GOLD}")
+    title.append(f" · {plural(result.total, 'hit')}", style="dim")
+    return Group(
+        index_line(result.index),
+        Text(""),
+        title,
+        table,
+        *_more(len(result.hits), result.total),
+        *_caveats(result.caveats),
+    )
+
+
+def _neighbours(title: str, symbols: tuple[SymbolRef, ...]) -> list[RenderableType]:
+    if not symbols:
+        return []
+    table = _table("Name", "Kind", "Location")
+    for symbol in symbols:
+        table.add_row(_name(symbol), Text(symbol.kind.value, style="dim"), _location(symbol))
+    return [_section(f"{title} ({len(symbols)})", table)]
+
+
+def describe_view(detail: NodeDetail, *, include_source: bool = False) -> Group:
+    """One symbol: a panel with where and what it is, then a table per neighbour list.
+
+    Args:
+        detail: A describe result.
+        include_source: Also show the symbol's source text.
+
+    Returns:
+        The index line, the symbol panel, the neighbour tables and any caveats.
+
+    Example:
+        A panel titled ``method User.save`` with ``Location app/models.py:6-7`` and
+        ``Id app/models.py::User.save``, then ``Callees (1)``.
+    """
+    symbol = detail.symbol
+    grid = Table.grid(padding=(0, 3))
+    grid.add_column(style="dim", min_width=_LABEL_WIDTH)
+    grid.add_column()
+    grid.add_row("Name", _name(symbol))
+    span = location(symbol)
+    if symbol.file_path and symbol.line_start and symbol.line_end != symbol.line_start:
+        span = f"{span}-{symbol.line_end}"
+    grid.add_row("Location", span)
+    grid.add_row("Id", Text(symbol.id, style="dim"))
+    if symbol.signature:
+        grid.add_row("Signature", Text(symbol.signature, style="bold"))
+    body: list[RenderableType] = [grid]
+    if detail.docstring:
+        body += [Text(""), Text(detail.docstring.strip(), style="italic")]
+    parts: list[RenderableType] = [
+        index_line(detail.index),
+        Panel(
+            Group(*body),
+            title=_title(f"{symbol.kind.value} {symbol.name}"),
+            border_style=GOLD,
+            padding=(1, 2),
+        ),
+    ]
+    parts += _neighbours("Bases", detail.bases)
+    parts += _neighbours("Subclasses", detail.subclasses)
+    parts += _neighbours("Members", detail.members)
+    parts += _neighbours("Callers", detail.callers)
+    parts += _neighbours("Callees", detail.callees)
+    parts += _neighbours("Imports", detail.imports)
+    parts += _neighbours("Imported by", detail.imported_by)
+    if detail.truncated:
+        parts.append(
+            Text("! some lists were cut short; describe the related symbols directly", "yellow")
+        )
+    if include_source and symbol.source:
+        parts.append(_section("Source", Text(symbol.source.rstrip())))
+    parts += _caveats(detail.caveats)
+    return Group(*parts)
+
+
+def _impact_row(table: Table, item: ResultItem) -> None:
+    via = via_text(item.via) if item.via else ""
+    confidence = "" if item.min_confidence is None else f"{item.min_confidence:.2f}"
+    table.add_row(
+        str(item.distance),
+        _name(item.symbol),
+        _location(item.symbol),
+        Text(via, style="dim"),
+        confidence,
+    )
+
+
+def impact_view(result: ImpactResult) -> Group:
+    """What may break if the target changes: a summary panel, then one row per symbol.
+
+    Args:
+        result: An impact result.
+
+    Returns:
+        The index line, the summary panel, the affected symbols nearest first and the
+        caveats (an empty answer is never shown as certain).
+
+    Example:
+        A panel ``impact of function decode_token`` with ``Affected 3 symbols in 2
+        files``, then rows like ``1  app.api.handle  app/api.py:4  calls decode_token
+        1.00``.
+    """
+    target = result.target
+    grid = Table.grid(padding=(0, 3))
+    grid.add_column(style="dim", min_width=_LABEL_WIDTH)
+    grid.add_column()
+    grid.add_row("Target", _name(target))
+    grid.add_row("Location", location(target))
+    grid.add_row("Depth", str(result.depth))
+    grid.add_row(
+        "Affected",
+        Text(
+            f"{plural(result.total, 'symbol')} in {plural(result.affected_file_count, 'file')}",
+            style="bold",
+        ),
+    )
+    table = _table("Hops", "Name", "Location", "Via", "Confidence", numeric=("Hops", "Confidence"))
+    shown = 0
+    for group in result.groups:
+        for item in group.items:
+            _impact_row(table, item)
+            shown += 1
+    parts: list[RenderableType] = [
+        index_line(result.index),
+        Panel(
+            grid,
+            title=_title(f"impact of {target.kind.value} {target.name}"),
+            border_style=GOLD,
+            padding=(1, 2),
+        ),
+    ]
+    if shown:
+        parts.append(table)
+    parts += _more(shown, result.total)
+    parts += _caveats(result.caveats)
+    return Group(*parts)

compass_cli/types.py

@@ -0,0 +1,41 @@
+"""Typed data objects shared across compass_cli commands."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import StrEnum
+from pathlib import Path
+
+from compass_core.shared_types import Language
+
+
+@dataclass(frozen=True)
+class IngestSummary:
+    """Aggregate results of a single `compass ingest` run."""
+
+    file_count: int
+    class_count: int
+    function_count: int
+    elapsed: float
+    node_count: int
+    edge_count: int
+    db_path: Path
+    db_size: int
+    skipped: int
+    resolved_pct: float
+    orphan_count: int
+    language_counts: dict[Language, int]
+    dropped_edges: int = 0
+
+
+class OutputFormat(StrEnum):
+    """How a query command prints its answer.
+
+    Attributes:
+        TEXT: Compact text, one line per item with ``file:line`` first; for people and
+            coding agents.
+        JSON: The typed contract result as JSON; for scripts and tools.
+    """
+
+    TEXT = "text"
+    JSON = "json"

compass_code-0.1.0.dist-info/METADATA

@@ -0,0 +1,72 @@
+Metadata-Version: 2.5
+Name: compass-code
+Version: 0.1.0
+Summary: Local-first code knowledge graph for AI coding agents: the compass command and its MCP server.
+Project-URL: Homepage, https://github.com/NIKU-SINGH/code-compass
+Project-URL: Repository, https://github.com/NIKU-SINGH/code-compass
+Project-URL: Issues, https://github.com/NIKU-SINGH/code-compass/issues
+License-Expression: Apache-2.0
+Keywords: code-graph,coding-agents,knowledge-graph,mcp,tree-sitter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: mcp<2,>=1.26.0
+Requires-Dist: pathspec>=1.0.4
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: real-ladybug<0.16,>=0.15.3
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tree-sitter-python<0.26,>=0.25.0
+Requires-Dist: tree-sitter<0.26,>=0.25.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: uvicorn>=0.32.0
+Description-Content-Type: text/markdown
+
+# Code Compass
+
+**A local-first code knowledge graph for AI coding agents.** Code Compass parses your
+repository with Tree-sitter into a graph of files, classes, functions and the calls,
+imports and inheritance between them, and answers structural questions from it: where
+something is defined, who calls it, and what may break if it changes. Coding agents
+(Claude Code, Codex, Cursor) ask over MCP; you ask with the `compass` command or in a 3D
+web view. Parsing is deterministic and nothing leaves your machine: no API keys, no
+embeddings, no network calls.
+
+> **Alpha.** Python repositories only; call resolution is partial, and every answer says
+> where it may be incomplete.
+
+## Install
+
+```bash
+uv tool install compass-code      # or: pipx install compass-code
+```
+
+## Use
+
+```bash
+cd your-repo
+compass ingest .                  # build the graph in .compass/
+compass overview                  # entry points and hot spots
+compass search save               # where is it defined?
+compass describe app/models.py::User
+compass impact decode_token       # what may break if it changes?
+compass serve                     # explore the graph in the browser
+compass setup --mcp               # let coding agents in this repo use it
+```
+
+For Codex, add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.code-compass]
+command = "compass"
+args = ["mcp"]
+```
+
+Documentation, source and issues: https://github.com/NIKU-SINGH/code-compass

compass_code-0.1.0.dist-info/RECORD

@@ -0,0 +1,137 @@
+compass_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_cli/display.py,sha256=krgkeDQuT8iIAIW_QLpufCPo6H-aI2P8wE79ey3aEPY,8043
+compass_cli/errors.py,sha256=PYXZuU2uoYTTO1kje_Iip3h6cOU9Bzd8iCo165vO-yY,809
+compass_cli/main.py,sha256=e_PefCx8nl9y09ri0gmfUKVixQq05M2VZtroODiBjfo,1497
+compass_cli/progress.py,sha256=ZK9DaK7iD-dgindMKK15kmPySSE-HuNAF0uDtokE8sI,6487
+compass_cli/result_views.py,sha256=NiCB7hhUkzZsus7ey2hua9RkX1psRWd6cZg36NfhCcs,14013
+compass_cli/types.py,sha256=mWVTx5R-yx1LMn8VOgWrYmxsOPOrasWTMbdEunlOEcQ,955
+compass_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_cli/commands/ingest.py,sha256=I7ejSqfBb_bRqK9Gd5u-e-wo5ZRdt8L6d51llYQKFaE,12237
+compass_cli/commands/mcp.py,sha256=CBH8t-rx3l7-XR9oYi_5n0jVAmUOnOVqEC3_Zbu4pmM,693
+compass_cli/commands/query.py,sha256=zNkD-nEsv5mQGyjm_2rGu41vr5zljograpmR7JtFCOU,7255
+compass_cli/commands/serve.py,sha256=5lQKA-yG7XoQlCPS7yEj5Z8bFXfZIOVaC_PjCEvdGUs,4199
+compass_cli/commands/setup.py,sha256=xtcmauTOE716zPA3OARLzvnkRMTrR77GDa5IjwHfSro,5836
+compass_core/__init__.py,sha256=bLZ28IvgwA7oBuxlzvElrUyjSnFyRiiAViXnU0mAnR4,36
+compass_core/errors.py,sha256=inwih-HI_0lHP61sW4QS6QzL6YUO40iV6xjTeC3-658,4640
+compass_core/logger.py,sha256=KErtsdB0Ns8Jng8sGw5SrwB751ynY0OmYn34uw61yZM,1209
+compass_core/progress.py,sha256=Xt74PchS_Ryq8TM2UZlzktHrTAO1LkXlqXiiCpnIpZI,1274
+compass_core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_core/render.py,sha256=z_qzdxdCLMYLZaU5tAidZKJmRFtseQiaG90_Z1BtctI,13213
+compass_core/settings.py,sha256=cWrkcniccwCKPgaLA9-f7-QPPFsGUItPSHSwrH2LMPA,2121
+compass_core/shared_types.py,sha256=svqlJnMxXZy14woxHCSB7zDq27oTcujWV87tdM_11Xo,2340
+compass_core/contract/__init__.py,sha256=OGDPIc8G_WnNzBWaWcVYvXWBlziYPfK3iE670SjiFZo,322
+compass_core/contract/errors.py,sha256=ypaw7Y_EYM48PdsNTQA97RWkdk91a0CEY2Ang7LaSLY,3864
+compass_core/contract/models.py,sha256=AjOreXm8OlBVEw2OnOBXjdAOs95grcW0PoGHnD27wGk,7478
+compass_core/contract/params.py,sha256=8US4THZ46ukORVI3IjeFsGZCU0VE7BRWTS4gzN4MQ-E,3018
+compass_core/contract/results.py,sha256=_2yIxn68Eyppoxcq3kJWNHJEeMbTddcFA7uwgv7QgfE,11245
+compass_core/contract/serialize.py,sha256=mrPoYUUpYT7_gyETdmRwzIh_H4FdXGJh9QXVChKfcLE,1507
+compass_core/contract/types.py,sha256=d8TqDwb4jDjJNhrjECXUoLabKdEpkLgLY--5EcAxm6I,2100
+compass_core/graph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_core/graph/db.py,sha256=Wx1znvYeKC87qFzRCqFVaznZ_DyiSbTbfllhmAjyLS4,7469
+compass_core/graph/schema.py,sha256=5sCkUFpQpSWyLzGrg0TuBYqlq8I2RawUyVM9zfh4uPY,6152
+compass_core/graph/stored_ids.py,sha256=p1MPMXcFjDW8vsvO4G4ojKx5MstvWk9ICvRmJHV6rGI,4567
+compass_core/graph/writer.py,sha256=1CynWY_EJE27ioDM-BsrAJ-sNjl6Pz6ujR3NMr9gx-w,17721
+compass_core/index/__init__.py,sha256=pznUFyoF9HfB5GurNvgW6MBNzS1zfvyS-Wpln54g__Q,57
+compass_core/index/freshness.py,sha256=FiMgyNJRa1Hyw_1OSznsB-d-E59qlaysaU7u8mDutvo,1868
+compass_core/index/locate.py,sha256=YSJPFVKA-OwlccaWy98jmt0ZVXIdxAV6wmIeZuNDA5M,4957
+compass_core/index/metadata.py,sha256=3kfBx1UTmmEusnZFMvER91bZmRiLhaqr4rVh10o3m4Q,4162
+compass_core/ir/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_core/ir/graph.py,sha256=ItJHo16U24EQnbHGJrTB41RN0BuGJv4fJisMqKOgt30,1753
+compass_core/ir/models.py,sha256=36Lf4OlGbROWbRpoCAcmKvphhF5g8KWIUwDkYtPJKsM,2075
+compass_core/languages/__init__.py,sha256=U5_wQ2gIBTys9lGpzlNNCvIjgLsnvzBpZ2DYx_30NnY,67
+compass_core/languages/base.py,sha256=BtR8X4LCXW177kPPInokBip06DEXjN72EUR3LMjFz20,721
+compass_core/languages/registry.py,sha256=rGk0fsBsS-LWoUHEbN1T_kOJajhMN7AhbahvmkvkjsY,3114
+compass_core/languages/python/__init__.py,sha256=_zIlp3tJ-ivgZr6lCt9MJ5YVBwvq40a0OsThL0zRjJQ,297
+compass_core/languages/python/extractor.py,sha256=wsqlP9r3zNysviqs3ls523VHRzjjCTIumh_hJzOnJuE,24802
+compass_core/languages/python/import_resolver.py,sha256=s0SHp-dcnHmNYl1qo2TdPuqtD3htbiBWXjFNALZ2T4U,4485
+compass_core/phases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_core/phases/base.py,sha256=OEC5TQHKZBu6v8huJPky8H7QdP7e90W64GtM914z-sQ,1593
+compass_core/phases/discovery.py,sha256=UcgZnYt5ttlLkHwOlD2vF_Uq62Wh6ibl4abuHYxkmQQ,5454
+compass_core/phases/parse.py,sha256=PAJiEoUB48hJrsZRNFnYU6UUcDkoEwvzKK-kMGUyB7Y,3052
+compass_core/phases/persistence.py,sha256=Bw5mNh6YaOh0qgMJUFvg8CeJ8d0XCH5YqLebXa458-4,1327
+compass_core/phases/pipeline.py,sha256=iSpinvT_QUOe2XhJIgbUC1QLHhblh06NI8aFlSwcc1s,5508
+compass_core/phases/resolution.py,sha256=ifE-PPTted4HvKcUt9EY7vXz0db281DKUzZn2-HWaVQ,23199
+compass_core/phases/symbol_table.py,sha256=sHRuNFY70mgwIMSe6FgIDG_CSzqbE21AWyAxrh_Kjy0,1389
+compass_core/phases/validation.py,sha256=VPSrzXLdCry0hO5Z_VGrjDCN5dPmPPJb_uElXVfHIQc,2869
+compass_core/query/__init__.py,sha256=Ht8JXVvajtbujwCJMsPCbTh5yP6GEficDsFsuCCkMpI,66
+compass_core/query/cypher.py,sha256=B0i6xB5e18PIy5ewbseCN7vqtmQqkWgYV_0gwcin4BU,3602
+compass_core/query/detail.py,sha256=sUyX_jVpiWFmJs5UsykgNQJjZjRz8Dj4yKShOzLeESA,8804
+compass_core/query/graph_map.py,sha256=RIX_I9JhL55v2QNUrWCNuSYmTx04xRs9_iz4CB3_JM8,4116
+compass_core/query/impact.py,sha256=piSg_4h_GkquUgAnA65X2sGfWpMonzR2GuhlL6FVP4E,11472
+compass_core/query/impact_walk.py,sha256=5wXP80ocsbYCYFND7nWnzerELHokEJdhWzHBxU9Kk6k,14703
+compass_core/query/overview.py,sha256=IZNxaOLXfmT2--WYrryixLzKjvRbtOxaU-EPm34kh6c,8474
+compass_core/query/references.py,sha256=lcHFl2nx71PKwWJUQ5zVTtVNqzvbMqjjOyOpXbGnwEQ,8941
+compass_core/query/rows.py,sha256=Ar-PJdpVBiBrYoYA1RSCK3ZXKZRSPsq_quJqsT9X0t4,11752
+compass_core/query/search.py,sha256=QAaUIKneWu51ZNyxGyuKvRDixPkR8UBEjoTmpYPpbJA,6950
+compass_core/query/status.py,sha256=c7eb204_nB3zjkBs5SeIfRSiCkC6Wi1k86vS1hGW5ws,1757
+compass_core/query/walk_queries.py,sha256=Rvkla5pb1Nm5gyva745fwqauIMcM21Cg-uO7CX-XyJc,5911
+compass_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_mcp/guide.py,sha256=rAYwnxn0TZypSyDPxRdYorQ2OMPbtc_lNNIFt7CuqmM,2450
+compass_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_mcp/server.py,sha256=-owv7sHphYh8_VW3yUa_HZRz2JxpGC77PTo3UakR_jc,10015
+compass_server/__init__.py,sha256=uVqAZBP4QElVBIzkwhNYC4qJYp6NKm4p3wtOss66zdM,209
+compass_server/errors.py,sha256=rz8nCLlSo8miCsQeTRREZ7s_oPBiC3Ag4xm8aur5b0s,2959
+compass_server/main.py,sha256=O9K6bznDv2QvBgWTSrnjqLwRoVRyBG9-AR8KjuJWE1M,1437
+compass_server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_server/settings.py,sha256=GFgJTRK7Y0icLKgg53FyUlbILki101yuHC4ISZZbYhc,1543
+compass_server/web_bundle.py,sha256=_miKsqgubeU_Swcx8Vg5GPLivVj_H-ZGaY_fkVtQ8tk,840
+compass_server/web_limits.py,sha256=gmGP8CnpOouCNFSf2yfNJWsIKIZpRUaxG_JWK4j1LOY,1640
+compass_server/routers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+compass_server/routers/query.py,sha256=mnhBBHYFjR-Lu-72Xi3lDcpVQjFar4MWWkz9ei_nRr4,6498
+compass_server/static/404.html,sha256=xx5ek8k-8rmKLQY2mWnjQoOTTrO6cF6CY6Z__OFTMcU,8944
+compass_server/static/index.html,sha256=0pNeobPgYfp1_7NoA8fipDvsgj5cUinRw9hrE-2EaTw,8837
+compass_server/static/index.txt,sha256=TSPr0oaUdavPv7hF4tR0-AE7OJp_oP7TCuk4vNcjlN8,4917
+compass_server/static/_next/static/chunks/1629039a.eed2a06658ec4f9c.js,sha256=CzwYPfFrw8P8JQYIqRjPOoUI9bjjsMGeJkhTQ72wYP8,325287
+compass_server/static/_next/static/chunks/1ff282bf-bb7c483245264fc9.js,sha256=v36UjjYs-FTFbnbFaCOG9X8vjZIcmnDYxcFgd131cVw,173024
+compass_server/static/_next/static/chunks/223.f881a22f446259bf.js,sha256=0B72j0iI_J2ksjZAXKJzQ0frU3TU3I6RIBPwRxfEOPQ,242122
+compass_server/static/_next/static/chunks/51fa5c19.6396973222c9d6fd.js,sha256=LlR323CG2bbBFD7DKcoYEn-naLLHnZtlT8sQGPTouHU,615887
+compass_server/static/_next/static/chunks/556.443c1682b6b20128.js,sha256=E01B1nCUGSXk6R5ufcxHON27xsaii-UP-Tej2btlN4Y,12512
+compass_server/static/_next/static/chunks/684-1aa0170f59baf77e.js,sha256=fGIZoOayzSCMeA1LZ2yebfA1oSREDXNXVk885_GbxLY,643162
+compass_server/static/_next/static/chunks/92e71660.3a42d4f70d017951.js,sha256=pApYdSv8vU-m31VwFmj-8jJAZDwh3n2tQw2wH0igQ90,356819
+compass_server/static/_next/static/chunks/937-8692224bb6d1b605.js,sha256=fdiJJPvd7INYsAJKoJ7o04txhGNdAEOM2zhxUOgLUWQ,173207
+compass_server/static/_next/static/chunks/framework-96dcd958cfe08bd4.js,sha256=aVpaPpZV0_FPiahM-SI4Mgj8toXHGxlCOP-ThrWHAxA,189785
+compass_server/static/_next/static/chunks/main-6dee8e626b16731a.js,sha256=--C4B4IYTh1m6Ju77MDPdyvxeIVSmny7lfMPGKmRfu8,127924
+compass_server/static/_next/static/chunks/main-app-460e8bc670818718.js,sha256=-zXnZGz9DsQnVjxS51Xp4SQ9J0QWNf_sc41Gm1fuyTY,569
+compass_server/static/_next/static/chunks/polyfills-42372ed130431b0a.js,sha256=CXPB1kyIrcjjyVBBDLWLKI9yEY1ZZbeASUON648vloM,112594
+compass_server/static/_next/static/chunks/webpack-597057bf48ce4111.js,sha256=8fUZdRdxkSDbh4vowE-E9L3fyJ-tC1IaX_snJzLOevk,3713
+compass_server/static/_next/static/chunks/app/layout-4bd0ba4a7d18aff9.js,sha256=xIYQqZKBs1Se2ByHaVevd4895_8Ki2QiZ4LGpZb2i20,991
+compass_server/static/_next/static/chunks/app/page-5376a0a98bbd1faa.js,sha256=4iwaIvueAxRBjxc96iLPeyS8PPB4Uxg-yp0Pw0ryBxo,91866
+compass_server/static/_next/static/chunks/app/_not-found/page-2c96ddf295eb6a86.js,sha256=53bragw1qG3uwojbLK45JWTExwp3pgofBhuZpgHWNJY,2680
+compass_server/static/_next/static/chunks/pages/_app-638a3e7363f92b80.js,sha256=J0xoqYN9AaBB2ZCzKOERq1xoejbtN95S046ubjJNCuQ,239
+compass_server/static/_next/static/chunks/pages/_error-6a72dbbb45cae743.js,sha256=oVBW5enTs3OVGsSJZ5_Sh7ItTkD2qaKyn60urQFjDxc,221
+compass_server/static/_next/static/css/1b0fbfd8dd653f37.css,sha256=6VPo2Lz-UXQ8iAAiUxTF2-gXWOxB0R1DKUKnjkj4joM,77188
+compass_server/static/_next/static/ctUZeD9K7jQUgLqmBas2L/_buildManifest.js,sha256=JL8CFWQG0GDopX39z0HQhfbSBn_QYSeaxQAoXOEcBLk,506
+compass_server/static/_next/static/ctUZeD9K7jQUgLqmBas2L/_ssgManifest.js,sha256=Z49s4suAsf5y_GfnQSvm4qtq2ggxEbZPfEDTXjy6XgA,80
+compass_server/static/_next/static/media/0086f8992871c45b-s.woff2,sha256=ZuG4x8ScKDWJ7JAWdL_zaIujYyDK1MKe6cz00Do6KCA,21252
+compass_server/static/_next/static/media/034d78ad42e9620c-s.woff2,sha256=I2F6G_Zn3Wop4nJKxlledZJFSdHCXoZy4jRu84vJmEo,39504
+compass_server/static/_next/static/media/03b436aa846269de-s.woff2,sha256=0NNYz8z88OMGB9ig3HrOCAkIfzONfx80okR94Nqqw3U,23588
+compass_server/static/_next/static/media/0484562807a97172-s.p.woff2,sha256=hy6GKRhZGp6CTcA-2S8FcpQ1_7uOu7EO_37aJlkrF5g,7992
+compass_server/static/_next/static/media/08aedeceaf1dcd57-s.woff2,sha256=VWBvvHbcIyxb6471hNe09_duManyeHcRLnVIQ1ZGJ4E,20176
+compass_server/static/_next/static/media/0aa834ed78bf6d07-s.woff2,sha256=r3SGlViAvhwrly6cdmrP-3dnaNZptldu2aCRnOcufKY,12064
+compass_server/static/_next/static/media/29a4aea02fdee119-s.woff2,sha256=briALXMZ_NSIUOs45B7W6hLZF_qv36x9rlYUpRfcK1Q,39204
+compass_server/static/_next/static/media/29e7bbdce9332268-s.woff2,sha256=bY70Ir5NgnA39vLVdmoICAGIdvpemqmpJ4f62dHxeTg,39384
+compass_server/static/_next/static/media/36008747766f78c6-s.woff2,sha256=Nn317QKwguP62WFcVPVqorU4gzElessivmDHwKYI5kc,17280
+compass_server/static/_next/static/media/39969fcf98a3026e-s.woff2,sha256=eOhQ1WmDSJLT9L39IITHp8DcZK5CJvMjGvMNrnBkAOI,3028
+compass_server/static/_next/static/media/4de1fea1a954a5b6-s.p.woff2,sha256=1K5RiKZTcOz-KPQik7vugpfP1XEsaq39snDUjyvNiLA,13980
+compass_server/static/_next/static/media/5c0c2bcbaa4149ca-s.p.woff2,sha256=axAqs1qh8rMVeIu0hTQ07R5SE3YDv3o9pxpoInZ0jUU,37792
+compass_server/static/_next/static/media/67957d42bae0796d-s.woff2,sha256=Pt82Pb-dX6DNx4SuK0MaikFS9AVaiohYAowL1miAgnM,9084
+compass_server/static/_next/static/media/6d38f9d4e0f4772b-s.woff2,sha256=qRSdr4LKX-8cEr3uSSdJ9JPC4uQxN2py-58DXmcGRXM,8908
+compass_server/static/_next/static/media/6d664cce900333ee-s.p.woff2,sha256=enzho08-mUT-iPxhq7yTtts4OvorkIFf18zqRW-85OU,14168
+compass_server/static/_next/static/media/886030b0b59bc5a7-s.woff2,sha256=mS7qL3AhBFfd0Rlt5N8yQJGf_gaK0YjHnZhfukVl078,2020
+compass_server/static/_next/static/media/8888a3826f4a3af4-s.p.woff2,sha256=KJ4K_IvnMahoIjSeVFVylvFFkmSWvSE42xusDbd_d6I,7740
+compass_server/static/_next/static/media/939c4f875ee75fbb-s.woff2,sha256=fbev-84f3uacH_wmQbvKKJsEmGf1JMnYYf41q2Zwvyk,15204
+compass_server/static/_next/static/media/a1386beebedccca4-s.woff2,sha256=JHdoOksSAGgHgKdZzBuTuBZBA2LcX0x06_6vohK8t00,5448
+compass_server/static/_next/static/media/ab00a911ac2adf48-s.woff2,sha256=j9lctmxT1fJjcHurU2RDdFb_wtW7eA56zobNVtWBgj4,29236
+compass_server/static/_next/static/media/b957ea75a84b6ea7-s.p.woff2,sha256=GXo8vXKQwkLFx2UmjN1pqaOYZ_3IDNEwcfJDqBxW-3Y,7848
+compass_server/static/_next/static/media/bb3ef058b751a6ad-s.p.woff2,sha256=HgZ0CgKkQ_t_Pu2o_KpoWg9sYg4_AeZmboRylUac460,40480
+compass_server/static/_next/static/media/c3bc380753a8436c-s.woff2,sha256=cu_Goyz9N8VXEIYoz_oBFTxIDD1M3lVnREBuULnY6fc,5552
+compass_server/static/_next/static/media/cce080f35d014443-s.woff2,sha256=uFyExlW8u6O9YossH-oPvbWxWKkCIoGi-RDoL9baUJg,2988
+compass_server/static/_next/static/media/db911767852bc875-s.woff2,sha256=nIxH7grqotN49OXVcZ7L8FpgGjXChdDUi4iBBrsVz0k,39160
+compass_server/static/_next/static/media/eafabf029ad39a43-s.p.woff2,sha256=PcXQxSQo_haWJkkHoQVOu6rAf4y-RYMsEF-BnCrjl8A,7900
+compass_server/static/_next/static/media/f10b8e9d91f3edcb-s.woff2,sha256=-PDChmHIjtvO4CKkqAZXYZ6JMa-MKkfCjiMDB-KvMOU,5496
+compass_server/static/_next/static/media/f911b923c6adde36-s.woff2,sha256=E5DobMKCPnWTWJGMAcT8wbbk8BvKkVvb621o61wkRAU,7468
+compass_server/static/_next/static/media/fe0777f1195381cb-s.woff2,sha256=H65ec9J4juHeodduyjqfFXoDht5r6MKA0HalOmTDWKE,5640
+compass_code-0.1.0.dist-info/METADATA,sha256=2ZzAwOOZfZkM2LEhqJAme5blg3cu_v8pzcHGk3tKKCw,2694
+compass_code-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+compass_code-0.1.0.dist-info/entry_points.txt,sha256=tY_5a4mMnxtpCok7wP4zOHzpuKTJoaKsNL9LGOot9fs,49
+compass_code-0.1.0.dist-info/RECORD,,

compass_code-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

compass_code-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+compass = compass_cli.main:app

compass_core/__init__.py

@@ -0,0 +1 @@
+"""Code Compass – core engine."""

compass_core/contract/__init__.py

@@ -0,0 +1,6 @@
+"""Public contract of the query engine: the types every adapter sends and receives.
+
+Plain frozen dataclasses and enums with no database, I/O or adapter imports. The
+query layer builds these values; the CLI, the MCP server and the HTTP server consume
+them. Only ``serialize.py`` uses Pydantic, to turn them into JSON.
+"""