RESTORATION LOG

The Chronicle

A record of restoration. These entries document the ongoing efforts to stabilize The Library and push back the encroaching Flux. Development began January 2nd, 2026.

Viewing:

Chronicle: JANUARY 30 - FEBRUARY 02, 2026

Visual Rendering:

  • [GameStudio] Feat: Display single sprite frame from sprite sheet in Character Editor
  • [GameStudio] Fix: Replace undefined spriteSize with frameHeight variable
  • [GameStudio] Feat: Auto-detect sprite sheet dimensions and fix direction mapping

Character & NPC:

  • [GameStudio] Feat: Add Character Registry and rename NPC terminology to Character
  • [GameStudio] Feat: Add walk speed setting to character placements
  • [GameStudio] Fix: Use camelCase for Character type fields to match Rust serde
  • [GameStudio] Feat: Add walk animation preview and snap-to-start button
  • [GameStudio] Feat: Enhance character movement controls with 16-way directions and timing
  • [Game] Feat(actor): Add dual sprite sheets, improve animation, and simplify to 8-way

Miscellaneous:

  • [GameStudio] Feat: Move object behavior to per-placement, add bounds visualization
  • [GameStudio] Feat: Add centralized Object Library accessible from global navigation
  • [GameStudio] Feat: Add path configuration system and improve Object Library filtering
  • [GameStudio] Feat: Simplify to 8-way directional system throughout

Stability & Fixes:

  • [GameStudio] Fix: Move persistRegistry before saveRegistry to fix hoisting error

The Codex (Docs):

  • [Game] Docs: updated documentation for dual sprite system and 8-way directions

Chronicle: JANUARY 29-30, 2026

Visual Rendering:

  • [GameStudio] Feat: Add monocle version support for backgrounds and sprites
  • [GameStudio] Fix: Reload sprite images when path changes

Miscellaneous:

  • [GameStudio] Fix: updated description templates to match narration style guide
  • [GameStudio] Feat: Rework Screen Editor UI and add Interactions Editor
  • [GameStudio] Fix: Screen Editor canvas sizing and layout reorganization

Narrative & Dialogue:

  • [GameStudio] Feat: Add comprehensive dialogue, narration, and NPC system

The Codex (Docs):

  • [GameStudio] Docs: updated all documentation for Screen Editor and Interactions Editor
  • [GameStudio] Docs: updated README.md to v1.2.0 with all current features
  • [GameStudio] Docs: Add monocle image feature documentation to Screen Editor guide

World Development:

  • [GameStudio] Feat: Add Object Registry system for reusable scene objects

Chronicle: JANUARY 29, 2026

Features & Systems:

  • [GameStudio] Feat: Add data integrity features - backup, export, migration safety
  • [GameStudio] Docs: updated Feature Status and Settings Help with data management features
  • [GameStudio] Docs: updated plan and feature status for completed Phase 2
  • [GameStudio] Chore: updated About dialog version to 1.2.0 and document post-Stage 2 features
  • [GameStudio] Feat(ui): Implement New Scene creation dialog

Audio & Sound:

  • [GameStudio] Feat(audio): Implement audio asset CRUD operations
  • [GameStudio] Fix(audio): Register audio context in help system
  • [GameStudio] Fix(audio): updated audio formats to match game engine capabilities
  • [GameStudio] Feat(audio): Add MIDI to OGG conversion backend
  • [GameStudio] Feat(audio): Add MIDI to OGG converter tool UI
  • [GameStudio] Docs: Add comprehensive help documentation for MIDI to OGG and Settings
  • [GameStudio] Feat(audio): Add adjustable OGG quality setting to MIDI converter

Character & NPC:

  • [GameStudio] Refactor(menu): Remove non-functional menu items and fix UI issues
  • [GameStudio] Chore(release): Complete Stage 2 Refactor and release v1.2.0

Miscellaneous:

  • [GameStudio] Fix(validation): Fix initialization order and Zustand compatibility
  • [GameStudio] Feat(screen-editor): Add vertex editing and depth mask elevation controls
  • [GameStudio] Fix: updated description templates to match narration style guide
  • [GameStudio] Feat: Add codebase sync status (Data Integrity Phase 2)
  • [GameStudio] Feat(validation): Add load-time project validation (Phase 3)
  • [GameStudio] Feat(ui): Add Home button to project navigation sidebar

Narrative & Dialogue:

  • [GameStudio] Fix: Correct Tauri dialog import for v2 plugin API

The Codex (Docs):

  • [Game] Docs: Fix incorrect narration style summaries (x2)
  • [GameStudio] Docs: updated documentation for Scene Library, Ollama AI, and codebase scanning
  • [GameStudio] Feat(audio): Add Audio to workflow dashboard and help documentation
  • [GameStudio] Docs: Add complete documentation for Phase 4 audio features

World Development:

  • [GameStudio] Fix: Add wingSettings field to Rust AppConfig struct
  • [GameStudio] Feat: Scene ID system overhaul, Settings improvements, and Ollama AI integration
  • [GameStudio] Feat(wing-settings): Make wing name editable and add browse button for assets folder
  • [GameStudio] Feat: Implement persistent wing settings storage

Chronicle: JANUARY 28, 2026

Puzzle Logic:

  • [GameStudio] Fix: Remove redundant auto-sync causing puzzle creation to hang

Visual Rendering:

  • [GameStudio] Feat(layout): Add draggable center point handles with color-coded connections

Audio & Sound:

  • [GameStudio] Feat(audio): Implement Phase 4 audio system with playback and validation
  • [GameStudio] Fix: Add Audio Editor routing and fix Puzzle Editor empty state

Character & NPC:

  • [GameStudio] Refactor(backend): Migrate all Tauri commands to use structured AppError

Code Maintenance:

  • [GameStudio] Fix(layout): Track connection handles and clean up invalid transitions

Miscellaneous:

  • [GameStudio] Fix: Resolve layout editor stale data and React Flow warnings
  • [GameStudio] Feat(screen-editor): Implement simplified Entry/Exit Zone System
  • [Game] Chore: Remove tools/GameStudio (moved to GameStudioDesktop repo)
  • [GameStudio] Feat(core): Implement Phase 1 scope tracking system with readable IDs
  • [GameStudio] Feat(layout): Improve connection management and add transition point foundation
  • [GameStudio] Feat: Add Screen Editor mask visualization and Layout Editor improvements

Narrative & Dialogue:

  • [GameStudio] Feat(dialogue): Complete Phase 3 dialogue linkage and condition builder
  • [GameStudio] Feat(dialogue): Implement Phase 3 character registry and dialogue scene integration
  • [GameStudio] Chore(storyboard): Remove redundant Design Status dropdown

Stability & Fixes:

  • [GameStudio] Feat(frontend): Implement comprehensive error handling system

The Codex (Docs):

  • [GameStudio] Feat(puzzle): Implement Phase 2 multi-puzzle management and living documentation
  • [GameStudio] Docs: Comprehensive updated to editor documentation
  • [GameStudio] Docs: updated user guide footer version to 1.1.0
  • [GameStudio] Docs: updated Phase 3 status to complete after AppError migration

Chronicle: JANUARY 27, 2026

Visual Rendering:

  • Chore(assets): Add generated sprite sheets and DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture binaries
  • GameStudio: introducing palette related files
  • Feat(docs): Integrated Sprite Generator & Image Convertor help, enhanced Help System with internal linking

Code Maintenance:

  • [GameStudio] Refactor(backend): Split sprites.rs into modular structure

Engine & Platform:

  • Feat(engine): Implemented Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (Truecolor (32-bit)))))))))))))))))) alpha blending and DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture-safe asset loading

Miscellaneous:

  • [GameStudio] Feat(security): Enable CSP and optimize memory settings
  • [GameStudio] Chore: Sync version numbers to 1.1.0 across all config files
  • [GameStudio] Feat(ux): Comprehensive Workflow & Navigation overhaul
  • [GameStudio] Feat(testing): Complete Phase 1 - Testing Infrastructure

The Codex (Docs):

  • [GameStudio] Docs: updated README and CONTRIBUTING for Phase 1 testing
  • [GameStudio] Docs: updated README version history with Phases 3-4
  • Docs(codex): updated Asset Pipeline and Technical Specifications
  • [GameStudio] Feat: Add dual documentation system with configurable Game Documentation
  • [Game] Docs: Clean up main Codex after GameStudio documentation migration

Chronicle: JANUARY 26, 2026

Visual Rendering:

  • Feat: Sprite Generator Overhaul (Preview, Zoom, Colors)
  • GameStudio v1.1.0: Enhanced Sprite Generation & UI Scaling
  • Feat(sprites): Add DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture 256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (256-color (8-bit)))))))))))))))))))) BMP export to Sprite Generator
  • Feat(DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture): Backport dynamic sprites and speed controls
  • Feat: Add Sprite Sheet Generator and 3D Asset Support
  • Chore: Add test render outputs
  • Style: Align Sprite Generator UI with App design system
  • Fix: Add missing closing tag in SpriteGeneratorView
  • Feat(sprites): Add Blender-based sprite sheet generator

Character & NPC:

  • Feat: updated Actor system and Archivist sprites

Miscellaneous:

  • Feat: Add undo/redo, native menus, dynamic sidebar, resizable help panel
  • Fix: Correct rust-toolchain action name
  • Fix: Add write permissions for release creation

The Codex (Docs):

  • Engine Fidelity & Exhaustive Codex Sync

World Development:

  • Ci: Add GitHub Actions release workflow

Chronicle: JANUARY 25, 2026

Visual Rendering:

  • Feat: Add Design Bible with Tailwind Typography, smart auto-save

Character & NPC:

  • Feat(gamestudio): Stage 3 refactor with item system and desktop planning

Engine & Platform:

  • Feat(DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture): Complete Stage 3 Chunk 4+5 - Item system with binary manifest architecture

Miscellaneous:

  • Feat: Implement file system storage and game project integration
  • Feat: Add undo/redo, native menus, dynamic sidebar, resizable help panel
  • Initial commit: GameStudio Desktop
  • Feat: Initialize Tauri backend for desktop application
  • Feat: Complete Stage 3 Chunk 4+5 - Data-driven item system with manifest integration

Narrative & Dialogue:

  • Chore: Remove obsolete dialogue files, add Support Refactor docs

Stability & Fixes:

  • Fix: Resolve save/restore scene tracking and bitmap ownership bugs

The Codex (Docs):

  • Feat: Add contextual help system with documentation panel
  • Docs: updated GameStudio Desktop documentation, archive old design files
  • Feat: Complete DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture Chunk 3 (Phases 8-DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture, 9-DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture) + Stage 3 documentation
  • Docs: updated README.md to reflect Stage 3 refactoring progress
  • Docs: Clean up Stage 2 document - remove phases moved to Stage 3

The Codex (Docs)

Character & NPC:

  • Refactor: Complete Chunk 3 (Phases 8, 8B, 9) with context refinements

Engine & Platform:

  • Refactor: Complete Phase 7B - Logging Migration (Windows/PC architecture/Linux architecture + DOS architecture)

The Codex (Docs):

  • Docs: updated documentation for Chunk 2 completion
  • Docs: updated all documentation for GameStudio completion

Miscellaneous:

  • Feat: Complete GameStudio integration system

Chronicle: JANUARY 23, 2026

Puzzle Logic:

  • DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture: Complete Stage 2 Phase 5 (Puzzle State Isolation)
  • Refactor Plan: Add parallel development strategy with logical chunks
  • Stage 2 Phase 5: Isolate puzzle state in scene custom state

Visual Rendering:

  • Chore: remove DIST directory and build artifacts from Git tracking (x2)

Audio & Sound:

  • Feat(engine): implement Phase 7 - Error Handling and Logging System
  • DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture: Implement Phase 7 - Error Handling & Logging System

Character & NPC:

  • Docs: updated Stage 2 refactor plan - Phase 3 complete
  • Refactor(DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture): implement Phase 3 dynamic array containers

Engine & Platform:

  • Chore: clean up c_allegro root directory and add File Organization Guide
  • Feat(engine): implement Phase 3 - Dynamic Array Containers
  • Feat(engine): implement Phase 6 - Scene Auto-Registration
  • DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture: Port Stage 2 Phase 1 (SceneCallbackContext pattern)
  • DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture: Port Stage 2 Phase 2 (ClusterResourceManager for automatic shared asset management)
  • DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture: Implement complete menu system with save/load/settings
  • DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture: Add alpha-blended flux transitions and architecture audit reports
  • Reorganize DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture assets: remove duplicate DATA/DATA paths, add source PNGs
  • DOS architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture architecture: Implement Phase 6 - Scene Auto-Registration System

Miscellaneous:

  • Chore: add remaining untracked design assets and logs
  • Stage 2 Phase 2: Implement ClusterResourceManager for automatic shared asset management

Narrative & Dialogue:

  • Chore: remove legacy DialogueEditor and updated runtime scripts

The Codex (Docs):

  • Docs: comprehensive Codex documentation audit and fixes
  • Docs: updated README.md with Stage 2 refactoring progress
  • Docs(codex): create master navigation and archive deprecated Design Bible
  • Docs(codex): updated reorganization plan with Phase 1 & 7 completion status
  • Feat: Implement visual Dialogue Editor and documentation
  • Codex: Add Design Website, reorganize Development for Stage 2
  • Overhaul README as comprehensive repository index

World Development:

  • Feat(studio): overhaul Game Studio with scene production workflow and visual redesign
  • Stage 2 Phase 1: Implement scene state encapsulation via SceneCallbackContext

Engine & Platform

Puzzle Logic:

  • Complete DOS architecture cluster exit system and puzzle mechanics alignment

Visual Rendering:

  • DOS architecture: Multiple bug fixes and intro palette management

World Development:

  • Complete Phase 6: Full scene state migration to W1S00_State

Engine & Platform:

  • DOS architecture: Add satchel/inventory system and fix UI interaction issues
  • DOS architecture: Fix intro transition and tune constellation timing

Miscellaneous

Audio & Sound:

  • Fixed issue with volume slider in settings menu, and audio mode cycling - Native midi was failing. fixed now.

Character & NPC:

  • DOS architecture refactoring: Phases 1-3 and 8 complete (state management, save/load, intro UX)

Engine & Platform:

  • Complete Phase 5: DOS architecture UI modularization matching Windows/PC architecture/Linux architecture

Miscellaneous:

  • Blockchain timestamp registration
  • Add blockchain timestamp for Master Source Archive

The Codex (Docs)

Puzzle Logic:

  • Improve menu UX, monocle gating, and puzzle interaction

Character & NPC:

  • Complete Phase 1 refactoring: scene instance state system and flag-based persistence

The Codex (Docs):

  • Add comprehensive Engine Architecture documentation
  • Fixed alignment timer reset and monocle asset loading. introduced comprehensive architecture documentation.

Code Maintenance:

  • Clean up architectural dependencies and file structure

Features & Systems

Features & Systems:

  • Implemented menu bar at the top of the screen for system settings.

Puzzle Logic:

  • Fix alignment puzzle timer not disappearing after completion

World Development:

  • Implement Scene Instance System + Resource Manager (Phase 1, Priority 1-2)

Character & NPC:

  • First stage of major refactoring complete. More to come

The Codex (Docs):

  • Updated UI, fixed some issues with navigation after refactoring code. introduced save / restore functionality to game. updated documentation to explain how everything works.

Chronicle: JANUARY 17-18, 2026

Features & Systems:

  • Introduced monocle asset. introduced early implementation of satchel / inventory (x7)

Puzzle Logic:

  • Updated commit / chronicle logic (x4)
  • Updated chronicle logic (x5)
  • Updated monocle gate logic. Monocle function unlocked with two paths. (x2)
  • Updated World Codex: Clarify multi-hinge mechanics (x2)

Code Maintenance:

  • Cleaned up source file assets (x3)

Miscellaneous:

  • Testing auto chronicle updates (x7)
  • Removed unnecessary asset source files (x4)
  • Test push

Narrative & Dialogue:

  • Updated formatting, changed some texts (x4)

Stability & Fixes:

  • Fixed an issue with monitor resolution detection on Windows/PC architecture (x2)
  • Fixed an issue with monitor resolution detection (x8)

The Codex (Docs):

  • Updated codex documentation to reflect new ideas and concepts (x6)
  • Updated core reference codex with chronicle workflow information (x6)

General Updates & Narrative Polish

Narrative and Polish:

  • Major revisions to Codex documentation
  • Refined effects system to better represent the narrative arc (Flux manifestation, Hinge resolution)
  • Dialogue rewritten to serve the story rather than explain it
  • Puzzles made more demanding
  • Fixed mouse movement on Windows build
  • Monocle marker now behaves correctly in the Precipice

Puzzle Mechanics:

  • Update World Codex: Clarify multi-hinge mechanics

General Updates:

  • Test push

Audio System

  • Added secondary audio path for pre-rendered OGG files (selectable from Launcher)
  • This is for systems that cannot handle real-time MIDI synthesis
  • Native MIDI audio path can now be manually specified in Linux/Windows builds

DOS/Windows Split

Major restructuring. The codebase has been split into two distinct branches:

  • DOS Build: Maintains 8-bit Mode 13h graphics for authentic retro hardware
  • Windows/Linux Build: Uses 32-bit color depth and modern rendering

Fixed graphics glitches on the modern build - mouse cursor no longer traces erratic paths.

First Puzzle and Audio

  • Constructed the first true puzzle (the Hinge mechanic in action)
  • Refined Monocle marker rendering (now displays correctly even under visual distortion)
  • Integrated OPL3 FM synthesizer for MIDI audio playback

Architecture Expansion

  • Built the Launcher (game entry point)
  • Implemented 640x400, 256-color palette for authentic VGA graphics
  • Drafted initial scene files for the Atrium and the Precipice (navigable but empty)

Engine Selection

Committed to C and the Allegro library. This provides low-level hardware access with enough abstraction for rapid development.

  • Implemented basic character movement (the Archivist can now walk across the screen)
  • Animation system is functional but rudimentary
  • Codex documentation updated to reflect the new technical direction

Project Initialization

The project has begun. Directory structure established. Currently evaluating whether to use a custom engine or an existing framework.

Repository initialized and ready for development.