feat: add trailer, docs site, diagrams and a hardened redeployed contract

.github/workflows/client.yml

@@ -35,9 +35,15 @@ jobs:
       - name: Typecheck
         working-directory: client
         run: bun run typecheck
+      - name: Lint
+        working-directory: client
+        run: bun run lint
+      - name: Format
+        working-directory: client
+        run: bun run format:check
       - name: Test
         working-directory: client
-        run: bun test
+        run: bun run test:coverage
       - name: Build
         working-directory: client
         run: bun run build

.github/workflows/contract.yml

@@ -27,13 +27,20 @@ jobs:
       - uses: dtolnay/rust-toolchain@1.97.1
         with:
           targets: wasm32v1-none
+          components: rustfmt, clippy
       - uses: actions/cache@v4
         with:
           path: |
             ~/.cargo/registry/index
             ~/.cargo/registry/cache
             ~/.cargo/git/db
           key: cargo-${{ runner.os }}-1.97.1-${{ hashFiles('contracts/deepmark-contract/Cargo.lock') }}
+      - name: Format
+        working-directory: contracts/deepmark-contract
+        run: cargo fmt --check
+      - name: Clippy
+        working-directory: contracts/deepmark-contract
+        run: cargo clippy --all-targets -- -D warnings
       - name: Test
         working-directory: contracts/deepmark-contract
         run: cargo test

.github/workflows/diagrams.yml

@@ -0,0 +1,35 @@
+name: diagrams
+
+on:
+  pull_request:
+    paths:
+      - diagrams/**
+      - .github/workflows/diagrams.yml
+  push:
+    branches: [main]
+    paths:
+      - diagrams/**
+      - .github/workflows/diagrams.yml
+
+permissions:
+  contents: read
+
+concurrency:
+  group: diagrams-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  diagrams:
+    name: diagrams
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: diagrams
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.14
+      - run: bun install --frozen-lockfile
+      - run: bun run typecheck
+      - run: bun run check

CLAUDE.md

@@ -1,6 +1,6 @@
 # Deepmark
 
-Deepmark is a turn-based dungeon-crawler roguelite with a bank-or-push extraction mechanic, built on Stellar/Soroban for the Find Your Way Meridian Hackathon (submission deadline: October 5, 2026, 4:00 PM Costa Rica time). See `docs/architecture/onchain-boundary.md` for what lives on-chain and why.
+Deepmark is a turn-based dungeon-crawler roguelite with a bank-or-push extraction mechanic, built on Stellar/Soroban for the Find Your Way Meridian Hackathon (submission deadline: October 12, 2026). See `docs/architecture/onchain-boundary.md` for what lives on-chain and why.
 
 ## Mission
 

client/biome.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": false },
+  "files": {
+    "includes": [
+      "src/**/*.ts",
+      "tests/**/*.ts",
+      "scripts/**/*.ts",
+      "docs-site/**/*.ts",
+      "vite.config.ts",
+      "biome.json",
+      "!src/game/kitDifficulty.generated.ts"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 140
+  },
+  "javascript": {
+    "formatter": { "quoteStyle": "single", "semicolons": "always", "trailingCommas": "es5" }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "preset": "recommended",
+      "suspicious": { "noExplicitAny": "error", "noEmptyBlockStatements": "error" },
+      "style": { "noNonNullAssertion": "error" }
+    }
+  },
+  "overrides": [{ "includes": ["tests/**"], "linter": { "rules": { "style": { "noNonNullAssertion": "off" } } } }],
+  "assist": { "enabled": false }
+}

client/docs-site/diagrams.ts

@@ -0,0 +1,43 @@
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { DIAGRAMS_DIR } from './manifest';
+import { REPO_ROOT } from './sources';
+
+export interface Diagram {
+  /** File name without extension, also the anchor on the diagrams page. */
+  stem: string;
+  file: string;
+  title: string;
+  description: string;
+  bytes: Uint8Array;
+}
+
+function tagText(svg: string, tag: 'title' | 'desc'): string {
+  const match = new RegExp(`<${tag}\\s+id="[^"]*">([\\s\\S]*?)</${tag}>`).exec(svg);
+  return match?.[1]?.trim() ?? '';
+}
+
+function decodeEntities(text: string): string {
+  return text
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'")
+    .replace(/&amp;/g, '&');
+}
+
+/** Read every diagram. Fails when one has no title or description for its alt text. */
+export function loadDiagrams(): Diagram[] {
+  const dir = join(REPO_ROOT, DIAGRAMS_DIR);
+  return readdirSync(dir)
+    .filter((name) => name.endsWith('.svg'))
+    .sort()
+    .map((name) => {
+      const bytes = readFileSync(join(dir, name));
+      const svg = bytes.toString('utf8');
+      const title = decodeEntities(tagText(svg, 'title'));
+      const description = decodeEntities(tagText(svg, 'desc'));
+      if (!title || !description) throw new Error(`docs: ${DIAGRAMS_DIR}/${name} has no title or desc for alt text`);
+      return { stem: name.replace(/\.svg$/, ''), file: `${DIAGRAMS_DIR}/${name}`, title, description, bytes };
+    });
+}