v0.3.0-rc.2: manifesto / needs ladder L0-L10
Adds an explicit hierarchical needs catalogue that the reflex consults
on every tick. The bot now pursues tangible intermediate goals (food,
wood tools, shelter, stone tools, ...) instead of inheriting whatever
the curriculum thought was "next".
Ladder:
L0 alive HP>5, food>0, not in lava, not panic-near hostile
L1 food ≥6 food items in inventory (or sated + any food)
L2 tools_wood wooden_pickaxe + wooden_axe + wooden_sword
L3 shelter_basic bed placed nearby or in inventory
L4 tools_stone stone-tier triplet
L5 armor_basic any chestplate (pursue=null until craft.leather-*
lands; ladder gracefully skips)
L6 food_security ≥16 food items
L7 tools_iron iron-tier triplet (pursue=gather.stone for now)
L8 armor_iron iron chestplate (pursue=null for now)
L9 village_seed bed + chest in nearby blocks
L10 village_full never detected, falls through to curriculum
Each need has detect(snapshot) → bool and pursue(snapshot) →
{skillId, args} | null. The ladder picks the LOWEST unsatisfied
pursuable need. Needs whose pursue is null get recorded as
blockedNeeds and the walk continues — no stalling on missing skills.
Wired into curriculumReflex: manifesto takes precedence over
curriculum.plan when it has a concrete suggestion. Tests can pass
ctx.disableManifesto=true to exercise the curriculum branch
in isolation (existing reflex tests keep passing this way).
Pi self-reflection prompt now includes
"activeNeed (Maslow ladder L0-L10): L2 tools_wood → gather.logs"
so Pi advises at the right level instead of giving generic guidance.
skillId returned by pursue() is validated against the live registry
(rc.1 plumbing) — manifesto cannot accidentally dispatch a
hallucinated skill name.
Tests: 315 green (was 279 on rc.1, +36 new):
- runtime/manifesto/needs.test.js — 24 tests (per-need detect/pursue,
helper sums)
- runtime/manifesto/state.test.js — 10 tests (ladder walk, hostile
takeover at L0, armor skipping, caching)
- runtime/reflex.test.js — 2 integration tests (manifesto overrides
curriculum plan; well-fed bot pursues tools_stone)
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Claude Opus 4.7
@@ -0,0 +1,314 @@
|
||||
// Hierarchical needs ladder (Maslow-like). Each need has:
|
||||
// id stable kebab-case
|
||||
// level 0-10, ascending priority (0 = most urgent)
|
||||
// title Russian short label for chat narration
|
||||
// detect(s) → bool, true means need is already satisfied
|
||||
// pursue(s) → { skillId, args? } | null, what to do RIGHT NOW
|
||||
//
|
||||
// Need ordering matters: state.js picks the LOWEST-level unsatisfied
|
||||
// need. If pursue() returns null we move on to the next level — that's
|
||||
// how "I want armour but can't craft it yet" gracefully degrades to
|
||||
// "go gather more iron".
|
||||
//
|
||||
// Snapshot shape comes from runtime/perceive.js#snapshot().
|
||||
|
||||
const PICKAXE_WOOD = ["wooden_pickaxe"];
|
||||
const PICKAXE_STONE = ["stone_pickaxe"];
|
||||
const PICKAXE_IRON = ["iron_pickaxe", "diamond_pickaxe", "netherite_pickaxe"];
|
||||
const AXE_WOOD = ["wooden_axe"];
|
||||
const AXE_STONE = ["stone_axe"];
|
||||
const AXE_IRON = ["iron_axe", "diamond_axe", "netherite_axe"];
|
||||
const SWORD_WOOD = ["wooden_sword"];
|
||||
const SWORD_STONE = ["stone_sword"];
|
||||
const SWORD_IRON = ["iron_sword", "diamond_sword", "netherite_sword"];
|
||||
const FOOD_ITEMS = [
|
||||
"bread", "cooked_beef", "cooked_porkchop", "cooked_chicken", "cooked_mutton",
|
||||
"cooked_rabbit", "cooked_cod", "cooked_salmon", "baked_potato",
|
||||
"apple", "carrot", "potato", "beetroot", "melon_slice", "sweet_berries",
|
||||
"golden_apple", "golden_carrot",
|
||||
];
|
||||
const ARMOR_CHEST_ANY = [
|
||||
"leather_chestplate", "iron_chestplate", "golden_chestplate",
|
||||
"diamond_chestplate", "netherite_chestplate", "chainmail_chestplate",
|
||||
];
|
||||
const ARMOR_IRON_CHEST = ["iron_chestplate"];
|
||||
const BED_ITEMS = [
|
||||
"white_bed", "orange_bed", "magenta_bed", "light_blue_bed", "yellow_bed",
|
||||
"lime_bed", "pink_bed", "gray_bed", "light_gray_bed", "cyan_bed",
|
||||
"purple_bed", "blue_bed", "brown_bed", "green_bed", "red_bed", "black_bed",
|
||||
];
|
||||
|
||||
function hasAny(inv, names) {
|
||||
if (!inv) return false;
|
||||
for (const n of names) {
|
||||
if ((inv[n] ?? 0) > 0) return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
function countAny(inv, names) {
|
||||
if (!inv) return 0;
|
||||
let total = 0;
|
||||
for (const n of names) total += inv[n] ?? 0;
|
||||
return total;
|
||||
}
|
||||
|
||||
function countLogs(inv) {
|
||||
if (!inv) return 0;
|
||||
let total = 0;
|
||||
for (const [name, count] of Object.entries(inv)) {
|
||||
if (name.endsWith("_log")) total += count;
|
||||
}
|
||||
return total;
|
||||
}
|
||||
|
||||
function countPlanks(inv) {
|
||||
if (!inv) return 0;
|
||||
let total = 0;
|
||||
for (const [name, count] of Object.entries(inv)) {
|
||||
if (name.endsWith("_planks")) total += count;
|
||||
}
|
||||
return total;
|
||||
}
|
||||
|
||||
function hostileImminent(s) {
|
||||
const h = s?.closestHostile;
|
||||
if (!h) return false;
|
||||
return (h.distance ?? Infinity) < 8;
|
||||
}
|
||||
|
||||
function aliveDetect(s) {
|
||||
if (!s?.connected) return true; // not connected, nothing to do
|
||||
const hp = s.health ?? 20;
|
||||
const food = s.food ?? 20;
|
||||
if (hp <= 5) return false;
|
||||
if (food <= 0) return false;
|
||||
if (s.hazards?.inFluid && s.hazards?.footBlock === "lava") return false;
|
||||
if (hostileImminent(s) && hp <= 10) return false;
|
||||
return true;
|
||||
}
|
||||
|
||||
function alivePursue(s) {
|
||||
const hp = s.health ?? 20;
|
||||
const food = s.food ?? 20;
|
||||
if (s.hazards?.footBlock === "lava") {
|
||||
return { skillId: "recovery.tunnel-out", args: { reason: "lava" } };
|
||||
}
|
||||
if (food <= 0 && s.hasFood) {
|
||||
return { skillId: "survive.eat" };
|
||||
}
|
||||
if (food <= 0 && !s.hasFood) {
|
||||
return { skillId: "survive.acquire-food" };
|
||||
}
|
||||
if (hostileImminent(s)) {
|
||||
return { skillId: "survive.flee" };
|
||||
}
|
||||
if (hp <= 5) {
|
||||
return { skillId: "survive.flee" };
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
function foodDetect(s) {
|
||||
if (!s?.connected) return true;
|
||||
if ((s.food ?? 20) >= 18 && countAny(s.inventory, FOOD_ITEMS) >= 1) return true;
|
||||
return countAny(s.inventory, FOOD_ITEMS) >= 6;
|
||||
}
|
||||
|
||||
function foodPursue(s) {
|
||||
if ((s.food ?? 20) < 16 && s.hasFood) {
|
||||
return { skillId: "survive.eat" };
|
||||
}
|
||||
return { skillId: "survive.acquire-food" };
|
||||
}
|
||||
|
||||
function toolsWoodDetect(s) {
|
||||
const inv = s?.inventory;
|
||||
if (!inv) return false;
|
||||
return hasAny(inv, PICKAXE_WOOD) && hasAny(inv, AXE_WOOD) && hasAny(inv, SWORD_WOOD);
|
||||
}
|
||||
|
||||
function toolsWoodPursue(s) {
|
||||
const inv = s.inventory ?? {};
|
||||
const planks = countPlanks(inv);
|
||||
const logs = countLogs(inv);
|
||||
const sticks = inv.stick ?? 0;
|
||||
const hasWb = (inv.crafting_table ?? 0) > 0
|
||||
|| (s.nearbyBlocks?.craftingTable ?? 0) > 0;
|
||||
|
||||
if (logs < 2 && planks < 4 && !hasWb) {
|
||||
return { skillId: "gather.logs" };
|
||||
}
|
||||
if (planks < 4) {
|
||||
return { skillId: "craft.planks" };
|
||||
}
|
||||
if (sticks < 2) {
|
||||
return { skillId: "craft.sticks" };
|
||||
}
|
||||
if (!hasAny(inv, PICKAXE_WOOD)) {
|
||||
return { skillId: "craft.wooden-pickaxe" };
|
||||
}
|
||||
if (!hasAny(inv, AXE_WOOD)) {
|
||||
return { skillId: "craft.wooden-axe" };
|
||||
}
|
||||
if (!hasAny(inv, SWORD_WOOD)) {
|
||||
return { skillId: "craft.wooden-sword" };
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
function shelterBasicDetect(s) {
|
||||
const inv = s?.inventory ?? {};
|
||||
const bedPlaced = (s.nearbyBlocks?.beds ?? 0) > 0;
|
||||
return bedPlaced || hasAny(inv, BED_ITEMS);
|
||||
}
|
||||
|
||||
function shelterBasicPursue(s) {
|
||||
const inv = s.inventory ?? {};
|
||||
if (!hasAny(inv, BED_ITEMS)) {
|
||||
const wool = countAny(inv, [
|
||||
"white_wool", "orange_wool", "magenta_wool", "light_blue_wool",
|
||||
"yellow_wool", "lime_wool", "pink_wool", "gray_wool",
|
||||
"light_gray_wool", "cyan_wool", "purple_wool", "blue_wool",
|
||||
"brown_wool", "green_wool", "red_wool", "black_wool",
|
||||
]);
|
||||
if (wool >= 3 && countPlanks(inv) >= 3) {
|
||||
return { skillId: "craft.bed" };
|
||||
}
|
||||
if (wool < 3) {
|
||||
return { skillId: "gather.wool" };
|
||||
}
|
||||
return { skillId: "gather.logs" };
|
||||
}
|
||||
// Have bed but no shelter — pick a base and build.
|
||||
const blocksForShelter = countPlanks(inv) + (inv.cobblestone ?? 0) + (inv.dirt ?? 0);
|
||||
if (blocksForShelter < 12) {
|
||||
return { skillId: "gather.stone" };
|
||||
}
|
||||
return { skillId: "village.build-shelter" };
|
||||
}
|
||||
|
||||
function toolsStoneDetect(s) {
|
||||
const inv = s?.inventory;
|
||||
if (!inv) return false;
|
||||
return hasAny(inv, PICKAXE_STONE) && hasAny(inv, AXE_STONE) && hasAny(inv, SWORD_STONE);
|
||||
}
|
||||
|
||||
function toolsStonePursue(s) {
|
||||
const inv = s.inventory ?? {};
|
||||
const cobble = inv.cobblestone ?? 0;
|
||||
const sticks = inv.stick ?? 0;
|
||||
if (cobble < 4) {
|
||||
return { skillId: "gather.stone" };
|
||||
}
|
||||
if (sticks < 2) {
|
||||
return { skillId: "craft.sticks" };
|
||||
}
|
||||
if (!hasAny(inv, PICKAXE_STONE)) {
|
||||
return { skillId: "craft.stone-pickaxe" };
|
||||
}
|
||||
if (!hasAny(inv, AXE_STONE)) {
|
||||
return { skillId: "craft.stone-axe" };
|
||||
}
|
||||
if (!hasAny(inv, SWORD_STONE)) {
|
||||
return { skillId: "craft.stone-sword" };
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
function armorBasicDetect(s) {
|
||||
const equip = s?.equipment ?? {};
|
||||
if (equip.torso && ARMOR_CHEST_ANY.includes(equip.torso)) return true;
|
||||
return hasAny(s.inventory, ARMOR_CHEST_ANY);
|
||||
}
|
||||
|
||||
function armorBasicPursue(_s) {
|
||||
// No armor crafting skills registered yet (v0.3.x roadmap). Don't
|
||||
// stall the ladder — let later needs drive activity.
|
||||
return null;
|
||||
}
|
||||
|
||||
function foodSecurityDetect(s) {
|
||||
return countAny(s?.inventory, FOOD_ITEMS) >= 16;
|
||||
}
|
||||
|
||||
function foodSecurityPursue(s) {
|
||||
if ((s.inventory?.wheat_seeds ?? 0) > 0 && (s.nearbyBlocks?.crops ?? 0) > 0) {
|
||||
return { skillId: "farm.wheat" };
|
||||
}
|
||||
return { skillId: "survive.acquire-food" };
|
||||
}
|
||||
|
||||
function toolsIronDetect(s) {
|
||||
const inv = s?.inventory;
|
||||
if (!inv) return false;
|
||||
return hasAny(inv, PICKAXE_IRON) && hasAny(inv, AXE_IRON) && hasAny(inv, SWORD_IRON);
|
||||
}
|
||||
|
||||
function toolsIronPursue(_s) {
|
||||
// No iron-tool craft skills registered yet. Direct the bot to keep
|
||||
// mining — the registry will gain craft.iron-* in a later iteration.
|
||||
return { skillId: "gather.stone" };
|
||||
}
|
||||
|
||||
function armorIronDetect(s) {
|
||||
const equip = s?.equipment ?? {};
|
||||
if (equip.torso === "iron_chestplate") return true;
|
||||
return hasAny(s.inventory, ARMOR_IRON_CHEST);
|
||||
}
|
||||
|
||||
function armorIronPursue(_s) {
|
||||
return null;
|
||||
}
|
||||
|
||||
function villageSeedDetect(s) {
|
||||
// Heuristic: at least one chest placed AND one bed placed within
|
||||
// nearby radius. Tightens later (POIs of kind "structure").
|
||||
const nb = s?.nearbyBlocks ?? {};
|
||||
return (nb.storage ?? 0) >= 1 && (nb.beds ?? 0) >= 1;
|
||||
}
|
||||
|
||||
function villageSeedPursue(s) {
|
||||
const inv = s.inventory ?? {};
|
||||
if ((inv.chest ?? 0) === 0 && countPlanks(inv) >= 8) {
|
||||
return { skillId: "craft.chest" };
|
||||
}
|
||||
if ((inv.chest ?? 0) > 0) {
|
||||
return { skillId: "village.deposit-surplus" };
|
||||
}
|
||||
return { skillId: "village.build-shelter" };
|
||||
}
|
||||
|
||||
function villageFullDetect(_s) {
|
||||
// Always false — it's the global goal.
|
||||
return false;
|
||||
}
|
||||
|
||||
function villageFullPursue(_s) {
|
||||
// Let the curriculum tackle it (fallback chain).
|
||||
return null;
|
||||
}
|
||||
|
||||
export const NEEDS = Object.freeze([
|
||||
{ id: "alive", level: 0, title: "Остаться живым", detect: aliveDetect, pursue: alivePursue },
|
||||
{ id: "food", level: 1, title: "Найти еду", detect: foodDetect, pursue: foodPursue },
|
||||
{ id: "tools_wood", level: 2, title: "Деревянные орудия", detect: toolsWoodDetect, pursue: toolsWoodPursue },
|
||||
{ id: "shelter_basic", level: 3, title: "Простой шелтер", detect: shelterBasicDetect, pursue: shelterBasicPursue },
|
||||
{ id: "tools_stone", level: 4, title: "Каменные орудия", detect: toolsStoneDetect, pursue: toolsStonePursue },
|
||||
{ id: "armor_basic", level: 5, title: "Базовая броня", detect: armorBasicDetect, pursue: armorBasicPursue },
|
||||
{ id: "food_security", level: 6, title: "Запас еды", detect: foodSecurityDetect, pursue: foodSecurityPursue },
|
||||
{ id: "tools_iron", level: 7, title: "Железные орудия", detect: toolsIronDetect, pursue: toolsIronPursue },
|
||||
{ id: "armor_iron", level: 8, title: "Железная броня", detect: armorIronDetect, pursue: armorIronPursue },
|
||||
{ id: "village_seed", level: 9, title: "Зачаток деревни", detect: villageSeedDetect, pursue: villageSeedPursue },
|
||||
{ id: "village_full", level: 10, title: "Полная деревня", detect: villageFullDetect, pursue: villageFullPursue },
|
||||
]);
|
||||
|
||||
export function getNeed(id) {
|
||||
return NEEDS.find((n) => n.id === id) ?? null;
|
||||
}
|
||||
|
||||
// Test exports
|
||||
export const __testing = {
|
||||
hasAny, countAny, countLogs, countPlanks,
|
||||
FOOD_ITEMS, BED_ITEMS, ARMOR_CHEST_ANY,
|
||||
};
|
||||
Reference in New Issue
Block a user