Assistant package contents and HTML help

Every generated Perl distribution includes the auditable assistant set below share/<package>/assistant/. Documentation is layered so an operator does not have to mine one oversized release history: the package root README.md starts the VFS runtime, the assistant directory’s README.md is the Perl response/artifact/replay reference, and examples/branch_agent/README.md is the specialist walkthrough.

Artifact	Purpose
`README.md`	Package-specific Perl examples, `respond()` fields, exact checkpoint measurements, benchmark replay, and failure semantics.
`model.json`	Saved neural weights, architecture, labels, vectorizer, and training summary.
`knowledge.json`	Reviewed answers used by retrieval.
`training.csv` / `benchmark.csv`	Normalized audited corpora.
`history.csv` / `metrics.json`	Epoch history and independent quality measurements.
`config.json`	Package-relative settings with private workstation paths removed.
`manifest.json`	Digest inventory, behavior thresholds, quality, and authority boundary; it also binds the assistant README and local Help files.
`build-report.json`	Package-specific source, architecture, and quality summary.
`help/index.html`	Network-free documentation generated for the actual package.

Independent evaluator included in every export

bin/plnn-text-evaluate recomputes predictions from a selected model and labeled CSV. The assistant README gives the package’s exact command, expected row count, and expected accuracy. Write replay output outside any branch bundle that will be signed; unlisted extras make admission fail closed.

Build with an approved main candidate

python -m vfs_federation_studio.tools.build_cli `
  .\output\root.vfsbin `
  --perl-package .\packages `
  --perl-module VFS::MyProduct `
  --assistant-bundle .\candidate-main

Specialist branches remain separate. If enabled, vfs-agent-branch publishes a validated descendant below /agents/ID only after an explicit command. To use its retained directory for workspace reconfiguration, sign that immutable bundle with a workspace-trusted Ed25519 identity and pass the workspace admission and regression checks before Chronicle registration. See Trust agent signers and set regression limits.