Dead Code And Stale Code Register

Dead Code And Stale Code Register

This page is the cleanup map for code that appears dead, stale, unreachable, orphaned, or misleading in rayswaynl/a2waspwarfare.

It is not a delete list. It separates safe comment cleanup from risky broken features and revive candidates so future agents do not accidentally remove useful archaeology or branch-ready systems.

Machine-readable findings live in docs/analysis/dead-code-findings.jsonl. The repeatable source scan lives in docs/analysis/dead-code-reference-scan.ps1, with the latest raw scan output in docs/analysis/dead-code-reference-scan.json.

Scan Snapshot

Latest local scan:

Item	Value
Roots scanned	Missions, Missions_Vanilla, Modded_Missions
Text files scanned	2765
Quoted source references found	3546
Missing quoted references reported	658
Real conflict-marker files found	18
Generated artifacts	docs/analysis/dead-code-reference-scan.json, docs/analysis/dead-code-findings.jsonl

Scanner caveats:

• The scanner intentionally finds leads, not final truth.
• ca\... references are Arma/OA addon paths, not repo-local missing files.
• version.sqf is a generated workflow dependency, not dead code.
• Commented-out references are usually cleanup/documentation candidates, not runtime failures.
• Includes inside subfolders can be relative to the including file, while the first scanner pass resolves quoted paths from the mission root.
• Modded missions are out of the current LoadoutManager release pack path, so modded breakage is real source debt but not necessarily current release breakage.

Classification Rules

Classification	Meaning	Default action
retired-commented-reference	A disabled/commented call points at a missing or old file.	Remove or rewrite comments only after a final source search.
broken-stale-ui-class	A visible config/dialog path points at missing code or stale controls.	Source-check callers, then patch or retire.
orphaned-partial-feature	Some feature wiring exists, but sender/receiver/registration is incomplete.	Do not delete until owner decides retire vs revive.
latent-revive-candidate	Compiled or implemented but no current caller is proven.	Preserve or explicitly retire after branch review.
broken-modded-source-reference	Broken in old/generated/modded mission roots.	Fix only when modded maps re-enter release scope.
generated-file-contract-risk	Looks missing in source but is produced by tooling.	Document and validate workflow, do not delete.
stale-or-malformed-resource-config	Resource/config code appears malformed or outdated.	Runtime/config smoke before editing.

Current Findings

ID	Classification	Evidence	Action
old-map-blink-loop-missing-files	Retired commented reference	Client/Init/Init_Client.sqf:138, :140, :782 reference missing plural blink/add-track files; :139 compiles the live singular Client_BlinkMapIcon.sqf.	Safe comment cleanup only. Keep the singular blink helper.
server-map-blinking-units-commented-missing	Retired commented reference	Server/Init/Init_Server.sqf:593 comments an exec for missing Server_MapBlinkingUnits.sqf.	Treat as retired unless marker authority is redesigned.
stale-rscmenu-upgrade-missing-onload	Broken stale UI class	Rsc/Dialogs.hpp:2425, :2428 keep RscMenu_Upgrade with missing Client/GUI/GUI_Menu_Upgrade.sqf.	Search all dialog callers, then remove/alias to the maintained upgrade menu.
mash-marker-relay-orphaned	Orphaned partial feature	Server compiles MASHMarker.sqf; client receiver compile is commented at Client/Init/Init_Client.sqf:132; sender/receiver PV channels do not form a maintained Chernarus loop.	Decide retire vs revive. MASH tents are not dead.
latent-aibuyunit-server-buy-worker	Latent revive candidate	Server/Init/Init_Server.sqf:10 compiles AIBuyUnit, but stable source search finds no caller; Server_BuyUnit.sqf is an AI/team worker.	Do not delete casually. Needed if AI commander production is revived.
modded-mission-conflict-markers	Broken modded mission sources	18 files under Modded_Missions contain real <<<<<<<, =======, >>>>>>> markers.	Resolve before any modded release. Do not blindly delete sections.
unitcaching-commented-absent-scaffold	Retired commented reference	description.ext:37 comments scripts\unitCaching\description.ext; the folder is absent.	Safe comment cleanup or keep as abandoned optimization note.
common-handlebombs-commented-missing	Retired commented reference	Common/Init/Init_Common.sqf:11 comments missing Common_HandleBombs.sqf.	Safe comment cleanup; live IRS/missile systems are separate.
legacy-config-defenses-commented-missing	Retired commented reference	Defense files call live Config_Defenses_Towns.sqf and retain commented old Config_Defenses.sqf calls.	Safe comment cleanup after branch search.
wasp-commented-action-scaffolds	Retired commented reference, narrow scope	WASP/Init_Client.sqf:7, :12, :21 point at missing old action/key scripts; adjacent WASP action helpers still have uses.	Clean only commented missing hooks unless a full WASP action inventory proves more.
bis-hc-parameter-orphan	Orphan-looking config	Rsc/Parameters.hpp:381 exposes WFBE_C_MODULE_BIS_HC; HC delegation uses WFBE_C_AI_DELEGATION.	Hide/remove or wire a real BIS High Command feature; do not label it as headless-client enablement.
economy-menu-missing-control-writes	Stale UI control writes	GUI_Menu_Economy.sqf:7-8 writes IDC 23004/23005/23006; audited RscMenu_Economy starts at 23002/23003 then 23008+.	Complete IDC inventory, then restore intended controls or remove stale writes.
modded-missing-camp-helper-files	Broken modded source reference	Modded Init_Common.sqf files compile Common_GetTotalCamps*.sqf; scan reports missing helpers in modded roots.	Restore from current source or regenerate modded missions before release.
generated-version-sqf-clean-checkout-risk	Generated-file contract risk	Mission entrypoints include version.sqf; LoadoutManager generates/excludes it.	Keep includes; validate generation workflow on clean checkout.
rsc-clickabletext-soundpush-malformed	Stale or malformed resource config	Rsc/Ressources.hpp:556 has soundPush[] = {, 0.2, 1}; in source and modded copies.	Replace with valid value only after config/dialog smoke.
modded-packaging-disabled-by-tooling	Deferred release scope	Tools/LoadoutManager/ZipManager.cs:16 packages Missions and Missions_Vanilla; SqfFileGenerator.cs:133 says add modded maps later.	Keep disabled until conflict/missing-reference checks pass, or archive old modded roots.

Priority Backlog

Priority	Work	Why
P0	Resolve or archive modded mission conflict markers before re-enabling modded packaging.	Raw merge markers are hard breakage if those missions are shipped.
P0	Verify and fix/remove stale RscMenu_Upgrade.	A dialog onLoad points at a missing file, so any live caller can break player UI.
P1	Decide MASH marker relay fate.	It has real PV wiring residue and could be useful, but it is currently half registered.
P1	Keep AIBuyUnit latent until AI commander production is intentionally merged or retired.	It is dead-looking on stable but valuable for AI commander work.
P1	Audit economy menu IDC 23004/23005/23006.	Stale UI writes can hide broken commander economy controls.
P2	Remove or rationalize safe commented missing references: unitCaching, old blink loop, old bomb handler, old defense helper, WASP commented hooks.	Low-risk bloat cleanup once branch searches are complete.
P2	Document generated version.sqf in every build/release handoff.	Prevent agents from misclassifying a required generated file as missing dead code.
P2	Fix RscClickableText.soundPush after config smoke.	Likely malformed config, but resource classes have wide UI blast radius.

Safe Cleanup Candidates

These are candidates for a future source patch because they are commented and point at absent files:

• Client_BlinkMapIcons.sqf, Client_AddUnitToTrack.sqf old comments.
• Server_MapBlinkingUnits.sqf old comment.
• scripts\unitCaching\description.ext commented include.
• Common_HandleBombs.sqf commented compile.
• Common\Config\Config_Defenses.sqf commented calls.
• WASP\actions\OnArmor\timer.sqf, WASP\KeyDown.sqf, WASP\actions\SitsOnArmor\init.sqf commented hooks.

Before changing source, run a branch-aware search against the target branch and verify generated mission propagation rules. Do not edit Missions_Vanilla directly for gameplay unless the build workflow requires it; source-of-truth rules still apply.

Revive Candidates

Candidate	Why preserve it	Revival gate
MASH marker relay	Useful player-facing map state around mobile respawn.	Sender, server relay, client receiver, marker delete/JIP behavior and PV channel docs must be made coherent.
AIBuyUnit / Server_BuyUnit.sqf	Likely needed by AI commander production branches.	AI production scheduler, funds/cap policy, queue cleanup and Client_BuildUnit drift review.
Old marker blinking loop	Could be useful if map marker ownership is redesigned.	Must not regress current singular Client_BlinkMapIcon behavior.
Modded maps	Community value, but currently conflict-marked and outside release packaging.	Conflict-free source, missing helper restoration, LoadoutManager policy and editor/dedicated smoke.

How To Rerun

From the repo root:

.\docs\analysis\dead-code-reference-scan.ps1

Validate the machine-readable register:

Get-Content .\docs\analysis\dead-code-findings.jsonl | ForEach-Object { $_ | ConvertFrom-Json | Out-Null }

Useful manual follow-up scans:

rg -n "RscMenu_Upgrade|GUI_Menu_Upgrade|AIBuyUnit|Server_MapBlinkingUnits|Client_BlinkMapIcons|Client_AddUnitToTrack" Missions Missions_Vanilla Modded_Missions
rg -n "^\s*(<{7,}|={7,}|>{7,})" Modded_Missions
rg -n "WFBE_C_MODULE_BIS_HC|WFBE_C_AI_DELEGATION|23004|23005|23006" Missions Missions_Vanilla Modded_Missions

Related Pages

• Feature status
• Source fix propagation queue
• Content structure and maps
• Tools and build workflow
• Client UI systems atlas
• Factory and purchase systems atlas
• AI commander autonomy audit

Continue Reading

Previous: Wiki pruning and relevance ledger | Next: Source fix propagation queue

Main map: Home | Status: Progress dashboard | Agent file: docs/analysis/dead-code-findings.jsonl