Packaged Perl NN and branch agents

Every generated Perl VFS distribution includes a saved pure-Perl conversational assistant, reviewed knowledge, training and benchmark CSV files, and training history. It does not require Python or network access. This assistant is distinct from the optional deterministic Monk Loom image attachment.

Ask questions

perl bin/vfs-perl-assistant
perl bin/vfs-perl-assistant --ask "How do Monk VFS scopes work?" --explain

From Perl, call Your::VFS->assistant(), then respond($question, $state). The model retrieves reviewed answers and never executes pasted code.

Training data and paths

Use UTF-8 CSV with the exact header utterance,intent, one natural question per row, at least two rows per intent, and balanced coverage. Quote fields containing commas or quotes. Knowledge JSON must contain a nonempty articles array; every article needs id, title, intent, and answer, and every training intent needs at least one article.

On Windows 11, quote paths containing spaces. Four workers are a sensible first measurement on an Intel i7, but compare one, two, and four because small batches can be slower when process communication dominates.

perl .\bin\vfs-agent-branch ^
  --image "C:\My App\working.vfsbin" ^
  --agent-id plugins ^
  --data "C:\My App\plugins-training.csv" ^
  --knowledge "C:\My App\plugins-knowledge.json" ^
  --benchmark "C:\My App\plugins-test.csv" ^
  --bundle-output "C:\My App\review-bundles\plugins" ^
  --minimum-accuracy 0.80 ^
  --workers 4

Preservation and authority

The command is the only trigger; no autonomous crawl or training occurs. It trains a descendant with the parent input width, hidden layers, activation, dropout, and vectorizer contract, while resizing the output layer to the specialist labels. Before publication it reloads the model, checks knowledge coverage and the quality floor, and verifies SHA-256 and byte size for every artifact.

A successful bundle contains manifest.json, model.json, knowledge.json, training.csv, history.csv, and an optional benchmark.csv. One transaction publishes it below /agents/ID. --bundle-output retains the same verified bundle for Chronicle review. Failure publishes nothing; an existing ID or output directory is never overwritten.

Ask a branch directly

perl .\bin\vfs-perl-assistant ^
  --agent-id plugins --image "C:\My App\working.vfsbin" ^
  --ask "Which reviewed plugin plan applies?" --json

A specialist knowledge article may include a fixed workspace_actions array. The JSON response labels it proposal-only; the Perl package never runs it. Before Chronicle registration, sign the retained review bundle with a workspace-trusted Ed25519 key and pass its independent-benchmark accuracy and regression policy. Follow the complete agent reconfiguration walkthrough.

The host command owns the VFS transaction. The descendant manifest explicitly denies autonomous-training, VFS-commit, and Monk-policy authority.