dreamboard 0.1.7 → 0.1.9

package/skills/dreamboard/references/ui-genre-worker-placement.md

@@ -1,143 +0,0 @@
-# UI Guide: Worker Placement Games
-
-Patterns for Agricola, Viticulture, Lords of Waterdeep, Caverna, and similar euro-style worker placement games.
-
-## Game characteristics
-
-- Players place **worker tokens** on shared **action slots** to gain resources or take actions.
-- Slots may be exclusive (one player per round) or shared.
-- Phases typically include: placement, resolution/harvest, and cleanup.
-- Key UI signals: available slots, slot costs/rewards, number of workers remaining, resource counts.
-
-## Recommended SDK components
-
-### Primary
-
-| Component             | Usage                                                                                                 |
-| --------------------- | ----------------------------------------------------------------------------------------------------- |
-| `SlotSystem`          | Core board — renders all action slots with occupants. Use `layout="grouped"` to organize by category. |
-| `DefaultSlotItem`     | Pre-built slot renderer showing name, description, capacity, cost/reward labels.                      |
-| `DefaultSlotOccupant` | Pre-built worker token display with player color.                                                     |
-| `ResourceCounter`     | Display each player's resource pool (wood, stone, food, etc.).                                        |
-| `ActionButton`        | "Place Worker" button with integrated cost display and affordability check.                           |
-
-### Supporting
-
-| Component                     | Usage                                                        |
-| ----------------------------- | ------------------------------------------------------------ |
-| `ActionPanel` / `ActionGroup` | Group available actions (e.g., "Place Worker", "End Turn").  |
-| `CostDisplay`                 | Show resource costs on slot details.                         |
-| `PlayerInfo`                  | Show each player's name, workers remaining, and turn status. |
-| `PhaseIndicator`              | Distinguish placement phase from harvest/scoring phases.     |
-| `GameEndDisplay`              | Final scoring with detailed breakdown.                       |
-| `Drawer`                      | Mobile drawer for detailed slot inspection.                  |
-
-### Hooks
-
-| Hook                              | Usage                                                                                          |
-| --------------------------------- | ---------------------------------------------------------------------------------------------- |
-| `useSlotSystem(slots, occupants)` | Utility for slot lookups: `getSlot`, `isFull`, `getRemainingCapacity`, `getOccupantsByPlayer`. |
-| `useMyResources()`                | Current player's resource pool.                                                                |
-| `useGameState`                    | Get `isMyTurn`, `currentState`, `currentPlayerIds`.                                            |
-| `useAction`                       | Submit place-worker or end-turn actions.                                                       |
-| `useUIArgs`                       | Get phase-specific data (available slots, worker count, etc.).                                 |
-| `usePlayerInfo`                   | Map player IDs to names and colors.                                                            |
-
-## Key patterns
-
-### Slot board with placement
-
-```tsx
-const { placementPhase } = useUIArgs();
-const slots = placementPhase?.slots ?? [];
-const occupants = placementPhase?.occupants ?? [];
-const availableSlotIds = new Set(placementPhase?.availableSlotIds ?? []);
-const slotApi = useSlotSystem(slots, occupants);
-
-<SlotSystem
-  slots={slots}
-  occupants={occupants}
-  layout="grouped"
-  renderSlot={(slot, slotOccupants) => (
-    <DefaultSlotItem
-      name={slot.name}
-      description={slot.description}
-      capacity={slot.capacity}
-      occupantCount={slotOccupants.length}
-      isExclusive={slot.exclusive}
-      isAvailable={availableSlotIds.has(slot.id)}
-      costLabel={formatCost(slot.cost)}
-      rewardLabel={formatReward(slot.reward)}
-      onClick={() => handlePlaceWorker(slot.id)}
-      renderOccupants={() => (
-        <div className="flex gap-1">
-          {slotOccupants.map((o) => (
-            <DefaultSlotOccupant
-              key={o.pieceId}
-              color={playerColors[o.playerId]}
-              label={playerInfo[o.playerId]?.name}
-            />
-          ))}
-        </div>
-      )}
-    />
-  )}
-/>;
-```
-
-### Resource display
-
-```tsx
-const resources = useMyResources();
-
-<ResourceCounter
-  resources={[
-    {
-      type: "wood",
-      label: "Wood",
-      icon: TreePine,
-      iconColor: "text-amber-700",
-    },
-    {
-      type: "stone",
-      label: "Stone",
-      icon: Mountain,
-      iconColor: "text-slate-400",
-    },
-    { type: "food", label: "Food", icon: Apple, iconColor: "text-red-400" },
-    { type: "gold", label: "Gold", icon: Coins, iconColor: "text-yellow-400" },
-  ]}
-  counts={resources}
-  layout="row"
-/>;
-```
-
-### Action buttons with costs
-
-```tsx
-<ActionButton
-  label="Build Farm"
-  cost={{ wood: 2, stone: 1 }}
-  currentResources={resources}
-  resourceDefs={resourceDefinitions}
-  icon={Home}
-  onClick={() => actions.buildActions.build({ buildingType: "farm" })}
-/>
-```
-
-## UIArgs recommendations
-
-```typescript
-// shared/ui-args.ts
-export interface PlacementPhaseUIArgs {
-  slots: SlotDefinition[];
-  occupants: SlotOccupant[];
-  availableSlotIds: string[]; // Slots the current player can legally place on
-  workersRemaining: number;
-}
-
-export interface HarvestPhaseUIArgs {
-  feedingRequired: number; // Food needed
-  currentFood: number;
-}
-```

package/skills/dreamboard/references/ui-style-guide.md

@@ -1,54 +0,0 @@
-# UI Style Guide
-
-This style guide details the design philosophy, visual tokens, and core components for the Dreamboard.games UI SDK. The framework uses a **Hand-Drawn** aesthetic that emphasizes human creativity over corporate polish.
-
-## Design Philosophy
-
-The Hand-Drawn design style celebrates authentic imperfection and human touch in a digital world. It rejects clinical precision in favor of organic, playful irregularity that evokes sketches on paper, sticky notes on a wall, and napkin diagrams from a brainstorming session.
-
-### Core Principles
-
-- **No Straight Lines**: Every border, shape, and container uses irregular border-radius values to create wobbly, hand-drawn edges that reject geometric perfection.
-- **Authentic Texture**: The design layer paper grain, dot patterns, and subtle background textures to simulate physical media (notebook paper, post-its, sketch pads).
-- **Playful Rotation**: Elements are deliberately tilted using small rotation transforms (`-rotate-1`, `rotate-2`) to break rigid grid alignment and create casual energy.
-- **Hard Offset Shadows**: Reject soft blur shadows entirely. Use solid, offset box-shadows (like `4px 4px 0px`) to create a cut-paper, layered collage aesthetic.
-- **Handwritten Typography**: Use exclusively handwritten or marker-style fonts (like Kalam for headings and Patrick Hand for body text) that feel human and approachable.
-- **Limited Color Palette**: Stick to pencil blacks (`#2d2d2d`), paper whites (`#fdfbf7`), correction marker red (`#ff4d4d`), post-it yellow (`#fff9c4`), and ballpoint blue (`#2d5da1`).
-- **Intentional Messiness**: Embrace overlap, asymmetry, and visual "mistakes" that make the design feel spontaneous.
-
-## CSS Tokens & Utilities
-
-The platform provides several global CSS utilities designed for this aesthetic:
-
-- **Borders**: `.wobbly-border`, `.wobbly-border-md`, `.wobbly-border-lg` apply the irregular `border-radius` shapes. Used with `border-2`, `border-[3px]`, or `border-[4px]`.
-- **Shadows**: `.hard-shadow`, `.hard-shadow-md`, `.hard-shadow-lg` apply the solid offset shadows. Use `.hard-shadow-sm` for active states (buttons pressing flat).
-
-## Implementing in Components
-
-When writing or modifying UI components in `ui/` or `ui-sdk/`:
-
-### Containers & Cards
-
-- Add `wobbly-border-md` or `wobbly-border-lg`.
-- Use `border-[3px] border-border` to give it a thick pencil-like stroke.
-- Apply `bg-[#fdfbf7]` (warm paper) or `bg-white`.
-- Add a solid shadow with `hard-shadow` or `hard-shadow-lg`.
-- Slightly rotate the element with `rotate-1` or `-rotate-1`.
-
-### Buttons
-
-- Use `wobbly-border`.
-- Normal state: `border-[3px] border-border bg-[#fdfbf7] text-foreground hard-shadow`.
-- Hover state: `hover:bg-primary hover:text-white hover:hard-shadow-sm hover:-translate-y-1`.
-- Active state: `active:shadow-none active:translate-y-1 active:translate-x-1`.
-- Secondary variants can use `bg-[#e5e0d8]` or `bg-[#fff9c4]`.
-
-### Typography
-
-- Add `font-sans` for standard handwritten text or `font-display` for bold marker headings.
-- Make things bold! `font-bold` works well with handwritten fonts to make them legible.
-
-### Decoration
-
-- For emphasis, wrap text in a post-it styling: `bg-[#fff9c4] px-2 py-1 border-2 border-border wobbly-border rotate-2 inline-block`.
-- Add "tape" to tops of containers: `<div className="absolute top-2 left-1/2 -translate-x-1/2 w-24 h-6 bg-[#e5e0d8] border border-border opacity-80 backdrop-blur-sm -rotate-2 z-10" />`.

package/skills/dreamboard/scripts/events-extract.mjs

@@ -1,218 +0,0 @@
-#!/usr/bin/env node
-
-import { access, readFile } from "node:fs/promises";
-
-const DEFAULT_EVENTS_PATH = ".dreamboard/run/events.ndjson";
-
-function printHelp() {
-  console.log(`Extract fields from dreamboard run artifacts.
-
-Usage:
-  node .agents/skills/dreamboard/scripts/events-extract.mjs [options]
-
-Options:
-  --file, -f <path>       NDJSON file path (default: ${DEFAULT_EVENTS_PATH})
-  --type <eventType>      Filter by event type (repeatable)
-  --field <path>          Dot path to extract (e.g. message.reason)
-  --player <playerId>     Filter by player ID across common message fields
-  --limit <number>        Limit output records
-  --no-index              Omit line index in output
-  --help, -h              Show this help
-
-Examples:
-  node .agents/skills/dreamboard/scripts/events-extract.mjs --type YOUR_TURN
-  node .agents/skills/dreamboard/scripts/events-extract.mjs --type ACTION_REJECTED --field message.reason
-  node .agents/skills/dreamboard/scripts/events-extract.mjs --player player-2 --field message.availableActions
-`);
-}
-
-function parseCliArgs(argv) {
-  const options = {
-    filePath: DEFAULT_EVENTS_PATH,
-    types: new Set(),
-    includeIndex: true,
-  };
-
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    const nextToken = argv[index + 1];
-
-    if (token === "--help" || token === "-h") {
-      printHelp();
-      process.exit(0);
-    }
-    if (token === "--no-index") {
-      options.includeIndex = false;
-      continue;
-    }
-    if (token === "--file" || token === "-f") {
-      if (!nextToken) {
-        throw new Error("--file requires a value");
-      }
-      options.filePath = nextToken;
-      index += 1;
-      continue;
-    }
-    if (token === "--type") {
-      if (!nextToken) {
-        throw new Error("--type requires a value");
-      }
-      options.types.add(nextToken);
-      index += 1;
-      continue;
-    }
-    if (token === "--field") {
-      if (!nextToken) {
-        throw new Error("--field requires a value");
-      }
-      options.fieldPath = nextToken;
-      index += 1;
-      continue;
-    }
-    if (token === "--player") {
-      if (!nextToken) {
-        throw new Error("--player requires a value");
-      }
-      options.playerId = nextToken;
-      index += 1;
-      continue;
-    }
-    if (token === "--limit") {
-      if (!nextToken) {
-        throw new Error("--limit requires a value");
-      }
-      const parsed = Number.parseInt(nextToken, 10);
-      if (!Number.isFinite(parsed) || parsed <= 0) {
-        throw new Error("--limit must be a positive integer");
-      }
-      options.limit = parsed;
-      index += 1;
-      continue;
-    }
-
-    throw new Error(`Unknown argument: ${token}`);
-  }
-
-  return options;
-}
-
-function getByPath(value, path) {
-  const segments = path.split(".").filter(Boolean);
-  let current = value;
-
-  for (const segment of segments) {
-    if (current === null || current === undefined) {
-      return undefined;
-    }
-    if (typeof current !== "object") {
-      return undefined;
-    }
-    current = current[segment];
-  }
-
-  return current;
-}
-
-function extractPlayerCandidates(record) {
-  const message = record.message ?? {};
-  const players = new Set();
-
-  const singleCandidates = [
-    message.playerId,
-    message.targetPlayer,
-    message.toUser,
-  ];
-  for (const candidate of singleCandidates) {
-    if (typeof candidate === "string") {
-      players.add(candidate);
-    }
-  }
-
-  const listCandidates = [
-    message.activePlayers,
-    message.previousPlayers,
-    message.currentPlayers,
-    message.controllablePlayerIds,
-    message.eligiblePlayerIds,
-  ];
-  for (const candidate of listCandidates) {
-    if (!Array.isArray(candidate)) {
-      continue;
-    }
-    for (const item of candidate) {
-      if (typeof item === "string") {
-        players.add(item);
-      }
-    }
-  }
-
-  return [...players];
-}
-
-function toOutputRecord(record, lineIndex, options) {
-  const output = {};
-
-  if (options.includeIndex) {
-    output.index = lineIndex;
-  }
-  output.observedAt = record.observedAt ?? null;
-  output.sessionId = record.sessionId ?? null;
-  output.eventId = record.eventId ?? null;
-  output.type = record.type ?? null;
-
-  if (options.fieldPath) {
-    output.field = options.fieldPath;
-    output.value = getByPath(record, options.fieldPath);
-  } else {
-    output.message = record.message ?? null;
-  }
-
-  return output;
-}
-
-async function main() {
-  const options = parseCliArgs(process.argv.slice(2));
-  await access(options.filePath);
-
-  const text = await readFile(options.filePath, "utf8");
-  const lines = text
-    .split(/\r?\n/u)
-    .map((line) => line.trim())
-    .filter((line) => line.length > 0);
-
-  let emitted = 0;
-  for (let lineIndex = 0; lineIndex < lines.length; lineIndex += 1) {
-    const line = lines[lineIndex];
-    let record;
-    try {
-      record = JSON.parse(line);
-    } catch {
-      continue;
-    }
-
-    if (options.types.size > 0 && !options.types.has(record.type ?? "")) {
-      continue;
-    }
-
-    if (options.playerId) {
-      const players = extractPlayerCandidates(record);
-      if (!players.includes(options.playerId)) {
-        continue;
-      }
-    }
-
-    const output = toOutputRecord(record, lineIndex + 1, options);
-    console.log(JSON.stringify(output));
-    emitted += 1;
-
-    if (options.limit !== undefined && emitted >= options.limit) {
-      break;
-    }
-  }
-}
-
-main().catch((error) => {
-  const message = error instanceof Error ? error.message : String(error);
-  console.error(`events-extract failed: ${message}`);
-  process.exit(1);
-});