Cleared stale STANDBY markers, swept dead DISCUSSION.md pointers, disambiguated overlapping personas, corrected asset-gen paths. Armed 7 discussion agents (gestalt/gore/mellanie/miri/nigel/ozzie/paula) with Bash so they can run the pql preamble. Integrated inigo into the roster + briefing (audio, standby). Removed tiger — localization dropped from scope (R-013). Part of T-1099. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
4.1 KiB
4.1 KiB
title, description, type, status, agent, updated
| title | description | type | status | agent | updated |
|---|---|---|---|---|---|
| Hoshe - Project Briefing | QA and test infrastructure agent — owns generator output validation, integration tests, content schema validation, and legibility test criteria for the v0.2 generator spike | briefing | active | Hoshe | 2026-03-13 |
Hoshe - Project Briefing
Last updated: 2026-03-13
Current Project State
Check active work: pql ticket list --status in_progress
Check your tickets: pql ticket list --assigned hoshe
Status
ACTIVE. Test infrastructure from earlier sprints is operational. v0.2 focus: generator output validation — can the generator produce legible NPCs? Are relationships readable from generator output?
Decisions Relevant to Your Role
Read decisions/architecture.md (D-010, D-020, D-030) and decisions/perception.md (D-011, D-017, D-018). Key decisions:
- D-010: Information boundaries — testable? Can we verify information never leaks?
- D-020: MessagePack serialization — correct round-trip? No data loss at protocol boundary?
- D-030: Testability architecture (hybrid Rust tests, gdUnit4, three-layer IPC, CauseChain)
- D-119: Generator spike — Phase 5 per D-166 cascade (not imminent). Success criterion: "can the player read NPC relationships from generator output?" Hoshe defines and verifies this criterion.
What's Been Delivered (Sprints 2-4)
Test infrastructure now in place:
- Integration test: tile type data in live server mode (#410, Sprint 4)
- Integration test: input roundtrip through live server (#411, Sprint 4)
- Knowledge graph unit test suite (#367, Sprint 2)
make validate-contentCLI (#392, Sprint 3)
Content pipeline (testable surface):
- YAML content loader Phase 2 (#408) — content loading is live
- Content schema definitions (#386) — validation rules exist
- Global knowledge files (#388) — canonical FactId source for validation
- Line previewer CLI (#407) — can verify content loads without errors
Current Priorities
Consult docs/sprints/ for active sprint briefing.
Generator spike validation (v0.2 critical path):
- Generator output legibility test plan — define what "can the player read NPC relationships from generator output?" means as a testable criterion. Produce test plan before the Sprint 25 generator spike begins.
- NpcBlueprint struct tests — when Tyre delivers the NpcBlueprint struct design, write unit tests verifying the 10-axis model (D-024) is correctly encoded in generator output.
- Generated NPC relationship readability test — functional test: given a generated location with generated NPCs, can a blind observer describe social relationships correctly? Design the test protocol.
Infrastructure maintenance:
- Verify existing integration tests still pass — regression check after any architectural changes
- Test harness improvements — reusable fixtures for server+client pairs
- Dedicated test map — minimal map for routing, pathfinding, visibility, protocol correctness (not dependent on hand-authored content)
- Edge case coverage — malformed packets, disconnects, entities at map edges, interactions at max range
Development Workflow
See docs/DEVOPS.md for full procedures. Your key targets:
make test— run all tests (server + client)make test-server— Rust unit + integration testsmake test-client— gdUnit4 tests (headless runner pending)make lint— run all lintersmake ci— full CI pipeline locally (lint -> build -> test)make validate-content— content schema validation- Server tests:
server/(inline#[cfg(test)]+tests/directory per D-030) - Client tests:
client/(gdUnit4 per D-030) - Cross-boundary tests:
tests/(IPC fixtures, serialization round-trips) - Test caches:
.cache/(gitignored, cleared bymake clean)
Key Documents
- decisions/ — domain-split decision files (see decisions/README.md for index)
- docs/DEVOPS.md — build, test, lint, CI procedures
- docs/sprints/ — current sprint briefings
- docs/workshops/wheres-the-fun/workshop-outcomes.md — v0.2 success criteria context
- tests/ — integration and end-to-end tests
- TEAM.md — team roster