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

{python_delphi_lsp-2.0.5 → python_delphi_lsp-2.2.0}/.github/workflows/ci.yml

@@ -2,6 +2,7 @@ name: CI
 
 on:
   push:
+    branches: [main]
   pull_request:
 
 jobs:

{python_delphi_lsp-2.0.5 → python_delphi_lsp-2.2.0}/MANIFEST.in

@@ -6,6 +6,7 @@ include scripts/check_ornith_cache.py
 include scripts/audit_delphi_language_features.py
 include scripts/build_github_performance_corpus.py
 include scripts/benchmark_github_corpus.py
+include scripts/benchmark_parallel_cache.py
 include scripts/bootstrap_vllm_opencode_test.py
 include scripts/bootstrap_vllm_codebase_skill_test.py
 include scripts/bootstrap_vllm_opencode_test.ps1

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-delphi-lsp
-Version: 2.0.5
+Version: 2.2.0
 Summary: Python Delphi/Object Pascal parser, semantic indexer, and language server.
 Author: Dark Light
 License-Expression: MPL-2.0
@@ -24,6 +24,7 @@ License-File: LICENSE
 Requires-Dist: lark>=1.1.9
 Requires-Dist: pygls<2.0,>=1.3.0
 Requires-Dist: lsprotocol>=2023.0.1
+Requires-Dist: watchfiles<2.0,>=1.2
 Provides-Extra: lsp
 Requires-Dist: pygls<2.0,>=1.3.0; extra == "lsp"
 Requires-Dist: lsprotocol>=2023.0.1; extra == "lsp"
@@ -41,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.0.5 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 2.2.0 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -186,12 +187,15 @@ problems; paths are not guessed.
 
 ```text
 delphi-lsp-agent cache start --root PATH [--project-file FILE] [--max-memory 512M]
+                                  [--workers auto|N] [--startup-timeout 120]
                                   [--idle-timeout 1800]
 delphi-lsp-agent cache status --root PATH [--format text|json]
 delphi-lsp-agent cache stop --root PATH
 delphi-lsp-agent view --root PATH [--project-file FILE] --layer LAYER
                       [--query TEXT] [--format markdown|json] [--deep-projects]
+                      [--workers auto|N]
 delphi-lsp-agent index --root PATH [--project-file FILE] [--out FILE]
+                       [--workers auto|N]
 delphi-lsp-agent query --root PATH ACTION [VALUE]
                       [--project-id FILE] [--detail summary|declaration|members|context|body|implementations]
                       [--relation references|callers|callees|uses|used_by|inherits|implements]
@@ -199,7 +203,7 @@ delphi-lsp-agent query --root PATH ACTION [VALUE]
 delphi-lsp-agent skill install [--target PATH] [--force]
 delphi-lsp-agent opencode install [--target PATH] [--python PYTHON]
                                   [--force] [--write-agent|--write-config]
-delphi-lsp-agent worker --root PATH [--project-file FILE]
+delphi-lsp-agent worker --root PATH [--project-file FILE] [--workers auto|N]
 ```
 
 The `cache` commands manage one daemon per canonical root. Use these:
@@ -233,6 +237,36 @@ fast. The cache retained-cache budget is `512 MiB` by default and tracks retaine
 cache usage only, not a hard RSS/parse peak. Warnings are emitted on stderr at or
 above 80 percent.
 
+Cold builds parse independent source units in short-lived processes created with
+the cross-platform `spawn` method. `--workers auto|N` defaults to `auto`.
+Automatic selection uses at most eight worker processes, leaves one detected CPU
+free, never exceeds the source task count, and—for the cache daemon—allows one
+worker per `64 MiB` of retained-cache budget. `view` and `index` use the same
+task, CPU, and eight-worker caps without the cache-budget term. An explicit value
+from 1 through 32 overrides the automatic CPU and memory caps but is still
+limited by the number of tasks.
+
+Worker processes build compact, detached navigation shards and exit before
+retained-cache accounting. Full semantic object graphs and source text are not
+retained in the parent. Tokenized source documents are loaded only for source
+evidence requests such as `inspect`, and a byte-bounded LRU evicts older
+documents. The transient worker memory remains separate from retained navigation
+structures and the existing 80-percent warning. Retained bytes are maintained
+incrementally; requests never traverse the complete cache object graph merely
+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.
+
+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
+OpenCode searches remain warm.
+
+`cache start` waits up to `--startup-timeout 120` seconds by default for a large
+workspace to prewarm. The timeout belongs to the starting client and does not
+change daemon compatibility or idle shutdown. Starting a live root with a
+different worker configuration reports a configuration conflict.
+
 Eviction is ordered: auxiliary caches are evicted first, navigation caches second.
 If compaction removes navigable data, the daemon rebuilds the navigation state on demand
 while preserving focus state for the next request.
@@ -240,7 +274,9 @@ while preserving focus state for the next request.
 The daemon tracks a 30-minute idle timeout; idle state shows in JSON status (`cache status`).
 `source revision` changes on source edits and invalidate reused request caches.
 Workspace state appears in status as `requests`, `warm_hits`, `rebuilds`, `invalidations`,
-`evictions`, and `cache_state`.
+`evictions`, and `cache_state`. Parallel prewarm status adds
+`workers_configured`, `workers_effective`, `parallel_files_completed`,
+`prewarm_seconds`, `parallel_seconds`, and `parallel_fallbacks`.
 
 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.0.5 → python_delphi_lsp-2.2.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.0.5 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 2.2.0 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -147,12 +147,15 @@ problems; paths are not guessed.
 
 ```text
 delphi-lsp-agent cache start --root PATH [--project-file FILE] [--max-memory 512M]
+                                  [--workers auto|N] [--startup-timeout 120]
                                   [--idle-timeout 1800]
 delphi-lsp-agent cache status --root PATH [--format text|json]
 delphi-lsp-agent cache stop --root PATH
 delphi-lsp-agent view --root PATH [--project-file FILE] --layer LAYER
                       [--query TEXT] [--format markdown|json] [--deep-projects]
+                      [--workers auto|N]
 delphi-lsp-agent index --root PATH [--project-file FILE] [--out FILE]
+                       [--workers auto|N]
 delphi-lsp-agent query --root PATH ACTION [VALUE]
                       [--project-id FILE] [--detail summary|declaration|members|context|body|implementations]
                       [--relation references|callers|callees|uses|used_by|inherits|implements]
@@ -160,7 +163,7 @@ delphi-lsp-agent query --root PATH ACTION [VALUE]
 delphi-lsp-agent skill install [--target PATH] [--force]
 delphi-lsp-agent opencode install [--target PATH] [--python PYTHON]
                                   [--force] [--write-agent|--write-config]
-delphi-lsp-agent worker --root PATH [--project-file FILE]
+delphi-lsp-agent worker --root PATH [--project-file FILE] [--workers auto|N]
 ```
 
 The `cache` commands manage one daemon per canonical root. Use these:
@@ -194,6 +197,36 @@ fast. The cache retained-cache budget is `512 MiB` by default and tracks retaine
 cache usage only, not a hard RSS/parse peak. Warnings are emitted on stderr at or
 above 80 percent.
 
+Cold builds parse independent source units in short-lived processes created with
+the cross-platform `spawn` method. `--workers auto|N` defaults to `auto`.
+Automatic selection uses at most eight worker processes, leaves one detected CPU
+free, never exceeds the source task count, and—for the cache daemon—allows one
+worker per `64 MiB` of retained-cache budget. `view` and `index` use the same
+task, CPU, and eight-worker caps without the cache-budget term. An explicit value
+from 1 through 32 overrides the automatic CPU and memory caps but is still
+limited by the number of tasks.
+
+Worker processes build compact, detached navigation shards and exit before
+retained-cache accounting. Full semantic object graphs and source text are not
+retained in the parent. Tokenized source documents are loaded only for source
+evidence requests such as `inspect`, and a byte-bounded LRU evicts older
+documents. The transient worker memory remains separate from retained navigation
+structures and the existing 80-percent warning. Retained bytes are maintained
+incrementally; requests never traverse the complete cache object graph merely
+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.
+
+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
+OpenCode searches remain warm.
+
+`cache start` waits up to `--startup-timeout 120` seconds by default for a large
+workspace to prewarm. The timeout belongs to the starting client and does not
+change daemon compatibility or idle shutdown. Starting a live root with a
+different worker configuration reports a configuration conflict.
+
 Eviction is ordered: auxiliary caches are evicted first, navigation caches second.
 If compaction removes navigable data, the daemon rebuilds the navigation state on demand
 while preserving focus state for the next request.
@@ -201,7 +234,9 @@ while preserving focus state for the next request.
 The daemon tracks a 30-minute idle timeout; idle state shows in JSON status (`cache status`).
 `source revision` changes on source edits and invalidate reused request caches.
 Workspace state appears in status as `requests`, `warm_hits`, `rebuilds`, `invalidations`,
-`evictions`, and `cache_state`.
+`evictions`, and `cache_state`. Parallel prewarm status adds
+`workers_configured`, `workers_effective`, `parallel_files_completed`,
+`prewarm_seconds`, `parallel_seconds`, and `parallel_fallbacks`.
 
 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/delphi_lsp/_version.py

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