docs(workshops): complete Knowledge Graph & Information Boundaries workshop

Two-round workshop producing D-041 (Knowledge Graph Data Model):
- Round 1: independent analyses from Dudley, Gestalt, SI, Tyre, Paula
- Round 2: synthesis resolving debates + Gestalt mechanics validation

Key decisions:
- 4-level confidence hierarchy (Suspects < KnowsOf < KnowsDetails < Direct)
- BTreeMap for deterministic iteration (D-010 principle 4)
- Per-entity Component model, not centralized Resource
- StableEntityId + EntityRegistry for save/load stability (partial Q-019)
- Sprint 2 stub: structs + direct observation + basic decay (~6.5 dev-days)

Resolved Q-016 (knowledge hierarchy), raised Q-024/Q-025/Q-026.
Created tickets #361-#368 under epic #351, reconciled #49 children.
Updated sprint 2 briefings, agent briefings, and decision files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/briefings/dudley.md

@@ -2,7 +2,7 @@
 Last updated: 2026-02-11
 
 ## Current Project State
-The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 40 confirmed decisions, 17 discussion rounds + 1 workshop complete. Engine selected (D-020: Rust/bevy_ecs server). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete.
+The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 41 confirmed decisions, 17 discussion rounds + 2 workshops complete. Engine selected (D-020: Rust/bevy_ecs server). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete. Knowledge Graph & Information Boundaries Workshop complete (D-041).
 
 ## Status
 STANDBY. This briefing will be populated when backend/engine implementation begins.
@@ -27,10 +27,11 @@ See `docs/DEVOPS.md` for full procedures. Your key targets:
 - Server code lives in `server/` — unit tests inline with `#[cfg(test)]`, integration tests in `server/tests/`
 - Cross-boundary IPC fixtures in `tests/`
 
-### Workshop Decisions (Content Gap Analysis — relevant to server)
+### Workshop Decisions (relevant to server implementation)
 - **D-034: THE FRIEND ECS spec** — 14 ECS components defined for production-level NPCs (NpcIdentity, Want, Secret, Relationships[3], ToleranceThreshold, DailyRoutine, InformationInventory, Contentment, PersonalityTraits, TellState, SkillSet, AccessTierMap, TriangleMembership, MoodState)
 - **D-035: Converged tag taxonomy (6+3)** — dialogue selection pipeline: access (hard filter) → situation (context filter) → trust (hard filter) → mood+topic (weighted selection). Server implements pipeline.
 - **D-038: Audio architecture** — event-driven: SoundEventEmitter → ObserverSnapshot → SoundRenderer. Server emits sound events.
+- **D-041: Knowledge Graph Data Model** — Per-entity `KnowledgeGraph` Component with BTreeMap storage (deterministic). 4-level confidence hierarchy (Suspects/KnowsOf/KnowsDetails/Direct). StableEntityId + EntityRegistry for stable entity references. Event-driven updates via KnowledgeEventQueue. Sprint 2 scope: data structures + direct observation + basic decay + observer snapshot integration (#112). Canonical Rust structs at `docs/workshops/knowledge-graph-information-boundaries/round2-synthesis.md` Part 3.
 
 ## Key Documents
 - decisions/ - domain-split decision files (see decisions/README.md for index)

docs/briefings/gestalt.md

@@ -2,7 +2,7 @@
 Last updated: 2026-02-11
 
 ## Current Project State
-The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 40 confirmed decisions, 17 discussion rounds + 1 workshop complete. Engine selected (D-020). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete — tag taxonomy converged, FRIEND ECS spec defined, audio architecture designed, previewer scoped.
+The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 41 confirmed decisions, 17 discussion rounds + 2 workshops complete. Engine selected (D-020). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete — tag taxonomy converged, FRIEND ECS spec defined, audio architecture designed, previewer scoped. Knowledge Graph & Information Boundaries Workshop complete (D-041) — Q-016 resolved.
 
 ## Status
 **ACTIVE.** Systems specification work unblocked. Tag taxonomy needs formalization as standalone document. Knowledge state vocabulary blocks Mellanie's monologue authoring. 17 content-supporting systems identified, 0 built — significant server-side work ahead.
@@ -34,6 +34,7 @@ The Settled Reach: top-down immersive sim, single-character perspective, asymmet
 - **D-033: Entity color** — client-side derivation from RelationshipState + knowledge state. Not an NPC property.
 - **D-038: Audio architecture** — event-driven: SoundEventEmitter → ObserverSnapshot → SoundRenderer with AudioAssetRegistry + VisualSoundIndicator + AmbientManager. Events first, assets second.
 - **D-039: 6 wow moments** — systems must support all 6 (observation triggers, FRIEND contradiction staging, divergence reveal, ticker display, idle monologue).
+- **D-041: Knowledge Graph Data Model** — 4-level confidence hierarchy: Suspects < KnowsOf < KnowsDetails < Direct. Resolves Q-016. Maps to D-028 access tiers and D-035 prerequisite tags. Per-entity KnowledgeGraph Component with BTreeMap storage. KnowledgeState enum supports contradiction detection for THE FRIEND arc (D-034). Sprint 2 scope: data structures + direct observation + basic decay.
 
 ## Open Questions Assigned to You
 - Q-002: v0.1 scope definition (co-lead)
@@ -44,14 +45,16 @@ The Settled Reach: top-down immersive sim, single-character perspective, asymmet
 - Q-013: Line previewer temporal progression (co-lead with Dudley)
 - Q-014: Audio timing with monologue chime (co-lead with Ozzie)
 - Q-015: Generation expansion for FRIEND content (co-lead with Mellanie)
-- Q-016: Knowledge hierarchy for prerequisites (co-lead with Paula)
+- Q-016: Knowledge hierarchy for prerequisites — **RESOLVED** (D-041)
 - Q-017: Triangle pressure threshold (co-lead with Paula)
+- Q-024: Gossip propagation timing (co-lead with Tyre) — preferred direction: queued
+- Q-026: Contradiction detection algorithm (co-lead with Paula, Dudley)
 
 ## Current Priorities
 **Systems specification → server implementation support → previewer**
 
 1. **Lock tag taxonomy + line pool format** — formalize Round 2 converged schema as standalone spec document. Reference for all content authors.
-2. **Knowledge state vocabulary** — define v0.1 knowledge flags (e.g., `knows: smuggling_operation`, `met: kael_davan`). Blocks Mellanie's monologue prerequisite authoring. Co-lead with Dudley.
+2. **Knowledge state vocabulary** — **UNBLOCKED** by D-041. Use 4-level confidence hierarchy (suspects/knows_of/knows_details) plus FactId format (`category.topic`). See D-041 Appendix A for v0.1 vocabulary and prerequisite format.
 3. **Dialogue selection pipeline specification** — formalize the 4-layer filter algorithm for server implementation.
 4. **Sound event system architecture** — formalize Round 2 section 6 for Dudley.
 5. **Line previewer (#193) MVP scope** — 7 must-have features. Build as first implementation of dialogue pipeline (shares 80% code). Rust CLI.

docs/briefings/paula.md

@@ -2,7 +2,7 @@
 Last updated: 2026-02-11
 
 ## Current Project State
-The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 40 confirmed decisions, 17 discussion rounds + 1 workshop complete. Engine selected (D-020). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete — NPC web reconciled, THE FRIEND designed, dependency chain established.
+The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 41 confirmed decisions, 17 discussion rounds + 2 workshops complete. Engine selected (D-020). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete — NPC web reconciled, THE FRIEND designed, dependency chain established. Knowledge Graph & Information Boundaries Workshop complete (D-041) — knowledge vocabulary unblocked for content authoring (#309).
 
 ## Status
 **ACTIVE.** Critical path owner. The Dual Lens Authoring Guide (#261) is the single biggest blocker in the project — everything downstream depends on it.
@@ -27,6 +27,7 @@ The Settled Reach: top-down immersive sim, single-character perspective, asymmet
 - **D-036: Sova Transit District** — 15 NPCs with Krenn System names (your Round 2 web is canonical)
 - **D-037: Contraband = unlicensed lattice components** — smuggling access, not weapons (moral ambiguity confirmed)
 - **D-039: All 6 wow moments in scope** — THE FRIEND contradiction is wow moment #3
+- **D-041: Knowledge Graph Data Model** — 4-level confidence hierarchy resolves Q-016. Knowledge vocabulary for content authoring (#309) defined at synthesis Appendix A. Prerequisite format: `knowledge: [{subject, flag, level}]` where level = suspects/knows_of/knows_details. FactId format: `category.topic`. Supports THE FRIEND contradiction detection (Contradicted state, monologue trigger, relationship shift to PersonOfInterest).
 
 ## Your Relationship Web (Canonical — Round 2)
 15 NPCs, 5 triangles:
@@ -40,8 +41,9 @@ Distribution: 3 flat (Pael, Ren, Tev), 7 mundane triangle, 4-5 entangled.
 
 ## Open Questions Assigned to You
 - Q-011: Character selection roster for prototype (co-lead with Miri)
-- Q-016: Knowledge hierarchy for monologue prerequisites (co-lead with Gestalt)
+- Q-016: Knowledge hierarchy for monologue prerequisites — **RESOLVED** (D-041)
 - Q-017: Triangle pressure threshold (co-lead with Gestalt)
+- Q-026: Contradiction detection algorithm (co-lead with Gestalt, Dudley)
 
 ## Current Priorities
 **Critical path: Dual Lens Guide → Voice Patterns → THE FRIEND profiles → NPC profiles → Review**
@@ -49,6 +51,7 @@ Distribution: 3 flat (Pael, Ren, Tev), 7 mundane triangle, 4-5 entangled.
 1. **Dual Lens Authoring Guide (#261) — full draft** (blocks everything downstream)
    - Refined outline from workshop: 6 parts including THE FRIEND section
    - Must include: emotional divergence moments, access tier shift paths, authoring checklist with display context tags
+   - **Knowledge prerequisite format** now available: see D-041 Appendix A for v0.1 vocabulary and prerequisite syntax
 2. **THE FRIEND: Kael Davan — full Tier 1 profile** (needs DLG)
 3. **THE FRIEND: Sera Venn — full Tier 1 profile** (needs DLG)
 4. **Character voice speech patterns** (co-deliver with Mellanie)

docs/briefings/si.md

@@ -2,7 +2,7 @@
 Last updated: 2026-02-11
 
 ## Current Project State
-The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 40 confirmed decisions, 17 discussion rounds + 1 workshop complete. Engine selected (D-020). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete — ~50 tickets identified across 7 categories.
+The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 41 confirmed decisions, 17 discussion rounds + 2 workshops complete. Engine selected (D-020). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete — ~50 tickets identified across 7 categories. Knowledge Graph & Information Boundaries Workshop complete (D-041) — Sprint 2 ticket impact requires reconciliation with existing #49 epic children.
 
 ## Decisions Relevant to Your Role
 All decisions across all domains. Read `decisions/README.md` for the index. Query decisions DB for sprint planning:
@@ -16,16 +16,24 @@ make decisions-active     # List all active decisions
 All open questions - tracks as tickets for assignment and progress monitoring.
 
 ## Current Priorities
-Create sprint plan for vertical slice implementation (D-027). Break D-024 through D-040 into tickets. Workshop output (`docs/workshops/content-gap-analysis_v0_1/SUMMARY.md`) contains ~50 deduplicated ticket proposals across 7 categories. Track dependencies:
+Create sprint plan for vertical slice implementation (D-027). Break D-024 through D-041 into tickets. Workshop output (`docs/workshops/content-gap-analysis_v0_1/SUMMARY.md`) contains ~50 deduplicated ticket proposals across 7 categories. Track dependencies:
 - Paula's Dual Lens Authoring Guide (#261) — critical path, blocks all downstream content
 - Miri's contraband spec + Sova texture appendix (blocks Mellanie)
-- Gestalt's tag taxonomy spec + knowledge state vocabulary (blocks content authoring)
+- Gestalt's tag taxonomy spec + knowledge state vocabulary — **UNBLOCKED by D-041** (Appendix A provides v0.1 vocabulary)
 - Hoshe's test plans (must precede implementation)
 - NPC ECS model (blocks template instantiation)
 - Template system (blocks dialogue system)
+- **Knowledge graph system (D-041)** — Sprint 2 priority, blocks #112, #358, #356. Requires ticket reconciliation with #49 epic.
 
 Vertical slice implementation + content authoring are now parallel workstreams — coordinate with Team Leader on sequencing and resourcing.
 
+### Knowledge Graph Workshop Ticket Impact (D-041)
+See synthesis Part 8 for full details. Key actions:
+1. **Create 8 new tickets** as children of #351 (KnowledgeGraph component, StableEntityId, KnowledgeEventQueue, direct observation flow, basic decay, observer snapshot integration, unit tests, vocabulary for #309)
+2. **Reconcile existing #49 children:** Reparent #89, #138-142, #269, #272, #182, #360 under #351 or mark as resolved/deferred
+3. **Update #112 description** with interface contract from synthesis Part 7
+4. **Update sprint 2 dependencies:** KnowledgeGraph blocks #112, StableEntityId blocks #360, observer snapshot integration blocks #358/#356
+
 ## Development Workflow
 See `docs/DEVOPS.md` for full procedures. Key awareness for sprint planning:
 - `make ci` must pass before any PR merges — definition of done includes CI green

docs/briefings/tyre.md

@@ -2,7 +2,7 @@
 Last updated: 2026-02-11
 
 ## Current Project State
-The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 40 confirmed decisions, 17 discussion rounds + 1 workshop complete. Engine selected (D-020: Godot + Rust/bevy_ecs subprocess). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete.
+The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 41 confirmed decisions, 17 discussion rounds + 2 workshops complete. Engine selected (D-020: Godot + Rust/bevy_ecs subprocess). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete. Knowledge Graph & Information Boundaries Workshop complete (D-041) — architectural foundation for information boundaries system defined.
 
 ## Decisions Relevant to Your Role
 Read `decisions/architecture.md` (primary) and `decisions/perception.md` (secondary). Key decisions:
@@ -11,21 +11,27 @@ Read `decisions/architecture.md` (primary) and `decisions/perception.md` (second
 - **D-026:** Simulation tier budgets (Active 30-80 NPCs, Background 500-2K, State-saved 10K+)
 - **D-030:** Testability architecture (hybrid test org, gdUnit4, CauseChain, three-layer IPC testing)
 - **D-031:** Time system (10 ticks = 1 game-minute, 4 day phases)
+- **D-041:** Knowledge Graph Data Model — **BTreeMap mandate** (not HashMap) per D-010 principle 4. Per-entity KnowledgeGraph Component. 4-level confidence hierarchy. StableEntityId + EntityRegistry for stable entity references. Event-driven updates. Performance budget: ~6 MB live memory for 80 Active + 2K Background NPCs. Canonical Rust structs at `docs/workshops/knowledge-graph-information-boundaries/round2-synthesis.md` Part 3. Sprint 2 deliverable: ~6.5 developer-days.
 
 ## Open Questions Assigned to You
 - ~~Q-001: Engine selection~~ — **Resolved** as D-020 (Godot 4 + Rust/bevy_ecs via subprocess/IPC)
 - Q-002: v0.1 scope definition (co-lead)
 - Q-005: Prototype scale (co-lead with Gestalt, Miri)
 - Q-007: Target platforms
+- Q-021: Tick budget overflow policy (co-lead with Dudley)
+- Q-022: NPC pathfinding cache eviction (co-lead with Dudley)
+- Q-024: Gossip propagation timing (co-lead with Gestalt) — preferred direction: queued
+- Q-025: Knowledge graph cap and eviction strategy (co-lead with Dudley)
 
 ## Current Priorities
 Vertical slice technical implementation:
 1. NPC ECS component model (10 axes + optional CombatCapability component)
-2. Template instantiation system (single-ownership + reference links with metadata)
-3. Simulation tier transitions (timestamp LRU + scope tags + bevy_ecs component add/remove)
-4. Access tier system (content filtering by tier 0-3)
-5. Basic cargo/goods system (for smuggling ring mechanics)
-6. Line previewer CLI (weekend build — YAML templates → trait-modified line pools)
+2. **Knowledge Graph Data Model (D-041)** — Sprint 2 priority. Implement canonical Rust structs from workshop synthesis. BTreeMap for deterministic iteration (non-negotiable). StableEntityId + EntityRegistry. KnowledgeEventQueue. Direct observation flow. Basic decay. Observer snapshot integration (#112). ~6.5 developer-days. Blocks #352 (Observer Snapshot Pipeline Workshop).
+3. Template instantiation system (single-ownership + reference links with metadata)
+4. Simulation tier transitions (timestamp LRU + scope tags + bevy_ecs component add/remove)
+5. Access tier system (content filtering by tier 0-3)
+6. Basic cargo/goods system (for smuggling ring mechanics)
+7. Line previewer CLI (weekend build — YAML templates → trait-modified line pools)
 
 **Future flag:** Base builder DLC requires data model stub now: `modifications: Vec<Modification>` on relevant entities. Add to schema early.