Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,8 @@ Every animation below is pure deterministic code (`sketch.js`), measured by `loo
| <img src="./gallery/cli-audit-session/showcase.gif" width="380" alt="Loop CLI Terminal Showcase"> | **Loop CLI Audit Session** (`scenes/terminal` · `phosphor`)<br>**Use case**: CLI documentation showing real flags, terminal telemetry, and pass/fail checks.<br><em>"The loop CLI audits any sketch for seam jumps, caption legibility, and source citations."</em> | `10s · 16fps`<br>`seamScore: 0.989` (`PASS`) | [showcase.json](./gallery/cli-audit-session/showcase.json) · [sketch.js](./gallery/cli-audit-session/sketch.js) · [storyboard.png](./gallery/cli-audit-session/storyboard.png) · [audit.json](./gallery/cli-audit-session/audit.json) |
| <img src="./gallery/api-pipeline-code/showcase.gif" width="380" alt="Phase Contract SDK Code Showcase"> | **Phase Contract SDK** (`scenes/code` · `studio-dark`)<br>**Use case**: Library & SDK docs pairing live-stepping code lines with a synchronized state monitor.<br><em>"Every Loop Studio sketch exports meta and a pure render(ctx, phase) function."</em> | `10s · 20fps`<br>`seamScore: 1.006` (`PASS`) | [showcase.json](./gallery/api-pipeline-code/showcase.json) · [sketch.js](./gallery/api-pipeline-code/sketch.js) · [storyboard.png](./gallery/api-pipeline-code/storyboard.png) · [audit.json](./gallery/api-pipeline-code/audit.json) |
| <img src="./gallery/mcp-mesh-topology/showcase.gif" width="380" alt="Agent Orchestrator Architecture Showcase"> | **Agent Orchestrator Mesh** (`scenes/architecture` · `aurora`)<br>**Use case**: System architecture & multi-agent / MCP service topology diagrams for RFCs & READMEs.<br><em>"The Loop Studio orchestrator coordinates the CLI renderer, seam analyzer, and cold-read subagent."</em> | `10s · 20fps`<br>`seamScore: 0.985` (`PASS`) | [showcase.json](./gallery/mcp-mesh-topology/showcase.json) · [sketch.js](./gallery/mcp-mesh-topology/sketch.js) · [storyboard.png](./gallery/mcp-mesh-topology/storyboard.png) · [audit.json](./gallery/mcp-mesh-topology/audit.json) |
| <img src="./gallery/git-pr-guardrails/showcase.webp" width="380" alt="Protected Git Workflow 60fps Showcase"> | **Protected Git Workflow** (`60 fps` WebP · `studio-dark`)<br>**Use case**: CI/CD & branch-protection explainer animating `feat/*` -> `PR + CI` -> `dev` -> `main`.<br><em>"Branch guardrails block direct pushes and require passing CI evals before merging."</em> | `8s · 60fps · 480f`<br>`seamScore: 1.148` (`PASS`) | [showcase.webp](./gallery/git-pr-guardrails/showcase.webp) · [sketch.js](./gallery/git-pr-guardrails/sketch.js) · [storyboard.png](./gallery/git-pr-guardrails/storyboard.png) · [audit.json](./gallery/git-pr-guardrails/audit.json) |
| <img src="./gallery/json-to-gif-transform/showcase.webp" width="380" alt="60fps Video Transformer Showcase"> | **60 fps Video Transformer** (`60 fps` WebP · `abyss`)<br>**Use case**: Compiler, build pipeline, or media-processing diagram converting specs into `480` frames.<br><em>"Converts brief.json into 480 phase-exact frames and encodes MP4 & WebP."</em> | `8s · 60fps · 480f`<br>`seamScore: 1.005` (`PASS`) | [showcase.webp](./gallery/json-to-gif-transform/showcase.webp) · [sketch.js](./gallery/json-to-gif-transform/sketch.js) · [storyboard.png](./gallery/json-to-gif-transform/storyboard.png) · [audit.json](./gallery/json-to-gif-transform/audit.json) |

### Ambient Loops (Mood, Backgrounds, 30–60 fps UI & Social Motion)

Expand All @@ -41,8 +43,10 @@ Every animation below is pure deterministic code (`sketch.js`), measured by `loo
| <img src="./gallery/cad-planetary/loop.gif" width="220" alt="Epicyclic Telemetry Blueprint CAD"> | **`styles/blueprint-cad`** (`blueprint`)<br>**Use case**: Robotics, hardware, CAD, and precision engineering project badges.<br><em>"Planetary gear linkages rotating at 1x and -2x harmonic speeds."</em> | `4s · 20fps · 320×320`<br>`seamScore: 1.023` (`PASS`) | [brief.json](./gallery/cad-planetary/brief.json) · [sketch.js](./gallery/cad-planetary/sketch.js) · [sheet.png](./gallery/cad-planetary/sheet.png) · [seam.json](./gallery/cad-planetary/seam.json) |
| <img src="./gallery/readme-hero-3d/loop.webp" width="220" alt="Nebula 3D Raymarched Sculpture"> | **`styles/sdf-raymarch`** (`nebula`)<br>**Use case**: Zero-dependency 3D product hero & smooth WebP/MP4 shader sculpture.<br><em>"30 fps 3D raymarched smooth-union torus and orbiting spheres."</em> | `3s · 30fps · 280×280` (WebP)<br>`seamScore: 1.061` (`PASS`) | [loop.webp](./gallery/readme-hero-3d/loop.webp) · [loop.gif](./gallery/readme-hero-3d/loop.gif) · [sketch.js](./gallery/readme-hero-3d/sketch.js) · [sheet.png](./gallery/readme-hero-3d/sheet.png) |
| <img src="./gallery/retro-crt-loader/loop.gif" width="220" alt="Amber CRT Bayer Dither Radar"> | **`styles/dither-mono`** (`amber-crt`)<br>**Use case**: Low-bandwidth CLI/game splash screen & zero-shimmer retro loader.<br><em>"30 fps amber CRT sphere and radar sweep via ordered 4×4 Bayer dithering."</em> | `3s · 30fps · 280×280`<br>`seamScore: 1.005` (`PASS`) | [loop.gif](./gallery/retro-crt-loader/loop.gif) · [loop.webp](./gallery/retro-crt-loader/loop.webp) · [sketch.js](./gallery/retro-crt-loader/sketch.js) · [sheet.png](./gallery/retro-crt-loader/sheet.png) |
| <img src="./gallery/kinetic-release-banner/loop.webp" width="220" alt="60 fps Editorial Kinetic Wave"> | **`styles/kinetic-type`** (`editorial`)<br>**Use case**: Silky **60 fps** social release announcement card & talk title slide.<br><em>"60 fps editorial kinetic typography wave with WCAG-verified focal pill."</em> | `2s · 60fps · 280×280` (WebP)<br>`seamScore: 0.987` (`PASS`) | [loop.webp](./gallery/kinetic-release-banner/loop.webp) · [loop.gif](./gallery/kinetic-release-banner/loop.gif) · [sketch.js](./gallery/kinetic-release-banner/sketch.js) · [sheet.png](./gallery/kinetic-release-banner/sheet.png) |
| <img src="./gallery/kinetic-release-banner/loop.webp" width="220" alt="60 fps Editorial Kinetic Wave"> | **`styles/kinetic-type`** (`editorial`)<br>**Use case**: Silky **60 fps** social release announcement card & talk title slide.<br><em>"60 fps 4-second editorial kinetic typography wave with WCAG-verified focal pill."</em> | `4s · 60fps · 240f` (WebP)<br>`seamScore: 0.968` (`PASS`) | [loop.webp](./gallery/kinetic-release-banner/loop.webp) · [loop.gif](./gallery/kinetic-release-banner/loop.gif) · [sketch.js](./gallery/kinetic-release-banner/sketch.js) · [sheet.png](./gallery/kinetic-release-banner/sheet.png) |
| <img src="./gallery/sonar-bathymetry/loop.gif" width="220" alt="Abyssal Bathymetry Topographic Isolines"> | **`styles/topographic-contour`** (`abyss`)<br>**Use case**: Geospatial, weather, sonar, and telemetry elevation backgrounds.<br><em>"30 fps bathymetric contour isolines over a cyclic scalar noise field."</em> | `3s · 30fps · 280×280`<br>`seamScore: 0.951` (`PASS`) | [loop.gif](./gallery/sonar-bathymetry/loop.gif) · [loop.webp](./gallery/sonar-bathymetry/loop.webp) · [sketch.js](./gallery/sonar-bathymetry/sketch.js) · [sheet.png](./gallery/sonar-bathymetry/sheet.png) |
| <img src="./gallery/live-audio-spectrum/loop.webp" width="220" alt="120 BPM 60fps Audio Spectrum"> | **`120 BPM Harmonic Spectrum`** (`ember`)<br>**Use case**: Music release visual, podcast player, & WebAudio/VST visualizer (3 bars of 4/4).<br><em>"6-second 60 fps 120 BPM harmonic equalizer with macro swell and oscilloscope."</em> | `6s · 60fps · 360f` (WebP)<br>`seamScore: 1.05` (`PASS`) | [loop.webp](./gallery/live-audio-spectrum/loop.webp) · [loop.gif](./gallery/live-audio-spectrum/loop.gif) · [sketch.js](./gallery/live-audio-spectrum/sketch.js) · [sheet.png](./gallery/live-audio-spectrum/sheet.png) |
| <img src="./gallery/orbital-telemetry-watch/loop.webp" width="220" alt="8s 60fps Orbital Radar Telemetry"> | **`Orbital Radar Telemetry`** (`blueprint`)<br>**Use case**: Aerospace HUD, satellite tracker, & DevOps live observability splash.<br><em>"8-second 60 fps radar sweep tracking 3 satellites on tilted elliptical orbits."</em> | `8s · 60fps · 480f` (WebP)<br>`seamScore: 1.037` (`PASS`) | [loop.webp](./gallery/orbital-telemetry-watch/loop.webp) · [loop.gif](./gallery/orbital-telemetry-watch/loop.gif) · [sketch.js](./gallery/orbital-telemetry-watch/sketch.js) · [sheet.png](./gallery/orbital-telemetry-watch/sheet.png) |

---

Expand Down Expand Up @@ -194,7 +198,7 @@ loop-studio/
│ ├─ lib/ # loop-kit, soft-canvas, encoders, analyzers, compositor, server
│ ├─ scripts/build-gallery.js
│ └─ test/run-evals.js
├─ gallery/ # 6 reproducible showcase & ambient loops with full artifacts
├─ gallery/ # 16 reproducible showcase & ambient loops (up to 60 fps) with full artifacts
├─ evals/ # Automated positive & negative verification gates
└─ docs/ # Phase contract, CLI manual, and renderer ADR
```
Expand Down
16 changes: 16 additions & 0 deletions gallery/git-pr-guardrails/audit.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
"id": "git-pr-guardrails",
"title": "Protected Git Workflow (8s @ 60fps)",
"mode": "showcase",
"useCase": "GitHub workflow & CI/CD guardrails explainer showing branch protection, evals, and PR merges",
"fps": 60,
"pass": true,
"seamScore": 1.148,
"duplicateFrames": 0,
"flickerScore": 0.736,
"legiblePass": true,
"sourcesPass": true,
"gifKB": 6539.7,
"webpKB": 3906.6,
"totalFrames": 480
}
120 changes: 120 additions & 0 deletions gallery/git-pr-guardrails/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,120 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Protected Git Workflow (8s @ 60fps) · Loop Studio</title>
<style>
:root {
--bg: #0E1120; --surface: #171B2E; --stage: #0A0C18; --ink: #E7E9F4;
--muted: #9BA1BC; --line: #2A3050; --accent: #FF6B9D; --spark: #7FA2FF;
--mono: "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
}
body {
margin: 0; padding: 2rem 1rem; background: var(--bg); color: var(--ink);
font-family: system-ui, -apple-system, sans-serif;
}
.wrap { max-width: 56rem; margin: 0 auto; display: flex; flex-direction: column; gap: 1.25rem; }
header { display: flex; justify-content: space-between; align-items: baseline; flex-wrap: wrap; gap: 0.5rem; }
h1 { margin: 0; font-size: 1.35rem; font-weight: 700; }
.badge { font-family: var(--mono); font-size: 0.78rem; color: var(--spark); background: var(--surface); border: 1px solid var(--line); padding: 0.25rem 0.6rem; border-radius: 4px; }
.stage-box { border: 1px solid var(--line); border-radius: 8px; background: var(--stage); overflow: hidden; }
.canvas-holder { display: flex; justify-content: center; align-items: center; padding: 1rem; background: var(--stage); }
canvas { display: block; max-width: 100%; height: auto; border-radius: 4px; box-shadow: 0 8px 24px rgba(0,0,0,0.35); }
canvas.mobile-width { max-width: 400px; }
.transport {
display: flex; flex-wrap: wrap; align-items: center; gap: 0.75rem;
padding: 0.75rem 1rem; background: var(--surface); border-top: 1px solid var(--line);
}
button {
font: 500 0.82rem var(--mono); color: var(--ink); background: var(--bg);
border: 1px solid var(--line); border-radius: 4px; padding: 0.4rem 0.75rem; cursor: pointer;
}
button:hover { border-color: var(--accent); }
input[type="range"] { flex: 1 1 12rem; accent-color: var(--accent); }
output { font-family: var(--mono); font-size: 0.8rem; color: var(--muted); font-variant-numeric: tabular-nums; }
</style>
</head>
<body>
<div class="wrap">
<header>
<h1>Protected Git Workflow (8s @ 60fps)</h1>
<span class="badge" id="meta-badge">loading sketch.js...</span>
</header>
<div class="stage-box">
<div class="canvas-holder">
<canvas id="stage-canvas"></canvas>
</div>
<div class="transport">
<button type="button" id="play-btn">Pause</button>
<input type="range" id="scrubber" min="0" max="119" value="0" step="1">
<output id="readout">frame 000 / 120 · phase 0.00</output>
<button type="button" id="phone-btn">400px Phone View</button>
</div>
</div>
</div>
<script type="module">
import * as sketch from "./sketch.js";
import { createKit } from "./loop-kit.js";

const cv = document.getElementById("stage-canvas");
const ctx = cv.getContext("2d");
const playBtn = document.getElementById("play-btn");
const phoneBtn = document.getElementById("phone-btn");
const scrubber = document.getElementById("scrubber");
const readout = document.getElementById("readout");
const badge = document.getElementById("meta-badge");

const meta = sketch.meta || { seconds: 4, fps: 30, width: 640, height: 640 };
const totalFrames = Math.round((meta.seconds || 4) * (meta.fps || 30));
cv.width = meta.width || 640;
cv.height = meta.height || 640;
scrubber.max = String(totalFrames - 1);
badge.textContent = `${meta.mode || "loop"} · ${meta.seconds}s @ ${meta.fps}fps (${totalFrames}f) · ${cv.width}×${cv.height}`;

const kit = createKit({ showcase: sketch.showcase });
let frame = 0;
let playing = true;
let startedAt = null;

function drawFrame() {
const phase = frame / totalFrames;
sketch.render(ctx, phase, kit);
scrubber.value = String(frame);
readout.textContent = `frame ${String(frame).padStart(3, "0")} / ${totalFrames} · phase ${phase.toFixed(3)}`;
}

function tick(now) {
if (playing) {
if (startedAt === null) startedAt = now - (frame / totalFrames) * meta.seconds * 1000;
const u = (((now - startedAt) / 1000 / meta.seconds) % 1 + 1) % 1;
const nextF = Math.floor(u * totalFrames) % totalFrames;
if (nextF !== frame) {
frame = nextF;
drawFrame();
}
}
requestAnimationFrame(tick);
}

playBtn.addEventListener("click", () => {
playing = !playing;
startedAt = null;
playBtn.textContent = playing ? "Pause" : "Play";
});
phoneBtn.addEventListener("click", () => {
cv.classList.toggle("mobile-width");
});
scrubber.addEventListener("input", () => {
playing = false;
startedAt = null;
playBtn.textContent = "Play";
frame = parseInt(scrubber.value, 10) || 0;
drawFrame();
});

drawFrame();
requestAnimationFrame(tick);
</script>
</body>
</html>
71 changes: 71 additions & 0 deletions gallery/git-pr-guardrails/legible.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
{
"pass": true,
"width": 640,
"height": 270,
"phoneWidth": 400,
"frame0ShowsAllStageLabels": true,
"stageLabelsChecked": 4,
"captions": [
{
"step": 1,
"caption": "branch feat/* forks from dev",
"words": 5,
"chars": 28,
"windowSeconds": 2,
"requiredSeconds": 2,
"passReadingTime": true,
"contrastRatio": 14.23,
"passContrast": true,
"minEdgeMarginPx": 30,
"phoneFontPx": 7.81,
"passMobileWidth": true,
"pass": true
},
{
"step": 2,
"caption": "CI runs 34 eval checks",
"words": 5,
"chars": 22,
"windowSeconds": 2,
"requiredSeconds": 2,
"passReadingTime": true,
"contrastRatio": 14.23,
"passContrast": true,
"minEdgeMarginPx": 30,
"phoneFontPx": 7.81,
"passMobileWidth": true,
"pass": true
},
{
"step": 3,
"caption": "CODEOWNERS approves the PR",
"words": 4,
"chars": 26,
"windowSeconds": 2,
"requiredSeconds": 1.7,
"passReadingTime": true,
"contrastRatio": 14.23,
"passContrast": true,
"minEdgeMarginPx": 30,
"phoneFontPx": 7.81,
"passMobileWidth": true,
"pass": true
},
{
"step": 4,
"caption": "merged into dev & main",
"words": 5,
"chars": 22,
"windowSeconds": 2,
"requiredSeconds": 2,
"passReadingTime": true,
"contrastRatio": 14.23,
"passContrast": true,
"minEdgeMarginPx": 30,
"phoneFontPx": 7.81,
"passMobileWidth": true,
"pass": true
}
],
"reasons": []
}
Binary file added gallery/git-pr-guardrails/loop.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gallery/git-pr-guardrails/poster.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading