@navipartner/demo-video 0.5.1 → 0.7.0

package/README.md

@@ -1,128 +1,104 @@
 # @navipartner/demo-video
 
-Marketing demo videos of React apps.
+Marketing demo videos of React apps, in the NaviPartner look: calm camera
+pushes and serif statement cards. The engine films an app on its own
+Playwright e2e mocks, frame by frame at 60 fps, so pans stay smooth. It
+works in pnpm repos on GitHub Actions, with `@playwright/test` 1.59 or later.
 
-- Filmed on the app's own e2e mocks.
-- NaviPartner look: camera pushes, serif cards.
-- Any customer's brand, chosen per video.
-- Smooth 60 fps, frame by frame.
-- pnpm repos, GitHub Actions, `@playwright/test` 1.59+.
+NaviPartner's brand is the only one kept. A video in a customer's branding
+is made in Linear, where @Linear researches their brand for that one video
+and saves nothing.
 
 ## Setup
 
+From the repo root:
+
     npx --ignore-scripts @navipartner/demo-video init
     pnpm install
 
-- Adds the skill, label and workflow.
-- Finds apps with a `playwright.config`.
-- One app: set up directly.
-- Several apps: `init --app <folder>` each.
-- Safe to re-run; `--dry-run` previews.
-- Then ask Claude for a video.
+`init` adds the skill, the `demo video` label and the workflow, and finds
+the apps: folders with a `playwright.config`. A repo with one app is set up
+in one go; with several, run `init --app <folder>` for each one you want.
+It's safe to re-run, and `--dry-run` previews. Then ask Claude for a demo
+video of the app: it writes the adapter and the primary story with you.
 
 ## Get a video
 
-| Ask | Who | You get |
+| Where | Ask | For |
 |---|---|---|
-| @Linear "video of checkout from np-pos for Acme" | Linear users | that story in Acme's brand, attached |
-| @Linear "pitch draft of checkout for Northwind (northwind.example)" | Linear users | a researched brand, attached |
-| `/demo-video` on a PR | members | primary story, from the PR branch |
-| `/demo-video checkout in acme branding` | members | that story, that brand |
-| `/demo-video help` | members | menu of stories and brands |
-| `demo video` label on a PR | whoever labels | every changed story, each push |
-| Actions → Demo video → Run workflow | repo writers | any story, any branch |
-| `pnpm exec demo-video render` | developers | any story, locally |
-
-- Requests only pick existing stories.
-- New stories come via PRs.
-- PR comments: first line is the request.
-- Unknown names get the menu.
+| Linear | @Linear "video of checkout from np-pos" | anyone who wants a video of an existing story |
+| Linear | @Linear "… for Northwind (northwind.example)" | the same, in a customer's researched brand |
+| A PR | the `demo video` label | reviewing the stories the PR adds or changes |
+| A PR | `/demo-video checkout` (`help` for the menu) | filming any story from the PR's branch |
+| Your machine | `pnpm exec demo-video render` | writing and tuning a story |
 
-### In Linear
+Requests only pick existing stories; new stories come through a developer's
+PR. In a PR comment, the first line is the request, a translation is found
+by its language (`checkout in danish`), and a name that doesn't match gets
+the menu.
 
-- Ask @Linear in plain words.
-- Name the repo, story and customer.
-- Follows the skill's `linear.md`.
-- Brand in the repo: 60 fps video.
-- No brand yet: a pitch draft.
-- MP4 and contact sheet attached.
-- Nothing committed, nothing kept.
-- Linear AI credits, no API key.
-- Slow sandbox: ~15× video length.
+### In Linear
 
-### Pitch drafts
+Ask @Linear in plain words, naming the repo, the story and the customer. In
+a coding session it follows the skill's `linear.md`, attaches the MP4 and
+its contact sheet to the issue, and commits nothing. It runs on Linear's AI
+credits; its sandbox is slow, about 15× the video's length at 60 fps.
 
-- @Linear researches the customer's own website.
-- Brand checked, then filmed at 30 fps.
-- Google Fonts stand-ins only.
-- That customer only; check before sending.
+For a customer, the video is a **pitch draft**. @Linear researches their
+brand from their own website, the engine checks it and films at 30 fps, and
+the brand is deleted afterwards. Fonts are Google Fonts stand-ins. A pitch
+draft is for that customer only: check it before sending it, and any other
+use needs their written permission.
 
 ## Stories and brands
 
-- **Story:** `demo/stories/<name>.json`, scenes as JSON.
-- Built only from the mocks.
-- One story per app is primary.
-- **Variant:** `checkout.acme.json`, customer's own words.
-- **Brand:** `demo/brands/<name>.json` plus assets.
-- `navipartner` ships as the default.
-- **Brand needs:** the adapter lists what brands need.
-- Missing needs fail `check`.
-- Customer brands need customer permission.
-- The skill has fields and the look.
+A story is `demo/stories/<name>.json`: the scenes of one journey, built only
+from what the e2e mocks return. One story per app is its primary story. A
+translation is a story of its own, such as `checkout-da.json`, with the same
+flow and its cards in that language.
+
+Repos keep no brands. `navipartner` ships with the engine, `check` refuses a
+`demo/brands/` folder, and stories never name a brand. The adapter's
+`brandNeeds` lists what a brand gives the app (a background image, a
+secondary colour), which is exactly what a pitch draft researches. The skill
+(`skills/np-demo-video/`) has every field and the look.
 
 ## Commands
 
-Run in the app's folder: `pnpm exec demo-video <command>`.
+Run them in the app's folder: `pnpm exec demo-video <command>`.
 
 | Command | Does |
 |---|---|
-| `init` | sets up a repo or app |
-| `list` | stories, primary first |
-| `check` | dry run in seconds, names problems |
-| `render` | MP4, contact sheet, ten stills |
-| `record` / `encode` / `stills` | render in parts |
-| `brand-needs` | what a brand must give |
-| `pitch <proposal.json>` | pitch draft from a researched brand |
-| `pick` | what a request means (workflows) |
-
-| Flag | Means |
-|---|---|
-| `--story <name>` | default: primary story |
-| `--brand <name>` | default: `navipartner` |
-| `--draft` | 30 fps, twice as fast |
-| `--brands <dir>` | extra brands folder, searched first |
-| `--app <dir>` | app folder, default `.` |
-| `--json` | machine-readable output |
-
-Output lands in `demo/out/`. Failures keep Playwright's output in `demo/out/failed/`.
-
-## Develop
+| `init` | sets up a repo or an app |
+| `list` | the stories, primary first |
+| `check` | a dry run in seconds that names what would film badly |
+| `render` | the MP4, a contact sheet and ten stills, in `demo/out/` |
+| `record`, `encode`, `stills` | `render` in parts |
+| `brand-needs` | what a brand must give this app |
+| `pitch <proposal.json>` | a pitch draft from a researched brand |
+| `pick` | what a request means (used by the workflows) |
+
+`--story <name>` picks a story (default: the primary one), `--draft` films
+at 30 fps in about half the time, `--app <dir>` names the app folder and
+`--json` gives machine-readable output. When something fails, Playwright's
+output is kept in `demo/out/failed/`.
+
+## Develop and release
 
     pnpm install
     pnpm test && pnpm typecheck && pnpm lint && pnpm build
 
-- CI runs tests, actionlint, smoke render.
-
-## Release
-
-1. Bump `version` on main.
-2. `git tag vX.Y.Z && git push origin vX.Y.Z`.
-
-- CI publishes to npm (`latest`).
-- Trusted publishing, no npm token.
-- `v0` tag moves along.
-- Manual `release.yml` run: `next` prerelease.
-
-## Public package, private repo
-
-- `check-public.mjs` checks every tarball.
-- Allowed files only, no source maps.
-- No secrets, emails or local paths.
-- Names aren't caught: keep customers out.
+CI runs the tests, actionlint and a smoke render of the fixture app. To
+release, bump `version` in `package.json` on main, then
+`git tag vX.Y.Z && git push origin vX.Y.Z`. CI publishes to npm as `latest`
+through trusted publishing (no npm token) and moves the `v0` tag. Running
+`release.yml` by hand publishes a `next` prerelease.
 
-## Compatibility
+The package is public; this repo is not. `scripts/check-public.mjs` checks
+every tarball for files outside the allowlist, source maps, secrets, emails
+and local paths. It can't catch names, so keep customers and people out of
+everything that ships.
 
-- Projects pin the CLI version.
-- Their workflows follow `v0` immediately.
-- Workflows must support CLI 0.4+.
-- Breaking that means `v1`.
+Projects pin the CLI in their lockfile, but their workflows follow `v0` at
+once. So `render.yml` and `request.yml` must work with every CLI from 0.4;
+anything that can't is `v1`.

package/bin/args.d.mts

@@ -27,9 +27,6 @@ export interface StoryEntry {
   name: string;
   description: string | null;
   primary: boolean;
-  /** A variant: the story it extends, and the brand it is for. */
-  extends?: string;
-  brand?: string | null;
 }
 export function listStories(demoDir: string): StoryEntry[];
 export function resolveStoryboard(

package/bin/args.mjs

@@ -62,10 +62,6 @@ export const listStories = (demoDir) => {
         name: f.slice(0, -".json".length),
         description: story.description ?? null,
         primary: story.primary === true,
-        // A variant: the base story's flow, for one brand.
-        ...(story.extends
-          ? { extends: story.extends, brand: story.brand ?? null }
-          : {}),
       };
     })
     .sort(

package/bin/demo-video.mjs

@@ -9,7 +9,7 @@ import path from "node:path";
 import { listStories, parseArgs } from "./args.mjs";
 import { encodeRecording, extractStillsFrom } from "./encode.mjs";
 import { initApp, initProject } from "./init.mjs";
-import { appMenu, menuMarkdown, pick, pickExact } from "./pick.mjs";
+import { appMenu, menuMarkdown, pick } from "./pick.mjs";
 import { buildPitchBrand } from "./pitch.mjs";
 import { writeRunner } from "./runner.mjs";
 
@@ -124,35 +124,31 @@ const runInit = (argv) => {
   return 0;
 };
 
-// demo-video pick [--request "<text>" | --app <a> --story <s> --brand <b>]
-// [--json] <app dir>...: which existing story and brand a request means
-// (see pick.mjs). --request reads a sentence (a /demo-video comment); the
-// flags are exact names (the Run workflow form).
+// demo-video pick [--request "<text>"] [--json] <app dir>...: which existing
+// story a request means (see pick.mjs): a /demo-video comment, or a request
+// to @Linear. No request: the primary story.
 const runPick = (argv) => {
-  const flags = {};
+  let request = "";
   const dirs = [];
   let json = false;
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     if (arg === "--json") {
       json = true;
-    } else if (["--request", "--app", "--story", "--brand"].includes(arg)) {
-      flags[arg.slice(2)] = argv[++i] ?? "";
+    } else if (arg === "--request") {
+      request = argv[++i] ?? "";
     } else {
       dirs.push(arg);
     }
   }
   if (dirs.length === 0) {
     console.error(
-      'Usage: demo-video pick [--request "<text>" | --app <a> --story <s> --brand <b>] [--json] <app dir>...',
+      'Usage: demo-video pick [--request "<text>"] [--json] <app dir>...',
     );
     return 2;
   }
   const apps = dirs.map((d) => appMenu(path.resolve(d)));
-  const result =
-    flags.request !== undefined
-      ? pick(flags.request, apps)
-      : pickExact(apps, flags);
+  const result = pick(request, apps);
   const out = result.menu
     ? {
         menu: true,
@@ -165,9 +161,7 @@ const runPick = (argv) => {
   } else if (out.menu) {
     console.log(out.markdown);
   } else {
-    console.log(
-      `${out.app}: story ${out.story}, brand ${out.brand ?? "(the app's default)"}`,
-    );
+    console.log(`${out.app}: story ${out.story}`);
   }
   return 0;
 };
@@ -345,7 +339,7 @@ const run = () => {
       } else {
         for (const s of stories) {
           console.log(
-            `${s.primary ? "* " : "  "}${s.name}${s.description ? `: ${s.description}` : ""}${s.extends ? ` (${s.extends}, for ${s.brand})` : ""}`,
+            `${s.primary ? "* " : "  "}${s.name}${s.description ? `: ${s.description}` : ""}`,
           );
         }
       }

package/bin/init.mjs

@@ -22,26 +22,14 @@ const engineVersion = () =>
 
 export const CALLER_WORKFLOW = `name: Demo video
 # The "${LABEL}" label films the stories a PR adds or changes. A comment
-# "/demo-video [<story>] [in <brand> branding]" on a PR, or Actions → Demo
-# video → Run workflow, films an existing story with a brand. In Linear, ask
-# @Linear (the skill's linear.md), pitch drafts included.
+# "/demo-video [<story>]" on a PR films an existing story in NaviPartner's
+# brand. A customer's branding: ask
+# @Linear (the skill's linear.md); repos keep no brands.
 on:
   pull_request:
     types: [labeled, synchronize]
   issue_comment:
     types: [created]
-  # Actions → Demo video → Run workflow: film a story with a brand.
-  workflow_dispatch:
-    inputs:
-      app:
-        description: "App folder, e.g. apps/retail-self-service (empty: the only app)"
-        default: ""
-      story:
-        description: "Story name (empty: the app's primary story)"
-        default: ""
-      brand:
-        description: "Brand (empty: the app's default)"
-        default: ""
 permissions: {}
 jobs:
   render:
@@ -51,16 +39,12 @@ jobs:
       pull-requests: write
     uses: navipartner/demo-video/.github/workflows/render.yml@v0
   request:
-    if: github.event_name == 'workflow_dispatch' || (github.event_name == 'issue_comment' && github.event.issue.pull_request && startsWith(github.event.comment.body, '/demo-video'))
+    if: github.event_name == 'issue_comment' && github.event.issue.pull_request && startsWith(github.event.comment.body, '/demo-video')
     permissions:
       contents: read
       pull-requests: write
       issues: write
     uses: navipartner/demo-video/.github/workflows/request.yml@v0
-    with:
-      app: \${{ inputs.app }}
-      story: \${{ inputs.story }}
-      brand: \${{ inputs.brand }}
 `;
 
 const read = (file) =>
@@ -261,7 +245,7 @@ export const initRepo = (root, { dryRun = false, label = true } = {}) => {
       .find(Boolean);
     if (existing && !existing.includes("request.yml@")) {
       todo.push(
-        '.github/workflows/demo-video.yml predates the "request" job (/demo-video comments, the Run workflow form): delete it and re-run init to get the current one.',
+        '.github/workflows/demo-video.yml predates the "request" job (/demo-video comments): delete it and re-run init to get the current one.',
       );
     }
   } else {

package/bin/pick.d.mts

@@ -4,20 +4,14 @@ export interface AppMenu {
   dir: string;
   name: string;
   stories: StoryEntry[];
-  brands: string[];
 }
 export type Pick =
   | {
       app: string;
       story: string;
-      brand: string | null;
       menu?: undefined;
     }
   | { menu: true; reason: string; apps?: AppMenu[] };
 export function appMenu(appDir: string): AppMenu;
 export function pick(request: string, apps: AppMenu[]): Pick;
 export function menuMarkdown(apps: AppMenu[], reason: string): string;
-export function pickExact(
-  apps: AppMenu[],
-  names: { app?: string; story?: string; brand?: string },
-): Pick;

package/bin/pick.mjs

@@ -1,27 +1,23 @@
-import fs from "node:fs";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
 
 import { listStories } from "./args.mjs";
 
 // `demo-video pick`: turns a `/demo-video …` request into one of the
-// already-made stories and a brand. No AI and nothing written: stories are a
-// developer's to make (locally, with the skill); a request only chooses.
+// already-made stories. No AI and nothing written: stories are a developer's
+// to make (locally, with the skill); a request only chooses. Every video is
+// in NaviPartner's brand: a customer's is researched by @Linear for one video
+// (the skill's linear.md), never kept in a repo.
 //
-//   /demo-video                                  → the primary story (one app)
-//   /demo-video help                             → the menu
-//   /demo-video checkout in acme branding   → story "checkout", brand "acme"
-//   /demo-video retail checkout                  → the app whose folder says retail
+//   /demo-video                    → the primary story (one app)
+//   /demo-video help               → the menu
+//   /demo-video checkout           → story "checkout"
+//   /demo-video checkout in danish → its translation "checkout-da"
+//   /demo-video retail checkout    → the app whose folder says retail
 //
 // Anything it can't settle on one story is answered with the menu.
 
-const engineDir = path.resolve(
-  path.dirname(fileURLToPath(import.meta.url)),
-  "..",
-);
-
 const STOP = new Set(
-  "a an and as at by for from in into make me of on or our please show story the this to video with branding brand marketing demo film render".split(
+  "a an and as at by for from in into make me of on or our please show story the this to video with branding brand marketing demo film render navipartner på".split(
     " ",
   ),
 );
@@ -31,44 +27,46 @@ const words = (text) =>
     (w) => [w, ...(w.includes("-") ? w.split("-") : [])],
   );
 
-const brandNames = (dir) =>
-  fs.existsSync(dir)
-    ? fs
-        .readdirSync(dir)
-        .filter((f) => f.endsWith(".json"))
-        .map((f) => f.slice(0, -".json".length))
-    : [];
-
-// The adapter may keep its brands elsewhere (`brands: "../brands"`). Read
-// from demo.config.ts's text: a literal path, as the field is documented.
-const adapterBrandsDir = (appDir) => {
-  const config = path.join(appDir, "demo", "demo.config.ts");
-  const text = fs.existsSync(config) ? fs.readFileSync(config, "utf8") : "";
-  const dir = /\bbrands:\s*["'`]([^"'`]+)["'`]/.exec(text)?.[1] ?? "./brands";
-  return path.resolve(appDir, "demo", dir);
+// A translation is a story named for its language (checkout-da): "danish"
+// and "dansk" say its "da" too.
+const languageNames = (part) => {
+  if (!/^[a-z]{2}$/.test(part)) {
+    return [];
+  }
+  try {
+    return [
+      new Intl.DisplayNames(["en"], { type: "language" }).of(part),
+      new Intl.DisplayNames([part], { type: "language" }).of(part),
+    ]
+      .filter((name) => name && name.toLowerCase() !== part)
+      .map((name) => name.toLowerCase());
+  } catch {
+    return [];
+  }
 };
 
-/** What an app offers: its stories, and its brands plus the engine's. */
+/** What an app offers: its stories. */
 export const appMenu = (appDir) => ({
   dir: appDir,
   name: path.basename(appDir),
   stories: listStories(path.join(appDir, "demo")),
-  brands: [
-    ...new Set([
-      ...brandNames(adapterBrandsDir(appDir)),
-      ...brandNames(path.join(engineDir, "brands")),
-    ]),
-  ],
 });
 
+const LINEAR =
+  "A customer's branding isn't kept in a repo: in Linear, ask @Linear for the video, and it researches their brand for that one video.";
+
 /**
- * Picks from `apps` (appMenu results). Returns { app, story, brand } (brand
- * null = the adapter's default) or { menu: true, reason }.
+ * Picks from `apps` (appMenu results). Returns { app, story } or
+ * { menu: true, reason }.
  */
 export const pick = (request, apps) => {
   // A bare /demo-video films the primary story; this asks what there is.
   if (/^\s*(help|menu|list)\s*$/i.test(request)) {
-    return { menu: true, reason: "The stories and brands:" };
+    return { menu: true, reason: "The stories:" };
+  }
+  const branded = /(?:^|\s)in\s+([\w-]+)\s+brand(?:ing)?\b/i.exec(request);
+  if (branded && branded[1].toLowerCase() !== "navipartner") {
+    return { menu: true, reason: LINEAR };
   }
   return pickStory(request, apps);
 };
@@ -76,22 +74,10 @@ export const pick = (request, apps) => {
 const pickStory = (request, apps) => {
   const said = words(request);
   const has = (word) => said.includes(word.toLowerCase());
+  const saysPart = (part) => has(part) || languageNames(part).some(has);
 
-  // The brand: any offered brand named in the request.
-  const allBrands = [...new Set(apps.flatMap((a) => a.brands))];
-  const brands = allBrands.filter(has);
-  if (brands.length > 1) {
-    return {
-      menu: true,
-      reason: `Name one brand, not ${brands.join(" and ")}.`,
-    };
-  }
-  const brand = brands[0] ?? null;
-
-  // What's left of the request once the brand and filler are gone.
-  const content = said.filter(
-    (w) => !STOP.has(w) && !brands.includes(w) && !/^\d+$/.test(w),
-  );
+  // What's left of the request once the filler is gone.
+  const content = said.filter((w) => !STOP.has(w) && !/^\d+$/.test(w));
 
   // The app: named by its folder, else by a part of it no other app's
   // folder has ("retail", not "self"), else the only one.
@@ -114,23 +100,18 @@ const pickStory = (request, apps) => {
     }
   }
 
-  // Score every story: its name (or a part of it) said outright counts most,
+  // Score every story: its name (or its parts) said outright counts most,
   // then words shared with its description.
-  // Variants aren't scored: the base story plus the brand finds them.
   const scored = candidates.flatMap((app) =>
-    app.stories
-      .filter((story) => !story.extends)
-      .map((story) => {
-        const nameParts = story.name.split("-");
-        // "checkout express" says the story checkout-express in full.
-        let score = has(story.name) || nameParts.every((p) => has(p)) ? 10 : 0;
-        score += nameParts.filter((p) => p.length > 2 && has(p)).length * 3;
-        const description = new Set(words(story.description ?? ""));
-        score += content.filter(
-          (w) => w.length > 2 && description.has(w),
-        ).length;
-        return { app, story, score };
-      }),
+    app.stories.map((story) => {
+      const nameParts = story.name.split("-");
+      // "checkout express" says the story checkout-express in full.
+      let score = has(story.name) || nameParts.every(saysPart) ? 10 : 0;
+      score += nameParts.filter(saysPart).length * 3;
+      const description = new Set(words(story.description ?? ""));
+      score += content.filter((w) => w.length > 2 && description.has(w)).length;
+      return { app, story, score };
+    }),
   );
   const best = Math.max(0, ...scored.map((s) => s.score));
   const top = scored.filter((s) => s.score === best);
@@ -147,7 +128,7 @@ const pickStory = (request, apps) => {
       .map((app) => ({ app, story: app.stories.find((s) => s.primary) }))
       .filter((p) => p.story);
     if (noFeature && candidates.length === 1 && primaries.length === 1) {
-      return withBrand(primaries[0].app, primaries[0].story.name, brand);
+      return { app: primaries[0].app.dir, story: primaries[0].story.name };
     }
     return {
       menu: true,
@@ -163,24 +144,7 @@ const pickStory = (request, apps) => {
       reason: `That matches ${top.map((t) => `\`${t.story.name}\``).join(", ")}. Pick one by name:`,
     };
   }
-  return withBrand(top[0].app, top[0].story.name, brand);
-};
-
-// The brand must be one the chosen app has: another app's brand would fail
-// at render time with a worse message. A story with a variant for that brand
-// (checkout + acme → checkout.acme) films the variant: its words are the
-// customer's.
-const withBrand = (app, story, brand) => {
-  if (brand && !app.brands.includes(brand)) {
-    return {
-      menu: true,
-      reason: `No brand \`${brand}\` in ${app.name}. Pick one:`,
-      apps: [app],
-    };
-  }
-  const variant =
-    brand && app.stories.find((s) => s.extends === story && s.brand === brand);
-  return { app: app.dir, story: variant ? variant.name : story, brand };
+  return { app: top[0].app.dir, story: top[0].story.name };
 };
 
 /** The menu as Markdown, for the PR reply. */
@@ -191,75 +155,19 @@ export const menuMarkdown = (apps, reason) => {
     if (app.stories.length === 0) {
       lines.push("- no stories yet");
     }
-    for (const s of app.stories.filter((x) => !x.extends)) {
+    for (const s of app.stories) {
       lines.push(
         `- \`${s.name}\`${s.primary ? " (primary)" : ""}${s.description ? `: ${s.description}` : ""}`,
       );
-      for (const v of app.stories.filter((x) => x.extends === s.name)) {
-        lines.push(`  - in \`${v.brand}\` branding: \`${v.name}\``);
-      }
     }
-    lines.push(`- brands: ${app.brands.map((b) => `\`${b}\``).join(", ")}`, "");
+    lines.push("");
   }
-  const example = apps.find((a) => a.stories.some((s) => !s.extends));
+  const example = apps.find((a) => a.stories.length > 0);
   if (example) {
-    lines.push(
-      `For example: \`/demo-video ${example.stories.find((s) => !s.extends).name}${example.brands.length > 1 ? ` in ${example.brands.find((b) => b !== "navipartner") ?? example.brands[0]} branding` : ""}\``,
-    );
-    lines.push(
-      "",
-      "In Linear, ask @Linear instead, also for a customer without a brand here (a pitch draft).",
-    );
+    lines.push(`For example: \`/demo-video ${example.stories[0].name}\``);
   }
-  return lines.join("\n");
-};
-
-/**
- * The form's version (Actions → Run workflow): app, story and brand by name,
- * no guessing. Empty story = the primary story, empty brand = the adapter's
- * default, empty app = the only app. A name that doesn't exist gets the menu,
- * so a typo never films something else. `apps` in a menu result narrows it.
- */
-export const pickExact = (apps, { app = "", story = "", brand = "" }) => {
-  const slashes = (p) => p.split("\\").join("/");
-  const wanted = slashes(app).replace(/\/+$/, "");
-  const candidates = wanted
-    ? apps.filter((a) => {
-        const dir = slashes(a.dir);
-        return (
-          a.name === wanted || dir === wanted || dir.endsWith(`/${wanted}`)
-        );
-      })
-    : apps;
-  if (candidates.length === 0) {
-    return { menu: true, reason: `No app \`${wanted}\`. The apps:` };
+  if (reason !== LINEAR) {
+    lines.push("", LINEAR);
   }
-  if (candidates.length > 1) {
-    return { menu: true, reason: "Which app? Fill in App with one of:" };
-  }
-  const chosen = candidates[0];
-  const found = story
-    ? chosen.stories.find((s) => s.name === story)
-    : chosen.stories.find((s) => s.primary);
-  if (!found) {
-    return {
-      menu: true,
-      reason: story
-        ? `No story \`${story}\` in ${chosen.name}. Pick one:`
-        : `${chosen.name} has no primary story. Pick one:`,
-      apps: [chosen],
-    };
-  }
-  if (found.extends) {
-    // A variant is made for one brand.
-    if (brand && brand !== found.brand) {
-      return {
-        menu: true,
-        reason: `\`${found.name}\` is made for \`${found.brand}\`. Leave Brand empty, or pick \`${found.extends}\`:`,
-        apps: [chosen],
-      };
-    }
-    return { app: chosen.dir, story: found.name, brand: found.brand };
-  }
-  return withBrand(chosen, found.name, brand || null);
+  return lines.join("\n");
 };

package/dist/{adapter-D_iU2dh2.d.ts → adapter-CDOXdUZI.d.ts}

@@ -152,13 +152,6 @@ interface DemoAdapter {
     setup(page: Page, ctx: {
         brand: Brand;
     }): Promise<void>;
-    /**
-     * The app's own brands folder, relative to demo/ (default "./brands").
-     * Searched before the brands shipped with the engine (navipartner, ...).
-     */
-    brands?: string;
-    /** Default "navipartner". */
-    defaultBrand?: string;
     /**
      * What this app takes from a brand, each with what it is and where it
      * shows ("full-screen photo behind the menu, landscape"). Apps differ: one

package/dist/{chunk-BYAFDWPA.js → chunk-D7UYGNSF.js}

@@ -502,76 +502,15 @@ var parseStoryboard = (raw, adapter, source = "storyboard") => {
   throw new StoryboardError(`Invalid ${source}:
 ${lines.join("\n")}`);
 };
-var cardChange = z.object({
-  eyebrow: cardFields.eyebrow,
-  heading: cardFields.heading,
-  sub: cardFields.sub,
-  logo: cardFields.logo,
-  style: z.enum(["pale", "brand"]).optional(),
-  seconds: z.number().min(0.5).max(10).optional()
-}).strict();
-var variantSchema = z.object({
-  extends: z.string().regex(/^[\w-]+$/, "the base story's name"),
-  brand: z.string().regex(/^[\w-]+$/, "a brand name"),
-  description: z.string().min(1).max(280).optional(),
-  title: cardChange.optional(),
-  closing: cardChange.optional(),
-  cards: z.array(cardChange).optional()
-}).strict();
 var readJson = (file) => JSON.parse(fs.readFileSync(file, "utf8"));
-var isVariant = (raw) => typeof raw === "object" && raw !== null && "extends" in raw;
-var loadVariant = (raw, file, adapter) => {
-  const name = path.basename(file);
-  const result = variantSchema.safeParse(raw);
-  if (!result.success) {
-    const lines = result.error.issues.map(
-      (i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`
-    );
-    throw new StoryboardError(`Invalid ${name}:
-${lines.join("\n")}`);
-  }
-  const variant = result.data;
-  const baseFile = path.join(path.dirname(file), `${variant.extends}.json`);
-  if (!fs.existsSync(baseFile)) {
-    throw new StoryboardError(
-      `${name} extends "${variant.extends}", but there is no ${variant.extends}.json beside it`
-    );
-  }
-  const base = readJson(baseFile);
-  if (isVariant(base)) {
-    throw new StoryboardError(
-      `${name} extends ${variant.extends}.json, which is a variant itself; extend the story it extends`
-    );
-  }
-  const steps = Array.isArray(base.steps) ? base.steps : [];
-  const cardAt = steps.flatMap((s, i) => s.do === "card" ? [i] : []);
-  if (variant.cards && variant.cards.length !== cardAt.length) {
+var loadStoryboard = (file, adapter) => {
+  const raw = readJson(file);
+  if (typeof raw === "object" && raw !== null && ("extends" in raw || "brand" in raw)) {
     throw new StoryboardError(
-      `${name} gives ${variant.cards.length} card${variant.cards.length === 1 ? "" : "s"}; ${variant.extends}.json has ${cardAt.length}. A variant gives every card of its story, in order.`
+      `${path.basename(file)} names a brand or extends a story: stories hold neither. A customer's brand is researched by @Linear for one video; a translation is a story of its own (checkout-da.json).`
     );
   }
-  const change = (card, over) => over ? { ...card, ...over } : card;
-  const merged = steps.map(
-    (step, i) => variant.cards ? change(step, variant.cards[cardAt.indexOf(i)]) : step
-  );
-  const rest = { ...base };
-  delete rest.primary;
-  const story = parseStoryboard(
-    {
-      ...rest,
-      description: variant.description ?? base.description,
-      title: change(base.title, variant.title),
-      closing: change(base.closing, variant.closing),
-      steps: merged
-    },
-    adapter,
-    `${name} (on ${variant.extends}.json)`
-  );
-  return { ...story, brand: variant.brand, variantOf: variant.extends };
-};
-var loadStoryboard = (file, adapter) => {
-  const raw = readJson(file);
-  return isVariant(raw) ? loadVariant(raw, file, adapter) : parseStoryboard(raw, adapter, path.basename(file));
+  return parseStoryboard(raw, adapter, path.basename(file));
 };
 var MIN_ZOOM = MIN_SCALE;
 var MAX_ZOOM = MAX_SCALE;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DemoAdapter } from './adapter-D_iU2dh2.js';
-export { B as Brand, C as CardSpec, a as DemoAction, b as DirectorApi, T as Target, V as VideoBrand, d as defineAction, c as defineDemo } from './adapter-D_iU2dh2.js';
+import { D as DemoAdapter } from './adapter-CDOXdUZI.js';
+export { B as Brand, C as CardSpec, a as DemoAction, b as DirectorApi, T as Target, V as VideoBrand, d as defineAction, c as defineDemo } from './adapter-CDOXdUZI.js';
 import { Page } from '@playwright/test';
 import { z } from 'zod';
 export { z } from 'zod';
@@ -236,10 +236,6 @@ declare const cardSchema: z.ZodEffects<z.ZodObject<{
 type Card = z.infer<typeof cardSchema>;
 interface Storyboard {
     app: string;
-    /** A variant's brand (see loadStoryboard): it is filmed with this one only. */
-    brand?: string;
-    /** The story a variant extends. */
-    variantOf?: string;
     /** What the story shows, for people choosing one (and the menu). */
     description?: string;
     /** The app's primary journey: the story filmed when none is named. One per app. */

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   StoryboardError,
   parseStoryboard
-} from "./chunk-BYAFDWPA.js";
+} from "./chunk-D7UYGNSF.js";
 
 // src/adapter.ts
 var defineDemo = (adapter) => adapter;

package/dist/runner/index.d.ts

@@ -1,5 +1,5 @@
 import { PlaywrightTestConfig, Page } from '@playwright/test';
-import { D as DemoAdapter } from '../adapter-D_iU2dh2.js';
+import { D as DemoAdapter } from '../adapter-CDOXdUZI.js';
 import 'zod';
 
 /**

package/dist/runner/index.js

@@ -30,7 +30,7 @@ import {
   unionRect,
   visibleRect,
   wideShot
-} from "../chunk-BYAFDWPA.js";
+} from "../chunk-D7UYGNSF.js";
 
 // src/runner/config.ts
 import path from "path";
@@ -135,10 +135,17 @@ var engineRoot = () => {
   }
 };
 var sharedBrandsDir = () => path2.join(engineRoot(), "brands");
-var brandDirs = (demoDir, brands = "./brands") => [
-  path2.resolve(demoDir, brands),
+var brandDirs = (pitchDir) => [
+  ...pitchDir ? [pitchDir] : [],
   sharedBrandsDir()
 ];
+var refuseRepoBrands = (demoDir) => {
+  if (fs.existsSync(path2.join(demoDir, "brands"))) {
+    throw new Error(
+      `${path2.join(demoDir, "brands")} isn't used: repos keep no brands. NaviPartner's ships with the engine; a customer's is researched by @Linear for one video and never saved. Delete the folder.`
+    );
+  }
+};
 var brandNames = (dir) => fs.existsSync(dir) ? fs.readdirSync(dir).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -".json".length)) : [];
 var loadBrand = (dirs, name) => {
   if (!NAME_RE.test(name)) {
@@ -1196,17 +1203,10 @@ var registerDemoTests = (test, adapter, demoDir) => {
         ].join("\n")
       );
     }
-    if (storyboard.brand && env.brand && env.brand !== storyboard.brand) {
-      throw new StoryboardError(
-        `${path4.basename(env.storyboardPath, ".json")} is ${storyboard.variantOf} for the brand ${storyboard.brand}. Render it without --brand, or render ${storyboard.variantOf} with --brand ${env.brand}.`
-      );
-    }
+    refuseRepoBrands(demoDir);
     const brand = loadBrand(
-      [
-        ...env.brandsDir ? [env.brandsDir] : [],
-        ...brandDirs(demoDir, adapter.brands)
-      ],
-      env.brand ?? storyboard.brand ?? adapter.defaultBrand ?? "navipartner"
+      brandDirs(env.brandsDir),
+      env.brand ?? "navipartner"
     );
     const missing = missingNeeds(brand, adapter.brandNeeds);
     if (missing.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@navipartner/demo-video",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Marketing demo videos of a React app, filmed by Playwright against the app's own e2e mocks.",
   "license": "UNLICENSED",
   "repository": {

package/skills/np-demo-video/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: np-demo-video
-description: Produce or change a marketing demo video of a NaviPartner React app (retail self-checkout, food-order kiosk, or any app with a demo/ adapter) in the house look, which is calm camera pushes, serif statement cards and customer branding, recorded by the engine @navipartner/demo-video. Use when asked for a product demo video, a showcase of a flow, a marketing or SoMe clip, a customer-branded video (e.g. "two waters, in a customer's branding"), a video asked for in Linear, including a pitch draft for a customer without a brand (e.g. "video of checkout for Acme", "pitch draft of checkout for Northwind"; follow linear.md), or to re-record a demo after UI changes.
+description: Produce or change a marketing demo video of a NaviPartner React app (retail self-checkout, food-order kiosk, or any app with a demo/ adapter) in the house look, which is calm camera pushes, serif statement cards and customer branding, recorded by the engine @navipartner/demo-video. Use when asked for a product demo video, a showcase of a flow, a marketing or SoMe clip, a translation of a story into another language, a video in a customer's branding asked for in Linear (e.g. "video of checkout for Northwind (northwind.example)"; follow linear.md), or to re-record a demo after UI changes.
 ---
 
 # NaviPartner demo video
@@ -18,7 +18,8 @@ workflow.
 From the request, take:
 - **Product:** which app.
 - **Chapters:** the 1–4 ideas to show.
-- **Brand:** default NaviPartner.
+- **Brand:** NaviPartner's, always, in a repo. A customer's branding is
+  @Linear's: it researches their brand for one video (linear.md).
 - **Data:** the products, names and amounts the request mentions ("two
   waters").
 
@@ -28,8 +29,7 @@ Card text defaults to English. Ask only for what you cannot infer.
 
 Every app has one **primary story**: the journey the app exists for, from
 start to the moment of value. It is the app's first story, and the one filmed
-when a request names no feature ("make a video of the QR app", "a video in
-the customer's branding").
+when a request names no feature ("make a video of the QR app").
 
 | App | Primary story | Ends on |
 |---|---|---|
@@ -51,8 +51,8 @@ two. In the PR, say which spec the story follows, so the developer can confirm
 it is the right journey.
 
 Run `pnpm --dir <app> exec demo-video list` first. If a primary story exists and the
-request names no feature, render it (`pnpm --dir <app> exec demo-video render` without `--story`,
-with `--brand` if one is asked for) instead of writing a new one. For a
+request names no feature, render it (`pnpm --dir <app> exec demo-video render` without `--story`)
+instead of writing a new one. For a
 repo with several apps and no app named, ask which app, or offer each app's
 primary story. A PR never films it by default; only stories a PR adds or
 changes are filmed there.
@@ -78,10 +78,10 @@ Check it against look.md:
 - Does every card describe exactly what the chapter after it shows?
 - Does the hook land by second 6?
 
-Example, retail self-checkout for a customer (here the made-up brand Acme):
+Example, retail self-checkout:
 
 ```
-open    Introducing · Acme logo · sub "Self-checkout"
+open    Introducing · NaviPartner logo · sub "Self-checkout"
 ch1     sees: a guest scans two waters and they land in the basket
         shots: wide for the scans (the rows appear at the top);
                push in 1.5 on the basket rows to read them
@@ -91,7 +91,7 @@ ch2     sees: the guest pays by card and the payment goes through
                pull out when the payment screen opens
         card: "Pay *by card*."
 payoff  "Paid *in seconds*." · sub "64,50 kr. by card." (expectText on the total)
-end     Acme logo · "Self-checkout by NaviPartner"
+end     NaviPartner logo · "Self-checkout by NaviPartner"
 ```
 
 ## 3. Learn the app
@@ -110,9 +110,9 @@ end     Acme logo · "Self-checkout by NaviPartner"
      with an absurdly long name or an error item.
    - If the request needs data the e2e tests don't have, say so instead of
      inventing it.
-   - One exception: a customer brand may rename the mock's products in its
-     `config.demoData` (see "A new brand"). It gives them names only, never
-     new barcodes, prices or flows.
+   - One exception: a pitch draft's brand may rename the mock's products
+     in `config.demoData`, when the adapter takes it (a `brandNeeds` entry).
+     It gives them names only, never new barcodes, prices or flows.
 
 ### A new app
 
@@ -143,12 +143,12 @@ end     Acme logo · "Self-checkout by NaviPartner"
 ## 4. Write the story
 
 A developer writes stories locally (VS Code, with this skill) and a PR
-confirms them. A `/demo-video` PR comment, the Run workflow form and a
-request to @Linear only pick an existing story and a brand: they never
-write one. A story is
+confirms them. A `/demo-video` PR comment and a request to @Linear only
+pick an existing story: they never write one. A story is
 `<app>/demo/stories/<name>.json`, named for what it shows (`checkout`,
-`settings`), and holds no brand: the same story renders for any brand with
-`--brand <name>`. A customer's own words go in a variant (below).
+`settings`), and holds no brand: it films in NaviPartner's brand, or in a
+customer's that @Linear researches for one video. A translation is a story
+of its own (below).
 
     { "app": "<adapter app>",
       "description": "One sentence: what the story shows. Follows e2e/<spec>.",
@@ -187,11 +187,9 @@ How the look maps onto steps:
   press, holds the press, waits for the app to react, settles the camera
   before acting, lingers on a chapter's result before its card, and opens
   every chapter wide with the cursor at rest. Don't add holds for those.
-- **Works with every brand:** any story can be filmed with any brand (the
-  label uses the app's default). Never target text a brand's `demoData`
-  sets (renamed products, an order number): pick products by testid and
-  `nth`, the mock's order. Run `check` without `--brand` as well as with the
-  brand you're writing for.
+- **Works with any brand:** a pitch draft films the same story in a
+  customer's brand. Never target text a brand can change (renamed products,
+  an order number): pick products by testid and `nth`, the mock's order.
 - **Safety:** after each navigation, `waitFor` the next screen's testid. Put
   `expectText` on prices and confirmations so the video fails if the copy is
   wrong, and so a card may quote them.
@@ -216,87 +214,29 @@ The words are what the viewer remembers; write them with care.
 - Statements ≤ 7 words, subs ≤ 16 (`check` stops at 8 and 16), sentence
   case, ending with a full stop.
 
-### A new brand
-
-A customer brand is `<app>/demo/brands/<name>.json` with its assets in
-`<app>/demo/brands/<name>/`. Fields: [reference.md](reference.md).
-
-A customer's name, logo and look are their trademarks. A video in them is
-made with their permission, from what they gave us, and stays internal until
-they approve it.
-
-- **Only with permission.** Make a customer brand only when the request says
-  the customer has agreed to a video in their branding (an account manager or
-  the customer asked for it). If that's unclear, ask before you start.
-- **Only their own material, never invented or recreated:** the logo file and
-  brand guide the customer supplied, or that a NaviPartner colleague received
-  from them. Don't download, trace, redraw or recolour a logo from their
-  website, and don't guess a colour or font. If a value is missing, ask the
-  customer contact for it; colours from their public site are a stand-in to
-  confirm with them, never final.
-- **Say where it came from.** The PR that adds the brand names the source of
-  the logo, colours and fonts, and who gave permission. Without that, the
-  brand doesn't merge.
-- **Logo:** an SVG or a PNG with a transparent background, readable on a
-  light background (`logoColor`, a top-level key, recolours a white SVG; use
-  it only when their brand guide allows that colour version).
-- **Fonts:** only a font whose licence covers use in a video. Google Fonts are
-  open-licensed and fine. A customer's own or commercial font is used only if
-  they confirm their licence covers it; otherwise take the closest Google
-  Font and say so in the report. Never copy font files from their website.
-- **No claims for them:** cards state what the video shows. No customer
-  quotes, statistics or "trusted by" lines, and a closing card says what the
-  product is, not that the customer endorses it.
-- **Publishing:** a customer-branded video goes to the customer for approval
-  before it is published anywhere. Say so in the report.
-- **`config`:** only keys the app's branding code accepts. Override every
-  value the e2e mock sets that would show through, such as a mock
-  `backgroundColor`.
-- **`config.demoData`** (when the adapter supports it): the customer's names
-  for the mock's products, keyed by the mock's barcodes. Mock data such as
-  "Toothpaste" or "TEST CARD" reads as a test run in a customer video. Use
-  plain product names ("Lemonade"), or ones the customer gave you, never a
-  third party's brand ("Coca-Cola"). Keep the mock's prices, so pick
-  products that are believable at those prices, and put the totals on the
-  cards from the render, not from your own sums.
-- **App limits:** an app may only offer presets (retail has two font pairs).
-  Pick the closest and say in the report what the kiosk can't show.
-- **`video` fonts** load from Google Fonts: the heading in 400, 700 and
-  italic 400, the body in 400 and 600. If a font lacks one, give `fontsUrl`
-  yourself.
-- Render with `--brand <name>` and check the stills before calling it done.
-
-### Videos asked for in Linear
-
-Asked for a video in a Linear session (an existing story in a brand the repo
-has, or a **pitch draft** for a customer without one): follow
-[linear.md](linear.md) and nothing else here. A pitch writes nothing to the repo, and its researched
-brand is not a brand: never commit it or copy its values into one. When the
-customer agrees to more, make a real brand with the rules above.
-
-### A variant: the story in a customer's words
-
-When a customer video needs its own words (their product, their place), write
-a variant beside the story instead of a copy: `checkout.acme.json`.
-
-    { "extends": "checkout",
-      "brand": "acme",
-      "description": "The checkout story, for Acme.",
-      "title":   { "sub": "Self-service at Acme" },
-      "closing": { "sub": "…" },
-      "cards":   [ { "heading": "A burger *and a lemonade*." }, { … }, { … } ] }
-
-- The steps are always the base story's: a variant changes words and brand,
-  never the flow. Fix the flow in the base, once, for every variant.
-- `cards` gives every card step of the base, in order; each entry, like
-  `title` and `closing`, changes only the fields it names. When the base
-  gains or loses a card, the variant stops loading until it is updated.
-- It films with its own brand only. `/demo-video checkout in acme branding`
-  and the form (story `checkout`, brand `acme`) pick the variant.
-- The same rules as any card: numbers proven by the base's `expectText`s,
-  and the customer's permission for their name (see "A new brand").
-- `check --story checkout.acme` before the PR, and re-check the variants
-  when you change their base.
+### Brands
+
+Repos keep no brands. NaviPartner's ships with the engine, and every video
+in a repo is in it. Never create `demo/brands/`: `check` refuses it.
+
+A video in a customer's branding is asked for in Linear: @Linear researches
+their brand for that one video and keeps nothing (follow
+[linear.md](linear.md), and nothing else here, when that's the request).
+
+### A translation
+
+A story in another language is a story of its own, named for its language:
+`checkout-da.json` beside `checkout.json`.
+
+- The same flow as the base, plus whatever switches the app to that
+  language (its language button, as the e2e tests do it).
+- Its title, cards and closing in that language, the same rules as any card.
+- `description` says the language ("The checkout, in Danish."). It is never
+  `primary`.
+- `/demo-video checkout in danish` (or `checkout da`, `checkout på dansk`)
+  picks it.
+- `check --story checkout-da` before the PR, and again when you change the
+  base story.
 
 ### Not supported yet
 
@@ -315,7 +255,8 @@ step for real and fails on anything that would film badly:
 | `clicking "x" changes y, which is outside the shot …` | Frame what the click changes, or `zoomOut` right after the click |
 | `N camera push-ins in one chapter` | Push in once on the chapter's area and hold steady |
 | `… only fit in the wide shot` | `frame` things that sit together, or stay wide |
-| `… gives N cards; … has M` | Give the variant one entry per card of its story, in order |
+| `… names a brand or extends a story` | Remove it: a customer's branding is @Linear's, a translation is a story of its own |
+| `…/demo/brands isn't used` | Delete the folder: repos keep no brands |
 | `a zoom with nothing in its shot` | Remove it, or act or read something in it |
 | `zoom 2.4; use 1.3–2` | Zoom less: context reads better and stays sharp |
 | `"…" looks like a testid-like name / barcode / code` | Cards are for people: say it in words |
@@ -326,7 +267,7 @@ Fix what the report names. Its `visible` list shows what is on screen at the
 failing step. Repeat until it passes, at most 3 rounds; a story that still
 fails is reported as "couldn't show this", with the last report. Then:
 
-    pnpm --dir <app> exec demo-video render [--story <name>] [--brand <name>]
+    pnpm --dir <app> exec demo-video render [--story <name>]
 
 Rendering films every frame (60 fps, frame by frame), so it takes about
 five times the video's length. While tuning, `render --draft` films at
@@ -358,7 +299,5 @@ Give:
 - the MP4 path and duration
 - the chapter plan
 - the contact sheet and stills
-- which brand it was rendered with, and for a customer brand, that the
-  video needs the customer's approval before it is published
 - anything the video could not show truthfully (it shows demo fixture data,
   not a real tenant's)

package/skills/np-demo-video/linear.md

@@ -1,23 +1,22 @@
 # A video asked for in Linear
 
 Someone asks @Linear for a video, in their own words: "make a video of the
-checkout story for Acme", "pitch draft of checkout for Northwind
-(northwind.example)". You film one of the app's **existing** stories, in a brand:
+checkout story from np-pos for Northwind (northwind.example)". You film one
+of the app's **existing** stories:
 
-- **A brand the repo has** (`acme` in `demo/brands/`): a normal video at
-  60 fps. That brand was added with the customer's permission.
-- **A customer without a brand here:** a **pitch draft**. You research their
-  brand, the engine checks it and films at 30 fps, for a sales pitch to that
-  customer only.
+- **For NaviPartner itself:** a normal video at 60 fps.
+- **For a customer:** a **pitch draft**. Repos keep no brands, so you
+  research theirs, the engine checks it and films at 30 fps, for a sales
+  pitch to that customer only. Nothing about them is saved.
 
 ## Hard rules
 
 - **Nothing is saved.** Never commit, push or open a pull request. Never
-  change a story, the app, its mocks or a brand in the repo. Everything you
+  change a story, the app or its mocks, and never add a brand to the repo. Everything you
   make lives in `/tmp/pitch` or `demo/out/` and is deleted at the end.
 - **An existing story, unchanged.** If no story fits the request, say so and
   list the stories. Don't write one.
-- **A pitch takes the customer's own material only.** Find their official
+- **The customer's own material only.** Find their official
   website (use the one named, if any). Take the logo, colours and images
   from it: the site itself, its brand or press page, or the CDN the site
   loads its own images from. No logo databases, no other companies' sites,
@@ -38,19 +37,17 @@ repo root when the app is the repo, otherwise the folder with
    (without `--with-deps`: a sandbox has the system packages and no root),
    then `mkdir -p /tmp/pitch`.
 2. **See what there is:** `pnpm exec demo-video pick --request help .` lists
-   the stories and the brands.
-3. **Pick the story and the brand:**
-   `pnpm exec demo-video pick --json --request "<story> in <brand> branding" .`
-   with the story and the customer the request names (no story named: leave
-   it out, for the primary story). It answers `{ "story", "brand" }`, and
-   takes a customer's variant of the story when there is one. `"brand":
-   null` means the customer has no brand here: it's a pitch draft, go to
-   step 5.
-4. **A brand the repo has:**
-   `pnpm exec demo-video render --story <story> --brand <brand> --json`. At
-   60 fps this takes about 15× the video's length and prints nothing
-   meanwhile. It prints the MP4 (`output`) and the contact sheet (`sheet`).
-   Go to step 7.
+   the stories.
+3. **Pick the story:**
+   `pnpm exec demo-video pick --json --request "<story>" .` with the story
+   the request names, and its language if it asks for one ("checkout in
+   danish" picks the translation `checkout-da`). No story named: leave it
+   out, for the primary story. It answers `{ "story" }`, or a menu if the
+   request matches none.
+4. **For NaviPartner itself:**
+   `pnpm exec demo-video render --story <story> --json`. At 60 fps this
+   takes about 15× the video's length and prints nothing meanwhile. It
+   prints the MP4 (`output`) and the contact sheet (`sheet`). Go to step 7.
 5. **A pitch draft: research the brand.**
    - Read what the app needs:
      `pnpm exec demo-video brand-needs --json > /tmp/pitch/needs.json`.
@@ -68,6 +65,9 @@ repo root when the app is the repo, otherwise the folder with
        image is a direct https URL from the customer's own site that fits
        its `what`. Other keys take the same kind of value as in `example`.
        Give optional ones only when their material has them.
+     - **`config.demoData`** (only if the app's needs list it): plain names
+       for the mock's products, never a third party's brand ("Coca-Cola"),
+       believable at the mock's prices.
 6. **A pitch draft: film it.**
    `pnpm exec demo-video pitch /tmp/pitch/proposal.json --story <story> --json`.
    It checks the proposal, downloads the images, checks the story with the
@@ -80,12 +80,11 @@ repo root when the app is the repo, otherwise the folder with
    well, the app looks branded. Film again only if something is clearly
    wrong.
 8. **Deliver:** attach the MP4 and the contact sheet to the issue, with a
-   line saying which story, which brand and how long. For a pitch draft,
-   also:
+   line saying which story and how long. For a pitch draft, also:
    > Pitch draft for <customer> only. The brand was researched from their own
    > material (<sources>) and isn't kept anywhere. Fonts are Google Fonts
    > stand-ins. Check the video before sending it: any other use needs
-   > <customer>'s permission and a brand added in a PR.
+   > <customer>'s written permission.
 
    Add your notes: what you couldn't find and what you used instead.
 9. **Clean up:** `rm -rf /tmp/pitch demo/out`. Then `git status` must show

package/skills/np-demo-video/look.md

@@ -112,10 +112,8 @@ end card       3–5 s   logo + tagline, still
   colour. The brand's logo and wordmark are on the open and end cards. The
   app itself is shown in the customer's branding (their kiosk looks like
   their kiosk).
-- **Default brand:** NaviPartner (below). A customer video, made with the
-  customer's permission and their own brand material (see "A new brand" in
-  SKILL.md), swaps the logo, colours, fonts, tagline and data (their
-  products, their language), following the same roles.
+- **Brand:** NaviPartner's (below). A pitch draft (linear.md) swaps in a
+  customer's researched logo, colours and fonts, following the same roles.
 
 ### NaviPartner brand
 

package/skills/np-demo-video/reference.md

@@ -7,8 +7,7 @@ the mocks booted the app), `viewport` (default 1728×972; a portrait kiosk is
 scaled to fit) and `setup(page, { brand })`, which runs the app's e2e mocks
 **unchanged** and lays the brand over the response that carries it.
 Optional: `actions` (app steps such as a barcode scan), `idleTimeoutSeconds`,
-`defaultBrand`, `brands` (folder, default `./brands`), `locale`, `timezone`,
-and `brandNeeds`: the `config` keys and asset slots `setup` uses, each a
+`locale`, `timezone`, and `brandNeeds`: the `config` keys and asset slots `setup` uses, each a
 description (where it shows, what shape) or `{ what, optional: true }`. A
 brand without a need that isn't optional fails `check`.
 
@@ -68,25 +67,19 @@ export default defineDemo({
   beats around clicks, the camera's settle and a linger before each card.
   Holds may not add up past the app's idle timeout.
 
-## Variant (`<app>/demo/stories/<story>.<brand>.json`)
-
-`extends` (the base story's name), `brand`, optional `description`, `title`,
-`closing` and `cards` (one entry per card step of the base, in order). Each
-card entry takes the card fields and changes only those it names. No
-`steps`, no `primary`: the flow is the base's. Filmed with its brand only.
-
-## Brand (`<app>/demo/brands/<name>.json`, assets in `<name>/`)
+## Brand (the engine's `navipartner`, or one a pitch draft builds)
 
 - `tenantName`
 - `config`: opaque to the engine, the keys the app's branding API reads
-  (`primaryColor`, …). An adapter may also read `config.demoData`: the
-  customer's names for the mock's products, keyed by the mock's barcodes
-  (prices and flows stay the mock's). It takes `demoData` out before it
+  (`primaryColor`, …). An adapter may also read `config.demoData`: names
+  for the mock's products, keyed by the mock's barcodes (prices and flows
+  stay the mock's). It takes `demoData` out before it
   overlays the branding.
-- `assets`: slot → file, e.g. `{ "logo": "<name>/logo.svg" }`
+- `assets`: slot → file, e.g. `{ "logo": "navipartner/logo.svg" }`
 - `video`: `primary`, `ink`, `accent`, `text`, `headingFont`, `bodyFont`,
   optional `fontsUrl`, `logo` (asset slot)
 - optional `logoColor` (recolours white fills in an SVG logo) and
   `stage.background`
 
-The engine ships `navipartner`; an app's own brand of the same name wins.
+Repos keep no brands: `check` refuses a `demo/brands/` folder. A pitch
+draft's brand is built by `demo-video pitch` from its proposal (linear.md).