vibemovie 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pooria Arab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# VibeMovie
+
+**Your vibe coding session, as a movie.**
+
+Transforms your AI-assisted coding activity into a cinematic, narrated video — complete with chapters, a storyline, dramatic music, and visual effects. Not a screen recording. A movie.
+
+## Install
+
+```bash
+npm i -g vibemovie
+# or run it directly
+npx vibemovie --help
+```
+
+## Quick start
+
+```bash
+# render a session recap from a JSON events file (or stdin)
+vibemovie render session.json
+# → writes ./vibe-recap.html — open it in any browser
+
+vibemovie render session.json --ratio 9:16 --template speedrun --out recap.html
+cat session.json | vibemovie render
+
+# expose the render tool to your agent
+vibemovie mcp
+```
+
+The default engine is **Hyperframes**: the recap is a self-contained animated
+HTML page rendered fully **offline** — **zero API keys**, no network, nothing
+leaves your machine. (Gen-video providers like Sora/Wavespeed slot into the
+cascade above it later; v0 ships the guaranteed floor.)
+
+Input is a JSON array of events (or `{ "events": [...] }`):
+
+```json
+[
+  { "kind": "task-done", "ts": 1769500000000, "agent": "claude-code", "cwd": "/repo/demo",
+    "payload": { "label": "Refactor auth middleware", "durationMin": 18 } },
+  { "kind": "tests-pass", "ts": 1769503600000, "payload": { "passed": 42 } },
+  { "kind": "pr-merged", "ts": 1769505100000, "payload": { "pr": 42, "branch": "main" } }
+]
+```
+
+Library usage:
+
+```ts
+import { renderMovie } from 'vibemovie';
+
+const { html, path } = await renderMovie(events, {
+  ratio: '16:9',            // '16:9' | '9:16' | '1:1'
+  template: 'documentary',  // 'documentary' | 'speedrun' | 'meme'
+  out: 'recap.html',        // optional — omit to just get the HTML string
+});
+```
+
+`buildScenes(events)` (events → scene list) and `renderHyperframes(scenes)` (scene list → HTML) are pure and exported for custom pipelines.
+
+## Why Build This
+
+- VibeReplay captures sessions — VibeMovie turns them into stories
+- "I built a SaaS in 4 hours" is interesting — a cinematic version of it is unforgettable
+- Content creators spend hours editing coding videos — this automates the entire pipeline
+- Every VibeMovie shared is a viral ad for the tool
+- Think: AI-generated documentary of your coding process
+
+## Features
+
+- **Story arc** — AI analyzes your session and creates a narrative: setup, struggle, breakthrough, deploy
+- **Cinematic editing** — Automatic cuts, zooms, transitions, and focus on the interesting parts
+- **AI narration** — Generated voiceover that explains the journey: "At minute 23, everything broke..."
+- **Dynamic soundtrack** — Music that matches the emotional arc (powered by VibeRadio engine)
+- **Code highlights** — Key code snippets rendered beautifully with syntax highlighting and annotations
+- **Stats overlay** — Lines of code, files changed, tokens used, time elapsed
+- **Chapters** — Auto-generated based on git commits and milestones
+- **Multiple formats** — YouTube (16:9), X/TikTok (9:16), LinkedIn (1:1), GIF summary
+- **Thumbnail generation** — AI-generated thumbnail optimized for clicks
+- **Templates** — Documentary, tutorial, speedrun, meme
+
+## Generation engine (cascade)
+
+Video generation follows the shared `@vibe/core` cascade so it always works:
+
+1. **Your existing model** — if your agent's provider does video (e.g. Sora via your
+   OpenAI), use it.
+2. **A video-gen key you bring** — Wavespeed, Replicate, or similar.
+3. **Hyperframes fallback** — pure HTML/CSS/JS animated "video" (a rendered,
+   animated web page). No generative-video model, no key, no network — always
+   available. (The prototype below _is_ a working Hyperframes recap.)
+
+Options across all tiers: **sync/live** (scenes build as the agent works) or
+**async** (rendered after a turn/session) — user-configurable per hook · **aspect
+ratios** 16:9 / 9:16 / 1:1 / GIF · **sound on/off** (soundtrack via the VibeRadio
+engine + optional narration) · **subtitles/captions** · **transitions & templates**
+(documentary, tutorial, speedrun, meme) · **avatar narrator** — if you've set up a
+personal likeness/voice (e.g. HeyGen, or an on-device avatar), the recap can be
+narrated by your avatar instead of an abstract summary.
+
+## Distribution
+
+- **CLI** — `vibemovie render session.json` (today) · `--session <id>` / `--repo .` (planned)
+- **npm package** — `npm install -g vibemovie`
+- **MCP server** — `vibemovie mcp` exposes a `render` tool your agent can call
+- **Claude Code skill** — `/vibemovie` to render your last session
+- **skills.sh** — Listed on skills.sh marketplace
+- **Web app** — Upload a git repo, get a movie of its entire history
+
+## Tech Stack
+
+- Node.js + TypeScript
+- Remotion (video rendering)
+- Claude API (narrative generation, story arc)
+- ElevenLabs (voiceover)
+- Tone.js (soundtrack — shared with VibeRadio)
+- FFmpeg (post-processing)
+
+## Prototype
+
+Interactive, self-contained UX prototype (no build, no network): open
+[`docs/prototype.html`](docs/prototype.html) in a browser — it plays a real
+Hyperframes recap with a working scrubber, the cascade selector, and an avatar
+narrator toggle.
+
+## Local-first
+
+Runs on your own machine. The Hyperframes tier renders fully offline; nothing leaves
+your machine unless you opt into a hosted video model. Enforced by the `@vibe/core`
+consent model.
+
+## Vibe Suite
+
+Part of the **Vibe Suite** — companion tools for agentic coding CLIs (Claude Code,
+Codex, Cursor, Gemini, Grok, pi, Kimi, and other harnesses). Ships as **CLI + npm
+package + MCP server**.
+
+## Relationship to VibeReplay
+
+- **VibeReplay** = raw capture + timelapse (quick, functional)
+- **VibeMovie** = cinematic, narrated, story-driven (polished, shareable)
+- VibeMovie can use VibeReplay recordings as input
+
+## Revenue Potential
+
+- Free tier: 1 movie/month, watermarked, 720p
+- Pro: unlimited, 4K, custom branding, all templates
+- Studio: team movies, custom narration voice, API access

package/dist/chunk-HI6AAJID.js

@@ -0,0 +1,6 @@
+// src/version.ts
+var VERSION = "0.1.0";
+
+export {
+  VERSION
+};