@revola-ai/video-craft 0.2.1

package/dist/rules/noShorthandWithUndefinedLonghand.js

@@ -0,0 +1,93 @@
+import { SyntaxKind } from "ts-morph";
+const FAMILIES = {
+  padding: /^padding(Top|Right|Bottom|Left|Block|Inline)/,
+  margin: /^margin(Top|Right|Bottom|Left|Block|Inline)/,
+  // `background` resets image/position/size/repeat/origin/clip/attachment/color.
+  // It does NOT reset background-blend-mode (CSS Backgrounds L3).
+  background: /^background(Color|Image|Position|Size|Repeat|Attachment|Clip|Origin)/,
+  // Ordered before `border` so the corner spellings can never be claimed by it.
+  borderRadius: /^border(Top|Bottom)(Left|Right)Radius$/,
+  // The negative lookahead is load-bearing: without it `^border(Top` also
+  // matches `borderTopLeftRadius`, and `border` does not reset border-radius.
+  border: /^border(Top|Right|Bottom|Left|Width|Style|Color|Block|Inline)(?!.*Radius)/,
+  font: /^font(Size|Weight|Family|Style|Variant|Stretch)/,
+  flex: /^flex(Grow|Shrink|Basis)$/,
+  overflow: /^overflow(X|Y)$/,
+  transition: /^transition(Property|Duration|TimingFunction|Delay)$/,
+  animation: /^animation(Name|Duration|TimingFunction|Delay|IterationCount|Direction|FillMode|PlayState)$/,
+  gap: /^(row|column)Gap$/
+};
+const noShorthandWithUndefinedLonghand = {
+  id: "no-shorthand-with-undefined-longhand",
+  claim: "Never put a longhand style property explicitly set to `undefined` in the same object as its shorthand; build the style object from only the keys you actually have.",
+  why: "React writes style keys in order, so an undefined longhand clears the shorthand that preceded it - one forwarded style object silently removed the padding from every panel in a film, and the source read as correct.",
+  learnedFrom: "claude-sessions-digest/product-room-video.md",
+  tier: "gate",
+  verify: "`vitest run packages/video-craft` - machine-checked over scene and kit source",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "source",
+    check: {
+      // Scene trees plus the kit: anywhere a style object is composed or
+      // forwarded. Same blast radius as the other geometry-class checks.
+      include: [
+        "revola-video/src/**/*.{ts,tsx}",
+        "workday-dple-video/src/**/*.{ts,tsx}",
+        "spec-videos/src/**/*.{ts,tsx}",
+        "qpa-video/03_scenes/**/*.{js,jsx,ts,tsx}",
+        "qse-qguard-video/src/**/*.{ts,tsx}",
+        "rcp-fund7-video/src/**/*.{ts,tsx}",
+        "expanse-video/src/**/*.{ts,tsx}",
+        "reverence-video/src/**/*.{ts,tsx}",
+        // Added Task 23: klaviyo-segments-video and radar-fixture-video were
+        // silently excluded - the same gap deterministic-scene-source had.
+        "klaviyo-segments-video/src/**/*.{ts,tsx}",
+        "radar-fixture-video/src/**/*.{ts,tsx}",
+        "packages/video-kit/src/**/*.{ts,tsx}"
+      ],
+      run(file, relPath) {
+        const findings = [];
+        for (const obj of file.getDescendantsOfKind(SyntaxKind.ObjectLiteralExpression)) {
+          const props = obj.getProperties().filter(
+            (p) => p.isKind(SyntaxKind.PropertyAssignment) || p.isKind(SyntaxKind.ShorthandPropertyAssignment)
+          );
+          const unquote = (n) => n.replace(/^["']|["']$/g, "");
+          const names = new Set(
+            props.map(
+              (p) => unquote(
+                p.isKind(SyntaxKind.PropertyAssignment) ? p.getName() : p.asKindOrThrow(SyntaxKind.ShorthandPropertyAssignment).getName()
+              )
+            )
+          );
+          for (const prop of props) {
+            const shorthandSyntax = prop.isKind(SyntaxKind.ShorthandPropertyAssignment);
+            const name = unquote(
+              shorthandSyntax ? prop.asKindOrThrow(SyntaxKind.ShorthandPropertyAssignment).getName() : prop.asKindOrThrow(SyntaxKind.PropertyAssignment).getName()
+            );
+            let possiblyUndefined = shorthandSyntax;
+            if (!shorthandSyntax) {
+              const init = prop.asKindOrThrow(SyntaxKind.PropertyAssignment).getInitializer();
+              possiblyUndefined = init?.getKind() === SyntaxKind.Identifier;
+            }
+            if (!possiblyUndefined) continue;
+            for (const [shorthand, longhands] of Object.entries(FAMILIES)) {
+              if (!longhands.test(name)) continue;
+              if (!names.has(shorthand)) continue;
+              findings.push({
+                file: relPath,
+                line: prop.getStartLineNumber(),
+                match: prop.getText().slice(0, 60),
+                message: `\`${name}\` may be undefined beside the \`${shorthand}\` shorthand in the same object, which clears the shorthand; omit the key instead of passing it undefined`
+              });
+              break;
+            }
+          }
+        }
+        return findings;
+      }
+    }
+  }
+};
+export {
+  noShorthandWithUndefinedLonghand
+};

package/dist/rules/noStackedFadesAtACut.js

@@ -0,0 +1,24 @@
+const noStackedFadesAtACut = {
+  id: "no-stacked-fades-at-a-cut",
+  claim: "Never stack the outgoing scene's fade-out with an incoming fade-in at a cut; at most one side of a seam may fade.",
+  why: "Two stacked fades multiply to near-zero and the film dips through a black hole at the seam; no easing can fix a cut that happens in black.",
+  learnedFrom: "revola-video/BUILD_NOTES_CRAFT.md",
+  tier: "gate",
+  verify: "`video radar:film --project <dir> --video <mp4> --check fade-stack-at-cut`",
+  owner: "fade-stack-at-cut",
+  exceptions: [
+    {
+      project: "qse-qguard-video",
+      decision: "client chose ACT854's paired 14f exit-fade + 14f enter-fade at every seam for the QGuard restyle; the black-dip risk is accepted and checked with stills at each seam",
+      recordedIn: "qse-qguard-video/docs/motion-brand-spec.md"
+    }
+  ],
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/scenes/craft/craftKit.tsx" }
+  }
+};
+export {
+  noStackedFadesAtACut
+};

package/dist/rules/noStaticHolds.js

@@ -0,0 +1,17 @@
+const noStaticHolds = {
+  id: "no-static-holds",
+  claim: "No shot holds fully static for more than about two seconds: the background always has subtle continuous motion, and idle hero objects get living motion (drift, rotate, breathe).",
+  why: "Every static hold in the corpus was eventually flagged as boring or empty; continuous low-amplitude motion is what separates a motion-graphics video from a slideshow.",
+  learnedFrom: "claude-sessions-digest/portfolio-reels.md",
+  tier: "gate",
+  verify: "`video radar:film --project <dir> --video <mp4> --check static-hold`",
+  owner: "static-hold",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    unanchorable: "The rule is a motion-over-time judgment; it is not expressible as a single code location."
+  }
+};
+export {
+  noStaticHolds
+};

package/dist/rules/occlusionVisibleElements.js

@@ -0,0 +1,17 @@
+const occlusionVisibleElements = {
+  id: "occlusion-visible-elements",
+  claim: "A tagged element stays visibly on top for the whole duration it is meant to be read; another element must never paint over enough of it, for long enough, that it reads as buried rather than merely overlapping.",
+  why: "A label that exists, sits in its correct band, and is fully painted over by a later layer looks identical to a correct scene in source and in every geometry check that only reasons about position - the QGuard station labels and S2 lane labels were both invisible in the shipped render while every positional check stayed clean.",
+  learnedFrom: "docs/superpowers/specs/2026-07-31-defect-radar-design.md",
+  tier: "gate",
+  verify: "`video radar:scene --project <dir> --comp <id> --check occlusion`",
+  owner: "occlusion",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    unanchorable: "The rule is a paint-order judgment across a shot's whole sampled range; no single code location expresses it."
+  }
+};
+export {
+  occlusionVisibleElements
+};

package/dist/rules/oneContinuousVoTrack.js

@@ -0,0 +1,15 @@
+const oneContinuousVoTrack = {
+  id: "one-continuous-vo-track",
+  claim: "Play the narration as one continuous Audio track from frame 0 and make the film exactly its length; never slice the VO into per-scene chunks that start at scene boundaries.",
+  why: "Per-scene VO slices start at each scene's first frame while scenes run longer than their slices, silently inserting dead air at every seam - the sliced build padded the read with 9s across four seams and the film read as padded.",
+  learnedFrom: "revola-video/BUILD_NOTES_CRAFT.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/RevolaCraft.tsx" }
+  }
+};
+export {
+  oneContinuousVoTrack
+};

package/dist/rules/onePunchPerMomentClass.js

@@ -0,0 +1,15 @@
+const onePunchPerMomentClass = {
+  id: "one-punch-per-moment-class",
+  claim: "Use a beat punch (zoom-in, scale pop, flash) at most once per class of moment; never repeat the same punch on every keypress, card, or list item.",
+  why: "A punch repeated on every event stops reading as emphasis and starts reading as a bug; repeated beat zooms were rejected twice in caps.",
+  learnedFrom: "claude-sessions-digest/portfolio-reels.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    unanchorable: "The rule is an emphasis-budget judgment across a scene's events; no single code location expresses it."
+  }
+};
+export {
+  onePunchPerMomentClass
+};

package/dist/rules/oneRenderPerRound.js

@@ -0,0 +1,15 @@
+const oneRenderPerRound = {
+  id: "one-render-per-round",
+  claim: "Close every defect a render surfaced before rendering again, and verify each fix with stills spanning the whole window it changes, not a single frame.",
+  why: "Rendering per fix instead of per round cost QGuard round 2 two extra full renders (~14 minutes), one of them because a fix was verified at a single frame while the motion it altered spanned a hundred.",
+  learnedFrom: "qse-qguard-video/BUILD_NOTES.md",
+  tier: "process",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "packages/video-cli/src/review.ts" }
+  }
+};
+export {
+  oneRenderPerRound
+};

package/dist/rules/openStaticAfterAHardCut.js

@@ -0,0 +1,22 @@
+const openStaticAfterAHardCut = {
+  id: "open-static-after-a-hard-cut",
+  claim: "After a hard cut, open the incoming scene static and at full opacity: no entry zoom, no entry blur, and the first two camera keys equal so nothing moves until the first deliberate travel.",
+  why: "A momentum entry is theoretically correct continuation but on screen reads as the camera drifting; the landing element must be the first thing the eye finds, and it must be still.",
+  learnedFrom: "revola-video/BUILD_NOTES_CRAFT.md",
+  tier: "craft",
+  exceptions: [
+    {
+      project: "qse-qguard-video",
+      decision: "client chose ACT854's 0.97-to-1 entry settle at every seam for the QGuard restyle; scenes still hold their first camera key static underneath it",
+      recordedIn: "qse-qguard-video/docs/motion-brand-spec.md"
+    }
+  ],
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/scenes/craft/S3Line.tsx" }
+  }
+};
+export {
+  openStaticAfterAHardCut
+};

package/dist/rules/openingsAndClosingsCarryMore.js

@@ -0,0 +1,15 @@
+const openingsAndClosingsCarryMore = {
+  id: "openings-and-closings-carry-more",
+  claim: "The opening and closing scenes out-spectacle the middle: frame one already carries the film's biggest visual statement, and the close lands one deliberate, composed payoff instead of fizzling.",
+  why: "'First scene is too boring for an opening' and 'make it an amazing closing scene' recurred across builds as their own feedback rounds; a strong middle never rescued a film whose first seconds read as template.",
+  learnedFrom: "docs/style/CREATIVE_EDGE.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    unanchorable: "A relative-spectacle judgment across scene positions; no single code location expresses it."
+  }
+};
+export {
+  openingsAndClosingsCarryMore
+};

package/dist/rules/persistentDeviceFrames.js

@@ -0,0 +1,15 @@
+const persistentDeviceFrames = {
+  id: "persistent-device-frames",
+  claim: "A device frame (laptop, phone, browser chrome) enters the video once; subsequent shots swap only the content inside it, never re-animate the frame's entrance.",
+  why: "A frame that re-enters on every shot reads as a reset and was hated on sight in two separate videos; persistence is what makes a sequence feel like one continuous product story.",
+  learnedFrom: "claude-sessions-digest/revola-intro-video.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    unanchorable: "The rule is a cross-shot continuity judgment; no single code location expresses it."
+  }
+};
+export {
+  persistentDeviceFrames
+};

package/dist/rules/pixelDiffAnEmptyBandFirst.js

@@ -0,0 +1,15 @@
+const pixelDiffAnEmptyBandFirst = {
+  id: "pixel-diff-an-empty-band-first",
+  claim: "When pixel-diffing rendered frames across a seam, measure an empty region of frame first; per-frame randomized layers (film grain, dust motes) produce large raw deltas by design.",
+  why: "A raw ~120/255 per-pixel delta at a verified-perfect seam was entirely FilmGrain/DustMotes re-randomizing; without the empty-band control you chase a phantom seam artifact.",
+  learnedFrom: "revola-video/BUILD_NOTES_CRAFT.md",
+  tier: "process",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/scenes/craft/craftKit.tsx" }
+  }
+};
+export {
+  pixelDiffAnEmptyBandFirst
+};

package/dist/rules/planIsPublishedNotGating.js

@@ -0,0 +1,15 @@
+const planIsPublishedNotGating = {
+  id: "plan-is-published-not-gating",
+  claim: "Publish the scene-flow plan with its open questions and keep building; never hold scene work waiting for sign-off, and when an answer arrives, change the plan and re-derive from it.",
+  why: "A plan used as a barrier stops all downstream work for feedback that is usually orthogonal to it - the QGuard build spent 40 minutes before its first scene against 8.9 in the reference sessions - while the things sign-off cannot catch (a plan the build silently does not honour) pass it anyway.",
+  learnedFrom: "qse-qguard-video/BUILD_NOTES.md",
+  tier: "process",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "packages/video-cli/src/planmd.ts" }
+  }
+};
+export {
+  planIsPublishedNotGating
+};

package/dist/rules/poweredByRevolaWatermark.js

@@ -0,0 +1,15 @@
+const poweredByRevolaWatermark = {
+  id: "powered-by-revola-watermark",
+  claim: "Every video carries the 'Powered by Revola' watermark - the kit's RevolaWatermark, rendered in screen space at the film level - unless the video explicitly specifies otherwise.",
+  why: "It is the standing brand default for Revola videos; sourcing it from @revola-ai/video-kit keeps it one import instead of a per-project reimplementation, and a film-level screen-space placement holds it fixed through scene camera moves and off the very edge so a minor crop cannot shave it.",
+  learnedFrom: "HOW_I_BUILD_VIDEOS.md",
+  tier: "process",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "packages/video-kit/src/react/bricks/RevolaWatermark.tsx", symbol: "RevolaWatermark" }
+  }
+};
+export {
+  poweredByRevolaWatermark
+};

package/dist/rules/predrawContentPresentAtTheCut.js

@@ -0,0 +1,17 @@
+const predrawContentPresentAtTheCut = {
+  id: "predraw-content-present-at-the-cut",
+  claim: "Give anything that must be visible on a scene's first frame a negative draw-on start (e.g. start={-20}); start=0 evaluates to zero progress on frame 0 and the cut lands on an empty frame.",
+  why: "The S3 spine with start=0 made the cut land on a black frame; a negative start pre-draws it while frame still advances, keeping the line boil alive.",
+  learnedFrom: "revola-video/BUILD_NOTES_CRAFT.md",
+  tier: "gate",
+  verify: "`video radar:film --project <dir> --video <mp4> --check dead-frame-at-cut`",
+  owner: "dead-frame-at-cut",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/scenes/craft/ink.tsx", symbol: "drawP" }
+  }
+};
+export {
+  predrawContentPresentAtTheCut
+};

package/dist/rules/premiumSurfacesNotFlatBorders.js

@@ -0,0 +1,15 @@
+const premiumSurfacesNotFlatBorders = {
+  id: "premium-surfaces-not-flat-borders",
+  claim: "Give panels a layered surface - contact plus ambient plus long-throw shadow, a top sheen, and a gradient hairline ring - instead of a flat 1px border.",
+  why: "Flat borders are the single clearest cheap-glass tell, and the surface treatment is what separated the reference videos from a first draft that used the same layout and the same palette.",
+  learnedFrom: "claude-sessions-digest/product-room-video.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/productroom/Glass.tsx" }
+  }
+};
+export {
+  premiumSurfacesNotFlatBorders
+};

package/dist/rules/radarDispositionsAreHumanOnly.js

@@ -0,0 +1,17 @@
+const radarDispositionsAreHumanOnly = {
+  id: "radar-dispositions-are-human-only",
+  claim: "Never accept or dismiss a radar claim; surface it and continue. Disposition authority is human-only.",
+  why: "An agent that quietly disposes its own findings is the exact single-pair-of-eyes failure the radar exists to remove - a judge claim an agent waved through on the operator's behalf is indistinguishable from one nobody ever reviewed.",
+  learnedFrom: "docs/superpowers/specs/2026-07-31-defect-radar-design.md",
+  tier: "gate",
+  verify: "`video radar:accept`/`radar:dismiss` refuse without a human `--operator <name>` and refuse outright under an agent process (`CLAUDECODE` set)",
+  owner: "coherence",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "packages/video-cli/src/cli.ts" }
+  }
+};
+export {
+  radarDispositionsAreHumanOnly
+};

package/dist/rules/realAssetsNotPlaceholders.js

@@ -0,0 +1,15 @@
+const realAssetsNotPlaceholders = {
+  id: "real-assets-not-placeholders",
+  claim: "Mock UIs and cards carry real assets and realistic, detailed content: brand SVG logos and icons (never colored dots or gradient squares), full-length plausible copy, no empty placeholder cards.",
+  why: "Placeholder shapes and short generic copy are the second half of the AI-template read; every video needed a de-placeholder round, and detail density was the fix that made recreated UIs land.",
+  learnedFrom: "claude-sessions-digest/portfolio-reels.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    unanchorable: "The rule is a content-density judgment over scene JSX; no single code location expresses it."
+  }
+};
+export {
+  realAssetsNotPlaceholders
+};

package/dist/rules/rebuildUiFromReconNotScreenshots.js

@@ -0,0 +1,15 @@
+const rebuildUiFromReconNotScreenshots = {
+  id: "rebuild-ui-from-recon-not-screenshots",
+  claim: "Rebuild product pages 1:1 as React components from recon captures; never embed screenshots in scenes or ship a generic stub.",
+  why: "Screenshots cannot be re-themed, animated per-element, or data-scrubbed, and a stub misrepresents the product: the v1 BOM panels were a one-chart stub and the client bounced them.",
+  learnedFrom: "act854-video/BUILD_NOTES.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "qpa-video/03_scenes/act854/panels.jsx" }
+  }
+};
+export {
+  rebuildUiFromReconNotScreenshots
+};

package/dist/rules/reconStrandsRunInParallel.js

@@ -0,0 +1,15 @@
+const reconStrandsRunInParallel = {
+  id: "recon-strands-run-in-parallel",
+  claim: "Run brand, product, artifact-accuracy and VO-script recon concurrently, each strand in its own worktree and owning exactly one declared output path; the plan is the join, and nothing before it runs in series.",
+  why: "The strands share no inputs and no outputs, so serialising them adds their durations instead of taking their maximum - 17 minutes of the QGuard build's 40-minute pre-scene phase was recon done one step at a time.",
+  learnedFrom: "qse-qguard-video/BUILD_NOTES.md",
+  tier: "process",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "packages/video-cli/src/schema.ts" }
+  }
+};
+export {
+  reconStrandsRunInParallel
+};

package/dist/rules/registryBeforeHandrolling.js

@@ -0,0 +1,15 @@
+const registryBeforeHandrolling = {
+  id: "registry-before-handrolling",
+  claim: "Reach for the remocn registry before hand-authoring any generic animated element (counter, bar chart, text reveal, backdrop, transition).",
+  why: "Hand-authoring what the registry already provides creates one-off implementations with no upstream, repeating the pre-registry _lib sprawl.",
+  learnedFrom: "HOW_I_BUILD_VIDEOS.md",
+  tier: "process",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/components/remocn/backdrop.tsx" }
+  }
+};
+export {
+  registryBeforeHandrolling
+};

package/dist/rules/remapRateEndpointFormula.js

@@ -0,0 +1,15 @@
+const remapRateEndpointFormula = {
+  id: "remap-rate-endpoint-formula",
+  claim: "Compute a scene's playback rate as (D-1)/(P-1), never D/P, so the last playback frame maps exactly onto the last design frame.",
+  why: "Seam contracts are derived off a scene's last design frame; D/P leaves an endpoint error and the match cut drifts.",
+  learnedFrom: "revola-video/BUILD_NOTES_CRAFT.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/tokensCraft.ts", symbol: "rate" }
+  }
+};
+export {
+  remapRateEndpointFormula
+};

package/dist/rules/remocnContentTailwindChrome.js

@@ -0,0 +1,15 @@
+const remocnContentTailwindChrome = {
+  id: "remocn-content-tailwind-chrome",
+  claim: "Use remocn components for animated content (counters, charts, text reveals, backdrops, transitions) and hand-built Tailwind for all container chrome (card shells, browser chrome, grids, layout).",
+  why: "remocn has no card, spotlight, or panel primitive, so sourcing chrome from the registry stalls the build; hand-animating counters and charts wastes the registry. The split is the norm, not a workaround.",
+  learnedFrom: "HOW_I_BUILD_VIDEOS.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/scenes/V2Beat4DashboardRemocn.tsx" }
+  }
+};
+export {
+  remocnContentTailwindChrome
+};

package/dist/rules/retimeOnlyViaPlaybackOrDesignTokens.js

@@ -0,0 +1,15 @@
+const retimeOnlyViaPlaybackOrDesignTokens = {
+  id: "retime-only-via-playback-or-design-tokens",
+  claim: "Retime by moving P_* (audio changed) or D_* (choreography changed) and let rates and seams re-derive; never edit a scene's internal beats to fit audio, and shorten a rushed beat in design space.",
+  why: "Editing internal beats to fit audio bypasses the remap layer, silently breaking every derived rate, seam contract, and cue anchor.",
+  learnedFrom: "revola-video/BUILD_NOTES_CRAFT.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/tokensCraft.ts" }
+  }
+};
+export {
+  retimeOnlyViaPlaybackOrDesignTokens
+};

package/dist/rules/reviewTheRenderByFrameSweep.js

@@ -0,0 +1,15 @@
+const reviewTheRenderByFrameSweep = {
+  id: "review-the-render-by-frame-sweep",
+  claim: "Before calling a round done, sweep the RENDERED file at ~2fps into labelled contact sheets and scan every frame; source review and hand-picked stills do not count.",
+  why: "Three defects in one build were invisible in source and obvious in the render - a wrapper that silently wiped every panel's padding, an animated sub-scene rendering as an empty box, and a click beat scheduled past its sequence end so it never drew - and all three survived rounds of per-beat stills because the stills were chosen where the author expected problems, not where they were.",
+  learnedFrom: "claude-sessions-digest/product-room-video.md",
+  tier: "process",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "packages/video-cli/src/review.ts" }
+  }
+};
+export {
+  reviewTheRenderByFrameSweep
+};

package/dist/rules/rollingNumberBoundedSequence.js

@@ -0,0 +1,17 @@
+const rollingNumberBoundedSequence = {
+  id: "rolling-number-bounded-sequence",
+  claim: "Wrap RollingNumber in a Sequence spanning the whole card window and use the speed prop to settle early.",
+  why: "RollingNumber reads useVideoConfig().durationInFrames, so it counts over its Sequence's duration rather than its own. Left unwrapped it rolls for the entire shot; wrapped in a short Sequence it unmounts and the number vanishes mid-card.",
+  learnedFrom: "HOW_I_BUILD_VIDEOS.md",
+  tier: "craft",
+  scope: { kind: "component", slug: "rolling-number", field: "gotcha" },
+  enforcement: {
+    kind: "prose",
+    // Anchored to the owned Tier A port (WS1); the guidance was originally
+    // learned on the vendored Tier B copy in revola-video.
+    anchor: { file: "packages/video-kit/src/motion/rolling-number.tsx" }
+  }
+};
+export {
+  rollingNumberBoundedSequence
+};

package/dist/rules/rollingNumberSequenceLayoutNone.js

@@ -0,0 +1,16 @@
+const rollingNumberSequenceLayoutNone = {
+  id: "rolling-number-sequence-layout-none",
+  claim: 'When the Sequence around RollingNumber exists only to shift time, always pass layout="none".',
+  why: "The default Sequence wraps children in an AbsoluteFill, which silently breaks inline/flow layout inside a card - elements stack at the container origin.",
+  learnedFrom: "HOW_I_BUILD_VIDEOS.md",
+  upstream: "remotion:rules/sequencing.md",
+  tier: "craft",
+  scope: { kind: "component", slug: "rolling-number", field: "gotcha" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "packages/video-kit/src/motion/rolling-number.tsx" }
+  }
+};
+export {
+  rollingNumberSequenceLayoutNone
+};

package/dist/rules/rollingNumberTightBoxAlignment.js

@@ -0,0 +1,15 @@
+const rollingNumberTightBoxAlignment = {
+  id: "rolling-number-tight-box-alignment",
+  claim: "To flow-align RollingNumber (or any remocn primitive), wrap it in a position: relative box sized to roughly the content's natural width, never a full-width box.",
+  why: "remocn primitives are centered AbsoluteFills filling their nearest positioned ancestor; in a too-wide box the number floats to the middle or wraps mid-word.",
+  learnedFrom: "HOW_I_BUILD_VIDEOS.md",
+  tier: "craft",
+  scope: { kind: "component", slug: "rolling-number", field: "gotcha" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "packages/video-kit/src/motion/rolling-number.tsx" }
+  }
+};
+export {
+  rollingNumberTightBoxAlignment
+};

package/dist/rules/rollingNumberWhenNotToUse.js

@@ -0,0 +1,17 @@
+const rollingNumberWhenNotToUse = {
+  id: "rolling-number-when-not-to-use",
+  claim: "Do not use RollingNumber for multiple simultaneous stats (use a stat grid), for non-numeric emphasis, or when the value must be pixel-aligned to bespoke chrome without a wrapping box.",
+  why: "A grid of rolling odometers makes every stat move so nothing reads as focal, and without a wrapping position: relative box its AbsoluteFill centering fights any pixel-alignment to bespoke chrome.",
+  learnedFrom: "docs/plans/2026-07-18-ws1-manifest-check-before-build-plan.md",
+  tier: "craft",
+  scope: { kind: "component", slug: "rolling-number", field: "whenNotToUse" },
+  enforcement: {
+    kind: "prose",
+    // Anchored to the owned Tier A port (WS1); the guidance was originally
+    // learned on the vendored Tier B copy in revola-video.
+    anchor: { file: "packages/video-kit/src/motion/rolling-number.tsx" }
+  }
+};
+export {
+  rollingNumberWhenNotToUse
+};

package/dist/rules/rollingNumberWhenToUse.js

@@ -0,0 +1,17 @@
+const rollingNumberWhenToUse = {
+  id: "rolling-number-when-to-use",
+  claim: "Use RollingNumber as the animated odometer for a single headline number (users, revenue, count) that is the beat's focal point.",
+  why: "Skipping it means hand-rolling a counter (a duplicate motion primitive), and animating a number that is not the focal point turns the odometer into background noise competing with the real subject of the beat.",
+  learnedFrom: "docs/plans/2026-07-18-ws1-manifest-check-before-build-plan.md",
+  tier: "craft",
+  scope: { kind: "component", slug: "rolling-number", field: "whenToUse" },
+  enforcement: {
+    kind: "prose",
+    // Anchored to the owned Tier A port (WS1); the guidance was originally
+    // learned on the vendored Tier B copy in revola-video.
+    anchor: { file: "packages/video-kit/src/motion/rolling-number.tsx" }
+  }
+};
+export {
+  rollingNumberWhenToUse
+};

package/dist/rules/sameFamilySameProject.js

@@ -0,0 +1,15 @@
+const sameFamilySameProject = {
+  id: "same-family-same-project",
+  claim: "Build a new video for the same product family as a new composition inside the existing npm project, never as a fresh repo.",
+  why: "A fresh repo forks _lib, fonts, and node_modules - the exact fork that left colors.js at three hashes and SceneTransition.jsx at five across the old projects.",
+  learnedFrom: "HOW_I_BUILD_VIDEOS.md",
+  tier: "process",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    unanchorable: "Repo-layout doctrine; no code symbol encodes it."
+  }
+};
+export {
+  sameFamilySameProject
+};

package/dist/rules/sampleBrandFromProduct.js

@@ -0,0 +1,15 @@
+const sampleBrandFromProduct = {
+  id: "sample-brand-from-product",
+  claim: "Sample brand colors, fonts, and accents from the real product's recon capture; never guess them.",
+  why: "Guessed brand values produce a video the client immediately flags as off-brand, triggering an avoidable feedback round.",
+  learnedFrom: "HOW_I_BUILD_VIDEOS.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/tokens.ts" }
+  }
+};
+export {
+  sampleBrandFromProduct
+};

package/dist/rules/sampleVelocityFromPreviousFramePosition.js

@@ -0,0 +1,15 @@
+const sampleVelocityFromPreviousFramePosition = {
+  id: "sample-velocity-from-previous-frame-position",
+  claim: "Compute motion-blur velocity from the previous frame's evaluated position, never from a delta in curve-parameter space.",
+  why: "Parameter-space sampling on a clamped bezier reports fake speed at the clamped tail, so the cursor would have blurred permanently while at rest.",
+  learnedFrom: "revola-video/BUILD_NOTES_CRAFT.md",
+  tier: "craft",
+  scope: { kind: "pipeline" },
+  enforcement: {
+    kind: "prose",
+    anchor: { file: "revola-video/src/scenes/craft/S2Turn.tsx" }
+  }
+};
+export {
+  sampleVelocityFromPreviousFramePosition
+};