Skip to content

feat(tutorial): teach ls -a and cat via the memory checkpoint - #11

Merged
NoHudd merged 2 commits into
devfrom
worktree-tutorial-cat-checkpoints
Sep 29, 2026
Merged

NoHudd merged 2 commits into
devfrom
worktree-tutorial-cat-checkpoints

Conversation

@NoHudd

@NoHudd NoHudd commented Sep 29, 2026

Copy link
Copy Markdown
Owner

The tutorial never had the player read a file, so the checkpoint loop (cat a lore file → memory restored → autosave) went untaught.

Changes

  • Hidden items implemented: hidden: true was declared in content but unread — .bash_profile showed in plain ls. Now plain ls hides it, ls -a reveals it, cat by name still works. Field added to the Item schema, removed from UNIMPLEMENTED_FIELDS.
  • Two new tutorial steps (9 → 11): after the fight Echo teaches ls -a (reveals .bash_profile), then cat bash_profile — fires the identity memory restore, and Echo names it as the checkpoint you resume from on death. ps/pwd/nav follow as before.
  • Cheat sheet + skip summary mention ls -a and cat-as-checkpoint.

Tests

10 new (tests/test_hidden_items.py, tests/test_tutorial_checkpoint.py), TDD; 4 nav tests updated for the new leg. Full gate green: ruff, mypy --strict, pytest, engine.validate.

🤖 Generated with Claude Code

NoHudd and others added 2 commits September 29, 2026 14:39
The tutorial never had the player read a file, so the checkpoint loop
(cat a lore file -> memory restored -> autosave) went untaught. Two new
steps after the fight: ls -a reveals bash_profile (item hidden: true now
actually hides files from plain ls — it was declared in content but
unread), cat fires the identity memory restore, and Echo names it as the
checkpoint you resume from on death. ps/pwd/nav follow as before;
11 steps total.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Hint-text conflict: kept the new ls -a / cat checkpoint steps, adopted
dev's 'use <item>' spelling (bracketed words now survive markup).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@NoHudd
NoHudd merged commit c441c71 into dev Sep 29, 2026
1 check failed
@NoHudd
NoHudd deleted the worktree-tutorial-cat-checkpoints branch September 29, 2026 20:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant