GUER Director V2

GUER Director V2 (AICOM V2 Lane 800)

Source pass: 2026-07-17 against rayswaynl/a2waspwarfare origin/master (Chernarus mission root). Canonical design: docs/design/v2/aicom-v2-800-guer-director.md. Lane is ARMED on current master.

What It Is

The GUER Director is the invisible A-Life layer for the resistance side: a per-town virtual strength ledger, virtual cells moving between towns, and a lightweight assessment/planning brain (reinforce, relief, retake, ambush, patrol). Materialization and dematerialization go through existing town/patrol creation paths so players only ever see ordinary resistance units doing plausible resistance things.

It is the authorized volume writer for GUER autonomous force when the lane is on. Player-funded orders enter through the GUER Commissar Panel; the Director remains materialization authority.

Current Source State (master, 2026-07-17)

Item	Value	Anchor
Implementation	Server/AI/Server_GuerDirector.sqf	main loop, orders, QRF/air paths
Launch	Server/Init/Init_Server.sqf:1109-1111	execVM when lane > 0
Lane switch	AICOMV2_LANE_GUER_DIRECTOR = 1	Init_CommonConstants.sqf:2078 — ARMED
Commissar panel gate	AICOMV2_GDIR_PANEL = 1	Init_CommonConstants.sqf:2094 (requires Director lane)
Design status	Approved for implementation; code live	docs/design/v2/aicom-v2-800-guer-director.md

Doc drift note: older pitch pages and some design comments still say "lane defaults 0 / inert." On current master the SQF default is 1. Prefer this page + constants over pitch text for live posture.

Behaviours (player-visible outcomes)

• Towns remember losses between activation cycles (ledger, not full V1 amnesia).
• Relief / reinforcement can move strength as virtual cells; when they arrive during a fight they materialize as defender waves with a direction.
• Commissar / panel orders (player cash + town funds) queue contracts the Director executes (reinf, QRF insert/gunship/combo, counter-attack, cache/relief/mortar per panel verbs).
• Group-budget stewardship — materializer is budget-aware; denies rather than silently hitting the side group cap.
• Telemetry families — RPT tokens such as GDIR_* / order lines (see Director + RequestGDirPanel.sqf); use HC/server RPT with a current mission-init window when grading soaks.

Related Human Surfaces

• GUER Commissar Panel — WF-menu Town Actions / Economy entry for resistance players.
• GUER air-defense loop — Ka-137 / Mi-24 materialization neighbourhood (panel air kinds use related classes).
• GUER Barrel Bomb call-in — separate kill-gated player support; not Director-owned volume.

Known Implementation Gaps (fresh-eyes, re-verify before patching)

Confidence medium — read-only static review 2026-07-17; not soak-proved in this pass:

1. QRF / counter-attack helis may bypass standard creation hooks — raw createVehicle / group create paths in Server_GuerDirector.sqf air execution (around the QRF class selection for Ka137_MG_PMC / Mi24_P) can miss EHs, cargo clear, and empty-queue handling that WFBE_CO_FNC_CreateVehicle provides.
2. First-cycle survivor blind spot — survivor ratio logic that requires a prior non-zero group count can miss a wipe before the first active tick stores a count (Server_GuerDirector.sqf survivor branch near _lastGrpCount > 0).
3. Town AI GUER group-cap accounting can count non-garrison resistance groups (Director QRF, player groups) against garrison headroom (server_town_ai.sqf group-cap compare) — can starve garrisons under load.

Design Doc Map

Doc	Role
docs/design/v2/aicom-v2-800-guer-director.md	Behaviour contract, ledger/order shapes, conservation, amendments A1/A2
GUER Director living-resistance pitch	Owner pitch (defaults may be stale)
Commander Town Ledger	WEST/EAST sibling ledger (disarmed)

Continue Reading

• Feature status register
• GUER Insurgents faction overview
• GUER insurgent player economy
• AI commander B69 improvement roadmap
• Telemetry families reference (if present)

Edit summary (task wasp-wiki-pages-wave-20260717)

New implementation-status page. Supplements the pitch page with current armed defaults and source anchors. Confidence: high on flags/launch; medium on gap list (static read only).