Commit graph

43 commits

Author SHA1 Message Date
833c0efa3a
Add a thorough tintin document 2026-02-12 16:31:34 -05:00
fb758c8f36
Add protocol negotiation doc 2026-02-12 16:24:37 -05:00
4ec09cffda
Improve doc discovery 2026-02-11 21:47:05 -05:00
9671f3c286
Add a roadmap outline 2026-02-11 18:21:43 -05:00
544b7dfee1
Add reading guide to index and refresh stale references 2026-02-11 16:19:34 -05:00
400ebe4275
Add object model design doc 2026-02-11 12:12:30 -05:00
94a01186c8
Add a doc index 2026-02-11 09:39:48 -05:00
da809bea31
Add zones and building doc 2026-02-10 22:48:44 -05:00
01d5848178
Add prompt system design doc 2026-02-10 19:07:32 -05:00
243a44e3fb
Add plan for zvm compatability 2026-02-10 16:50:23 -05:00
bc1a2e5489
Add undo command support 2026-02-10 16:49:46 -05:00
8288b2535a
Add multiplayer zmachine design notes 2026-02-10 16:09:33 -05:00
ad47ee05bd
Document z-machine performance analysis and optimization roadmap 2026-02-10 15:45:52 -05:00
4313941334
Update if-journey: mark V8 MUD wiring as done, note upper window fix 2026-02-10 14:36:57 -05:00
14816478aa
Update if-journey.rst with V8/Lost Pig milestone and corrections
Wizard Sniffer is Glulx (.gblorb), not z-machine — out of scope.
Lost Pig is V8, not V5 as originally assumed. Added milestone
section documenting the V8 support work, bugs found and fixed,
and new opcode implementations. Updated game descriptions and
version notes. Added trace_lostpig.py utility script.
2026-02-10 13:53:02 -05:00
f4b7d0548b
Update if-journey.rst with save/restore bug fix details 2026-02-10 13:15:16 -05:00
8b4493ea39
Update if-journey docs with Level 2 integration milestone 2026-02-10 11:18:22 -05:00
5b7cb252b5
Update if-journey docs with save/restore completion
Save/restore is now fully implemented in the hybrid interpreter. Updated
open question 7 to reflect completion, marked the what-to-do-next item as
done, and updated the milestone section to include save/restore in the
"what works" list.

Also noted the QuetzalParser off-by-one bug fix (return_pc parsing).
2026-02-10 10:13:45 -05:00
8097bbcf55
Document save/restore as open gap in hybrid interpreter
op_save is a stub that always fails. QuetzalWriter chunks are stubs.
Added as open question 7, next step item, and corrected the inaccurate
claim that save/restore works.
2026-02-09 23:13:47 -05:00
1b08c36b85
Update investigation and journey docs with session 3 findings 2026-02-09 23:06:43 -05:00
f8f5ac7ad0
Add z-machine garbled output investigation doc and debug script 2026-02-09 22:54:32 -05:00
e6b63622fa
Document Zork 1 milestone in if-journey
The hybrid interpreter can now run Zork 1, marking the first working
implementation of the embedded interpreter path. This enables levels 2-5
(inspectable/moldable/shared worlds) rather than just the opaque terminal
approach of level 1.
2026-02-09 21:46:53 -05:00
205e2716dd
Update if-journey.rst with hybrid interpreter progress 2026-02-09 20:44:22 -05:00
47ef606e7f
Update documents with new IF system 2026-02-09 17:59:47 -05:00
bc5e829f6b
Add a terminal plan 2026-02-09 15:48:04 -05:00
4b52051bed
Add a doc on utf8 design 2026-02-09 15:47:57 -05:00
e0910151f4
Add research on IF possibilities 2026-02-09 11:54:22 -05:00
588227bcd0
Add dbzfe notes 2026-02-08 10:45:25 -05:00
6344c09275
Restructure combat moves: single-word commands with variant args
The DREAMBOOK always described "punch right/left [target]" as one command
with a direction argument, but the implementation had separate TOML files
and multi-word command names that the dispatcher couldn't reach (it only
matches the first word). Aliases like "pr" also couldn't pass targets
because the shared handler tried to re-derive the move from args.

Changes:
- Merge punch_left/right, dodge_left/right, parry_high/low into single
  TOML files with [variants] sections
- Add command/variant fields to CombatMove for tracking move families
- load_move() now returns list[CombatMove], expanding variants
- Handlers bound to moves via closures at registration time:
  variant handler for base commands (punch → parses direction from args),
  direct handler for aliases and simple moves (pr → move already known)
- Core logic in do_attack/do_defend takes a resolved move
- Combat doc rewritten as rst with architecture details
- Simplify mud.tin aliases (pr/pl/etc are built-in MUD commands now)
2026-02-08 00:20:52 -05:00
83455c525f
Update commands doc with combat, content, and editor sections
Documents how combat moves are registered from TOML, how content-defined commands
work, and how editor mode captures input.
2026-02-07 23:50:55 -05:00
ef658fd987
Update architecture plan opening to reflect current progress
Items 1-8 from the plan are complete. Only in-world programming (item 9) remains.
2026-02-07 23:50:32 -05:00
8f3455ce0a
Convert things-and-building doc to rst 2026-02-07 23:39:45 -05:00
0395aaadad
Add things and building design doc 2026-02-07 23:36:47 -05:00
388e693f8c
Add MTTS capability parsing module with client color detection
Parses MTTS bitfield values from telnetlib3 ttype3 into a ClientCaps dataclass.
Includes color_depth property that returns the best available color mode
(truecolor, 256, or 16) based on client capabilities.
2026-02-07 22:44:23 -05:00
f36880f82c
Add persistence documentation
Explains the store module architecture, password security considerations,
and the three-layer save strategy (auto-save, logout save, disconnect save).
2026-02-07 21:42:19 -05:00
6173a165c2
Add combat system design documentation
Captures the combat-as-content architecture: moves are TOML files,
engine is a state machine (IDLE→TELEGRAPH→WINDOW→RESOLVE). Documents
move set, counter relationships, damage formulas, and how combat
initiation works without a dedicated fight command.
2026-02-07 20:47:41 -05:00
8f5956df3d
Add research on various mu* dsls 2026-02-07 19:31:38 -05:00
600be4ed95
Add note on combat tick health 2026-02-07 16:31:16 -05:00
dcc8b961bb
Add CommandDefinition and migrate command registry 2026-02-07 16:15:21 -05:00
0f05302b6e
Add an architectural plan 2026-02-07 15:54:12 -05:00
e059bac633
Add research on graphicmud 2026-02-07 15:39:36 -05:00
1223eebeb1
Add mudlib documents 2026-02-07 15:36:52 -05:00
25bb565091
Move notes to docs/how, docs/why, docs/lessons
how/  - how things work (terrain generation, command system)
why/  - design philosophy (telnet-first, text worlds)
lessons/ - things we learned the hard way (charset vs mtts)

Removes notes/ — DAYDREAMING.txt became DREAMBOOK.md, charset-vs-mtts
expanded into docs/lessons/ with the connect_maxwait fix documented.
2026-02-07 13:31:02 -05:00