ruv 0aac1e13f1 feat(intelligence): pretrain self-learning from repo history (ADR-077, 3.10.17) ...

Ships a deterministic one-shot harvester so a fresh ruflo install can
bootstrap its self-learning system from the repo's own GitHub history
(git commits + gh issues) instead of starting empty.

Each item flows through the same code paths real-time learning uses —
distillAndSerialise (ADR-076) → recordTrajectory (ADR-074) → neural
store seed. Closes the ADR-075 consistency note "globalStats moved but
neural store stayed empty" by writing to both stores from the same script.

Measured (this checkout):
  • 80/80 trajectories trained from 50 commits + 30 issues
  • +95 trajectoriesRecorded, +85 patternsLearned, +80 neuralPatternCount
  • 3.36 ms avg per trajectory
  • 100% retrieval match rate across 10 sample queries
  • 7.67 ms avg query latency at N=95

Adds:
  - scripts/pretrain-from-github.mjs (harvester, env-configurable)
  - scripts/benchmark-pretrained-retrieval.mjs (after-pretrain validator)
  - __tests__/pretrain-from-github.test.ts (CI guard, embedded fixture,
    no git/gh shell-outs — auto-picked-up by v3-ci.yml line 610)
  - v3/docs/adr/ADR-077-pretrain-from-history.md (decision + measured
    proof + honest limits)
  - v3/docs/learning/self-learning-usage.md (copy-paste guide for all
    three learning paths plus this pretrain flow)

Co-Authored-By: RuFlo <ruv@ruv.net>

2026-05-30 12:55:58 -04:00

..

self-learning-2245-proof.md

…

self-learning-usage.md

…