qplotter 1.6.0__tar.gz → 1.6.1__tar.gz

{qplotter-1.6.0 → qplotter-1.6.1}/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 All notable user-facing changes are recorded here.
 
+## 1.6.1
+
+This patch release improves live acquisition viewing and release validation.
+
+### Fixed
+
+- Restore Auto-plot in trusted live mode. Newly detected runs open automatically,
+  and enabling Auto-plot opens the newest incomplete run. Requests survive
+  selection changes and refreshes, retry while run metadata becomes available,
+  and cancel when Auto-plot is disabled, the database changes, or qPlot closes.
+- Reduce unnecessary WAL coordination overhead that could cause deferred QCoDeS
+  writes to fail with `SQLITE_BUSY` during live viewing. Existing database
+  protections remain enforced.
+- Display the main window title as `qPlot - <version>` without a duplicated
+  application-name suffix.
+- Correct editable-install validation for source checkouts without generated
+  build metadata.
+
+### Maintenance
+
+- Release the native-reader fix as `qplotter-native==1.0.1`, installed
+  automatically by the application's updated dependency pin.
+- Add a workflow to revalidate published releases against their original
+  artifacts, retaining each release's original native dependency pin.
+- Update live-reader, Auto-plot, and release-validation documentation and add
+  README badges.
+
 ## 1.6.0
 
 ### Highlights ###

{qplotter-1.6.0 → qplotter-1.6.1}/CONTRIBUTING.md

@@ -52,7 +52,7 @@ Linux is exercised in headless CI; Windows and macOS are supported desktop
 platforms. See the [platform matrix](docs/distribution.md#supported-platforms).
 
 The root distribution `qplotter` is pure Python. Install the compatible
-`qplotter-native==1.0.0` platform wheel with the application in editable
+`qplotter-native==1.0.1` platform wheel with the application in editable
 mode. After the native release is on PyPI, no separate download is needed:
 
 ```console

{qplotter-1.6.0 → qplotter-1.6.1}/MANIFEST.in

@@ -27,6 +27,7 @@ prune src/qplotter.egg-info
 
 global-exclude .DS_Store
 global-exclude *.py[cod]
+global-exclude *.py[cod].*
 global-exclude *.dll
 global-exclude *.dylib
 global-exclude *.pyd

{qplotter-1.6.0 → qplotter-1.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qplotter
-Version: 1.6.0
+Version: 1.6.1
 Summary: PyQt-based viewer for completed and running QCoDeS database experiments
 Author-email: Ben Wordsworth <b.wordsworth@lancaster.ac.uk>, Edward Laird <e.a.laird@lancaster.ac.uk>
 License-Expression: MIT
@@ -24,7 +24,7 @@ Classifier: Topic :: Scientific/Engineering :: Visualization
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: qplotter-native==1.0.0
+Requires-Dist: qplotter-native==1.0.1
 Requires-Dist: apsw==3.53.4.0
 Requires-Dist: jsonschema>=4.23.0
 Requires-Dist: numpy>=2.3.1
@@ -46,6 +46,11 @@ Dynamic: license-file
 # QCoDeS-Plotter
 
 [![release](https://img.shields.io/github/v/release/lairdgrouplancaster/QCoDeS-Plotter?label=release)](https://github.com/lairdgrouplancaster/QCoDeS-Plotter/releases/latest)
+[![CI](https://github.com/lairdgrouplancaster/QCoDeS-Plotter/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/lairdgrouplancaster/QCoDeS-Plotter/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/lairdgrouplancaster/QCoDeS-Plotter)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.11–3.14-blue?logo=python)](#requirements)
+[![PyPI](https://img.shields.io/pypi/v/qplotter)](https://pypi.org/project/qplotter/)
+
 [![pre-release](https://img.shields.io/github/v/release/lairdgrouplancaster/QCoDeS-Plotter?include_prereleases&label=pre-release&sort=semver)](https://github.com/lairdgrouplancaster/QCoDeS-Plotter/releases)
 
 QCoDeS-Plotter, or qPlot, is a PyQt-based data viewer for QCoDeS databases. It
@@ -129,7 +134,7 @@ Source checkouts also show the commit and
 whether there are local changes. CI-built packages retain their build commit
 and, for pull-request builds, the PR number. Packages installed without build
 provenance still show the release number.
-The separately built `qplotter-native==1.0.0` supplies the protected
+The separately built `qplotter-native==1.0.1` supplies the protected
 SQLite reader through `qplot_native`. The application's exact dependency pin
 installs the compatible native wheel automatically. Both packages pin the same
 APSW/SQLite runtime, preserving trusted live reading and database protections.
@@ -147,7 +152,7 @@ source builds, and release validation.
 ## Install
 
 Install qPlot inside a supported Python virtual environment. This checkout
-prepares the stable application release `1.6.0`, with native `1.0.0`.
+prepares the stable application release `1.6.1`, with native `1.0.1`.
 The installation examples below work after publication; until then, use
 validated local artifacts as described in [Distribution](docs/distribution.md).
 
@@ -178,9 +183,9 @@ For ordinary installation after a stable PyPI release is available:
 python -m pip install --only-binary=:all: qplotter
 ```
 
-To select version 1.6.0 explicitly after publication:
+To select version 1.6.1 explicitly after publication:
 ```console
-python -m pip install --only-binary=:all: qplotter==1.6.0
+python -m pip install --only-binary=:all: qplotter==1.6.1
 ```
 
 Both commands install the full runtime dependency set as wheels, with no C
@@ -202,7 +207,7 @@ installing the new packages:
 
 ```console
 python -m pip uninstall -y qplot qcodes-plotter qcodes-plotter-native qplotter qplotter-native
-python -m pip install --only-binary=:all: qplotter==1.6.0
+python -m pip install --only-binary=:all: qplotter==1.6.1
 python -m pip check
 ```
 

{qplotter-1.6.0 → qplotter-1.6.1}/README.md

@@ -1,6 +1,11 @@
 # QCoDeS-Plotter
 
 [![release](https://img.shields.io/github/v/release/lairdgrouplancaster/QCoDeS-Plotter?label=release)](https://github.com/lairdgrouplancaster/QCoDeS-Plotter/releases/latest)
+[![CI](https://github.com/lairdgrouplancaster/QCoDeS-Plotter/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/lairdgrouplancaster/QCoDeS-Plotter/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/lairdgrouplancaster/QCoDeS-Plotter)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.11–3.14-blue?logo=python)](#requirements)
+[![PyPI](https://img.shields.io/pypi/v/qplotter)](https://pypi.org/project/qplotter/)
+
 [![pre-release](https://img.shields.io/github/v/release/lairdgrouplancaster/QCoDeS-Plotter?include_prereleases&label=pre-release&sort=semver)](https://github.com/lairdgrouplancaster/QCoDeS-Plotter/releases)
 
 QCoDeS-Plotter, or qPlot, is a PyQt-based data viewer for QCoDeS databases. It
@@ -84,7 +89,7 @@ Source checkouts also show the commit and
 whether there are local changes. CI-built packages retain their build commit
 and, for pull-request builds, the PR number. Packages installed without build
 provenance still show the release number.
-The separately built `qplotter-native==1.0.0` supplies the protected
+The separately built `qplotter-native==1.0.1` supplies the protected
 SQLite reader through `qplot_native`. The application's exact dependency pin
 installs the compatible native wheel automatically. Both packages pin the same
 APSW/SQLite runtime, preserving trusted live reading and database protections.
@@ -102,7 +107,7 @@ source builds, and release validation.
 ## Install
 
 Install qPlot inside a supported Python virtual environment. This checkout
-prepares the stable application release `1.6.0`, with native `1.0.0`.
+prepares the stable application release `1.6.1`, with native `1.0.1`.
 The installation examples below work after publication; until then, use
 validated local artifacts as described in [Distribution](docs/distribution.md).
 
@@ -133,9 +138,9 @@ For ordinary installation after a stable PyPI release is available:
 python -m pip install --only-binary=:all: qplotter
 ```
 
-To select version 1.6.0 explicitly after publication:
+To select version 1.6.1 explicitly after publication:
 ```console
-python -m pip install --only-binary=:all: qplotter==1.6.0
+python -m pip install --only-binary=:all: qplotter==1.6.1
 ```
 
 Both commands install the full runtime dependency set as wheels, with no C
@@ -157,7 +162,7 @@ installing the new packages:
 
 ```console
 python -m pip uninstall -y qplot qcodes-plotter qcodes-plotter-native qplotter qplotter-native
-python -m pip install --only-binary=:all: qplotter==1.6.0
+python -m pip install --only-binary=:all: qplotter==1.6.1
 python -m pip check
 ```
 

{qplotter-1.6.0 → qplotter-1.6.1}/docs/architecture.md

@@ -245,8 +245,16 @@ unavailable detail state: ordinary selection starts no selected-detail worker
 and prepares no additional selected-detail snapshot. A trusted detail failure
 also does not trigger an automatic fallback copy. This is a property of the
 selection action, not the whole fallback session: fallback metadata and retained
-preview paths can still create private snapshots. Only explicit plot and CSV
-actions materialise a DataSet.
+preview paths can still create private snapshots. Fallback plot actions
+(including Auto-plot) and CSV actions can materialise a DataSet.
+
+Trusted Auto-plot owns a deduplicated queue independently of selected-detail
+and refresh requests. It submits one bounded plot-metadata request at a time,
+then uses the same asynchronous plot pipeline as manual plotting. Unavailable
+descriptions are operation-local failures that leave the reader session usable.
+Retries use bounded backoff; later run-metadata changes wake exhausted requests.
+Disabling Auto-plot, committing a database switch, closing the database, and
+shutdown cancel the queue. Source identity checks still guard publication.
 
 Stage 5A's `trusted_work_scheduler.py` owns the exact derived priority key
 `(run tier, work kind, stable run index)` without materialising one task per

{qplotter-1.6.0 → qplotter-1.6.1}/docs/distribution.md

@@ -29,15 +29,15 @@ virtual environment with:
 python -m pip install --only-binary=:all: qplotter
 ```
 
-The current development target is the stable application release `1.6.0`,
-with exact native dependency `1.0.0`. Existing candidate tags do not establish
+The current development target is the stable application release `1.6.1`,
+with exact native dependency `1.0.1`. Existing candidate tags do not establish
 that publication succeeded. Preparing a PR does not publish either package.
 
-The prepared stable application release is `1.6.0`, with exact native
-dependency `1.0.0`. Once published, install that release explicitly:
+The prepared stable application release is `1.6.1`, with exact native
+dependency `1.0.1`. Once published, install that release explicitly:
 
 ```console
-python -m pip install --only-binary=:all: qplotter==1.6.0
+python -m pip install --only-binary=:all: qplotter==1.6.1
 ```
 
 The earlier `native-and-app/v1.6.0b2` candidate did not pass its complete hosted
@@ -59,7 +59,7 @@ wheel paths from this revision's validated artifacts together. For example,
 on Windows x64 (replace the application version when appropriate):
 
 ```console
-python -m pip install --only-binary=:all: dist/qplotter_native-1.0.0-cp311-abi3-win_amd64.whl dist/qplotter-1.6.0-py3-none-any.whl
+python -m pip install --only-binary=:all: dist/qplotter_native-1.0.1-cp311-abi3-win_amd64.whl dist/qplotter-1.6.1-py3-none-any.whl
 ```
 
 Use your platform's native filename on macOS/Linux. Never mix artifacts from
@@ -91,7 +91,7 @@ application names before installing the replacement:
 
 ```console
 python -m pip uninstall -y qplot qcodes-plotter qcodes-plotter-native qplotter qplotter-native
-python -m pip install --only-binary=:all: qplotter==1.6.0
+python -m pip install --only-binary=:all: qplotter==1.6.1
 python -m pip check
 python -c "from importlib.metadata import packages_distributions; p = packages_distributions(); assert set(p['qplot']) == {'qplotter'}; assert set(p['qplot_native']) == {'qplotter-native'}"
 ```
@@ -221,7 +221,7 @@ wheels must build the extension from source.
 
 The native wheel contains the `cp311-abi3` extension
 `qplot_native._trusted_vfs_native` and is platform-specific. The application
-wheel is `py3-none-any`. The application requires exactly native version 1.0.0;
+wheel is `py3-none-any`. The application requires exactly native version 1.0.1;
 both distributions pin APSW 3.53.4.0. Keep these dependencies, the validator's
 pins, and the Python/native SQLite 3.53.4 and source-ID checks coordinated.
 The reader also rejects an incompatible native distribution version, SQLite
@@ -399,8 +399,8 @@ application version from `pyproject.toml`:
 
 | Tag | Native handling | PyPI uploads |
 | --- | --- | --- |
-| `native-and-app/v1.6.0` | Build/validate native `1.0.0` at this revision, if unpublished | Native wheels first, then application wheel/sdist |
-| `v1.6.0` | Fetch/validate the application's exact published native pin | Application wheel/sdist only |
+| `native-and-app/v1.6.1` | Build/validate native `1.0.1` at this revision, if unpublished | Native wheels first, then application wheel/sdist |
+| `v1.6.1` | Fetch/validate the application's exact published native pin | Application wheel/sdist only |
 
 The workflow calls the entire CI workflow at the tagged revision. Failure of
 any build, static check, source-distribution suite, database-protection suite,
@@ -432,9 +432,9 @@ After application publication and byte verification, `public-installations`
 runs on all four platforms and every advertised CPython version (3.11–3.14).
 Each entry creates two fresh environments outside the original checkout.
 The ordinary path runs `python -m pip install --only-binary=:all:
-qplotter==1.6.0` against the public PyPI index with all runtime dependencies.
+qplotter==1.6.1` against the public PyPI index with all runtime dependencies.
 The editable path fetches the exact tested commit into a fresh checkout and
-installs `.[dev]` with `qplotter-native==1.0.0` resolved from public PyPI.
+installs `.[dev]` with `qplotter-native==1.0.1` resolved from public PyPI.
 Neither path installs a local release wheel; the validated artifacts are only
 comparison receipts for the pip report and installed-file hashes. All runtime
 and development dependencies must resolve to public wheels. Both paths disable
@@ -444,7 +444,10 @@ protections. Editable acceptance additionally observes a Python edit without
 reinstalling and checks that the native binary's bytes, identity and timestamp
 remain unchanged. Windows uses the standard-user wrapper for both paths.
 Publication is irreversible; failures in these post-publication checks must
-be reported and fixed in a new release, rather than described as acceptance.
+be reported. Changes to published package contents require a new release.
+A defect confined to the validation tools can instead be corrected and the
+existing release rechecked as described below; the failed original run remains
+part of the release record.
 
 ### One-time account configuration
 
@@ -490,12 +493,11 @@ and [pending-publisher instructions](https://docs.pypi.org/trusted-publishers/cr
 
 ### Paired release commands
 
-For 1.6.0, use the paired tag below only if native 1.0.0 still needs
-publication. If that exact native version is already published and validated,
-use the application-only tag `v1.6.0` instead. Never republish native 1.0.0.
+Version 1.6.1 includes native-reader changes, so release native 1.0.1 with
+the paired tag below. Keep the already published native 1.0.0 unchanged.
 
 Complete the account setup and merge the reviewed packaging/release changes
-to `main`. With application `1.6.0` and native `1.0.0`, use the configured
+to `main`. With application `1.6.1` and native `1.0.1`, use the configured
 Git remote/credentials:
 
 ```console
@@ -503,8 +505,8 @@ git fetch origin
 git switch main
 git pull --ff-only origin main
 python scripts/validate_distribution.py --check-clean
-git tag -a native-and-app/v1.6.0 -m "qPlot 1.6.0 with native reader 1.0.0"
-git push origin refs/tags/native-and-app/v1.6.0
+git tag -a native-and-app/v1.6.1 -m "qPlot 1.6.1 with native reader 1.0.1"
+git push origin refs/tags/native-and-app/v1.6.1
 ```
 
 Use the activated project venv for Python; on macOS set
@@ -545,6 +547,35 @@ the application remains blocked. Once the complete native release is verified,
 an application-only tag for the still-unpublished application version can also
 recover a failed paired release after a new validation run.
 
+### Recheck an existing published release
+
+If post-publication acceptance fails because of a validation-tool defect,
+fix and review the tools, then merge them to `main`. Do not move the release
+tag or rerun a successful publication job. In GitHub Actions, select
+**Revalidate published qPlot release**, then **Run workflow**, using branch
+`main`. Supply the original release tag and publication workflow run ID.
+For the 1.6.0 resource-inventory correction these are `v1.6.0` and
+`38429734516`.
+
+This manual workflow uses the corrected tools from `main`, but checks out
+the original release source separately. It checks the native package version
+pinned by that original source while retaining the tools' supported APSW/SQLite
+ABI checks. It downloads the `qplot-release` artifact from the original
+publication run, verifies its tag, commit, run ID,
+and hashes, and checks the published PyPI bytes against those receipts. The
+artifact must still be available; a missing/expired receipt is a failed gate,
+not permission to substitute a new build. The receipts are comparison inputs;
+ordinary and editable dependencies are still installed from public PyPI.
+All four platforms and CPython 3.11-3.14 run both installation paths, including
+GUI startup and the trusted live reader/database-protection smokes. Windows
+runs unprivileged. The workflow has only read permissions and no publishing
+jobs or deployment approvals.
+
+Wait for all 16 matrix jobs to pass before reporting corrected acceptance.
+Link both the original publication run and the new validation run in the
+release notes. If any failure requires an application or native package change,
+use a new package version and the normal release workflow.
+
 ### Local and hosted results
 
 Local tests and actionlint validate release configuration and failure gates.

{qplotter-1.6.0 → qplotter-1.6.1}/docs/trusted-live-reader.md

@@ -265,8 +265,19 @@ proof handles, actual SQLite handles, source pathnames, rollback-journal absence
 and active SHM bindings. Only after that succeeds may page reads reuse pathname
 proofs until operation cleanup. Every page read still validates the retained and
 actual handle identities and their physically read-only permissions, before and
-after delegation. Other callbacks, including SHM mapping/locking, retain their
-full existing checks. Newly opened or promoted WAL handles are fully validated.
+after delegation. SHM mapping and newly opened or promoted WAL handles retain
+their full checks. SHM locks and memory barriers use the binding already proved
+by mapping and operation-boundary validation, without filesystem calls inside
+SQLite's WAL critical sections. Unlocks are forwarded even after a latched
+validation error, allowing SQLite to release its coordination locks on cleanup.
+
+SQLite reads the two WAL-index header copies around `xShmBarrier`. Filesystem
+checks in that callback widen the race with a commit and can force even a
+read-only connection to acquire `WAL_WRITE_LOCK` to retry the header. Checks
+after acquisition or before release then prolong that lock, causing a QCoDeS
+deferred read-to-write upgrade to fail with `SQLITE_BUSY`. The native callbacks
+retain the platform memory fence and real SHM locking, including legitimate
+WAL-index recovery; they neither suppress locks nor bypass them.
 
 Cleanup disables pathname reuse and performs full native validation before any
 materialised result is published, including error, deadline and cancellation
@@ -279,6 +290,11 @@ transaction. Reads outside the explicit finite scope retain per-read path checks
 Native audit counters include `read_path_reused`, `read_validation_ns` and
 `read_io_ns`. The timings separate page-read validation from the delegated OS VFS
 read, not total SQL or IPC time, and never govern safety checks or deadlines.
+`shm_write_lock_attempts`, `shm_write_lock_acquired`, `shm_write_lock_ns` and
+`shm_write_lock_max_ns` expose transient WAL write-lock contention. The durations
+run from successful acquisition return through successful release return; these
+diagnostics do not control locking. A read-only connection can legitimately
+acquire this lock to coordinate the writable WAL index.
 `scripts/profile_trusted_reads.py DATABASE RUN_ID` profiles finite 65,536-row
 intervals through the pinned reader and checks protected-file sizes/timestamps.
 It does not clear OS caches or modify the selected database. Use the actual plot

{qplotter-1.6.0 → qplotter-1.6.1}/docs/user-guide.md

@@ -329,9 +329,14 @@ Common actions:
   on macOS and `Ctrl+Q` on Windows and Linux.
 * The refresh interval controls how often qPlot checks for new runs. Set it to
   `0.0 s` to disable automatic checks.
-* `Auto-plot` retains its existing behavior for snapshot fallback sessions.
-  Trusted live Stage 4 does not materialise an action-owned plot dataset
-  automatically; use an explicit plot action instead.
+* `Auto-plot` opens every newly detected run, including runs already complete,
+  in both trusted live and snapshot fallback sessions. Enabling it also opens
+  the newest incomplete run already listed. Trusted live requests use the
+  asynchronous reader and survive selection changes and subsequent refreshes.
+  An empty plot waits for its first data. Missing descriptions are retried with
+  backoff (eight attempts); after that, a run metadata change wakes the request,
+  or you can open it manually. Disabling Auto-plot, changing databases, or
+  quitting cancels pending automatic requests.
 
 Where a legacy preview is available, its double-click and context-menu actions
 can still request a plot or export. Trusted live sessions do not generate those

{qplotter-1.6.0 → qplotter-1.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qplotter"
-version = "1.6.0"
+version = "1.6.1"
 description = "PyQt-based viewer for completed and running QCoDeS database experiments"
 readme = "README.md"
 authors = [{name="Ben Wordsworth", email="b.wordsworth@lancaster.ac.uk"},{name="Edward Laird", email="e.a.laird@lancaster.ac.uk"}]
@@ -27,7 +27,7 @@ classifiers = [
     "Topic :: Scientific/Engineering :: Visualization",
 ]
 dependencies = [
-    "qplotter-native==1.0.0",
+    "qplotter-native==1.0.1",
     "apsw==3.53.4.0",
     "jsonschema>=4.23.0",
     "numpy>=2.3.1",

qplotter-1.6.1/scripts/revalidate_published_release.py

@@ -0,0 +1,81 @@
+"""Recheck an existing public release with corrected validation tools; never upload."""
+
+from __future__ import annotations
+
+import argparse
+import re
+import subprocess
+import tempfile
+import tomllib
+from pathlib import Path
+
+if __package__:
+    from . import release
+    from . import validate_compiler_free_install as acceptance
+else:
+    import release
+    import validate_compiler_free_install as acceptance
+
+
+def validate_installation(repository: Path, bundle: Path, *, tag: str,
+                          run_id: str, platform: str, mode: str) -> None:
+    """Use the original release's native pin with the corrected validation tools.
+
+    Publishing still requires the current pin. Only this read-only recheck
+    scopes the pin to the tagged source; the current APSW/SQLite ABI checks,
+    receipt identities, public hashes and installed-reader smokes remain intact.
+    """
+    native = tomllib.loads((repository / 'native/pyproject.toml').read_text())['project']
+    current_pin = release.validator.PINNED_NATIVE_VERSION
+    try:
+        release.validator.PINNED_NATIVE_VERSION = native['version']
+        _validate_installation(repository, bundle, tag=tag, run_id=run_id,
+                               platform=platform, mode=mode)
+    finally:
+        release.validator.PINNED_NATIVE_VERSION = current_pin
+
+
+def _validate_installation(repository: Path, bundle: Path, *, tag: str,
+                           run_id: str, platform: str, mode: str) -> None:
+    """Bind original receipts to the tagged source and public package bytes."""
+    repository = repository.resolve()
+    assert mode in ('wheel', 'editable'), mode
+    assert re.fullmatch(r'[1-9][0-9]*', run_id), 'invalid original release run ID'
+    ref = f'refs/tags/{tag}'
+    release.preflight(repository, ref)
+    metadata = release.projects(repository)
+    revision = subprocess.check_output(
+        ['git', '-c', f'safe.directory={repository}', 'rev-parse', 'HEAD'],
+        cwd=repository, text=True,
+    ).strip()
+    identity = dict(revision=revision, ref=ref, run_id=run_id)
+    for package in ('application', 'native'):
+        receipt = release.verify_bundle(bundle / package, **identity)
+        assert receipt['package'] == release.PACKAGES[package], 'wrong receipt package'
+        assert receipt['version'] == metadata[package]['version'], 'wrong receipt version'
+        release.verify_pypi(receipt)
+    with tempfile.TemporaryDirectory(prefix=f'qplot-public-recheck-{mode}-') as name:
+        temporary = Path(name)
+        selected = temporary / 'comparison'
+        release.select_platform(bundle, platform, selected, **identity)
+        artifacts = acceptance.validator.find_artifacts([selected], wheel_only=True)
+        acceptance.accept_installation(repository, artifacts, temporary,
+                                       editable=mode == 'editable', public_pypi=True)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--repository', type=Path, required=True,
+                        help='Clean checkout of the original release tag, not the validation tools')
+    parser.add_argument('--bundle', type=Path, required=True)
+    parser.add_argument('--tag', required=True)
+    parser.add_argument('--run-id', required=True, help='Original publication workflow run ID')
+    parser.add_argument('--platform', required=True, choices=release.PLATFORMS)
+    parser.add_argument('--mode', required=True, choices=('wheel', 'editable'))
+    args = parser.parse_args()
+    validate_installation(args.repository, args.bundle, tag=args.tag,
+                          run_id=args.run_id, platform=args.platform, mode=args.mode)
+
+
+if __name__ == '__main__':
+    main()

{qplotter-1.6.0 → qplotter-1.6.1}/scripts/validate_compiler_free_install.py

@@ -382,6 +382,15 @@ def fresh_checkout(repository: Path, destination: Path) -> Path:
     return destination
 
 
+def smoke_runtime_files(runtime: set[str], *, editable_source: Path | None) -> set[str]:
+    """Keep required resources, allowing unstamped editable Git checkouts."""
+    if editable_source is not None and not (editable_source / 'src/qplot/_build_info.json').is_file():
+        # Release wheels and extracted sdists carry generated provenance.
+        # A fresh Git checkout instead reports provenance from Git at runtime.
+        return runtime - {'qplot/_build_info.json'}
+    return set(runtime)
+
+
 def accept_installation(repository: Path, artifacts: dict[str, Path],
                         temporary: Path, *, editable: bool, public_pypi: bool = False) -> None:
     assert not temporary.resolve().is_relative_to(repository.resolve())
@@ -444,7 +453,8 @@ else:
     if editable:
         prove_editable_edit(python, app, temporary, audit, env)
     start_qplot(environment, temporary, env)
-    validator.smoke_test_installation(repository, app_wheel, native, runtime,
+    smoke_runtime = smoke_runtime_files(runtime, editable_source=app if editable else None)
+    validator.smoke_test_installation(repository, app_wheel, native, smoke_runtime,
                                      temporary, environment, audit_code=audit, env=env)
     validator.run([str(python), '-I', str(native_probe)], cwd=temporary, env=env)
     assert_no_compiler_builds(log, baseline)

{qplotter-1.6.0 → qplotter-1.6.1}/scripts/validate_distribution.py

@@ -50,7 +50,7 @@ NATIVE_EXTENSION_MEMBERS = {
     f"{NATIVE_EXTENSION_STEM}.pyd",
 }
 PINNED_APSW_VERSION = "3.53.4.0"
-PINNED_NATIVE_VERSION = "1.0.0"
+PINNED_NATIVE_VERSION = "1.0.1"
 CONSOLE_SCRIPTS = {
     "qplot": "qplot.__main__:run",
     "qplot-cfg": "qplot.configuration.scripts:scripts",

{qplotter-1.6.0 → qplotter-1.6.1}/src/qplot/__main__.py

@@ -62,7 +62,8 @@ def _configure_application_identity(app):
     """
     app.setApplicationName("qPlot")
     if hasattr(app, "setApplicationDisplayName"):
-        app.setApplicationDisplayName("qPlot")
+        # Window titles already identify qPlot; suppress Qt's automatic suffix.
+        app.setApplicationDisplayName("")
 
 
 def _finalize_confirmed_process_shutdown(

qplotter-1.6.1/src/qplot/_build_info.json

@@ -0,0 +1 @@
+{"version": "1.6.1", "commit": "2ae041507af8edbcd89ddfcb750b0e97917aa98d", "dirty": false, "released": true}

{qplotter-1.6.0 → qplotter-1.6.1}/src/qplot/datahandling/trusted_live.py

@@ -39,7 +39,7 @@ from qplot.datahandling.file_identity import (
 )
 
 TRUSTED_READER_APSW_VERSION = "3.53.4.0"
-TRUSTED_READER_NATIVE_VERSION = "1.0.0"
+TRUSTED_READER_NATIVE_VERSION = "1.0.1"
 TRUSTED_READER_SQLITE_VERSION = "3.53.4"
 TRUSTED_READER_SQLITE_SOURCE_ID = (
     "2026-07-24 19:02:57 "

{qplotter-1.6.0 → qplotter-1.6.1}/src/qplot/datahandling/trusted_plot.py

@@ -1,4 +1,4 @@
-"""Explicit plot data captured through the application's trusted broker.
+"""Plot data captured through the application's trusted broker.
 
 Only a run's result table is staged, never database pages or unrelated runs.
 The private spool lets the existing precision-preserving QCoDeS decoder and
@@ -24,6 +24,14 @@ RECORD_PROGRESS_UNITS = 1_000_000
 MAX_PARAMETERS = 256
 
 
+class PlotMetadataUnavailableError(TrustedLiveQueryError):
+    """Run creation/start has not yet published a usable plot description.
+
+    This is an operation-local data condition, not a fatal reader failure.
+    The broker session must remain usable for other runs and later attempts.
+    """
+
+
 def identifier(name):
     return '"' + str(name).replace('"', '""') + '"'
 
@@ -46,10 +54,17 @@ class TrustedPlotDataset:
         self.service = service
         self.path_to_db = service.database_instance.logical_path
         self.description_json = description
-        self.description = from_json_to_current(description)
-        self._parameters = list(new_to_old(self.description.interdeps).paramspecs)
-        if not 0 < len(self._parameters) <= MAX_PARAMETERS:
-            raise ValueError("Plot parameter count exceeds the supported bound.")
+        if not description:
+            raise PlotMetadataUnavailableError("The run description is not available yet.")
+        try:
+            self.description = from_json_to_current(description)
+            self._parameters = list(new_to_old(self.description.interdeps).paramspecs)
+        except (ValueError, TypeError, KeyError) as error:
+            raise PlotMetadataUnavailableError("The run description is not usable yet.") from error
+        if not self._parameters:
+            raise PlotMetadataUnavailableError("The run has no plot parameters yet.")
+        if len(self._parameters) > MAX_PARAMETERS:
+            raise TrustedLiveQueryError("Plot parameter count exceeds the supported bound.")
         self._completed = bool(completed)
         self.number_of_results = 0
         # Only qPlot's cache accessors are used; no DataSet database methods.
@@ -80,7 +95,7 @@ def plot_dataset(executor, service, guid):
         "WHERE r.guid=? LIMIT 2", (guid,),
     ).rows
     if len(rows) != 1:
-        raise ValueError("The requested plot GUID does not identify one run.")
+        raise TrustedLiveQueryError("The requested plot GUID does not identify one run.")
     return TrustedPlotDataset(service, rows[0])