VFS Federation Studio 0.0.15 engineering handoff
=================================================

Primary change
--------------
The configured Perl NN lifecycle is now usable through a guided AI Workbench.
Typed JSON remains authoritative, while preflight, training, inspection, and
approval run through spawn-isolated supervisor tasks with truthful progress and
cooperative cancellation.

The desktop visual family now follows the supplied PyCForge 1.0.5 source:
blackened forged-steel tokens, compact frameless menu/title chrome, muted
application icons, consistent dialogs, responsive previews, and a live About
surface. PySide6 is a mandatory distribution dependency.

The main toolbar follows PyCForge's mixed-density action flow: Open, Save, and
the primary AI Workbench action show text beside their icons; secondary tools
remain compact and retain tooltips/accessibility names. Button height derives
from the active system font with a 33-logical-pixel floor.

Important files
---------------
src/vfs_federation_studio/ui/dialogs/assistant_workbench.py
src/vfs_federation_studio/app/bootstrap.py
src/vfs_federation_studio/workers/entrypoint.py
src/vfs_federation_studio/ipc/protocol.py
src/vfs_federation_studio/assistant/candidate.py
perl_runtime_templates/assistant/bin/plnn-text-train
perl_runtime_templates/assistant/lib/LaptopNN/Network.pm
scripts/p5_assistant_workbench_proof.py
scripts/windows_assistant_qualification.ps1
scripts/windows_ui_qualification.py
docs/architecture/PERL_NN_WORKBENCH_CONTRACT.md
src/vfs_federation_studio/ui/themes/visual_tokens.py
src/vfs_federation_studio/ui/themes/dark.py
src/vfs_federation_studio/ui/widgets/title_bar.py
src/vfs_federation_studio/ui/dialogs/about.py
src/vfs_federation/ide/__main__.py
PYPI_RELEASE.md

Review boundary
---------------
Training never writes approval. The Workbench displays measured quality and the
complete candidate fingerprint, requires a named reviewer plus confirmation,
and revalidates approval immediately before updating package configuration.
The final emitter validates it again.

Host qualification
------------------
On Windows 11 PowerShell, run:

  powershell -ExecutionPolicy Bypass -File .\scripts\windows_assistant_qualification.ps1

Then launch the Studio and inspect actual-display scaling, keyboard focus,
F1 routing, screen-reader names, and long localized text at 100%, 125%, 150%,
and 200%. Use `py -m vfs_federation.ide`; inspect the forged-steel main shell,
every custom dialog, tree icons, file preview, and About surface. Automated
offscreen layout checks complement but do not replace this.

Wheel review
------------
The project uses a standard PyPI wheel and source distribution. The wheel
declares PySide6>=6.8,<7, installs the GUI script `vfs-federation-studio`, and
supports `py -m vfs_federation.ide`. Review the wheel from a clean environment
outside the source checkout as described in PYPI_RELEASE.md.

Release boundary
----------------
The Workbench durably saves its JSON and selects an approved candidate. A final
VFS/package build remains a separate explicit build command; full Chronicle
embedding of assistant configuration remains future work.
