# Changelog

All notable project-organization and protocol-facing changes should be recorded here.

## 2026-05-11

### Changed

- Upgraded the public website visual system so public pages no longer depend on repeated text-card layouts.
- Added page-specific visual explainers for the homepage cognitive loop, Protocol causal loop, Downloads release map, Wallet signing boundary, Node runtime path, Explorer ledger strip, and Docs knowledge map.
- Added reference-mapped visual objects to public page cards so each section has a page-specific diagram, release surface, signing surface, runtime lane, ledger surface, or documentation map instead of plain text.
- Updated website information architecture and project status to require visual explainers, improved typographic hierarchy, and page-specific layouts for future UI work.
- Updated website architecture rules to require a mature reference pattern before implementing major page sections.
- Refined the public website shell with sticky protocol navigation, unified page/canvas surfaces, stronger visual rhythm, and motion rules for protocol pages.
- Added a unified surface mode so public cards and panels blend into the page by default and reveal stronger borders, shadows, and contrast only on hover or focus.
- Tightened the unified surface mode so public cards are transparent by default and only materialize as cards on hover or focus.

## 2026-05-10

### Added

- Added `docs/website-information-architecture.md` to define the MazeXChain website split between homepage, console, protocol, whitepaper, downloads, wallet, node, explorer, and docs pages.
- Added `/console.html` as the dedicated operational solving workspace.
- Added `ROADMAP.md` as the durable engineering sequence for future work.
- Added `docker/` local-node deployment with a runtime Dockerfile, compose file, and Docker usage notes.

### Changed

- Updated project status and reading rules so future UI work must follow the website information architecture before editing public pages.
- Rebuilt `/` as a slim protocol landing page instead of a mixed dashboard.
- Gave Protocol, Downloads, Wallet, Node, Explorer, and Docs pages distinct layouts instead of a repeated card-grid template.
- Replaced the flat public-site navigation with a grouped Mega Menu and rebuilt the homepage routing area as a role-based protocol entry portal.
- Updated README, project status, and persistent context to mark Docker local-node deployment as implemented.

## 2026-05-09

### Added

- Added `docs/protocol-vocabulary.md` as the canonical terminology layer for cognitive advancement, challenge behavior, Solve Blocks, cognitive state, MAZEX resources, and legacy term mapping.
- Added formal `cli/` operator commands for node start, health checks, chain status, verification, replay, wallet creation, balance lookup, config display, and download packaging.
- Added whitepaper PDF download entries to the website download strip and public download manifest generation.
- Archived whitepaper source notes under `docs/whitepaper/sources/` and added a whitepaper source reading rule.
- Rebuilt the Chinese whitepaper structure around problem definition, protocol model, challenge generation, verification, chain state, security, scalability, consensus, and implementation specifications.
- Promoted the Chinese whitepaper thesis to the canonical "chain-based cognitive protocol" narrative and recorded it in the whitepaper source register.
- Refined the Chinese whitepaper positioning to "cognitive advancement protocol" and aligned the cover, abstract, protocol definition, and conclusion around continuous challenges, behavior verification, Solve Blocks, chained state inheritance, and verifiable cognitive state advancement.
- Updated active project-control docs, architecture notes, API/data-flow/module docs, public UI copy, and whitepaper pages to use "challenge behavior" and "cognitive advancement" as the current protocol vocabulary while preserving `blackbox` only as a legacy implementation alias.

## 2026-05-08

### Added

- Added project constitution and project status ledger.
- Added persistent project context for future AI handoff and compressed-context recovery.
- Added mandatory reading dependency rules for future AI sessions.
- Added stable architecture, module, data-flow, security, API, and deployment documents under `docs/`.
- Added chain, app, network, consensus, wallet, security, and genesis configuration templates under `config/`.
- Added genesis-state, initial-account, and initial-fragment templates under `genesis/`.
- Added formal `tests/` suite manifest and runner backed by existing `tools/` checks.
- Added runtime config/genesis loader and wired core app, chain, wallet, network, security, and genesis defaults.

### Notes

- These files establish engineering control surfaces. Deeper config-only protocol migration remains a future hardening step.
- The active protocol line remains Base1.
