graphlint 0.3.3__tar.gz → 0.3.4__tar.gz

{graphlint-0.3.3 → graphlint-0.3.4}/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.3.4] - 2026-07-27
+
+### Changed
+- Incremental entry detection: entry point results are now persisted to DB
+  and only re-scanned for changed files in incremental builds, reducing
+  redundant computation when most files are unchanged
+
 ## [0.3.3] - 2026-07-25
 
 ### Changed

{graphlint-0.3.3/graphlint.egg-info → graphlint-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphlint
-Version: 0.3.3
+Version: 0.3.4
 Summary: A static analysis tool for identifying dead code in a codebase. It provides Python API and CLI for use by agents.
 Author-email: Yutong Zou <yutong.zou.24@alumni.ucl.ac.uk>
 License-Expression: MIT

{graphlint-0.3.3 → graphlint-0.3.4}/graphlint/__init__.py

@@ -3,7 +3,7 @@
 
 from typing import Any
 
-__version__ = "0.3.3"
+__version__ = "0.3.4"
 
 __all__ = ["query", "build", "configure", "__version__"]
 

{graphlint-0.3.3 → graphlint-0.3.4}/graphlint/analyzer/graph.py

@@ -259,6 +259,7 @@ class GraphBuilder:
         parse_results: dict[str, ParseResult],
         changed_files: Optional[set[str]] = None,
         prebuilt_edges: Optional[list[EdgeInfo]] = None,
+        prebuilt_entries: Optional[list[EntryInfo]] = None,
         old_changed_node_ids: dict[int, tuple[str, str]] | None = None,
     ) -> GraphBuildResult:
         """Build the complete dependency graph from parse results.
@@ -267,6 +268,9 @@ class GraphBuilder:
             old_changed_node_ids: Maps old global node ID → (qualified_name, file_path)
                 for nodes in changed files. Used to remap parent_node_id when a
                 child in an unchanged file references a parent in a changed file.
+            prebuilt_entries: Pre-loaded EntryInfo from DB for unchanged files
+                (incremental mode). When provided, entry detection only scans
+                changed files and merges these prebuilt entries.
         """
         fid_map: dict[str, int] = {}
         fid_cnt = 1
@@ -332,15 +336,30 @@ class GraphBuilder:
             if fid and fid in file_nodes_by_fid:
                 fnodes_map[fp] = {n.qualified_name: n.id for n in file_nodes_by_fid[fid]}
 
-        # Detect entries via language adapters
+        # Detect entries via language adapters.
+        # In incremental mode, only scan changed files and merge prebuilt
+        # entries loaded from DB for unchanged files.
         entries: list[EntryInfo] = []
-        if self.registry:
-            for adapter in self.registry.all_adapters():
-                entries.extend(
-                    adapter.detect_entries(
-                        parse_results, self._nodes, self._node_id_map, self.config
+        if prebuilt_entries is not None and changed_files and len(changed_files) < len(parse_results):
+            changed_pr = {
+                fp: pr for fp, pr in parse_results.items() if fp in changed_files
+            }
+            if self.registry:
+                for adapter in self.registry.all_adapters():
+                    entries.extend(
+                        adapter.detect_entries(
+                            changed_pr, self._nodes, self._node_id_map, self.config
+                        )
+                    )
+            entries.extend(prebuilt_entries)
+        else:
+            if self.registry:
+                for adapter in self.registry.all_adapters():
+                    entries.extend(
+                        adapter.detect_entries(
+                            parse_results, self._nodes, self._node_id_map, self.config
+                        )
                     )
-                )
         for e in entries:
             if e.node_id and e.node_id in self._node_id_map:
                 self._node_id_map[e.node_id].is_entry = True

{graphlint-0.3.3 → graphlint-0.3.4}/graphlint/incremental/_db_ops.py

@@ -9,7 +9,7 @@ import json
 import os
 from typing import Any, Optional
 
-from graphlint.analyzer._types import EdgeInfo, NodeInfo, GraphBuildResult
+from graphlint.analyzer._types import EdgeInfo, EntryInfo, NodeInfo, GraphBuildResult
 from graphlint.storage.db import Database
 from graphlint.storage.hashing import compute_file_hash, is_test_file
 
@@ -96,13 +96,14 @@ def update_db(
         else:
             # Full build: unconditionally clear all data tables (keep files table)
             # files table is updated by subsequent _upsert_files INSERT OR REPLACE
-            for tbl in ("edges", "nodes", "imports", "warnings", "graph_snapshots"):
+            for tbl in ("edges", "nodes", "imports", "warnings", "graph_snapshots", "entries"):
                 db.execute(f"DELETE FROM {tbl}")
         _upsert_files(db, build_result, root_dir, test_patterns, changed)
         fid_map = _load_fid_map(db)
         _insert_nodes(db, build_result, fid_map, changed_files=changed_set)
         _do_insert_edges(db, build_result, fid_map, changed_files=changed_set)
         _insert_warnings(db, build_result, fid_map, changed_files=changed_set)
+        _insert_entries(db, build_result, fid_map, changed_files=changed_set)
         if incremental:
             update_snapshots(db, build_result)
         else:
@@ -115,7 +116,7 @@ def _delete_old(db: Database, removed: list[str], changed: list[str]) -> None:
         if not paths:
             continue
         ph = ",".join("?" for _ in paths)
-        for tbl in ("edges", "nodes", "imports", "warnings"):
+        for tbl in ("edges", "nodes", "imports", "warnings", "entries"):
             db.execute(
                 f"DELETE FROM {tbl} WHERE file_id IN "
                 f"(SELECT id FROM files WHERE path IN ({ph}))",
@@ -302,6 +303,77 @@ def _insert_warnings(
         )
 
 
+def _insert_entries(
+    db: Database,
+    build_result: GraphBuildResult,
+    fid_map: dict[str, int],
+    changed_files: Optional[set[str]] = None,
+) -> None:
+    """Insert entry point detection results."""
+    batch: list[tuple[Any, ...]] = []
+    for entry in build_result.entry_info_list:
+        fp = entry.file_path
+        if changed_files is not None and fp not in changed_files:
+            continue
+        fid = fid_map.get(fp, 0)
+        if not fid:
+            continue
+        batch.append(
+            (
+                fid,
+                entry.node_id or 0,
+                entry.rule_name,
+                entry.line,
+                entry.description or "",
+                1 if entry.no_propagate else 0,
+            )
+        )
+        if len(batch) >= 5000:
+            db.executemany(
+                "INSERT INTO entries (file_id, node_id, rule_name, "
+                "line, description, no_propagate) VALUES (?,?,?,?,?,?)",
+                batch,
+            )
+            batch.clear()
+    if batch:
+        db.executemany(
+            "INSERT INTO entries (file_id, node_id, rule_name, "
+            "line, description, no_propagate) VALUES (?,?,?,?,?,?)",
+            batch,
+        )
+
+
+def load_unchanged_entries(
+    db: Database,
+    unchanged_files: set[str],
+) -> list[EntryInfo]:
+    """Load entry points for unchanged files from DB (incremental build)."""
+    if not unchanged_files:
+        return []
+    ph = ",".join("?" for _ in unchanged_files)
+    rows = db.fetchall(
+        f"SELECT e.*, f.path FROM entries e "
+        f"JOIN files f ON e.file_id = f.id "
+        f"WHERE f.path IN ({ph})",
+        tuple(unchanged_files),
+    )
+    entries: list[EntryInfo] = []
+    for r in rows:
+        file_path = r["path"]
+        node_id = r["node_id"] or 0
+        entries.append(
+            EntryInfo(
+                rule_name=r["rule_name"],
+                file_path=file_path,
+                line=r["line"],
+                node_id=node_id,
+                description=r["description"] or "",
+                no_propagate=bool(r["no_propagate"]),
+            )
+        )
+    return entries
+
+
 def _precompute_edge_counts(
     component_map: dict[int, int],
     edges: list[EdgeInfo],

{graphlint-0.3.3 → graphlint-0.3.4}/graphlint/incremental/indexer.py

@@ -20,6 +20,7 @@ from graphlint.incremental._db_ops import (
     build_snapshots,
     load_old_changed_node_ids,
     load_prebuilt_edges,
+    load_unchanged_entries,
     persist_unchanged_parent_node_ids,
     update_db,
     update_snapshots,
@@ -140,7 +141,7 @@ class IncrementalIndexer:
 
         if needs_full:
             with self.db.transaction():
-                for t in ("edges", "nodes", "imports", "warnings", "graph_snapshots", "files"):
+                for t in ("edges", "nodes", "imports", "warnings", "graph_snapshots", "entries", "files"):
                     self.db.execute(f"DELETE FROM {t}")
             all_results = self._parse_batch(disk_files)
             for fp, pr in all_results:
@@ -186,11 +187,15 @@ class IncrementalIndexer:
                     prebuilt = load_prebuilt_edges(self.db, unchanged, sql_to_mem)
 
             # ------ Phase 4: Rebuild graph (upstream + downstream + analysis) --
+            prebuilt_entries: Optional[list[Any]] = None
+            if unchanged:
+                prebuilt_entries = load_unchanged_entries(self.db, unchanged)
             builder = self._create_builder(wc)
             br = builder.build(
                 pr_map,
                 changed_files=set(changed),
                 prebuilt_edges=prebuilt,
+                prebuilt_entries=prebuilt_entries,
                 old_changed_node_ids=old_ids if old_ids else None,
             )
 

{graphlint-0.3.3 → graphlint-0.3.4}/graphlint/storage/schema.py

@@ -117,6 +117,19 @@ CREATE TABLE IF NOT EXISTS graph_snapshots (
 
 CREATE INDEX IF NOT EXISTS idx_snapshots_time ON graph_snapshots(snapshot_time);
 
+-- Entry points: persisted detection results for incremental rebuild reuse
+CREATE TABLE IF NOT EXISTS entries (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    file_id         INTEGER NOT NULL REFERENCES files(id) ON DELETE CASCADE,
+    node_id         INTEGER DEFAULT 0,
+    rule_name       TEXT NOT NULL,
+    line            INTEGER NOT NULL DEFAULT 0,
+    description     TEXT NOT NULL DEFAULT '',
+    no_propagate    INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_entries_file ON entries(file_id);
+
 -- Component members: maps node_id to component_id for incremental connectivity analysis
 CREATE TABLE IF NOT EXISTS component_members (
     component_id    INTEGER NOT NULL,

{graphlint-0.3.3 → graphlint-0.3.4/graphlint.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphlint
-Version: 0.3.3
+Version: 0.3.4
 Summary: A static analysis tool for identifying dead code in a codebase. It provides Python API and CLI for use by agents.
 Author-email: Yutong Zou <yutong.zou.24@alumni.ucl.ac.uk>
 License-Expression: MIT

{graphlint-0.3.3 → graphlint-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "graphlint"
-version = "0.3.3"
+version = "0.3.4"
 description = "A static analysis tool for identifying dead code in a codebase. It provides Python API and CLI for use by agents."
 readme = "README_PYPI.md"
 license = "MIT"