plan-viewer完了報告HTMLに「読了」ボタン追加(認証スキップAPI+gen改修で仕組み化… 完了報告 (j-20260504-011)

✅ 完了

やったこと

mini-apps-api/src/index.ts に GET /app/api/jobs/:id/read-public (+ /api/...) を追加し authMiddleware バイパス。db.ts/db-rw.ts の既存 markJobRead を流用。launchctl kickstart で再起動。gen-completion-summary.sh の md 末尾に HTML 直書きの「読了」ボタン (fetch ベース) を埋め込み、marked が透過することを確認。j-20260504-009 を再生成して実機 curl でクリック相当の動作を検証 (ok:true, changed:true → 2回目 changed:false で idempotency も担保)。SQL で bucket が archive へ遷移したことを直接確認。後方互換も古い HTML 3本に readCompletionBtn が含まれないことで担保。

完了条件の検証

• ✅ mini-apps-apiに認証なしreadエンドポイント追加で動作 — curl https://mbp.tail863a2a.ts.net/app/api/jobs/j-20260504-009/read-public → {"ok":true,"changed":true}
• ✅ gen-completion-summary.sh改修でmdに「読了」ボタン埋め込み — src/index.ts に handleReadPublic 追加, gen-completion-summary.sh の md 末尾 HEREDOC で 出力
• ✅ j-20260504-009のplan-viewer HTML再生成で「読了」ボタン表示確認 — grep readCompletionBtn ...j-20260504-009.html → 2 matches
• ✅ ボタンクリック→read_at更新→INBOXから消失を実機確認 — before: read_at NULL → API → after: 2026-05-04T06:23:27.840Z, bucket=archive (was inbox)
• ✅ 後方互換性(既存plan-viewer HTMLには影響しない) — 古い HTML 3本 grep readCompletionBtn → 0 buttons (新規生成のみボタン入る)
• ✅ report-done-v2.shで完了報告 — このスクリプト実行で送信中

次にやること

• 健人が今後 plan-viewer URL を開いたら読了ボタンを押して INBOX を消化していく
• 既存 INBOX 滞留分は別途バルク処理(B案)が必要なら次ジョブで対応
• 完了報告以外の plan-viewer 記事(自由フォーマット)へのボタン展開は不要(scope外)

ジョブID: j-20260504-011
完了時刻: 2026-05-04 15:24:59 JST