VFS Federation Studio 0.0.13 engineering handoff
=================================================

Primary change
--------------
Every generated Perl VFS distribution now carries the trained PLNN Perl/VFS
assistant and can explicitly train validated same-structure descendants into
new /agents/ID VFS branches.

Important files
---------------
src/vfs_federation_studio/emitters/perl/package.py
perl_runtime_templates/assistant/
docs/architecture/PERL_NN_AGENT_CONTRACT.md
docs/architecture/PERL_NN_AGENT_STATUS_v0.0.13.md
src/vfs_federation_studio/help/topics/perl-assistant-branches.html

Compatibility
-------------
The optional Monk Loom section-12 contract and pure-Perl MonkLoom/Spindle
runtime remain unchanged. PLNN is the default conversational package assistant,
not a rewrite of the deterministic image attachment.

Verification expectations
-------------------------
1. Run the Python suite when pytest is installed.
2. Emit a Perl package with verify_perl=True; every module is perl -c checked
   and all generated t/*.t tests must pass.
3. Copy the emitted directory away from Studio and rerun prove -lr t.
4. Run vfs-agent-branch with workers=2 or 4 and verify the new /agents/ID root.
5. Run the standalone PLNN suite; its independent benchmark floor is 90%.

Authority reminder
------------------
Training is an explicit host command. The trained network does not control the
transaction, cannot overwrite an existing branch, and has no autonomous,
commit, or Monk-policy authority.

