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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-delphi-lsp
-Version: 2.0.3
+Version: 2.0.5
 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.3 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 2.0.5 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -82,6 +82,19 @@ project = ProjectIndexer(
 print(project.parsed_units)
 ```
 
+Long-running discovery and indexing accept a keyword-only `on_progress`
+callback. It receives an immutable `ProgressEvent` with package-controlled
+phase, path, and monotonic counters; callback exceptions are not suppressed.
+
+```python
+from delphi_lsp import ProjectIndexer, ProgressEvent
+
+def report(event: ProgressEvent) -> None:
+    print(event.phase, event.files_completed, event.path)
+
+ProjectIndexer(on_progress=report).index("Main.dpr")
+```
+
 ## Architecture metrics
 
 The public metrics API analyzes a single unit or aggregates a complete project:
@@ -172,15 +185,67 @@ 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]
+                                  [--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]
 delphi-lsp-agent index --root PATH [--project-file FILE] [--out FILE]
+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]
 ```
 
+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.
+
+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`.
+
+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`
@@ -214,7 +279,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
@@ -249,6 +314,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.3 → python_delphi_lsp-2.0.5}/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.3 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 2.0.5 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -43,6 +43,19 @@ project = ProjectIndexer(
 print(project.parsed_units)
 ```
 
+Long-running discovery and indexing accept a keyword-only `on_progress`
+callback. It receives an immutable `ProgressEvent` with package-controlled
+phase, path, and monotonic counters; callback exceptions are not suppressed.
+
+```python
+from delphi_lsp import ProjectIndexer, ProgressEvent
+
+def report(event: ProgressEvent) -> None:
+    print(event.phase, event.files_completed, event.path)
+
+ProjectIndexer(on_progress=report).index("Main.dpr")
+```
+
 ## Architecture metrics
 
 The public metrics API analyzes a single unit or aggregates a complete project:
@@ -133,15 +146,67 @@ 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]
+                                  [--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]
 delphi-lsp-agent index --root PATH [--project-file FILE] [--out FILE]
+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]
 ```
 
+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.
+
+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`.
+
+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`
@@ -175,7 +240,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
@@ -210,6 +275,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.3 → python_delphi_lsp-2.0.5}/delphi_lsp/__init__.py

@@ -48,6 +48,7 @@ from .semantic_builder import SemanticBuilder, SemanticModel, SemanticProblem
 from .workspace import WorkspaceSemanticResult, build_workspace_semantics
 from .lsp_server import LspWorkspaceState, create_server
 from .project_discovery import DelphiProjectDiscovery, DiscoveryProblem, discover_delphi_project
+from .progress import ProgressCallback, ProgressEvent
 from .project_indexer import (
     GetUnitSyntaxHook,
     IncludeFileInfo,
@@ -136,6 +137,8 @@ __all__ = [
     'DelphiProjectDiscovery',
     'DiscoveryProblem',
     'discover_delphi_project',
+    'ProgressCallback',
+    'ProgressEvent',
     'ProjectIndexer',
     'ProjectIndexResult',
     'ProjectProblemType',

python_delphi_lsp-2.0.5/delphi_lsp/_version.py

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