analyzthis_design 2.5.2 → 2.6.0

package/README.md

@@ -4,6 +4,13 @@ A set of AI design personas and a task-first evaluation framework that plugs int
 
 Install once. Run structured UX critiques, multi-phase ideation, and task-grounded screen reviews — directly inside your AI chat. **No external LLM API keys required** for CLI orchestrator runs: **`/devi`** voices each persona from your host IDE (Cursor, Claude, etc.).
 
+## v2.6.0 — Mood boards you decide on, now with scroll films
+
+- **Element collage:** Zara crops 20–24 real UI elements from 6+ live sites into sections (first screen, typography, colour, components, imagery, motion), each with its source page and real colours and fonts.
+- **You decide:** `moodboard show` opens a clickable board on 127.0.0.1. Keep / maybe / reject overrides every persona; rejected tiles never come back; `lock` saves the direction every persona follows.
+- **Scroll films:** `moodboard film --board <id> --url <site>` records the real page scrolling through four depths as a looping motion tile with waypoint stills. Needs the optional `playwright-core` and Google Chrome.
+- **Install fix:** the `mood-board` skill is now copied by `npx analyzthis_design` (it was missing before).
+
 ## v2.5.2 — Motion, UX, and visual-design libraries
 
 Personas cite real packages and prefer what is already in the repo:
@@ -106,7 +113,7 @@ Pass `--global` to opt into the legacy merged behavior (read `config.sources` an
 
 Use `npx analyzthis_design run-unchunked` for the legacy single-pass orchestrator.
 
-**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.5.2 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
+**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.6.0 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
 
 ---
 
@@ -871,10 +878,14 @@ npx analyzthis_design outcome --infer [--window N]
 npx analyzthis_design outcome --pending
 npx analyzthis_design outcome --confirm --persona <id> --result shipped|revised|blocked|missed
 
-# Mood board (v1.22)
-npx analyzthis_design moodboard create --task "..." [--auto] [--url <url> ...]
-npx analyzthis_design moodboard critique --board <id>
-npx analyzthis_design moodboard add --board <id> --url <url> --title "..." --tags a,b
+# Mood board — visual element collage, user decides
+npx analyzthis_design moodboard create --task "..." [--adjectives a,b,c] [--not "..."] [--sections components,typography]
+npx analyzthis_design moodboard tile --board <id> --page <url> --image <crop> --element "..." --section components
+npx analyzthis_design moodboard critique --board <id>      # team votes = advice
+npx analyzthis_design moodboard film --board <id> --url <url>   # scroll film as a motion tile (needs playwright-core + Chrome)
+npx analyzthis_design moodboard show --board <id>          # you keep / maybe / reject in the browser
+npx analyzthis_design moodboard rescout --board <id> --note "..."
+npx analyzthis_design moodboard lock --board <id>          # saves design_direction for every persona
 npx analyzthis_design moodboard list
 
 # Devi — host LLM queue (v1.20)
@@ -917,7 +928,8 @@ lib/
   reference-pack.js     Shared multi-file CSV + vault retrieval (buildReferencePack)
   mcp-server.js         MCP server — 19 tools for any MCP-compatible IDE
   system-prompt.js      Consolidated prompt generator (fallback for non-MCP tools)
-  moodboard.js          Mood-board engine: collect web/DS references, tag, deliberate
+  moodboard.js          Mood-board engine: element tiles, persona advice, user decisions, lock
+  moodboard-view.js     Visual board page + local 127.0.0.1 server for keep / maybe / reject
   dedup.js              Cross-persona redundancy detection
   lessons.js            Self-evolving lessons store (extract/retrieve/inject)
   outcome.js            Infer + confirm persona outcome labels
@@ -1002,7 +1014,7 @@ skills/
 
 | Feature | Description |
 |---------|-------------|
-| **Mood boards** | Tagged URLs + team deliberation. **UI image boards:** Zara scouts 3–5 real shipped screens; Arjun/Noor/Priya/Meera jury; she re-scouts if they skip (max 3 rounds) |
+| **Mood boards** | Zara crops 20–24 real UI elements from 6+ live sites into a sectioned visual collage with each site's real colours and fonts, plus optional scroll films (looping video + four waypoint stills) for motion feel. Arjun/Noor/Priya/Meera vote as advice. **You** keep / maybe / reject in the browser — your choice overrides every persona, rejected tiles never return, and the locked direction is saved for all personas. `--kind mood` keeps the older tagged-URL board |
 | **User-contributed references** | User can add URLs/notes to a board and rerun the critique loop |
 | **Visual direction setting** | Arjun, Meera, Priya, Zara, Noor score references via the UX Honeycomb rigor matrix |
 | **Workspace artifacts** | `moodboard/{boardId}.json` is written into the project for the user to inspect |

package/agents/cards/mood-board.md

@@ -1,14 +1,13 @@
 You are the Mood Board conductor. You do not have a design opinion of your own.
 
 Your job is to:
-1. Collect visual/textual references for a design direction.
-2. Tag references with style, mood, surface, and relevant keywords.
-3. Pull matching design-system tokens, styles, and patterns from the reference CSVs.
-4. Run Arjun, Meera, Priya, Zara, and Noor through adversarial deliberation over the board.
-5. On a **ui** board: Zara scouts real screens first. Arjun, Noor, Priya, Meera jury. She re-scouts if they skip (max 3 rounds).
-6. Write `board.json` to the session and a workspace copy the user can open.
-7. Accept user-contributed references and rerun the loop.
+1. Write the brief (job, 3 adjectives, one "not this", sections) and confirm it with the user.
+2. Have Zara crop 20–24 real UI elements from 6+ live sites — one element per tile, each with its source page, real colours and fonts, and steal / refuse / peak.
+3. Run Arjun, Noor, Priya, and Meera over the tiles. Their keep / skip votes are advice.
+4. Open the visual board for the user. The user's keep / maybe / reject overrides every persona.
+5. Send Zara back with the user's notes when asked. Rejected tiles never return.
+6. Lock the user's direction into the session (`design_direction`) so every persona builds from it.
 
-Always assess-only: never write code or final wireframes. Produce the structured board artifact and a synthesis of the team's direction.
+Never record a decision for the user that they did not make. Never write code or final wireframes.
 
 Cite design-system rows using the format: `[filename, row N: "exact quoted value"]`.

package/agents/manifests/mood-board.json

@@ -6,19 +6,23 @@
   "system_card": "agents/cards/mood-board.md",
   "system_skill": "skills/mood-board/SKILL.md",
   "allowed_jobs": [
-    "collect web references for visual direction",
-    "run a Zara UI-image-board scout then a jury loop",
-    "tag references with style, mood, surface",
-    "retrieve design-system patterns for the task",
-    "orchestrate team deliberation over references",
-    "write board.json artifacts",
-    "accept user-contributed references and rerun"
+    "write a brief and confirm it with the user",
+    "have Zara crop real UI elements from live sites into a sectioned collage",
+    "read real colours, fonts, radius and spacing from each source page",
+    "collect persona votes on each tile as advice",
+    "open the visual board for the user to keep / maybe / reject",
+    "send Zara back with the user's notes",
+    "lock the user's direction into the session for every persona",
+    "keep the older link-and-tag board (kind mood)"
   ],
   "forbidden_jobs": [
     "produce final wireframes or code",
     "replace the design-critic chain for screen review",
-    "auto-apply design system changes"
+    "auto-apply design system changes",
+    "record a user decision the user did not make",
+    "let a persona vote override the user's choice",
+    "add a tile without its source page"
   ],
-  "hard_gates": [],
+  "hard_gates": ["user_decides_before_lock"],
   "parallel_safe_with": []
 }

package/agents/router.json

@@ -93,7 +93,7 @@
       "signals": ["mood board", "mood-board", "/mood-board", "visual direction", "references", "inspiration", "style direction", "design direction", "ui board", "image board", "ui image board"],
       "route_to": ["mood-board"],
       "never_route_to": ["design-critic_chain", "zara", "noor_alone"],
-      "notes": "Visual direction setting — collect references, tag them, pull DS patterns, run team deliberation. Not a screen critique."
+      "notes": "Visual direction setting — Zara crops real UI elements into a collage, the team votes as advice, the user decides in the browser and locks the direction. Not a screen critique."
     }
   ]
 }

package/dist/README.md

@@ -4,6 +4,13 @@ A set of AI design personas and a task-first evaluation framework that plugs int
 
 Install once. Run structured UX critiques, multi-phase ideation, and task-grounded screen reviews — directly inside your AI chat. **No external LLM API keys required** for CLI orchestrator runs: **`/devi`** voices each persona from your host IDE (Cursor, Claude, etc.).
 
+## v2.6.0 — Mood boards you decide on, now with scroll films
+
+- **Element collage:** Zara crops 20–24 real UI elements from 6+ live sites into sections (first screen, typography, colour, components, imagery, motion), each with its source page and real colours and fonts.
+- **You decide:** `moodboard show` opens a clickable board on 127.0.0.1. Keep / maybe / reject overrides every persona; rejected tiles never come back; `lock` saves the direction every persona follows.
+- **Scroll films:** `moodboard film --board <id> --url <site>` records the real page scrolling through four depths as a looping motion tile with waypoint stills. Needs the optional `playwright-core` and Google Chrome.
+- **Install fix:** the `mood-board` skill is now copied by `npx analyzthis_design` (it was missing before).
+
 ## v2.5.2 — Motion, UX, and visual-design libraries
 
 Personas cite real packages and prefer what is already in the repo:
@@ -106,7 +113,7 @@ Pass `--global` to opt into the legacy merged behavior (read `config.sources` an
 
 Use `npx analyzthis_design run-unchunked` for the legacy single-pass orchestrator.
 
-**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.5.2 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
+**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.6.0 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
 
 ---
 
@@ -871,10 +878,14 @@ npx analyzthis_design outcome --infer [--window N]
 npx analyzthis_design outcome --pending
 npx analyzthis_design outcome --confirm --persona <id> --result shipped|revised|blocked|missed
 
-# Mood board (v1.22)
-npx analyzthis_design moodboard create --task "..." [--auto] [--url <url> ...]
-npx analyzthis_design moodboard critique --board <id>
-npx analyzthis_design moodboard add --board <id> --url <url> --title "..." --tags a,b
+# Mood board — visual element collage, user decides
+npx analyzthis_design moodboard create --task "..." [--adjectives a,b,c] [--not "..."] [--sections components,typography]
+npx analyzthis_design moodboard tile --board <id> --page <url> --image <crop> --element "..." --section components
+npx analyzthis_design moodboard critique --board <id>      # team votes = advice
+npx analyzthis_design moodboard film --board <id> --url <url>   # scroll film as a motion tile (needs playwright-core + Chrome)
+npx analyzthis_design moodboard show --board <id>          # you keep / maybe / reject in the browser
+npx analyzthis_design moodboard rescout --board <id> --note "..."
+npx analyzthis_design moodboard lock --board <id>          # saves design_direction for every persona
 npx analyzthis_design moodboard list
 
 # Devi — host LLM queue (v1.20)
@@ -917,7 +928,8 @@ lib/
   reference-pack.js     Shared multi-file CSV + vault retrieval (buildReferencePack)
   mcp-server.js         MCP server — 19 tools for any MCP-compatible IDE
   system-prompt.js      Consolidated prompt generator (fallback for non-MCP tools)
-  moodboard.js          Mood-board engine: collect web/DS references, tag, deliberate
+  moodboard.js          Mood-board engine: element tiles, persona advice, user decisions, lock
+  moodboard-view.js     Visual board page + local 127.0.0.1 server for keep / maybe / reject
   dedup.js              Cross-persona redundancy detection
   lessons.js            Self-evolving lessons store (extract/retrieve/inject)
   outcome.js            Infer + confirm persona outcome labels
@@ -1002,7 +1014,7 @@ skills/
 
 | Feature | Description |
 |---------|-------------|
-| **Mood boards** | Tagged URLs + team deliberation. **UI image boards:** Zara scouts 3–5 real shipped screens; Arjun/Noor/Priya/Meera jury; she re-scouts if they skip (max 3 rounds) |
+| **Mood boards** | Zara crops 20–24 real UI elements from 6+ live sites into a sectioned visual collage with each site's real colours and fonts, plus optional scroll films (looping video + four waypoint stills) for motion feel. Arjun/Noor/Priya/Meera vote as advice. **You** keep / maybe / reject in the browser — your choice overrides every persona, rejected tiles never return, and the locked direction is saved for all personas. `--kind mood` keeps the older tagged-URL board |
 | **User-contributed references** | User can add URLs/notes to a board and rerun the critique loop |
 | **Visual direction setting** | Arjun, Meera, Priya, Zara, Noor score references via the UX Honeycomb rigor matrix |
 | **Workspace artifacts** | `moodboard/{boardId}.json` is written into the project for the user to inspect |

package/dist/agents/cards/mood-board.md

@@ -1,14 +1,13 @@
 You are the Mood Board conductor. You do not have a design opinion of your own.
 
 Your job is to:
-1. Collect visual/textual references for a design direction.
-2. Tag references with style, mood, surface, and relevant keywords.
-3. Pull matching design-system tokens, styles, and patterns from the reference CSVs.
-4. Run Arjun, Meera, Priya, Zara, and Noor through adversarial deliberation over the board.
-5. On a **ui** board: Zara scouts real screens first. Arjun, Noor, Priya, Meera jury. She re-scouts if they skip (max 3 rounds).
-6. Write `board.json` to the session and a workspace copy the user can open.
-7. Accept user-contributed references and rerun the loop.
+1. Write the brief (job, 3 adjectives, one "not this", sections) and confirm it with the user.
+2. Have Zara crop 20–24 real UI elements from 6+ live sites — one element per tile, each with its source page, real colours and fonts, and steal / refuse / peak.
+3. Run Arjun, Noor, Priya, and Meera over the tiles. Their keep / skip votes are advice.
+4. Open the visual board for the user. The user's keep / maybe / reject overrides every persona.
+5. Send Zara back with the user's notes when asked. Rejected tiles never return.
+6. Lock the user's direction into the session (`design_direction`) so every persona builds from it.
 
-Always assess-only: never write code or final wireframes. Produce the structured board artifact and a synthesis of the team's direction.
+Never record a decision for the user that they did not make. Never write code or final wireframes.
 
 Cite design-system rows using the format: `[filename, row N: "exact quoted value"]`.

package/dist/agents/manifests/mood-board.json

@@ -6,19 +6,23 @@
   "system_card": "agents/cards/mood-board.md",
   "system_skill": "skills/mood-board/SKILL.md",
   "allowed_jobs": [
-    "collect web references for visual direction",
-    "run a Zara UI-image-board scout then a jury loop",
-    "tag references with style, mood, surface",
-    "retrieve design-system patterns for the task",
-    "orchestrate team deliberation over references",
-    "write board.json artifacts",
-    "accept user-contributed references and rerun"
+    "write a brief and confirm it with the user",
+    "have Zara crop real UI elements from live sites into a sectioned collage",
+    "read real colours, fonts, radius and spacing from each source page",
+    "collect persona votes on each tile as advice",
+    "open the visual board for the user to keep / maybe / reject",
+    "send Zara back with the user's notes",
+    "lock the user's direction into the session for every persona",
+    "keep the older link-and-tag board (kind mood)"
   ],
   "forbidden_jobs": [
     "produce final wireframes or code",
     "replace the design-critic chain for screen review",
-    "auto-apply design system changes"
+    "auto-apply design system changes",
+    "record a user decision the user did not make",
+    "let a persona vote override the user's choice",
+    "add a tile without its source page"
   ],
-  "hard_gates": [],
+  "hard_gates": ["user_decides_before_lock"],
   "parallel_safe_with": []
 }

package/dist/agents/router.json

@@ -93,7 +93,7 @@
       "signals": ["mood board", "mood-board", "/mood-board", "visual direction", "references", "inspiration", "style direction", "design direction", "ui board", "image board", "ui image board"],
       "route_to": ["mood-board"],
       "never_route_to": ["design-critic_chain", "zara", "noor_alone"],
-      "notes": "Visual direction setting — collect references, tag them, pull DS patterns, run team deliberation. Not a screen critique."
+      "notes": "Visual direction setting — Zara crops real UI elements into a collage, the team votes as advice, the user decides in the browser and locks the direction. Not a screen critique."
     }
   ]
 }

package/dist/bin/cli.js

@@ -102,14 +102,26 @@ Usage:
                             full: all 19 named tools. Or ANALYZTHIS_MCP_CATALOG=full
 
 ── Mood board commands ─────────────────────────────────────
-  moodboard create --task <text>   Build a mood board from web + DS references
-                                    [--url <url> ...] [--auto] [--kind mood|ui]
-  moodboard frames --board <id>    Add Zara scout frames to a --kind ui board
-                                    --url <url> [--title t] [--steal s] [--refuse r] [--peak p]
-  moodboard critique --board <id>  Run team deliberation (jury on ui boards)
-  moodboard add --board <id>       Add a user reference and rerun critique
-                                    [--url <url>] [--title <t>] [--desc <d>]
-                                    [--tags a,b] [--note <text>]
+  moodboard create --task <text>   Start a visual mood board (Zara scouts element crops)
+                                    [--adjectives a,b,c] [--not "..."] [--sections components,typography]
+                                    [--kind mood] for the older link-and-tag board
+  moodboard brief --board <id>     Edit the brief [--adjectives] [--not] [--sections] [--yes]
+  moodboard capture-script          Print the page script that reads real colours/fonts
+                                    [--selector ".pricing-card"]
+  moodboard tile --board <id>      Add one element crop: --page <url> --image <file|url>
+                                    --element "<what>" --section <id> [--steal] [--refuse]
+                                    [--peak] [--colors #hex,..] [--fonts a,b] [--concept]
+                                    [--video film.webm] [--stills a.png,b.png]
+  moodboard film --board <id>      Record real sites scrolling as motion tiles: --url <url>
+                                    (repeatable) [--section motion] [--steal] [--refuse]
+                                    Needs playwright-core + Google Chrome
+  moodboard critique --board <id>  Team votes on each tile (advice only)
+  moodboard votes --board <id>     Save team votes from a JSON file --votes votes.json
+  moodboard show --board <id>      Open the clickable board on 127.0.0.1 [--port 4317]
+  moodboard decide --board <id>    Your choice: --tile <n> --decision keep|maybe|reject|clear
+  moodboard rescout --board <id>   Send Zara back with your note [--note "..."]
+  moodboard lock --board <id>      Lock your direction for every persona [--note "..."]
+  moodboard add --board <id>       Add a reference to a link board and rerun critique
   moodboard list                   List mood boards for this project
 
 ── Reference data (retrieve-on-demand) ───────────────────────
@@ -224,9 +236,10 @@ Usage:
   npx analyzthis_design research --query "EY design system tokens"
 
   npx analyzthis_design moodboard create --task "B2B fintech dashboard, trustworthy, high-contrast" --auto
-  npx analyzthis_design moodboard create --task "Invoice approval, partner signs" --kind ui
-  npx analyzthis_design moodboard frames --board <id> --url https://example.com/shot.png --title "Dense table" --steal "one stamp" --refuse "purple glow"
+  npx analyzthis_design moodboard create --task "Invoice approval, partner signs" --adjectives calm,precise,trusted --not "AI purple hero"
+  npx analyzthis_design moodboard tile --board <id> --page https://linear.app/pricing --image ./crop.png --element "Pricing card" --section components --steal "one quiet CTA"
   npx analyzthis_design moodboard critique --board <boardId>
+  npx analyzthis_design moodboard show --board <boardId>
   npx analyzthis_design moodboard add --board <boardId> --url https://dribbble.com/shots/example --title "Alt hero" --tags "landing,trust"
 
   npx analyzthis_design retrieve --file colors.csv --column "Product Type" --keywords saas,dashboard
@@ -363,6 +376,24 @@ const maxCallsVal = getFlag('max-calls');
 const runsVal = getFlag('runs');
 const deltaVal = getFlag('delta');
 const resumeVal = getFlag('resume');
+const sectionVal = getFlag('section');
+const sectionsVal = getFlag('sections');
+const elementVal = getFlag('element');
+const imageVal = getFlag('image');
+const tileVal = getFlag('tile');
+const decisionVal = getFlag('decision');
+const noteVal = getFlag('note');
+const portVal = getFlag('port');
+const selectorVal = getFlag('selector');
+const adjectivesVal = getFlag('adjectives');
+const notThisVal = getFlag('not');
+const colorsVal = getFlag('colors');
+const fontsVal = getFlag('fonts');
+const votesVal = getFlag('votes');
+const conceptFlag = flags.includes('--concept');
+const videoVal = getFlag('video');
+const stillsVal = getFlag('stills');
+const splitList = (raw) => (raw ? raw.split(',').map((s) => s.trim()).filter(Boolean) : undefined);
 
 // ─── Commands ────────────────────────────────────────────────────────────────
 
@@ -688,7 +719,7 @@ switch (cmd) {
     const msub = flags.find((f) => !f.startsWith('--')) || 'create';
     if (msub === 'create') {
       if (!taskVal) {
-        console.error('\n  ✗  --task is required.  Example: npx analyzthis_design moodboard create --task "B2B fintech dashboard" --auto\n');
+        console.error('\n  ✗  --task is required.  Example: npx analyzthis_design moodboard create --task "B2B fintech dashboard" --adjectives calm,dense,trusted\n');
         process.exit(1);
       }
       (async () => {
@@ -703,14 +734,17 @@ switch (cmd) {
             project: projectVal,
             task: taskVal,
             urls: urls,
-            kind: kindVal || 'mood',
+            kind: kindVal || 'ui',
             discover: autoFlag || urls.length > 0,
             dryRun: dryRunFlag,
+            brief: { adjectives: splitList(adjectivesVal), not_this: notThisVal || '', sections: splitList(sectionsVal) },
           });
-          console.log(`\n✅ ${result.board.kind === 'ui' ? 'UI image board' : 'Mood board'} created: ${result.board.board_id}`);
+          console.log(`\n✅ ${result.board.kind === 'ui' ? 'Mood board (visual)' : 'Link mood board'} created: ${result.board.board_id}`);
           if (result.board.kind === 'ui') {
+            console.log(`   Sections: ${result.board.brief.sections.join(', ')}`);
             console.log(`   Scout:    Zara round ${result.board.scout.round} — ${result.board.scout.status}`);
-            console.log(`   Next:     /zara (Scout Pass), then moodboard frames --board ${result.board.board_id}`);
+            console.log(`   Next:     Zara crops elements, then moodboard tile --board ${result.board.board_id} --page <url> --image <file> --element "<what>" --section components`);
+            console.log(`   Then:     moodboard show --board ${result.board.board_id}  (you decide in the browser)`);
             console.log('');
             console.log(result.board.scout.brief);
             console.log('');
@@ -751,10 +785,7 @@ switch (cmd) {
           console.log(`   Verdict: ${result.board.synthesis?.verdict || 'n/a'}`);
           if (result.board.kind === 'ui' && result.board.scout) {
             console.log(`   Scout:   round ${result.board.scout.round} — ${result.board.scout.status}`);
-            if (result.board.scout.status === 'awaiting_scout') {
-              console.log('');
-              console.log(result.board.scout.brief);
-            }
+            console.log(`   Team votes are advice. You decide: moodboard show --board ${result.board.board_id}`);
           }
           console.log(`   Rounds:  ${result.board.deliberation?.round || 0}`);
           console.log(`   Board:   ${result.boardDir || path.join(session.sessionDir(projectVal || session.getProjectId()), 'moodboard', boardVal)}`);
@@ -770,31 +801,149 @@ switch (cmd) {
       })();
       break;
     }
-    if (msub === 'frames') {
-      if (!boardVal || !urlVal) {
-        console.error('\n  ✗  --board and --url are required.  Example: npx analyzthis_design moodboard frames --board <id> --url https://example.com/shot.png --title "Dense table" --steal "one stamp" --refuse "purple glow"\n');
+    if (msub === 'film') {
+      const urls = flags.filter((f, i) => i > 0 && flags[i - 1] === '--url' && !f.startsWith('--'))
+        .concat(flags.filter((f) => f.startsWith('--url=')).map((f) => f.slice(6)));
+      if (!boardVal || !urls.length) {
+        console.error('\n  ✗  --board and --url are required.  Example: npx analyzthis_design moodboard film --board <id> --url https://osmo.supply --steal "easing taste"\n');
+        process.exit(1);
+      }
+      (async () => {
+        try {
+          console.log(`\n  🎬 Filming ${urls.length} site${urls.length === 1 ? '' : 's'} (about 15 seconds each)…`);
+          const out = await require('../lib/moodboard-film').filmTiles({
+            project: projectVal, boardId: boardVal, urls,
+            section: sectionVal, element: elementVal, steal: stealVal, refuse: refuseVal, peak: peakVal,
+          });
+          out.failed.forEach((f) => console.error(`  ✗  ${f.url}: ${f.reason}`));
+          const added = out.saved ? out.saved.added : [];
+          (out.saved ? out.saved.skipped : []).forEach((s) => console.error(`  ✗  ${s.element}: ${s.reason}`));
+          if (!added.length) process.exit(1);
+          console.log(`\n✅ ${added.length} film tile${added.length === 1 ? '' : 's'} added: ${added.map((t) => '#' + t.n + ' ' + t.site).join(', ')}`);
+          console.log(`   Next: moodboard show --board ${boardVal}\n`);
+        } catch (err) {
+          console.error(`\n  ✗  ${err.message}\n`);
+          process.exit(1);
+        }
+      })();
+      break;
+    }
+    if (msub === 'tile' || msub === 'frames') {
+      const pageUrl = getFlag('page') || urlVal;
+      if (!boardVal || !pageUrl) {
+        console.error('\n  ✗  --board and --page are required.  Example: npx analyzthis_design moodboard tile --board <id> --page https://linear.app/pricing --image ./crop.png --element "Pricing card" --section components --steal "one quiet CTA"\n');
         process.exit(1);
       }
       try {
-        const result = moodboard.addFrames({
+        const result = moodboard.addTiles({
           project: projectVal,
           boardId: boardVal,
-          frame: {
-            url: urlVal,
-            title: titleVal || '',
+          tile: {
+            page_url: pageUrl,
+            element: elementVal || titleVal || '',
+            section: sectionVal || 'components',
+            image_path: imageVal && !/^https?:\/\//i.test(imageVal) ? imageVal : undefined,
+            image_url: imageVal && /^https?:\/\//i.test(imageVal) ? imageVal : (msub === 'frames' ? urlVal : undefined),
+            video_path: videoVal,
+            stills: splitList(stillsVal),
+            tokens: { colors: splitList(colorsVal), fonts: splitList(fontsVal) },
             steal: stealVal || '',
             refuse: refuseVal || '',
             peak: peakVal || '',
+            concept: conceptFlag,
           },
         });
-        console.log(`\n✅ Frame added to UI board ${result.board.board_id} (${result.board.frames.length} total)`);
-        console.log(`   Scout: ${result.board.scout.status} — next: moodboard critique --board ${result.board.board_id}\n`);
+        if (result.skipped.length) {
+          console.error(`\n  ✗  Not added: ${result.skipped.map((s) => s.reason).join('; ')}\n`);
+          process.exit(1);
+        }
+        console.log(`\n✅ Tile #${result.added[0].n} added (${result.board.tiles.length} on the board)`);
+        console.log(`   Next: more tiles, then moodboard critique or moodboard show --board ${result.board.board_id}\n`);
+      } catch (err) {
+        console.error(`\n  ✗  ${err.message}\n`);
+        process.exit(1);
+      }
+      break;
+    }
+    if (msub === 'brief') {
+      try {
+        const result = moodboard.setBrief({
+          project: projectVal, boardId: boardVal,
+          adjectives: splitList(adjectivesVal), not_this: notThisVal, sections: splitList(sectionsVal),
+          confirmed_by_user: yesFlag ? true : undefined,
+        });
+        console.log(`\n✅ Brief saved: ${JSON.stringify(result.board.brief)}\n`);
+      } catch (err) {
+        console.error(`\n  ✗  ${err.message}\n`);
+        process.exit(1);
+      }
+      break;
+    }
+    if (msub === 'votes') {
+      try {
+        const raw = JSON.parse(fs.readFileSync(votesVal, 'utf8'));
+        const result = moodboard.recordPersonaVotes({ project: projectVal, boardId: boardVal, votes: raw.votes || [], verdict: raw.verdict, summary: raw.summary });
+        console.log(`\n✅ Team advice saved. ${result.ignored.length} ignored. Next: moodboard show --board ${result.board.board_id}\n`);
+      } catch (err) {
+        console.error(`\n  ✗  ${err.message}  (usage: moodboard votes --board <id> --votes votes.json)\n`);
+        process.exit(1);
+      }
+      break;
+    }
+    if (msub === 'decide') {
+      try {
+        moodboard.recordUserDecision({ project: projectVal, boardId: boardVal, tile: tileVal, decision: decisionVal, note: noteVal || '' });
+        console.log(`\n✅ Tile ${tileVal}: ${decisionVal}. Your choice overrides every persona.\n`);
+      } catch (err) {
+        console.error(`\n  ✗  ${err.message}  (usage: moodboard decide --board <id> --tile 3 --decision keep|maybe|reject|clear --note "...")\n`);
+        process.exit(1);
+      }
+      break;
+    }
+    if (msub === 'rescout') {
+      try {
+        const result = moodboard.requestRescout({ project: projectVal, boardId: boardVal, note: noteVal || '' });
+        console.log(`\n✅ Zara goes back out (round ${result.board.scout.round}).\n\n${result.board.scout.brief}\n`);
+      } catch (err) {
+        console.error(`\n  ✗  ${err.message}\n`);
+        process.exit(1);
+      }
+      break;
+    }
+    if (msub === 'lock') {
+      try {
+        const result = moodboard.lockDirection({ project: projectVal, boardId: boardVal, note: noteVal || '' });
+        const d = result.board.direction;
+        console.log(`\n✅ Direction locked: ${d.kept.length} kept, ${d.rejected.length} rejected. Saved to session as design_direction.`);
+        if (d.palette.length) console.log(`   Palette: ${d.palette.join(' ')}`);
+        if (d.fonts.length) console.log(`   Fonts:   ${d.fonts.join(', ')}`);
+        console.log('');
       } catch (err) {
         console.error(`\n  ✗  ${err.message}\n`);
         process.exit(1);
       }
       break;
     }
+    if (msub === 'show') {
+      if (!boardVal) {
+        console.error('\n  ✗  --board is required.  Example: npx analyzthis_design moodboard show --board <id>\n');
+        process.exit(1);
+      }
+      require('../lib/moodboard-view').serveBoard({ project: projectVal, boardId: boardVal, port: portVal != null ? portVal : undefined, onChange: (what, b) => {
+        console.log(`   ${new Date().toLocaleTimeString()}  ${what}  — scout: ${b.scout && b.scout.status}`);
+      } }).then((live) => {
+        console.log(`\n✅ Mood board live at ${live.url}`);
+        console.log('   Open it in the browser. Keep / maybe / reject saves instantly. Ctrl+C to stop.\n');
+      }).catch((err) => {
+        console.error(`\n  ✗  ${err.message}\n`);
+        process.exit(1);
+      });
+      break;
+    }
+    if (msub === 'capture-script') {
+      console.log(moodboard.captureScript(selectorVal || 'body', getFlag('text') || ''));
+      break;
+    }
     if (msub === 'add') {
       if (!boardVal) {
         console.error('\n  ✗  --board is required.  Example: npx analyzthis_design moodboard add --board <id> --url <url>\n');
@@ -845,7 +994,7 @@ switch (cmd) {
       }
       break;
     }
-    console.error('\n  Unknown moodboard subcommand. Use: create | frames | critique | add | list\n');
+    console.error('\n  Unknown moodboard subcommand. Use: create | brief | tile | critique | votes | show | decide | rescout | lock | capture-script | add | list\n');
     process.exit(1);
   }
 

package/dist/lib/install.js

@@ -59,6 +59,7 @@ const SKILLS = [
   'evolve-check',
   'devi',
   'design-director',
+  'mood-board',
   'design-spec',
   'design-personas',
   'design-reference',