@tandryukha/aidemo 0.8.0 → 0.15.0

package/.claude/skills/record-demo/SKILL.md

@@ -26,8 +26,11 @@ fetch it first, then follow it:
    and follow the guide. Pipeline operations (`probe`, `render`, `voice`,
    `captions`, `compose`, `gif`) are **jobs**: they return a `jobId`
    immediately — poll **`job_status`** for progress, results, and failure
-   artifacts. Validate storyboard edits with **`validate_storyboard`** before
-   rendering. Pass **absolute** demo directories.
+   artifacts. Discover selectors with **`inspect`** (unique selectors per
+   visible element — no guessing) before writing targets; validate storyboard
+   edits with **`validate_storyboard`** and **`lint_storyboard`** (pacing
+   forecast: which scenes will freeze or be cut) before rendering; read
+   `output/report.json` after. Pass **absolute** demo directories.
 2. **Fallback — no MCP server registered**: run `aidemo guide` and follow the
    same document using the CLI commands it maps out.
 3. **After verifying the final video** (per the guide's "Verify before

package/README.md

@@ -15,12 +15,16 @@ demo.
 [![Website](https://img.shields.io/badge/website-aidemo.top-1a7f37)](https://aidemo.top)
 [![ci](https://github.com/tandryukha/aidemo/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/tandryukha/aidemo/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Release](https://img.shields.io/github/v/release/tandryukha/aidemo)](https://github.com/tandryukha/aidemo/releases)
+[![npm](https://img.shields.io/npm/v/%40tandryukha%2Faidemo?logo=npm&label=npm&color=cb3837)](https://www.npmjs.com/package/@tandryukha/aidemo)
+[![Homebrew](https://img.shields.io/badge/Homebrew-tandryukha%2Faidemo-fbb040?logo=homebrew&logoColor=white)](https://github.com/tandryukha/homebrew-aidemo)
 [![GitHub Marketplace](https://img.shields.io/badge/Marketplace-aidemo%20Demo%20Video-2ea44f?logo=githubactions&logoColor=white)](https://github.com/marketplace/actions/aidemo-demo-video)
+[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-aidemo-1f6feb)](https://registry.modelcontextprotocol.io)
 [![Works with Claude Code](https://img.shields.io/badge/works%20with-Claude%20Code-d97757)](#three-ways-to-use-it)
 [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/tandryukha/aidemo/badge)](https://scorecard.dev/viewer/?uri=github.com/tandryukha/aidemo)
+[![Glama](https://glama.ai/mcp/servers/tandryukha/aidemo/badges/score.svg)](https://glama.ai/mcp/servers/tandryukha/aidemo)
 
-**Install:** `/plugin marketplace add tandryukha/aidemo` (Claude Code) · `uses: tandryukha/aidemo@stable` (CI) · `npx -y github:tandryukha/aidemo#stable` (CLI / any agent)
+**Install:** Claude Code `/plugin marketplace add tandryukha/aidemo` · any agent `npx skills add tandryukha/aidemo` (skill only; add the MCP server with `repo-init`) · CI `uses: tandryukha/aidemo@stable` · CLI `npx -y @tandryukha/aidemo` · Homebrew `brew install tandryukha/aidemo/aidemo`
+<br>Published on the [GitHub Marketplace](https://github.com/marketplace/actions/aidemo-demo-video), [npm](https://www.npmjs.com/package/@tandryukha/aidemo), a [Homebrew tap](https://github.com/tandryukha/homebrew-aidemo), and the [MCP Registry](https://registry.modelcontextprotocol.io).
 
 [![aidemo demoing itself on Wikipedia — recorded with aidemo](docs/demo.gif)](https://github.com/tandryukha/aidemo/releases/download/v0.3.0/wikipedia-showcase-demo.mp4)
 
@@ -171,19 +175,27 @@ re-recording, recompose without re-transcribing, etc.
 
 ```bash
 aidemo init <name>            # scaffold demos/<name>/ with a starter storyboard
+aidemo init <name> --from-url <url>   # …drafted from the live page's headings + real selectors
+aidemo import-trace trace.zip --name <name>   # …or from a Playwright trace / *.spec.ts (actions + selectors → scenes)
 aidemo voice   <dir>          # per-scene TTS → narration.mp3 + voice.json
 aidemo record  <dir>          # drive Chrome → raw video + timeline.json
 aidemo probe   <dir>          # record-only dry run (verify selectors), no key needed
+aidemo validate <dir>         # schema-check the storyboard, no browser (non-zero exit on issues)
+aidemo lint    <dir>          # predict freezes/cuts + selector pitfalls before spending a take
 aidemo captions <dir>         # Whisper → captions.{srt,vtt,cues.json} (--offline for no network)
 aidemo compose <dir>          # trim + sync + zoom + cards + caption + mux → final-demo.mp4
 aidemo gif     <dir>          # final-demo.mp4 → README-ready GIF (autoplays on GitHub)
+aidemo frames  <dir>          # evenly spaced PNGs from the video for review (--source raw)
 aidemo render  <dir>          # voice → record → captions → compose
 aidemo guide                  # print the canonical authoring guide
 aidemo doctor                 # check Node, ffmpeg, Chrome, voice endpoint
 ```
 
 Add `--headless` for CI/fixtures; omit it for real sites that need your
-logged-in session. `--profile <dir>` picks the Chrome user-data dir;
+logged-in session. `--profile <dir>` picks the Chrome user-data dir; `--fresh`
+records on a wiped one; `--storage-state <file>` / `--cookie "name=value;domain=host"`
+seed a cookie-gated site before the first action (or declare `setup` in the
+storyboard, which can also run a `preflight` script before every take);
 `--capture native|obs` switches to high-fidelity screen capture. `voice`/`render`
 **skip TTS for unchanged scenes**, and `record` **salvages a failed take** (keeps
 the footage + drops a screenshot/frame-dump in `logs/`).
@@ -264,7 +276,7 @@ demos/<name>/          ← your working area (untracked; scaffold with `aidemo i
   fully local. The MCP server is **stdio-only** — no listener.
 - **Small, auditable surface:** ~20 source files, 7 runtime deps, MIT. Pin an
   immutable ref if you're wary of the moving `#stable` tag:
-  `npx -y github:tandryukha/aidemo#v0.8.0`.
+  `npx -y github:tandryukha/aidemo#v0.14.0` (any released tag).
 - Full detail: [docs/LOCAL_MODELS.md](docs/LOCAL_MODELS.md#what-leaves-the-machine)
   · report vulnerabilities privately per [SECURITY.md](SECURITY.md).