feat: the in-world calendar (#126) #1214

Merged

claude-bot merged 27 commits from feat/126-calendar into main 2026-10-17 15:37:54 +00:00

Conversation 0 Commits 27 Files changed 99 +13304 -105

claude-bot commented 2026-10-17 15:03:46 +00:00

Collaborator

Copy link

Fixes #126: the in-world calendar. Design: docs/design/in-world-calendar.md (branch design/126-in-world-calendar). The owner's answers are Q183 to Q187: (a) for the first four, and (b) for Q187, named ages.

Engine

• One date arithmetic in Python (app/services/world_calendar.py) and JS (src/calendar/engine.js), held together by one shared set of 1,128 test cases (src/calendar/cases.json). The expected results come from brute force, datetime and hand-written strings, never from the engine (scripts/calendar_cases.py --check).
• Months, festival and leap days carry stable ids and can sit outside the week. Leap rules follow the Gregorian pattern, and there are moons.
• Four generic presets, with no setting names (Q183 a).

Server

• Migration a126ca1e0d01 (now revising a1181f11e5a1): world_calendars, and the sessions.world_* columns.
• Calendar CRUD with the C6 check. Changes that would break a stored date are refused with the list of what uses it. Others remap every stored date by id in the same transaction.
• Copy a calendar from another campaign, or save and load it as a file.
• Session dates: a start, plus a span in hours or days with "ran past midnight" (Q184 a), and a default start.
• Timeline world_date and named ages; the campaign's "today".
• Export schema version 21.
• The approved summary's Discord post gains "In the story" (Q186 a). This is additive, with no contract bump.

Screens

• A date picker: an ARIA grid, festival cells, before-era years, precision.
• Settings → Calendar: presets, a full editor, a live preview, save with the check.
• On the session page:
  • "In the story…" in Manage, plus the header line;
  • one quiet row in the review (Q185 a).
• The Sessions list and campaign home lines.
• Wiki timeline dates and named ages.
• The Storyline's "As we played" / "In the world" switch, with "N days later".

Tests

• Engine: 1,176 server and 1,129 browser checks.
• Backend: 2,492 in the calendar-touched areas.
• Bot: 1,225.
• New journey J9: passes on desktop, phone and keyboard, with J5, J6 and J8 also green.
• The 4.6.0 integration rehearsal: 10,333 backend tests and 187 journeys passed.

The merge with main puts Settings → Files and Calendar side by side; those resolutions are taken from the rehearsal. Squash on merge: several builder commits lack the co-author line.

🤖 Generated with Claude Code

Fixes #126: the in-world calendar. Design: `docs/design/in-world-calendar.md` (branch `design/126-in-world-calendar`). The owner's answers are Q183 to Q187: (a) for the first four, and (b) for Q187, named ages. **Engine** - One date arithmetic in Python (`app/services/world_calendar.py`) and JS (`src/calendar/engine.js`), held together by one shared set of 1,128 test cases (`src/calendar/cases.json`). The expected results come from brute force, `datetime` and hand-written strings, never from the engine (`scripts/calendar_cases.py --check`). - Months, festival and leap days carry stable ids and can sit outside the week. Leap rules follow the Gregorian pattern, and there are moons. - Four generic presets, with no setting names (Q183 a). **Server** - Migration `a126ca1e0d01` (now revising `a1181f11e5a1`): `world_calendars`, and the `sessions.world_*` columns. - Calendar CRUD with the C6 check. Changes that would break a stored date are refused with the list of what uses it. Others remap every stored date by id in the same transaction. - Copy a calendar from another campaign, or save and load it as a file. - Session dates: a start, plus a span in hours or days with "ran past midnight" (Q184 a), and a default start. - Timeline `world_date` and named ages; the campaign's "today". - Export schema version **21**. - The approved summary's Discord post gains "In the story" (Q186 a). This is additive, with no contract bump. **Screens** - A date picker: an ARIA grid, festival cells, before-era years, precision. - Settings → Calendar: presets, a full editor, a live preview, save with the check. - On the session page: - "In the story…" in Manage, plus the header line; - one quiet row in the review (Q185 a). - The Sessions list and campaign home lines. - Wiki timeline dates and named ages. - The Storyline's "As we played" / "In the world" switch, with "N days later". **Tests** - Engine: 1,176 server and 1,129 browser checks. - Backend: 2,492 in the calendar-touched areas. - Bot: 1,225. - New journey J9: passes on desktop, phone and keyboard, with J5, J6 and J8 also green. - The 4.6.0 integration rehearsal: 10,333 backend tests and 187 journeys passed. The merge with main puts Settings → Files and Calendar side by side; those resolutions are taken from the rehearsal. **Squash on merge:** several builder commits lack the co-author line. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

claude-bot added 27 commits 2026-10-17 15:03:46 +00:00

feat(calendar): in-world calendar engine, definition schema, presets and shared cases (#126) ... d4a9deea2f

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

style(calendar): ruff format; fix schema period test (#126) ... 30e01a997d

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

feat(calendar): stable entry ids, outside_week days, committed cases generator (#126) ... 6aff85dee8

Entries carry an id; check_change derives the remap from ids and remap_dates
rewrites stored indexes. Festival and leap days can sit outside the week.
scripts/calendar_cases.py builds cases.json from brute-force enumeration.

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

wip(calendar): model, migration, API, session dates, timeline, export, bot line (#126) ... 03f4dabd03

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

wip(calendar): tests dd2467dd7c

wip: no rollback in calendar router eb92b0d8dd

wip: WorldDate m,d default 8d9ad71743

wip: orm rewrite keeps updated_at, json null as sql null, v20 gate 7f591897da

wip 5e6fdb4aed

wip: import bounds fe05e44f65

wip: update schema pins; bounds; changelog d0673cad98

wip: test fix 4f48fd1f38

style: ruff format; fixture noqa 4ca836936b

docs: API reference for the in-world calendar (#126) 51c13a9eaf

test: file-level noqa for the shared fixtures f63d0660e2

wip: calendar date picker, API client and view helpers (#126) 2cd1f8f8fc

wip: settings calendar page and editor (#126) 5eacf068e4

wip: session dates dialog, header line, review row (#126) 2d767aa090

wip: timeline dates, storyline order, list and home lines (#126) 844bd1e2d3

wip: catalogue rows, changelog, e2e journey, tests (#126) 47adee2cfb

wip: more tests (#126) cc18f42deb

wip: fix journey and test expectations (#126) 946cb738c6

fix: picker grid name without a caption; session tests (#126) 2be6f9d3cf

wip: journey opens the Completed tab (#126) 31ba51d036

test: ten settings sections, the calendar item in Manage (#126) 83b1f6b08d

test: allow world_calendar_service.collect_uses to read page titles (GM-only refusal list) (#126) ... ca851d1f65

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Merge main into feat/126-calendar; its migration follows a1181f11e5a1; Files and Calendar both in Settings ... d47c929de3

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

claude-bot scheduled this pull request to auto merge when all checks succeed 2026-10-17 15:03:48 +00:00

claude-bot merged commit 8d3a537756 into main 2026-10-17 15:37:54 +00:00

claude-bot referenced this pull request from a commit 2026-10-17 15:37:56 +00:00

feat: the in-world calendar (#126) (#1214)

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

backend

Issue related to the backend

  

bot

Issue related to the bot

  

bug

Something is not working

  

duplicate

This issue or pull request already exists

  

enhancement

New feature

  

frontend

Issue related to the frontend

  

help wanted

Need some help

  

invalid

Something is wrong

  

question

More information is needed

  

recording

Issue related to the recording system

  

security

Security hardening / vulnerability work

  

wontfix

This won't be fixed

No labels

backend

bot

bug

duplicate

enhancement

frontend

help wanted

invalid

question

recording

security

wontfix

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

rbrooks/Quest-Board!1214

No description provided.