@litfamily/lithermes 1.0.28 → 1.0.30

package/assets/lithermes-plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json

@@ -0,0 +1,67 @@
+{
+  "aspect": "2:1",
+  "beat": "The lid opens, the core rises and settles, and the lid closes.",
+  "brandWord": "LITHERMES",
+  "encode": {
+    "edgeFrames": 15,
+    "edgeQ": 97,
+    "q": 94
+  },
+  "fps": 20,
+  "hero": "A rounded case with a hinged lid and a lit core.",
+  "idea": "A case turns once and opens on its beat to show the lit core inside, beside a still name.",
+  "layers": {
+    "beat": "The lid opens on the core and a ring runs out across the floor.",
+    "mid": "The camera breathes twice per loop.",
+    "slow": "The case turns exactly once per loop."
+  },
+  "loopSec": 8,
+  "mode": "cover",
+  "motto": {
+    "from": "the motto painted on the repository artwork",
+    "source": "project",
+    "text": "KEEP THE WORK LIT."
+  },
+  "note": "PORT_UNMEASURED: the row below is the ancestor's GPU-rung measurement (Apple M5 Pro, three.js r170, libwebp); re-render through this renderer and replace the row before adding hero-3d to qa/cover-recipes.js.",
+  "recipe": "hero-3d",
+  "recipeReason": "One object acting once per loop says what the project holds better than a type pattern.",
+  "request": "A README motion cover for LitHermes with a product object that opens.",
+  "row": {
+    "bytes": 1060856,
+    "longestStillSec": 0.05,
+    "medianD": 0.002485,
+    "movingFrac": 1,
+    "seamLocal": 1.199,
+    "spike": 3.684
+  },
+  "schema": "lithermes.cover-recipe/v1",
+  "settings": {
+    "encode": {
+      "edgeFrames": 15,
+      "edgeQ": 97,
+      "method": 4,
+      "q": 94
+    },
+    "fps": 20,
+    "frames": 160,
+    "size": [
+      1000,
+      500
+    ]
+  },
+  "system": {
+    "copies": "One case, one core, one ring.",
+    "offset": "The ring trails the lid by a tenth of the loop.",
+    "rule": "One hinge rule and one turn rule on one object."
+  },
+  "title": {
+    "box": [
+      0.05,
+      0.36,
+      0.43,
+      0.14
+    ],
+    "kind": "live"
+  },
+  "verdict": "PORT_UNMEASURED"
+}

package/assets/lithermes-plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html

@@ -0,0 +1,139 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<!-- Recipe D, hero 3D: one product object, lit in a small studio, acting its beat once per loop. A
+     worked example: a rounded case turns exactly once per loop (slow layer), the camera breathes twice
+     (mid layer), and once per loop the lid opens, a lit core rises and settles back and the lid closes,
+     while a ring runs out across the floor (the beat). The word sits still on the left. Drawn with the
+     pinned three.js build on the GPU rung (software when the GPU is missing). Replace the word, the
+     motto and the HERO block with the project's own object. -->
+<link rel="stylesheet" href="/lit/fonts.css">
+<script src="/lit/loop-kit.js"></script>
+<script type="importmap">{ "imports": { "three": "/lit/three/three.module.js", "three/addons/": "/lit/three/addons/" } }</script>
+<style>
+  html, body { margin: 0; width: 1200px; height: 600px; overflow: hidden; background: #0b0f16; }
+  canvas { position: absolute; left: 0; top: 0; width: 1200px; height: 600px; display: block; }
+</style>
+</head>
+<body>
+<canvas id="world"></canvas>
+<canvas id="type" width="2400" height="1200"></canvas>
+<script type="module">
+import * as THREE from "three";
+import { RoomEnvironment } from "three/addons/environments/RoomEnvironment.js";
+import { RoundedBoxGeometry } from "three/addons/geometries/RoundedBoxGeometry.js";
+
+const { TAU, clamp, fract, ease } = LitLoop;
+const span = (a, b, t) => clamp((t - a) / (b - a));
+const C = { bg: "#0b0f16", ivory: "#f2efdf", dim: "#8b8f8f", orange: "#ff6337", shell: "#d9d4c4", inner: "#1a2230" };
+const W = 1200, H = 600;
+const AIM = { x: 860, y: 318 };
+
+// ---- the world: renderer, studio light, floor ----
+const glCanvas = document.getElementById("world");
+const renderer = new THREE.WebGLRenderer({ canvas: glCanvas, antialias: true, alpha: true, preserveDrawingBuffer: true });
+renderer.setPixelRatio(window.devicePixelRatio);
+renderer.setSize(W, H, false);
+renderer.setClearColor(0x000000, 0);
+renderer.outputColorSpace = THREE.SRGBColorSpace;
+renderer.toneMapping = THREE.ACESFilmicToneMapping;
+renderer.shadowMap.enabled = true;
+renderer.shadowMap.type = THREE.PCFSoftShadowMap;
+const scene = new THREE.Scene();
+scene.environment = new THREE.PMREMGenerator(renderer).fromScene(new RoomEnvironment(), 0.04).texture;
+scene.environmentIntensity = 0.55;
+const cam = new THREE.PerspectiveCamera(30, W / H, 0.1, 60);
+cam.setViewOffset(W, H, W / 2 - AIM.x, H / 2 - AIM.y, W, H);
+const key = new THREE.DirectionalLight(0xffffff, 2.4);
+key.position.set(-3, 6, 4);
+key.castShadow = true;
+key.shadow.mapSize.set(2048, 2048);
+key.shadow.radius = 5;
+key.shadow.bias = -0.0004;
+key.shadow.normalBias = 0.03;
+key.shadow.camera.left = -4; key.shadow.camera.right = 4; key.shadow.camera.top = 4; key.shadow.camera.bottom = -4;
+const rim = new THREE.DirectionalLight(0xffb08f, 1.1);
+rim.position.set(4, 2.5, -5);
+scene.add(key, rim);
+const floor = new THREE.Mesh(new THREE.PlaneGeometry(30, 30), new THREE.ShadowMaterial({ opacity: 0.35 }));
+floor.rotation.x = -Math.PI / 2;
+floor.receiveShadow = true;
+scene.add(floor);
+const ring = new THREE.Mesh(new THREE.RingGeometry(0.98, 1, 128), new THREE.MeshBasicMaterial({ color: C.orange, transparent: true, opacity: 0 }));
+ring.rotation.x = -Math.PI / 2;
+ring.position.y = 0.002;
+scene.add(ring);
+
+// ---- HERO: the product object (a case with a hinged lid and a lit core) ----
+const shell = new THREE.MeshPhysicalMaterial({ color: C.shell, roughness: 0.32, metalness: 0.05, clearcoat: 0.6, clearcoatRoughness: 0.2 });
+const inner = new THREE.MeshStandardMaterial({ color: C.inner, roughness: 0.8 });
+const HERO = new THREE.Group();
+const base = new THREE.Mesh(new RoundedBoxGeometry(1.6, 0.62, 1.1, 6, 0.12), shell);
+base.position.y = 0.31;
+const well = new THREE.Mesh(new RoundedBoxGeometry(1.38, 0.5, 0.88, 4, 0.08), inner);
+well.position.y = 0.4;
+const hinge = new THREE.Group();
+hinge.position.set(0, 0.64, -0.55);
+const lid = new THREE.Mesh(new RoundedBoxGeometry(1.6, 0.16, 1.1, 6, 0.07), shell);
+lid.position.set(0, 0.08, 0.55);
+hinge.add(lid);
+const coreMat = new THREE.MeshStandardMaterial({ color: C.orange, emissive: C.orange, emissiveIntensity: 0, roughness: 0.35 });
+const core = new THREE.Mesh(new THREE.IcosahedronGeometry(0.24, 3), coreMat);
+const glow = new THREE.PointLight(C.orange, 0, 4, 2);
+core.add(glow);
+for (const m of [base, lid, core]) m.castShadow = true;
+base.receiveShadow = true;
+HERO.add(base, well, hinge, core);
+scene.add(HERO);
+
+// The beat: open 0.28-0.44, hold, close 0.62-0.78; zero at both ends, so the loop closes.
+const openAt = (t) => ease.smooth(span(0.28, 0.44, t)) * (1 - ease.smooth(span(0.62, 0.78, t)));
+
+function drawWorld(t) {
+  HERO.rotation.y = -0.5 + TAU * t;
+  const open = openAt(t);
+  hinge.rotation.x = -1.45 * open;
+  const rise = ease.outBack(span(0.36, 0.5, t)) * (1 - ease.smooth(span(0.58, 0.7, t)));
+  core.position.y = 0.42 + 0.6 * rise;
+  core.rotation.y = TAU * 2 * t;
+  coreMat.emissiveIntensity = 1.1 * open;
+  glow.intensity = 3 * open;
+  const wave = ease.outCubic(span(0.38, 0.72, t));
+  ring.scale.setScalar(0.9 + 1.3 * wave);
+  ring.material.opacity = 0.55 * open * (1 - wave);
+  const breathe = Math.sin(TAU * 2 * t);
+  cam.position.set(5.8 * Math.sin(0.35), 2.3 + 0.12 * breathe, 5.8 * Math.cos(0.35));
+  cam.lookAt(0, 0.62 + 0.04 * breathe, 0);
+  renderer.render(scene, cam);
+}
+
+// ---- the word, set once ----
+const ctx = document.getElementById("type").getContext("2d");
+ctx.scale(2, 2);
+function drawType(mask) {
+  ctx.clearRect(0, 0, W, H);
+  if (mask) { ctx.fillStyle = "#000"; ctx.fillRect(0, 0, W, H); }
+  ctx.textBaseline = "alphabetic";
+  ctx.fillStyle = mask ? "#fff" : C.ivory;
+  ctx.font = '800 84px "JetBrains Mono"';
+  ctx.fillText("LITHERMES", 70, 292);
+  if (mask) return;
+  ctx.font = '500 18px "JetBrains Mono"';
+  ctx.fillStyle = C.dim;
+  let mx = 74;
+  for (const ch of "KEEP THE WORK ") { ctx.fillText(ch, mx, 338); mx += 19.6; }
+  ctx.fillStyle = C.orange;
+  ctx.font = '700 18px "JetBrains Mono"';
+  for (const ch of "LIT.") { ctx.fillText(ch, mx, 338); mx += 19.6; }
+}
+
+window.renderFrame = (t, o = {}) => {
+  glCanvas.style.visibility = o.mask ? "hidden" : "visible";
+  if (!o.mask) drawWorld(fract(t));
+  drawType(Boolean(o.mask));
+};
+document.fonts.load('800 84px "JetBrains Mono"').then(() => document.fonts.load('500 18px "JetBrains Mono"')).then(() => { window.renderFrame(0); window.ready = true; });
+</script>
+</body>
+</html>

package/assets/lithermes-plugin/skills/lit-typographic-motion/references/depth.md

@@ -0,0 +1,74 @@
+# Depth and story
+
+Motion films read like stories because shots have protagonists, turns and
+pay-offs, and depth answers how far the eye travels. This reference condenses
+the story file format and the depth rules; the renderer and QA enforce them.
+
+## Story and protagonist
+
+The treatment carries the narrative contract: a **story** (`expect` what the
+viewer expects, `turn` what happens instead, `beat` the shot where the turn
+lands, `payoff` what the ending gives) and, on the stage path, a
+**protagonist** (one character or hero object the eye follows: a name, a
+look, and one act per shot, the acts covering at least half the film
+including the turn shot). The board's per-shot captions carry the turns so
+the read of the board is the read of the story.
+
+## The four depths
+
+Each shot is staged at one of four depths, declared in the treatment:
+
+| Depth | Eye travel | Camera | Layers |
+|---|---|---|---|
+| `flat` | none: the page is a poster | locked | type + ground only |
+| `near` | small parallax on the hero | dolly ≤ 6 % | hero lifts off ground |
+| `deep` | the hero travels through the world | dolly + focus pull | foreground, hero, ground |
+| `fold` | the world turns its page | one rotation, one axis | double-sided panel |
+
+A film uses at most two depths, and the pay-off shot is never `flat`. Depth
+changes only on a `match` or `morph` hand-off, so the eye never teleports.
+
+## GPU ladder
+
+A film declares the cheapest rung that can stage it honestly: a 2D film takes
+the software rung (SwiftShader, CPU raster); a `depth: 3d` film takes the
+platform's GPU rung first (ANGLE/Metal/GL/D3D11), and falls back to software
+only with a warning, rendering the same frames. Only when neither rung has
+WebGL is it exit 11. The rung is chosen from the treatment (`depth`), never
+by the page. `paper` stays 2D: hand-drawn calm never reaches for a GPU.
+`terminalcore` stays 2D too: phosphor has no third dimension.
+
+## The Blender rung
+
+A `depth: 3d` film whose treatment says `render3d: "blender"` renders its
+world offline in Blender and shows the path-traced plate under its HTML type.
+The scene is `stage/scene.py`, written against the `lit` helpers the runner
+puts in scope; `motion.mjs blender --out DIR` renders one still at every beat
+midpoint into `stage/plate-preview/`, `--final` renders the plate sequence
+into `stage/plate/` plus `plate.json`, and the stage refuses to render without
+a plate that matches its frames (exit 17). Preview first, open the stills,
+compare them with any reference frames the user gave and with what the GPU
+rung built, then render the final plate. A film that shows its plate shares
+its run with a 3-D-of-any-kind page: the same scene, receipt and frames
+render exactly the same plate again. Without Blender installed the command
+falls back to the GPU rung instead of rendering; without `scene.py` it is
+exit 17.
+
+## Painted light and replay identity
+
+Light is painted, never computed live: the scaffold bakes one key light, one
+hemisphere light in the style's colours and one shadow-only floor into the
+page, with the shadow bias that keeps a turning object's self-shadow from
+flickering (`-0.0004` / `0.03`; without them the acne reads as flashes and
+fails the gate). A Blender plate shows path-traced light under the same type;
+the GPU rung renders the same baked page, so both agree to the eye.
+
+For WebGL the page creates its context with `preserveDrawingBuffer: true`; a
+page that asks for WebGL and gets none on any rung exits 11. A replay is
+frame-identical: the same treatment on the same rung in a fresh browser must
+reproduce the sampled frames pixel for pixel, or the render stops with exit
+18. Chrome rasterizes every tile in full on the CPU, so blurs, shadows and
+shaders replay pixel for pixel; one quirk remains, and the replay paints and
+captures every frame exactly like the master because of it. Seeds are never
+time-based. The rung is chosen from the treatment (`depth`) or the cover
+recipe, never by the page.

package/assets/lithermes-plugin/skills/lit-typographic-motion/references/studio.md

@@ -0,0 +1,87 @@
+# House styles
+
+Four house styles ship as data in `styles/<id>.json` (schema
+`litfamily.motion-style/v1`, validated by `engine/styles.mjs` and refused with
+the bad field named). A film's treatment names exactly one; the validator checks
+it against the pick rules below, the renderer serves it as `/lit/style.css`
+and `/lit/style.js`, and the text QA judges copy against it. The style bibles in
+`references/style-bibles.md` carry the look of each; this file carries the
+rules. `node <skill>/bin/motion.mjs styles [--out DIR]` prints the table and,
+with `--out`, writes the machine-readable `styles.json` catalog.
+
+| Style | Type preset | Best for |
+|---|---|---|
+| `swiss-signal` | swiss-signal | the default: precise, hard cuts, teal signal |
+| `tidal` | tidal | brand moods: slow flow, coral moment |
+| `terminalcore` | terminalcore | terminal briefs: phosphor type, no ease |
+| `paper` | none (stage only) | warm explainers; the type path refuses it |
+
+## Picking
+
+A style named in the request wins (`paper style`, `tidal`, `터미널코어`…).
+Otherwise the project's house style (`motion-house.json` beside the output
+folder, written by a render that passes its gate) holds while it exists.
+Otherwise the keyword table in `style-bibles.md` auto-picks (`terminal` /
+`hacker`, `gradient` / `wave`, `warm` / `paper`…). Otherwise an `explainer`
+takes `paper` and a `brand-mood` takes `tidal`. Otherwise the default
+`swiss-signal`. The manifest records `{ style, source, reason }`.
+
+## Register
+
+Rich is the default: every layer the treatment's world describes is drawn,
+labelled, lit and moved. Minimal is only for a calm, quiet or minimal ask
+(`minimal`, `calm`, `잔잔한`, `차분한`…): the core palette, two layers, one
+camera move at most, no accents. A minimal film that reaches for a role
+accent, or a rich film the request asked calm, fails validation.
+
+## Palette, type, motion
+
+Every colour on a stage page comes from the style's palette plus, on a rich
+film, the style's role accents (`style.accents`, each with a role and a
+`3:1`-on-ground colour). Copy uses the text roles (`style.textRoles`); display
+and headline type uses ink. Ink on ground needs `7:1`, muted `4.5:1`. Type
+uses the style's faces (Hangul falls back to Pretendard) on the style's
+descending scale steps, with `keep-all` word breaking. Entrances, moves and
+hand-offs use the style's ease curves and durations; an exit is never longer
+than the hero move. Nothing eases on `terminalcore`. The banned list in each
+style file is closed: the page never uses what its style bans.
+
+## Layouts per shot
+
+One grid per layout, named per shot, mapped per format (`LAYOUTS` in
+`engine/styles.mjs`): `title`, `split`, `split-alt`, `stage`, `hero`, `full`
+(a full shot is subject only and shows no copy). Every type zone sits inside
+the central 90 % title-safe area. Adjacent shots never share a layout; a film
+of four or more shots uses at least three. A hand-off (`cut`, `match`,
+`wipe`, `push`, `iris`, `dissolve`, `morph`) comes from the style's list; the
+last shot's transition is `end`. Every shot names its hero: the one move the
+eye follows.
+
+## The board
+
+Round 1 ends with a board, not a preview: `stills/board.png`, one keyframe
+per shot with number, time, layout and hand-off under it, the shot's type
+zone dashed on the frame, the house style (name, palette, type) plus format,
+length and sound in the header, and the layout check in the footer. The check
+runs the text and style rules on the board frames (`stills/check.json`);
+a FAIL ends the round with exit 13 (`BOARD_CHECK_FAIL`, the QA-fail exit with
+the board named). Read the board with `read_file`, record the round with
+`look`, make the change, then render.
+
+## The gate rule names
+
+Older notes name six text rules that have no runtime of their own. They are
+contracts on the page, enforced by the QA checks and look rounds below; the
+mapping is fixed and every row has a RED test:
+
+| Doc name | Enforced by |
+|---|---|
+| `TEXT-OVERLAP` | no two settled copy lines overlap (`text-title-safe` overlap row at the settled frames) |
+| `TEXT-ON-STYLE` | copy uses the style's faces, roles and scale steps (`fonts`, `text-title-safe` family row, type scale) |
+| `TEXT-ZONE` | settled copy sits in the shot's type zone (`text-title-safe` zone row + board zone guide) |
+| `FLAT-FRAME` | no empty dark run past twice the scene hold floor (`MO-D-03` in `gate.mjs`) |
+| `DEAD-AIR` | every beat's midpoint shows a non-text image (`non-text-presence` in `stage-qa.mjs`, WARN at 1.5x) |
+| `RICH-FILL` | rich films use the style's regions: copy roles plus at least one accent (`stage-qa` role coverage on rich treatments) |
+
+`MO-D-03`'s floor is a calibration constant: it changes only with a new
+calibration table, never to let a film pass.

package/assets/lithermes-plugin/skills/lit-typographic-motion/references/style-bibles.md

@@ -36,11 +36,18 @@ merely ends. An explicit `"style"` in the brief always wins over this table.
 The report labels a style you chose as `agent default`; it says
 `user-specified` only when the user's own request named that style.
 
-| Brief mentions | Preset |
+| Brief mentions | Style |
 |---|---|
 | 터미널, 해커 / terminal, hacker, CRT | `terminalcore` |
 | 물결, 파도, 잔잔한, 흐름 / gradient, wave, tide, calm | `tidal` |
-| anything else | `swiss-signal` |
+| 따뜻한, 밝은, 종이, 손그림, 포근한, 아기자기 / warm, cozy, bright, paper, handmade, hand-drawn | `paper` (stage only) |
+| anything else | the default `swiss-signal` |
+
+A style named in the request wins; then the project's house style
+(`motion-house.json` beside the output folder, written by a passed render),
+then the keyword table above, then the genre (`explainer` takes `paper`,
+`brand-mood` takes `tidal`), then the default. The manifest records the pick
+and the reason.
 
 `system`, `status` and a bare `flow` are deliberately not keywords: they appear
 in payment-system, design-system and workflow briefs that have nothing to do

package/assets/lithermes-plugin/skills/lit-typographic-motion/references/treatment.md

@@ -57,7 +57,11 @@ span is removed from it.
 | `audience`, `channel` | Who watches, and where it plays. |
 | `format`, `formatReason` | `16:9` (1920×1080) or `9:16` (1080×1920), with a reason tied to `channel`. |
 | `durationSec` | 4 to 90. Unless the user asked for a length, `announcement`, `event`, `explainer` and `motion-graphics` run at least 10 s. |
-| `beats[]` | `{t0, t1, purpose, onScreen, motion, sound}` each. They cover 0 to `durationSec` with no gap over 0.25 s, every beat lasts at least 1.2 s, and there are at least as many beats as the genre's arc has stages. |
+| `beats[]` | `{t0, t1, purpose, onScreen, motion, sound}` each, plus `layout`, `hero` and `transition` on the stage path. They cover 0 to `durationSec` with no gap over 0.25 s, every beat lasts at least 1.2 s, and there are at least as many beats as the genre's arc has stages. |
+| `story` | `{expect, turn, payoff}` (one or two sentences each; the turn differs from the expectation) and `beat` (the shot where the turn lands: after the opening, before the end). A genre arc alone is an information order, not a story. |
+| `protagonist` | Stage path only: `{name, kind: character or object, look, acts[]}`. One drawn character or hero object that acts across the film: one act per shot, acts covering at least half the film, including the turn shot. |
+| `depth`, `render3d` | `depth` is `2d` or `3d` (a stage-path route). A `depth3d` subject device needs `depth: 3d`, and `3d` needs the subject. `render3d` is `three` (the GPU rung, the default) or `blender` (the offline Cycles rung) and needs `depth: 3d`. |
+| `world` | Stage path, rich register only: `{layers[], labels[], camera[]}`. At least 3 depth layers back to front, at least 6 labelled parts the viewer reads (4 words each at most), and camera moves covering at least half the shots. |
 | `subject` | `{name, source: user or invented, specifics[]}`. When the request names no specific subject, invent one: a name plus at least 2 concrete specifics (what it is or does, for whom, one distinctive detail). |
 | `visualDevices[]` | `{kind, role: subject, support or texture, beats[]}`, where `beats` lists beat indexes from 0. Kinds: `illustration`, `diagram`, `chart`, `icon`, `shape`, `path`, `mask`, `depth3d`, `particles`, `grid`, `gradient`, `photo-texture`. |
 | `typePlan` | `{faces[], hierarchy, maxWordsOnScreen}`. Faces come from this product's verified set: Pretendard, Archivo, Galmuri9, VT323, Silkscreen, MesloLGS NF. |
@@ -89,13 +93,21 @@ span is removed from it.
 
 ### Sound rules
 
-- `generated` is the default under bare `lit`, on both paths. The `sound`
-  subcommand builds a deterministic bed from the treatment: tempo, pulse and a
-  pad chord progression, plus accents only where a beat's `sound` field asks
-  (a hit on a cut, a rise into a change, a closing cadence). `sound.palette` is
-  one of `soft-mallet`, `warm-keys`, `glass-pulse` or `low-strings`; key and
-  tempo follow from the treatment, so two films rarely share a bed. The reply
-  labels the bed as generated.
+- `score` is the default for rich films, built per film from the film itself:
+  the words seed its key, mode, tempo, progression, motif and percussion, the
+  beats arrange it (intro, build, the drop on the turn, break, outro), and the
+  `sound` subcommand writes `sound/score.wav`, one stem per part in
+  `sound/stems/` and the cue plan in `sound-cues.json`. The reply labels the
+  score as generated. `generated` is the bed for minimal films only: tempo,
+  pulse and a pad chord progression, plus accents only where a beat's `sound`
+  field asks (a hit on a cut, a rise into a change, a closing cadence).
+  `sound.palette` is one of `soft-mallet`, `warm-keys`, `glass-pulse` or
+  `low-strings`; key and tempo follow from the treatment, so two films rarely
+  share a bed.
+- On the stage path a `score` or `generated` film lists at least 2 on-screen
+  events that make a sound (`sound.events`: `{t, on, kind}`, `kind` one of
+  `tap`, `hit`, `whoosh`, `chime`), at least half of them away from the cuts.
+  The score plays them on screen; the bed accents them where a beat asks.
 - `supplied`: the user's WAV, named in `sound.file`, relative to the output dir.
 - `authored`: a WAV you wrote into the stage dir (`stage/*.wav`).
 - `none` only when the user asked for silence, or when the channel plays muted
@@ -143,6 +155,10 @@ mostly equal this example's (`copiedExample`). Do not copy it; write your own.
   "beats": [
     { "t0": "<start s>", "t1": "<end s>", "purpose": "<arc stage>", "onScreen": "<what is drawn>", "motion": "<how it moves>", "sound": "<what the sound does here>" }
   ],
+  "story": { "expect": "<what the viewer expects>", "turn": "<what happens instead>", "beat": "<shot index of the turn>", "payoff": "<what the ending gives>" },
+  "protagonist": { "name": "<the character or hero object>", "kind": "<character or object>", "look": "<shape, material, colour role, scale>", "acts": [{ "beat": "<beat index>", "action": "<what it does in this shot>" }] },
+  "depth": "<2d or 3d>",
+  "world": { "layers": ["<depth layer, back to front>"], "labels": ["<part the viewer reads>"], "camera": [{ "beat": "<beat index>", "move": "<push-in, truck, crane, orbit, rack focus>" }] },
   "subject": { "name": "<a specific name>", "source": "<user or invented>", "specifics": ["<what it is or does>", "<for whom>", "<one distinctive detail>"] },
   "visualDevices": [
     { "kind": "<device kind>", "role": "<subject, support or texture>", "beats": ["<beat index>"] }

package/assets/lithermes-plugin/skills/lit-typographic-motion/styles/paper.json

@@ -0,0 +1,41 @@
+{
+  "schema": "litfamily.motion-style/v1",
+  "id": "paper",
+  "name": "Paper",
+  "summary": "A warm paper ground, near-black ink, one terracotta signal and one blue moment; soft springs, hand-drawn calm.",
+  "light": true,
+  "typePreset": null,
+  "palette": { "ground": "#F3EEE5", "surface": "#E6DED0", "ink": "#1D1B18", "muted": "#5B564E", "signal": "#B0452A", "accent": "#2B5D8E", "line": "#C9BFAE" },
+  "accents": [{ "role": "growth and done", "color": "#3F7D3A" }, { "role": "a second data series", "color": "#7A3E7A" }, { "role": "a warning or a date", "color": "#8A6418" }, { "role": "a third data series", "color": "#1F6F6B" }],
+  "textRoles": ["ink", "muted", "signal", "accent", "ground"],
+  "faces": {
+    "display": { "family": "Pretendard", "weight": 700 },
+    "headline": { "family": "Pretendard", "weight": 700 },
+    "body": { "family": "Pretendard", "weight": 400 },
+    "label": { "family": "MesloLGS NF", "weight": 400 }
+  },
+  "scale": {
+    "16:9": { "display": 112, "headline": 68, "body": 40, "label": 26 },
+    "9:16": { "display": 108, "headline": 74, "body": 46, "label": 32 }
+  },
+  "leading": { "display": 1.15, "headline": 1.25, "body": 1.6, "label": 1.4 },
+  "motion": {
+    "ease": { "enter": [0.22, 1, 0.36, 1], "move": [0.65, 0, 0.35, 1], "exit": [0.55, 0, 1, 0.45] },
+    "dur": { "micro": 0.18, "move": 0.55, "hero": 0.8, "exit": 0.32 },
+    "stagger": { "letter": 0.03, "word": 0.09, "item": 0.1 },
+    "spring": { "micro": { "zeta": 0.85, "hz": 3.5 }, "panel": { "zeta": 0.8, "hz": 2 }, "headline": { "zeta": 0.95, "hz": 2.2 }, "subject": { "zeta": 0.6, "hz": 1.8 }, "camera": { "zeta": 1, "hz": 0.5 } },
+    "secondary": { "delay": 0.15, "travel": 0.6 },
+    "ambient": { "travel": 0.04 },
+    "push": 0.02
+  },
+  "transitions": ["cut", "match", "wipe", "iris", "push"],
+  "ground": { "kind": "flat" },
+  "sound": { "timbre": "soft-keys", "key": "F", "mode": "major", "tempo": 96 },
+  "score": { "genre": "garage" },
+  "beds": [
+    { "timbre": "soft-keys", "key": "F", "mode": "major", "tempo": 96 },
+    { "timbre": "felt-strings", "key": "G", "mode": "major", "tempo": 88 },
+    { "timbre": "glass", "key": "C", "mode": "major", "tempo": 108 }
+  ],
+  "bans": ["drop shadows that float type", "neon or glow", "gradients on type", "a saturated colour with no role", "bouncy type"]
+}

package/assets/lithermes-plugin/skills/lit-typographic-motion/styles/swiss-signal.json

@@ -0,0 +1,41 @@
+{
+  "schema": "litfamily.motion-style/v1",
+  "id": "swiss-signal",
+  "name": "Swiss signal",
+  "summary": "Ink ground, bone type, one teal signal and one amber moment; type lands precisely and cuts hard.",
+  "light": false,
+  "typePreset": "swiss-signal",
+  "palette": { "ground": "#0C0E13", "surface": "#171B24", "ink": "#E9EBE4", "muted": "#A4A9AF", "signal": "#0F7A82", "accent": "#D9A441", "line": "#4B5058" },
+  "accents": [{ "role": "state under review", "color": "#E2725B" }, { "role": "state planned", "color": "#9B8CFF" }, { "role": "state done", "color": "#8FC25A" }, { "role": "state in progress", "color": "#5BA8E0" }],
+  "textRoles": ["ink", "muted", "signal", "accent", "ground"],
+  "faces": {
+    "display": { "family": "Archivo", "weight": 900, "stretch": "100%" },
+    "headline": { "family": "Archivo", "weight": 700, "stretch": "100%" },
+    "body": { "family": "Pretendard", "weight": 400 },
+    "label": { "family": "MesloLGS NF", "weight": 400 }
+  },
+  "scale": {
+    "16:9": { "display": 128, "headline": 76, "body": 40, "label": 26 },
+    "9:16": { "display": 120, "headline": 80, "body": 46, "label": 32 }
+  },
+  "leading": { "display": 1.1, "headline": 1.2, "body": 1.55, "label": 1.4 },
+  "motion": {
+    "ease": { "enter": [0.16, 1, 0.3, 1], "move": [0.65, 0, 0.35, 1], "exit": [0.7, 0, 0.84, 0] },
+    "dur": { "micro": 0.15, "move": 0.45, "hero": 0.6, "exit": 0.28 },
+    "stagger": { "letter": 0.025, "word": 0.07, "item": 0.08 },
+    "spring": { "micro": { "zeta": 1, "hz": 4 }, "panel": { "zeta": 0.9, "hz": 2.2 }, "headline": { "zeta": 1, "hz": 2.6 }, "subject": { "zeta": 0.8, "hz": 1.8 }, "camera": { "zeta": 1, "hz": 0.5 } },
+    "secondary": { "delay": 0.15, "travel": 0.6 },
+    "ambient": { "travel": 0.03 },
+    "push": 0.02
+  },
+  "transitions": ["cut", "wipe", "match", "push"],
+  "ground": { "kind": "flat", "grid": true },
+  "sound": { "timbre": "glass", "key": "A", "mode": "minor", "tempo": 104 },
+  "score": { "genre": "house" },
+  "beds": [
+    { "timbre": "glass", "key": "A", "mode": "minor", "tempo": 104 },
+    { "timbre": "pulse-synth", "key": "D", "mode": "minor", "tempo": 112 },
+    { "timbre": "soft-keys", "key": "C", "mode": "major", "tempo": 96 }
+  ],
+  "bans": ["glow or bloom on type", "an accent colour with no role", "centred fade-in as the only move", "overshoot or bounce on type", "particles as decoration", "gradients behind type"]
+}

package/assets/lithermes-plugin/skills/lit-typographic-motion/styles/terminalcore.json

@@ -0,0 +1,42 @@
+{
+  "schema": "litfamily.motion-style/v1",
+  "id": "terminalcore",
+  "name": "Terminalcore",
+  "summary": "A navy terminal: phosphor type that appears at typing speed, one signal hue, hard cuts, nothing eases.",
+  "light": false,
+  "typePreset": "terminalcore",
+  "palette": { "ground": "#05070A", "surface": "#0C1116", "ink": "#39FF6A", "muted": "#7C8B93", "signal": "#39FF6A", "line": "#1E2A33" },
+  "accents": [{ "role": "a warning line", "color": "#FFB23F" }, { "role": "an error line", "color": "#FF6B6B" }, { "role": "a path or a link", "color": "#6CA8FF" }],
+  "textRoles": ["ink", "muted", "signal", "ground"],
+  "faces": {
+    "display": { "family": "VT323", "weight": 400 },
+    "headline": { "family": "VT323", "weight": 400 },
+    "body": { "family": "VT323", "weight": 400 },
+    "label": { "family": "MesloLGS NF", "weight": 400 }
+  },
+  "hangul": { "family": "Galmuri9", "weight": 400 },
+  "scale": {
+    "16:9": { "display": 126, "headline": 81, "body": 45, "label": 36 },
+    "9:16": { "display": 117, "headline": 81, "body": 54, "label": 36 }
+  },
+  "leading": { "display": 1.1, "headline": 1.2, "body": 1.5, "label": 1.4 },
+  "motion": {
+    "ease": { "enter": [0, 0, 1, 1], "move": [0, 0, 1, 1], "exit": [0, 0, 1, 1] },
+    "dur": { "micro": 0.1, "move": 0.3, "hero": 0.5, "exit": 0.1 },
+    "stagger": { "letter": 0.0455, "word": 0.18, "item": 0.25 },
+    "spring": { "micro": { "zeta": 1, "hz": 6 }, "panel": { "zeta": 1, "hz": 4 }, "headline": { "zeta": 1, "hz": 4 }, "subject": { "zeta": 1, "hz": 3 }, "camera": { "zeta": 1, "hz": 1 } },
+    "secondary": { "delay": 0.1, "travel": 0.6 },
+    "ambient": { "travel": 0.02 },
+    "push": 0
+  },
+  "transitions": ["cut", "wipe"],
+  "ground": { "kind": "flat", "panel": "surface" },
+  "sound": { "timbre": "pulse-synth", "key": "E", "mode": "minor", "tempo": 120 },
+  "score": { "genre": "tech-house" },
+  "beds": [
+    { "timbre": "pulse-synth", "key": "E", "mode": "minor", "tempo": 120 },
+    { "timbre": "glass", "key": "B", "mode": "minor", "tempo": 132 },
+    { "timbre": "pulse-synth", "key": "A", "mode": "minor", "tempo": 100 }
+  ],
+  "bans": ["falling code rain", "purple-cyan neon haze", "glitch running continuously", "an accent hue with no role", "pixel type too small to read", "eased type"]
+}

package/assets/lithermes-plugin/skills/lit-typographic-motion/styles/tidal.json

@@ -0,0 +1,41 @@
+{
+  "schema": "litfamily.motion-style/v1",
+  "id": "tidal",
+  "name": "Tidal",
+  "summary": "Indigo ground with a slow teal-to-violet flow, off-white type that drifts with it, one coral moment.",
+  "light": false,
+  "typePreset": "tidal",
+  "palette": { "ground": "#0E1420", "surface": "#18223A", "ink": "#E8ECEF", "muted": "#A9B3C1", "signal": "#5FB3C4", "accent": "#E07856", "line": "#3A4660", "stopA": "#124559", "stopB": "#4C3B6E" },
+  "accents": [{ "role": "a warm highlight", "color": "#E8C07A" }, { "role": "a second current", "color": "#7FD6B0" }, { "role": "a far layer", "color": "#B9A3E3" }],
+  "textRoles": ["ink", "muted", "signal", "accent", "ground"],
+  "faces": {
+    "display": { "family": "Archivo", "weight": 700, "stretch": "100%" },
+    "headline": { "family": "Archivo", "weight": 700, "stretch": "100%" },
+    "body": { "family": "Pretendard", "weight": 400 },
+    "label": { "family": "MesloLGS NF", "weight": 400 }
+  },
+  "scale": {
+    "16:9": { "display": 116, "headline": 72, "body": 40, "label": 26 },
+    "9:16": { "display": 112, "headline": 76, "body": 46, "label": 32 }
+  },
+  "leading": { "display": 1.12, "headline": 1.22, "body": 1.6, "label": 1.4 },
+  "motion": {
+    "ease": { "enter": [0.37, 0, 0.63, 1], "move": [0.45, 0, 0.55, 1], "exit": [0.5, 0, 0.75, 0] },
+    "dur": { "micro": 0.25, "move": 0.9, "hero": 1.2, "exit": 0.6 },
+    "stagger": { "letter": 0.04, "word": 0.12, "item": 0.14 },
+    "spring": { "micro": { "zeta": 1, "hz": 2.5 }, "panel": { "zeta": 1, "hz": 1.2 }, "headline": { "zeta": 1, "hz": 1.4 }, "subject": { "zeta": 0.9, "hz": 1 }, "camera": { "zeta": 1, "hz": 0.35 } },
+    "secondary": { "delay": 0.2, "travel": 0.6 },
+    "ambient": { "travel": 0.05 },
+    "push": 0.025
+  },
+  "transitions": ["dissolve", "match", "wipe"],
+  "ground": { "kind": "flow", "stops": ["stopA", "stopB"] },
+  "sound": { "timbre": "felt-strings", "key": "D", "mode": "major", "tempo": 84 },
+  "score": { "genre": "deep-house" },
+  "beds": [
+    { "timbre": "felt-strings", "key": "D", "mode": "major", "tempo": 84 },
+    { "timbre": "glass", "key": "F#", "mode": "minor", "tempo": 76 },
+    { "timbre": "soft-keys", "key": "Bb", "mode": "major", "tempo": 72 }
+  ],
+  "bans": ["a rainbow or hue-cycling ramp", "bloom on the flow", "hard snaps on type", "glitch as texture", "flow so fast that held type smears"]
+}

package/assets/lithermes-plugin/skills/litresearch/SKILL.md

@@ -578,6 +578,10 @@ Stop when:
 
 On resume (after compaction, cancel, or restart): reread the on-disk `SESSION_DIR` — `expansion-log.md` for the lead ledger, every `wave-*.md` for merged findings, and the live plain-text tracker — before launching any new wave. The on-disk ledger, not session memory, is the source of truth for what is open and closed.
 
+## Port handoff
+
+When the user wants a found mechanism ported into their own skill, hand the ranked sources to `lit-hijack` (`lit hijack <source> into <target>`): it captures with provenance, applies the licence gate and builds a source-free spec the target can be built from.
+
 ## Anti-patterns
 
 - Self-activating on a question one read would answer.