superdario 1.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eventually Solutions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,193 @@
+# Super Dario
+
+Claude's pixel mascot in a Super Mario flavoured endless runner for your terminal.
+Stomp bugs, bonk ? blocks, jump the pipes, duck under ghosts, collect gold tokens and
+chase the global high score.
+It plugs into Claude Code: every prompt you send opens Dario in a fresh terminal
+tab so you can play while Claude works, and the HUD tells you when Claude is done
+or needs your input.
+
+```
+ DARIO   TOKENS 7   SCORE 00412   HI 01230                     CLAUDE: working...
+
+                       ▄▄                 ▄▄▄▄
+          ▄███▄       ▀▀▀              ▄██████▄
+         ▐█ ▀ █▌                       ▀ █▀▀█ ▀
+          ▀█▄█▀                          ▀▀  ▀▀
+           █ █           ▄▄██▄▄
+ ─────────────────────────────────────────────────────────────────────────────
+          SPACE / UP  jump    DOWN / S  duck    P  pause    Q  quit
+```
+
+## Requirements
+
+- macOS (the "open a new terminal" part uses Warp and iTerm as a new tab in the active window; a new window in Terminal.app, Ghostty, WezTerm, kitty, Alacritty, Tabby and Rio; or the integrated terminal of Cursor, VS Code, VS Code Insiders, VSCodium, Windsurf, Kiro and Trae through a tiny launcher extension)
+- Node.js >= 22.18 (runs TypeScript directly, no build step, no runtime dependencies)
+
+## Install
+
+```sh
+curl -fsSL https://dario-xxx.web.app/install.sh | sh   # downloads ~/.dario/app, runs the first-run wizard, wires Claude Code
+dario update                                          # later: fetch the newest release from the site
+```
+
+Or from npm (the package is `superdario`, the command is still `dario`):
+
+```sh
+npm install -g superdario && dario install   # stable global install; update with npm install -g superdario@latest
+npx superdario install                       # one-shot: copies itself to ~/.dario/app first, since the npx cache gets pruned
+```
+
+From a source checkout instead:
+
+```sh
+cd dario
+npm install          # only dev tooling for typecheck/tests
+./bin/dario install  # hooks into ~/.claude/settings.json, links ~/.claude/skills/dario and ~/.local/bin/dario
+```
+
+Releases are built with `scripts/build_release.sh` (writes `web/dl/dario-<version>.tgz`, `dario-latest.tgz`, `version.json`) and published with `firebase deploy --only hosting`.
+
+`dario install` is idempotent and only adds/removes its own entries.
+`dario uninstall` reverses everything.
+
+## Play
+
+```sh
+dario            # play in the current terminal
+dario launch     # open a new tab/window and play there
+dario stop       # close the running game
+dario scores     # high score, token totals, games played
+dario ranking    # global leaderboard (Firebase) and your rank
+dario name Bob   # change the name shown on the leaderboard (asked once on first play)
+dario mode pro   # PRO CODER: play only while the agent works (vibe = any time, the default)
+dario status     # running? hooks installed? auto-launch? Claude state?
+```
+
+Controls: hold `RIGHT`/`D` to run and release to stop (a tiny helper reads the physical key state on macOS, so this works in every terminal), `LEFT`/`A` walks back (the camera never scrolls back), `SPACE`/`UP`/`W` jump, `DOWN`/`S` duck (fast-fall in the air), `P` pause, `R` restart, `Q`/`ESC` quit. Nothing moves until you run; enemies still walk toward you.
+
+You start with 3 lives (shown as `LIVES ♥♥♥` in the HUD; lost ones turn into dots). Touching an enemy costs one: the mascot hops back and blinks
+for a moment, and the run only ends when the last life goes. Some ? blocks pop a red heart instead of
+their logo; grabbing it adds a life (up to 9), credited to the sponsor when it came out of their block ("+1 LIFE by FIGMA").
+
+Score grows with distance; each coin is worth 25 points (there is no separate token counter). Landing on a bug squishes
+it for +100, hitting a blinking ? block from below pops out a mushroom (+200 points) or a sponsor's
+logo (+300 points, +100 more each time, shown as "+300 by FIGMA"), and you can stand on blocks. Pipes must be jumped, mid-height
+ghosts ducked (or jumped with perfect timing), high ghosts run under.
+
+## Modes
+
+`dario mode vibe` (default, **VIBE CODER**) lets you play whenever you like. `dario mode pro` (**PRO CODER**) only lets
+the mascot run while Claude / Codex / Grok is actually working on a prompt: the start, resume and restart keys are
+locked otherwise ("PRO CODER: plays only while CLAUDE is working"), the game pauses itself the moment the agent
+finishes or needs you, and resumes on its own with the next prompt. The mode is also in the in-game settings panel (C).
+
+## Characters
+
+You play as the agent you launched from: the Claude Code hook starts the game as
+**Claude**, `CODEX_HOME`/`CODEX_SANDBOX` in the environment means **Codex**, `GROK_CLI`
+means **Grok**. The other two agents are the walking enemies you stomp. Force it with
+`dario play --as codex`, `dario launch --as grok` or persistently `dario character grok`
+(`auto` restores detection).
+
+## Claude Code integration
+
+| Hook               | What happens                                                                     |
+| ------------------ | -------------------------------------------------------------------------------- |
+| `UserPromptSubmit` | writes `working` to `~/.config/dario/claude_status.json`, opens Dario if not running |
+| `Stop`             | writes `done`: the game shows **CLAUDE IS DONE - go check your prompt!**         |
+| `Notification`     | permission / idle prompts write `attention`: **CLAUDE NEEDS YOUR INPUT**         |
+| `PreToolUse` / `PostToolUse` | write the running tool ("Bash · npm test", "Edit · game.ts") so the HUD shows live activity; between tools it cycles Claude-Code-style thinking verbs |
+
+The hook scripts return immediately (the work runs in the background) and print
+nothing, so prompts are never delayed and no context is injected.
+
+When Claude is done or needs input the game pauses itself, and the hook brings
+the app you prompted from back to the front (captured when the prompt was sent).
+If that app was Warp it also presses Cmd+Shift+[ to return to the previous tab,
+which needs Accessibility permission for the app running the hook.
+
+```sh
+dario focus off           # keep playing; do not switch apps when Claude finishes
+dario off                 # stop opening the game on every prompt (hooks stay installed)
+dario on                  # resume
+dario terminal iterm      # force a terminal app or IDE; `dario terminal --list` shows what is installed here
+dario ide cursor          # install the Dario Launcher extension and open the game inside the IDE's integrated terminal
+                          # (cursor | vscode | vscode_insiders | vscodium | windsurf | kiro | trae)
+```
+
+## Codex CLI and Grok Build
+
+The same hooks exist for OpenAI's Codex CLI and xAI's Grok Build, and the game then plays as
+Codex or Grok with the other agents as enemies. `dario install` writes them automatically when
+it finds `~/.codex` or `~/.grok`; `dario agents` shows the state, `dario agents codex` /
+`dario agents grok` add them later and `dario agents codex off` removes them.
+
+| Agent      | Where the hooks go              | Events                                                                 |
+| ---------- | ------------------------------- | ---------------------------------------------------------------------- |
+| Codex CLI  | `~/.codex/hooks.json`           | `UserPromptSubmit`, `Stop`, `PermissionRequest` (attention), `PreToolUse`, `PostToolUse` |
+| Grok Build | `~/.grok/hooks/dario.json`      | `UserPromptSubmit`, `Stop`, `Notification` (matcher `permission_prompt\|idle_prompt`), `PreToolUse`, `PostToolUse` |
+
+Codex only runs hooks you have trusted: open Codex, type `/hooks` and approve the Dario entries once.
+Grok Build also executes Claude Code's `settings.json` hooks in its compatibility mode; the Dario
+scripts detect that (`GROK_HOOK_EVENT`) and either defer to the Grok hook file or report the event as Grok,
+so the game is never opened twice. `CODEX_HOME` / `GROK_HOME` are honoured when set.
+
+The `/dario` skill (linked into `~/.claude/skills/dario`) lets you ask Claude to
+open the game, read scores, or toggle auto-launch from the chat.
+
+## Global ranking
+
+Scores are submitted to Firestore (project `dario-xxx`) after every game (VIBE and PRO keep separate boards: `highScore` / `proHighScore`) using an
+anonymous Firebase session stored in `~/.config/dario/auth.json`. No SDK: plain
+`fetch` against the Firestore and Identity Toolkit REST APIs. Security rules
+(`firebase/firestore.rules`) let anyone read the board, let only the owner write
+their own document, and never let a high score go down. Deploy rules with
+`firebase deploy --only firestore:rules`.
+
+## Website and sponsors
+
+`web/` is a static site on Firebase Hosting (https://dario-xxx.web.app): landing page,
+live leaderboard (VIBE / PRO tabs), an autoplay demo of the real engine (`web/demo.js`, built from `src/demo` with
+`scripts/build_demo.sh`) and the sponsor flow. Three tiers, all paid through Polar:
+
+- **In-game mystery box sponsor** (30 days, pay what you like from $29): the amount paid becomes the sponsor's
+  `priority`, so higher amounts rank higher: more ? boxes and always the first box of a run.
+- **Banner sponsor** ($69.90 per day) and **ranking sponsor** ($29.90 per day): booked per UTC day on a 30-day
+  calendar (`/api/sponsor/slots` lists free / held / booked days). Checkout holds the chosen days for 30 minutes
+  (`sponsor_slots`), `order.paid` confirms them, and the game shows the sponsor whose `days` include today.
+
+After paying, sponsors upload an image that is shrunk to the tier grid (token 16×12 drawn with sextant glyphs into the 8×8 block, banner 66×20),
+reduced to 8 colors and editable pixel by pixel with a terminal-accurate preview.
+
+`functions/` holds the Cloud Functions (Node 22): `sponsorCheckout` creates the pending sponsor (holding its days)
+and the Polar checkout, `polarWebhook` activates it on `order.paid` (Standard Webhooks verified, idempotent per order,
+stores the amount as `priority`, confirms the days), `sponsorState` and `sponsorLogo` serve the edit page behind a
+per-sponsor key, `sponsorSlots` serves the calendar. Firestore: `sponsors` (public when active), `sponsor_private`,
+`sponsor_slots` (public). `priority` can also be edited in the console; ties go to whoever paid first. Non-secret parameters live in `functions/.env`
+(see `.env.example`); tokens are Secret Manager secrets:
+
+```sh
+firebase functions:secrets:set POLAR_ACCESS_TOKEN
+firebase functions:secrets:set POLAR_WEBHOOK_SECRET
+firebase deploy --only functions,hosting,firestore:rules
+```
+
+In the game, active sponsors are fetched once an hour. A **mystery box** sponsor's logo (or a heart) pops out
+of the ? boxes and pays points when grabbed; they are ranked (priority, then who paid first) and the
+top one owns the most boxes and always the first box of a run. The **ranking** sponsor of the day heads the top-10 panel. The single **banner** sponsor (top of the ranking) gets a 66×20 plate, the size of the SUPER DARIO title, with
+"sponsored by NAME" above it: right of the title on the start screen (below it on narrow terminals) and centered on
+top of the pause and game-over screens. All of them are clickable
+(OSC 8 hyperlinks) in Warp, iTerm2, VS Code, kitty, WezTerm and Ghostty. `dario sponsors` lists them.
+
+## Development
+
+```sh
+npm run typecheck
+npm test
+```
+
+Layout: `src/game` (physics, spawning, loop), `src/render` (half-block pixel
+renderer, sprites, HUD), `src/launcher` (terminal strategies, pid lock),
+`src/claude` (status file, hook service, settings installer), `src/agents` (Codex / Grok hook files), `src/ide` (launcher extension for VS Code-style IDEs), `src/cli`
+(commands), `hooks/` (scripts Claude Code calls), `skills/dario` (the skill).

package/bin/dario

@@ -0,0 +1,45 @@
+#!/bin/sh
+# Dario launcher: resolves the project root (through symlinks) and runs the TypeScript entry with Node >= 22.18.
+SOURCE="$0"
+while [ -h "$SOURCE" ]; do
+  LINK_DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  case "$SOURCE" in
+    /*) ;;
+    *) SOURCE="$LINK_DIR/$SOURCE" ;;
+  esac
+done
+ROOT="$(cd -P "$(dirname "$SOURCE")/.." && pwd)"
+
+find_node() {
+  if [ -n "$DARIO_NODE" ] && [ -x "$DARIO_NODE" ]; then
+    echo "$DARIO_NODE"
+    return 0
+  fi
+  if command -v node >/dev/null 2>&1; then
+    command -v node
+    return 0
+  fi
+  for candidate in /opt/homebrew/bin/node /usr/local/bin/node "$HOME/.volta/bin/node" "$HOME/.local/share/fnm/aliases/default/bin/node"; do
+    if [ -x "$candidate" ]; then
+      echo "$candidate"
+      return 0
+    fi
+  done
+  latest="$(ls -d "$HOME"/.nvm/versions/node/*/bin/node 2>/dev/null | sort -V | tail -n 1)"
+  if [ -n "$latest" ]; then
+    echo "$latest"
+    return 0
+  fi
+  return 1
+}
+
+NODE="$(find_node)" || {
+  echo "dario: could not find node (>= 22.18 required). Set DARIO_NODE=/path/to/node." >&2
+  exit 1
+}
+
+# npm installs ship the bundled dist/main.js (Node will not strip types under node_modules); checkouts run the sources.
+ENTRY="$ROOT/src/main.ts"
+if [ ! -f "$ENTRY" ] && [ -f "$ROOT/dist/main.js" ]; then ENTRY="$ROOT/dist/main.js"; fi
+exec "$NODE" --no-warnings=ExperimentalWarning "$ENTRY" "$@"