feat(v0.4.0): finish vNext plan — anti-loop, skill-graph, worldDelta diff, flee→motion

Completes the remaining v0.4.0 plan items and one fix motivated by a live
in-game observation (flee hanging 30s against a persistent zombie).

- flee → MotionService.gotoSafe: structured {stuck|timeout|nopath} in ~4s with
  a blind-retreat fallback, instead of the observed 30s pathfinder hang + 3
  watchdog replans. Movements setup guarded so it is unit-testable.
- QW5 anti-loop (runtime/anti-loop.js): same skill failing >=3x in 5min →
  30min blacklist (reflex shouldSkip) + one-shot improvement_request
  (bot.js drainFired -> writeProposal).
- 4.1 closed-loop worldDelta: runSkill snapshots inventory before execute and
  attaches the real delta (_invObserved) to every successful result; opt-in
  skill.expectGain asserts the claimed gain or returns world_unchanged.
- 3.6 skill-graph (Plan4MC): declarative requires/produces for ~20 skills;
  prerequisitesMet/canRun/runnableFrontier; GoalManager annotates suggestions
  with blockedBy when prereqs are unmet.

+22 tests (472 total green). Live smoke confirmed dig-in works and no new
errors; flee loop is what this commit's flee migration addresses.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-28 11:20:52 +03:00
co-authored by Claude Opus 4.7
parent 2a6cc0cdb1
commit c963ab3ecb
13 changed files with 575 additions and 26 deletions
+37
View File
@@ -59,6 +59,7 @@ import { createScenarioMemory, situationHash } from "./scenario-memory.js";
import { createOwnedBlocksLedger } from "./owned-blocks.js";
import { createInventoryLedger } from "./services/inventory-ledger.js";
import { createMotionService } from "./services/motion.js";
import { createAntiLoop } from "./anti-loop.js";
import { initKnowledge } from "./knowledge/index.js";
import { attach as attachCoach } from "./coach/postmortem.js";
import { attach as attachReflect } from "./coach/reflect.js";
@@ -109,6 +110,7 @@ const worldJournal = createWorldJournal();
const scenarioMemory = createScenarioMemory();
const ownedBlocks = createOwnedBlocksLedger();
const inventoryLedger = createInventoryLedger();
const antiLoop = createAntiLoop();
const goalManager = createGoalManager();
let motionService = null; // armed on spawn (needs a live bot for pathfinder)
let lastResult = null; // { label, ok, code, detail, ts }
@@ -138,6 +140,7 @@ const reflexCtx = {
metrics: skillMetrics,
owned: ownedBlocks,
ledger: inventoryLedger,
antiLoop,
motion: null, // set on spawn alongside the pathfinder watchdog
};
@@ -971,6 +974,40 @@ function tick() {
void filePostCritique(wedged, "wedged");
}
// QW5 — anti-loop: a skill that failed ≥3× in 5 min is blacklisted by
// the detector; here we turn each fired loop into an improvement_request
// so the operator/Codex gets a concrete ticket instead of silent thrash.
for (const loop of antiLoop.drainFired()) {
try {
writeProposal({
kind: `anti-loop-${loop.skillId}`,
summary: `${loop.skillId} looped ${loop.count}× in 5min (last code=${loop.code ?? "?"})`,
body: [
`# Anti-loop: ${loop.skillId}`,
``,
`The same skill failed ${loop.count} times within 5 minutes with no success`,
`in between, so it has been blacklisted until ${new Date(loop.until).toISOString()}.`,
``,
`- skill: ${loop.skillId}`,
loop.targetKey ? `- target: ${loop.targetKey}` : `- target: (none)`,
`- last failure code: ${loop.code ?? "?"}`,
`- runtime state: ${lastSnapshot.runtimeState ?? "?"}`,
`- no-progress reason: ${lastSnapshot.noProgressReason ?? "?"}`,
`- position: ${JSON.stringify(lastSnapshot.position ?? null)}`,
`- milestone: ${lastSnapshot.contract?.milestone?.id ?? lastSnapshot.currentMilestone ?? "?"}`,
``,
`## Suggested fix`,
`Either the skill's preconditions are too loose (it keeps being chosen`,
`when it cannot succeed here) or it needs a real recovery branch. Inspect`,
`runtime/skills/${loop.skillId.split(".").pop()}*.js and the scheduler path.`,
].join("\n"),
editScope: ["runtime/skills/", "runtime/reflex.js", "runtime/modes.js"],
});
} catch (e) {
warn("anti-loop", `writeProposal failed: ${e?.message ?? e}`);
}
}
ipc?.broadcast(EVENT_TYPES.STATUS, lastSnapshot);
} else {
lastSnapshot = { connected: false };