@v12-engine/engine 0.1.1 → 0.4.0

package/dist/ai/goals.js

@@ -0,0 +1,560 @@
+import { exp } from "../exactMath.js";
+import { defineModule } from "./module.js";
+import { considerationsLine } from "./report.js";
+import { UnitSet } from "./view.js";
+//#region src/ai/goals.ts
+var clamp01 = (x) => x > 1 ? 1 : x > 0 ? x : 0;
+/**
+* The usual response curves, each a line (`consider(name, read, curve.saturate(6))`): how a raw number becomes "how
+* much do I care". A curve gives 0..1; what gives nonsense (NaN) counts as 0
+*
+* @beta
+*/
+var curve = {
+	/** A straight line from 0 at 0 to 1 at `max` (1 when left out: for a ratio), flat beyond: twice the units, twice the care, up to a point */
+	linear: (max = 1) => (x) => clamp01(x / max),
+	/** 1 − e^(−x/k): rises fast, then levels off at 1 (0.63 at `k`, 0.86 at `2k`): the sixth worker seen matters less than the first */
+	saturate: (k) => (x) => x <= 0 ? 0 : 1 - exp(-x / k),
+	/** k / (k + x): 1 at 0, falling to a half at `k` and towards 0: the less there is of it, the better (how held their base is) */
+	inverse: (k) => (x) => x <= 0 ? 1 : k / (k + x),
+	/** 0 below `at`, 1 from it on: a threshold (a wave is ready at so many units), an on-off (any intruder at all: `step(1)`) */
+	step: (at) => (x) => x >= at ? 1 : 0,
+	/** 1 between `low` and `high`, 0 outside: a window (an army of between 4 and 12) */
+	band: (low, high) => (x) => x >= low && x <= high ? 1 : 0,
+	/** A shape of the game's own: whatever the function gives, kept to 0..1 */
+	custom: (fn) => (x) => clamp01(fn(x))
+};
+/**
+* A consideration: a question with a name, and the curve that says how much its answer matters (`curve.linear()`
+* when left out: the number is a ratio already)
+*
+* @beta
+*/
+function consider(name, read, shape = curve.linear()) {
+	return {
+		name,
+		read,
+		curve: shape
+	};
+}
+/**
+* Defines a goal: checked, and given back as it is, for a brain's `goals`, `meleeBrain.with({ goals })`, or
+* `ai.goals.add`
+*
+* @beta
+*/
+function defineGoal(def) {
+	if (!def.id) throw new Error("A goal needs an id");
+	if (!Array.isArray(def.considerations)) throw new Error(`The goal "${def.id}" needs its considerations, as a list`);
+	if (typeof def.run !== "function") throw new Error(`The goal "${def.id}" needs a run`);
+	return def;
+}
+var MIN = .05;
+var MARGIN = .15;
+var COMMITMENT = 5;
+/**
+* The brain's goals and their picker (`ai.goals`): what the computer could do, scored each think, the best given what
+* they claim (`think`, once a think: run by the `goals()` module, or by a module of the brain's own in its place among
+* the others). What each holds is read here (`held`, `holds`, `holder`, `pool`), taken by a rule or a module
+* (`take`), and reported (`report`)
+*
+* @beta
+*/
+var Goals = class {
+	ai;
+	/** Its id among the brain's areas: what its memory and its report are kept under */
+	id = "goals";
+	/** What the log says where a save's memory of it is of a shape it does not read */
+	afresh = "the save remembers what the computer player’s goals held in a shape this brain does not read: they start afresh";
+	/** How much each goal scored this think, by id: what the debug tools showed before the report */
+	scores = {};
+	/** The goal that scored highest above the minimum this think: what the army is on. None when nothing is worth doing */
+	best;
+	entries = /* @__PURE__ */ new Map();
+	holds = {};
+	cooldowns = {};
+	added = 0;
+	thoughtAt = -1;
+	min;
+	margin;
+	commitment;
+	constructor(ai, options = {}) {
+		this.ai = ai;
+		this.min = options.min ?? MIN;
+		this.margin = options.margin ?? MARGIN;
+		this.commitment = options.commitment ?? COMMITMENT;
+	}
+	/** Adds goals to pick among: a brain's own (`BrainDef.goals`), the seat's (`AiOptions.goals`), a module's */
+	add(...defs) {
+		for (const def of defs) {
+			if (this.entries.has(def.id)) throw new Error(`The brain "${this.ai.def.id}" has two goals called "${def.id}"`);
+			this.entries.set(def.id, {
+				def,
+				order: this.added++,
+				score: 0,
+				urgent: false,
+				considerations: [],
+				picked: false
+			});
+		}
+	}
+	/** Takes a goal out: what it held goes back to the pool, and it is told `removed`. Whether there was one */
+	remove(id) {
+		if (!this.entries.get(id)) return false;
+		this.release(id, "removed");
+		this.entries.delete(id);
+		return true;
+	}
+	/** The goals, as added */
+	list() {
+		return [...this.entries.values()].map((entry) => entry.def);
+	}
+	/** A goal by id */
+	get(id) {
+		return this.entries.get(id)?.def;
+	}
+	/** What a goal holds, while it does */
+	held(id) {
+		return this.holds[id];
+	}
+	/** What every goal holds, by goal id */
+	all() {
+		return this.holds;
+	}
+	/** The goal that holds a unit, by the unit's id: none for a unit in the pool */
+	holder(unit) {
+		for (const id in this.holds) if (this.holds[id].units.includes(unit)) return id;
+	}
+	/** The player's units no goal holds, as of the think's picture: what a goal picked next may claim */
+	pool() {
+		const held = this.heldIds();
+		const { mine } = this.ai.view;
+		return held.size ? mine.where((entity) => !held.has(entity.id)) : mine;
+	}
+	/** The money the goals hold together (`GoalClaims.money`): held in the purse (`ai.purse`), which takes it off what is free */
+	reserved() {
+		const sum = {};
+		for (const id in this.holds) {
+			const { money } = this.holds[id];
+			for (const kind in money) sum[kind] = (sum[kind] ?? 0) + money[kind];
+		}
+		return sum;
+	}
+	/**
+	* Takes units from whatever goals hold them, for a rule (B2) or a module (the defence, C4) that wants them: a goal
+	* left with none is told why (`told` when left out). Those of them that were held, by id.
+	*
+	* With `by`, the units are then held by that rule or module itself (`by.id`, which names no goal: `rule:attack`),
+	* for `by.seconds` (30 when left out) or until `release(by.id)`: no goal may claim them meanwhile, for a rule goes
+	* before the goals (the one order of who may move a unit: goals, then rules take, then the defence; micro never
+	* retasks). Units taken again by the same id are added to what it holds, and its time starts again. `seconds:
+	* Infinity` holds them until let go of (`release`, `drop`): what a squad that is no goal's holds its units by
+	*/
+	take(units, why = "told", by) {
+		const wanted = new Set(units);
+		const taken = [];
+		for (const id in this.holds) {
+			if (id === by?.id) continue;
+			const hold = this.holds[id];
+			const kept = hold.units.filter((unit) => !wanted.has(unit));
+			if (kept.length === hold.units.length) continue;
+			taken.push(...hold.units.filter((unit) => wanted.has(unit)));
+			hold.units = kept;
+			if (!kept.length) this.release(id, why);
+		}
+		if (by) {
+			if (this.entries.has(by.id)) throw new Error(`"${by.id}" is a goal of the brain: what a rule holds needs a name of its own`);
+			const { tick, session } = this.ai;
+			const kept = (this.holds[by.id]?.units ?? []).filter((unit) => this.ai.view.mine.has(unit));
+			const all = [...kept, ...[...wanted].filter((unit) => !kept.includes(unit) && this.ai.view.mine.has(unit))];
+			all.sort((a, b) => this.ai.view.indexOf(this.ai.view.byId(a)) - this.ai.view.indexOf(this.ai.view.byId(b)));
+			const seconds = by.seconds ?? 30;
+			const forever = seconds === Infinity;
+			this.holds[by.id] = {
+				units: all,
+				since: this.holds[by.id]?.since ?? tick,
+				until: forever ? tick : tick + Math.round(seconds * session.tickRate),
+				score: 1,
+				...forever && { kept: true }
+			};
+		}
+		return taken;
+	}
+	/**
+	* Adds units from the pool (what nothing holds) to what a goal, a rule or a module holds: a squad's reinforcements
+	* (`Squad.reinforce`). What another holds is passed over: `take` is for that. Those given, by id
+	*/
+	give(id, units) {
+		const hold = this.holds[id];
+		if (!hold) return [];
+		const { view } = this.ai;
+		const held = this.heldIds();
+		const given = [];
+		for (const unit of units) if (!held.has(unit) && view.mine.has(unit) && !given.includes(unit)) given.push(unit);
+		if (!given.length) return given;
+		hold.units = hold.units.filter((unit) => view.mine.has(unit));
+		hold.units.push(...given);
+		hold.units.sort((a, b) => view.indexOf(view.byId(a)) - view.indexOf(view.byId(b)));
+		return given;
+	}
+	/**
+	* Lets go of some of what a goal, a rule or a module holds: they go back to the pool. One left with none is released,
+	* told why (`done` when left out). Those let go of, by id
+	*/
+	drop(id, units, why = "done") {
+		const hold = this.holds[id];
+		if (!hold) return [];
+		const gone = new Set(units);
+		const dropped = hold.units.filter((unit) => gone.has(unit));
+		if (!dropped.length) return dropped;
+		hold.units = hold.units.filter((unit) => !gone.has(unit));
+		if (!hold.units.length) this.release(id, why);
+		return dropped;
+	}
+	/** What rules and modules hold (`take` with `by`), by their id: not goals' */
+	taken() {
+		const result = {};
+		for (const id in this.holds) if (!this.entries.has(id)) result[id] = this.holds[id];
+		return result;
+	}
+	/** Whether a unit is held by a rule or a module rather than by a goal (`take` with `by`): what nothing else is to give orders to */
+	ruled(unit) {
+		for (const id in this.holds) if (!this.entries.has(id) && this.holds[id].units.includes(unit)) return true;
+		return false;
+	}
+	/** Takes a goal's claim away, telling it why (`told` when left out): its units go back to the pool. Whether it held one */
+	release(id, why = "told") {
+		const hold = this.holds[id];
+		if (!hold) return false;
+		delete this.holds[id];
+		if (hold.money) this.ai.purse.release(id);
+		const entry = this.entries.get(id);
+		if (!entry) {
+			this.ai.decide(`${id} lets go of ${hold.units.length === 1 ? "1 unit" : `${hold.units.length} units`}`, { kind: "rule" });
+			return true;
+		}
+		this.ai.decide(`${id} stopped: ${stopped(why, entry.lostTo)}`, {
+			kind: "goal",
+			goal: id
+		});
+		entry.def.stop?.(this.ai, why, this.claimedOf(id, hold, false));
+		const cooldown = entry.def.cooldown ?? 0;
+		if (cooldown > 0) this.cooldowns[id] = this.ai.tick + Math.round(cooldown * this.ai.session.tickRate);
+		return true;
+	}
+	/**
+	* The think: every goal scored (its considerations read, curved, multiplied, weighed), the goals that hold a claim
+	* kept to it or beaten, the rest picked best first with what they claim, and each picked one run. Once a think: a
+	* second call in the same think does nothing
+	*/
+	think() {
+		const { ai } = this;
+		const { tick, view } = ai;
+		if (this.thoughtAt === tick) return;
+		this.thoughtAt = tick;
+		for (const id in this.holds) {
+			const hold = this.holds[id];
+			const entry = this.entries.get(id);
+			const alive = hold.units.filter((unit) => view.mine.has(unit));
+			if (alive.length !== hold.units.length) hold.units = alive;
+			if (!entry) {
+				if (!hold.kept && tick >= hold.until || !alive.length) this.release(id, "done");
+				continue;
+			}
+			if (!alive.length && entry.def.claims?.units) this.release(id, "done");
+		}
+		for (const id in this.cooldowns) if (this.cooldowns[id] <= tick) delete this.cooldowns[id];
+		const entries = [...this.entries.values()];
+		this.scores = {};
+		this.best = void 0;
+		let bestScore = this.min;
+		for (const entry of entries) {
+			this.score(entry);
+			this.scores[entry.def.id] = entry.score;
+			if (entry.score > bestScore) {
+				bestScore = entry.score;
+				this.best = entry.def.id;
+			}
+		}
+		for (const entry of entries) {
+			const { id } = entry.def;
+			if (this.holds[id] && entry.score <= (entry.def.min ?? this.min)) this.release(id, "done");
+		}
+		const ranked = entries.filter((entry) => entry.score > (entry.def.min ?? this.min)).sort((a, b) => b.score - a.score || a.order - b.order);
+		const pool = new Set(this.pool().ids());
+		for (let i = 0; i < ranked.length; i++) {
+			const entry = ranked[i];
+			const { def } = entry;
+			const { id } = def;
+			if (this.cooldowns[id] !== void 0) {
+				entry.why = "cooldown";
+				continue;
+			}
+			let hold = this.holds[id];
+			let first = false;
+			if (hold) {
+				if (!hold.units.length && def.claims?.units) {
+					this.release(id, entry.lost ?? "beaten");
+					entry.why = entry.lost === "urgent" ? "taken by an urgent goal" : "beaten";
+					continue;
+				}
+			} else {
+				hold = this.claim(entry, ranked, i, pool);
+				if (!hold) continue;
+				first = true;
+			}
+			entry.picked = true;
+			const claimed = this.claimedOf(id, hold, first);
+			if (first) this.decided(entry, claimed);
+			def.run(ai, claimed);
+		}
+	}
+	/**
+	* A goal's score this think: each consideration read and curved, their product, the weight, the game's say. Once a
+	* consideration answers 0 the goal is vetoed, and the ones after it are not asked: put the cheap questions first
+	*/
+	score(entry) {
+		const { ai } = this;
+		const { def } = entry;
+		let product = 1;
+		entry.considerations = [];
+		for (const consideration of def.considerations) {
+			if (product === 0) {
+				entry.considerations.push({
+					name: consideration.name,
+					value: 0,
+					curved: 0,
+					asked: false
+				});
+				continue;
+			}
+			const value = finite(consideration.read(ai));
+			const curved = positive(consideration.curve(value));
+			entry.considerations.push({
+				name: consideration.name,
+				value,
+				curved
+			});
+			product *= curved;
+		}
+		let score = positive(product * (def.weight ?? 1) * (ai.profile.weights?.[def.id] ?? 1));
+		entry.score = score;
+		entry.urgent = score > (def.min ?? this.min) && (typeof def.urgent === "function" ? def.urgent(ai) : !!def.urgent);
+		entry.picked = false;
+		entry.why = void 0;
+		entry.lost = void 0;
+		entry.lostTo = void 0;
+	}
+	/** Writes down a goal picked anew, for the decision log: its score, what it holds, its considerations */
+	decided(entry, claimed) {
+		const { def } = entry;
+		const units = def.claims?.units ? ` (${claimed.units.length === 1 ? "1 unit" : `${claimed.units.length} units`})` : "";
+		const reasons = considerationsLine(entry);
+		this.ai.decide(`${def.id} picked at ${entry.score.toFixed(2)}${units}${entry.urgent ? ", urgent" : ""}${reasons && `: ${reasons}`}`, {
+			kind: "goal",
+			goal: def.id
+		});
+	}
+	/**
+	* What a goal picked anew takes: the units it chooses from the pool and from the holds of goals ranked below it
+	* that it may take from (by the margin within their commitment, by any lead after it, and by any lead at all for an
+	* urgent goal), and the money it names. Nothing where it asked for units and chose none
+	*/
+	claim(entry, ranked, at, pool) {
+		const { ai } = this;
+		const { def } = entry;
+		const { view, tick } = ai;
+		const units = [];
+		if (def.claims?.units) {
+			const held = this.heldIds();
+			for (const unit of pool) if (held.has(unit)) pool.delete(unit);
+			const preys = [];
+			for (let j = at + 1; j < ranked.length; j++) {
+				const other = ranked[j];
+				const hold = this.holds[other.def.id];
+				if (!hold?.units.length) continue;
+				const lead = tick < hold.until && !entry.urgent ? other.def.margin ?? this.margin : 0;
+				if (entry.score > other.score + lead) preys.push(other);
+			}
+			const takeable = new Set(pool);
+			for (const prey of preys) for (const unit of this.holds[prey.def.id].units) takeable.add(unit);
+			const available = view.mine.where((unit) => takeable.has(unit.id));
+			for (const chosen of def.claims.units(ai, available)) if (takeable.has(chosen.id) && !units.includes(chosen.id)) units.push(chosen.id);
+			if (!units.length) {
+				entry.why = "nothing to claim";
+				return;
+			}
+			units.sort((a, b) => view.indexOf(view.byId(a)) - view.indexOf(view.byId(b)));
+			for (const unit of units) {
+				if (pool.delete(unit)) continue;
+				for (const prey of preys) {
+					const hold = this.holds[prey.def.id];
+					const index = hold.units.indexOf(unit);
+					if (index < 0) continue;
+					hold.units.splice(index, 1);
+					prey.lost = entry.urgent ? "urgent" : "beaten";
+					prey.lostTo = def.id;
+					break;
+				}
+			}
+		}
+		const money = this.moneyOf(def);
+		if (money) ai.purse.reserve(def.id, money);
+		const commitment = def.commitment ?? this.commitment;
+		const hold = {
+			units,
+			...money && { money },
+			since: tick,
+			until: tick + Math.round(commitment * ai.session.tickRate),
+			score: entry.score
+		};
+		this.holds[def.id] = hold;
+		return hold;
+	}
+	/** The money a goal names, as a cost: a number is in the game's money */
+	moneyOf(def) {
+		const { ai } = this;
+		const asked = typeof def.claims?.money === "function" ? def.claims.money(ai) : def.claims?.money;
+		if (asked === void 0) return void 0;
+		if (typeof asked === "number") {
+			if (!(asked > 0)) return void 0;
+			const currency = ai.registry.currency ?? ai.registry.resources[0]?.id;
+			return currency === void 0 ? void 0 : { [currency]: asked };
+		}
+		return Object.keys(asked).length ? { ...asked } : void 0;
+	}
+	/** What a goal holds, as it is handed to it */
+	claimedOf(goal, hold, first) {
+		const { ai } = this;
+		const units = new UnitSet(ai.view, hold.units.map((id) => ai.view.byId(id)).filter((unit) => !!unit));
+		const squad = (name, of, options = {}) => {
+			const kept = ai.squads.named(name);
+			if (!kept || kept.owner !== goal) return ai.squads.make(name, of, {
+				...options,
+				owner: goal
+			});
+			kept.data.options = {
+				...ai.squads.defaults,
+				...options
+			};
+			return kept.add(of);
+		};
+		return {
+			units,
+			...hold.money && { money: hold.money },
+			began: hold.since,
+			first,
+			squad
+		};
+	}
+	heldIds() {
+		const held = /* @__PURE__ */ new Set();
+		for (const id in this.holds) for (const unit of this.holds[id].units) held.add(unit);
+		return held;
+	}
+	/** Every goal as the picker last saw it: score, considerations, what it holds, why it did not run */
+	report() {
+		const { view } = this.ai;
+		return [...this.entries.values()].map((entry) => {
+			const { def } = entry;
+			const hold = this.holds[def.id];
+			return {
+				id: def.id,
+				scope: def.scope ?? "army",
+				score: entry.score,
+				considerations: entry.considerations,
+				picked: entry.picked,
+				urgent: entry.urgent,
+				...hold && { held: {
+					units: hold.units.length,
+					ids: [...hold.units],
+					strength: view.strength.sum(hold.units.map((id) => view.byId(id)).filter((unit) => !!unit)),
+					...hold.money && { money: { ...hold.money } },
+					since: hold.since,
+					until: hold.until
+				} },
+				...entry.why && { why: entry.why }
+			};
+		});
+	}
+	/** What is held and on cooldown, for a save */
+	/** Whether it has anything to remember now: one that does not is left out of a save */
+	remembers() {
+		return this.list().length > 0 || Object.keys(this.all()).length > 0;
+	}
+	/** Gives what the goals remember, the holds and the rest, as plain data for a save of the brain */
+	save() {
+		const holds = {};
+		for (const id in this.holds) {
+			const hold = this.holds[id];
+			holds[id] = {
+				...hold,
+				units: [...hold.units],
+				...hold.money && { money: { ...hold.money } }
+			};
+		}
+		return {
+			v: 1,
+			holds,
+			cooldowns: { ...this.cooldowns }
+		};
+	}
+	/** Takes back what `save` gave: whether it was read */
+	restore(memory) {
+		const given = memory;
+		if (!given || typeof given !== "object" || given.v !== 1) return false;
+		this.holds = {};
+		for (const id in given.holds ?? {}) {
+			const hold = given.holds[id];
+			this.holds[id] = {
+				...hold,
+				units: [...hold.units ?? []],
+				...hold.money && { money: { ...hold.money } }
+			};
+		}
+		this.cooldowns = { ...given.cooldowns ?? {} };
+		return true;
+	}
+	/** What the debug tools show: the report, the best, and the picker's numbers */
+	inspect() {
+		return {
+			goals: this.report(),
+			...this.best !== void 0 && { goal: this.best }
+		};
+	}
+};
+/** Why a goal stopped, in words, for the decision log */
+function stopped(why, by) {
+	switch (why) {
+		case "beaten": return by ? `beaten by ${by}` : "beaten";
+		case "urgent": return by ? `its units taken by ${by}, urgent` : "its units taken by an urgent goal";
+		case "done": return "done, or nothing left to run with";
+		case "told": return "its units taken by a rule or a module";
+		case "removed": return "taken out of the brain";
+	}
+}
+/** A number as it is, and 0 for what is none (NaN, infinite): the picker never picks on nonsense */
+var finite = (x) => Number.isFinite(x) ? x : 0;
+/** A curved value or a score: finite, and nothing under 0 */
+var positive = (x) => Number.isFinite(x) && x > 0 ? x : 0;
+/**
+* The goals module: runs the brain's picker (`ai.goals.think`) in its place among the brain's modules, after what
+* reads the game and before what acts on orders. With goals of its own to add to the brain's
+*
+* @beta
+*/
+var goals = (defs = []) => defineModule({
+	id: "goals",
+	make: (ai) => {
+		ai.goals.add(...defs);
+		return {
+			id: "goals",
+			phase: "act",
+			think: () => ai.goals.think()
+		};
+	}
+});
+//#endregion
+export { Goals, consider, curve, defineGoal, goals };
+
+//# sourceMappingURL=goals.js.map

package/dist/ai/goals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals.js","names":[],"sources":["../../src/ai/goals.ts"],"sourcesContent":["import type { Cost } from '#engine/defs'\nimport type { AiArea } from './area'\nimport { exp } from '#engine/exactMath'\nimport type { EntityState } from '#engine/session/protocol'\nimport { type Brain } from './brain'\nimport { type AiModule, type AiModuleDef, defineModule } from './module'\nimport { considerationsLine } from './report'\nimport type { Squad, SquadOptions } from './squads'\nimport { UnitSet } from './view'\n\n/*\n * Goals that score themselves (AI plan, B1): how a computer player decides what to do with what it has. The old way\n * was a ladder of ifs (`if (underAttack) defend() else if (ready) attack()`), and the first version of the melee\n * player's goals was a constant each (defend 1, attack 0.8): one ran, for the whole army, and nothing weighed \"a small\n * raid at my expansion while my army is away\" against \"their army at my gate\". This is the **utility** pattern,\n * written down once:\n *\n * - A **goal** is something the computer could do (`defineGoal`): defend, attack, creep, scout, raid their workers.\n * - It scores itself from **considerations**: each a question over what it sees that gives a number (how many enemies\n *   at my buildings; the strength of my idle army over my whole army; seconds since their base was looked at), passed\n *   through a **curve** that says how much that number matters, as 0..1 (`curve.linear`, `saturate`, `inverse`,\n *   `step`, `band`, `custom`). The goal's **score** is the product of its considerations times its `weight`: a product\n *   is a soft AND, so a goal that wants several things at once scores high only when it has them all, and a\n *   consideration at 0 vetoes it outright (no worker seen: no raid), which saves every goal an `if`.\n * - The **picker** (`Goals.think`, once a think) scores every goal, takes them best first, and gives each what it\n *   **claims**: units from the pool (what no goal holds) and money; the next goal sees what is left, until nothing\n *   scores above `min`. So several goals run at once on different units, and a goal that claims nothing of what it\n *   asked for is not picked.\n * - **Commitment**, or hysteresis: two goals at 0.61 and 0.60 would swap every think and the army would walk in\n *   circles. A picked goal keeps its claim for `commitment` seconds unless another scores more than it by `margin`;\n *   after that, anything that scores more may take from it. `urgent` goals (the melee player's defend, when the raid is\n *   stronger than what the army out holds) break any commitment the moment they score above the committed goal.\n * - **Who may move a unit, in one place.** A unit is held by one goal at a time (`holder`), taken from the pool when\n *   the goal is picked and given back when it stops; a rule (B2) or the defence (C4) that wants a unit takes it\n *   through `take`, and the goal that held it is told (`stop('told')`). Squads (C1) are made of what a goal holds.\n *\n * The report of it all (`report`: every goal's score, its considerations with their raw and curved values, what it\n * holds and why it was not picked) is what the debug tools show, so \"why did it do that\" is read, not guessed. What\n * is held is plain data kept in the brain's memory (`save`, `restore`), ticks and ids: a save keeps the army's goal\n */\n\n/**\n * A response curve: a number (how many, how strong, how long) to how much it matters, 0..1\n *\n * @beta\n */\nexport type Curve = (x: number) => number\n\nconst clamp01 = (x: number) => (x > 1 ? 1 : x > 0 ? x : 0)\n\n/**\n * The usual response curves, each a line (`consider(name, read, curve.saturate(6))`): how a raw number becomes \"how\n * much do I care\". A curve gives 0..1; what gives nonsense (NaN) counts as 0\n *\n * @beta\n */\nexport const curve = {\n\t/** A straight line from 0 at 0 to 1 at `max` (1 when left out: for a ratio), flat beyond: twice the units, twice the care, up to a point */\n\tlinear:\n\t\t(max = 1): Curve =>\n\t\t(x) =>\n\t\t\tclamp01(x / max),\n\t/** 1 − e^(−x/k): rises fast, then levels off at 1 (0.63 at `k`, 0.86 at `2k`): the sixth worker seen matters less than the first */\n\tsaturate:\n\t\t(k: number): Curve =>\n\t\t(x) =>\n\t\t\tx <= 0 ? 0 : 1 - exp(-x / k),\n\t/** k / (k + x): 1 at 0, falling to a half at `k` and towards 0: the less there is of it, the better (how held their base is) */\n\tinverse:\n\t\t(k: number): Curve =>\n\t\t(x) =>\n\t\t\tx <= 0 ? 1 : k / (k + x),\n\t/** 0 below `at`, 1 from it on: a threshold (a wave is ready at so many units), an on-off (any intruder at all: `step(1)`) */\n\tstep:\n\t\t(at: number): Curve =>\n\t\t(x) =>\n\t\t\tx >= at ? 1 : 0,\n\t/** 1 between `low` and `high`, 0 outside: a window (an army of between 4 and 12) */\n\tband:\n\t\t(low: number, high: number): Curve =>\n\t\t(x) =>\n\t\t\tx >= low && x <= high ? 1 : 0,\n\t/** A shape of the game's own: whatever the function gives, kept to 0..1 */\n\tcustom:\n\t\t(fn: (x: number) => number): Curve =>\n\t\t(x) =>\n\t\t\tclamp01(fn(x))\n} as const\n\n/**\n * One question a goal asks of what it sees, and how much the answer matters: `read` gives the raw number, `curve`\n * turns it into 0..1. The report keeps both\n *\n * @beta\n */\nexport interface Consideration {\n\t/** What it asks, for the report: \"intruders at my buildings\" */\n\tname: string\n\t/** The raw number, read from the brain each think: cheap, or cached for the think (`ai.cache`) */\n\tread: (ai: Brain) => number\n\t/** How much the number matters, 0..1 */\n\tcurve: Curve\n}\n\n/**\n * A consideration: a question with a name, and the curve that says how much its answer matters (`curve.linear()`\n * when left out: the number is a ratio already)\n *\n * @beta\n */\nexport function consider(name: string, read: (ai: Brain) => number, shape: Curve = curve.linear()): Consideration {\n\treturn { name, read, curve: shape }\n}\n\n/**\n * What a goal is about, and so what it competes with: `army` goals claim units, `economy` goals money, `squad` and\n * `hero` goals are about one of those (scored once each until squads (C1) and heroes (C2) score them apiece), or a\n * game's own word\n *\n * @beta\n */\nexport type GoalScope = 'army' | 'economy' | 'squad' | 'hero' | (string & {})\n\n/**\n * Why a goal lost its claim (`GoalDef.stop`): `beaten` by one that scored more by the margin, `urgent` by an urgent\n * one, `done` as its own score fell to nothing, `told` by a rule or a module that took its units, `removed` from the\n * brain\n *\n * @beta\n */\nexport type StopReason = 'beaten' | 'urgent' | 'done' | 'told' | 'removed'\n\n/**\n * What a goal claims to run: units from the pool and money from the purse. The picker gives each goal what it asks\n * of what is left, best goal first\n *\n * @beta\n */\nexport interface GoalClaims {\n\t/**\n\t * The units it takes, chosen from what it may have (`available`: the pool, and what goals it may take from hold):\n\t * the nearest six fighters, one scout, everything. A goal that asks for units and gets none is not picked\n\t */\n\tunits?: (ai: Brain, available: UnitSet) => Iterable<EntityState>\n\t/**\n\t * The money it holds while it runs, in the game's money (`Registry.currency`) as a number, or as a cost by resource;\n\t * a function for one that depends. Held against the purse (`Goals.reserved`), given back when the goal stops\n\t */\n\tmoney?: number | Cost | ((ai: Brain) => number | Cost | undefined)\n}\n\n/**\n * What a picked goal was given (`GoalDef.run`): the units it holds this think (the dead and the lost dropped), the\n * money, when it was picked, and whether this is the first think it runs\n *\n * @beta\n */\nexport interface Claimed {\n\t/** The units it holds, as of this think's picture */\n\tunits: UnitSet\n\t/** The money it holds, where it asked for any */\n\tmoney?: Cost\n\t/** The tick it was picked at */\n\tbegan: number\n\t/** Whether this is the first think it runs: when its orders are to be sent, once */\n\tfirst: boolean\n\t/**\n\t * Makes a squad the goal owns (`ai.squads.make` with the goal as its `owner`): when the goal stops, its squads go.\n\t * Called again for a name the goal has a squad of already (a run each think), it is that squad, kept as it is (its\n\t * task, its `size`), the units given added to it and its options those given now\n\t */\n\tsquad(name: string, units: Iterable<EntityState | number>, options?: SquadOptions): Squad\n}\n\n/**\n * A goal: something the computer could do, scored by its considerations, run with what it claims (`defineGoal`)\n *\n * @beta\n */\nexport interface GoalDef {\n\t/** Unique among the brain's goals, prefixed as components are (the engine's `ai.defend`, a game's `mygame.raid`) */\n\tid: string\n\t/** What it is about: `army` when left out */\n\tscope?: GoalScope\n\t/** Its questions: the score is their product (a soft AND: one at 0 vetoes the goal), times the weight */\n\tconsiderations: Consideration[]\n\t/** What it is worth against the other goals at their best: 1 when left out */\n\tweight?: number\n\t/** The score under which it is not picked: the picker's (`PickingOptions.min`) when left out */\n\tmin?: number\n\t/** What it takes to run: units, money. None: it runs on its score alone, holding nothing */\n\tclaims?: GoalClaims\n\t/**\n\t * Seconds it keeps its claim once picked, unless another scores more than it by the margin, or an urgent one scores\n\t * more at all. The picker's default when left out. Hysteresis: without it two close goals swap every think\n\t */\n\tcommitment?: number\n\t/** How much more another goal must score to take from this one within its commitment: the picker's when left out */\n\tmargin?: number\n\t/** Whether it may break another goal's commitment as soon as it scores more: a raid that cannot wait */\n\turgent?: boolean | ((ai: Brain) => boolean)\n\t/** Seconds after it stops before it may be picked again */\n\tcooldown?: number\n\t/** What it does, each think it holds its claim: `claimed.first` on the first, where its orders are sent once and then watched */\n\trun(ai: Brain, claimed: Claimed): void\n\t/** Told when it loses its claim, and why: to let go of what it was doing */\n\tstop?(ai: Brain, why: StopReason, claimed: Claimed): void\n}\n\n/**\n * Defines a goal: checked, and given back as it is, for a brain's `goals`, `meleeBrain.with({ goals })`, or\n * `ai.goals.add`\n *\n * @beta\n */\nexport function defineGoal(def: GoalDef): GoalDef {\n\tif (!def.id) throw new Error('A goal needs an id')\n\tif (!Array.isArray(def.considerations)) throw new Error(`The goal \"${def.id}\" needs its considerations, as a list`)\n\tif (typeof def.run !== 'function') throw new Error(`The goal \"${def.id}\" needs a run`)\n\treturn def\n}\n\n/**\n * How a brain picks among its goals, where a goal does not say for itself (`BrainDef.picking`)\n *\n * @beta\n */\nexport interface PickingOptions {\n\t/** The score under which a goal is not picked: 0.05 when left out */\n\tmin?: number\n\t/** How much more a goal must score than a committed one to take from it: 0.15 when left out */\n\tmargin?: number\n\t/** Seconds a picked goal keeps its claim: 5 when left out */\n\tcommitment?: number\n}\n\n/**\n * What a goal holds while it runs: its units (ids, of the player's), its money, when it was picked and until when it\n * is committed. Plain data, kept in the brain's memory\n *\n * @beta\n */\nexport interface Hold {\n\t/** The units it holds, by id, in the picture's order */\n\tunits: number[]\n\t/** The money it holds (`GoalClaims.money`) */\n\tmoney?: Cost\n\t/** The tick it was picked at */\n\tsince: number\n\t/** The tick its commitment ends at: for a rule's or a module's hold (`take` with `by`), the tick it lets go at */\n\tuntil: number\n\t/** For a rule's or a module's hold: kept until let go of (`release`), whatever `until` says. A squad of one's own holds so */\n\tkept?: true\n\t/** What it scored when picked */\n\tscore: number\n}\n\n/**\n * What the goals remember between thinks: what each holds, and until when each is on cooldown\n *\n * @beta\n */\nexport interface GoalsMemory {\n\t/** The version of this shape */\n\tv: 1\n\t/** What each goal holds, by goal id */\n\tholds: Record<string, Hold>\n\t/** The tick each goal on cooldown may be picked again at, by goal id */\n\tcooldowns: Record<string, number>\n}\n\n/**\n * One goal as the picker last saw it: for the debug tools, and for \"why did it do that\"\n *\n * @beta\n */\nexport interface GoalReport {\n\t/** The goal */\n\tid: string\n\t/** What it is about */\n\tscope: GoalScope\n\t/** Its score: the considerations' product, weighed */\n\tscore: number\n\t/**\n\t * Each question, its raw answer and how much that mattered. One after a question answered 0 is not asked (the goal\n\t * is vetoed already): `asked: false`, its numbers 0\n\t */\n\tconsiderations: { name: string; value: number; curved: number; asked?: false }[]\n\t/** Whether it ran this think */\n\tpicked: boolean\n\t/** Whether it may break a commitment now */\n\turgent: boolean\n\t/** What it holds: how many units (and which, `ids`), how strong together, the money, since when and until when (ticks) */\n\theld?: { units: number; ids: number[]; strength: number; money?: Cost; since: number; until: number }\n\t/** Why it did not run, where it scored enough: `cooldown`, `nothing to claim`, or what it lost its claim to */\n\twhy?: string\n}\n\n/** Where a goal's definition is kept, with what the picker found of it this think */\ninterface Entry {\n\tdef: GoalDef\n\t/** Its place in the order added: the tie-breaker among equal scores, so that two thinks pick alike */\n\torder: number\n\tscore: number\n\turgent: boolean\n\tconsiderations: GoalReport['considerations']\n\tpicked: boolean\n\twhy?: string\n\t/** Why it lost units this think, where it did: its stop reason once it has none left */\n\tlost?: StopReason\n\t/** The goal it lost units to this think, for the decision log */\n\tlostTo?: string\n}\n\nconst MIN = 0.05\nconst MARGIN = 0.15\nconst COMMITMENT = 5\n\n/**\n * The brain's goals and their picker (`ai.goals`): what the computer could do, scored each think, the best given what\n * they claim (`think`, once a think: run by the `goals()` module, or by a module of the brain's own in its place among\n * the others). What each holds is read here (`held`, `holds`, `holder`, `pool`), taken by a rule or a module\n * (`take`), and reported (`report`)\n *\n * @beta\n */\nexport class Goals implements AiArea {\n\t/** Its id among the brain's areas: what its memory and its report are kept under */\n\treadonly id = 'goals'\n\t/** What the log says where a save's memory of it is of a shape it does not read */\n\treadonly afresh = 'the save remembers what the computer player’s goals held in a shape this brain does not read: they start afresh'\n\n\t/** How much each goal scored this think, by id: what the debug tools showed before the report */\n\tscores: Record<string, number> = {}\n\t/** The goal that scored highest above the minimum this think: what the army is on. None when nothing is worth doing */\n\tbest: string | undefined\n\tprivate readonly entries = new Map<string, Entry>()\n\tprivate holds: Record<string, Hold> = {}\n\tprivate cooldowns: Record<string, number> = {}\n\tprivate added = 0\n\tprivate thoughtAt = -1\n\tprivate readonly min: number\n\tprivate readonly margin: number\n\tprivate readonly commitment: number\n\n\tconstructor(\n\t\t/** The brain they are the goals of */\n\t\treadonly ai: Brain,\n\t\toptions: PickingOptions = {}\n\t) {\n\t\tthis.min = options.min ?? MIN\n\t\tthis.margin = options.margin ?? MARGIN\n\t\tthis.commitment = options.commitment ?? COMMITMENT\n\t}\n\n\t/** Adds goals to pick among: a brain's own (`BrainDef.goals`), the seat's (`AiOptions.goals`), a module's */\n\tadd(...defs: GoalDef[]): void {\n\t\tfor (const def of defs) {\n\t\t\tif (this.entries.has(def.id)) throw new Error(`The brain \"${this.ai.def.id}\" has two goals called \"${def.id}\"`)\n\t\t\tthis.entries.set(def.id, { def, order: this.added++, score: 0, urgent: false, considerations: [], picked: false })\n\t\t}\n\t}\n\n\t/** Takes a goal out: what it held goes back to the pool, and it is told `removed`. Whether there was one */\n\tremove(id: string): boolean {\n\t\tconst entry = this.entries.get(id)\n\t\tif (!entry) return false\n\t\tthis.release(id, 'removed')\n\t\tthis.entries.delete(id)\n\t\treturn true\n\t}\n\n\t/** The goals, as added */\n\tlist(): GoalDef[] {\n\t\treturn [...this.entries.values()].map((entry) => entry.def)\n\t}\n\n\t/** A goal by id */\n\tget(id: string): GoalDef | undefined {\n\t\treturn this.entries.get(id)?.def\n\t}\n\n\t/** What a goal holds, while it does */\n\theld(id: string): Hold | undefined {\n\t\treturn this.holds[id]\n\t}\n\n\t/** What every goal holds, by goal id */\n\tall(): Readonly<Record<string, Hold>> {\n\t\treturn this.holds\n\t}\n\n\t/** The goal that holds a unit, by the unit's id: none for a unit in the pool */\n\tholder(unit: number): string | undefined {\n\t\tfor (const id in this.holds) if (this.holds[id].units.includes(unit)) return id\n\t\treturn undefined\n\t}\n\n\t/** The player's units no goal holds, as of the think's picture: what a goal picked next may claim */\n\tpool(): UnitSet {\n\t\tconst held = this.heldIds()\n\t\tconst { mine } = this.ai.view\n\t\treturn held.size ? mine.where((entity) => !held.has(entity.id)) : mine\n\t}\n\n\t/** The money the goals hold together (`GoalClaims.money`): held in the purse (`ai.purse`), which takes it off what is free */\n\treserved(): Cost {\n\t\tconst sum: Cost = {}\n\t\tfor (const id in this.holds) {\n\t\t\tconst { money } = this.holds[id]\n\t\t\tfor (const kind in money) sum[kind] = (sum[kind] ?? 0) + money[kind]\n\t\t}\n\t\treturn sum\n\t}\n\n\t/**\n\t * Takes units from whatever goals hold them, for a rule (B2) or a module (the defence, C4) that wants them: a goal\n\t * left with none is told why (`told` when left out). Those of them that were held, by id.\n\t *\n\t * With `by`, the units are then held by that rule or module itself (`by.id`, which names no goal: `rule:attack`),\n\t * for `by.seconds` (30 when left out) or until `release(by.id)`: no goal may claim them meanwhile, for a rule goes\n\t * before the goals (the one order of who may move a unit: goals, then rules take, then the defence; micro never\n\t * retasks). Units taken again by the same id are added to what it holds, and its time starts again. `seconds:\n\t * Infinity` holds them until let go of (`release`, `drop`): what a squad that is no goal's holds its units by\n\t */\n\ttake(units: Iterable<number>, why: StopReason = 'told', by?: { id: string; seconds?: number }): number[] {\n\t\tconst wanted = new Set(units)\n\t\tconst taken: number[] = []\n\t\tfor (const id in this.holds) {\n\t\t\tif (id === by?.id) continue\n\t\t\tconst hold = this.holds[id]\n\t\t\tconst kept = hold.units.filter((unit) => !wanted.has(unit))\n\t\t\tif (kept.length === hold.units.length) continue\n\t\t\ttaken.push(...hold.units.filter((unit) => wanted.has(unit)))\n\t\t\thold.units = kept\n\t\t\tif (!kept.length) this.release(id, why)\n\t\t}\n\t\tif (by) {\n\t\t\tif (this.entries.has(by.id)) throw new Error(`\"${by.id}\" is a goal of the brain: what a rule holds needs a name of its own`)\n\t\t\tconst { tick, session } = this.ai\n\t\t\t// what it held and is gone is let go of here: a brain with no goals has no picker to do it each think\n\t\t\tconst kept = (this.holds[by.id]?.units ?? []).filter((unit) => this.ai.view.mine.has(unit))\n\t\t\tconst all = [...kept, ...[...wanted].filter((unit) => !kept.includes(unit) && this.ai.view.mine.has(unit))]\n\t\t\tall.sort((a, b) => this.ai.view.indexOf(this.ai.view.byId(a)!) - this.ai.view.indexOf(this.ai.view.byId(b)!))\n\t\t\tconst seconds = by.seconds ?? 30\n\t\t\t// for ever is no number a save can keep: such a hold is `kept`, and its `until` is when it was taken\n\t\t\tconst forever = seconds === Infinity\n\t\t\tthis.holds[by.id] = {\n\t\t\t\tunits: all,\n\t\t\t\tsince: this.holds[by.id]?.since ?? tick,\n\t\t\t\tuntil: forever ? tick : tick + Math.round(seconds * session.tickRate),\n\t\t\t\tscore: 1,\n\t\t\t\t...(forever && { kept: true as const })\n\t\t\t}\n\t\t}\n\t\treturn taken\n\t}\n\n\t/**\n\t * Adds units from the pool (what nothing holds) to what a goal, a rule or a module holds: a squad's reinforcements\n\t * (`Squad.reinforce`). What another holds is passed over: `take` is for that. Those given, by id\n\t */\n\tgive(id: string, units: Iterable<number>): number[] {\n\t\tconst hold = this.holds[id]\n\t\tif (!hold) return []\n\t\tconst { view } = this.ai\n\t\tconst held = this.heldIds()\n\t\tconst given: number[] = []\n\t\tfor (const unit of units) if (!held.has(unit) && view.mine.has(unit) && !given.includes(unit)) given.push(unit)\n\t\tif (!given.length) return given\n\t\thold.units = hold.units.filter((unit) => view.mine.has(unit))\n\t\thold.units.push(...given)\n\t\thold.units.sort((a, b) => view.indexOf(view.byId(a)!) - view.indexOf(view.byId(b)!))\n\t\treturn given\n\t}\n\n\t/**\n\t * Lets go of some of what a goal, a rule or a module holds: they go back to the pool. One left with none is released,\n\t * told why (`done` when left out). Those let go of, by id\n\t */\n\tdrop(id: string, units: Iterable<number>, why: StopReason = 'done'): number[] {\n\t\tconst hold = this.holds[id]\n\t\tif (!hold) return []\n\t\tconst gone = new Set(units)\n\t\tconst dropped = hold.units.filter((unit) => gone.has(unit))\n\t\tif (!dropped.length) return dropped\n\t\thold.units = hold.units.filter((unit) => !gone.has(unit))\n\t\tif (!hold.units.length) this.release(id, why)\n\t\treturn dropped\n\t}\n\n\t/** What rules and modules hold (`take` with `by`), by their id: not goals' */\n\ttaken(): Record<string, Hold> {\n\t\tconst result: Record<string, Hold> = {}\n\t\tfor (const id in this.holds) if (!this.entries.has(id)) result[id] = this.holds[id]\n\t\treturn result\n\t}\n\n\t/** Whether a unit is held by a rule or a module rather than by a goal (`take` with `by`): what nothing else is to give orders to */\n\truled(unit: number): boolean {\n\t\tfor (const id in this.holds) if (!this.entries.has(id) && this.holds[id].units.includes(unit)) return true\n\t\treturn false\n\t}\n\n\t/** Takes a goal's claim away, telling it why (`told` when left out): its units go back to the pool. Whether it held one */\n\trelease(id: string, why: StopReason = 'told'): boolean {\n\t\tconst hold = this.holds[id]\n\t\tif (!hold) return false\n\t\tdelete this.holds[id]\n\t\tif (hold.money) this.ai.purse.release(id)\n\t\tconst entry = this.entries.get(id)\n\t\tif (!entry) {\n\t\t\tthis.ai.decide(`${id} lets go of ${hold.units.length === 1 ? '1 unit' : `${hold.units.length} units`}`, { kind: 'rule' })\n\t\t\treturn true\n\t\t}\n\t\tthis.ai.decide(`${id} stopped: ${stopped(why, entry.lostTo)}`, { kind: 'goal', goal: id })\n\t\tentry.def.stop?.(this.ai, why, this.claimedOf(id, hold, false))\n\t\tconst cooldown = entry.def.cooldown ?? 0\n\t\tif (cooldown > 0) this.cooldowns[id] = this.ai.tick + Math.round(cooldown * this.ai.session.tickRate)\n\t\treturn true\n\t}\n\n\t/**\n\t * The think: every goal scored (its considerations read, curved, multiplied, weighed), the goals that hold a claim\n\t * kept to it or beaten, the rest picked best first with what they claim, and each picked one run. Once a think: a\n\t * second call in the same think does nothing\n\t */\n\tthink(): void {\n\t\tconst { ai } = this\n\t\tconst { tick, view } = ai\n\t\tif (this.thoughtAt === tick) return\n\t\tthis.thoughtAt = tick\n\n\t\t// what is held and no longer mine (dead, given away) is let go of first\n\t\tfor (const id in this.holds) {\n\t\t\tconst hold = this.holds[id]\n\t\t\tconst entry = this.entries.get(id)\n\t\t\tconst alive = hold.units.filter((unit) => view.mine.has(unit))\n\t\t\tif (alive.length !== hold.units.length) hold.units = alive\n\t\t\t// what a rule holds is its own until its time is up, or nothing of it is left\n\t\t\tif (!entry) {\n\t\t\t\tif ((!hold.kept && tick >= hold.until) || !alive.length) this.release(id, 'done')\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\t// a goal whose every unit died has nothing left to run with\n\t\t\tif (!alive.length && entry.def.claims?.units) this.release(id, 'done')\n\t\t}\n\t\tfor (const id in this.cooldowns) if (this.cooldowns[id] <= tick) delete this.cooldowns[id]\n\n\t\t// every goal scored, whether or not it can run: the report says what each was worth\n\t\tconst entries = [...this.entries.values()]\n\t\tthis.scores = {}\n\t\tthis.best = undefined\n\t\tlet bestScore = this.min\n\t\tfor (const entry of entries) {\n\t\t\tthis.score(entry)\n\t\t\tthis.scores[entry.def.id] = entry.score\n\t\t\tif (entry.score > bestScore) {\n\t\t\t\tbestScore = entry.score\n\t\t\t\tthis.best = entry.def.id\n\t\t\t}\n\t\t}\n\n\t\t// a held goal whose score fell to nothing is done; one on cooldown or under the minimum is out of the running\n\t\tfor (const entry of entries) {\n\t\t\tconst { id } = entry.def\n\t\t\tif (this.holds[id] && entry.score <= (entry.def.min ?? this.min)) this.release(id, 'done')\n\t\t}\n\n\t\t// best first; among equals, as added, so that two thinks of one picture pick alike\n\t\tconst ranked = entries.filter((entry) => entry.score > (entry.def.min ?? this.min)).sort((a, b) => b.score - a.score || a.order - b.order)\n\t\tconst pool = new Set(this.pool().ids())\n\t\tfor (let i = 0; i < ranked.length; i++) {\n\t\t\tconst entry = ranked[i]\n\t\t\tconst { def } = entry\n\t\t\tconst { id } = def\n\t\t\tif (this.cooldowns[id] !== undefined) {\n\t\t\t\tentry.why = 'cooldown'\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tlet hold: Hold | undefined = this.holds[id]\n\t\t\tlet first = false\n\t\t\tif (hold) {\n\t\t\t\t// it keeps what it holds, less what the goals above it took: with nothing left of what it claimed, it is beaten\n\t\t\t\tif (!hold.units.length && def.claims?.units) {\n\t\t\t\t\tthis.release(id, entry.lost ?? 'beaten')\n\t\t\t\t\tentry.why = entry.lost === 'urgent' ? 'taken by an urgent goal' : 'beaten'\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\thold = this.claim(entry, ranked, i, pool)\n\t\t\t\tif (!hold) continue\n\t\t\t\tfirst = true\n\t\t\t}\n\t\t\tentry.picked = true\n\t\t\tconst claimed = this.claimedOf(id, hold, first)\n\t\t\tif (first) this.decided(entry, claimed)\n\t\t\tdef.run(ai, claimed)\n\t\t}\n\t}\n\n\t/**\n\t * A goal's score this think: each consideration read and curved, their product, the weight, the game's say. Once a\n\t * consideration answers 0 the goal is vetoed, and the ones after it are not asked: put the cheap questions first\n\t */\n\tprivate score(entry: Entry): void {\n\t\tconst { ai } = this\n\t\tconst { def } = entry\n\t\tlet product = 1\n\t\tentry.considerations = []\n\t\tfor (const consideration of def.considerations) {\n\t\t\tif (product === 0) {\n\t\t\t\tentry.considerations.push({ name: consideration.name, value: 0, curved: 0, asked: false })\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst value = finite(consideration.read(ai))\n\t\t\tconst curved = positive(consideration.curve(value))\n\t\t\tentry.considerations.push({ name: consideration.name, value, curved })\n\t\t\tproduct *= curved\n\t\t}\n\t\t// its weight, and what the profile says it weighs (a personality's leanings: `{ attack: 1.3 }`)\n\t\t// a weight of the game's or the profile's that is no number scores nothing, as a consideration's does\n\t\tlet score = positive(product * (def.weight ?? 1) * (ai.profile.weights?.[def.id] ?? 1))\n\t\tentry.score = score\n\t\t// whether it may break a commitment: asked only of a goal in the running\n\t\tentry.urgent = score > (def.min ?? this.min) && (typeof def.urgent === 'function' ? def.urgent(ai) : !!def.urgent)\n\t\tentry.picked = false\n\t\tentry.why = undefined\n\t\tentry.lost = undefined\n\t\tentry.lostTo = undefined\n\t}\n\n\t/** Writes down a goal picked anew, for the decision log: its score, what it holds, its considerations */\n\tprivate decided(entry: Entry, claimed: Claimed): void {\n\t\tconst { def } = entry\n\t\tconst units = def.claims?.units ? ` (${claimed.units.length === 1 ? '1 unit' : `${claimed.units.length} units`})` : ''\n\t\tconst reasons = considerationsLine(entry)\n\t\tthis.ai.decide(`${def.id} picked at ${entry.score.toFixed(2)}${units}${entry.urgent ? ', urgent' : ''}${reasons && `: ${reasons}`}`, {\n\t\t\tkind: 'goal',\n\t\t\tgoal: def.id\n\t\t})\n\t}\n\n\t/**\n\t * What a goal picked anew takes: the units it chooses from the pool and from the holds of goals ranked below it\n\t * that it may take from (by the margin within their commitment, by any lead after it, and by any lead at all for an\n\t * urgent goal), and the money it names. Nothing where it asked for units and chose none\n\t */\n\tprivate claim(entry: Entry, ranked: Entry[], at: number, pool: Set<number>): Hold | undefined {\n\t\tconst { ai } = this\n\t\tconst { def } = entry\n\t\tconst { view, tick } = ai\n\t\tconst units: number[] = []\n\t\tif (def.claims?.units) {\n\t\t\t// what the goals run before it gave themselves since the pool was read (a squad reinforced) is no longer the pool's\n\t\t\tconst held = this.heldIds()\n\t\t\tfor (const unit of pool) if (held.has(unit)) pool.delete(unit)\n\t\t\t// whose units it may take, by the rules of commitment\n\t\t\tconst preys: Entry[] = []\n\t\t\tfor (let j = at + 1; j < ranked.length; j++) {\n\t\t\t\tconst other = ranked[j]\n\t\t\t\tconst hold = this.holds[other.def.id]\n\t\t\t\tif (!hold?.units.length) continue\n\t\t\t\tconst committed = tick < hold.until\n\t\t\t\tconst lead = committed && !entry.urgent ? (other.def.margin ?? this.margin) : 0\n\t\t\t\tif (entry.score > other.score + lead) preys.push(other)\n\t\t\t}\n\t\t\tconst takeable = new Set(pool)\n\t\t\tfor (const prey of preys) for (const unit of this.holds[prey.def.id].units) takeable.add(unit)\n\t\t\tconst available = view.mine.where((unit) => takeable.has(unit.id))\n\t\t\tfor (const chosen of def.claims.units(ai, available)) if (takeable.has(chosen.id) && !units.includes(chosen.id)) units.push(chosen.id)\n\t\t\tif (!units.length) {\n\t\t\t\tentry.why = 'nothing to claim'\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t\tunits.sort((a, b) => view.indexOf(view.byId(a)!) - view.indexOf(view.byId(b)!))\n\t\t\tfor (const unit of units) {\n\t\t\t\tif (pool.delete(unit)) continue\n\t\t\t\tfor (const prey of preys) {\n\t\t\t\t\tconst hold = this.holds[prey.def.id]\n\t\t\t\t\tconst index = hold.units.indexOf(unit)\n\t\t\t\t\tif (index < 0) continue\n\t\t\t\t\thold.units.splice(index, 1)\n\t\t\t\t\tprey.lost = entry.urgent ? 'urgent' : 'beaten'\n\t\t\t\t\tprey.lostTo = def.id\n\t\t\t\t\tbreak\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tconst money = this.moneyOf(def)\n\t\t// held against the purse from now: nothing of the think spends what the goal holds\n\t\tif (money) ai.purse.reserve(def.id, money)\n\t\tconst commitment = def.commitment ?? this.commitment\n\t\tconst hold: Hold = {\n\t\t\tunits,\n\t\t\t...(money && { money }),\n\t\t\tsince: tick,\n\t\t\tuntil: tick + Math.round(commitment * ai.session.tickRate),\n\t\t\tscore: entry.score\n\t\t}\n\t\tthis.holds[def.id] = hold\n\t\treturn hold\n\t}\n\n\t/** The money a goal names, as a cost: a number is in the game's money */\n\tprivate moneyOf(def: GoalDef): Cost | undefined {\n\t\tconst { ai } = this\n\t\tconst asked = typeof def.claims?.money === 'function' ? def.claims.money(ai) : def.claims?.money\n\t\tif (asked === undefined) return undefined\n\t\tif (typeof asked === 'number') {\n\t\t\tif (!(asked > 0)) return undefined\n\t\t\tconst currency = ai.registry.currency ?? ai.registry.resources[0]?.id\n\t\t\treturn currency === undefined ? undefined : { [currency]: asked }\n\t\t}\n\t\treturn Object.keys(asked).length ? { ...asked } : undefined\n\t}\n\n\t/** What a goal holds, as it is handed to it */\n\tprivate claimedOf(goal: string, hold: Hold, first: boolean): Claimed {\n\t\tconst { ai } = this\n\t\tconst units = new UnitSet(\n\t\t\tai.view,\n\t\t\thold.units.map((id) => ai.view.byId(id)).filter((unit): unit is EntityState => !!unit)\n\t\t)\n\t\t// the goal's squad of that name, kept: called again (each think) it is the same squad, made up with what is given\n\t\tconst squad = (name: string, of: Iterable<EntityState | number>, options: SquadOptions = {}) => {\n\t\t\tconst kept = ai.squads.named(name)\n\t\t\tif (!kept || kept.owner !== goal) return ai.squads.make(name, of, { ...options, owner: goal })\n\t\t\tkept.data.options = { ...ai.squads.defaults, ...options }\n\t\t\treturn kept.add(of)\n\t\t}\n\t\treturn { units, ...(hold.money && { money: hold.money }), began: hold.since, first, squad }\n\t}\n\n\tprivate heldIds(): Set<number> {\n\t\tconst held = new Set<number>()\n\t\tfor (const id in this.holds) for (const unit of this.holds[id].units) held.add(unit)\n\t\treturn held\n\t}\n\n\t/** Every goal as the picker last saw it: score, considerations, what it holds, why it did not run */\n\treport(): GoalReport[] {\n\t\tconst { view } = this.ai\n\t\treturn [...this.entries.values()].map((entry) => {\n\t\t\tconst { def } = entry\n\t\t\tconst hold = this.holds[def.id]\n\t\t\treturn {\n\t\t\t\tid: def.id,\n\t\t\t\tscope: def.scope ?? 'army',\n\t\t\t\tscore: entry.score,\n\t\t\t\tconsiderations: entry.considerations,\n\t\t\t\tpicked: entry.picked,\n\t\t\t\turgent: entry.urgent,\n\t\t\t\t...(hold && {\n\t\t\t\t\theld: {\n\t\t\t\t\t\tunits: hold.units.length,\n\t\t\t\t\t\tids: [...hold.units],\n\t\t\t\t\t\tstrength: view.strength.sum(hold.units.map((id) => view.byId(id)).filter((unit): unit is EntityState => !!unit)),\n\t\t\t\t\t\t...(hold.money && { money: { ...hold.money } }),\n\t\t\t\t\t\tsince: hold.since,\n\t\t\t\t\t\tuntil: hold.until\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t\t...(entry.why && { why: entry.why })\n\t\t\t}\n\t\t})\n\t}\n\n\t/** What is held and on cooldown, for a save */\n\t/** Whether it has anything to remember now: one that does not is left out of a save */\n\tremembers(): boolean {\n\t\treturn this.list().length > 0 || Object.keys(this.all()).length > 0\n\t}\n\n\t/** Gives what the goals remember, the holds and the rest, as plain data for a save of the brain */\n\tsave(): GoalsMemory {\n\t\tconst holds: Record<string, Hold> = {}\n\t\tfor (const id in this.holds) {\n\t\t\tconst hold = this.holds[id]\n\t\t\tholds[id] = { ...hold, units: [...hold.units], ...(hold.money && { money: { ...hold.money } }) }\n\t\t}\n\t\treturn { v: 1, holds, cooldowns: { ...this.cooldowns } }\n\t}\n\n\t/** Takes back what `save` gave: whether it was read */\n\trestore(memory: unknown): boolean {\n\t\tconst given = memory as GoalsMemory | undefined\n\t\tif (!given || typeof given !== 'object' || given.v !== 1) return false\n\t\tthis.holds = {}\n\t\tfor (const id in given.holds ?? {}) {\n\t\t\tconst hold = given.holds[id]\n\t\t\tthis.holds[id] = { ...hold, units: [...(hold.units ?? [])], ...(hold.money && { money: { ...hold.money } }) }\n\t\t}\n\t\tthis.cooldowns = { ...(given.cooldowns ?? {}) }\n\t\treturn true\n\t}\n\n\t/** What the debug tools show: the report, the best, and the picker's numbers */\n\tinspect(): Record<string, unknown> {\n\t\treturn { goals: this.report(), ...(this.best !== undefined && { goal: this.best }) }\n\t}\n}\n\n/** Why a goal stopped, in words, for the decision log */\nfunction stopped(why: StopReason, by: string | undefined): string {\n\tswitch (why) {\n\t\tcase 'beaten':\n\t\t\treturn by ? `beaten by ${by}` : 'beaten'\n\t\tcase 'urgent':\n\t\t\treturn by ? `its units taken by ${by}, urgent` : 'its units taken by an urgent goal'\n\t\tcase 'done':\n\t\t\treturn 'done, or nothing left to run with'\n\t\tcase 'told':\n\t\t\treturn 'its units taken by a rule or a module'\n\t\tcase 'removed':\n\t\t\treturn 'taken out of the brain'\n\t}\n}\n\n/** A number as it is, and 0 for what is none (NaN, infinite): the picker never picks on nonsense */\nconst finite = (x: number) => (Number.isFinite(x) ? x : 0)\n/** A curved value or a score: finite, and nothing under 0 */\nconst positive = (x: number) => (Number.isFinite(x) && x > 0 ? x : 0)\n\n/**\n * The goals module: runs the brain's picker (`ai.goals.think`) in its place among the brain's modules, after what\n * reads the game and before what acts on orders. With goals of its own to add to the brain's\n *\n * @beta\n */\nexport const goals = (defs: GoalDef[] = []): AiModuleDef =>\n\tdefineModule({ id: 'goals', make: (ai: Brain): AiModule => {\n\t\tai.goals.add(...defs)\n\t\treturn {\n\t\t\tid: 'goals',\n\t\t\tphase: 'act',\n\t\t\tthink: () => ai.goals.think()\n\t\t}\n\t} })\n\ndeclare module './area' {\n\tinterface AreaMemories {\n\t\tgoals?: GoalsMemory\n\t}\n}\n"],"mappings":"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"}