@bongos/core 1.17.2 → 1.17.3

package/scripts/hall-preview/fixtures/leaderboard.json

@@ -0,0 +1,184 @@
+{
+  "leaderboard": [
+    {
+      "id": "1",
+      "github_login": "lars589",
+      "display_name": "lars589",
+      "avatar_url": "https://avatars.githubusercontent.com/u/283020391?v=4",
+      "total_credits": 38644,
+      "karma": 10,
+      "rank": "archon",
+      "achievements": [
+        "first-ship",
+        "first-claim",
+        "first-parallel-claim",
+        "streak-3",
+        "streak-7"
+      ],
+      "tokens_used": "38866453596"
+    },
+    {
+      "id": "95",
+      "github_login": "jaxri",
+      "display_name": "Jackson Rini",
+      "avatar_url": "https://avatars.githubusercontent.com/u/64553469?v=4",
+      "total_credits": 4630,
+      "karma": 1,
+      "rank": "metic",
+      "achievements": [
+        "first-ship",
+        "first-claim",
+        "first-parallel-claim",
+        "streak-3",
+        "gds-shipper"
+      ],
+      "tokens_used": "2485218160"
+    },
+    {
+      "id": "94",
+      "github_login": "scootermack",
+      "display_name": "scootermack",
+      "avatar_url": "https://avatars.githubusercontent.com/u/295990394?v=4",
+      "total_credits": 2422,
+      "karma": 0,
+      "rank": "metic",
+      "achievements": [
+        "first-ship",
+        "first-claim",
+        "first-parallel-claim",
+        "streak-3",
+        "art-pipeline-shipper"
+      ],
+      "tokens_used": "966367590"
+    },
+    {
+      "id": "25",
+      "github_login": "IAMMASTERQUA",
+      "display_name": "IAMMASTERQUA",
+      "avatar_url": "https://avatars.githubusercontent.com/u/290184380?v=4",
+      "total_credits": 286,
+      "karma": 37,
+      "rank": "metic",
+      "achievements": [
+        "first-ship",
+        "first-claim",
+        "first-parallel-claim",
+        "art-pipeline-shipper",
+        "gds-shipper"
+      ],
+      "tokens_used": "322340908"
+    },
+    {
+      "id": "70",
+      "github_login": "kingaonline",
+      "display_name": "kingaonline",
+      "avatar_url": "https://avatars.githubusercontent.com/u/293641659?v=4",
+      "total_credits": 160,
+      "karma": 0,
+      "rank": "thetes",
+      "achievements": [
+        "first-ship",
+        "first-claim",
+        "art-pipeline-shipper",
+        "breaking-the-100c-bar"
+      ],
+      "tokens_used": "66829858"
+    },
+    {
+      "id": "3",
+      "github_login": "LarsCode",
+      "display_name": "LarsCode",
+      "avatar_url": "https://avatars.githubusercontent.com/u/35337514?v=4",
+      "total_credits": 71,
+      "karma": 0,
+      "rank": "xenos",
+      "achievements": [
+        "first-ship",
+        "first-claim",
+        "art-pipeline-shipper"
+      ],
+      "tokens_used": "25527381"
+    },
+    {
+      "id": "24",
+      "github_login": "bfg-system",
+      "display_name": "The BFG (system)",
+      "avatar_url": null,
+      "total_credits": 0,
+      "karma": 0,
+      "rank": "xenos",
+      "achievements": [],
+      "tokens_used": "0"
+    },
+    {
+      "id": "27",
+      "github_login": "willHermesLines",
+      "display_name": "willHermesLines",
+      "avatar_url": "https://avatars.githubusercontent.com/u/267458743?v=4",
+      "total_credits": 0,
+      "karma": 0,
+      "rank": "xenos",
+      "achievements": [],
+      "tokens_used": "0"
+    },
+    {
+      "id": "28",
+      "github_login": "discord-bot-system",
+      "display_name": "Discord Bot (system)",
+      "avatar_url": null,
+      "total_credits": 0,
+      "karma": 0,
+      "rank": "xenos",
+      "achievements": [],
+      "tokens_used": "0"
+    },
+    {
+      "id": "50",
+      "github_login": "Svensson-CMD",
+      "display_name": "Svensson-CMD",
+      "avatar_url": "https://avatars.githubusercontent.com/u/290959655?v=4",
+      "total_credits": 0,
+      "karma": 0,
+      "rank": "xenos",
+      "achievements": [],
+      "tokens_used": "0"
+    },
+    {
+      "id": "51",
+      "github_login": "MrTenkpro",
+      "display_name": "MrTenkpro",
+      "avatar_url": "https://avatars.githubusercontent.com/u/291558470?v=4",
+      "total_credits": 0,
+      "karma": 0,
+      "rank": "xenos",
+      "achievements": [],
+      "tokens_used": "0"
+    },
+    {
+      "id": "57",
+      "github_login": "largekristensen-svg",
+      "display_name": "largekristensen-svg",
+      "avatar_url": "https://avatars.githubusercontent.com/u/292408002?v=4",
+      "total_credits": 0,
+      "karma": 0,
+      "rank": "xenos",
+      "achievements": [],
+      "tokens_used": "0"
+    },
+    {
+      "id": "71",
+      "github_login": "erikwils",
+      "display_name": "erikwils",
+      "avatar_url": "https://avatars.githubusercontent.com/u/51457175?v=4",
+      "total_credits": 0,
+      "karma": 0,
+      "rank": "xenos",
+      "achievements": [],
+      "tokens_used": "0"
+    }
+  ],
+  "page": {
+    "limit": 100,
+    "offset": 0
+  }
+}

package/scripts/hall-preview/fixtures/me.json

@@ -0,0 +1,476 @@
+{
+  "builder": {
+    "id": "95",
+    "github_id": "64553469",
+    "github_login": "jaxri",
+    "display_name": "Jackson Rini",
+    "avatar_url": "https://avatars.githubusercontent.com/u/64553469?v=4",
+    "total_credits": 4630,
+    "karma": 1,
+    "created_at": "2026-06-22T22:49:07.833Z",
+    "rank": "metic",
+    "status": "active",
+    "deactivated_at": null,
+    "reactivated_at": null,
+    "deactivated_reason": null,
+    "preferred_disciplines": [
+      "engineer"
+    ],
+    "system_role": null,
+    "anthropic_email": null,
+    "anthropic_user_id": null,
+    "monthly_budget_usd": null,
+    "box_blocked": false,
+    "box_blocked_reason": null,
+    "box_blocked_at": null,
+    "box_blocked_by": null
+  },
+  "active_claims": [
+    {
+      "claim_id": "1845",
+      "task_id": "2167",
+      "worktree_name": "frontend-redesign-ux-746bdd",
+      "claimed_at": "2026-07-10T18:29:41.871Z",
+      "head_sha": "7119fa2124f4570fc9502b2f12411cc054a7e4fc",
+      "reserved_migration_number": null,
+      "release_requested_by": null,
+      "release_requested_at": null,
+      "release_requested_note": null,
+      "title": "Check in the hall preview harness (fixture server + screenshot runbook)",
+      "touches": [
+        "scripts/hall-preview/server.js",
+        "scripts/hall-preview/README.md"
+      ],
+      "priority": 2,
+      "credits_reward": 50,
+      "version_id": "BONGOS-V1",
+      "module_key": null,
+      "streak_preview": {
+        "current_streak": 1,
+        "projected_streak": 1,
+        "qualifies": true,
+        "reason": "today-already-counted"
+      }
+    }
+  ],
+  "active_claim": {
+    "claim_id": "1845",
+    "task_id": "2167",
+    "worktree_name": "frontend-redesign-ux-746bdd",
+    "claimed_at": "2026-07-10T18:29:41.871Z",
+    "head_sha": "7119fa2124f4570fc9502b2f12411cc054a7e4fc",
+    "reserved_migration_number": null,
+    "release_requested_by": null,
+    "release_requested_at": null,
+    "release_requested_note": null,
+    "title": "Check in the hall preview harness (fixture server + screenshot runbook)",
+    "touches": [
+      "scripts/hall-preview/server.js",
+      "scripts/hall-preview/README.md"
+    ],
+    "priority": 2,
+    "credits_reward": 50,
+    "version_id": "BONGOS-V1",
+    "module_key": null,
+    "streak_preview": {
+      "current_streak": 1,
+      "projected_streak": 1,
+      "qualifies": true,
+      "reason": "today-already-counted"
+    }
+  },
+  "est_vs_actual": {
+    "median": 0.08,
+    "sample_size": 10
+  },
+  "unlocked": [
+    {
+      "builder_id": "95",
+      "achievement_id": "first-ship",
+      "unlocked_at": "2026-06-30T00:26:01.980Z",
+      "unlocked_by_task_id": null,
+      "name": "First Ship",
+      "description": "Ship your first task.",
+      "icon": "📦",
+      "credit_bonus": 1,
+      "sort_order": 10
+    },
+    {
+      "builder_id": "95",
+      "achievement_id": "first-claim",
+      "unlocked_at": "2026-06-22T23:04:49.435Z",
+      "unlocked_by_task_id": null,
+      "name": "First Claim",
+      "description": "Claim your first task.",
+      "icon": "🪙",
+      "credit_bonus": 1,
+      "sort_order": 20
+    },
+    {
+      "builder_id": "95",
+      "achievement_id": "first-parallel-claim",
+      "unlocked_at": "2026-06-30T00:26:01.980Z",
+      "unlocked_by_task_id": null,
+      "name": "First Parallel Claim",
+      "description": "Hold two simultaneous claims; ship both successfully.",
+      "icon": "⚓",
+      "credit_bonus": 2,
+      "sort_order": 30
+    },
+    {
+      "builder_id": "95",
+      "achievement_id": "streak-3",
+      "unlocked_at": "2026-06-30T00:51:29.738Z",
+      "unlocked_by_task_id": "1680",
+      "name": "Streak: 3 Nights",
+      "description": "Ship a task in 3 consecutive local-time nights (>=15min; cleanup/refactor now counts).",
+      "icon": "🔥",
+      "credit_bonus": 2,
+      "sort_order": 40
+    },
+    {
+      "builder_id": "95",
+      "achievement_id": "gds-shipper",
+      "unlocked_at": "2026-06-30T00:26:01.980Z",
+      "unlocked_by_task_id": null,
+      "name": "GDS Shipper",
+      "description": "Ship a task whose touches[] include src/gds/ or scripts/gds/.",
+      "icon": "⚙️",
+      "credit_bonus": 2,
+      "sort_order": 70
+    },
+    {
+      "builder_id": "95",
+      "achievement_id": "breaking-the-100c-bar",
+      "unlocked_at": "2026-06-30T00:26:01.980Z",
+      "unlocked_by_task_id": null,
+      "name": "Breaking the 100c Bar",
+      "description": "Cross 100 total credits.",
+      "icon": "💯",
+      "credit_bonus": 5,
+      "sort_order": 80
+    }
+  ],
+  "locked_with_progress": [
+    {
+      "achievement_id": "streak-7",
+      "name": "Streak: 7 Nights",
+      "description": "Ship a task in 7 consecutive local-time nights (>=15min; cleanup/refactor now counts).",
+      "icon": "🌋",
+      "progress_text": "track 7 consecutive ship-days"
+    },
+    {
+      "achievement_id": "art-pipeline-shipper",
+      "name": "Art Pipeline Shipper",
+      "description": "Ship a task whose touches[] include the art/ pipeline.",
+      "icon": "🎨",
+      "progress_text": "needs one shipped task touching art/"
+    },
+    {
+      "achievement_id": "subtractor",
+      "name": "Subtractor",
+      "description": "Earn the net-negative ship bonus on 3 ships — across your work you have deleted more than you have added.",
+      "icon": "🪓",
+      "progress_text": "keep building"
+    }
+  ],
+  "streak": {
+    "current": 1,
+    "longest": 5,
+    "last_ship_day": "2026-07-10",
+    "started_on": "2026-07-10",
+    "timezone": "America/New_York",
+    "today": "2026-07-10"
+  },
+  "grades": {
+    "recent": [],
+    "rolling": {
+      "n": 0,
+      "avg_score": "0.0",
+      "n_passed": 0
+    }
+  },
+  "karma": {
+    "recent": [
+      {
+        "id": "11",
+        "delta": 1,
+        "reason": "peer_vote_weekly",
+        "recorded_at": "2026-07-01T09:26:29.519Z",
+        "granted_by": null,
+        "granted_by_login": null,
+        "granted_by_display_name": null
+      }
+    ],
+    "delta_30d": 1
+  },
+  "onboarding": {
+    "current_stage": "graduated",
+    "completed_stages": [
+      "auth_complete",
+      "pick_disciplines",
+      "first_start",
+      "first_claim",
+      "ship_three"
+    ],
+    "started_at": "2026-06-22T22:49:07.839Z",
+    "completed_at": "2026-06-23T18:52:07.021Z",
+    "progress": {
+      "cleared": 5,
+      "total": 5
+    },
+    "stages": [
+      {
+        "id": "box_connect",
+        "source": "box",
+        "label": "Connect to thy dev box",
+        "hint": "Follow the steps in the welcome scroll above to get Claude running on thy dev box — this ticks itself the moment thou art connected.",
+        "detail": "",
+        "cleared": true,
+        "is_current": false
+      },
+      {
+        "id": "join_discord",
+        "source": "discord",
+        "label": "Join the Discord server",
+        "hint": "Connect Discord — thou art auto-joined to the city's server and given thy rank.",
+        "detail": "",
+        "cleared": true,
+        "is_current": false
+      },
+      {
+        "id": "pick_disciplines",
+        "source": "stage",
+        "label": "Choose thy craft — engineer, artist, or ideator",
+        "hint": "Pick the work that calls thee — engineer, artist, ideator, or any mix.",
+        "detail": "",
+        "cleared": true,
+        "is_current": false
+      },
+      {
+        "id": "cli_setup",
+        "source": "cli",
+        "label": "Run /builder-setup on thy dev box",
+        "hint": "Sign the GDS in on thy dev box with /builder-setup — this ticks itself once thou art signed in.",
+        "detail": "",
+        "cleared": true,
+        "is_current": false
+      },
+      {
+        "id": "ship_three",
+        "source": "stage",
+        "label": "Ship three works — and rise to Thetes",
+        "hint": "Carry three tasks through with /builder-ship — the third makes thee a Thetes.",
+        "detail": "3 of 3 works shipped",
+        "cleared": true,
+        "is_current": false
+      }
+    ],
+    "graduated": true
+  },
+  "discord": {
+    "linked": true,
+    "configured": true
+  },
+  "grader_bypass": true,
+  "cost": {
+    "spend_mtd_usd": 711.03,
+    "budget_mtd_usd": null,
+    "pct_used": 0,
+    "level": "ok"
+  },
+  "wandering": {
+    "rank": "metic",
+    "levels": [
+      {
+        "n": 0,
+        "key": "locked",
+        "label": "Locked",
+        "blurb": "Strictly the claimed task. Off-task notes are filed silently, never raised.",
+        "allowed": true
+      },
+      {
+        "n": 1,
+        "key": "focused",
+        "label": "Focused",
+        "blurb": "On task, full in-task initiative; at most one captured follow-up at the end.",
+        "allowed": true
+      },
+      {
+        "n": 2,
+        "key": "balanced",
+        "label": "Balanced",
+        "blurb": "May surface a high-value tangent mid-task as \"capture or pursue?\" — your call.",
+        "allowed": true
+      },
+      {
+        "n": 3,
+        "key": "exploratory",
+        "label": "Exploratory",
+        "blurb": "A thinking partner — actively surfaces adjacent work and investigations.",
+        "allowed": true
+      }
+    ],
+    "default_level": 2,
+    "default_key": "balanced",
+    "max_level": 3,
+    "max_key": "exploratory",
+    "override_level": null,
+    "effective_level": 2,
+    "effective_key": "balanced",
+    "effective_label": "Balanced",
+    "contract": "Wandering: Balanced. Stay anchored to your claim, but if you hit a genuinely high-value or blocking tangent you may surface it briefly and ask \"capture or pursue?\" — leave the call to the user. Note anomalies as observations; don't rabbit-hole.",
+    "inject": false
+  },
+  "interaction": {
+    "fields": [
+      {
+        "field": "technical_level",
+        "label": "Technical level",
+        "blurb": "How much software-engineering vocabulary to assume.",
+        "default_value": "non_technical",
+        "values": [
+          {
+            "value": "non_technical",
+            "label": "Non-technical (default)"
+          },
+          {
+            "value": "mixed",
+            "label": "Some technical background"
+          },
+          {
+            "value": "engineer",
+            "label": "Engineer"
+          }
+        ]
+      },
+      {
+        "field": "toolchain_familiarity",
+        "label": "Local-toolchain familiarity",
+        "blurb": "Whether local dev tools (package managers, ports, env vars) need step-by-step help.",
+        "default_value": "new",
+        "values": [
+          {
+            "value": "new",
+            "label": "New to local tooling (default)"
+          },
+          {
+            "value": "comfortable",
+            "label": "Comfortable with local tooling"
+          }
+        ]
+      },
+      {
+        "field": "verbosity",
+        "label": "Reply length",
+        "blurb": "How much prose to return by default.",
+        "default_value": "concise",
+        "values": [
+          {
+            "value": "concise",
+            "label": "Concise (default)"
+          },
+          {
+            "value": "detailed",
+            "label": "Detailed"
+          }
+        ]
+      }
+    ],
+    "stored": {},
+    "effective": {
+      "technical_level": "non_technical",
+      "toolchain_familiarity": "new",
+      "verbosity": "concise"
+    },
+    "contract": "",
+    "inject": false
+  },
+  "model_allocation": {
+    "slots": [
+      {
+        "slot": "main",
+        "label": "Main interactive session",
+        "blurb": "The session the builder sits in front of.",
+        "code_default": "opus",
+        "tiers": [
+          "haiku",
+          "sonnet",
+          "opus",
+          "fable"
+        ]
+      },
+      {
+        "slot": "subagentDefault",
+        "label": "Subagents (default)",
+        "blurb": "Research, audits, code review, design, code that ships, parallel build sessions.",
+        "code_default": "opus",
+        "tiers": [
+          "haiku",
+          "sonnet",
+          "opus",
+          "fable"
+        ]
+      },
+      {
+        "slot": "subagentRoutine",
+        "label": "Subagents (routine plumbing)",
+        "blurb": "Mechanical known-path GDS/DB ops: list, fetch-by-id, log a cost row, read a known file.",
+        "code_default": "haiku",
+        "tiers": [
+          "haiku",
+          "sonnet",
+          "opus",
+          "fable"
+        ]
+      }
+    ],
+    "allowed_tiers": [
+      "haiku",
+      "sonnet",
+      "opus",
+      "fable"
+    ],
+    "code_defaults": {
+      "main": "opus",
+      "subagentDefault": "opus",
+      "subagentRoutine": "haiku"
+    },
+    "instance_default": {
+      "main": "opus",
+      "subagentDefault": "opus",
+      "subagentRoutine": "haiku"
+    },
+    "override": {},
+    "effective": {
+      "main": "opus",
+      "subagentDefault": "opus",
+      "subagentRoutine": "haiku"
+    },
+    "contract": "Model allocation — main session: opus; subagents default: opus, routine plumbing: haiku. Set the Agent `model` param explicitly per this allocation."
+  },
+  "render": {
+    "widgets_enabled": false,
+    "default_enabled": true,
+    "override": false
+  },
+  "needs": {
+    "items": [
+      {
+        "id": "art_key",
+        "title": "Image-generation key",
+        "what": "The art pipeline draws your tiles and sprites with Google AI Studio (Gemini).",
+        "learn_more_url": "https://aistudio.google.com/app/apikey",
+        "state": "action_needed",
+        "severity": "action",
+        "message": "Your free art coverage has ended, so image generation now runs on your own key (you pay only for what you make). Add it to keep making art.",
+        "action": {
+          "label": "Add your key",
+          "href": "/settings#art-key"
+        }
+      }
+    ],
+    "action_needed_count": 1,
+    "has_action_needed": true
+  }
+}