test: add curses-cli

[scarf005]

Purpose of change (The Why)

• the answer to "which AI reviews the AI generated PR?"
• make it possible for AI to playtest PRs

Describe the solution (The How)

the script runs the game on tmux and work as a bridge between AI and game. in the future, it can be used to quickly test multiple PRs locally.

• game/CLI integration:
  • expose runtime Lua action-menu macros as JSON and surface them in curses-cli (available-macros-json, macro:<id> entries in inputs-jsonl)
  • harden session lifecycle around tmux socket normalization and startup validation
• Lua stdlib:
  • add AI utility action-menu macros (bn_macro_agent_context, bn_macro_look_target, bn_macro_adjacent_target) plus earlier macro set
• docs/skills:
  • add skills/curses-cli/references/macros.md
  • add skills/curses-cli/references/benchmark-loop.md
  • add docs/en/dev/guides/bench.md
• evidence artifacts:
  • add benchmark session bundle zip at artifacts/curses-cli/curses-bench-live-2026-02-26.zip

Testing

• TypeScript checks/tests:
  • deno check scripts/curses-cli/main.ts
  • deno test scripts/curses-cli/main_test.ts
• C++ build validation:
  • cmake --build --preset linux-full --target cataclysm-bn-tiles-common
  • cmake --preset linux-curses && cmake --build --preset linux-curses --target cataclysm-bn
• runtime validation:
  • started/stopped real curses-cli session and generated artifacts
  • uploaded cast and verified preview link
  • verified zip artifact committed and accessible from branch

Additional context

AI was really inefficient, took IRL 36 minutes above. hopefully this should become faster in the future

session bundle: https://github.com/scarf005/Cataclysm-BN/raw/chore/ai-pr-local-curses-validation/artifacts/curses-cli/curses-bench-live-2026-02-26.zip

Checklist

Mandatory

• I wrote the PR title in conventional commit format.
• I ran the code formatter.
• I linked any relevant issues using github keyword syntax like closes #1234 in Summary of the PR so it can be closed automatically.
• I've committed my changes to new branch that isn't main so it won't cause conflict when updating main branch later.

Optional

• This is a C++ PR that modifies JSON loading or behavior.
  • I have documented the changes in the appropriate location in the docs/ folder.
  • If documentation for this feature does not exist, please write it or at least note its lack in PR description.
• This PR modifies lua scripts or the lua API.
  • I have added lua scope to the PR title.
  • I have added type annotations to functions so that it's safe and easy to maintain.
  • I have committed the output of deno task docs:gen so the Lua API documentation is updated.

[ushkinaz]

Wow, that's really cool idea.
and with asciicinema we'll have a screen replay basically for free.