cybersecurity/BreakEscape
1
0
Fork 0
mirror of https://github.com/cliffe/BreakEscape.git synced 2026-02-21 11:18:08 +00:00
Code Issues Packages Projects Releases Wiki Activity
716 Commits 48 Branches 0 Tags
7a69835e14e1587296c2ec29e644ea83c65eeb73
Commit Graph

716 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Z. Cliffe Schreuders
7a69835e14 Add Agent 0x99 phone support dialogue script for Mission 4 
Created m04_phone_agent0x99.ink (510 lines) - strategic guidance system
providing event-triggered phone support throughout the mission.

Key features:
- Handler confidence tracking (0-100) affecting dialogue tone
- Event-triggered conversations (server room, attack identified)
- Adaptive guidance based on player progress and choices
- Player-initiated help system (priorities, intel, tactical hints)
- Voltage capture vs. speed guidance for final phase
- Multi-stage mission progression support

Implements dialogue planning from Stage 6 for Agent 0x99 phone contact.
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
fe4ff43518 Create Robert Chen Ink dialogue script (Mission 4) 
Complete multi-stage conversation system for facility manager:
- 402 lines with extensive branching dialogue
- 2 major conversations: initial meeting + SCADA discovery
- Early reveal option (player can reveal mission immediately)
- Forced reveal path (mission revealed during SCADA investigation)
- Trust system tracking (chen_trust_level 0-100)

Key conversation paths:
1. Initial Meeting (Task 1.2):
   - Multiple player approach styles (professional, apologetic, direct)
   - Optional early mission reveal
   - OptiGrid maintenance discussion
   - Provides Level 1 keycard

2. SCADA Anomaly Discovery (Task 1.4):
   - Technical explanation of threat
   - Mission reveal (if not done earlier)
   - Chen becomes ally
   - Suggests server room investigation

Variables tracked:
- chen_trust_level (affects cooperation throughout mission)
- revealed_mission (changes dialogue branches)
- chen_is_ally (activates support features)
- scada_threat_confirmed (objective progression)

Estimated voice lines: 120-140 (Chen's most complex dialogue)

Progress: 2/12 Ink scripts complete (16.7%)
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
25661e6c5d Create Mission 4 opening briefing Ink dialogue script 
Complete opening briefing with Agent 0x99:
- 241 lines (branching dialogue structure)
- 14 conversation knots with player choices
- Variables: player_approach, handler_trust, combat_ready
- Key information delivery:
  - Critical Mass cell introduction
  - Chemical threat (chlorine weaponization)
  - 240,000 residents at risk
  - 4 hostile operatives (Cipher, Relay, Static, Voltage)
  - EPA auditor cover identity
  - The Architect revelation
  - Combat system introduction

Dialogue branches cover:
- Threat assessment
- ENTROPY ideology
- Combat readiness
- Mission priorities (attack prevention vs. capture)
- Cover identity usage
- Timeline and stakes

Variables track player personality for future dialogue adaptation.

Progress: 1/12 Ink scripts complete (8.3%)
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
a931c4180f Add Mission 4 implementation status tracking document 
Comprehensive status tracking for M4 development:
- Overall progress: 70% complete
- Planning documentation: 100% (9 stages, ~9,297 lines)
- Core implementation: 100% (scenario.json.erb, mission.json)
- Dialogue scripts: 0% (12 scripts needed)
- Asset production: 0% (sprites, VO, music)

Key achievements:
- 0 validation errors (vs M3's 46)
- Complete room and NPC structure
- VM integration configured
- All objectives and tasks defined

Next steps:
- Create 12 Ink dialogue scripts (~480-595 lines)
- Asset production (sprites, VO, music)
- SecGen VM scenario development
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
8bd2f4dbcf Add Mission 4 metadata file (mission.json) 
Mission display information and CyBOK mappings:
- Display name: Critical Failure
- Difficulty: 2 (Intermediate)
- SecGen scenario: vulnerability_analysis
- 6 CyBOK knowledge areas mapped
- Focus: SCADA/ICS security, infrastructure protection, combat

CyBOK areas: NS, SS, IS, AB, HF, IR
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
ae26085f05 Complete Mission 4 'Critical Failure' scenario.json.erb 
Created complete scenario file for M4 with:
- 3 objectives, 17 tasks (15 required, 2 optional combat)
- 9 rooms (water treatment facility)
- VM integration (vulnerability_analysis scenario with 4 flags)
- 8 NPCs (Robert Chen + 3 phone NPCs + 4 ENTROPY operatives)
- Complete narrative structure and objects
- 931 lines total

Validation results: 0 errors (vs M3's 46 errors)
- Schema validation: PASSED
- ERB rendering: PASSED
- All room types corrected to match schema
- Bidirectional connections verified

Mission specifications:
- Setting: Pacific Northwest Water Treatment Facility
- Threat: Critical Mass cell weaponizing chlorine dosing
- SCADA investigation with combat encounters
- Cross-cell coordination revealed (Critical Mass + Social Fabric)
- The Architect's larger plan introduced

This completes the scenario implementation phase following all 9 stages
of planning documentation (Stage 1-9 complete).
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
5a93195bf9 Complete Stage 9 scenario assembly guide for Mission 4 
Final stage complete with comprehensive assembly instructions:
- Step 0: Reference mission examination (REQUIRED before starting)
- Complete schema requirements checklist (all required fields)
- Mission-specific configuration templates
- All 3 objectives with 18 tasks (detailed JSON examples)
- All 9 rooms configuration patterns
- Critical Server Room VM integration (vm-launcher + flag-station)
- All 8 NPCs with correct properties (displayName, not name)
- ERB helper function usage guide
- JSON structure assembly walkthrough
- 3-tier validation checkpoints (syntax, schema, in-game)
- Final review and polish checklist
- Troubleshooting guide for common issues

Target: 0-5 validation errors (vs M3's 46)
Based on: Stage 9 Prompt Improvements from M3 experience
Includes: All patterns from M1/M2 reference missions

Mission 4 'Critical Failure' - ALL 9 STAGES COMPLETE
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
423730bb36 Complete Stage 8 VM integration and SecGen configuration for Mission 4 
- SecGen 'Vulnerability Analysis' scenario selected
- Complete network topology (SCADA backup server simulation)
- 4 flags with educational progression:
  * flag{network_scan_complete} - Nmap reconnaissance
  * flag{ftp_intel_gathered} - Service enumeration, cross-cell intel
  * flag{http_analysis_complete} - Web analysis, attack schedule
  * flag{distcc_exploit_complete} - Exploitation + privesc
- Vulnerability chain: Nmap → FTP/HTTP → distcc RCE → sudo Baron
- VM-launcher and flag-station JSON configurations
- Narrative-technical integration for all 4 challenges
- Intermediate difficulty balancing (30-40 min completion)
- Hint system (3 levels: Robert Chen, Terminal, Agent 0x99)
- Testing checklist and validation criteria
- SecGen scenario.xml structure
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
1f4df7c4d9 Complete Stage 7 asset manifest for Mission 4 
- Complete character sprite and animation requirements
- Robert Chen: 30 frames, Voltage: 24 frames, Operatives: 60 frames
- Player combat animations: 24 new frames
- Environment tilesets: 3 sets (industrial, control room, chemical storage)
- Large environmental objects: 15 unique assets
- Furniture and props: 30 objects
- UI elements: 55 components including SCADA interface
- Item icons: 25 unique icons
- Audio: 300-350 total files (ambience, SFX, VO, music)
- Voice acting: 245-295 lines estimated
- Music: 5 original tracks (15-20 minutes)
- Asset production phases and priorities
- Technical specifications for all asset types
- Complete file structure organization
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
42aa74d604 Complete Stage 6 dialogue and Ink script planning for Mission 4 
- Complete Ink dialogue structures for all NPCs
- Agent 0x99 briefing and debrief (55-65 lines)
- Robert Chen multi-stage conversations (120-140 lines)
- Voltage confrontation with branching outcomes (35-45 lines)
- Security guard and operatives combat dialogue (35-45 lines)
- Total 245-295 voice acting lines estimated
- Mission variable tracking system (chen_trust_level, voltage_captured, etc.)
- Event emission integration with objectives
- Dialogue choice consequences mapped
- Voice acting recording sessions planned
- Complete knot structure for all conversations
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
7ae370a05b Complete Stage 5 room design and puzzle layout for Mission 4 
- Detailed room-by-room specifications (9 rooms total)
- Complete object placement and interaction systems
- Combat space design for all 3 encounters
- Item distribution across all rooms
- Lock and access control systems (tiered keycards)
- NPC positioning and patrol routes
- Multiple approach paths (stealth, social, combat)
- Environmental storytelling in each room
- Room connection map with access requirements
- VM and flag station integration in Server Room
- No traditional puzzles (investigation-focused)
- Supports 60-80 minute playtime target
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
8668377ad8 Create Stage 4 objectives and task structure for Mission 4 
- Complete 3-objective structure aligned with 3-act narrative
- Detailed task definitions (18 tasks total: 16 required, 2 optional)
- Task types: enter_room, npc_conversation, custom, submit_flags
- Full VM challenge integration (4 flags with submission tasks)
- Task dependency map and progression logic
- Player choice implementation (capture vs disable, disclosure)
- Success/failure states (no timer-based failure)
- Stage-based urgency integration
- Event system triggers and rewards
- Player guidance system design
- 60-80 minute target playtime structure
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
75787c4568 Create Stage 3 character development for Mission 4 
- Complete character profiles for all NPCs
- Robert Chen: Detailed arc from skeptical to ally
- Voltage: Professional antagonist with credible threat
- Three field operatives: Cipher, Relay, Static
- Agent 0x99: Mission-specific support role
- Minor NPCs: Security guard, background employees
- Character relationship dynamics
- NPC behavior systems (patrol, alert states, radio)
- Sprite and animation requirements for all characters
- Voice acting direction and dialogue patterns
- Character integration with gameplay mechanics
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
2eab36779e Create Stage 2 atmosphere and environment design for Mission 4 
- Complete facility layout (8 interconnected rooms)
- Room-by-room visual and audio atmosphere design
- SCADA interface design with urgency stage progression
- Sound design mapped to 5 urgency stages
- Combat space design for stealth and direct engagement
- Environmental storytelling elements throughout
- Lighting progression (normal → emergency → resolution)
- Comprehensive asset requirements list
- Industrial water treatment facility authenticity
- Stage-based urgency indicators (no real-time timer)
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
392b1662d5 Create Stage 1 narrative structure for Mission 4 
- Complete 3-act story arc with beat-by-beat progression
- Character arcs: Robert Chen, Voltage, Agent 0x99
- Combat encounters integrated with narrative stages
- Major choices: capture vs disable, disclosure vs quiet patch
- Stage-based urgency mapped to acts (no real-time timer)
- VM challenge integration points
- LORE and cross-mission connections
- Task Force Null and The Architect revelation
- 60-80 minute mission structure
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
278410b413 Remove real-time timer from M4, replace with stage-based urgency 
Replace 30-minute countdown timer with narrative-driven urgency:
- Stage-based attack progression (5 stages)
- Visual/audio urgency indicators (SCADA status, radio chatter)
- No automatic failure from taking time
- Thoroughness rewarded with tactical advantages

Urgency created through:
- Narrative progression (attack stages advance)
- SCADA system status indicators (green -> yellow -> red)
- Robert Chen dialogue reflecting crisis state
- Operative radio chatter intensity
- Facility alarm states

Benefits:
- Removes time pressure frustration
- Allows exploration and investigation
- Rewards careful players
- Maintains narrative tension
- Player-driven pacing

Updated sections:
- Game Mechanics: timer -> escalating urgency
- Time Pressure System -> Escalating Urgency System
- UI Elements: timer display -> stage indicator
- Risk Mitigation: timer stress -> urgency balance
- Success Criteria: timer tension -> narrative urgency
- Next Steps: timer mechanics -> urgency progression

Combat and multi-system investigation remain core mechanics.
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
ac8e319560 Initialize Mission 4: Critical Failure 
Create M4 infrastructure defense mission initialization:
- Water treatment facility SCADA attack scenario
- ENTROPY Cell: Critical Mass
- SecGen: Vulnerability Analysis (Nmap/Nessus, distcc, sudo Baron)
- Estimated playtime: 60-80 minutes
- Difficulty: Intermediate (Tier 2)

New mechanics introduced:
- Hostile NPCs (first combat encounter)
- Item drops from defeated enemies
- Time-pressure objectives (30-min timer)
- Multi-system investigation

Educational focus:
- Cyber-Physical Systems (SCADA/ICS security)
- Security Operations (vulnerability scanning, threat hunting)
- Systems Security (privilege escalation)

Campaign connections:
- Cross-cell coordination (Critical Mass + Social Fabric)
- The Architect's infrastructure initiative
- Setup for Task Force Null (M5-10)

Mission represents transition from reconnaissance to active
crisis response with combat. First mission with time pressure
and hostile combatants.

Ready for Stage 1 development.
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
02e519e3fe Update Implementation Roadmap with Phase 0 requirements 
Add Phase 0: Reference Mission Examination (REQUIRED FIRST):
- Files to study (M1/M2 scenarios, schema)
- Critical patterns to extract (6 key patterns)
- Schema requirements checklist (13 requirements)
- ERB helper setup with usage notes
- Validation strategy (4 checkpoints)

Update time estimates:
- Add Phase 0: 2-3 hours
- Total: 70-105 hours (from 68-102)
- Note: Phase 0 saves 4-6 hours of rework

Update version to 2.0 with critical change notice
Emphasize Phase 0 prevents 40+ validation errors

Based on M3 experience: proper reference examination
essential for valid JSON on first attempt.
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
f5068ab6eb Update Stage 9 Quick Start Guide with critical improvements 
Add Step 0: Examine Reference Missions (REQUIRED FIRST):
- Extract VM launcher/flag station patterns from M1/M2
- Schema requirements checklist (mandatory fields)
- ERB helper functions reference
- Validation checkpoint requirements (4 checkpoints)

Enhance Common Pitfalls section:
- Encoding/JSON issues (Unicode, multi-line strings)
- Schema validation errors (wrong property names, types)
- VM/Flag integration issues (missing patterns)

Update time estimates to include Step 0 (2-3 hours)
Note: Step 0 saves 4-6 hours by preventing validation errors

Based on M3 experience: avoided 46 validation errors through
proper reference examination and schema awareness.

Version: 2.0 (from 1.0)
Status: Ready for use with all future missions
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
fe19f93c17 Add Stage 9 prompt improvements based on M3 experience 
Document critical improvements to Stage 9 prompts to reduce iterations:
- Add Step 0: Examine reference missions (M1/M2) before starting
- Schema requirements checklist (all required fields listed)
- Validation checkpoint requirements (validate incrementally)
- Common pitfalls to avoid (encoding, keyPins, object types)
- ERB helper function reference with examples
- Flag submission tasks pattern (explicit guidance)

Based on M3 development: avoided 46 validation errors that could
have been prevented with proper reference examination and schema
awareness. New approach should produce valid JSON on first attempt.
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
50bbf22269 Add flag submission tasks to main mission objective 
- Add 4 submit_flags tasks following M1 pattern
- submit_network_scan_flag: flag{network_scan_complete}
- submit_ftp_flag: flag{ftp_intel_gathered}
- submit_http_flag: flag{pricing_intel_decoded}
- submit_distcc_flag: flag{distcc_legacy_compromised}
- Provides clear player guidance for flag submission
- Aligns with success criteria requiring all 4 VM flags
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
11ba86df99 Add high priority quality improvements to M3 scenario 
- Add currentKnot to 3 NPCs (receptionist, guard, Victoria)
- Add player sprite configuration (Agent 0x00)
- Add closing debrief phone NPC with eventMapping trigger
- Add victoria_choice_made global variable for debrief trigger
- Fixes all 4 missing recommended fields from validation
 2026-01-14 09:46:33 +00:00
Z. Cliffe Schreuders
e304fffd69 Update VM launcher, flag station, and add opening briefing 
- vm-launcher: Add hacktivityMode and vm object following M1 pattern
- flag-station: Add acceptsVms and flags arrays for 4 VM flags
- Add opening briefing NPC with timedConversation cutscene
- Flags: network_scan, ftp_intel, pricing_intel, distcc_exploit
- Opens with Agent 0x99 briefing in reception lobby
 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
0ddee347b2 Add compiled Ink dialogue scripts for Mission 3 
- Copy 9 compiled JSON files from planning to scenario ink directory
- m03_opening_briefing.json - Mission briefing cutscene
- m03_npc_receptionist.json - Receptionist dialogue
- m03_npc_victoria.json - Victoria Sterling dialogue
- m03_npc_guard.json - Night guard dialogue
- m03_phone_agent0x99.json - Agent 0x99 phone contact
- m03_james_choice.json - James Park moral choice
- m03_terminal_cyberchef.json - CyberChef terminal
- m03_terminal_dropsite.json - Drop-site terminal
- m03_closing_debrief.json - Mission closing debrief
 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
ec749f2599 Fix keyPins ranges to match M1/M2 (25-60), fix PIN lock to use requires 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
5109e261f3 Fix key lock validation: add keyPins to all key locks 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
25fc9f341c Convert all objects to valid item types, remove unsupported features 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
d8c956f197 Fix NPC structure: rename to displayName/npcType, remove unsupported features 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
84abcdf439 Add type field to all 7 rooms, remove extra metadata 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
4c04abd535 Fix objectives: add order field, flatten structure, add task types 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
5582ba05f1 Add scenario creation status document with validation issues 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
a5e940f127 Backup scenario.json.erb before schema restructuring 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
d99a6370a0 Add JSON escaping for multi-line content strings 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
30395481cd Fix Unicode arrow character in operational log content 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
8143416338 Add Mission 3 scenario structure (scenario.json.erb) 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
1d9140ab4d Add Mission 3 metadata (mission.json) 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
4416e24c08 Add comprehensive session summary - Stage 9 prep 100% complete 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
d578c6392a Update Stage 9 prep summary - 100% complete, all blockers resolved 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
8cdd0c42e3 Update validation progress - Ink compilation complete, all critical blockers resolved 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
04d9932d04 Compile m03_closing_debrief.ink to JSON - fix all EXTERNAL syntax and handler_trust VAR 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
286ebefa8a Compile m03_phone_agent0x99.ink to JSON - fix all EXTERNAL function calls 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
b320770a04 Compile m03_terminal_dropsite.ink to JSON - fix literal flag syntax and pipe characters 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
aa856b2377 Compile m03_terminal_cyberchef.ink to JSON - fix list syntax 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
078a494f9d Compile m03_james_choice.ink to JSON - fix EXTERNAL syntax 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
546aba4731 Compile m03_npc_guard.ink to JSON - remove unused EXTERNAL 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
84170426d8 Compile m03_npc_receptionist.ink to JSON - add EXTERNAL player_name() 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
03068ae1e1 Compile m03_npc_victoria.ink to JSON - fix EXTERNAL syntax and divert error 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
b3f36efe13 Compile m03_opening_briefing.ink to JSON - fix EXTERNAL syntax 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
a69ddd9dfa Add comprehensive test cases for Stage 9 validation (24 test scenarios) 2026-01-14 09:46:32 +00:00
Z. Cliffe Schreuders
f8ad0776ce Add Quick Start Guide for Stage 9 implementation (condensed 8-step checklist) 2026-01-14 09:46:32 +00:00