python-delphi-lsp 2.0.4__tar.gz → 2.1.0__tar.gz

{python_delphi_lsp-2.0.4 → python_delphi_lsp-2.1.0}/.github/workflows/ci.yml

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

{python_delphi_lsp-2.0.4 → python_delphi_lsp-2.1.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.4/python_delphi_lsp.egg-info → python_delphi_lsp-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-delphi-lsp
-Version: 2.0.4
+Version: 2.1.0
 Summary: Python Delphi/Object Pascal parser, semantic indexer, and language server.
 Author: Dark Light
 License-Expression: MPL-2.0
@@ -41,7 +41,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.4 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 2.1.0 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -185,15 +185,93 @@ problems; paths are not guessed.
 `delphi-lsp-agent` has these subcommands and options:
 
 ```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]
+                      [--cursor TEXT] [--max-items INT] [--max-chars INT]
 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:
+
+```bash
+delphi-lsp-agent cache start --root PATH
+delphi-lsp-agent cache status --root PATH
+delphi-lsp-agent cache stop --root PATH
+```
+
+`cache start` outputs cache lifecycle JSON; runtime warnings are still on stderr.
+`cache status --format json` outputs status JSON to stdout and the same warning stream on stderr.
+`cache stop` outputs stop status JSON and may include warnings on stderr.
+`query` outputs Protocol v2 JSON responses and writes warnings to stderr.
+
+```bash
+delphi-lsp-agent query --root PATH find TCustomer
+delphi-lsp-agent query --root PATH focus TARGET_ID
+delphi-lsp-agent query --root PATH inspect
+delphi-lsp-agent query --root PATH trace TARGET_ID --relation callers
+delphi-lsp-agent query --root PATH metrics
+delphi-lsp-agent query --root PATH metrics UNIT_QUERY
+delphi-lsp-agent cache status --root PATH --format json
+```
+
+`inspect` uses the currently focused target, so call `focus TARGET_ID` before
+`inspect` unless a previous request already selected it.
+
+The cache daemon prewarms the navigation cache at startup so first `find` requests are
+fast. The cache retained-cache budget is `512 MiB` by default and tracks retained
+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 four worker processes, leaves one detected CPU
+free, never exceeds the source task count, and—for the cache daemon—allows one
+worker per `128 MiB` of retained-cache budget. `view` and `index` use the same
+task, CPU, and four-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 exit before retained-cache accounting. Their models and source
+text are streamed into the parent, so transient worker memory is separate from
+the retained navigation structures and the existing 80-percent warning. 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 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.
+
+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`. 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
+outside the root workspace.
+
 `view --layer` accepts `overview`, `projects`, `units`, `unit`,
 `symbols`, `symbol`, `implementation`, `references`, `problems`, and
 `metrics`. For example, `delphi-lsp-agent view --layer metrics --format json`
@@ -227,7 +305,7 @@ Focus preserves the selected project, unit, or target. Cursors bind a workspace
 revision and request fingerprint, so source changes and cross-target or
 cross-detail reuse invalidate them. `max_items` and `max_chars` bound each
 response. A `sound_partial` relation is sound but incomplete: unresolved and
-ambiguous relations are never fabricated.
+ambiguous relations are never fabricated. Unsupported relations are rejected.
 
 For every source size the navigator builds an outline first, loads source detail
 lazily for a selected target, and returns only selected fragments. Typed source
@@ -262,6 +340,11 @@ The plugin maintains one worker per session/root, reusing focus and indexes.
 During compaction it restores the focus and summary into the new context.
 Transport failure, session deletion, and plugin disposal clean up the worker.
 
+OpenCode history: 1.1.0 and 1.1.1 used a spawned view per call model.
+Persistent session/root worker support first shipped in 2.0.0.
+This is the same persistent session/root worker boundary.
+The OpenCode worker stays separate from CLI daemon, and current plugin behavior is unchanged.
+
 A generated OpenCode agent starts with this Markdown frontmatter:
 
 ```markdown

{python_delphi_lsp-2.0.4 → python_delphi_lsp-2.1.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.4 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 2.1.0 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -146,15 +146,93 @@ problems; paths are not guessed.
 `delphi-lsp-agent` has these subcommands and options:
 
 ```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]
+                      [--cursor TEXT] [--max-items INT] [--max-chars INT]
 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:
+
+```bash
+delphi-lsp-agent cache start --root PATH
+delphi-lsp-agent cache status --root PATH
+delphi-lsp-agent cache stop --root PATH
+```
+
+`cache start` outputs cache lifecycle JSON; runtime warnings are still on stderr.
+`cache status --format json` outputs status JSON to stdout and the same warning stream on stderr.
+`cache stop` outputs stop status JSON and may include warnings on stderr.
+`query` outputs Protocol v2 JSON responses and writes warnings to stderr.
+
+```bash
+delphi-lsp-agent query --root PATH find TCustomer
+delphi-lsp-agent query --root PATH focus TARGET_ID
+delphi-lsp-agent query --root PATH inspect
+delphi-lsp-agent query --root PATH trace TARGET_ID --relation callers
+delphi-lsp-agent query --root PATH metrics
+delphi-lsp-agent query --root PATH metrics UNIT_QUERY
+delphi-lsp-agent cache status --root PATH --format json
+```
+
+`inspect` uses the currently focused target, so call `focus TARGET_ID` before
+`inspect` unless a previous request already selected it.
+
+The cache daemon prewarms the navigation cache at startup so first `find` requests are
+fast. The cache retained-cache budget is `512 MiB` by default and tracks retained
+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 four worker processes, leaves one detected CPU
+free, never exceeds the source task count, and—for the cache daemon—allows one
+worker per `128 MiB` of retained-cache budget. `view` and `index` use the same
+task, CPU, and four-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 exit before retained-cache accounting. Their models and source
+text are streamed into the parent, so transient worker memory is separate from
+the retained navigation structures and the existing 80-percent warning. 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 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.
+
+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`. 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
+outside the root workspace.
+
 `view --layer` accepts `overview`, `projects`, `units`, `unit`,
 `symbols`, `symbol`, `implementation`, `references`, `problems`, and
 `metrics`. For example, `delphi-lsp-agent view --layer metrics --format json`
@@ -188,7 +266,7 @@ Focus preserves the selected project, unit, or target. Cursors bind a workspace
 revision and request fingerprint, so source changes and cross-target or
 cross-detail reuse invalidate them. `max_items` and `max_chars` bound each
 response. A `sound_partial` relation is sound but incomplete: unresolved and
-ambiguous relations are never fabricated.
+ambiguous relations are never fabricated. Unsupported relations are rejected.
 
 For every source size the navigator builds an outline first, loads source detail
 lazily for a selected target, and returns only selected fragments. Typed source
@@ -223,6 +301,11 @@ The plugin maintains one worker per session/root, reusing focus and indexes.
 During compaction it restores the focus and summary into the new context.
 Transport failure, session deletion, and plugin disposal clean up the worker.
 
+OpenCode history: 1.1.0 and 1.1.1 used a spawned view per call model.
+Persistent session/root worker support first shipped in 2.0.0.
+This is the same persistent session/root worker boundary.
+The OpenCode worker stays separate from CLI daemon, and current plugin behavior is unchanged.
+
 A generated OpenCode agent starts with this Markdown frontmatter:
 
 ```markdown

python_delphi_lsp-2.1.0/delphi_lsp/_version.py

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