Home

A2 Wasp Warfare Developer Wiki

Developer documentation for rayswaynl/a2waspwarfare, an Arma 2: Operation Arrowhead 1.64 Warfare / CTI mission and server ecosystem.

This wiki is built for two audiences at once:

Audience	Start here	Why
New human developer	Quickstart	Fast orientation, safe edit rules and reading paths.
AI assistant	Agent context, Arma 2 OA external reference guide, Arma 2 OA compatibility audit, agent-entrypoint.json and agent-context.json	Compact context, OA engine references, compatibility guardrails, page map and high-risk rules.
LLM / agent bootstrap	LLM agent entry pack, agent-entrypoint.json and llms.txt	Fast load order, task bundles and machine-readable entrypoints.
Reviewer	Feature status register	Broken, partial, deferred and missing features.
Hardening implementer	Hardening roadmap, Server authority map, ICBM authority playbook, Economy authority first cut and Attack-wave authority playbook	Source-backed patch order, validation gates and safe implementation notes.
Tester / releaser	Testing workflow, Source fix propagation queue and agent-release-readiness.json	Source checks, generated propagation, smoke packs, RPT logging and release gates.
Mission implementer	SQF code atlas	Compile registry, PVF contract and entrypoint ownership.
Claude collaborator	Agent collaboration protocol and Claude loop goal	Shared claim, handoff, event protocol and Claude's current operating mode.
Steff / project owner	Progress dashboard	One page for current Codex/Claude lanes, event feed and status files.
Docs/platform owner	Knowledge platform roadmap	Canonical docs location, GitHub Pages/MkDocs path and LLM bundle plan.

Click-Through Tours

Use these when you want to read the wiki like a connected handbook instead of jumping through the sidebar.

Tour	Path
First day in the repo	Quickstart -> Architecture overview -> Mission lifecycle -> Lifecycle wait-chain -> Join/disconnect lifecycle -> Parameters/build inputs
Implement a gameplay change	Gameplay atlas -> Towns/camps/capture atlas -> Commander/HQ lifecycle -> Victory/endgame atlas -> Marker cleanup/restoration atlas -> Support/specials/modules atlas -> Construction/CoIn atlas -> Factory/purchase atlas -> Upgrades/research atlas -> Factory queue cleanup -> Server runtime atlas -> Core systems -> Feature status -> Source fix propagation queue
Risk triage shortcut	Feature status -> Pending owner decisions -> Hardening roadmap -> Source fix queue -> Testing workflow
Harden the mission	Feature status -> Pending owner decisions -> Abandoned feature revival -> Paratrooper marker revival -> Hardening roadmap -> PVF dispatch playbook -> Server authority map -> ICBM authority playbook -> Economy authority first cut -> Upgrades/research atlas -> Attack-wave authority playbook -> Integration trust boundary audit -> AntiStack DB audit -> Testing workflow -> Arma 2 OA external reference guide -> Networking/PV -> PV channel index -> Deep-review findings
Trace SQF and networking	SQF atlas -> Function index -> Networking/PV -> PV channel index
Work on UI/HUD	Client UI/HUD/menus -> Client UI systems atlas -> Respawn/death lifecycle -> Gear/loadout/EASA atlas -> Service menu affordability guards -> Tools/build
Coordinate Codex and Claude	Progress dashboard -> Coordination board -> Agent collaboration protocol -> Claude loop goal -> Agent worklog
Bootstrap an LLM agent	LLM agent entry pack -> agent-entrypoint.json -> llms.txt -> agent-context.json -> Feature status -> Progress dashboard

Most content pages now include a Continue Reading block with previous and next links for the main handbook path; a few index and ledger pages use lighter related-link strips.

First Principles

Rule	Details
Source mission	Gameplay edits start in Missions/[55-2hc]warfarev2_073v48co.chernarus.
Generated missions	Missions_Vanilla is the maintained generated/copy target. Modded_Missions exists in-tree, but current LoadoutManager generation/package paths do not actively maintain it.
Script reference	Use Bohemia Interactive Arma 2 OA scripting docs, not Arma 3 assumptions; see Arma 2 OA compatibility audit for the current docs scan.
Windows path trap	Use PowerShell -LiteralPath for [55-2hc] paths because brackets are wildcard syntax.
Current branch docs	Repo mirror lives in PR #2 on docs/developer-wiki-index.

Reading Paths

Task	Pages
Understand startup flow	Architecture overview -> Mission entrypoints -> Lifecycle wait-chain -> Join/disconnect lifecycle -> Parameters/build inputs -> SQF code atlas
Work on networking	Networking and public variables -> Public variable channel index -> SQF code atlas
Work on economy, towns, upgrades or supply	Economy, towns and supply -> Towns/camps/capture atlas -> Economy authority first cut -> Upgrades/research atlas -> Attack-wave authority playbook -> Supply mission architecture -> Supply mission authority cleanup -> Supply mission scan narrowing -> Current supply heli PR
Work on AI/performance	AI, headless and performance -> AI commander autonomy audit -> Performance opportunity sweep, Factory queue cleanup, Hosted server FPS loop sleep, Client skill init idempotency, Supply mission scan narrowing, WASP marker wait cleanup -> HC delegation/failover playbook -> Town AI vehicle safety -> Feature status register
Work on UI/HUD/menus	Client UI, HUD and menus -> Client UI systems atlas -> Respawn/death lifecycle -> UI IDD collision repair -> Gear/loadout/EASA atlas -> Gear template profile filter -> Vehicle cargo equip loop bounds -> Service menu affordability guards
Work on core gameplay	Gameplay systems atlas -> Towns/camps/capture atlas -> Commander/HQ lifecycle -> Victory/endgame atlas -> Marker cleanup/restoration atlas -> Support/specials/modules atlas -> Modules atlas -> Construction and CoIn systems atlas -> Factory and purchase systems atlas -> Upgrades/research atlas -> Factory queue cleanup -> Server gameplay runtime atlas -> Core systems index
Test or release changes	Testing workflow -> Source fix propagation queue -> Arma 2 OA external reference guide -> Arma 2 OA compatibility audit -> Tools/build -> Knowledge platform roadmap -> Hardening roadmap -> PVF dispatch playbook -> Server authority map -> ICBM authority playbook -> Attack-wave authority playbook
Check agent progress	Progress dashboard -> agent-status.json -> agent-events.jsonl
Coordinate agents	LLM agent entry pack -> Progress dashboard -> Coordination board -> Agent worklog -> Codebase coverage ledger -> Claude long-term goal -> Claude loop goal
Understand WASP-specific additions	WASP overlay -> WASP marker wait cleanup -> Feature status register

Current Map

Area	Page
Architecture	Architecture overview, Mission entrypoints
Boot dependencies	Lifecycle wait-chain, Join/disconnect lifecycle, Parameters/build inputs
Inventory	Source inventory, Content structure and maps
Code	Function and module index, SQF code atlas, Variable and naming conventions
Runtime systems	Gameplay systems atlas, Towns/camps/capture atlas, Commander/HQ lifecycle, Victory/endgame atlas, Marker cleanup/restoration atlas, Support/specials/modules atlas, Modules atlas, Construction and CoIn systems atlas, Factory and purchase systems atlas, Upgrades/research atlas, Server gameplay runtime atlas, Respawn/death lifecycle, Core systems index, Economy, towns and supply, Supply mission authority cleanup, Supply mission scan narrowing, AI, headless and performance, AI commander autonomy audit, Performance opportunity sweep, Factory queue cleanup, Hosted server FPS loop sleep, Client skill init idempotency, WASP marker wait cleanup, HC delegation/failover playbook, Town AI vehicle safety
Networking	Networking and public variables, Public variable channel index
UI	Client UI, HUD and menus, Client UI systems atlas, Respawn/death lifecycle, Gear/loadout/EASA atlas, Gear template profile filter, Vehicle cargo equip loop bounds, Service menu affordability guards
WASP additions	WASP overlay, WASP marker wait cleanup
Operations	Tools and build workflow, Parameters/build inputs, Source fix propagation queue, Testing/debugging/release workflow, Knowledge platform roadmap, Arma 2 OA external reference guide, Arma 2 OA compatibility audit, External integrations, Integration trust boundary audit, AntiStack database extension audit
Risk and future work	Feature status register, Source fix propagation queue, Pending owner decisions, Abandoned feature revival, AI commander autonomy audit, Paratrooper marker revival, Performance opportunity sweep, Factory queue cleanup, Hosted server FPS loop sleep, Client skill init idempotency, Respawn/death lifecycle, Supply mission scan narrowing, WASP marker wait cleanup, Commander/HQ lifecycle, Victory/endgame atlas, Commander reassignment call shape, Resistance supply scaffold, UI IDD collision repair, Gear template profile filter, Vehicle cargo equip loop bounds, Service menu affordability guards, Hardening implementation roadmap, PVF dispatch playbook, Server authority migration map, ICBM authority playbook, Economy authority first cut, Towns/camps/capture atlas, Upgrades/research atlas, Supply mission authority cleanup, Attack-wave authority playbook, Testing/debugging/release workflow, HC delegation/failover playbook, Town AI vehicle safety, Deep-review findings, External research reports, Codebase coverage ledger, Wiki quality audit, Documentation implementation plan
LLM and agent entrypoints	LLM agent entry pack, llms.txt, agent-context.json, agent-feature-status.jsonl, agent-hardening-backlog.jsonl, agent-knowledge.jsonl
Agent collaboration	AI assistant developer guide, Arma 2 OA external reference guide, Arma 2 OA compatibility audit, Agent context, Progress dashboard, Coordination board, Agent collaboration protocol, Claude loop goal

Repo Shape

Count	Top-level path
1475	Modded_Missions
787	Missions
786	Missions_Vanilla
199	Tools
42	DiscordBot
16	Extension
3	Guides
3	Mods
2	BattlEyeFilter

Machine Context

• Human-readable agent brief: Agent context
• Machine-readable agent file: agent-context.json
• Machine-readable feature status: agent-feature-status.jsonl
• Machine-readable OA compatibility audit: agent-compatibility-audit.json
• Human-readable progress dashboard: Progress dashboard
• Machine-readable progress file: agent-status.json
• Machine-readable collaboration file: agent-collaboration.json
• Machine-readable release-readiness ledger: agent-release-readiness.json
• Machine-readable hardening backlog: agent-hardening-backlog.jsonl
• Machine-readable test evidence schema: agent-test-plan.schema.json
• External PDF report metadata: external-research-report-manifest.json
• Append-only coordination feed: agent-events.jsonl
• Agent coordination log: Agent worklog

Persistent navigation is provided by _Sidebar.md; shared bottom navigation is provided by _Footer.md.

Continue Reading

Previous: Claude long-term goal | Next: Quickstart

Main map: Home | Fast path: Quickstart | Agent file: agent-context.json