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

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>

runtime/coach/reflect.js

@@ -16,8 +16,20 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 
 import { isAvailable as knowledgeAvailable, record as recordLesson } from "../knowledge/index.js";
+import { isRegistered, skillRegistryPrompt } from "../skill-registry.js";
 import { info, warn } from "../log.js";
 
+// Mode-name allow-list, mirrors postmortem.js (advice.js maps them to
+// real skills at consult-time). Anything else is hallucination → dropped.
+const KNOWN_MODE_NAMES = new Set([
+	"self_preservation", "night_shelter", "hunger", "shelter",
+	"flee", "sleep", "eat", "tunnel_out", "tunnel-out", "explore", "wander",
+]);
+function isLikelyModeName(s) {
+	if (!s || typeof s !== "string") return false;
+	return KNOWN_MODE_NAMES.has(s.toLowerCase().trim());
+}
+
 const DEFAULT_INTERVAL_MS = 30 * 60 * 1000;
 const HOURLY_BUDGET = 2;
 const HISTORY_TAIL_LINES = 80;
@@ -78,20 +90,33 @@ export async function runOnce({ stateDir, askPi, getSnapshot, force = false } =
 	}
 
 	const path = writeReflection(stateDir, parsed, reply);
+	let rejectedPrefer = 0;
 	for (const l of asArray(parsed.lessons)) {
 		if (!l?.lesson) continue;
+		let preferSkill = l.prefer_skill ?? null;
+		if (preferSkill && !isRegistered(preferSkill) && !isLikelyModeName(preferSkill)) {
+			rejectedPrefer += 1;
+			preferSkill = null;
+		}
+		let avoidSkill = l.avoid_skill ?? null;
+		if (avoidSkill && !isRegistered(avoidSkill) && !isLikelyModeName(avoidSkill)) {
+			avoidSkill = null;
+		}
 		recordLesson({
 			text: l.lesson,
 			category: l.category ?? "self-improve",
 			triggerSkill: l.trigger_skill ?? null,
 			triggerHostile: l.trigger_hostile ?? null,
-			avoidSkill: l.avoid_skill ?? null,
-			preferSkill: l.prefer_skill ?? null,
+			avoidSkill,
+			preferSkill,
 			confidence: clamp(Number(l.confidence) || 0.5, 0.1, 0.9),
 			source: "pi-reflect",
 			sourceRef: path,
 		});
 	}
+	if (rejectedPrefer > 0) {
+		warn("reflect", `dropped prefer_skill from ${rejectedPrefer} reflection lessons (not in registry)`);
+	}
 	info("reflect", `verdict=${parsed.verdict ?? "?"} ${parsed.summary?.slice(0, 80) ?? ""} (${path ?? "no file"})`);
 	return { ok: true, verdict: parsed.verdict, summary: parsed.summary, lessons: parsed.lessons ?? [] };
 }
@@ -136,6 +161,8 @@ function buildPrompt({ snap, journal, scenarios, diary, plan }) {
 		"You are pepa, an autonomous Minecraft survival bot, reflecting on your own progress.",
 		"Look at the last ~30 minutes of activity below. Answer honestly: are you actually making progress, or stuck in a loop?",
 		"",
+		skillRegistryPrompt({ limit: 1800 }),
+		"",
 		"## Current state",
 		`- position: ${pos ? `(${Math.round(pos.x)}, ${Math.round(pos.y)}, ${Math.round(pos.z)})` : "?"}`,
 		`- hp: ${snap?.health ?? "?"} food: ${snap?.food ?? "?"} day: ${snap?.isDay ? "yes" : "no"}`,
@@ -176,8 +203,8 @@ function buildPrompt({ snap, journal, scenarios, diary, plan }) {
 		'      "category": "combat|pathing|crafting|survival|self-improve",',
 		'      "trigger_skill": "<skill id or null>",',
 		'      "trigger_hostile": "<mob name or null>",',
-		'      "avoid_skill": "<skill to avoid or null>",',
-		'      "prefer_skill": "<alternative skill id or null>",',
+		'      "avoid_skill": "<registered skill id to avoid or null>",',
+		'      "prefer_skill": "<registered skill id to use instead or null>",',
 		'      "confidence": 0.6 }',
 		'  ]',
 		'}',
@@ -185,6 +212,7 @@ function buildPrompt({ snap, journal, scenarios, diary, plan }) {
 		"If you're clearly in a loop (same activity, no inventory growth, same position), say so honestly.",
 		"If you're stuck in a bad terrain (deep pit, hostile-rich area), recommend choosing a new base.",
 		"Lessons should be SHORT and ACTIONABLE. Don't repeat lessons the dispatcher already learned.",
+		"CRITICAL: avoid_skill and prefer_skill MUST be one of the registered ids listed at the top of this prompt, or null. Do NOT invent new ids.",
 	].join("\n");
 }