python-delphi-lsp 2.2.0__tar.gz → 2.3.0__tar.gz

{python_delphi_lsp-2.2.0/python_delphi_lsp.egg-info → python_delphi_lsp-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-delphi-lsp
-Version: 2.2.0
+Version: 2.3.0
 Summary: Python Delphi/Object Pascal parser, semantic indexer, and language server.
 Author: Dark Light
 License-Expression: MPL-2.0
@@ -42,7 +42,7 @@ Dynamic: license-file
 
 `python-delphi-lsp` parses Delphi/Object Pascal, builds semantic and project
 indexes, serves LSP, and provides bounded codebase navigation for agents.
-Version 2.2.0 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 2.3.0 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -257,6 +257,13 @@ to measure it. If an automatic pool fails before accepting a result, one
 automatic serial fallback is attempted; explicit worker counts fail instead of
 silently changing the requested configuration.
 
+Detached navigation shards are also stored as versioned, content-addressed JSON
+under `.delphi-lsp/agent-cache/navigation-v1`. A restarted CLI or OpenCode cache
+daemon reuses unchanged units without parsing them again. Source content,
+conditional defines, or a shard-schema change produces a cache miss; malformed
+or incompatible JSON is ignored and rebuilt. The disk cache contains no pickle
+payloads and does not count against the retained-RAM budget.
+
 Cache prewarming builds the navigation registry directly without constructing
 an empty-query result, symbol cards, pagination, or JSON payloads. Up to sixteen
 recent ranked queries are retained in a small LRU so alternating CLI and
@@ -276,7 +283,8 @@ The daemon tracks a 30-minute idle timeout; idle state shows in JSON status (`ca
 Workspace state appears in status as `requests`, `warm_hits`, `rebuilds`, `invalidations`,
 `evictions`, and `cache_state`. Parallel prewarm status adds
 `workers_configured`, `workers_effective`, `parallel_files_completed`,
-`prewarm_seconds`, `parallel_seconds`, and `parallel_fallbacks`.
+`prewarm_seconds`, `parallel_seconds`, `parallel_fallbacks`,
+`navigation_disk_hits`, and `navigation_disk_misses`.
 
 Metadata is stored in `.delphi-lsp/agent-cache/daemon.json` with owner-only token and
 permissions (`daemon.json` mode 600 and parent 700). Do not copy or share this token

{python_delphi_lsp-2.2.0 → python_delphi_lsp-2.3.0}/README.md

@@ -2,7 +2,7 @@
 
 `python-delphi-lsp` parses Delphi/Object Pascal, builds semantic and project
 indexes, serves LSP, and provides bounded codebase navigation for agents.
-Version 2.2.0 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 2.3.0 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -217,6 +217,13 @@ to measure it. If an automatic pool fails before accepting a result, one
 automatic serial fallback is attempted; explicit worker counts fail instead of
 silently changing the requested configuration.
 
+Detached navigation shards are also stored as versioned, content-addressed JSON
+under `.delphi-lsp/agent-cache/navigation-v1`. A restarted CLI or OpenCode cache
+daemon reuses unchanged units without parsing them again. Source content,
+conditional defines, or a shard-schema change produces a cache miss; malformed
+or incompatible JSON is ignored and rebuilt. The disk cache contains no pickle
+payloads and does not count against the retained-RAM budget.
+
 Cache prewarming builds the navigation registry directly without constructing
 an empty-query result, symbol cards, pagination, or JSON payloads. Up to sixteen
 recent ranked queries are retained in a small LRU so alternating CLI and
@@ -236,7 +243,8 @@ The daemon tracks a 30-minute idle timeout; idle state shows in JSON status (`ca
 Workspace state appears in status as `requests`, `warm_hits`, `rebuilds`, `invalidations`,
 `evictions`, and `cache_state`. Parallel prewarm status adds
 `workers_configured`, `workers_effective`, `parallel_files_completed`,
-`prewarm_seconds`, `parallel_seconds`, and `parallel_fallbacks`.
+`prewarm_seconds`, `parallel_seconds`, `parallel_fallbacks`,
+`navigation_disk_hits`, and `navigation_disk_misses`.
 
 Metadata is stored in `.delphi-lsp/agent-cache/daemon.json` with owner-only token and
 permissions (`daemon.json` mode 600 and parent 700). Do not copy or share this token

python_delphi_lsp-2.3.0/delphi_lsp/_version.py

@@ -0,0 +1 @@
+__version__ = "2.3.0"

{python_delphi_lsp-2.2.0 → python_delphi_lsp-2.3.0}/delphi_lsp/agent_cache.py

@@ -280,6 +280,18 @@ def _safe_metadata_path(root: str | Path, *, create: bool = False) -> Path:
     return result
 
 
+def _safe_navigation_cache_path(root: str | Path, *, create: bool = False) -> Path:
+    parent = _safe_metadata_path(root, create=create).parent
+    result = parent / "navigation-v1"
+    if result.exists() and result.is_symlink():
+        raise CacheClientError("unsafe_metadata", "Navigation cache path is unsafe.")
+    if create:
+        result.mkdir(mode=0o700, exist_ok=True)
+        if os.name != "nt":
+            os.chmod(result, 0o700)
+    return result
+
+
 def _metadata_mapping(metadata: CacheMetadata) -> dict[str, object]:
     return {field.name: getattr(metadata, field.name) for field in fields(metadata)}
 
@@ -549,6 +561,10 @@ class _CacheService:
             workers=metadata.workers,
             worker_memory_budget_bytes=metadata.max_memory_bytes,
             revision_check_interval_seconds=_CACHE_REVISION_CHECK_INTERVAL_SECONDS,
+            navigation_cache_dir=_safe_navigation_cache_path(
+                metadata.root,
+                create=True,
+            ),
         )
         self.budget = CacheBudget(metadata.max_memory_bytes)
         self.stats = CacheStats()
@@ -648,6 +664,8 @@ class _CacheService:
             "prewarm_seconds": self.prewarm_seconds,
             "parallel_seconds": self.context.parallel_stats.elapsed_seconds,
             "parallel_fallbacks": self.stats.parallel_fallbacks,
+            "navigation_disk_hits": self.context.navigation_disk_hits,
+            "navigation_disk_misses": self.context.navigation_disk_misses,
             "idle_timeout": self.metadata.idle_timeout, "idle_remaining": max(0.0, self.metadata.idle_timeout - idle),
             "workspace_revision": self.last_revision,
         }