20年分の発明を、もう一度マッシュアップ。
ProtoPediaに公開された実在の作品を2つ「親」として選び、生成AIによって新しい発明のアイデア(「子」)を1つ誕生させるWebサービス。子も次の配合の親になれます。生成された発明の系譜は、公開された「発明の系譜図」として育てられます。
生成された子作品は「AIが考えた未実装のアイデア」です。 実際に製作したもの・実在の成果物ではありません。ProtoPediaの元作品には出典リンクを表示します。
| 部分 | 構成 |
|---|---|
| 公開UI | GitHub Pages(Vite + TypeScript の静的サイト) |
| 投稿 | GitHub Issues(サイトにログイン機能・書き込みトークンなし) |
| 配合候補 | config/schedule.json の間隔(既定15分)ローテ → data/current-candidates.json(ブラウザはProtoPedia APIを呼ばない) |
| 作品データ | ProtoPedia API v2 → 少数取得(data/sample-prototypes.json ほか)→ 候補プール |
| 配合ワーカー | GitHub Actions(起床は一定間隔、実行可否は設定間隔で判定 + 手動 workflow_dispatch) |
| 頻度設定 | config/schedule.json(候補更新間隔・配合間隔・候補件数をファイルで変更 / issue #15) |
| 永続データ | リポジトリ内の data/offspring.json / data/breeding-state.json / data/element-cache.json / data/processed-issues.json / data/ai-usage.json |
| AI | Cloudflare Workers AI(Actionsサーバー側から呼ぶ。テキスト @cf/openai/gpt-oss-20b・画像 @cf/black-forest-labs/flux-1-schnell / issue #16) |
| サムネイル | 生成成功時 public/static/assets/inventions/<子ID>.png(ViteのpublicDirから dist/assets/inventions/ へ配信)(512×512)。失敗してもテキストは保存(imagePath: null) |
AI配合は設定間隔(既定60分=1時間)を空けて最大1件です(全ユーザー共有)。 閲覧・選択・系譜図表示にAIは使いません。
候補は設定間隔(既定15分)ごとに最大6件が全ユーザー共通です。「本日の発明研究所」に並ぶ候補はスロット(UTC YYYY-MM-DDTHHMM・設定間隔の刻み)ごとに決定的に選ばれ、ページを再読み込みしても変わりません。自由検索はなく、候補から2作品(AとB)を選んで申請します。
cp .env.example .env # Issue作成リンク用の owner/repo を設定
npm install
npm run dev # http://localhost:5173- APIトークンなしでもフロントは起動・ビルドできます(
npm test,npm run build)。 - 候補6件は
data/current-candidates.jsonの静的importだけ(ブラウザからAPIを呼ばない)。 - 候補データが未同期のときは
[SAMPLE]付きの開発用サンプルが表示され、右上バッジも「開発用サンプル」になります。本番と混同しないでください。 - 本番の子作品が0件のときだけ、サンプルの子作品(系譜図2世代の確認用)を「最近誕生した発明」と系譜図に表示します(注意書きを分けて案内)。
| 変数 | 用途 | 必須 |
|---|---|---|
VITE_GITHUB_OWNER |
Issue作成リンクのowner | ローカルのみ |
VITE_GITHUB_REPO |
Issue作成リンクのrepo | ローカルのみ |
GITHUB_REPOSITORY |
Actionsが自動提供。ビルド時にクライアントへ注入 | Actions |
CLOUDFLARE_ACCOUNT_ID |
CloudflareのアカウントID(GitHub Secrets / ローカル.envのみ) |
配合処理時 |
CLOUDFLARE_API_TOKEN |
Workers AI実行用のAPIトークン(最小権限・GitHub Secrets / ローカル.envのみ。ログ・JSON・フロントに入れない) |
配合処理時 |
PROTOPEDIA_API_V2_TOKEN |
ProtoPedia API v2のトークン(GitHub Secrets / ローカルenvのみ。VITE_ プレフィックス禁止) | 作品同期時 |
GH_TOKEN |
ローカルの gh CLI用PAT(.env 専用・node scripts/gh.mjs が読む。VITE_ プレフィックス禁止。Actionsは GITHUB_TOKEN で自動認証) |
開発issue登録時のみ |
- Pages: Settings → Pages → Source を
GitHub Actionsに設定(deploy.ymlが push のたびにテスト → ビルド → デプロイ)。base は既定で相対パス(./): カスタムドメインのルート配信・<owner>.github.io/<repo>/・フォーク先のいずれでも、ドメインや公開パスを変更してもビルド設定なしで動く(Issue リンクはGITHUB_REPOSITORYから自動導出)。絶対パスに固定したい場合のみVITE_BASE=/<repo>/を指定する。絶対パス base をカスタムドメインで使うとアセットが全部404で真っ黒になる(実例: 2026-11-10 → 相対baseへ修正)。 - Issues: Settings → Issues でラベル
breeding-requestを用意(ワークフロー側で管理。利用者が付ける前提にしない)。 - Secrets: Settings → Secrets and variables → Actions に登録:
CLOUDFLARE_ACCOUNT_ID/CLOUDFLARE_API_TOKEN(配合処理。未設定時はコスト0で停止し、npm run breed:dryの動作確認のみ)PROTOPEDIA_API_V2_TOKEN(作品同期。トークン取得先。未設定時は同期をスキップし既存データを維持)
- Actions権限: Settings → Actions → General → Workflow permissions を設定。JSONコミットには
contents: write、Issue対応にはissues: writeを該当ジョブのみに付与。 - 配合申請はサイトの「配合を申し込む」ボタン → Issue作成画面が開く → ユーザー自身が送信。
配合頻度・候補更新頻度・候補件数は設定ファイルで変更できる(issue #15)。ファイルの変更をコミットするだけで反映され、UIの文言・次回予定時刻もこの値から生成される。
{
"candidateRotationMinutes": 15,
"breedingIntervalMinutes": 60,
"maxCandidates": 6
}| キー | 意味 | 既定 |
|---|---|---|
candidateRotationMinutes |
配合候補の更新間隔(分・正の整数、1〜10080) | 15 |
breedingIntervalMinutes |
配合(生成AI呼び出し)の間隔(分・正の整数)。前回の成功からの空き時間 | 60 |
maxCandidates |
1枠の候補件数の上限(正の整数、1〜50) | 6 |
dailyAiCallLimit(任意) |
UTC日ごとの生成AI呼び出し回数の上限(正の整数)。未設定 = 上限なし | なし |
- 候補更新と配合処理は独立した設定であり、UIでも混同しない(「◯ごとに新しい発明候補が届くよ!」と「◯に最大1つ、新しい発明が誕生します!」は別々のキーから生成)。「1時間に1回」「毎時」などの固定文言はサイトに存在しない。
- GitHub ActionsのcronはJSONを読めないため、ワークフローは一定間隔(15分)で「起床」し、スクリプト側が実行可否を判定する:
- 候補:
scripts/rotate-candidates.tsが現在時刻から設定間隔でスロットを算出し、data/current-candidates.jsonのslotと比較。同一枠ならスキップ(= 二重生成しない)。**「間隔ごとに必ず生成」ではなく「間隔を空けて最大1件」**なので、Actionsの遅延があっても正常動作。手動実行(workflow_dispatch)も同じ判定を通る。 - 実効的な候補更新間隔 = max(設定値, 起床間隔15分)。15分未満の間隔にする場合は cron(
rotate-candidates.yml)も合わせて短くすること。 - 配合: ワーカー(
breed.yml/ issue #6)がshouldBreed()(lib/schedule.ts)で判定。前回成功日時(data/breeding-state.json)とbreedingIntervalMinutesを比較し、未経過なら生成AIを呼ばない。
- 候補:
- 失敗時の再試行条件(明示): 失敗は間隔に数えないので次の起床で再試行できる(最大3回)。連続3回失敗すると間隔ぶんの冷却に入り、冷却経過で再開。成功でカウントはリセット。
dailyAiCallLimit設定時はUTC日単位で上限(失敗した試行も呼び出し回数に計上)。 - 設定が不正なとき: rotate / validate は exit 1 で処理を停止してエラーを通知(= AIを呼ばない)。フロントは既定値で表示を続けつつエラーを告知する。
- 既存の
data/offspring.json・Issue申請・current-candidates.jsonは変更不要(設定変更との互換性を維持)。 - ローカル開発で枠内に再生成したいときだけ
npm run rotate:candidates -- --force(ワークフローからは渡さない)。
サイトに表示する日時はすべて日本時間(Asia/Tokyo)。内部データと処理はUTCのまま(下記)。
- 表示:
lib/datetime.tsの共通関数だけを通す。日付2026/11/10/ 日時2026/11/10 15:00/ 時刻15:00/ 時間帯15:00〜15:15(日跨ぎは2026/11/09 23:30〜2026/11/10 00:30)。24時間表記・秒なし・Intl.DateTimeFormatにtimeZone: 'Asia/Tokyo'を明示するためブラウザ/OSのタイムゾーン設定に依存しない。文言は「現在の配合枠」「最終更新」「次の候補更新」「誕生日時」で、値の後ろに「(日本時間)」を添える。 - 不正・欠損の日時は例外ではなく
日時不明を表示する(そのときだけ「(日本時間)」は付けない)。 - 内部はUTC: JSONの
createdAt/generatedAt/ スロットキー(YYYY-MM-DDTHHMM)はISO 8601(UTC)のまま、Actionsのcron・間隔判定・スロット境界もUTCの絶対時刻。JST文字列を再解析して判定することはしない(比較・判定はlib/schedule.ts/lib/candidates.ts、lib/datetime.tsは表示専用)。既存JSONの書換も不要。 - 予定時刻は保証しない: 「次の候補更新」はActionsの実行結果(JSONの値)から導いた更新予定で、遅延時は
⚠ 候補更新が遅れていますが出る(端末時計で補完しない)。カウントダウン表示は無い。 - 配合の実行制限は従来どおり**前回成功からの経過時間(elapsed方式)**で、表示時間帯(固定枠の境界)とは独立した設定(
breedingIntervalMinutes)。
仕様は docs/protopediaapi.md(調査資料。実接続で一部確認済み、下「検証済みと未検証」参照)。実装は lib/protopedia.ts + scripts/fetch-sample-prototypes.mjs + scripts/rotate-candidates.ts。
ProtoPedia API v2 ──(Bearer)──> npm run fetch:sample(少数・手動 / syncはdispatchのみ)
│ 取得 → HTML除去・型検証・URL検証・ライセンス確認
▼
data/sample-prototypes.json(候補プール)
│ npm run rotate:candidates(configの間隔・既定15分ごと / APIトークン不要)
▼
data/current-candidates.json ──> GitHub Pages(静的import)
- 試作段階では全件収集を開始しない:
npm run fetch:sampleは既定12件(--count=上限50 /--offset=)。 全件同期はnpm run sync:protopedia。sync-prototypes.ymlは手動 dispatch のみ(有効化するときだけscheduleを戻す)。 - 候補ローテ:
npm run rotate:candidatesは保存済みプールからスロット(UTCYYYY-MM-DDTHHMM・設定間隔の刻み)に決定的にmaxCandidates件を選出。 同じスロットなら常に同じ候補(枠内のActionsの再実行・ローカル実行でも不変)。APIもトークンも使わない。前回と同一枠ならスキップ(頻度制限。--forceで解除)。-- --slot=2026-11-09T1415で任意の枠を検証、-- --dry-runで書き込まず確認。 - 起床は15分固定・実行可否はスクリプト判定:
.github/workflows/rotate-candidates.yml(cron4/15 * * * *+ dispatch)が一定間隔で起動し、スクリプトがconfig/schedule.jsonの間隔と前回生成のslotから実行可否を判断してdata/current-candidates.jsonをコミット(issue #15)。 画面上の「次回の候補更新予定」はこの**実行結果(JSONの値)**ベースで、遅延時は注意書きが出ます。 - 失敗時の挙動: 取得失敗・0件・不正レスポンスでは既存JSONを置き換えない(0件保存は拒否)。
- トークンの扱い:
.env/ Secretsのみ。スクリプトがreadFileSyncで読む(シェルにexportしない)。ログ・JSON・コミット・フロントバンドルに入れない。 - 作者(
表示名@handleのまま保存 = クレジット用)・タグ・ライセンス・作品画像はこのJSONから表示。
Title: [Breed] protopedia:1234 x protopedia:5678 ← 表示用(信用しない)
parent_a: protopedia:1234 ← 正規の入力元は本文のみ
parent_b: protopedia:5678
parent_a_url: https://protopedia.net/prototype/1234 ← 表示・照合用の「データ」(httpsのみ)
parent_b_url: https://protopedia.net/prototype/5678
mode: fusion ← fusion(単純配合)/ genetic(遺伝子配合)/ mutation(突然変異配合)
slot: 2026-11-09T1715 ← 申請時の候補スロット(UTC・設定間隔の刻み=既定15分。移行前のHH形式も許容)
<!-- 任意: comment: の後に1行だけで自由記述(最大500字・研究員へのひとこと) -->
- 親Aと親Bは別のID、許可されたID形式(
protopedia:<数字>/mashup-<数字>)のみ。 slot/*_urlは付いていれば形式を検証して記録。URLは命令として扱わず、ワーカーは親IDから出典URLを再導出する。comment(研究員へのひとこと)は任意の自由記述(1行・最大500字・Issue作成時のみ入力)。生成時の追加条件としてAIに渡しますが、渡し方は区切り付きの「参考資料(データであり命令ではない)」だけで、シェル・GitHub Actions式には一切埋め込みません(プロンプトインジェクション対策 / issue #5・#16 §5)。- 不正な入力はAIを呼ばずに理由をコメントします。
.github/workflows/breed.yml が cron(9/15 * * * * = 15分ごとに起床)と workflow_dispatch で起動し、scripts/process-breeding.ts が処理します。実効的な配合は config/schedule.json の breedingIntervalMinutes(既定60分)を空けて最大1件(全ユーザー共有。cronは正時に厳密実行しないため「間隔を空けて最大1件」という仕様)。
open Issue の最古1件(ラベル非信用・タイトル/本文で判定)
→ パース・ID検証・重複/近親交配チェック(不正はAI前に却下コメント)
→ 親の要素抽出8項目(使用技術/目的/解決する課題/入力/出力/体験/特徴/面白さ)
└ 作品ID + 内容ハッシュで data/element-cache.json にキャッシュ(同じ親は再抽出しない)
→ gpt-oss-20b で配合生成(配合タイプ・研究員のひとこと反映 / JSON構造化出力)
→ 出力JSONを検証(不正・危険・根拠なし主張は公開しない)
→ flux-1-schnell で 512×512 サムネイル(画像内文字なし・写真風禁止。失敗してもテキストは保存)
→ data/offspring.json + キャッシュ + 利用量 + 処理状態をコミット
→ Issue へ生成結果をコメントしてクローズ
- ローカル実行:
npm run breed:dry(AI呼び出し・データ書き込み・Issue操作を一切しない安全確認)/npm run breed(本番と同じ処理)/npm run breed:check-ai(認証情報の接続確認のみ1回)。 - 二重処理防止:
data/processed-issues.json(resolved/rejectedは永却下、failedは3回まで再試行)。concurrencyは固定グループで直列実行。 - 利用量とコスト:
data/ai-usage.jsonに実行回数とトークン数は実測で記録し、Neurons は公開料金表からの試算として記録します(試算を実測値として扱わない)。Cloudflareの利用量APIは公式ドキュメントに存在しない(未検証)ため、上限判定は実呼び出し回数(dailyAiCallLimit)で行います。「1時間に1回なら無料枠内」とは断定しません(無料枠・料金は変動するため、使う前に公式情報を確認してください)。 - 失敗時: 認証失敗・予算超過・一時障害を分類してログに残し、自動の無限リトライはしません(テキスト生成2回・画像再試行1回まで)。エラーにトークンを含めません。
- 権限: ワークフローは
permissions: {}から始まり、該当ジョブだけcontents: write(JSONコミット)とissues: write(コメント・クローズ)を付与。AI出力はshellへ埋め込まずtmp/breed-report.md経由でコメントします。 dry_run: true(dispatch の既定値)は本番の時間枠を消費せず、データ・Issueを書き換えません。
デザインの基準は DESIGN.md。「ちょっと怪しい発明博士の、16bit配合研究所」。MOTHER2/マサキの家の雰囲気を抽象化して独自に構成し、既存IPの画像・キャラクター・UI配置は流用しない。
-
ダーク / ライト切り替え: ヘッダー右上のボタンで切り替え、
localStorage['mashup-theme']に保存。既定はOS設定。index.htmlの初期化スクリプトがCSS読込前にdata-themeを設定し、テーマフラッシュを防ぐ。トークンは:rootの--lab-*(固定パレット)とロールトークン(--bg/--window/--line/--textなど)に集中管理。 -
フォント: 見出し・ボタン・ラベルは DotGothic16、本文は Noto Sans JP で可読性優先(Google Fonts CDN への外部接続あり。届かない環境ではゴシック/等幅にフォールバック)。
-
アクセス解析: Google Tag Manager(
GTM-NLGLRR3T) をトップと/ideasの両方の<head>に配置し、<body>直後に公式推奨のnoscriptiframe を配置(外部接続先:googletagmanager.com)。タグ本体はGTMコンテナ側で管理し、サイトにはIDだけを置く。ローカルのnpm run dev/ preview からもヒットが送信される(解析値に開発データが混ざる点に注意。除外はGTMコンテナ側のトリガー条件で行う)。 -
ウィンドウ: 太い外枠3px + 内側の細い線(inset)+ 右下ハードシャドウのRPG風。ガラス調・ネオンは不使用。
-
候補パネル「本日の発明研究所」: 画面完成イメージ準拠の角丸パネル + 3列画像カード(900pxで2列 / 560pxで1列)。 画像タイルは下地
--tile(白系・両テーマ共通)でobject-fit: contain・loading=lazy・読込失敗時は「画像なし」プレースホルダ(枠は維持)。 見出しは DotGothic16 + ラテン小見出し、枠・色は研究所トークンのまま — 一般的なSaaSカードUIにしない。 選択状態は「タイル枠の色 + バッジ文字(親A選択中)+ 押下ボタン」の三重化で色だけに依存しない。 -
一覧ページ
/ideas: Viteマルチページ(public/ideas/index.html+public/ideas.ts)。data/offspring.jsonのみを新しい順に列挙し、各項目に 未実装バッジ・世代・親リンク(子作品=トップの?id=ディープリンク / ProtoPedia=出典URL)・誕生日時(日本時間)・元Issue(あれば)を表示。0件なら空状態で申請誘導。トップの「最近誕生した発明」見出しからリンクする。 -
系譜図の配色は dataviz 手順で検証済み(両テーマ・ノード面でPASS):
テーマ 面 元作品(実線) 子作品(破線) ダーク #303C51#12A87D#D96B4Fライト #FFFCF0#0F9D72#C15733CVD分離は ΔE 7〜8 のWARN帯のため、凡例 + 線種(実線/破線)+ ノードラベルで二重化して合法化している。勝手に色を替えない。
-
コントラスト: 本文はAA(4.5:1以上)をトークンで確保。アクセント色の強調語は
--accent-ink(通常サイズでAA)、タグラインは太字19pxの「大きな文字」経路(3:1以上)を使う。装飾はaria-hidden、状態は色のみで区別しない(ラベル・線種・マーク併用)。 -
装飾: 浮遊スプライト・常時点滅・グリッド背景は不使用(DESIGN.md §3.1/§6)。所長のメモは文字だけのセリフウィンドウ。博士キャラクターは状態表現としてのみ動き、
prefers-reduced-motionで全停止する。 -
博士キャラクター(issue #11): 案内役の博士(親選択の案内)と 実験担当の博士(配合実験・結果発表)を8bitスプライトで表示(
public/assets/characters/に個別透過PNG 8枚・共通135×268・足元揃え、切り出しはscripts/slice-characters.mjs)。- 状態は
idle / success / thinking / celebrationの4種(public/character.tsが表示、public/breeding-state.tsが実際の状態から決定)。 - リアクションは実際の処理状態と連動: Issue作成画面を開いただけでは
successにしない(「送信」まで未完了と表示)。申請完了は匿名GitHub APIがIssueを確認したときだけ。実験待ち(open Issue)と生成中(closed 未公開)を区別し、誕生(celebration)は公開済みの本番子作品でだけ判定する。 - 状態観測はブラウザから匿名
api.github.com(CORS可・60req/h/IP)を 3分間隔(最大40req/h) でポーリング。3回連続失敗・レート制限・誕生確認で停止し、無限リトライしない(public/github-watch.ts)。 - ランタイムの誕生検知用にビルド時と同様の
data/offspring.jsonをdist/へ emit(取得失敗時はビルド時データにフォールバック)。
- 状態は
-
ロゴの読み仮名(issue #19): FVの英語ロゴ「Mashup Ours」の右隣に小さく 「(マッシュアップアワーズ)」 を添える(Mashup Awardsをもじった名前と伝わる添え書き)。
- 英語ロゴ(
.hero h1)は文言・ドット絵スプライトとも変更せず、読み仮名は.logo-yomi(h1とは別要素)。 - カタカナは英語より目立たない: h1(
clamp(1.6rem〜2.6rem)DotGothic16)に対しclamp(0.72rem〜0.95rem)・--text-dim・本文フォント Noto Sans JP(日本語の可読性優先でドットフォントにしない)。 - 760px以下はロゴの下に配置(
.hero-logoを縦積み)。デスクトップ/モバイルとも横スクロール0pxを実測。 - キャッチコピー「20年分の発明を、もう一度マッシュアップ。」は変更なし。
- 英語ロゴ(
-
スクリーンショット確認:
npm run build && npx vite preview --port 4173を起動してからnpm run screenshot(ライト/ダーク両テーマ × デスクトップ/詳細/モバイルをtmp/に出力。初回のみnpx playwright install chromiumとinstall-depsが必要)。
- ProtoPedia作品:
protopedia:<数字>(第0世代) - 生成された子作品:
mashup-<数字6桁>(例mashup-000001)。Issue本文のparent_a/parent_bにもこのid文字列をそのまま使う。- AGENTS.mdのIssue例は
mashup:<生成ID>(コロン)だが、データモデル例はmashup-000001(ハイフン)。誤導入を避けるためデータモデル例のハイフン形式に統一した。
- AGENTS.mdのIssue例は
- 先祖と子孫の組み合わせ(近親交配)は拒否する。共通の子を持つだけのダイヤモンド形状は許可。
実接続で確認済み(2026-11・実トークンでの取得):
/prototype/listのレスポンス形状は{metadata, count, links, results}。countはページ内件数(総数ではない)。- カタログ件数外の offset は HTTP 200 +
count:0でresultsキー自体が無い(= 空ページとして正常終了)。
実接続で確認済み(2026-11・npm run breed:check-ai / Cloudflare Workers AI):
- 認証・エンドポイントは有効。テキスト生成
@cf/openai/gpt-oss-20bの同期応答は OpenAI互換(object: "chat.completion")で本文はchoices[0].message.content。 usageフィールドは存在する:prompt_tokens/completion_tokens/total_tokens/neurons(Workers AI の消費単位。neuronsは試算値という方針は維持)。- gpt-oss は推論モデル:
max_tokensは思考も含む予算。不足するとcontent: null+finish_reason: "length"(思考はmessage.reasoning_content)→ 抽出は空文字になり呼び出し側の検証・失敗処理に落ちる(データは壊れない)。check-ai はmax_tokens: 300+include_reasoning: falseで本文取得を確認。 include_reasoning: falseは受理される。reasoning_effortは HTTP 400 で不可(このエンドポイント)。- トークン実測例: prompt 76 / completion 40(思考込み)で
content="OK"。 users/tagsは|-区切りの文字列。作者は表示名@handle形式(例ひさやん@hisayan。そのまま保存 = クレジット用)。licenseType: 1→ 作品ページ表示「CC BY 4+」(id=1 のページと照合済み)。取得時はライセンスのある作品だけ保存。- 作品ページURLは
https://protopedia.net/prototype/<id>。カタログ総数は 5,100件超(正確な総数は未測定)。 data/sample-prototypes.json12件取得 →data/current-candidates.json候補6件生成 → 両方ともnpm run validate-dataで検証済み。
未検証:
-
deploy.yml/sync-prototypes.yml/rotate-candidates.ymlの実動作 — push後のActions実行結果で確認(ローカルではYAML構文・スクリプト単体・決定的選出テストのみ確認)。 -
releaseFlgのenum値の意味(観測値は常に 2。欠損=公開扱いの暫定実装)。 - ProtoPedia APIのレート制限・1レスポンスの件数上限(ページ間隔100msで暫定対応)。
- Cloudflare Workers AI の本番生成(テキスト接続は確認済み=上記。以下は未検証)。
-
flux-1-schnellの応答(result.imageの形式・width/height非指定時の挙動)— check-ai はテキストのみ確認。 - 本番の抽出(1200)・生成(2500トークン)での推論トークン消費 — 思考込みの予算のため、長文思考で
finish_reason=lengthになる可能性。起きれば検証失敗→再試行→失敗処理に落ちる(安全側)。 - 無料枠・料金・レート制限の現行条件(「1時間に1回なら無料枠内」とは断定しない)。
-
-
breed.ymlの cron 実動作(15分起床・間隔判定・Issueコメント/クローズまで)。ローカルはnpm run breed:dryと単体テストのみ。 -
data/offspring.jsonへのコミットとブランチ保護の兼ね合い — Actions実装時に確認、必要ならPR方式へ。 - GitHub Pages 本番での
/ideas配信 — ローカル preview では/・/ideas/・/ideasすべて200を確認。Pagesの/ideas→/ideas/リダイレクト挙動は未検証(自前リンクは末尾/つきなので影響なし)。 - ブラウザからの匿名 GitHub API ポーリング(申請確認・実験待ち/生成中/誕生の観測)の実挙動 — ローカルではフェッチ注入の単体テストのみ。実ネットワークでのレート制限・CORS挙動は未検証。
- Pages 本番での
dist/data/offspring.json配信(誕生のランタイム検知)— ローカル preview/dev では 200 を確認済み。
npm run dev # 開発サーバー
npm test # パーサー・世代計算・候補選出・フロントのスモークテスト
npm run build # 型チェック + 本番ビルド
npm run validate-data # config/schedule + offspring / prototypes / sample-prototypes / current-candidates /
# breeding-state / element-cache / processed-issues / ai-usage の検証
npm run fetch:sample # ProtoPediaから少数だけ取得 → data/sample-prototypes.json(トークン要)
npm run rotate:candidates # 候補をスロットから決定的に選出 → data/current-candidates.json(トークン不要・設定間隔の枠内ならスキップ / --force で解除)
npm run breed:dry # 配合ワーカーの安全確認(AI・データ書き込み・Issue操作をしない)
npm run breed # 配合ワーカーを本番同様に実行(Cloudflare認証情報が必要)
npm run breed:check-ai # Cloudflare Workers AI の接続確認のみ(1回)
npm run screenshot # 両テーマ×デスクトップ/詳細/モバイル + /ideas一覧のスクリーンショット(tmp/).
├── AGENTS.md # プロジェクト規約(最初に読む)
├── DESIGN.md # デザイン規約(16bit配合研究所)
├── README.md
├── public/ # 公開サイト一式(Viteのroot。ページ・UI・静的ファイル)
│ ├── index.html # / トップ(配合研究所)
│ ├── main.ts # トップのUI(vanilla TS)
│ ├── character.ts # 博士キャラクター表示(状態・スプライト・読み上げ制御)
│ ├── breeding-state.ts # 配合状態判定(申請確認/実験待ち/生成中/誕生の純関数)
│ ├── github-watch.ts # 匿名GitHub APIポーリング(上限・停止条件つき)
│ ├── ideas.ts # /ideas 一覧ページのUI
│ ├── ideas/ # /ideas アイデア一覧(マルチページエントリ)
│ ├── style.css # 16bit 配合研究所テーマ
│ ├── assets/ # ビルド取り込み対象(博士スプライト8枚 透過PNG 135×268)
│ └── static/ # そのまま配信する生ファイル(dist直下へコピー)
│ └── sprites/ # ピクセル絵素材の原本(切り出し元)
├── lib/ # 型・Issueパーサー・世代計算・候補選出・頻度設定(schedule.ts) /
# 配合: blend.ts(プロンプトと出力検証)/ elements.ts(要素抽出とキャッシュ) /
# queue.ts(キュー選択)/ cloudflare.ts(Workers AI)/ usage.ts(利用量)/
# github.ts(Issue対応)/ ProtoPedia/設定(フロント/ワーカー共有)
├── config/ # schedule.json(頻度設定: 候補更新間隔・配合間隔・候補件数 / issue #15)
├── data/ # offspring.json / current-candidates.json / breeding-state.json /
# element-cache.json / processed-issues.json / ai-usage.json / *sample*.json
├── logs/ # 開発ログ(public公開のため秘密情報は書かない / 書式は logs/README.md)
├── scripts/ # process-breeding(配合ワーカー)/ fetch-sample / rotate-candidates / sync /
# validate-data / screenshot / gh / load-env / slice-characters(博士スプライト切り出し)
├── tests/
└── .github/workflows/ # deploy.yml / sync-prototypes.yml(dispatchのみ) /
# rotate-candidates.yml(起床15分固定・間隔はconfig判定) / breed.yml(配合ワーカー)