akari-video 0.1.7 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
   "type": "module",
   "bin": {

package/vendor/docs/contract-2026-08-02-setup-remote-v0.md

@@ -25,7 +25,7 @@ OK / 差し戻しを言う」だけ — その閲覧と素材の受け渡しを
 
 | 論点 | 決定 |
 |---|---|
-| 手段 | **Tailscale**（tailnet 限定）。閲覧 = `tailscale serve` でプレビューサーバーを tailnet 限定 HTTPS 化。素材 = **Taildrop**（共有シートからデバイス直送。クラウド不経由・実用上サイズ無制限・画質劣化なし） |
+| 手段 | **Tailscale**（tailnet 限定）。閲覧 = `tailscale serve` でプレビューサーバーと承認レポートヘルパーを tailnet 限定 HTTPS 化。素材 = **Taildrop**（共有シートからデバイス直送。クラウド不経由・実用上サイズ無制限・画質劣化なし） |
 | 不採用 / 保留 | Cloudflare Tunnel + Access（tailnet 外の人への共有が要件になったときの**別契約**。「公開してからゲートで守る」構造は既定にしない）。Cloudflare Pages（レポートはローカル随時生成のため噛み合わない） |
 | 素材搬送路の優先順位 | **Taildrop（v0 で実装）** → Dropbox カメラアップロード → iCloud 写真 → Google Drive（順次。v0 では選択肢として提示のみ）。Google フォトは対象外（Library API 制限により自動取得不可） |
 | 対応 OS | macOS / Windows 両対応を前提に書く（Tailscale / Taildrop とも両対応。手順の分岐は SKILL.md 側） |
@@ -37,7 +37,17 @@ OK / 差し戻しを言う」だけ — その閲覧と素材の受け渡しを
 2. **導入ガイド — 人間手番の受け渡し**: インストーラーの sudo・GUI ログイン・スマホ側アプリ導入は
    **自動化しない**（macOS の cask は .pkg で sudo 対話必須 — 実測済み）。スキルは
    「ここはあなたの番」を明確に指示 → 完了を doctor で確認 → 次へ進む、を繰り返す構造とする
-3. **serve 設定**: `tailscale serve` でプレビューサーバー（4567）を tailnet 限定 HTTPS URL にする
+3. **serve 設定**: `tailscale serve` で許可リスト（§3）の 2 件を tailnet 限定 HTTPS URL にする。
+   外部から見える口を安定させるため、**外部ポートを固定し内部ポートを写像する**形を既定とする:
+
+   | 外部 | 内部 | 中身 |
+   |---|---|---|
+   | `https://<host>.ts.net/` | 4567 | プレビューサーバー |
+   | `https://<host>.ts.net:8443/` | ヘルパーの動的ポート | 承認レポート + `decisions.json` |
+
+   レポートヘルパーの内部ポートは起動ごとに変わりうるが、外部 URL は固定される（チャットに
+   貼ったリンクが起動のたびに死なない）。パス分岐（`--set-path /report`）はプレフィックス
+   除去の挙動を実測してから選択肢に加える — 未実測の間は既定にしない
 4. **Taildrop 受信設定**: 受信先フォルダを固定し、作業場の `inbox/` へ接続する
    （直接指定できる場合は直接、できない場合は受信箱 → `inbox/` への移送手順を案内）
 5. **疎通確認**: 別デバイスから (a) serve URL が開ける (b) テストファイルを Taildrop 送信して
@@ -47,7 +57,13 @@ OK / 差し戻しを言う」だけ — その閲覧と素材の受け渡しを
 
 - 既定は **tailnet 限定のみ**。公開インターネットへ出す `tailscale funnel` は**既定で使わない・
   提案もしない**。ユーザーが明示的に要求した場合のみ、リスク説明 + 明示承認を経て扱う
-- serve の対象は**プレビューサーバーのみ**。ファイルシステムや他ポートを serve しない
+- serve してよい対象は**次の許可リスト 2 件に限る**（2026-08-12 拡張）:
+  - (a) **プレビューサーバー**（`akari --preview`、既定 4567）
+  - (b) **decision-cards レポートヘルパー**（`packages/decision-cards/report-helper.mjs`。
+    承認レポートの配信と `decisions.json` の read / write / commit を担う。`127.0.0.1` バインド）
+
+  これ以外のポート・アプリ・ファイルシステムは serve しない。許可リストを増やすときは
+  **本契約を改訂してから**行う（スキル側の判断で足さない）
 - secrets を作業場・プロジェクトに書かない（creator-root v1 の原則。Tailscale の認証情報は
   Tailscale 側が管理し、スキルは一切保持しない）
 - スキルが勝手にインストールを完遂しない（§2-2 の人間手番）。ネットワーク設定の変更は
@@ -68,8 +84,9 @@ OK / 差し戻しを言う」だけ — その閲覧と素材の受け渡しを
 
 - **L0**: SKILL.md の体裁・スキル lint が通る
 - **L1**: doctor が 3 状態（未導入 / 未ログイン / 構成済み）を正しく判定する
-- **L2**: 実機スモーク — 別デバイスから serve URL が開ける + Taildrop のテストファイルが
-  `inbox/` に現れる（§2-5 の疎通確認そのもの）
+- **L2**: 実機スモーク — 別デバイスから (a) プレビューの serve URL が開ける
+  (b) 承認レポートを開いて決定を保存 → `decisions.json` が実際に更新される
+  (c) Taildrop のテストファイルが `inbox/` に現れる（§2-5 の疎通確認そのもの）
 
 ## 6. 将来（非スコープの明示）
 
@@ -79,3 +96,33 @@ OK / 差し戻しを言う」だけ — その閲覧と素材の受け渡しを
 - tailnet 外への共有（クライアント・協力者にブラウザだけで見せる）: Cloudflare Tunnel +
   Access（One-time PIN）系の別契約
 - `inbox/` からの自動素材選択規約（直近 N 件）と create-project / analyze-footage への自動接続
+
+## 7. L2 実測記録（2026-08-12・オーナー実機 iPhone + macOS）
+
+**通った項目**:
+
+| 検証 | 結果 |
+|---|---|
+| 別デバイスからのプレビュー閲覧 | ✓ tailnet 経由で表示。体感速度は「十分すぎる」（WireGuard 直結のため） |
+| **レポート内に埋めた動画の再生** | ✓ iOS 実機で再生・**シーク成功**（H.264 640x360 / 6 秒） |
+| Taildrop 着弾 | ✓ 受信先の実パス = **`~/Downloads/`**（macOS GUI 版・実測で確定） |
+| Taildrop の無劣化性 | ✓ 92MB / HEVC / 1180x2556 / 60fps / **15.7Mbps のまま**再エンコードなし |
+| Taildrop → 作業場 `inbox/` | ✓ **移送運用**で接続（`~/Akari/inbox/`）。macOS スタンドアロン版は受信先を設定変更できないため、直接指定ではなく移送を採る（§2-4 の想定どおり） |
+| **承認の往復（`decisions.json`）** | ✓ スマホのタップが Mac のファイルへ書き戻ることを実測。単選カード（`thumbnail`: 既定 → 別候補）・整数スライダ（`direction.intensity`: 50 → 75）・**確定（`completedAt` 記入）** の 3 経路が通過。`byDefault: false` / `answeredAt` も期待どおり更新され、ファイルは `0600` を維持 |
+
+- Taildrop の実測は「チャット添付は搬送路として筋が悪い」（§非スコープの根拠）を裏づけた —
+  同じ 92MB は Telegram Bot API 標準（受信 20MB）では原理的に通らない
+- 受信物が HEVC だった点は、プレビューサーバー側の H.264 自動プロキシ層が実運用で必要になることの実例
+
+**未達の項目（L2 は未クローズ）**:
+
+| 未達 | 状況 |
+|---|---|
+| HTTPS | **`tailscale serve` の TLS が未成立**。tailnet 側で HTTPS は有効（`CertDomains` に当該ドメインあり）だが Let's Encrypt の ACME 注文が `invalid` で失敗。上記の実測は tailnet 内の平文 HTTP で代替した（WireGuard 内側のため機密性は保たれるが、secure context を要する機能は使えない）。**平文 HTTP を既定にはしない** |
+
+## 8. 改訂履歴
+
+| 日付 | 変更 | 理由 |
+|---|---|---|
+| 2026-08-02 | v0 初版 | — |
+| 2026-08-12 | §3 serve 許可リストを 1 件 → 2 件へ拡張（decision-cards レポートヘルパーを追加）。§2-3 に外部ポート写像を明記。§5 L2 に承認往復の実測を追加 | 元のスコープ（§0「レポートを見て OK / 差し戻しを言う」）は最初から承認を含んでいたが、ハードルールが `serve = プレビューのみ` と狭すぎ、**承認レポートを配信する経路が契約上ふさがっていた**。スコープの拡大ではなくスコープとハードルールの不整合の是正 |

package/vendor/packages/akari-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
   "type": "module",
   "bin": {

package/vendor/packages/decision-cards/report-helper.mjs

@@ -186,10 +186,17 @@ function contentTypeFor(filePath) {
       ".jpg": "image/jpeg",
       ".js": "text/javascript; charset=utf-8",
       ".json": "application/json; charset=utf-8",
+      ".m4a": "audio/mp4",
       ".mjs": "text/javascript; charset=utf-8",
+      ".mov": "video/quicktime",
+      ".mp3": "audio/mpeg",
+      ".mp4": "video/mp4",
+      ".ogg": "audio/ogg",
       ".png": "image/png",
       ".svg": "image/svg+xml",
       ".txt": "text/plain; charset=utf-8",
+      ".wav": "audio/wav",
+      ".webm": "video/webm",
       ".webp": "image/webp",
     }[extension] ?? "application/octet-stream"
   );
@@ -354,7 +361,58 @@ async function writeState(state) {
   }
 }
 
-async function serveFile(response, filePath, contentType) {
+const SINGLE_RANGE_PATTERN = /^bytes=(\d*)-(\d*)$/;
+
+// 単一バイトレンジだけを解釈する。複数レンジ・未知の単位・壊れた指定は null を返し、
+// 呼び出し側は 200 全体配信へフォールバックする（RFC 9110 が許す挙動）。
+// レンジが範囲外のときだけ { unsatisfiable: true } を返して 416 にする。
+function parseRange(rangeHeader, size) {
+  if (typeof rangeHeader !== "string") {
+    return null;
+  }
+
+  const match = SINGLE_RANGE_PATTERN.exec(rangeHeader.trim());
+  if (match === null) {
+    return null;
+  }
+
+  const [, rawStart, rawEnd] = match;
+  if (rawStart === "" && rawEnd === "") {
+    return null;
+  }
+
+  let start;
+  let end;
+
+  if (rawStart === "") {
+    // bytes=-N — 末尾 N バイト
+    const suffixLength = Number(rawEnd);
+    if (!Number.isSafeInteger(suffixLength) || suffixLength <= 0) {
+      return null;
+    }
+    start = Math.max(0, size - suffixLength);
+    end = size - 1;
+  } else {
+    start = Number(rawStart);
+    end = rawEnd === "" ? size - 1 : Number(rawEnd);
+    if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end)) {
+      return null;
+    }
+    if (end > size - 1) {
+      end = size - 1;
+    }
+  }
+
+  if (start >= size || start > end) {
+    return { unsatisfiable: true };
+  }
+
+  return { start, end };
+}
+
+// iOS Safari は <video> に対してまず `Range: bytes=0-1` を投げ、206 が返らないと再生を諦める。
+// レンジ対応は動画・音声をレポート内で再生させるための必須要件。
+async function serveFile(response, filePath, contentType, rangeHeader) {
   let fileStats;
   try {
     fileStats = await stat(filePath);
@@ -369,15 +427,44 @@ async function serveFile(response, filePath, contentType) {
     throw new HttpError(404, "file not found");
   }
 
-  response.writeHead(200, {
+  const baseHeaders = {
     "Content-Type": contentType ?? contentTypeFor(filePath),
-    "Content-Length": fileStats.size,
     "Cache-Control": "no-store",
     "X-Content-Type-Options": "nosniff",
+    "Accept-Ranges": "bytes",
+  };
+
+  if (fileStats.size === 0) {
+    response.writeHead(200, { ...baseHeaders, "Content-Length": 0 });
+    response.end();
+    return;
+  }
+
+  const range = parseRange(rangeHeader, fileStats.size);
+
+  if (range !== null && range.unsatisfiable === true) {
+    response.writeHead(416, {
+      ...baseHeaders,
+      "Content-Length": 0,
+      "Content-Range": `bytes */${fileStats.size}`,
+    });
+    response.end();
+    return;
+  }
+
+  const start = range === null ? 0 : range.start;
+  const end = range === null ? fileStats.size - 1 : range.end;
+
+  response.writeHead(range === null ? 200 : 206, {
+    ...baseHeaders,
+    "Content-Length": end - start + 1,
+    ...(range === null
+      ? {}
+      : { "Content-Range": `bytes ${start}-${end}/${fileStats.size}` }),
   });
 
   await new Promise((resolveStream, rejectStream) => {
-    const stream = createReadStream(filePath);
+    const stream = createReadStream(filePath, { start, end });
     stream.on("error", rejectStream);
     stream.on("end", resolveStream);
     stream.pipe(response);
@@ -421,7 +508,12 @@ const server = createServer(async (request, response) => {
 
   try {
     if (request.method === "GET" && rawPath === "/") {
-      await serveFile(response, reportPath, "text/html; charset=utf-8");
+      await serveFile(
+        response,
+        reportPath,
+        "text/html; charset=utf-8",
+        request.headers.range,
+      );
       return;
     }
 
@@ -477,7 +569,7 @@ const server = createServer(async (request, response) => {
 
     if (request.method === "GET") {
       const staticPath = await resolveStaticPath(rawPath);
-      await serveFile(response, staticPath);
+      await serveFile(response, staticPath, undefined, request.headers.range);
       return;
     }
 

package/vendor/skills/setup-remote/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: setup-remote
-description: スマホなど別デバイスから承認レポート・プレビューを閲覧し、撮影素材を作業場へ送れるようにする遠隔セットアップスキル。Tailscale の状態を doctor で判定し、導入・ログイン（人間手番）→ tailscale serve でプレビューサーバー（既定 4567）を tailnet 限定 HTTPS 化 → Taildrop 受信先を作業場 inbox/ へ接続 → 別デバイスからの疎通確認までを一気通貫でガイドする。「スマホでレポートを見たい」「外から承認したい」「スマホから素材を送りたい」「遠隔セットアップして」で発動する。公開インターネットへの露出（funnel）は既定で扱わない。
+description: スマホなど別デバイスから承認レポート・プレビューを閲覧し、撮影素材を作業場へ送れるようにする遠隔セットアップスキル。Tailscale の状態を doctor で判定し、導入・ログイン（人間手番）→ tailscale serve でプレビューサーバー（既定 4567）と承認レポートヘルパーを tailnet 限定 HTTPS 化 → Taildrop 受信先を作業場 inbox/ へ接続 → 別デバイスからの疎通確認までを一気通貫でガイドする。「スマホでレポートを見たい」「外から承認したい」「スマホから素材を送りたい」「遠隔セットアップして」で発動する。公開インターネットへの露出（funnel）は既定で扱わない。
 ---
 
 # FORBIDDEN 級ハードルール
@@ -12,7 +12,10 @@ description: スマホなど別デバイスから承認レポート・プレビ
 1. **`tailscale funnel`（公開インターネットへの露出）を実行・提案しない。** ユーザーが明示的に
    funnel を要求した場合のみ、「URL を知る誰でも到達できる」リスクを説明し、明示承認を得てから扱う。
    既定は常に tailnet 限定（私設ネットワーク内のみ）。
-2. **serve の対象はプレビューサーバーのみ。** ファイルシステム・他ポート・他アプリを serve しない。
+2. **serve してよいのは許可リストの 2 件だけ** — (a) プレビューサーバー（既定 4567）
+   (b) decision-cards レポートヘルパー（`report-helper.mjs`。承認レポート配信 + `decisions.json`）。
+   **ファイルシステム・他ポート・他アプリを serve しない。** 許可リストの拡張は契約改訂を要する
+   （スキルの判断で足さない）。
 3. **インストール・ログイン・スマホ側アプリ導入を代行しない。** 人間の手番として明示的に依頼し、
    完了を doctor（`bin/doctor.mjs`）の再実行で確認してから次工程へ進む。
 4. **ネットワーク設定の変更（serve の on/off・受信先変更）は、実行するコマンドと効果・解除方法を
@@ -25,7 +28,7 @@ description: スマホなど別デバイスから承認レポート・プレビ
 # 実行順リーフ
 
 1. [doctor-and-install.md](doctor-and-install.md) — doctor 判定 → 状態別の導入・ログインガイド（macOS / Windows / スマホ）
-2. [serve-preview.md](serve-preview.md) — プレビューサーバー起動 → `tailscale serve` 設定 → URL 確定
+2. [serve-preview.md](serve-preview.md) — プレビューサーバー起動 → `tailscale serve` 設定 → URL 確定 →（承認をスマホで回す場合）レポートヘルパーの serve
 3. [taildrop-inbox.md](taildrop-inbox.md) — Taildrop 受信先の固定 → 作業場 `inbox/` へ接続 → 疎通確認 → 完了レポート
 
 詳細を先読みせず、現在の工程に対応するファイルだけを読む。人間手番の完了を doctor で確認せずに先へ進めない。

package/vendor/skills/setup-remote/serve-preview.md

@@ -26,5 +26,29 @@ tailscale serve --bg 4567
 
 - doctor 再実行 → `serve.configured: true` と `serveUrl` を確認
 - スマホ（Tailscale オン）で `serveUrl` を開いてもらい、プレビューが表示されることを確認
-- 表示されたら [taildrop-inbox.md](taildrop-inbox.md) へ。開けない場合はまずスマホ側の
-  Tailscale がオンかを確認する（最頻出の原因）
+- 開けない場合の切り分け順:
+  1. スマホ側の Tailscale がオンか（最頻出の原因）
+  2. **TLS ハンドシェイクで止まる場合は証明書**。管理コンソールで HTTPS Certificates が
+     有効か確認する。有効なのに失敗するなら `tailscale cert <dnsName>` を単体実行して
+     ACME のエラー本文を読む（発行が invalid なら tailnet 側の問題で、serve の設定ミスではない）
+  3. マシンがスリープしていないか（寝ると tailnet から消える）
+
+## 4. 承認レポートを serve する（必要なとき）
+
+承認ゲートをスマホで回す場合は、decision-cards レポートヘルパーも serve する。
+**許可リストはプレビューサーバーとこのヘルパーの 2 件だけ**（ハードルール 2）。
+
+1. ヘルパーを起動する（`<port>` は空きポート。標準出力に `HELPER: http://localhost:<port>/`）:
+   ```
+   node packages/decision-cards/report-helper.mjs <report.html のパス> --port <port>
+   ```
+2. serve 設定（承認必須 — ハードルール 4）。コマンド・効果・解除方法を提示して承認を得る:
+   ```
+   tailscale serve --bg --https=8443 <port>
+   ```
+   - 効果: `https://<マシン名>.<tailnet 名>.ts.net:8443` → `localhost:<port>`。tailnet 内限定
+   - 外部ポートを 8443 に固定するため、ヘルパーの内部ポートが起動ごとに変わっても
+     **チャットに貼った URL は死なない**
+   - 解除: `tailscale serve --https=8443 off`（プレビュー側は残る）
+3. スマホで開き、カードを 1 つ操作 → `<report.html>.decisions.json` が実際に更新されることを
+   Mac 側で確認する。**表示できただけで完了と言わない**（ハードルール 6）

package/vendor/skills/setup-remote/taildrop-inbox.md

@@ -8,6 +8,10 @@ Taildrop = Tailscale のデバイス間ファイル直送（スマホの共有
 - 受信先は環境により異なる（macOS / Windows の GUI 版は多くの環境で「ダウンロード」フォルダ。
   アプリの設定で変更できる場合がある）。**推測で断定せず、§3 のテスト送信で実パスを確定する**
 - CLI 運用（Linux 等）では `tailscale file get <受信先ディレクトリ>` で取り出す
+- **実測（2026-08-12 / macOS スタンドアロン版 `io.tailscale.ipn.macsys` 1.98.10）**: 受信先は
+  `~/Downloads` で、`defaults read io.tailscale.ipn.macsys` に受信先を指すキーは存在しなかった。
+  この形態では受信先を `inbox/` へ直接向けられない前提で §2 の移送運用に進んでよい
+  （設定 UI に項目が見当たらない場合も同じ扱い）
 
 ## 2. 作業場 inbox/ への接続