feat: add turn, a dungeon-turn tracker

[ptaranat]

Adds dw turn, the dungeon clock: advance turns (10 min each), track named light sources and spells by duration (6, 30m, 1h), warn on expiry and upcoming expiry, and remind on the wandering-check cadence (configurable, default every 2 turns). State survives between invocations in dw-session.json at the repo root (already gitignored), overridable via DW_SESSION; a corrupt state file starts fresh with a note. No named light sources or book content hardcoded: the user names the thing and gives its duration. DB-106.

[macro-application]

dw turn: dungeon-turn tracker

[cloudflare-workers-and-pages]

Deploying dlmnwd with    Cloudflare Pages

Latest commit:	300bd2a
Status:	✅  Deploy successful!
Preview URL:	https://fbc052df.dlmnwd.pages.dev
Branch Preview URL:	https://ptaranat-db-106-dw-turn-dung.dlmnwd.pages.dev

View logs

[Copilot]

Pull request overview

Adds a new dw turn command to track dungeon turns (10 minutes each), persist session state between invocations, and provide reminders for expiring tracked items and wandering-check cadence.

Changes:

• Introduces core turn/session state logic (parseTurns, advance, persistence helpers) and associated tests.
• Adds the turn CLI command with subcommands (track, status, check-every, end) and integrates it into the main CLI help/dispatch.
• Updates documentation and shell completion to expose the new command.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
test/turn.test.ts	Adds unit tests for parsing, advancement rules, wandering-check cadence, and persistence/corruption handling.
src/turn.ts	Implements turn-state model, duration parsing/formatting, advancement logic, and JSON file persistence.
src/commands/turn.ts	Adds the dw turn CLI subcommand implementation and user-facing output.
src/cli.ts	Registers turn in command dispatch and documents it in dw help.
README.md	Documents dw turn usage and updates the “Working” command list/roadmap.
completions/_dw	Adds zsh completion entries for the new turn command and its subcommands.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Suppressed comments (1)

src/commands/turn.ts:90

• cmdAdvance uses parseInt, so inputs like dw turn 1h or dw turn 3x will be accepted and silently interpreted as 1/3. Given this command’s docs also mention m/h durations (for track), this is especially likely to produce wrong advances. Consider requiring a pure integer string for [n] before parsing.

function cmdAdvance(arg: string | undefined): void {
  const n = arg === undefined ? 1 : parseInt(arg, 10);
  if (Number.isNaN(n) || n < 1) {
    console.error(USAGE);
    process.exit(1);
  }