Screeps Verification Coverage and Evidence Priorities

Current rule

Evidence strength and coverage completeness stay separate. Without accepted Console or live multi-tick evidence, a path remains unverified; documentation review, offline simulation, or a database row cannot promote it on their own.

Spawn will not spawn

Partial

TargetConsoleCurrent4 accepted record(s)Still missingERR_BUSY · ERR_RCL_NOT_ENOUGH

Capture nextPrioritize ERR_NOT_ENOUGH_RESOURCES, ERR_NAME_EXISTS, ERR_BUSY, and one OK path without generalizing to long-term queue behavior.

SAFE CAPTURE RECIPE

Finish the remaining spawnCreep() branches without changing colony policy

The current public Evidence already covers the Energy-shortage and duplicate-name branches. These recipes target only still-missing branches. Every probe uses dryRun, records scoped before/after state, and fails closed if the observed return code is not the intended branch.

ERR_BUSYNaturally busy Spawn · dryRun only

Safety guardWait for a Spawn that is already spawning through normal colony activity. Do not start or cancel a Creep just to manufacture this branch. The snippet is dryRun-only and fails closed unless it observes ERR_BUSY (-4).

var spawn = Object.values(Game.spawns).find(function (item) {
  return item.my && item.isActive() && Boolean(item.spawning);
});
if (!spawn) throw new Error("No naturally busy owned Spawn; skip this branch for now.");

var name = "LQBusy_" + Game.time;
var body = [MOVE];
var before = EvidenceCapture.snapshot({ spawn: spawn, room: spawn.room });
before.probe = {
  branch: "ERR_BUSY",
  name: name,
  body: body,
  dryRun: true,
  spawnActive: spawn.isActive(),
  spawnBusy: Boolean(spawn.spawning),
  spawningName: spawn.spawning && spawn.spawning.name
};

var rc = spawn.spawnCreep(body, name, { dryRun: true });
if (rc !== ERR_BUSY) {
  throw new Error("Unexpected return code " + rc + "; discard this capture.");
}

var after = EvidenceCapture.snapshot({ spawn: spawn, room: spawn.room });
EvidenceCapture.captureConsole({
  articleSlug: "screeps-spawn-create-creep",
  language: "zh-CN",
  roomName: spawn.room.name,
  apiName: "StructureSpawn.spawnCreep",
  returnCode: rc,
  beforeState: before,
  afterState: after,
  evidenceNote: "A naturally busy owned Spawn returned ERR_BUSY (-4) to an explicit dryRun probe; no additional spawn intent was submitted.",
  label: "SPAWN-BUSY"
});

ERR_RCL_NOT_ENOUGHNaturally inactive Spawn · never downgrade for evidence

Safety guardOnly use an owned Spawn that is already inactive because of the current room state. Never downgrade, unclaim, destroy, or otherwise damage a room to obtain this Evidence. If no such Spawn exists, leave this branch pending.

var spawn = Object.values(Game.spawns).find(function (item) {
  return item.my && item.isActive() === false;
});
if (!spawn) throw new Error("No naturally inactive owned Spawn; leave ERR_RCL_NOT_ENOUGH pending.");

var name = "LQRcl_" + Game.time;
var body = [MOVE];
var before = EvidenceCapture.snapshot({
  spawn: spawn,
  room: spawn.room,
  controller: spawn.room.controller
});
before.probe = {
  branch: "ERR_RCL_NOT_ENOUGH",
  name: name,
  body: body,
  dryRun: true,
  spawnActive: spawn.isActive(),
  controllerLevel: spawn.room.controller && spawn.room.controller.level
};

var rc = spawn.spawnCreep(body, name, { dryRun: true });
if (rc !== ERR_RCL_NOT_ENOUGH) {
  throw new Error("Unexpected return code " + rc + "; discard this capture.");
}

var after = EvidenceCapture.snapshot({
  spawn: spawn,
  room: spawn.room,
  controller: spawn.room.controller
});
EvidenceCapture.captureConsole({
  articleSlug: "screeps-spawn-create-creep",
  language: "zh-CN",
  roomName: spawn.room.name,
  apiName: "StructureSpawn.spawnCreep",
  returnCode: rc,
  beforeState: before,
  afterState: after,
  evidenceNote: "A naturally inactive owned Spawn returned ERR_RCL_NOT_ENOUGH (-14) to a dryRun probe; no room downgrade or spawn intent was performed for evidence collection.",
  label: "SPAWN-RCL-NOT-ENOUGH"
});

A printed bundle is still only captured material. Validate it, review it, then accept it separately; this recipe never changes Evidence status.

Controller downgrade pressure

Partial

TargetLive multi-tickCurrent2 accepted record(s)Still missingtarget evidence level · ERR_NOT_ENOUGH_RESOURCES · ERR_INVALID_TARGET

Capture nextRecord upgradeController() results, Upgrader Energy, Controller progress, ticksToDowngrade, and supply-side state across ticks.

Creep not moving

Unverified

TargetLive multi-tickCurrent0 accepted record(s)Still missingtarget evidence level · ERR_NO_PATH · ERR_TIRED · ERR_NOT_IN_RANGE

Capture nextCapture the real moveTo() result, creep.fatigue, start/end positions, and at least one later tick.

Creep not harvesting

Unverified

TargetLive multi-tickCurrent0 accepted record(s)Still missingtarget evidence level · ERR_NOT_IN_RANGE · ERR_INVALID_TARGET · ERR_NOT_ENOUGH_RESOURCES

Capture nextRecord the harvest() result, target type, WORK parts, resource amount, and later-tick Store/Source changes.

Link not transferring Energy

Unverified

TargetLive multi-tickCurrent0 accepted record(s)Still missingtarget evidence level · ERR_TIRED · ERR_NOT_ENOUGH_RESOURCES · ERR_FULL · ERR_INVALID_TARGET

Capture nextCapture sender/receiver Stores, cooldown, return code, and next-tick state instead of relying on a single screenshot.

VERIFICATION COVERAGE

Coverage is measured against accepted runtime evidence

The registry prioritizes what should be proved next. Current coverage is calculated from structured Runtime Evidence that survives the same accepted + Markdown-accepted public boundary as Diagnostic Center, then matched to each path by canonical API identity.

10planned diagnostic paths2paths with accepted evidence6structured accepted evidence records

Creep not moving

Unverified

Target evidenceLive multi-tick

Current accepted evidenceNo accepted runtime evidence · 0/3 return-code branches

Coverage goal

Cover moveTo(), fatigue, no-path, and range branches, then verify later-tick position or state changes.

Next evidence to capture

Capture the real moveTo() result, creep.fatigue, start/end positions, and at least one later tick.

Creep not harvesting

Unverified

Target evidenceLive multi-tick

Current accepted evidenceNo accepted runtime evidence · 0/3 return-code branches

Coverage goal

Cover harvest() target, range, WORK-part, and resource branches, then verify Store or Source state changes.

Next evidence to capture

Record the harvest() result, target type, WORK parts, resource amount, and later-tick Store/Source changes.

Primary error branches

ERR_NOT_IN_RANGE-9 ERR_INVALID_TARGET-7 ERR_NOT_ENOUGH_RESOURCES-6

Primary API surfaces

creep.harvest(target)

Related object hubs

Creep StructureController StructureSpawn Room Game.market

Useful tools

Creep Body Calculator →Room Snapshot Diagnostic →Controller Downgrade and Upgrader Planner →Market and Terminal Cost Calculator →

Spawn will not spawn

Partial

Target evidenceConsole

Current accepted evidenceConsole · 3/5 return-code branches

Coverage goal

First make the high-frequency spawnCreep() return-code, dryRun, and real-call boundaries reproducible in Console evidence.

Next evidence to capture

Prioritize ERR_NOT_ENOUGH_RESOURCES, ERR_NAME_EXISTS, ERR_BUSY, and one OK path without generalizing to long-term queue behavior.

Primary error branches

ERR_BUSY-4 ERR_NOT_ENOUGH_RESOURCES-6 ERR_INVALID_ARGS-10 ERR_NAME_EXISTS-3 ERR_RCL_NOT_ENOUGH-14

Primary API surfaces

spawn.spawnCreep(body, name, opts?)

Related object hubs

StructureSpawn StructureController Game.market Room

Useful tools

Spawn Queue and Replacement Planner →Creep Body Calculator →Market and Terminal Cost Calculator →Room Snapshot Diagnostic →

Controller downgrade pressure

Partial

Target evidenceLive multi-tick

Current accepted evidenceConsole · 1/3 return-code branches

Coverage goal

Put the Controller, Upgrader, Link/hauling supply, and ticksToDowngrade into one multi-tick evidence chain.

Next evidence to capture

Record upgradeController() results, Upgrader Energy, Controller progress, ticksToDowngrade, and supply-side state across ticks.

Primary error branches

ERR_NOT_IN_RANGE-9 ERR_NOT_ENOUGH_RESOURCES-6 ERR_INVALID_TARGET-7

Primary API surfaces

creep.upgradeController(controller)link.transferEnergy(target, amount?)

Related object hubs

StructureController Creep StructureLink Store Room

Useful tools

Controller Downgrade and Upgrader Planner →Room Snapshot Diagnostic →Creep Body Calculator →Market and Terminal Cost Calculator →

Link not transferring Energy

Unverified

Target evidenceLive multi-tick

Current accepted evidenceNo accepted runtime evidence · 0/4 return-code branches

Coverage goal

Cover cooldown, sender stock, receiver capacity, and the real transferEnergy() result, then verify both Stores on the next tick.

Next evidence to capture

Capture sender/receiver Stores, cooldown, return code, and next-tick state instead of relying on a single screenshot.

Primary error branches

ERR_TIRED-11 ERR_NOT_ENOUGH_RESOURCES-6 ERR_FULL-8 ERR_INVALID_TARGET-7

Primary API surfaces

link.transferEnergy(target, amount?)

Related object hubs

StructureLink Store Room Creep StructureSpawn

Useful tools

Room Snapshot Diagnostic →Hauling Throughput Planner →Creep Body Calculator →Market and Terminal Cost Calculator →

Market action failed

Unverified

Target evidenceConsole

Current accepted evidenceNo accepted runtime evidence · 0/2 return-code branches

Coverage goal

Use controlled Console cases to confirm argument, Credits, Terminal, and transaction-Energy boundaries without generalizing one trade into a market strategy claim.

Next evidence to capture

Prefer low-risk, reversible, or read-only checks; when a real transaction is required, verify only the smallest explicit case and record limitations.

Primary error branches

ERR_NOT_ENOUGH_RESOURCES-6 ERR_INVALID_ARGS-10

Primary API surfaces

Game.market.deal(orderId, amount, roomName?)Game.market.createOrder(params)terminal.send(resourceType, amount, destination, description?)

Related object hubs

Game.market StructureTerminal Store Room StructureSpawn

Useful tools

Market and Terminal Cost Calculator →Creep Body Calculator →Room Snapshot Diagnostic →

CPU usage too high

Unverified

Target evidenceLive multi-tick

Current accepted evidenceNo accepted runtime evidence

Coverage goal

Use multi-tick CPU/bucket and hotspot measurements to prove the performance problem and the effect of changes instead of concluding from one tick.

Next evidence to capture

Record Game.cpu.getUsed() section measurements, bucket, workload size, and before/after comparisons across multiple ticks.

Primary error branches

No single return-code branch defines this path.

Primary API surfaces

Game.cpu.getUsed()PathFinder.search(origin, goal, opts?)

Related object hubs

Room PathFinder Creep

Useful tools

Room Snapshot Diagnostic →

Resources not moving

Unverified

Target evidenceLive multi-tick

Current accepted evidenceNo accepted runtime evidence · 0/5 return-code branches

Coverage goal

Connect withdraw/pickup, movement, transfer, and source/carrier/destination Stores into one complete multi-tick logistics evidence chain.

Next evidence to capture

Store withdraw, pickup, moveTo, and transfer results separately and track source, Creep, and destination Stores across ticks to locate the broken logistics stage.

Primary error branches

ERR_NOT_ENOUGH_RESOURCES-6 ERR_FULL-8 ERR_NOT_IN_RANGE-9 ERR_NO_PATH-2 ERR_TIRED-11

Primary API surfaces

creep.withdraw(target, resourceType, amount?)creep.pickup(resource)creep.transfer(target, resourceType, amount?)creep.moveTo(target, opts)

Related object hubs

Creep Store PathFinder Room StructureSpawn

Useful tools

Hauling Throughput Planner →Room Snapshot Diagnostic →Creep Body Calculator →Market and Terminal Cost Calculator →

Builder not building or repairing

Unverified

Target evidenceLive multi-tick

Current accepted evidenceNo accepted runtime evidence · 0/4 return-code branches

Coverage goal

Cover build()/repair() results, WORK parts, Energy, target type, and later Construction Site progress or structure hits changes.

Next evidence to capture

Record build/repair results, Creep Energy, WORK parts, target starting state, and at least one later tick of progress or hits.

Primary error branches

ERR_NOT_IN_RANGE-9 ERR_NOT_ENOUGH_RESOURCES-6 ERR_INVALID_TARGET-7 ERR_NO_BODYPART-12

Primary API surfaces

creep.build(target)creep.repair(target)

Related object hubs

Creep Store Room StructureController StructureSpawn

Useful tools

Creep Body Calculator →Room Snapshot Diagnostic →Controller Downgrade and Upgrader Planner →Market and Terminal Cost Calculator →

Tower not attacking, healing, or repairing

Unverified

Target evidenceLive multi-tick

Current accepted evidenceNo accepted runtime evidence · 0/2 return-code branches

Coverage goal

Cover Tower attack/heal/repair results, Energy, targets, and later state; treat range as an output factor rather than a substitute for runtime evidence.

Next evidence to capture

Prefer controlled repair or heal cases with action result, Tower Energy, target hits, and a later tick; add attack evidence only when it occurs naturally and can be recorded clearly.

Primary error branches

ERR_NOT_ENOUGH_RESOURCES-6 ERR_INVALID_TARGET-7

Primary API surfaces

tower.attack() / heal() / repair()room.getEventLog(raw?)

Related object hubs

StructureTower Store Room StructureSpawn Game.market

Useful tools

Tower Damage, Heal, and Repair Calculator →Room Snapshot Diagnostic →Creep Body Calculator →Market and Terminal Cost Calculator →