diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index a94dd59..d846422 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -2,19 +2,19 @@
"name": "loop-studio-marketplace",
"owner": {
"name": "Marcusk00",
- "url": "https://github.com/Marcusk00"
+ "url": "https://github.com/MarcusK00"
},
"plugins": [
{
"name": "loop-studio",
"source": "./",
- "description": "Deterministic phase-driven seamless animation studio & verification CLI for coding agents.",
- "version": "1.0.0",
+ "description": "Deterministic HTML/WebGL2 browser capture, dual-theme dark/light README bundles, and universal loop/source-drift auditing.",
+ "version": "2.0.0",
"author": {
"name": "Marcusk00"
},
- "homepage": "https://github.com/Marcusk00/loop-studio",
- "tags": ["animation", "loop", "gif", "showcase", "video", "canvas"]
+ "homepage": "https://github.com/MarcusK00/loop-studio",
+ "tags": ["readme-demo", "loop", "gif", "webp", "audit", "wcag"]
}
]
}
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 2fb688a..c51f425 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,21 +1,21 @@
{
"name": "loop-studio",
- "version": "1.0.0",
- "description": "Produce verified, seamless animations and repo showcase loops (GIF, MP4, WebM, PNG) driven by deterministic phase math, seam analysis, legibility checks, and cold-read evaluation.",
+ "version": "2.0.0",
+ "description": "Deterministic HTML/WebGL2 browser capture, dual-theme dark/light README bundles, and universal loop/source-drift auditing.",
"author": {
"name": "Marcusk00",
"url": "https://github.com/Marcusk00"
},
- "homepage": "https://github.com/Marcusk00/loop-studio",
- "repository": "https://github.com/Marcusk00/loop-studio",
+ "homepage": "https://github.com/MarcusK00/loop-studio",
+ "repository": "https://github.com/MarcusK00/loop-studio",
"license": "MIT",
"keywords": [
+ "readme-demo",
"animation",
"seamless-loop",
- "showcase",
+ "webp",
"gif",
- "mp4",
- "generative-art",
- "readme"
+ "wcag",
+ "audit"
]
}
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 6d16778..23edaf9 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -14,9 +14,9 @@ jobs:
- uses: actions/setup-node@v4
with:
node-version: "20"
+ - name: Install FFmpeg for external video audit tests
+ run: sudo apt-get update && sudo apt-get install -y --no-install-recommends ffmpeg
- name: Check Loop CLI Doctor
run: node ./tool/bin/loop.js doctor
- - name: Rebuild & Audit Gallery Loops
- run: npm run build:gallery
- - name: Run Positive & Negative Eval Suite
+ - name: Run Core, Chromium & External Video Eval Suite
run: npm test
diff --git a/.gitignore b/.gitignore
index e19578c..664e327 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,3 +2,12 @@ node_modules/
.DS_Store
*.log
tmp/
+examples/**/*.gif
+examples/**/*.webp
+examples/**/*.mp4
+examples/**/*.webm
+examples/**/*.png
+examples/**/audit.json
+examples/**/seam.json
+examples/**/legible.json
+examples/**/sources.json
diff --git a/AGENTS.md b/AGENTS.md
index 33af165..8f12157 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,35 +4,21 @@
## Quick Command Reference
-Use the `loop` CLI (`npx loop` or `node tool/bin/loop.js`) for every stage of the workflow:
+| Command | Purpose |
+| :--- | :--- |
+| `loop new
[--template html\|code-diff\|shader]` | Scaffold a clean `scene.html` / `shader.frag` starter with `showcase.json` / `brief.json` |
+| `loop sheet ` | Render a numbered contact sheet (`sheet.png`) |
+| `loop story ` | Render Frame `0` + step midpoints into `storyboard.png` for cold reading |
+| `loop seam ` | Measure wrap-seam RMS delta, duplicate frames, and flicker (works on projects or external videos via `ffmpeg`) |
+| `loop legible [--themes dark,light]` | Verify stage labels, reading time, DOM overflow, `400px` width, and WCAG `4.5:1` contrast |
+| `loop source-check [--repo .]` | Verify repo-relative `file:line` citations and `"match"` doc-drift tokens |
+| `loop audit [--repo .] [--themes dark,light]` | Unified verification gate (`0` pass, `1` fail, `2` missing runtime / invalid input) |
+| `loop render [--themes dark,light] [--formats webp,gif,mp4]` | Export verified WebP, GIF, MP4, PNG, and GitHub `` embeds |
+| `loop serve ` | Launch interactive phase scrubber, dark/light switcher, and `400px` preview |
+| `loop doctor` | Inspect available browser engines and encoders/decoders |
-| Command | Purpose | Output |
-| :--- | :--- | :--- |
-| `loop new [--mode showcase\|ambient] [--style ] [--scene ] [--fps ]` | Scaffold a loop project with `brief.json` / `showcase.json`, `sketch.js`, and preview HTML | `/sketch.js`, `/index.html` |
-| `loop sheet [--cols 4] [--every 8]` | Render every Nth frame into a numbered contact sheet for visual critique | `/sheet.png` |
-| `loop story ` | Render Frame `0` plus the midpoint frame of each step in `showcase.json` | `/storyboard.png` |
-| `loop seam ` | Measure frame-to-frame pixel deltas, last-to-first seam ratio, duplicate frames, and flicker | `/seam.json` |
-| `loop legible ` | Audit caption reading time, WCAG contrast (`>= 4.5:1`), safe margins, and phone-width readability | `/legible.json` |
-| `loop source-check [--repo ]` | Verify every `file:line` citation in `showcase.json` exists in the target repository | `/sources.json` |
-| `loop audit ` | Run `seam`, `legible`, and `source-check` together as a unified quality gate | `/audit.json` |
-| `loop render [--fps ] [--formats gif,mp4,webp,webm,png\|all]` | Render full-resolution `loop.gif` / `showcase.gif`, `poster.png`, `loop.mp4` (FFmpeg or macOS AVFoundation), Animated WebP, and WebM at up to `60–120 fps` | `/loop.gif`, `/loop.mp4`, `/poster.png` |
-| `loop serve [--port 4173]` | Launch interactive browser workbench with phase scrubber, seam oscilloscope, and mobile preview | `http://localhost:4173` |
-| `loop doctor` | Check runtime capabilities (Pure-JS engine, Headless Chrome/Chromium, FFmpeg) | JSON / terminal diagnostic |
+## Skills & Agent
-## Skill Routing
-
-1. Start every session by reading [`skills/loop-studio/SKILL.md`](skills/loop-studio/SKILL.md).
-2. For **Showcase loops** ("animate what this repo does"), load:
- - [`skills/loop-showcase/SKILL.md`](skills/loop-showcase/SKILL.md)
- - [`skills/loop-timeline/SKILL.md`](skills/loop-timeline/SKILL.md)
- - [`skills/loop-type/SKILL.md`](skills/loop-type/SKILL.md)
- - One scene pack from `skills/scenes//SKILL.md` (`flow`, `transform`, `terminal`, `code`, `interface`, `structure`, `architecture`, or `benchmark`)
- - [`skills/loop-cold-read/SKILL.md`](skills/loop-cold-read/SKILL.md)
-3. For **Ambient loops** ("make a looping background / shader / generative animation"), load:
- - [`skills/loop-brief/SKILL.md`](skills/loop-brief/SKILL.md)
- - [`skills/loop-math/SKILL.md`](skills/loop-math/SKILL.md)
- - [`skills/loop-compose/SKILL.md`](skills/loop-compose/SKILL.md)
- - [`skills/loop-palette/SKILL.md`](skills/loop-palette/SKILL.md)
- - One style pack from `skills/styles/
+
+
+
+
+
+ loop audit · refactor diff
+
+
+ Diff
+ Phase Contract
+ Verified
+
+
+
+
+
+
+
sketch.js · refactor/phase-loop
+
seam: 1.00 PASS
+
+
+
+
12-const x = (Date.now() * 0.12) % W;
+
13-const jitter = Math.random() * 8;
+
12+const turn = phase * kit.TAU; // [0, 1)
+
13+const x = cx + Math.cos(turn) * r;
+
14+const n = kit.loopNoise(phase, 0.8, 7);
+
+
+
+
+
+
+
+
+
+
detect clock drift and random jitter
+
+
+
+
+