@lalalic/markcut 2.2.3 → 2.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lalalic/markcut",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "description": "Markdown-to-video engine. Describe scenes in markdown, get a rendered video.",
   "bin": {
     "markcut": "bin/markcut"

package/skills/markcut/SKILL.md

@@ -66,4 +66,11 @@ some common issues (photo or video can't be displayed, audio missing), take belo
   - `rehype-katex` — render math formulas with KaTeX
 
 - `@remotion/shapes` — render shapes like arrows, circles, rectangles, etc
-- `@remotion/starburst` — render starburst animations
+- `@remotion/starburst` — render starburst animations
+
+## Golden rule
+- always check stream start and duration to avoid
+  - audio cut off
+  - video cut off
+  - subtitle mismatch
+  - sync issues between audio, video, and subtitles

package/skills/markcut/docs/markdown-descriptive.md

@@ -35,7 +35,11 @@ The line after `# video` contains all video configuration as space-separated
 
 ```markdown
 # video
-width:1920 height:1080 fps:30 layout:series tts:"edge-tts --voice 'en-US-GuyNeural' --text '{input}' --write-media '{output}'" stylesheet:".bg { background: #000; }" subtitle:captions.vtt
+width:1920 height:1080 fps:30 layout:series 
+~~~css stylesheet
+.bg { background: #000; }
+~~~
+subtitle:captions.vtt
 ```
 
 Supported keys: `width`, `height`, `fps`, `layout`, `tts`, `stt`, `tti`, `ttv`,
@@ -145,8 +149,10 @@ For compatibility, `import { Name } from "spec"` also works and produces the sam
 | `height` | canvas height | root |
 | `fps` | frame rate | root |
 | `theme` | *removed — use `style` on root* | root |
-| `tts` | CLI template string (e.g. `edge-tts --voice "en-US-GuyNeural" --text "{input}" --write-media "{output}"`) | root |
-| `stt` | CLI template string (e.g. `whisper "{input}" --output_format vtt --output_dir "{output}"`) | root |
+| `tts` | text-to-speech CLI template string  | root |
+| `stt` | speech-to-text CLI template string  | root |
+| `tti` | text-to-image CLI template string  | root |
+| `ttv` | text-to-video CLI template string  | root |
 | `layout` | `series\|parallel\|transitionSeries` | root, scene | 
 | `transition` | `fade\|slide\|wipe\|flip\|clockWipe` | transitionSeries |
 | `transitionTime` | seconds | transitionSeries |
@@ -176,7 +182,6 @@ For compatibility, `import { Name } from "spec"` also works and produces the sam
 | `script` | narration/dialogue text; TTS source; NOT rendered directly | audio | Only on audio nodes — see Narration section below |
 | `speaker` | speaker name for multi-turn dialogue; set automatically by dialogue expansion | audio | Used for per-speaker voice lookup and subtitle prefix |
 | `voices` | JSON object mapping speaker names to extra TTS CLI flags e.g. `{"Ray":"--voice en-US-GuyNeural"}` | root | Flags are appended to the resolved TTS CLI template |
-| `tts` | CLI template string e.g. `"edge-tts --voice en-US-GuyNeural --text {input} --write-media {output}"` | root | Set once at the root level; all TTS uses this template |
 | `metadata` | arbitrary metadata string | root |
 | `stylesheet` | global CSS string; selectors use `.className` on elements | root |
 | `style` | inline CSS applied to the node's container div e.g. `"border-radius:12px"` | any |

package/skills/markcut/docs/template.md

@@ -59,7 +59,6 @@ What tools/skills the agent needs before starting. Always include:
 
 - The engine itself: `npx @lalalic/markcut` runnable
 - Required markcut skill (`SKILL.md` + `docs/markdown-descriptive.md`) — the agent must read these
-- Required CLIs: `edge-tts`, `ffmpeg`/`ffprobe`, whisper, image-understanding (for reviewer)
 - Any domain-specific tools
 
 ### §1 Inputs — the contract with the user

package/skills/markcut/docs/templates/vlog/TEMPLATE.md

@@ -9,26 +9,6 @@ engine: "@lalalic/markcut — run via `npx @lalalic/markcut`"
 
 Follow this file top to bottom. Read the markcut skill (`SKILL.md` → `docs/markdown-descriptive.md`) first if you have not.
 
-```mermaid
-flowchart LR
-    Profile[👤 user.md<br/>profile] --> Writer
-    History[📜 vlog_history.json<br/>past entries] --> Writer
-    Media[📁 Media folder] --> Vision[🧠 markcut vision --label]
-    Vision --> Labels[📝 metadata.json]
-    Labels --> Group[🔍 group-clips.md<br/>filter + group]
-    Group --> Groups[📋 grouped scenes]
-    Locale[🌍 local-context.md<br/>weather, events, news] --> Groups
-    Groups --> Writer[✍️ story-writer agent<br/>narration + title]
-    Writer --> Storyboard[📄 course.md]
-    BGM[🎵 bgm-select.md<br/>mandatory BGM] --> Assemble[📦 assemble + render]
-    Storyboard --> Assemble
-    Assemble --> MP4[📺 final.mp4]
-    MP4 --> Reviewer[🔍 reviewer agent]
-    Reviewer -->|FAIL| Fix[🔧 fix]
-    Fix --> Assemble
-    Reviewer -->|PASS| HistoryUpdate[📝 append to<br/>vlog_history.json]
-```
-
 | Path | Runs in | Purpose |
 |---|---|---|
 | `TEMPLATE.md` | your context | everything |
@@ -38,10 +18,7 @@ flowchart LR
 ## 0. Prerequisites
 
 - `npx @lalalic/markcut` runnable
-- TTS CLI (default: `edge-tts`)
-- `ffmpeg`/`ffprobe` on PATH
-- For vision pipeline: ITT/VTT/STT CLIs configured (see `docs/markdown-descriptive.md` for env vars)
-- For reviewer: image-understanding capability, STT CLI
+- `ffmpeg`/`ffprobe`/`exiftool` on PATH
 
 ## 1. Inputs — collect before starting
 
@@ -50,13 +27,13 @@ flowchart LR
 | Media folder | **yes** | — | absolute path to folder of photos/videos |
 | Theme / event name | **yes** | — | e.g. "birthday camping", "Tokyo trip", "product unboxing" |
 | Date range | no | from media EXIF | — |
-| Language | no | en | narrator's language |
+| Language | no | zh | narrator's language |
 | Style | no | `daily` | `daily` (casual), `lyrical` (cinematic), `humorous` (funny) |
 | Target duration | no | 60s | 15–120s for short vlogs |
-| Profile | **parse from** | `~/.pi/agent/user.md` | user's personality, region, family members, voice ref, life context. Read this file at the start — it's the authoritative source for who the creator is. The creator's name, region, family, and regular activities feed into narration naturally ("my daughter", "drove up from Ottawa", "my third camping trip this year"). |
+| Profile | **parse from** | context | user's personality, region, family members, voice ref, life context. Read this file at the start — it's the authoritative source for who the creator is. The creator's name, region, family, and regular activities feed into narration naturally ("my daughter", "drove up from Ottawa", "my third camping trip this year"). |
 | Voice | no | en: `en-US-GuyNeural` | edge-tts voice. If profile has a voice reference URL, use TTS voice cloning instead |
 | BGM style | no | `ambient` | mood/genre for background music. BGM is **mandatory** — see §2 for root-level audio node |
-| Vlog history | **read from** | `vlog_history.json` | JSON array of past vlogs in the project. Used for story continuity ("last time I was here...", "my third camping trip this year"). If the file doesn't exist, start fresh. See §3 for history rules. |
+| Vlog history | **read from** | `vlog_history.json` or folder | JSON array of past vlogs in the project. Used for story continuity ("last time I was here...", "my third camping trip this year"). If the file doesn't exist, start fresh. See §3 for history rules. |
 
 **Rule:** The golden rule of vlogs — **every word in narration, title, or captions must be traceable to real data**: (1) user-stated facts, (2) clip VLM descriptions, (3) GPS/timestamp metadata, (4) user labels from interactive labeling, (5) local news/searched events for the date/location. Never invent people, dialogue, events, or place names. When unsure, paraphrase conservatively ("a path", "someone") rather than guessing.