Files
pepa-pi-bot/scripts/show-story.js
T
mayatnikovandClaude Opus 4.7 7f545723b5 feat(v0.3.1): storyline — canonical Minecraft survival quest
The bot has been stuck in a loop for two days:
  acquire-food (fail: no nearby food) → explore.far → pillar-up (fail) → repeat

Diagnosis: manifesto + LLM advisor both correctly identify "you need
food" but neither expresses *what concretely to do next*. Manifesto is
a priority ladder (need-detection), not a narrative arc.

This commit adds the missing narrative layer — an ordered list of
operational steps that mirror the vanilla Minecraft survival path:

  1. orient_self      — Понять где я
  2. first_wood       — Собрать 8 поленьев
  3. crafting_basics  — Сделать верстак и палки
  4. first_tools      — Деревянные орудия
  5. first_food       — Найти первую еду
  6. shelter_minimal  — Простой шелтер с кроватью
  7. stone_tier       — Каменные орудия
  8. food_security    — Запас еды на 16+
  9. iron_age         — Железо и печь
  10. settle_base     — Постоянная база
  11. village_grow    — Развивать деревню (ongoing)

Each step has:
  - completed(snapshot) → bool — detects achievement from snapshot
  - suggestSkill(snapshot) → { skillId, args? } — concrete next dispatch
  - emergencyPause(snapshot) → bool — defers to manifesto L0 alive
    emergencies (low HP near hostile, lava under foot, food = 0)
  - narration_ru — chat-friendly Russian one-liner spoken on entry

Components:

- runtime/goal/storyline.js — 11-step canonical quest catalogue
- runtime/goal/state.js — pickCurrentStep(snapshot) walks the list,
  returns first non-completed step + its suggestion. 3s cache.
  Validates suggestSkill's skillId against the live registry.
- runtime/reflex.js — curriculumReflex dispatch priority is now:
    1. manifesto (L0 alive emergencies always win)
    2. storyline (concrete operational subgoal)
    3. curriculum plan (legacy fallback)
  Tests pass ctx.disableStoryline=true for isolation.
- runtime/bot.js — snapshot.storyStep populated each tick so
  chatter/advisor/reflect observers see the same view.
- runtime/coach/fast-advisor.js — buildUserPrompt now embeds the
  current step + its suggested skill, so LLM advice is anchored
  ("step 5 first_food, storyline wants survive.acquire-food, but
  recent dispatches show it's failing — try explore.far + scout").
- runtime/coach/advisor-trigger.js — forwards ctx.storyStep into
  advise() and logs step id at trigger time.
- runtime/coach/reflect.js — reflection prompt includes storyline
  progress so 30-min self-assessment is anchored.
- runtime/persona/chatter.js — narrates step.narration_ru on
  transition. Rate-limited via existing maybeNarrateRaw().

New operator CLI:

- scripts/show-story.js — fetches the live snapshot via IPC sock and
  prints step progress with ✓/→/ markers, current skill, inventory.
  Falls back to --plain catalogue view when bot offline.

Token cost impact: ~+30 input tokens per advise() call (one extra
line in user prompt). Trivial vs the value of grounding LLM advice
in a concrete narrative.

Operator usage:

  node scripts/show-story.js          # live progress + which step + why
  node scripts/show-story.js --plain  # static catalogue of all 11 steps

Tests: 376 green (was 360, +16 storyline tests).

Also in this branch (already committed): dev/v0.3.1/PRD.md —
LLM prompt cost optimization design doc.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 20:36:17 +03:00

95 lines
2.9 KiB
JavaScript

#!/usr/bin/env node
// Operator-facing view of the bot's storyline progress.
//
// Reads the bot's IPC sock if available (live snapshot), else falls
// back to "what would the picker say given an empty inventory". The
// useful form is the live one.
//
// Usage:
// node scripts/show-story.js # live snapshot via IPC
// node scripts/show-story.js --plain # show static catalogue
import { config as loadDotenv } from "dotenv";
loadDotenv();
import net from "node:net";
import { STORYLINE } from "../runtime/goal/storyline.js";
import { pickCurrentStep, progressSummary, _resetForTest } from "../runtime/goal/state.js";
import { socketPath } from "../runtime/config.js";
function plainCatalogue() {
console.log("=== Storyline (canonical Minecraft survival arc) ===");
for (let i = 0; i < STORYLINE.length; i++) {
const s = STORYLINE[i];
console.log(` ${(i + 1).toString().padStart(2)}. ${s.id.padEnd(20)} ${s.title}`);
console.log(` → ${s.narration_ru}`);
}
}
async function fetchSnapshotViaIpc() {
return new Promise((resolve) => {
const sock = net.connect(socketPath);
const buf = [];
const timer = setTimeout(() => { sock.destroy(); resolve(null); }, 1500);
sock.on("connect", () => {
sock.write(JSON.stringify({ kind: "get-status" }) + "\n");
});
sock.on("data", (chunk) => buf.push(chunk));
sock.on("end", () => {
clearTimeout(timer);
try {
const raw = Buffer.concat(buf).toString("utf8").trim();
const lines = raw.split("\n").filter(Boolean);
for (const ln of lines) {
const obj = JSON.parse(ln);
if (obj?.kind === "status" && obj?.snapshot) {
resolve(obj.snapshot);
return;
}
}
resolve(null);
} catch { resolve(null); }
});
sock.on("error", () => { clearTimeout(timer); resolve(null); });
});
}
async function main() {
if (process.argv.includes("--plain")) {
plainCatalogue();
return;
}
const snap = await fetchSnapshotViaIpc();
if (!snap) {
console.log("(bot IPC not reachable — showing static catalogue)");
console.log("");
plainCatalogue();
return;
}
_resetForTest();
const cur = pickCurrentStep(snap);
console.log(`=== Storyline progress (live snapshot) ===`);
console.log(progressSummary(snap));
console.log("");
if (!cur) {
console.log("(disconnected)");
return;
}
for (let i = 0; i < STORYLINE.length; i++) {
const s = STORYLINE[i];
const mark = i < cur.index ? "✓" : (i === cur.index ? "→" : " ");
const tag = i === cur.index ? ` (${cur.suggestion?.skillId ?? "-"})${cur.emergency ? " [PAUSED]" : ""}` : "";
console.log(` ${mark} ${(i + 1).toString().padStart(2)}. ${s.id.padEnd(20)} ${s.title}${tag}`);
}
console.log("");
console.log(`Inventory keys: ${snap.inventory ? Object.keys(snap.inventory).slice(0, 12).join(", ") : "(empty)"}`);
console.log(`HP ${snap.health ?? "?"} / food ${snap.food ?? "?"} / day=${snap.isDay ? "yes" : "no"}`);
}
main().catch((e) => {
console.error("ERROR:", e?.message ?? e);
process.exit(1);
});