descry-codegraph 1.0.2__tar.gz → 1.1.0__tar.gz

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/CHANGELOG.md

@@ -4,6 +4,36 @@ All notable changes to Descry will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [semver](https://semver.org/) from 1.0.0.
 
+## [1.1.0] — 2026-11-03
+
+### Added
+
+- `callers` and `callees` take `exclude_tests` (CLI `--exclude-tests`, MCP
+  `exclude_tests`, web `?exclude_tests=true`), as `search` does.
+- `status` answers `changed_since_index`: how many files the graph tracks
+  are newer than it or gone; every text answer's header says so
+  (`| 2 file(s) changed since index`).
+- `descry index` logs its progress every 15 seconds while it parses and
+  while it resolves calls.
+
+### Changed
+
+- Rust: `<X as Trait>::f(x)` calls `X`'s impl of `Trait::f`, the trait's
+  default body where the impl has none, and `<dyn Trait>::f(x)` is
+  `Trait::f(x)`; the callee was read from the trait's type arguments
+  (`Trait>::f`).
+- Rust: a call on an element of a `vec![..]` a `let` binds reads what its
+  elements hold (`d[0].go()`).
+- Search: the keyword side leaves out the words a question or prompt is
+  written with ("where", "which", "the", "function"), so a whole prompt
+  searches what it asks about; a search of such words alone is unchanged.
+- Rust: glob re-exports that lead back round a cycle are walked once per
+  file: the walk that entered the cycle gives every module of it its answer.
+- Search: while an embedding model load is under way (the MCP server's at
+  its start, or the one an index run begins), a search answers keyword-only
+  instead of waiting; a search that finds no load under way, as each CLI
+  command's, begins one and waits as before.
+
 ## [1.0.2] — 2026-10-31
 
 ### Fixed

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/CONTRACT.md

@@ -59,7 +59,7 @@ as its type (`limit=ten`) is `invalid` there too.
 
 | tool | parameters | answer |
 |---|---|---|
-| `callers`, `callees` | `symbol`, `limit`=20 | `symbol`, `total`, counts, `more` (counts), `callers` / `callees` (references) |
+| `callers`, `callees` | `symbol`, `limit`=20, `exclude_tests`=false | `symbol`, `total`, counts, `more` (counts), `callers` / `callees` (references) |
 | `context` | `symbol`, `brief`, `full`, `expand_callees`, `deduplicate`, `depth`=1, `max_tokens`=2000, `callee_budget`=2000, `head_lines`, `max_output_tokens` | `symbol` (definition), `brief`; brief: `callers`, `callees` (counts); else `depth`, `callers`, `callees` (references), `callers_more`, `callees_more` (counts), `examples` (`file`, `line`, `candidates`), `members` (`id`, `name`, `line`, `tokens`), `tests`, `configs` (`id`, `line`, `type`), `omitted`, `truncated`; with `deduplicate`, a symbol shown before answers `symbol` and `repeated` only |
 | `flow` | `start`, `direction`=forward, `depth`=3, `target`, `inline_threshold`=100 | `start`, `direction`, `asked`, `depth`, `target`, `root` (tree: `id`, `name`, `type`, `tokens`, `file`, `line`, `kind`, `candidates`, `children`, `more`, `more_possible`, `seen`), `path_to_target`?, `cut`? |
 | `path` | `start`, `end`, `max_depth`=10, `direction`=forward | `status` (`found`, `not_found`, `timeout`), `start`, `end`, `direction`, `max_depth`, `hops` (`caller`, `callee` references, `file`, `line`) |
@@ -73,7 +73,7 @@ as its type (`limit=ten`) is `invalid` there too.
 | `churn` | `time_range`, `path_filter`, `limit`=20, `mode`=symbols, `exclude_generated`=true | `mode`, `time_range`, `path_filter`, `truncation_note`?, and `symbols`, `files`, `pairs` (with `file_level`?) or `message` |
 | `changes` | `commit_range`, `time_range`, `path_filter`, `show_callers`=true, `limit`=50 | `range`, `commits`, `files_count`, `symbols_count`, and `symbols` (with `callers`) or `changed_files`; or `message` |
 | `evolution` | `symbol`, `time_range`, `limit`=10, `show_diff`, `crate` | `node_id`, `mode` (`lines`, `file`), `truncation_note`?, `authors`, `commits` (`hash`, `date`, and in `lines` mode `added`, `removed`); or `message` |
-| `status` | — | `exists`, `age_str`, `age_hours`, `nodes`, `edges`, `languages`, `stale`, `error`, `scip` (`state`, `indexers`, `cached`), `embeddings` (`state`, `nodes`, `model`) |
+| `status` | — | `exists`, `age_str`, `age_hours`, `nodes`, `edges`, `languages`, `stale`, `changed_since_index`, `error`, `scip` (`state`, `indexers`, `cached`), `embeddings` (`state`, `nodes`, `model`) |
 | `health` | — | `status`, `version`, `project_root`, `cache_dir`, `warm`, `max_depth` (the deepest a `flow` or `context` goes), `features`, `graph` |
 | `ensure` | `max_age_hours` | `action` (`ready`, `refreshed`, `generated`), `summary`, `graph` (status) |
 | `index` | `path`=. (not on the web, which always indexes the project root) | the graph's status after the run |

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: descry-codegraph
-Version: 1.0.2
+Version: 1.1.0
 Summary: Codebase knowledge graph: polyglot indexer, semantic search, call-graph analysis
 Project-URL: Homepage, https://github.com/06chaynes/descry
 Project-URL: Repository, https://github.com/06chaynes/descry

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/claude-skill/descry/references/cli-reference.md

@@ -43,8 +43,8 @@ descry quick <symbol>
 ## Call graph
 
 ```bash
-descry callers <symbol> [--limit N]           # default 20
-descry callees <symbol> [--limit N]           # default 20
+descry callers <symbol> [--limit N] [--exclude-tests]   # default 20
+descry callees <symbol> [--limit N] [--exclude-tests]   # default 20
 
 descry flow <start>
     [--direction forward|backward]   # default forward

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/claude-skill/descry/references/mcp-tools.md

@@ -35,8 +35,8 @@ This is descry's prompt-injection defense — preserve it when quoting.
 - `descry_quick(symbol, full=False, brief=False)` — search + context in one.
 
 ### Call graph
-- `descry_callers(symbol, limit=20)`
-- `descry_callees(symbol, limit=20)`
+- `descry_callers(symbol, limit=20, exclude_tests=False)`
+- `descry_callees(symbol, limit=20, exclude_tests=False)`
 - `descry_flow(start, direction="forward", depth=3, target=None, inline_threshold=100)`
 - `descry_path(start, end, max_depth=10, direction="forward")`
 

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/docs/TOOLS.md

@@ -46,22 +46,23 @@ Check if the codebase graph exists and its freshness. Returns existence, age, an
 
 No parameters.
 
-Answer: `exists`, `age_str`, `age_hours`, `nodes`, `edges`, `languages`, `stale`, `error`, `scip` (`state`, `indexers`, `cached`), `embeddings` (`state`, `nodes`, `model`)
+Answer: `exists`, `age_str`, `age_hours`, `nodes`, `edges`, `languages`, `stale`, `changed_since_index`, `error`, `scip` (`state`, `indexers`, `cached`), `embeddings` (`state`, `nodes`, `model`)
 
 MCP `descry_status`; web `GET /api/status`; CLI `usage: descry status [--json]`
 
 ## callers
 
-Find all functions/methods that call a given symbol. More reliable than grep for call relationships - distinguishes actual calls from definitions and comments. Use for impact analysis before refactoring or to understand usage patterns.
+Find all functions/methods that call a given symbol. More reliable than grep for call relationships - distinguishes actual calls from definitions and comments. Use for impact analysis before refactoring or to understand usage patterns. Set exclude_tests=true to leave out test callers.
 
 | parameter | type | default |
 |---|---|---|
 | `symbol` | string | required |
 | `limit` | integer | 20 |
+| `exclude_tests` | boolean | false |
 
 Answer: `symbol`, `total`, counts, `more` (counts), `callers` / `callees` (references)
 
-MCP `descry_callers`; web `GET /api/callers`; CLI `usage: descry callers [--json] [--limit LIMIT] symbol`
+MCP `descry_callers`; web `GET /api/callers`; CLI `usage: descry callers [--json] [--limit LIMIT] [--exclude-tests] symbol`
 
 `descry callers load --json`:
 
@@ -91,16 +92,17 @@ MCP `descry_callers`; web `GET /api/callers`; CLI `usage: descry callers [--json
 
 ## callees
 
-Find what functions/methods a given symbol calls. Use for dependency analysis and understanding what a function relies on.
+Find what functions/methods a given symbol calls. Use for dependency analysis and understanding what a function relies on. Set exclude_tests=true to leave out test callees.
 
 | parameter | type | default |
 |---|---|---|
 | `symbol` | string | required |
 | `limit` | integer | 20 |
+| `exclude_tests` | boolean | false |
 
 Answer: `symbol`, `total`, counts, `more` (counts), `callers` / `callees` (references)
 
-MCP `descry_callees`; web `GET /api/callees`; CLI `usage: descry callees [--json] [--limit LIMIT] symbol`
+MCP `descry_callees`; web `GET /api/callees`; CLI `usage: descry callees [--json] [--limit LIMIT] [--exclude-tests] symbol`
 
 `descry callees main --json`:
 

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/pi-extension/descry-cli.py

@@ -38,11 +38,13 @@ def main():
     p = subparsers.add_parser("callers")
     p.add_argument("--symbol", required=True)
     p.add_argument("--limit", type=int, default=20)
+    p.add_argument("--exclude-tests", action="store_true")
 
     # callees
     p = subparsers.add_parser("callees")
     p.add_argument("--symbol", required=True)
     p.add_argument("--limit", type=int, default=20)
+    p.add_argument("--exclude-tests", action="store_true")
 
     # context
     p = subparsers.add_parser("context")
@@ -157,9 +159,9 @@ async def dispatch(args):
         elif cmd == "status":
             return await service.status()
         elif cmd == "callers":
-            return await service.callers(args.symbol, args.limit)
+            return await service.callers(args.symbol, args.limit, args.exclude_tests)
         elif cmd == "callees":
-            return await service.callees(args.symbol, args.limit)
+            return await service.callees(args.symbol, args.limit, args.exclude_tests)
         elif cmd == "context":
             return await service.context(
                 args.symbol,

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/pi-extension/descry-tools.ts

@@ -124,10 +124,12 @@ export default function (pi: ExtensionAPI) {
 		parameters: Type.Object({
 			symbol: Type.String({ description: "A node ID, or a symbol name" }),
 			limit: Type.Optional(Type.Number({ description: "Max results", default: 20 })),
+			exclude_tests: Type.Optional(Type.Boolean({ description: "Exclude test files", default: false })),
 		}),
 		async execute(_toolCallId, params, signal) {
 			const args = ["--symbol", params.symbol];
 			if (params.limit !== undefined) args.push("--limit", String(params.limit));
+			if (params.exclude_tests) args.push("--exclude-tests");
 			const result = await runDescry("callers", args, signal);
 			return { content: [{ type: "text", text: result }] };
 		},
@@ -142,10 +144,12 @@ export default function (pi: ExtensionAPI) {
 		parameters: Type.Object({
 			symbol: Type.String({ description: "A node ID, or a symbol name" }),
 			limit: Type.Optional(Type.Number({ description: "Max results", default: 20 })),
+			exclude_tests: Type.Optional(Type.Boolean({ description: "Exclude test files", default: false })),
 		}),
 		async execute(_toolCallId, params, signal) {
 			const args = ["--symbol", params.symbol];
 			if (params.limit !== undefined) args.push("--limit", String(params.limit));
+			if (params.exclude_tests) args.push("--exclude-tests");
 			const result = await runDescry("callees", args, signal);
 			return { content: [{ type: "text", text: result }] };
 		},

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "descry-codegraph"
-version = "1.0.2"
+version = "1.1.0"
 description = "Codebase knowledge graph: polyglot indexer, semantic search, call-graph analysis"
 requires-python = ">=3.11"
 authors = [{name = "Christian Haynes"}]

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/src/descry/__init__.py

@@ -1,4 +1,4 @@
 """Descry — Codebase knowledge graph: polyglot indexer, semantic search, call-graph analysis."""
 
-__version__ = "1.0.2"
+__version__ = "1.1.0"
 __all__ = ["__version__"]

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/src/descry/cli.py

@@ -67,14 +67,14 @@ def cmd_ensure(args):
 def cmd_index(args):
     svc = _make_service()
     path = args.path if args.path else "."
-    _print_answer(args, svc.index_answer(path), svc.index_text)
+    _print_answer(args, svc.index_answer(path, echo=True), svc.index_text)
 
 
 def cmd_callers(args):
     svc = _make_service()
     _print_answer(
         args,
-        svc.callers_answer(args.symbol, args.limit),
+        svc.callers_answer(args.symbol, args.limit, args.exclude_tests),
         lambda a: svc.listing_text(a, "callers", args.limit),
     )
 
@@ -83,7 +83,7 @@ def cmd_callees(args):
     svc = _make_service()
     _print_answer(
         args,
-        svc.callees_answer(args.symbol, args.limit),
+        svc.callees_answer(args.symbol, args.limit, args.exclude_tests),
         lambda a: svc.listing_text(a, "callees", args.limit),
     )
 
@@ -289,6 +289,9 @@ def build_parser():
     )
     sub.add_argument("symbol", help="A node ID, or a name")
     sub.add_argument("--limit", type=int, default=20, help="Max results (default: 20)")
+    sub.add_argument(
+        "--exclude-tests", action="store_true", help="Exclude test symbols"
+    )
     sub.set_defaults(func=cmd_callers)
 
     sub = subparsers.add_parser(
@@ -296,6 +299,9 @@ def build_parser():
     )
     sub.add_argument("symbol", help="A node ID, or a name")
     sub.add_argument("--limit", type=int, default=20, help="Max results (default: 20)")
+    sub.add_argument(
+        "--exclude-tests", action="store_true", help="Exclude test symbols"
+    )
     sub.set_defaults(func=cmd_callees)
 
     sub = subparsers.add_parser(

{descry_codegraph-1.0.2 → descry_codegraph-1.1.0}/src/descry/generate.py

@@ -11,6 +11,7 @@ import re
 import signal
 import stat
 import threading
+import time
 import tomllib
 from collections import Counter
 from pathlib import Path
@@ -704,6 +705,7 @@ class CodeGraphBuilder:
             logger.warning("Skipping %s — escapes project root via symlink", real)
             return False
 
+        parsed_count, heartbeat = 0, time.monotonic()
         for root, dirs, files in os.walk(self.root_dir, followlinks=False):
             dirs.sort()
             # A directory's manifests first: they tell how its files parse.
@@ -809,6 +811,10 @@ class CodeGraphBuilder:
                         rel_path, content, module
                     )
                 self._merge(shell)
+                parsed_count += 1
+                if time.monotonic() - heartbeat > 15:
+                    logger.info("Parsing: %d files so far", parsed_count)
+                    heartbeat = time.monotonic()
         if self.parse_cache:
             self.parse_cache.prune(whole=self.root_dir == self.rel_base)
 
@@ -990,6 +996,7 @@ class CodeGraphBuilder:
         edges_to_remove = set()
         file_stats, file_reads = {}, {}
         resolving = None  # the file whose calls are being resolved
+        resolved_count, heartbeat = 0, time.monotonic()
         for idx, edge in enumerate(self.edges):
             target = edge["target"]
             if (file_id := edge["source"].split("::")[0]) != resolving:
@@ -998,6 +1005,15 @@ class CodeGraphBuilder:
                 stats = file_stats[file_id] = dict.fromkeys(_STATS, 0)
                 if reads:
                     file_reads[file_id] = reads.start()
+                resolved_count += 1
+                if time.monotonic() - heartbeat > 15:
+                    logger.info(
+                        "Resolving calls: %d files, %d/%d edges",
+                        resolved_count,
+                        idx,
+                        len(self.edges),
+                    )
+                    heartbeat = time.monotonic()
             if file_id in kept:
                 continue
             if target.startswith("REF:"):