xmatic/pepa-pi-bot
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

v0.3.0-rc.1: live skill registry + fast advisor scaffold

Browse Source 
Roots out the v0.2.x failure mode: Pi-extracted lessons routinely named
hallucinated skill ids (relocate.surface, choose.safe.surface,
survive.shelter, gather.visible_log, …). All 47 Pi-lessons in the live DB
had applied_count=0 because normalisePreferSkill couldn't find them.

Fix:
1. runtime/skill-registry.js — single source of truth derived from
   skills/index.js. Exports listSkillIds, isRegistered, and a
   prompt-ready block (skillRegistryPrompt) grouped by namespace.
2. Pi prompts (coach/postmortem, coach/reflect) embed the live registry
   with a "USE ONLY THESE, never invent" instruction. Lessons are
   filtered at write-time too — anything not in the registry and not a
   known mode name gets dropped.
3. coach/advice.js — normalisePreferSkill now returns null for unknown
   ids, hardening consult() against any hallucinations that slip
   through. Warn-logged for visibility.

Also lays the LLM substrate for the rest of v0.3.0:

- runtime/llm/provider.js — OpenAI-compatible chat client. Configured
  via PEPA_FAST_LLM_{BASE_URL,API_KEY,MODEL,TIMEOUT_MS}. Safe no-op
  unless API_KEY is set. Supports JSON-mode.
- runtime/coach/fast-advisor.js — tactical advisor tier (scaffold).
  Exposes advise() that asks the fast LLM what to do RIGHT NOW when
  the reflex is wedged/stuck. Rejects hallucinated skill ids using the
  registry. Rate-limited 6/h, 30s cooldown. Not auto-triggered yet —
  wired into reflex in rc.3 (awareness layer).

Tests: 279 green (+24 vs rc.3): 5 registry, 9 provider, 10 advisor.

See dev/v0.3.0/PLAN.md for the full iteration design (manifesto needs
ladder, event-driven awareness, skill pre-emption) and STATUS.md for
shipped/pending tracking.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
mayatnikov
2026-05-27 17:39:43 +03:00
co-authored by Claude Opus 4.7
parent 865aae1213
commit fcfa2277ba
13 changed files with 1113 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
runtime/coach/advice.test.js
+9 -3
View File
@@ -117,10 +117,16 @@ test("normalisePreferSkill: passes through known dot-form skills unchanged", ()
assert.equal(normalisePreferSkill("explore.far"), "explore.far");
});
test("normalisePreferSkill: unknown values returned as-is", () => {
assert.equal(normalisePreferSkill("some.unknown.skill"), "some.unknown.skill");
test("normalisePreferSkill: unknown values rejected (returns null)", () => {
// v0.3.0-rc.1: anything not in the live registry and not a known mode
// name is rejected outright. We'd rather fall through to 'avoid' than
// dispatch a hallucinated skill id.
assert.equal(normalisePreferSkill("some.unknown.skill"), null);
assert.equal(normalisePreferSkill("relocate.surface"), null);
assert.equal(normalisePreferSkill("choose.safe.surface"), null);
assert.equal(normalisePreferSkill("survive.shelter"), null);
assert.equal(normalisePreferSkill(null), null);
assert.equal(normalisePreferSkill(""), "");
assert.equal(normalisePreferSkill(""), null);
});
test("consult: Pi-style mode-name prefer is normalised to override target", async () => {