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 and agent-context.json	Compact context, page map and high-risk rules.
Reviewer	Feature status register	Broken, partial, deferred and missing features.
Hardening implementer	Hardening roadmap, Server authority map, Economy authority first cut and Attack-wave authority playbook	Source-backed patch order, validation gates and safe implementation notes.
Tester / releaser	Testing workflow	Source checks, 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.

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
Implement a gameplay change	Gameplay atlas -> Construction/CoIn atlas -> Factory/purchase atlas -> Server runtime atlas -> Core systems -> Feature status
Harden the mission	Feature status -> Pending owner decisions -> Hardening roadmap -> PVF dispatch playbook -> Server authority map -> Economy authority first cut -> Attack-wave authority playbook -> Testing workflow -> 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 -> Gear/loadout/EASA atlas -> Tools/build
Coordinate Codex and Claude	Progress dashboard -> Coordination board -> Agent collaboration protocol -> Claude loop goal -> Agent worklog

Every content page now includes a Continue Reading block with previous and next links for the main handbook path.

First Principles

Rule	Details
Source mission	Gameplay edits start in Missions/[55-2hc]warfarev2_073v48co.chernarus.
Generated missions	Missions_Vanilla and Modded_Missions are generated/copied targets managed by Tools/LoadoutManager.
Script reference	Use Bohemia Interactive Arma 2 OA scripting docs, not Arma 3 assumptions.
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 -> SQF code atlas
Work on networking	Networking and public variables -> Public variable channel index -> SQF code atlas
Work on economy or supply	Economy, towns and supply -> Economy authority first cut -> Attack-wave authority playbook -> Supply mission architecture -> Current supply heli PR
Work on AI/performance	AI, headless and performance -> 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 -> Gear/loadout/EASA atlas
Work on core gameplay	Gameplay systems atlas -> Modules atlas -> Construction and CoIn systems atlas -> Factory and purchase systems atlas -> Server gameplay runtime atlas -> Core systems index
Test or release changes	Testing workflow -> Tools/build -> Hardening roadmap -> PVF dispatch playbook -> Server authority map -> Attack-wave authority playbook
Check agent progress	Progress dashboard -> agent-status.json -> agent-events.jsonl
Coordinate agents	Progress dashboard -> Coordination board -> Agent worklog -> Codebase coverage ledger -> Claude long-term goal -> Claude loop goal
Understand WASP-specific additions	WASP overlay -> Feature status register

Current Map

Area	Page
Architecture	Architecture overview, Mission entrypoints
Boot dependencies	Lifecycle wait-chain
Inventory	Source inventory, Content structure and maps
Code	Function and module index, SQF code atlas, Variable and naming conventions
Runtime systems	Gameplay systems atlas, Modules atlas, Construction and CoIn systems atlas, Factory and purchase systems atlas, Server gameplay runtime atlas, Core systems index, Economy, towns and supply, AI, headless and performance, 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, Gear/loadout/EASA atlas
WASP additions	WASP overlay
Operations	Tools and build workflow, Testing/debugging/release workflow, External integrations
Risk and future work	Feature status register, Pending owner decisions, Hardening implementation roadmap, PVF dispatch playbook, Server authority migration map, Economy authority first cut, 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
Agent collaboration	AI assistant developer guide, 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
• Human-readable progress dashboard: Progress dashboard
• Machine-readable progress file: agent-status.json
• Machine-readable collaboration file: agent-collaboration.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