v0.2.3

Xem docs/CHANGELOG.md mục 0.2.3: tài liệu init đúng hành vi 0.2.2, tắt telemetry trước doctor (+ dòng NOT_CHECKED telemetry), lời khuyên cài giọng rõ hơn, gitignore, Actions Node 24. Hành vi render/init không đổi.

v0.2.2

Bản vá sau lượt kiểm trên Mac mini (báo cáo MAC-REVIEW-FOR-WINDOWS). Máy Windows đã đặt
VIDEO_STATION không đổi hành vi.

• init không còn tự nhận ~/.video có sẵn (sự cố lượt Mac 29/09). ~/.video chỉ tình cờ
  mang dấu trạm thì init hỏi người dùng; với --yes hay khi không có người trả lời, nó in đường
  trạm cũ rồi thoát mã 2 và không ghi gì. Nhận trạm đó phải bằng --mode separate,
  --station <thư mục> hoặc --migrate. --yes giữ đúng nghĩa: embedded, <repo>/workspace/.
  Trạm đã chọn (biến VIDEO_STATION/VIDEO_ROOT, hoặc studio.local.json ghi separate) vẫn
  dùng luôn không hỏi; studio.local.json ghi separate nay thắng một ~/.video tình cờ có mặt.
• Khối engine của JSON kết quả (P2-17): engine.voice_studio nay là bản hợp đồng của
  repo giọng (API_VERSION) ở cả render lẫn narrate, đúng nghĩa repo giọng tự trả; bản phát
  hành của gói giọng đi khoá mới engine.voice_studio_version. Trước đây render trả bản phát hành
  dưới cùng khoá. Bảng nghĩa từng khoá ở docs/CONTRACT.md §2.
• scripts/install-video-use.{ps1,sh} không còn đoán trạm là $HOME/.video: trạm do package
  phân giải (biến → studio.local.json → <repo>/workspace/), và lệnh gợi ý cuối cùng khớp chế độ
  cài. Cổng tests/test_ps1_portable.py thêm luật chặn mọi script đoán trạm ở home.
• doctor: chưa cài repo giọng mà bản clone của nó nằm cạnh repo này (cùng thư mục cha, tên gì
  cũng được, nhận bằng nội dung) thì dòng voice-studio in sẵn lệnh pip install -e "<đường>[engine]".
• Tài liệu: clone vào <thư mục cha> người dùng chọn thay cho đường cứng; repo giọng là anh em
  cùng thư mục cha (INSTALL.md mục 4, 5b); bước tắt telemetry của HyperFrames
  npx --yes hyperframes@<bản ghim> telemetry disable (mục 7b, P2-18); mọi chỗ nói browser ensure
  ghi rõ dạng npx --yes hyperframes@<bản ghim> browser ensure — đó là lệnh của HyperFrames, CLI
  repo này không có lệnh con browser (P2-2); package.json của project không quyết bản render,
  station.json mới quyết (P3-2); bảng nền tảng ghi macOS arm64 đã render thật bài mẫu (dòng macOS
  của samples/news-mini/EXPECTED.md, PR #3).

PR: #3 (dòng macOS EXPECTED.md), #4.

v0.2.1

Bản vá tài liệu để một agent trên Mac Apple Silicon mới tinh tự cài được theo INSTALL.md, không
biến môi trường nào (chế độ embedded).

• macOS trong INSTALL.md, START-HERE.md, docs/INSTALL.md: tạo venv bằng python3.12
  (python3 của Mac mới là 3.9, dưới mức tối thiểu); điều kiện trước cho Mac mới — Xcode Command
  Line Tools, Homebrew do người dùng tự cài (agent không chạy lệnh tải-rồi-chạy), /opt/homebrew/bin
  trên PATH, brew install python@3.12 node ffmpeg git; kiểm biến và PATH bằng
  zsh -lic 'echo $…' vì shell của agent không nạp ~/.zshrc. Lần render đầu cần mạng (HyperFrames,
  Chromium, CDN), và bản HyperFrames đang ghim (0.8.54) chưa render gì trên arm64.
• Một đường cài lồng tiếng duy nhất (mục 5b mới của INSTALL.md): clone agent-voice-studio
  cạnh repo này, pip install -e "../agent-voice-studio[engine]" vào chính .venv của repo video,
  voice-studio init --yes, rồi tạo giọng mặc định bằng make-profile --instruct … --set-default.
  Bỏ câu "cài vào venv của trạm giọng" ở docs/INSTALL.md và trang web, vốn mâu thuẫn với
  INSTALL.md. Thiếu bước giọng mặc định thì bài mẫu dừng vì chưa có profile — trước đây tài liệu
  không nói.
• Bài mẫu news-mini: dòng Windows trong EXPECTED.md có số đo thật (HyperFrames 0.8.54,
  113 s, 51,05 s / 24,93 s), đo bằng một bản cài mới theo đúng mục 5b.
• INSTALL.md mục 6: máy đã có trạm ~/.video thì init --yes tự nhận trạm đó — agent phải
  đọc dòng station của doctor và hỏi trước khi render thử vào trạm đang chạy lịch.

v0.2.0

Chuẩn hóa để chạy như nhau trên Windows và macOS, cài được bằng một lời nhờ agent.

• Trạm mặc định nằm trong repo. Không đặt biến nào thì trạm là <repo>/workspace/ (Git bỏ
  qua cả thư mục), kể cả trước khi video-studio init tạo nó. Bỏ tầng đoán ~/.video: máy dùng
  trạm ngoài chọn tường minh bằng VIDEO_STATION hoặc init --station DIR. Bản cài wheel không
  có repo thì mọi lệnh cần trạm dừng mã 3 và chỉ cách chọn trạm.
• Trạm giọng không bị đoán. VOICE_STATION → OMNIVOICE_DIR → trạm mà repo giọng cài cùng
  venv đã được chọn; không có gì thì là "chưa có trạm giọng".
• Bài mẫu samples/news-mini/ — bản tin hai cảnh, giọng ghim hạt giống, kèm EXPECTED.md
  (lệnh chạy, tên file ra, bảng số đo theo máy) và test không cần mạng.
• CI chạy trên mọi nhánh, ma trận Windows + macOS × Python 3.10 / 3.12 / 3.13, action ghim
  theo SHA commit.
• Skill không còn được chép vào trạm. init thôi chép 24 skill vào <trạm>/.claude/skills +
  .agents/skills và thôi ghi skills-lock.json. Gốc repo có adapter .claude/skills/ và
  .agents/skills/ (sinh bằng scripts/build_host_adapters.py, --check báo lệch) trỏ về skill
  gốc trong skills/ — một nguồn, git pull là có bản mới. Trạm cũ: init --station DIR --migrate
  gỡ bản đã chép cùng file khoá (dời vào nhật ký, --undo trả về), skill riêng của người dùng giữ.
• video-studio uninstall — chỉ gỡ thứ bộ cài đã đặt (skill bản cũ đã chép nếu chưa sửa, liên kết
  repo → trạm, .env chưa điền, hook pre-commit của chính nó), dời vào nhật ký của trạm thay vì
  xoá; trạm và mọi project giữ nguyên. --dry-run in kế hoạch.
• doctor có mức NOT_CHECKED cho thứ chưa kiểm được (chạy --offline, thiếu npx) và cho
  render — doctor không tự render, nên không để một bảng toàn PASS nói thay. Nhãn người đọc
  đổi thành PASS / WARN / FAIL / NOT_CHECKED / SKIP; JSON thêm danh sách not_checked.
• Cài bằng một lời nhờ agent: INSTALL.md ở gốc repo là hướng dẫn dành cho agent (Windows và
  macOS, hỏi trước khi cài phần mềm, không tải-rồi-chạy, báo nguyên văn từng dòng doctor) kèm
  prompt copy-dán tiếng Việt và tiếng Anh; README và START-HERE chép đúng prompt đó.
• AGENTS.md (hướng dẫn chung cho mọi agent) với CLAUDE.md / GEMINI.md là con trỏ, và
  hosts/ cho Claude Code, Codex, Antigravity, Claude Desktop — nói rõ đường nạp skill nào đã
  chạy, đường nào chưa kiểm.
• Trang web /install/: chọn ứng dụng AI, dán prompt (chép nguyên văn từ INSTALL.md), đọc nhãn kiểm tra.
• START-HERE.md và nhật ký thay đổi này.

🤖 Generated with Claude Code

v0.1.0 — a video engine, a news template, and 21 distilled skills

First release. video_studio renders video from a spec: an editing layer
distilled from video-use (transcribe, EDL, grade, pack, render), a news
template with five layouts, and 21 HyperFrames skills whose hashes are checked
against the upstream manifest in CI.

Paths are a contract, not a guess: a drive letter anywhere in a member name is
refused on every OS, and exit codes say which kind of wrong it was — 2 for a
bad spec, 3 for a missing engine — so a scheduler knows whether retrying helps.

Bring your own ffmpeg and your own voice. Tested on Windows and macOS in CI.