python-delphi-lsp 3.1.1__tar.gz → 3.1.2__tar.gz

{python_delphi_lsp-3.1.1 → python_delphi_lsp-3.1.2}/MANIFEST.in

@@ -7,6 +7,9 @@ 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/prepare_fpc_corpus.py
+include scripts/benchmark_fpc_corpus.py
+include scripts/prepare_delphi_corpus.py
 include scripts/benchmark_cpg.py
 include scripts/benchmark_parallel_cache.py
 include scripts/bootstrap_vllm_opencode_test.py
@@ -22,5 +25,9 @@ include scripts/start_ornith_vllm.sh
 include scripts/summarize_opencode_request_payloads.py
 include scripts/ollama/ornith-lspctx.Modelfile
 include tests/corpora.performance.lock.json
+include tests/fpc_parse_quality.baseline.json
+include tests/test_fpc_performance_corpus.py
+include tests/test_delphi_performance_corpus.py
+include docs/performance-delphi.md
 recursive-include docs *.md
 recursive-include tests *.py *.pas *.inc *.dpr *.dpk

{python_delphi_lsp-3.1.1/python_delphi_lsp.egg-info → python_delphi_lsp-3.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-delphi-lsp
-Version: 3.1.1
+Version: 3.1.2
 Summary: Python Delphi/Object Pascal parser, semantic indexer, and language server.
 Author: Dark Light
 License-Expression: MPL-2.0
@@ -45,7 +45,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 3.1.1 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 3.1.2 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -521,6 +521,12 @@ source was parsed for CPG. Legacy navigation retained 98.43 percent of its
 in-run control throughput, above the 95-percent release floor. Reproduce it
 with `python scripts/benchmark_cpg.py --root CORPUS --query Run --workers 8`.
 
+Separate reproducible performance profiles cover the coherent FPC compiler
+tree and a project-file-dense Delphi corpus. The Delphi profile can add a
+deterministic `__history`/recovery/build/search-path overlay without changing
+the pinned base corpus. See [the FPC benchmark](docs/performance-fpc.md) and
+[the Delphi discovery benchmark](docs/performance-delphi.md).
+
 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
 chunks are at most 6000 characters and also respect the response budget. This

{python_delphi_lsp-3.1.1 → python_delphi_lsp-3.1.2}/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 3.1.1 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 3.1.2 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -478,6 +478,12 @@ source was parsed for CPG. Legacy navigation retained 98.43 percent of its
 in-run control throughput, above the 95-percent release floor. Reproduce it
 with `python scripts/benchmark_cpg.py --root CORPUS --query Run --workers 8`.
 
+Separate reproducible performance profiles cover the coherent FPC compiler
+tree and a project-file-dense Delphi corpus. The Delphi profile can add a
+deterministic `__history`/recovery/build/search-path overlay without changing
+the pinned base corpus. See [the FPC benchmark](docs/performance-fpc.md) and
+[the Delphi discovery benchmark](docs/performance-delphi.md).
+
 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
 chunks are at most 6000 characters and also respect the response budget. This

python_delphi_lsp-3.1.2/delphi_lsp/_version.py

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

{python_delphi_lsp-3.1.1 → python_delphi_lsp-3.1.2}/delphi_lsp/preprocessor.py

@@ -472,6 +472,12 @@ class Preprocessor:
             self._emit_text(output, active_replacement, ctx.file_name, start_line, active=True)
             return
 
+        if name == 'I' and param.strip() in {'+', '-'}:
+            if self._is_active():
+                self._apply_named_option(name, param)
+            self._emit_text(output, active_replacement, ctx.file_name, start_line, active=True)
+            return
+
         if name in {'I', 'INCLUDE'}:
             if self._is_active():
                 include_name = self._extract_include_name(param)

python_delphi_lsp-3.1.2/docs/performance-delphi.md

@@ -0,0 +1,161 @@
+# Delphi-shaped discovery performance profile
+
+The `delphi` corpus profile complements the coherent FPC compiler benchmark.
+FPC exercises parsing and outline construction well, but contains few Delphi
+project files. This profile preserves the project density that drives search
+path discovery and can optionally add deterministic IDE/build artifacts.
+
+## Corpus preparation
+
+The profile uses the five revisions pinned in
+`tests/corpora.performance.lock.json`: mORMot2, DUnitX, DelphiAST,
+python4delphi, and castle-engine. It deliberately takes the full checkout of
+each pinned repository so project files outside the lock's source subpaths are
+not lost.
+
+```console
+.venv/bin/python scripts/prepare_delphi_corpus.py \
+  --workspace /tmp/delphi-corpus \
+  --fetch
+```
+
+Cached revisions can subsequently be used with `--offline`. A local clean
+checkout at the exact locked revision can be supplied repeatedly as
+`--checkout NAME=PATH`.
+
+The manifest schema records `.pas`, `.inc`, `.dpr`, `.dpk`, `.dproj`, `.lpi`,
+and `.lpr` files. The measured preparation contained 4,055 files and
+2,983,643 physical lines:
+
+| Repository | Files | Lines |
+|---|---:|---:|
+| mORMot2 | 638 | 673,177 |
+| DUnitX | 249 | 65,805 |
+| DelphiAST | 70 | 18,598 |
+| python4delphi | 261 | 98,965 |
+| castle-engine | 2,837 | 2,127,098 |
+
+The extension inventory contained 1,930 `.pas`, 1,053 `.inc`, 384 `.dpr`,
+49 `.dpk`, 373 `.dproj`, 235 `.lpi`, and 31 `.lpr` files. The corpus is
+16,357 lines short of 3 million. Reports therefore say
+`requested_max_reached: false` and record 2,983,643 as the honest available
+and measured maximum; they never label it as a 3M result.
+
+## Clean and realism runs
+
+The default profile is still `fpc`. Select Delphi explicitly:
+
+```console
+.venv/bin/python scripts/benchmark_fpc_corpus.py \
+  --profile delphi \
+  --workspace /tmp/delphi-corpus \
+  --no-worker-sweep \
+  --output /tmp/delphi-clean.json
+
+.venv/bin/python scripts/benchmark_fpc_corpus.py \
+  --profile delphi \
+  --realism \
+  --workspace /tmp/delphi-corpus \
+  --no-worker-sweep \
+  --output /tmp/delphi-realism.json
+```
+
+Default Delphi targets are 100k, 250k, 500k, 1M, 2M, and 3M lines. Targets
+above the available corpus are replaced by the exact maximum. Every slice
+reports the requested and actual line count.
+
+The opt-in realism overlay is off by default. Its defaults are:
+
+- `__history` copies for a stable 30% of `.pas` files, with one to three
+  versions selected from a BLAKE2b hash;
+- `__recovery` copies for a stable 10%;
+- source plus plausible `.dcu` output under `bin`, `obj`, `Win32/Debug`, or
+  `Win64/Release` for a stable 10%;
+- 64 synthetic `.dpr`/`.dproj` pairs, each with 16 unique search paths.
+
+The CLI exposes each parameter as `--realism-*`. Selection never uses Python's
+random state or wall-clock time. All targets are constrained to the temporary
+slice root, copies use hardlinks with a copy fallback, and the report records
+parameters, generated-file count, and a BLAKE2b digest per slice.
+
+The overlay simulates discovery pressure, not a complete RAD Studio
+installation. It does not synthesize BDS/RTL source trees, real DCU contents,
+registry state, ACL failures, symlink loops, or arbitrary corrupt files.
+
+## Measured results, 2026-07-28
+
+Both reports were measured on Darwin arm64, Python 3.14.3, 10 logical CPUs,
+and 32 GiB RAM. Cold and warm are fresh Python processes; no wall-clock number
+is asserted by CI.
+
+| Base lines | Clean cold | Realism cold | Clean sources | Realism sources | Clean paths | Realism paths |
+|---:|---:|---:|---:|---:|---:|---:|
+| 107,263 | 0.752 s | 1.339 s | 383 | 695 | 157 | 1,352 |
+| 251,329 | 1.144 s | 2.159 s | 408 | 738 | 157 | 1,353 |
+| 505,892 | 1.996 s | 3.362 s | 480 | 867 | 162 | 1,374 |
+| 1,009,316 | 3.704 s | 7.328 s | 1,224 | 2,074 | 430 | 1,808 |
+| 2,000,333 | 6.938 s | 12.073 s | 2,959 | 4,299 | 646 | 2,249 |
+| 2,983,643 | 11.113 s | 16.032 s | 3,416 | 5,053 | 692 | 2,366 |
+
+At the largest slice the overlay generated 1,893 files. Every one of the
+1,637 additional source-shaped files was indexed: `sources_visited` equaled
+`sources_indexed`, `sources_skipped` was zero, and the skip-reason histogram
+was empty. That is the intended evidence that the current scanner does not
+exclude `__history`, `__recovery`, `bin`, `obj`, `Win32`, or `Win64`.
+Project entries grew from 433 to 497.
+
+| Largest-slice diagnostic | Clean | Realism |
+|---|---:|---:|
+| Discovery | 1.546 s | 3.230 s |
+| Outline/preprocess/model | 8.677 s | 10.689 s |
+| Semantic assembly | 0.135 s | 0.143 s |
+| Total index diagnostic | 10.361 s | 14.066 s |
+| Sources | 3,416 | 5,053 |
+| Search paths | 692 | 2,366 |
+
+For context, a fresh diagnostic on the post-F39 3,000,891-line FPC slice
+reported 7,364 sources, zero project entries, 332 search paths, 0.641 seconds
+of discovery, and a 10.975-second cold overview. The largest-slice comparison
+is therefore:
+
+| Profile | Base lines | Sources indexed | Projects | Search paths | Discovery | Cold overview |
+|---|---:|---:|---:|---:|---:|---:|
+| FPC | 3,000,891 | 7,364 | 0 | 332 | 0.641 s | 10.975 s |
+| Delphi clean | 2,983,643 | 3,416 | 433 | 692 | 1.546 s | 11.113 s |
+| Delphi realism | 2,983,643 | 5,053 | 497 | 2,366 | 3.230 s | 16.032 s |
+
+Clean discovery cost about 0.452 ms per source; realism cost about
+0.639 ms per source. The cold scaling exponents were 0.819 clean and 0.777
+with realism, both classified as linear by the harness. The earlier
+30.18-CPU-second pathological discovery result was therefore **not
+reproduced**. The overlay still made the known risk measurable: search paths
+grew 3.4×, sources 1.5×, and absolute discovery time 2.1×.
+
+The parser audit intentionally covers the pinned base sources, not generated
+copies. It accepted all 3,416 sources; the role-aware clean ratios were 54.126%
+for units/projects and 95.916% for include fragments.
+
+## CI and next optimizations
+
+Fast tests use temporary fixtures only. The real smallest-slice probe is
+opt-in:
+
+```console
+DELPHI_LSP_DELPHI_CORPUS=/tmp/delphi-corpus \
+  .venv/bin/python -m pytest -q -m perf \
+  tests/test_delphi_performance_corpus.py
+```
+
+The benchmark intentionally leaves these measured product changes for the
+next release:
+
+1. derive overview `unit_count` directly from discovery/model inventory
+   (`delphi_lsp/agent_layers.py:327`);
+2. replace the linear `next(...casefold())` lookup after every resolved path
+   with a keyed lookup (`delphi_lsp/project_discovery.py:849-854`);
+3. decide and implement Delphi-specific exclusions for `__history`,
+   `__recovery`, `bin`, `obj`, `Win32`, `Win64`, `Debug`, `Release`, and `.vs`
+   (`delphi_lsp/project_discovery.py:22-37`).
+
+Those changes are deliberately absent from these measurements so a follow-up
+can compare against the clean and realism reports above.

python_delphi_lsp-3.1.2/docs/performance-fpc.md

@@ -0,0 +1,239 @@
+# FPC overview performance benchmark
+
+This benchmark answers one product question:
+
+> On an Intel Core i5 laptop with 16 GB RAM and Windows 11, can
+> `delphi-lsp-agent view --layer overview` process a repository with
+> 3,000,000 physical Object Pascal lines within 60 seconds?
+
+The corpus is the coherent Free Pascal compiler source tree pinned in
+`tests/corpora.performance.lock.json`. Corpus files and reports stay outside
+the repository and are never included in a distribution.
+
+## Prepare the corpus
+
+```console
+.venv/bin/python scripts/prepare_fpc_corpus.py \
+  --target-lines 3000000 \
+  --workspace /tmp/fpc-3m \
+  --fetch
+```
+
+Preparation clones or reuses the exact locked revision, selects anchors
+followed by a deterministic path-sorted prefix of `.pas` and `.inc` files,
+hard-links or copies those files into the external workspace, and verifies
+every line count and SHA-256 before writing `corpus-manifest.json`. An existing
+non-empty workspace is never cleared implicitly.
+
+Use `--offline` after the revision is cached. An existing clean checkout at
+the locked revision can be supplied with `--checkout PATH`.
+
+## Run the benchmark
+
+```console
+.venv/bin/python scripts/benchmark_fpc_corpus.py \
+  --profile fpc \
+  --workspace /tmp/fpc-3m \
+  --sizes 250000,500000,1000000,2000000,3000000 \
+  --workers 0,1,2,4 \
+  --output /tmp/fpc-report.json
+```
+
+`fpc` is the default profile, so existing invocations may omit
+`--profile fpc`. The project-file-dense companion profile is documented in
+`docs/performance-delphi.md`.
+
+The default run performs:
+
+- cold and warm overview calls in separate Python processes;
+- five deterministic scaling slices and a log-log scaling fit;
+- a 1M-line worker sweep;
+- import-floor and phase diagnostics;
+- a full recovery-oriented DelphiAST compatibility audit.
+
+`--skip-warm`, `--no-parse-audit`, `--no-worker-sweep`, and
+`--no-phase-breakdown` shorten exploratory runs. `--report-only` writes all
+failures but exits successfully. The release budgets are configurable with
+`--budget-cold`, `--budget-warm`, `--budget-rss-gib`,
+`--min-parse-ratio`, `--max-scaling-exponent`,
+`--max-clean-ratio-regression`, `--max-problem-count-regression`, and
+`--new-problem-threshold`.
+
+The parser-quality gate compares the run with
+`tests/fpc_parse_quality.baseline.json`. Regenerate that file deliberately
+only after a passing run:
+
+```console
+.venv/bin/python scripts/benchmark_fpc_corpus.py \
+  --workspace /tmp/fpc-3m \
+  --output /tmp/fpc-report.json \
+  --update-baseline
+```
+
+`--update-baseline` refuses to write when any non-quality release gate fails
+or when the parser audit is disabled. This prevents accepting a slow, crashing,
+or pathologically scaling run merely by replacing its baseline.
+
+The opt-in pytest integration probe uses the smallest slice:
+
+```console
+DELPHI_LSP_FPC_CORPUS=/tmp/fpc-3m \
+  .venv/bin/python -m pytest -q -m perf \
+  tests/test_fpc_performance_corpus.py
+```
+
+Normal pytest runs exclude the `perf` marker and require neither network nor
+an external corpus.
+
+## Budgets and interpretation
+
+| Gate | Default | Meaning |
+|---|---:|---|
+| 3M cold overview | 60.0 s | Primary product question |
+| 3M warm overview | 5.0 s | Second invocation in a fresh process |
+| Peak RSS | 11 GiB | Leaves room on a 16 GB Windows/editor machine |
+| Parse acceptance ratio | 0.95 | Parser returned, cleanly or through recovery |
+| Clean ratio regression | 0.01 absolute | Per-role drop from the committed baseline |
+| Known problem growth | 5% relative | Per-description increase from baseline |
+| New problem threshold | 50 | Previously unseen description count |
+| Scaling exponent | 1.15 | Rejects growth that extrapolates poorly |
+
+Cold means the exact slice-local `.delphi-lsp` directory is removed and its
+absence verified. Warm means a second fresh process without another removal.
+The current `view` path does not write a persistent navigation cache, so its
+warm result benefits only from the operating system's filesystem cache.
+
+The overview command performs project/source discovery, source reads,
+conditional outline processing, outline semantic-model construction, unit
+scope registration, and overview payload construction. It does not full-parse
+units or traverse complete reference relations. The full parser audit is
+therefore measured and reported separately. It selects recovery-oriented
+DelphiAST tolerant mode so every recoverable FPC problem remains countable;
+the report states that mode and that the small-file Lark fallback is disabled
+for this audit.
+
+The report distinguishes three ratios:
+
+- `accepted_ratio` is unchanged: it counts files for which parsing did not
+  raise. It remains the 0.95 crash floor.
+- `clean_parse_ratio_units` counts complete units, programs, libraries, and
+  packages with zero reported problems.
+- `clean_parse_ratio_includes` counts fragments with zero applicable problems.
+  It excludes only
+  `Expected unit, program, library, or package header`, because a fragment is
+  not a standalone compilation unit. The report records this exact rule and
+  rationale in `clean_ratio_exclusions`; no other problem is silently dropped.
+
+`parse_success_ratio` remains a deprecated alias of `accepted_ratio` for one
+report-schema release. `metric_definitions` identifies the alias explicitly.
+
+Role detection is source-shaped rather than extension-only. After leading
+whitespace, comments, and compiler directives are skipped, a first token of
+`unit`, `program`, `library`, or `package` makes the file a unit. This catches
+complete `.inc` files. Headerless `.pas` files are fragments, while `.dpr` and
+`.dpk` retain unit status if preprocessing hides their header. In the measured
+FPC slice this classified 3,682 files in each role, including 27 complete
+`.inc` units and 53 `.pas` fragments.
+
+## Measured result, 2026-07-28
+
+The report was produced at
+`/tmp/python-delphi-lsp-fpc-report.json` from FPC revision
+`a8e7ad4e2f2f6d3bdc240850075d85e659a42ff8` on Darwin arm64, Python
+3.14.3, 10 logical CPUs, and 32 GiB RAM. These are not target-hardware
+measurements.
+
+| Requested slice | Files | Physical lines | Cold | Warm | Peak RSS | Accepted |
+|---:|---:|---:|---:|---:|---:|---:|
+| 250k | 268 | 290,162 | 1.074 s | 1.121 s | 64.2 MiB | 100% |
+| 500k | 584 | 500,068 | 1.816 s | 1.787 s | 95.7 MiB | 100% |
+| 1M | 2,505 | 1,000,095 | 4.610 s | 4.140 s | 187.6 MiB | 100% |
+| 2M | 6,007 | 2,000,205 | 9.015 s | 8.818 s | 422.7 MiB | 100% |
+| 3M | 7,364 | 3,000,891 | 13.608 s | 12.819 s | 538.3 MiB | 100% |
+
+The cold scaling exponent was **1.1054**, classified as **n_log_n**
+(`R² = 0.9966`). This passes the 1.15 scaling gate. The run's overall status
+was **fail** because the 3M fresh-process warm result exceeded its budget. The
+measured cold 60-second target, RSS, parse-ratio, and scaling gates passed.
+Cold throughput declined from 270,231 lines/s on the smallest slice to
+220,529 lines/s at 3M; exact cold and warm throughput is present on every
+slice in the JSON report.
+
+After the IOChecks-directive correction, a fresh 3M parser audit processed
+3,000,891 physical and 4,957,004 post-preprocessing lines. All 7,364 files
+returned a recoverable result. The raw problem-free count rose from 1,171 to
+1,208, and files carrying problems fell from 6,193 to 6,156. Unresolved
+include problems fell from 2,533 to 2,261; all 228
+`include not found: -` and 44 `include not found: +` reports disappeared.
+Syntax recoveries remained 20,686.
+
+The post-fix role-aware clean ratios committed in the baseline are:
+
+| Role | Clean | Total | Clean ratio |
+|---|---:|---:|---:|
+| Units/projects | 1,192 | 3,682 | 32.374% |
+| Include fragments | 3,364 | 3,682 | 91.363% |
+
+The include ratio applies the one documented structural exclusion above. The
+committed baseline also contains every problem-description count, not only a
+top-ten summary, so a frequent new recovery mode is gated even when the crash
+ratio stays at 100%.
+
+## Largest-slice phase profile
+
+| Phase | Seconds |
+|---|---:|
+| Discovery | 1.497 |
+| Read-only source probe | 0.619 |
+| Conditional outline, parse, and model construction | 15.785 |
+| Semantic index assembly | 0.199 |
+| Full relation traversal | not used |
+| Overview payload | 0.000009 |
+| Total index diagnostic | 17.491 |
+
+Outline workers combine reads, conditional preprocessing, outline parsing,
+and model construction, so the read number is a separate diagnostic pass and
+is not subtracted from the measured outline time.
+
+## Worker sweep at 1M lines
+
+| Workers | Cold | Speedup vs. one worker | Peak RSS |
+|---:|---:|---:|---:|
+| default/0 | 6.707 s | 2.261× | 186.7 MiB |
+| 1 | 15.165 s | 1.000× | 221.1 MiB |
+| 2 | 9.206 s | 1.647× | 185.3 MiB |
+| 4 | 9.350 s | 1.622× | 188.2 MiB |
+
+The automatic/default worker count was fastest on the measured machine.
+Windows uses spawned workers too, but the optimum must be measured on the
+target laptop.
+
+## Verdict and findings
+
+On the measured machine the answer is **yes**: the 3M cold overview completed
+in 13.608 seconds. Applying the explicitly assumed, unverified 4× slowdown
+projects 54.431 seconds on the Windows i5 target, within the 60-second budget.
+That projection is not a Windows measurement, so the target-hardware question
+remains projected rather than proven.
+
+Important findings:
+
+- `view` creates no persistent `.delphi-lsp` cache
+  (`delphi_lsp/agent_cli.py:313-321`), so the second fresh-process invocation
+  still rebuilds the whole outline and misses the 5-second warm budget.
+- Outline/preprocessing/model work dominates the largest slice
+  (`delphi_lsp/agent_layers.py:76-127`); overview payload construction is
+  negligible.
+- Discovery indexed all 7,364 manifest source files and skipped none. `.pp`
+  files are excluded because the product task filter accepts `.pas`, `.inc`,
+  `.dpr`, and `.dpk` (`delphi_lsp/agent_layers.py:76-81`).
+- Recovery parsing exposes broad FPC-dialect incompatibility despite a 100%
+  recoverable-result ratio: 84.1% of files report at least one problem
+  (`delphi_lsp/parser.py:88-127`).
+- The strict small-file Lark branch
+  (`delphi_lsp/parser.py:99-108`) is not the overview path and proved
+  unsuitable for a bounded full-corpus compatibility audit; the report uses
+  and labels DelphiAST tolerant mode instead.
+- The parent-process RSS measurement reuses the existing Windows PSAPI
+  implementation but cannot aggregate spawned-worker RSS
+  (`delphi_lsp/parallel_outline.py:123-181`).

python_delphi_lsp-3.1.2/docs/release-3.1.2.md

@@ -0,0 +1,39 @@
+# Python Delphi LSP 3.1.2
+
+Version 3.1.2 is a parser-correctness and benchmark-quality release.
+
+## Preprocessor correctness
+
+- Delphi compiler switches such as `{$I-}` and `{$I+}` are no longer
+  interpreted as include directives.
+- The adversarial FPC corpus check reduced phantom include problems from 272
+  to zero.
+
+## Honest parse-quality metrics
+
+- The existing accepted-unit ratio remains available for continuity.
+- `clean_parse_ratio_units` and `clean_parse_ratio_includes` now expose how
+  much source parsed without recovered errors.
+- Benchmark gates can compare those clean ratios with a pinned baseline and
+  fail on regressions.
+
+## Reproducible performance profiles
+
+- A Delphi corpus profile pins five public repositories and records project
+  files deterministically.
+- A deterministic realism overlay exercises malformed and deeply nested
+  Delphi input without changing the checked-out upstream sources.
+- This release improves the benchmark harness and reporting; it does not claim
+  a product-speedup from those measurement changes.
+
+## Verification
+
+- Full unit and integration suite
+- Opt-in FPC and Delphi corpus performance tests
+- Wheel and source-distribution metadata checks
+
+Install or upgrade with:
+
+```bash
+python -m pip install --upgrade python-delphi-lsp==3.1.2
+```

{python_delphi_lsp-3.1.1 → python_delphi_lsp-3.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-delphi-lsp"
-version = "3.1.1"
+version = "3.1.2"
 description = "Python Delphi/Object Pascal parser, semantic indexer, and language server."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -68,4 +68,7 @@ delphi_lsp = ["py.typed"]
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 pythonpath = ["."]
-addopts = "--timeout=120 --timeout-method=thread"
+addopts = "--timeout=120 --timeout-method=thread -m 'not perf'"
+markers = [
+  "perf: opt-in benchmarks that require an externally prepared real-world corpus",
+]

{python_delphi_lsp-3.1.1 → python_delphi_lsp-3.1.2/python_delphi_lsp.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-delphi-lsp
-Version: 3.1.1
+Version: 3.1.2
 Summary: Python Delphi/Object Pascal parser, semantic indexer, and language server.
 Author: Dark Light
 License-Expression: MPL-2.0
@@ -45,7 +45,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 3.1.1 is authored by Dark Light and supports Windows, macOS, and Linux.
+Version 3.1.2 is authored by Dark Light and supports Windows, macOS, and Linux.
 
 ## Install and quick start
 
@@ -521,6 +521,12 @@ source was parsed for CPG. Legacy navigation retained 98.43 percent of its
 in-run control throughput, above the 95-percent release floor. Reproduce it
 with `python scripts/benchmark_cpg.py --root CORPUS --query Run --workers 8`.
 
+Separate reproducible performance profiles cover the coherent FPC compiler
+tree and a project-file-dense Delphi corpus. The Delphi profile can add a
+deterministic `__history`/recovery/build/search-path overlay without changing
+the pinned base corpus. See [the FPC benchmark](docs/performance-fpc.md) and
+[the Delphi discovery benchmark](docs/performance-delphi.md).
+
 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
 chunks are at most 6000 characters and also respect the response budget. This

{python_delphi_lsp-3.1.1 → python_delphi_lsp-3.1.2}/python_delphi_lsp.egg-info/SOURCES.txt

@@ -45,11 +45,14 @@ delphi_lsp/semantic_builder.py
 delphi_lsp/source_reader.py
 delphi_lsp/workspace.py
 delphi_lsp/writer.py
+docs/performance-delphi.md
+docs/performance-fpc.md
 docs/release-2.3.0.md
 docs/release-2.3.3.md
 docs/release-3.0.0.md
 docs/release-3.1.0.md
 docs/release-3.1.1.md
+docs/release-3.1.2.md
 docs/superpowers/plans/2026-07-16-architecture-metrics-implementation.md
 docs/superpowers/plans/2026-07-17-large-codebase-performance.md
 docs/superpowers/plans/2026-07-22-conditional-outline-ranges.md
@@ -82,6 +85,7 @@ python_delphi_lsp.egg-info/requires.txt
 python_delphi_lsp.egg-info/top_level.txt
 scripts/audit_delphi_language_features.py
 scripts/benchmark_cpg.py
+scripts/benchmark_fpc_corpus.py
 scripts/benchmark_github_corpus.py
 scripts/benchmark_parallel_cache.py
 scripts/bootstrap_vllm_codebase_skill_test.py
@@ -92,6 +96,8 @@ scripts/build_github_performance_corpus.py
 scripts/check_ornith_cache.py
 scripts/generate_progress_pdf.py
 scripts/generate_release_evidence.py
+scripts/prepare_delphi_corpus.py
+scripts/prepare_fpc_corpus.py
 scripts/prepare_ornith_cache.py
 scripts/run_opencode_lsp_probe.py
 scripts/run_openrouter_github_e2e.py
@@ -99,6 +105,7 @@ scripts/start_ornith_vllm.sh
 scripts/summarize_opencode_request_payloads.py
 scripts/ollama/ornith-lspctx.Modelfile
 tests/corpora.performance.lock.json
+tests/fpc_parse_quality.baseline.json
 tests/test_agent_cache.py
 tests/test_agent_cli_errors.py
 tests/test_agent_codebase.py
@@ -112,11 +119,13 @@ tests/test_agent_worker.py
 tests/test_agent_workspace.py
 tests/test_bootstrap_vllm_codebase_skill.py
 tests/test_bootstrap_vllm_opencode.py
+tests/test_delphi_performance_corpus.py
 tests/test_delphiast_lexer.py
 tests/test_delphiast_native_compatibility.py
 tests/test_delphiast_parser.py
 tests/test_delphiast_semantic_compatibility.py
 tests/test_diagnostics.py
+tests/test_fpc_performance_corpus.py
 tests/test_github_performance_corpus.py
 tests/test_language_feature_matrix.py
 tests/test_legacy_snippets.py