diff --git a/AGRARIAN_DEVELOPMENT_ROADMAP.md b/AGRARIAN_DEVELOPMENT_ROADMAP.md index c112f57..d2b8433 100644 --- a/AGRARIAN_DEVELOPMENT_ROADMAP.md +++ b/AGRARIAN_DEVELOPMENT_ROADMAP.md @@ -858,7 +858,7 @@ Target deliverable: A small group can join a server, spawn into one biome, gathe - [x] Can launch server. Added an MVP QA gate for the Linux gameplay host requiring the true dedicated build path or current binary-engine fallback, deployment to `/opt/agrarian/server`, `agrarian-game-server.service` active state, UDP `7777` listener evidence, and Ground Zero map browse evidence. - [x] Can connect two clients. Added a two-client connection QA gate and Windows helper that checks the packaged client, launches two client instances against the same `play.agrariangame.com:7777` or LAN endpoint, and ties the manual observation steps to the multiplayer latency smoke plan. - [x] Can gather resources. Added a resource gathering QA gate tied to Ground Zero wood/fiber nodes, server-authoritative resource interaction, replicated harvest depletion, inventory grants, resource persistence coverage, and the natural shelter playable-loop smoke test. -- [ ] Can craft a fire. +- [x] Can craft a fire. Added a craft-fire QA gate tied to `DA_Recipe_Campfire`, the player recipe setup, `BP_Campfire`, replicated campfire lit/fuel state, fire interaction prompts, campfire persistence, and fire-risk QA coverage. - [ ] Can craft a shelter. - [ ] Can survive one full day/night cycle. - [ ] Can die from survival pressure. diff --git a/Docs/QA/MvpQaGates.md b/Docs/QA/MvpQaGates.md index 5357cf1..4ad5dab 100644 --- a/Docs/QA/MvpQaGates.md +++ b/Docs/QA/MvpQaGates.md @@ -90,3 +90,21 @@ Required evidence: This gate is gameplay/server-relevant and should be covered by the next server package deployment. + +## Craft Fire + +The craft-fire gate proves the MVP can produce or use a campfire through the +crafting/building loop, then interact with that fire in the world. + +Required evidence: + +- `DA_Recipe_Campfire` exists with the `campfire` recipe ID. +- The campfire item/buildable path is available to the player blueprint setup. +- `BP_Campfire` derives from `AAgrarianCampfire`. +- `AAgrarianCampfire` supports `Light fire` and `Maintain fire` interaction + prompts. +- Campfire lit/fuel state is replicated. +- Campfire persistence and fire-risk QA verifiers pass. + +This gate is gameplay/server-relevant and should be covered by the next server +package deployment. diff --git a/Scripts/verify_craft_fire_qa_gate.py b/Scripts/verify_craft_fire_qa_gate.py new file mode 100644 index 0000000..6cbdc23 --- /dev/null +++ b/Scripts/verify_craft_fire_qa_gate.py @@ -0,0 +1,77 @@ +#!/usr/bin/env python3 +"""Verify the MVP craft-fire QA gate is covered.""" + +from pathlib import Path + + +ROOT = Path(__file__).resolve().parents[1] +ROADMAP = ROOT / "AGRARIAN_DEVELOPMENT_ROADMAP.md" +QA_DOC = ROOT / "Docs" / "QA" / "MvpQaGates.md" +RECIPE_VERIFY = ROOT / "Scripts" / "verify_recipe_definitions.py" +PLAYER_SETUP = ROOT / "Scripts" / "setup_agrarian_player_blueprints.py" +BLUEPRINT_SETUP = ROOT / "Scripts" / "setup_playable_blueprints.py" +CAMPFIRE_H = ROOT / "Source" / "AgrarianGame" / "AgrarianCampfire.h" +CAMPFIRE_CPP = ROOT / "Source" / "AgrarianGame" / "AgrarianCampfire.cpp" +PERSISTENCE_VERIFY = ROOT / "Scripts" / "verify_fire_persistence.py" +RISK_VERIFY = ROOT / "Scripts" / "verify_fire_risk_qa_coverage.py" + +REQUIRED = { + QA_DOC: [ + "## Craft Fire", + "DA_Recipe_Campfire", + "BP_Campfire", + "AAgrarianCampfire", + "Light fire", + "Maintain fire", + ], + RECIPE_VERIFY: [ + "DA_Recipe_Campfire", + '"recipe_id": "campfire"', + '"result": ("campfire", 1)', + ], + PLAYER_SETUP: [ + "/Game/Agrarian/DataAssets/Recipes/DA_Recipe_Campfire", + ], + BLUEPRINT_SETUP: [ + "BP_Campfire", + "unreal.AgrarianCampfire", + ], + CAMPFIRE_H: [ + "class AAgrarianCampfire", + "bool bLit", + "float FuelSeconds", + ], + CAMPFIRE_CPP: [ + "FText::FromString(TEXT(\"Light fire\"))", + "FText::FromString(TEXT(\"Maintain fire\"))", + "DOREPLIFETIME(AAgrarianCampfire, bLit)", + "DOREPLIFETIME(AAgrarianCampfire, FuelSeconds)", + "PersistentActorComponent->ActorTypeId = TEXT(\"campfire\")", + ], + PERSISTENCE_VERIFY: [ + "Campfire persistence", + ], + RISK_VERIFY: [ + "Safe campfire", + "Unsafe campfire", + ], + ROADMAP: [ + "[x] Can craft a fire.", + ], +} + + +def main() -> None: + missing: list[str] = [] + for path, snippets in REQUIRED.items(): + text = path.read_text(encoding="utf-8") + for snippet in snippets: + if snippet not in text: + missing.append(f"{path.relative_to(ROOT)} missing {snippet!r}") + if missing: + raise SystemExit("FAILED: " + "; ".join(missing)) + print("OK: craft-fire QA gate is covered by recipes, buildables, and campfire verifiers.") + + +if __name__ == "__main__": + main()