Pokered Save Editor 2
Pokemon Red & Blue save file editor - Qt 6 C++/QML
Loading...
Searching...
No Matches
2026-06-14 — Session Log

Standing policies: keep VERSION current + rebuild docs on FF main

Adopted two by-default rules. (1) Version is kept current automatically — the AI decides and applies PATCH (fix/small change) and MINOR (feature) bumps in the same commit as the change; MAJOR is leaders-only, never automatic; docs/notes/test/CI-only commits don't move the number. Caught the stale number up 0.7.0-alpha0.7.1-alpha (it hadn't moved since the baseline was set). (2) Rebuild the Doxygen docs by default after fast-forwarding main, so the generated docs/html/ always tracks main. Both written into CLAUDE.md (Default Workflow), with the bump authority also in ../../reference/versioning.md.

Doxygen: organized the notes into the doc site + repo-doc links

Built the notes/ (and key repo docs) into the generated Doxygen site as a structured tree, not an auto-appended pile. notes/_nav.dox defines two top-level "Related Pages" hubs — Project Notes (every notes/ page, by section) and Project & Repository (credits.md, VERSION, LICENSE). Hard rule recorded: every Markdown page in the Doxyfile INPUT must get a \subpage line; nothing auto-appends. Doxyfile changes: MARKDOWN_ID_STYLE = GITHUB (so the README TOC #slug anchors resolve), AUTOLINK_SUPPORT = YES (C++ symbols like MainWindow/Bridge/Router auto-link), LICENSE/VERSION added to INPUT with EXTENSION_MAPPING = no_extension=md so their README links resolve. The README's manual TOC was converted to raw-HTML anchors (<a href="#slug">) because Doxygen doubles the text of Markdown [text](#anchor) links; the architecture-table layers now link to their systems/ notes. Added projects/db/assets/data/credits.md (human-readable rendering of credits.json, regenerated on every JSON edit — see CLAUDE.md). Full rationale: ../../reference/documentation.md → "Markdown pages, links & navigation".

Sessions reorganized into month folders

Per-day session files now live in YYYY-MM/ month folders (sessions/2026-06/2026-06-06.md …), with a "June 2026" month hub in the Doxygen nav, to mirror the changelog's month split and scale cleanly. (Pre-revival history is the per-commit Changelog, all months present in the doc site; per-day session logs naturally begin at the 2026 revival.) README/CLAUDE/sessions-README updated to match.

Notes system — major refactor, cleanup, and restructure

A deep overhaul of the notes/ system itself — both the content and the system the notes describe for maintaining themselves. Goals: cleaner structure, less duplication, restored voice, a better- integrated AI + memory workflow. Highlights:

  • Per-day session logs adopted. The single sessions/session-log.md was replaced by one file per day, sessions/YYYY-MM-DD.md, with a sessions/README.md defining the system (a long-standing want). The dated history that had been crammed into status.md was moved out into the correct per-day files; status.md is now current-state only. The undated pre-corruption revival narrative (the s13 series) is preserved in sessions/revival-s13-series.md.
  • Naming/voice. An earlier pass (6bc16e5) had swapped personal names for "the maintainer" everywhere; the notes now use plain names again only where attribution matters, in neutral, matter-of-fact phrasing (no elevating "signed off"/"directed" wording).
  • Cluster consolidation. The changelog meta-doc (reference/version-history.md) was folded into the changelog index (version.md); the documentation cluster (documentation.md + doc-comment-style.md + documentation-progress.md) was merged into one reference/documentation.md; the Qt cluster (qt6-patterns.md + qt-gotchas.md) was merged into reference/qt-patterns.md; one-off incident notes (player-name-hang.md, box-recovery-research.md) were folded into their proper reference/session homes.
  • README.md rewritten to document the new structure and maintenance system; CLAUDE.md note map and cross-references updated to match.

(This is a notes-only/maintenance change — per the changelog policy it does not get its own changelog entry; this session-log entry is the record.)

(Committed earlier today, pre-refactor)

  • d8b118e docs: polish an amended README draft.
  • fb8cdf5 chore(assets): add assets/references/ for local-only reference material.
  • b823a5c docs(changelog): catch up the June 2026 backlog + adopt the inline-entry policy.
  • 199eb7e / b0cd23a docs: move the notes changelog into notes/ and shorten its name to version.
  • 6bc16e5 docs(notes): de-name maintainer references (later reverted — see above).