# 改善の記録 改善項目ごとの内容と、実ブラウザ検証の結果です。「確認」は目視で判別できたこと、「部分確認」は要素の存在は見えたが細部まで判別できなかったこと、「未確認」は条件を変えて複数回試みても判別できなかったことを指します。 ## 初版へのフィードバック対応(2026-10-24) | 項目 | 内容 | 結果 | |---|---|---| | 建物とハトのリアリティ | 窓・階線・反射・建物ごとの色・屋上構造物・街路樹・露出抑制、ハトの精細化 | 実装・納品 | | 観察モードでハトが遠い | 開始位置をハトの近くへ、追跡・リング・矢印・名前タグ・距離表示 | 実装・納品 | | 餌まきの反応が分かりにくい | 大きな粒・光柱・ラベル・接近するハト・反応パネル | 実装・納品 | ## 生態とリアリティの改修(2026-10-24) - **行動配分のリバランス**: 「ハトが飛びすぎている」との指摘を受け、調査と照合して飛行中心の配分を是正。定期飛行は 80〜170 分間隔で群れの 25〜55% の短距離移動のみとし、地上採餌と休息を主役に。地上で座る loafing を追加。 - **場所の用途別ファサード**: オフィス/商業/住宅/低層店舗の 4 種アトラス、屋上広告塔、街灯、電柱・架線、自販機、マンホール、横断歩道、袖看板、高架の桁帯と半透明遮音壁、川面の流れ。 - **季節・気象**: 太陽位置計算(大阪の緯度経度)と日の出・日没連動、季節の自動/手動切替と街路樹・行動の季節変化、天候 6 種と避雨・水浴び・ドリフト等の行動連動、日没連動の窓明かり。 - **至近 LOD**: 嘴・蝋膜、虹彩・瞳孔+眼環、関節・爪付き脚趾、尾羽 12 枚、翼帯の高コントラスト化、遮蔽建物の自動半透明化、生態パラメータの追加修正(hold 比 0.63、二段着陸の原則化など)。 ## 2026-10-30 改善ビルド(9 項目)と検証結果(2026-10-31 実施) 2026-10-24 の実ブラウザ検証で判別できなかった 9 項目すべてに手を入れた改善ビルドを作成し、視点ボタン(路面で見る/川面を見る/高架の遮音壁)を追加。2026-10-31 に公開リンク上で項目ごとに再検証しました。 | # | 項目 | 改善内容 | 検証結果 | |---|---|---|---| | 1 | 電柱・架空線 | 太く増設し、垂れた 4 束の架線チューブ | 部分確認(太い電柱と垂れた束は見えたが束の本数は分離できず) | | 2 | 自販機 | 発光する前面、飲料ウィンドウ、価格帯、投入口、取り出し口 | 部分確認(飲料ウィンドウと取り出し口は見えたが価格帯は距離で読めず) | | 3 | マンホール | ø1.1 m の蓋、二重の縁、下水道の質感、増設 | **確認**(大きな蓋と二重の縁、「下水道」の表示) | | 4 | 横断歩道・車線表示 | 大きく明るいゼブラ、停止線、中央線、矢印 | 部分確認(ゼブラと車線は見えたが停止線・中央線・矢印は個別に判別できず) | | 5 | 半透明の遮音壁 | 橋桁脇に高さ約 2.8 m・不透明度 0.30 のパネル、柱・レール・継ぎ目 | 部分確認(半透明の帯は見えたが柱・レール・継ぎ目は分離できず) | | 6 | 首の虹色光沢 | 飽和した角度依存の緑⇔紫(後述の追加改善で作り直し) | 追加改善後に **確認**(下記) | | 7 | 赤い脚の見え方 | 体高引き上げ、太く鮮やかな赤い脚、左右交互ステップ(後述の追加改善で再作) | 色・太さ・歩行は確認、交互ステップは観察限界で閉鎖(下記) | | 8 | 袖看板の文字 | 支持アームと両面の縦書き文字 | 部分確認(縦書き様の印は見えたが語は読めず、背面と支持アームは未確認) | | 9 | 川面の質感・流れ | 速度の異なる 2 層の流れ筋・反射・波紋 | 部分確認(流れ筋・波紋・反射は見えたが 2 層の分離は判別できず) | ## 首の虹色と脚の追加改善(2026-10-31) - **首**: 方位で回転する緑⇔紫グラデーション+フレネル層に作り直し、範囲を首〜胸へ拡張。再検証(1.9〜3.4 m 接写、3 個体)で、マゼンタ/紫の中心と緑〜シアンの側面を持つ飽和したグラデーションが角度で流れることを確認。以前の「平らなミント色の貼り付き」は解消。 - **脚**: 色を鮮やかな赤(#ea0d0d)に、半径を約 2 倍(0.011 → 0.019)に、体高を 0.34 → 0.42 m に引き上げ。至近 LOD で脚のステップ駆動が止まる除外を撤廃し、ステップ振幅(±0.035 → ±0.06)と持ち上げを増加。再検証で太く鮮やかな赤い脚が地面まで見えることを確認。 ## 左右交互ステップの検証記録(項目 7 の残件) 交互ステップだけは、以下の 4 回の条件変更でも路面視点では読み取れませんでした。 1. **接写フォーカス(×10)**: 対象個体がテレメトリの採餌表示に反して速度 0 km/h で留まり続け、ステップ自体が発生しない。 2. **フォーカスなし・路面視点(×10、餌まき 3 回)**: 歩行と歩行中の鮮やかな赤い脚は確認。距離約 10〜11 m・両脚同色・奥の脚が体の陰になるため、交互の読み取りはできず。 3. **低速のつもりが条件不成立**: 当時ビルドの速度 UI に ×1・×2 がなく ×60 での観察となり、距離約 18〜21 m では脚は点状。 4. **×1・×2 追加後の最終再確認(路面視点、フォーカスなし、餌まき 3 回)**: マル・ミケ・トワの 3 羽が約 9〜14 m で歩行。赤い脚 2 本は確認できたが、脚が数ピクセルで左右・前後の区別がつかず、脚の重なり・体の陰・餌粒の遮りがあり、歩行自体もその場の小刻みな採餌中心で横方向の連続歩行が現れなかったため、左→右→左の交互は読み取れず。 2026-10-31、所有者の判断により、項目 7 は「色・太さ・歩行は確認済み、交互ステップは路面視点の観察条件の限界」として閉鎖しました。これはモデルの欠陥の認定ではなく、ステップ実装が無いことの証拠でもありません(実装自体はソースと QA スナップショットで確認済み)。 ## 検証方法についての記録 - ビルダーの監査ハーネスはソフトウェア WebGL で 15 秒の読み込み上限があり、本作品のデスクトップシーンは初回描画がその予算に収まらず、監査キャプチャは繰り返し失敗しました。この失敗を「未確認」の終端とせず、公開リンクを実ブラウザで開く独立経路で検証する運用に切り替えました(2026-10-30 のセルフレビューによる再発防止)。 - 実ブラウザ検証では、ハーネス計測の実行時刻を正とし、検証条件(視点、速度、フォーカスの有無、餌まき回数、対象個体と距離)を毎回記録しています。 ## リアリティ・スコアカードの策定(R0-1、2026-11-02) リアリティ向上プログラムの物差しとして、docs/realism-scorecard.md を新規に策定した(R0-1、Issue #66)。視点(至近/路面/川面/高架/俯瞰)×観点(外観/行動/環境)の確認項目 30 件(外観 10 件、行動 7 件、環境 13 件)に、それぞれ確認方法(実ブラウザでの観察手順と計測パネルの読み値)と「確認」の基準(要素単位)を定めた。処分の語彙(確認/部分確認/未確認)と視点の定義、性能天井は docs/verification-criteria.md(2026-10-31 制定)からそのまま引き継ぎ、上限値は変更していない。 ベースライン処分は、2026-10-30〜31 に公開リンクを実ブラウザで開く経路で確認された記録だけを根拠とした。内訳は次のとおり。 | 処分 | 件数 | 項目 | |---|---|---| | 確認 | 6 件 | E-01 首虹色、E-02 脚の色・太さ、E-09 至近の既存要素、E-10 俯瞰の全体描画、B-07 歩行、V-09 マンホール | | 部分確認 | 6 件 | V-07 電柱・架空線、V-08 自販機、V-10 横断歩道・車線表示、V-11 半透明の遮音壁、V-12 袖看板の文字、V-13 川面の質感・流れ | | 未確認 | 18 件 | E-03 脚の立体形状、E-04 羽毛の微細変調、E-05 個体差の第 3 層、E-06 モーフ模様・配分、E-07 眼の角膜光沢、E-08 首テクスチャ共有化、B-01 頭部運動、B-02 採餌の多様化、B-03 離着陸遷移、B-04 群れの同期とばらつき、B-05 静止時の微動、B-06 頭のサッケードと注視、V-01 影の柔らかさと環境光の反射、V-02 大気の奥行き、V-03 路面と川面の濡れ・きらめき増強、V-04 ファサードの経年変化と個体差、V-05 夜間の街路光、V-06 周辺グラウンド質感 | 実ブラウザ確認の記録がない項目はすべて「未確認」とし、理由と次の手(スコアカード検証バッチでの確認)を各項目に書いた。未確認を「確認済み」「部分確認」とは書いていない。 性能ベースラインは、2026-11-01 時点の静的実測ベースの到達点として totalNodes 3977(上限 4046 の内側)、geometries 645(上限 683 の内側)、programs 42(上限 45 の内側)を引用した。これらは本スプリントで再計測した値ではない。実行時の計測パネルによる再計測は、スコアカード検証バッチ(R4-1)で行う。 注記: - 左右交互ステップは D1 で閉鎖済みのため、本書でも判定対象外とした(項目 B-07 の注記)。歩行の足運び・タイミングには触れていない。 - realism-roadmap.md の「目的」第 1 項にある首の虹色の記述(平坦なミント色パッチ)は 2026-10-30 改善ビルドの状態(2026-10-31 午前の作り直し前確認で観察)を指すものであり、2026-10-31 午後の作り直し後の再検証による「確認」を本書のベースライン処分とした。ロードマップ目的節の文言更新は別途の整理事項とし、Issue #66 のスプリント記録コメントに残す。 - 本スプリントは文書の起草のみで、ビルドへの変更はない。実ブラウザ目視が要る視覚受入はスコアカード検証バッチ(R4-1)へ送る。 ## R1-1 首虹色の視角依存シフト(Issue #67) - 目的: 現行の首はグラデーション texture+fresnel sheen+視線方位係数で駆動されているが、構造色が視線方位のみに依存し光源方向を無視していたため、カメラ固定で個体が太陽に対して向きを変えても色が流れない状態だった。これを解消する。 - 変更内容: 既存の首 sheen シェーダ(`src/scripts/pigeons.js` の `makeNeckSheenMat()`)に太陽方向 uniform `uSunDir` を追加し、half-vector の NdotH で hue mix 係数 `t` を `(ndh-0.5)*0.35`(±0.175 の範囲)だけ変調した。テクスチャ回転は現行維持で、変更は既存 ShaderMaterial の式拡張のみ。太陽方向は `src/scripts/simulation.js` の `updateSkyEnv()` で既存の `_sunDir`(Sky ドームと同一、季節・天候の太陽位置ロジック由来)を各鳥の既存 neck sheen マテリアルへ毎フレーム複写するもので、新規の太陽計算系はない。プログラム・ノード・テクスチャの追加はなく、静的サイト数は ShaderMaterial 9→9、Mesh 84→84、CanvasTexture 28→28、Geometry 95→95(いずれも +0)。 - ビルド: `tools/build.py` で再生成。4,908,323 bytes、git blob `e89d38a9974bb6457d3b37d02691dc72117a1f10`、SHA-256 `20f1c80faa2b9b563ed11258304d99fb422bb838bd9f0857358a4c8d038e2024`、決定論的再ビルド一致、inline script 6 本の `node --check` 合格。 - 受入への対応見込み: 至近(2〜5 m)でカメラ角を変えたとき、首の色が緑〜紫方向へ連続変化する設計。計測パネルでの programs・totalNodes +0 は静的差分で確認済みだが、ランタイムの確定計測(計測パネル値、最悪条件のフレーム時間 520 ms 内)は検証バッチで行う。 - 専門レビューによる追加受入観点の訂正: グルーミング反映コメントの「カメラ固定で個体が頭を振る場面」は、首シェルが体幹グループ bodyG の子で headG の回転が及ばない機構のため、文字通りには成立しない。検証バッチの試験は「カメラ固定・体幹 heading の変化」へ訂正し、Issue #67 へ訂正コメント 6569813919 を記録した。Issue #67 本体の受入条件(カメラ角を変えたときの連続変化)は変更しない。太陽項単独の確認には、同一 heading・同一カメラで太陽幾何だけを変える差分試験(停止または ×1)を検証バッチで用いる。逆光の degenerate case(L+V のゼロ正規化)へのガードは提案として次回以降の同シェーダ改修へ申し送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 ## R1-2 足の形状と色の実体化(Issue #68、外観監査 A3) - 目的: 現行の基本脚は MeshBasicMaterial の平らな赤で、至近・路面視点で脚が色の帯にしか読めず、鱗の立体感がなかった。脚の太さ・色は 2026-10-31 改善で到達済みのため、本単位の主眼は無陰影の平坦さの解消(陰影・鱗感)である。グルーミング反映コメント 6568213360 に従う。 - 変更内容: `src/scripts/pigeons.js` のみ、3 か所(脚以外のマテリアル・形状には触れていない)。 1. SHARED_LEG_MAT を MeshBasicMaterial から MeshStandardMaterial へ変更。色は純赤 0xea0d0d を維持し、roughness 0.6(隣接する角質系の既存値=嘴 0.55・眼環 Hi 0.6 と整合)を選んだ。脚の位置・形状・オフセット計算は変えていない。 2. 鱗状の横縞を描いた共有テクスチャ `legScaleTex`(手続き生成の CanvasTexture 128×128、外部素材なし)を新規作成し、基本脚(tarsus)に bumpMap として流用した(bumpScale 0.02、P5 の翼 barb 細線と同じ値)。円筒 UV の u が周方向・v が高さ方向のため、横縞は 16 px ごとに暗い溝+明るい稜線の 8 段とし、 faint な縦 seams を加えて鱗の区切りとした。データテクスチャのため sRGB エンコーディングなし。共有 1 枚のみで個体ごとに増やさない。同一共有マテリアルを使う足板・足首球にも同じ bump が及ぶ(マテリアルを分割しない最小変更のため)。 3. 至近 toe の SHARED_TOE_MAT の emissiveIntensity を 0.85 から 0.35 へ適正化した。色(0xe80d0d)・emissive 色(0x7a0404)は変えていない。 - D1 厳守: 歩行の足運び・タイミング・ステップ関連コード(pigeons.js の stepping 周り、脚の位置・オフセット計算)には一切触れていない。差分は上記 3 か所のみで、stepping ブロックの差分はない。 - ビルド: `tools/build.py` で再生成。4,910,708 bytes(変更前 4,908,323 bytes、+2,385 bytes)、git blob `f7d0f1ad0c4bb4e34899e603be0cf66bf2262476`、SHA-256 `a754645b204ad7acb5b1d49bcecdddb547421566238c30321fd2d2f387b898bc`、決定論的再ビルド一致(`tools/build.py verify` 合格)、inline script 6 本の `node --check` 合格。 - 静的計測(変更前 → 変更後、grep ベース): pigeons.js の Material ctor は MeshBasic 9→8・MeshStandard 31→32(総数 43→43、+0)、CanvasTexture ctor は pigeons.js 9→10・全 src/scripts 28→29(+1、共有 1 枚のみ)、Geometry ctor は pigeons.js 47→47(+0、新規メッシュ・形状なし)。構造上限との照合(docs/verification-criteria.md): totalNodes は新規メッシュなしのため静的 +0、geometries +0、textures は静的 +1 で上限 88 の内側、programs は下記の静的判断を参照。 - programs への静的判断(ランタイム確定値は検証バッチで計測): 既存シーンに「Standard+bump のみ(map・roughnessMap・vertexColors・normalMap なし)」の組み合わせは存在しない。既存の bump 使用はすべて map+roughnessMap 付き(体・翼・尾・首 Physical)であり、色のみの Standard とも異なるため、脚の新バリアントは静的には新規プログラム +1 の見込みである。Basic プログラムは眼・瞳孔・眼環など他の Basic マテリアルが残るため消えない。したがって +0 の成立条件は静的には満たさない見込みで、2026-11-01 時点の到達点 programs 42 から 43 への見込みとなり、上限 45 の内側ではある。検証バッチで計測パネルの programs を読み、43 以下(上限 45 内)であることを確認すること。+0 を厳密に求める場合は、体と同じ map+roughnessMap 付きの組み合わせに寄せる設計変更が必要になるが、拡散色の見え方が仕様外に変わるため本スプリントでは行っていない。スプリントレビューでの判断事項として申し送る。 - 受入への対応見込み: 至近(2〜5 m)および路面視点で、脚が平らな赤帯ではなく陰影のある柱として読め、鱗の横縞が陰影として判別できる設計。至近 toe は自発光感が弱まり、基本脚との輝度差が縮まる設計。計測可能な条件(構造量・天井照合)は静的差分で上記のとおりだが、ランタイムの確定計測は検証バッチで行う。 - 訂正(QA 再計測による): 当初の静的計測表は文字列出現数で数えたため MeshStandard 32→33・総数 45→45 と記載していたが、厳密な ctor 数え(`new THREE.X(`)では 31→32・総数 43→43 が正しい。差分(MeshStandard +1、総数 +0)は変わらない。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 ## R1-3 羽毛の微細変調(斜光の艶と羽方向)(Issue #69) - 目的: 羽毛の roughnessMap(P5 導入の共有 1 枚)は ±14 の細かいストライプと ±8 の全体グラデーションのみで、斜光下で艶の方向性と羽方向の読みが弱かった。均一なプラスチック状の見え方にならないよう、平均粗さをほぼ変えずに変調の振幅と緩やかな成分を強める。 - 変更内容: `src/scripts/pigeons.js` の `featherRoughTexture()` とそのコメントのみ。他ファイルのロジック変更なし。数値は次のとおり。 1. ストライプ振幅 ±14 → ±29。ベース値を 230 から 226 へ移し、明 255/暗 197 の対称振幅とした(230 のままでは +29 が 255 を超えるため)。ストライプの周期(約 6 px)・線幅(3 px)・barb 流れ方向(moveTo(x,256) → lineTo(x+58,0))は変更なし。 2. barb 流れに沿う第 2 の粗い変調を追加。24 px 幅の斜めバンドを 24 px 間隔で明暗交互に描き(明暗 1 周期 ≈48 px、ストライプ周期の約 8 倍)、0.039 のアルファの白・黒ストロークを重ねた。アルファ合成の実効値は対称な ±10 ではない(専門レビュー指摘により訂正。ストライプ平均 226 を基準に白バンド +1.1、黒バンド −8.8、緩やかな変動幅 peak-to-peak ≈9.9。実質はほぼ原値のバンドと約 9 値暗いバンドの交互)。アルファ合成のため値は 0〜255 の範囲内に収まり、クリッピングによる平坦化はない。 3. 平均粗さの移動は合計 ≈−7.8 値(ベース移動 −4 値+バンド交互の平均シフト −3.8 値。スカラー 0.85〜0.95 を掛けた実効粗さで −0.026〜−0.029、約 3%)で、現行の艶レベルをほぼ維持する(専門レビュー指摘により「−4 値」の記述を訂正)。 4. 全体グラデーション(±8)は変更なし。スカラー roughness・マテリアル種・bumpMap・シェーダには触れていない。 - 含めないもの: A6(翼 Lo テクスチャの 512 px 化)はコーディネーター判断で本スプリントに含めない(Issue #69 コメント 6571156157 に判断と理由を記録済み)。翼テクスチャの解像度変更、bumpMap の変更、スカラー roughness の変更、シェーダの新規追加は行っていない。 - D1 厳守: 歩行の足運び・タイミング・ステップ関連コードには一切触れていない。差分は上記関数のみで、stepping ブロックの差分はない。 - ビルド: `tools/build.py` で再生成。4,911,973 bytes(変更前 4,910,708 bytes、+1,265 bytes=コメント・コードの追加分がそのまま inlined されたもの)、git blob `66b8d1227dcbb62223a2b66952e07a458cae30e8`、SHA-256 `7de6e31404b6da3cc29eb5ff662ccfe663585987adb656ce8158a29df67ecc7e`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html から抽出)の `node --check` 合格。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/ 配下を同一方法で計測): CanvasTexture 29→29、MeshStandardMaterial 40→40、MeshBasicMaterial 20→20、ShaderMaterial 9→9、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)94→94、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。新規テクスチャ/プログラム/ノード/ジオメトリ/マテリアル種の組み合わせはなし。数え方はテキスト上のコンストラクタ出現数であり、ループによる実行時インスタンス数ではないため、絶対値ではなく差分を主とする。なお R1-2 のログ記載(src/scripts 基準 28→29)と本単位の変更前 29 は、R1-2 のマージ済みツリーを起点としているため整合する。 - 受入への対応見込み: 計測可能な静的受入(新規要素 +0、ビルド再現性、inline script の構文チェック)は満たす。視覚受入(路面・至近視点で光の角度により羽毛の艶が変化し均一なプラスチック状に見えないこと)と、最悪ケースを含む 6 条件の性能天井内であることは、本スプリントでは実ブラウザ計測ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 ## R1-4 個体差の第 3 層(模様シード・体格・姿勢)(Issue #70) - 目的: P7(#22)の第 2 層(モーフ×3 バリアント+首クラス)を超えて、路面視点で群れを見たときに隣り合う個体がコピーに見えないようにする。模様の位相・体格・姿勢の 3 軸を、既存の共有テクスチャ/マテリアル/形状だけを使って個体ごとに振る。 - 変更内容: `src/scripts/pigeons.js` のみ、5 か所。他ファイルのロジック変更なし。 1. 模様シード: P7 バリアント表を 3 相から 5 相へ拡張。uOff を 0.00/0.20/0.40/0.60/0.80(テクスチャ 1 周の 0.20 刻み)、jitter を 0.96/0.98/1.00/1.02/1.04(P7 の ±0.04 帯の内側に維持)とし、割当ては P7 と同じ spreadIndicesP7(等重み 5、24 羽で 5・5・5・5・4 羽、系列は 0・1・2・3・4 の繰り返しで index 上の隣接は必ず相が異なる(鳥スロットはランダム割当てで鳥は移動するため、index 順は空間的な隣接と一致せず、空間的に隣り合う個体同士の相の相異は保証されない。検証バッチでは空間的に隣り合う個体対で判定すること))。uOff のずれは既存の p7ShiftUV(customProgramCacheKey='p7uv' で全オフセット変種が同一プログラムを共有)で与えるため、新規テクスチャ・新規マテリアル種の組み合わせ・新規プログラムはなし。各鳥は従来どおり共有のモーフ×バリアント項目を 1 つだけ使うため、相異なる項目数は 24 羽以下に bounded される。 2. 体格: bodyG.scale を (s, 1, s) とし、s は 0.94/0.98/1.02/1.06(±6%、平均 1.00)の 4 段階を spreadIndicesP7(等重み 4、6 羽ずつ、系列は 0・1・2・3 の繰り返し)で割り当てる。y を 1 に固定したのは、脚・足の y 位置を一切スケールせず、すべての足が従来どおり BODY_Y で正確に接地するためである(脚長・オフセットの補正は行わない。均一スケールでは ±6% で足が (s-1)×BODY_Y ≒ ±25 mm 浮く/沈むため採用しなかった)。高さは変わらず、体格差は胴の太さ・長さとして読める設計。体格の周期 4 に対し模様の周期 5 のため、(模様, 体格) の組み合わせは 20 通りを循環する。 3. 姿勢: 胸前出しクセとして、首と胸パッチの z 位置をともに r14Chest(0/0.004/0.008 m、表示スケールで 0〜12.8 mm)だけ前方へずらす。割当ては spreadIndicesP7(等重み 3、8 羽ずつ)。animate() は neck.scale と headG を書き換えるが neck/breastPatch の position は書き換えないため、クセは毎フレーム維持される。遠距離 LOD の首は固定位置のままのため、胸クセは至近の手がかりであり、路面視点での読みは主張しない。なお歩行中の脚の z 位置は毎フレーム絶対値で書かれるため、体格スケールは脚の x(脚間隔)・z(スイング振幅)に ±6% の継承スケールとしてのみ及び、歩行の位相・タイミング・振幅定数には触れていない。 4. 検証用の露出: makePigeonMesh の返却オブジェクトに r14Size・r14Chest を追加した(動作への影響なし)。 5. 3 軸の組み合わせは 24 羽すべて相異なる(spread 関数を 24 羽で実行して確認。(模様, 体格, 胸) の三つ組は 24 通り)。ただし模様の位相自体は 5 値しかないため、index 上で隣接しない同モーフの鳥同士で位相が一致することはあり得る。コピー感の解消は三つ組全体(モーフ+位相+首クラス+体格+姿勢)で担う。 - 含めないもの: 個体ごとの新規テクスチャ、個体ごとのマテリアル複製、鳥ごとの新規メッシュ・形状、頭部の静的チルト(headG の回転・位置は毎フレーム書き換えられるため静的クセとして成立しない)、体幹の静的ヨー(進行方向とのずれとして読まれるため不採用)、高さ方向の体格差(上記の接地理由で不採用)。 - D1 厳守: 歩行の足運び・タイミング・ステップ関連コード(pigeons.js の stepping ブロック、脚の位置・オフセット計算の定数 LEG_Y/ANK_Y/FOOT_Y、スイング振幅 0.06・持ち上げ 0.034、bobPhase 位相)には一切触れていない。差分は上記 5 か所のみで、stepping ブロックの差分はない。脚まわりの変更は bodyG の plan スケールによる継承のみで、脚の y(接地)は不変である。 - ビルド: `tools/build.py` で再生成。4,915,080 bytes(変更前 4,912,300 bytes、+2,780 bytes=コメント・コードの追加分がそのまま inlined されたもの。専門レビュー要修正の文言訂正を含む)、git blob `8d0ff9049d663c9381e594d6a7a07853d8977149`、SHA-256 `393a43f688ac8dd31cf520feae9b2d7c5ee4414dd1e2d981bafeb2d93071d048`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html から抽出)の `node --check` 合格。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/ 配下を同一方法で計測): CanvasTexture 29→29、MeshStandardMaterial 40→40、MeshBasicMaterial 20→20、ShaderMaterial 9→9、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)94→94、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。新規テクスチャ/プログラム/ノード/ジオメトリ/マテリアル種の組み合わせはなし。数え方はテキスト上のコンストラクタ出現数であり、ループによる実行時インスタンス数ではないため、絶対値ではなく差分を主とする。注記: simulation.js の variantCounts パネルは初期配列が 3 要素だが、JS 配列の自動拡張により 5 相の件数も正しく数えられるため、本スプリントでは同ファイルに触れていない。 - programs への静的判断(ランタイム確定値は検証バッチで計測): 新規の uOff 値(0.20/0.40/0.60/0.80)を持つ変種はすべて既存の p7ShiftUV 経路で customProgramCacheKey='p7uv' を共有し、uOff=0 の変種は従来どおり無修飾のため、プログラムの新規追加は静的にはない。2026-11-01 時点の到達点 programs 42 から増加しない見込みで、上限 45 の内側である。検証バッチで計測パネルの programs を読み、42(上限 45 内)であることを確認すること。 - 受入への対応見込み: 計測可能な静的受入(新規要素 +0、ビルド再現性、inline script の構文チェック、24 羽の維持=NAMES 24 羽・新規メッシュなし、D1 遵守)は満たす。視覚受入(路面視点で空間的に隣り合う個体の模様・体格差が読め、どの個体も他個体のコピーに見えないこと。胸クセは至近でのみ判定すること)と、計測パネル値(programs・totalNodes 等)のランタイム確定計測は、本スプリントでは実ブラウザ計測ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 ## R1-5 モーフ模様の実体化・第2弾(Issue #83、外観監査 A2) - 目的: checker の翼チェック斑を鱗状に強化し、pied の胴に白斑を実体化して、路面視点で blue bar 個体と並んだ状態でもモーフが判別できるようにする。配分是正は現行 main の実態確認により既達として扱い、weight は変更しない(下記「前提差異」参照)。 - 前提差異(現行 main の実読による Issue 前提の訂正): - checker の翼チェック斑は既に存在する(drawWingPattern/drawWingPatternFar の patches()、雨覆部のみの楕円パッチ、Lo alpha 0.5/Far 0.75)。本単位で行うのは楕円から鱗状への形状強化のみで、バー位置・本数は不変。 - pied の白斑は従来「翼テクスチャ上の blobs」のみで、胴(bodyTex 系)には白斑がなかった。これが本単位の主たる未達であり、新規に胴変種を作る。 - モーフ配分は既に重み付きである(MORPHS の weight と buildMorphAssignment により 24 羽で blue-bar 8、blue-checker 6、t-pattern 4、spread-black 2、red 2、pied 1、white 1。blue bar+checker で 14/24 の過半)。Issue の「全モーフ均等」という前提は現行 main では成立しないため、weight・順序・body 色は変更しない。配分は既達として記録する。 - 変更内容: `src/scripts/pigeons.js` のみ。`index.html` は `tools/build.py` の再生成物。 1. pied の胴テクスチャ変種: drawPiedBodyBlobs(固定 8 斑、各斑は主楕円+衛星フレーク 2 個で不規則な輪郭に)と bodyPiedTex(Lo、bodyTex 画像に mid-grey ウォッシュ rgba(52,54,60,0.38) を重ねてから白斑 rgba(246,245,238,0.96) を描く)を追加。共有 bodyTex の素地が近白(#f2f2f0)のため、ウォッシュなしでは白斑はモーフ色の乗算後に読めない。ウォッシュ後の素地は他モーフの明度帯に収まる。白斑の範囲は肩〜腹(キャンバス y 約0.27–0.96、楕円の広がりを含む実到達。球体上=キャンバス上が mantle 側という既存の対応に従う)。morphMatsFor で pattern==='pied' の場合のみ bodyLo/breastLo に bodyPiedTex、bodyHi/breastHi に bodyPiedTexHi を使う。pied は pattern 'pied' を持つ唯一のモーフのため、模様クラス単位のキャッシュとして 1 対で足り、P7 バリアントごとの増加はない。Hi 変種は ensureHiTextures() 内で bodyTexHi の実キャンバス生成直後に同ウォッシュ+同斑レイアウト(1024 単位空間)で描くため、Hi の細部がウォッシュ下で維持される。遠距離 LOD の trunkFar は全モーフ共通で bodyTex のまま(遠距離で白斑は読めないためテクスチャ増を抑える判断。コメントに明記)。 2. checker の鱗状強化: drawWingPattern/drawWingPatternFar の checker 分岐のみを変更し、楕円 patches() から scallops()(6×5 グリッド・市松選択・雨覆部のみ cx>0.76*S 除外は維持)へ置き換えた。鱗は平頂・下縁丸みのタイル形状で、行高の 1.15 倍の高さを持ち下の行と重なり、下の行から先に描くことで上の鱗が下の鱗に重なる。下縁には淡いリム線(alpha の 0.4 倍)を引き、重なりが 1 つの染みではなく鱗の重なりとして読めるようにした。バーは現行のまま(Lo: 位置・alpha 不変、Far: 拡幅・alpha 1.0 の現行則を維持)。新規テクスチャは増やさず、既存キャンバスの描き直しのみ。tpattern/red の patches() は変更なし。 3. 含めないもの: MORPHS の weight・順序・body 色の変更、バー位置・本数の変更、ジオメトリ・ノードの追加、新規マテリアル種・プログラムの追加、翼 pied blobs・頭部テクスチャの変更、trunkFar の変更。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コード(pigeons.js の stepping ブロック、bobPhase 駆動)には一切触れていない。差分は上記の胴変種・鱗状・Hi 派生・マテリアル選択のみで、stepping ブロックの差分はない。D4(r128 のまま)、D5(単一 HTML)、D6(手続き生成のみ)も維持。 - ビルド: `tools/build.py` で再生成。4,921,250 bytes(変更前 4,915,080 bytes、+6,170 bytes=コメント・コードの追加分がそのまま inlined されたもの)、git blob `35ef065adb811ad5071aa82070b5671d5dbe020a`、SHA-256 `cd9dc81dc91bc768fb41b492664cad4c9d601c3e2860be398a059322a8a9757e`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html から抽出)の `node --check` 合格。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/ 配下を同一方法で計測): CanvasTexture 29→29、MeshStandardMaterial 40→40、MeshBasicMaterial 20→20、ShaderMaterial 9→9、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)94→94、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。コンストラクタ出現数は新規テクスチャが既存ヘルパー(featherTexture/hiPlaceholderTex)経由で作られるため変わらない。実行時テクスチャインスタンスは pied Lo+Hi の +2 のみで、基準の最大 73 に対し 75 見込み(+4 以内・上限 88 内)。新規プログラム・新規ジオメトリ・新規メッシュはなし。形状変更なしのため avgTriangles は実施前と同値の見込み。 - 受入への対応見込み: 計測可能な静的受入(テクスチャ増 +2・上限 88 内、形状変更なし、ビルド再現性、inline script の構文チェック、D1 遵守)は満たす。視覚受入(路面約 10m で checker 個体の翼にチェック斑・pied 個体の胴に白斑が blue bar 個体と並んだ状態で判別できること、至近 2〜5m で斑の縁が滲みではなく模様として読めること)と、計測パネル値(textures・avgTriangles 等)のランタイム確定計測は、本スプリントでは実ブラウザ計測ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 ## R1-6 眼の角膜光沢(Issue #84) - 目的: 至近(1.9〜3.4 m)で視点を左右に振った際に両眼のハイライト位置が移動して読め、目が描いただけの平坦なものに見えないようにする。P6 の要素(目・嘴・眼環)の判別が退行しないこと。 - 前提差異(現行 main の実読による Issue 前提の訂正): Issue 本文の「ハイライトがなく描いた目になる」は監査時点の見立てであり、現行 main には P6(Issue #21)で既に透明な角膜キャップ(SHARED_CORNEA_MAT、MeshPhysicalMaterial、clearcoat 1.0、opacity 0.25、envMapIntensity 0.3、眼球より一回り大きい球)が close-LOD の眼球上に存在する。したがって本単位はキャップの新設ではなく、下記のパラメータ変更のみでハイライトの読みを強める。キャップ自体には触れていない。 - 変更内容: `src/scripts/pigeons.js` のみ、3 か所。色・テクスチャ・ジオメトリ・メッシュ数は一切変えていない。 1. 虹彩 roughness 0.25 → 0.08(SHARED_IRIS_MAT、close-LOD の眼球のみ)。色 0xffffff・irisTex マップは不変。新規マテリアルなし。 2. close-LOD 瞳孔の扁平化(pup.scale.set(0.55,1,1))と位置の外側移動(x 0.0585 → 0.0620)。x は外側方向で、球(半径 0.0078)を外側方向に薄くし、眼球表面上の円盤として読ませる。扁平化だけでは瞳孔外面が 0.06279 となり、瞳孔中心高さでの眼球前面 0.06471 より内側に埋没して不可視になるため(専門レビュー指摘 M1、コーディネーターが数値再計算で確認)、位置を外側へ移動して外面を 0.06629 とし、眼球前面からの突出を +0.00158(変更前 +0.00159)、角膜キャップ前面からの突出を +0.00026(変更前 +0.00027)に復元した。ジオメトリ・色・マテリアルは不変。 3. close-LOD 眼環 roughness 0.6 → 0.85(SHARED_RING_HI_MAT)。色 0xd9d0bf・ジオメトリは不変。0.85 は近傍の質感値と整合させた値で、close-LOD の cere(0.85)と同値、基本の cere(0.9)に近い粉質の帯にある。 - 含めないもの(スコープ外と理由): 基本 LOD の瞳孔(SHARED_PUPIL_MAT、MeshBasic の小球)は受入距離(至近 1.9〜3.4 m)の主対象が close-LOD のため変更しない。基本 LOD の眼環(SHARED_RING_MAT)は MeshBasic のため roughness パラメータ自体がなく対象外。基本 LOD の眼(SHARED_EYE_MAT、MeshBasic)も同様に変更しない。角膜キャップの新設・パラメータ変更は、機構が既存のため行わない。 - キャップ越しの見え方についての判断: 移動するハイライトの主因はキャップ側(clearcoat+環境マップ、opacity 0.25 の透明シェル)で、視点移動に伴いハイライト位置が動く構造は既にある。虹彩 roughness を 0.08 へ下げると、キャップの下の虹彩自身のスペキュラがより鋭く・強くなる。キャップの opacity は 0.25 と薄いため虹彩は覆い隠されず、虹彩のグラデーション模様は読めたまま、鋭い二次的な光沢が重なってハイライトの移動が判別しやすくなる設計である。瞳孔の扁平化は出っ張った玉感を抑えつつ、位置の外側移動で黒中心の突出(変更前と同等)を保ち、眼球表面上の円盤として読ませる。眼環をよりマットにすることで、光沢のある眼球と粉質の眼環のコントラストがつき、P6 の目・嘴・眼環の判別が保たれる設計である。 - 白飛びリスクについての所見: リスクは低いと判断する。理由は (a) キャップは opacity 0.25・envMapIntensity 0.3 と P6 で控えめに設計されており、本単位はキャップ側を強めていない、(b) 虹彩は無地の白ではなくグラデーションの irisTex マップ付きで、拡散輝度は上がらない(roughness 低下はスペキュラの鋭さ・強さのみに効く)、(c) 拡散光の増加や emissive の追加は一切ない、(d) 瞳孔はほぼ黒(0x0d0a08)のままで眼の中心の暗さが残り、眼環はよりマットになるため、眼全体が白く抜ける方向には働かない。ただし強い直射光の角度では眼球上に小さな鋭いスペキュラ点が出る可能性があり、個体ごとの白飛びの有無は実ブラウザ目視で確認する(下記「視覚受入」参照)。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コードには一切触れていない。差分は上記 3 か所のみで、stepping ブロックの差分はない。D4(r128 のまま)、D5(単一 HTML)、D6(手続き生成のみ、新規テクスチャなし)も維持。 - ビルド: `tools/build.py` で再生成。専門レビュー指摘 M1 の修正後の最終値は 4,922,792 bytes(変更前 4,921,296 bytes、+1,496 bytes=コメント・コードの追加分がそのまま inlined されたもの)、git blob `4b5fc5a6d8cb5cbfc9ed8fa53b764d97e888d99f`、SHA-256 `483f8a026f068bf37506e81ca7de1ef23c37420b6b9cbb356424bbc1a8e402f6`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html から抽出)の `node --check` 合格。修正前のビルド値は 4,922,371 bytes、blob `0e5c97ba49ea5afca976278a78e585751c3556a9`、SHA-256 `d396ab9d06ea0b355e2e5e5038abbd8ff9c5b18eb701a7d535f31ad4b774c11f` だった。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/ 配下を同一方法で計測): CanvasTexture 29→29、MeshStandardMaterial 40→40、MeshBasicMaterial 20→20、ShaderMaterial 9→9、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)94→94、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。数え方はテキスト上のコンストラクタ出現数であり、ループによる実行時インスタンス数ではないため、絶対値ではなく差分を主とする。マテリアル種の組み合わせ・テクスチャ・ジオメトリ・メッシュの新規追加はなく、瞳孔の扁平化は既存メッシュの scale 変更のみのため、programs の新規追加も静的にはない見込みである。 - 受入への対応見込み: 計測可能な静的受入(新規要素 +0、ビルド再現性、inline script の構文チェック、D1 遵守)は満たす。計測パネル値(totalNodes/programs/geometries/textures)のランタイム確定値が実施前と同値(±0)であることは、本スプリントでは実ブラウザ計測ができないため未確認とし、検証バッチで計測パネルを読み照合すること。視覚受入(至近で視点を左右に振った際の両眼ハイライト位置の移動の判別、P6 要素の判別の退行なし、白飛びする個体なし)も同様に未確認とし、検証バッチ(R4-1、Issue #80)へ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 ## R1-7 首テクスチャ共有化によるテクスチャ予算の回収(Issue #85、外観監査 A5) - 目的: 全羽が同一の首 canvas から個別テクスチャを生成して計測パネルの textures を24圧迫していた最大の単一消費源を、共有1枚へ寄せて予算を回収し、R1-5 など質感チャネル追加の受け皿にする。 - 前提確認(現行 main の実読): Issue の前提は成立する。`src/scripts/pigeons.js` の neckCanvas はモジュールレベルで1回だけ生成されるが、`makePigeonMesh()` 内で羽ごとに `new THREE.CanvasTexture(neckCanvas)` が実行され、24羽で24インスタンスになっていた(同一ピクセルに対する24回の GL アップロード)。外観監査の留保(スナップショット基準)については、作業ツリーが main そのものであるため本線 src/ との突き合わせは満たされる。 - 変更内容: `src/scripts/pigeons.js` のみ、10ハンク。`index.html` は `tools/build.py` の再生成物。 1. 共有テクスチャ: neckCanvas 直後に `SHARED_NECK_TEX`(`new THREE.CanvasTexture(neckCanvas)`、wrapS Repeat・sRGB・anisotropy 8=従来の羽ごとの設定と同一)をモジュールレベルで1回だけ生成し、`makePigeonMesh()` では `const neckTex=SHARED_NECK_TEX` とする。map+bumpMap+emissiveMap の3スロットは従来どおり同一インスタンスを指す。ピクセル・色・bumpScale・roughness・metalness は不変。 2. per-frame の offset 書き換えを廃止: `animate()` の `m.neckTex.offset.x=vf*0.5+(m.neckPhase||0)` を削除し、共有テクスチャの offset は全羽共通の固定値 0 とする。共有インスタンスへの書き込みは全羽の首を同時に動かすため、残すことはできない。`mesh` 返却オブジェクトから `neckTex` フィールドを除去した(他に参照箇所はなく、setCloseLOD/setFarLOD は首テクスチャに触れない)。 3. sheen 側の補償(個体差と視点スイープ): `makeNeckSheenMat()` に静的 uniform `uPhase` を追加し、生成時に P7 と同じハッシュ `hash(pi*57+13)` から `(neckPhase-0.5)*0.5`(±0.25、ミックス範囲の半分)を設定する。視点スイープ係数は `(uShift-0.5)*1.05` → `*1.45`(±0.525 → ±0.725)へ増強し、テクスチャ回転が担っていた視点方向の色の流れを sheen 側の補償で担う(完全な再現ではない。第5項の限界参照)。空間 sweep 係数 0.95 と太陽項 (ndh-0.5)*0.35 は不変。R1-1 の uSunDir 機構(simulation.js の updateSkyEnv() が羽ごとの sheen マテリアルへ複写)は untouched。 4. 残した per-bird 処理と理由(コメントに明記): neckMat は羽ごとに残す(クラス tint と、毎フレーム羽ごとに書き換える emissiveIntensity がマテリアル属性のため)。neckSheenMat は羽ごとに残す(uShift は毎フレーム羽ごと、uSunDir は updateSkyEnv が羽ごとに複写、uPhase とクラス係数 uA/uB/uHi は羽ごとに設定)。共有したのはテクスチャのみで、マテリアルを共有すると羽同士が1インスタンスを奪い合って虹色が壊れる(旧 B3 注記の趣旨はテクスチャを除いて維持)。 5. 補償の限界の明記: テクスチャ帯の回転そのものを sheen で完全に再現することはできない(sheen のミックスは emerald⇄violet の線形混合で、テクスチャの帯回転とは別キャリア)。したがって本単位では3バリアントへの fallback は採用しなかった。理由は、共有1枚だけで受入の −20 を満たす見込み(−23)があり、バリアントは静的な位相しか増やさず sheen の uPhase が既に担っているためである。視覚受入(検証基準書 項目6「確認」の維持)は静的には主張せず、検証バッチの目視判定に委ねる。 - 含めないもの: 首以外のテクスチャ、far-LOD の neckFar(mapless、無変更)、歩行の stepping ブロック、R1-1・R1-5 との同一スプリント化(本単位単独で処分を記録する)。D4(r128 のまま)、D5(単一 HTML)、D6(手続き生成のみ)も維持。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コード(pigeons.js の stepping ブロック、LEG_Y/ANK_Y/FOOT_Y、スイング振幅・持ち上げ、bobPhase 位相)には一切触れていない。main との unified diff は10ハンクすべて首まわり(ヘッダ注記・sheen シェーダ・B3 注記・makePigeonMesh 首ブロック・返却オブジェクト・animate 首ブロック)で、stepping・脚に言及する差分行はゼロ。 - ビルド: `tools/build.py` で再生成。4,926,690 bytes(変更前 4,922,792 bytes、+3,898 bytes=コメント・コードの追加分がそのまま inlined されたもの。セルフレビュー指摘の旧注記訂正を含む最終値)、git blob `789007c7b6f201f22b12d94d1bf1e5af29649d7c`、SHA-256 `eb208972d9fa2cafad4cc25d937de3e219cba287735ff4fd5f1b246509687638`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html からスクリプトタグ境界で抽出)の `node --check` 合格。 - 静的計測(変更前 → 変更後、grep ベースの `new THREE.*` コンストラクタ出現数、src/scripts/*.js を同一方法で計測): CanvasTexture 29→29、MeshStandardMaterial 40→40、MeshPhysicalMaterial 2→2、MeshBasicMaterial 20→20、ShaderMaterial 9→9、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)94→94、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。コンストラクタ出現数は生成箇所の数であり、ループによる実行時インスタンス数ではないため、首テクスチャの実行時インスタンスは別に数える: 変更前は makePigeonMesh 実行24回で24インスタンス、変更後はモジュールレベル IIFE 1回で1インスタンス。差分 −23。同一テクスチャオブジェクトは r128 で1回の GL アップロードとして数えられるため、計測パネルの textures は同一視点で −23 の見込みで、受入条件の −20 以上を静的に満たす見込みである。programs は静的に +0 の見込み(sheen シェーダの式は改訂したが、鳥ごとの違いは uniform 値のみで新規プログラムを生まない。uSunDir・uShift と同じ扱い)。 - 受入への対応見込み: 静的に満たすもの=テクスチャ生成箇所の共有化(24→1、−23見込み)、ビルド再現性、inline script の構文チェック、D1 遵守、単独処分。ランタイム実測待ちのもの=同一視点 snapshot での textures −20 以上の実測、boot.texturesReady の実施前同等以下(共有化でアップロードが23回減り、per-frame の offset 書き込みも減るため、増加する方向の要因は静的にはない)、検証基準書 項目6(首)の「確認」維持の目視。いずれも本スプリントでは実ブラウザ計測ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 ## R2-1 頭部運動の生体化(Issue #71) - 目的: 歩行・採餌中の頭の動きを、等速往復の機械的な往復から「止まってから素早く前に出る」リズムとして判読できるものにする。対象は頭・首のみで、歩行の足運びには触れない(D1)。 - 前提確認(現行 main の実読): 頭部運動は `src/scripts/pigeons.js` の歩行ブロックで、歩行位相 `bobPhase`(歩行距離駆動、HEADBOB.stride 0.115 m/サイクル)から `headG` の前後位置 `hz` を決める。従来の波形は区分線形で、hold 相(ph < 0.63)で +A から −A へ直線的に戻り、thrust 相(残り 37%)で −A から +A へ直線的に戻るものだった。時間配分自体は既に非対称(63/37)だが、両相とも等速のため往復が機械的に読めるのが未達である。頭グループ `headG` は体幹グループ `bodyG` の子で、首シェルは `bodyG` の子のため headG の回転は首に及ばない(R1-1 専門レビュー指摘の機構)。したがって本単位の可動部は headG の位置・回転のみで、首の付け替えや再ペアレントは行わない。テレメトリの head-bob 表示(hold 63%/thrust 37%)は HEADBOB.holdRatio から算出されるため、holdRatio を変えない限り表示は変わらない。 - 変更内容: `src/scripts/pigeons.js` のみ、2 ハンク。`index.html` は `tools/build.py` の再生成物。 1. 時間配分は不変: holdRatio 0.63(hold 63%/thrust 37%)、stride 0.115、breakSpeed 0.81、振幅 A=0.02 m(崩壊時は 0.22 倍)はすべて変更なし。歩行位相からの駆動(bobPhase の歩行距離による進行)も変更なし。頭の位相を歩行位相から切り離す変更はしていない。 2. thrust 波形の非対称化: hold 相は直線のまま(頭の世界空間速度を体幹速度の約0.45倍で一定に抑える近似として、体幹相対の後退は等速が物理的に正しい。hold 中の頭の世界移動は +0.03245 m(体幹 +0.07245 m に対し)で静止ではない)。thrust 相のみ、直線から三次 smoothstep `s(t)=t*t*(3-2*t)`(t は thrust 区間内の正規化位相)へ変更した。端点は連続(hold 終端 −A=thrust 始端 −A、thrust 終端 +A=次サイクル hold 始端 +A)。thrust 両端の速度は 0、中間のピーク速度は直線平均の 1.5 倍となり、頭が後方で留まってから素早く前に出て前方で落ち着くリズムになる。数値検証(node による波形評価): ph=0 で +0.02000、ph=0.315 で 0.00000、ph=0.63 で −0.02000、thrust 中間 ph=0.815 で 0.00000、ph→1 で +0.02000。ピーク勾配/直線平均勾配=1.500。 3. 変更しないもの: 垂直ディップ `hy = -|sin(ph*π)|*0.004`、ついばみ・飲水・水浴び・羽繕い・止まり時の頭姿勢、headYaw(サッケード系は R2-6 の対象)、脚の stepping ブロック、bobPhase 駆動、テレメトリ表示式。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コード(pigeons.js の stepping ブロック、LEG_Y/ANK_Y/FOOT_Y、スイング振幅・持ち上げ、bobPhase 位相)には一切触れていない。main との unified diff は2ハンクすべて頭部運動ブロック(HEADBOB 注記と歩行頭部ブロック)で、stepping・脚に言及する差分行はゼロ。D4(r128 のまま)、D5(単一 HTML)、D6(手続き生成のみ、新規テクスチャなし)も維持。新規マテリアル/テクスチャ/ジオメトリ/メッシュはゼロ。 - ビルド: `tools/build.py` で再生成。4,928,259 bytes(変更前 4,926,690 bytes、+1,569 bytes。専門レビュー要修正の記述訂正コミット後の最終値。専門レビュー前の初回値は 4,928,097 bytes・blob `7f83a358…`)、git blob `bcb23d3e765ad3bc0d37b7287b8814ea25492f79`、SHA-256 `ba73efc1281c61e6d7d13a4deda18303e6f78def96da8b4020af9def438bc205`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html からスクリプトタグ境界で抽出)の `node --check` 合格。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/scripts/*.js を同一方法で計測): CanvasTexture 29→29、MeshStandardMaterial 40→40、MeshPhysicalMaterial 2→2、MeshBasicMaterial 20→20、ShaderMaterial 9→9、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)94→94、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。波形変更は既存変数の式の置き換えのみで、コンストラクタ・メッシュ・ジオメトリ・プログラムの新規追加は静的にはない。programs は上限 45 の内側(現行 42)の見込み。 - 受入への対応見込み: 計測可能な静的受入(波形の端点連続とピーク速度比の数値検証、ビルド再現性、inline script の構文チェック、D1 遵守)は満たす。受入 (2)(足運びに変更がないこと)は差分ゼロで満たす見込み。受入 (1)(路面・至近視点で「止まってから素早く前に出る」リズムとして判読できること)は、本スプリントでは実ブラウザ目視ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。検証バッチでの確認方法: 路面(約 9〜15 m)および至近(2〜5 m)で歩行・採餌中の個体を ×1・×2 で観察し、頭が後方で留まってから素早く前に出るリズムが等速往復と区別できることを判定すること。判定は通常歩行(0.28〜0.5 m/s)の個体で行い、速度が breakSpeed 0.81 m/s を超えて振幅が 0.22 倍に崩壊する個体(群れ活動時 0.95 m/s・feedRush 時 1.6 m/s 等)は除外すること。テレメトリの head-bob 表示(hold/thrust)はタイミングの判別記録にはならない(スコアカード B-01 注記)。計測パネル値(programs・totalNodes 等)のランタイム確定計測も同様に未確認とし、検証バッチへ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 ## R2-2 採餌行動の多様化(Issue #72) - 目的: B4(#8)で実体化した餌粒への反応を一段上げる。ついばみの深さ・速さの個体差と、粒を選ぶ動き、空振りを入れる(グルーミングコメント 6568243140、行動専門監査 提案2が実施内容の確定版)。 - 前提確認(現行 main の実読による既達・未達の切り分け): - 既達(壊さない): 発火時の計数(pecks は発火時のみ加算、peckHits は餌クラスタ有効時かつ中心 4.2 m 以内のみ加算。探索ついばみ=空振りは計数レベルで既に区別されている)、発火間隔のばらつき(クラスタ有効時 0.3–0.85 秒、それ以外 1.4–4.2 秒の乱数)、移動レベルの対象選択(餌クラスタへの収束は優位性順の内側半径で既に実装)、フィード表示の従来条件(state==='forage' かつ 4.6 m 以内の eating 計数)。 - 未達(本単位で実装): (1) ついばみ波形が単一正弦パルス(peckAnim を dt*3.2 で減衰、振幅 hpitch 0.95/hz 0.03/hy -0.035 固定)で全個体一律、底での保持がない、(2) 命中と非命中の見た目の区別がない、(3) 粒のある方向へ頭が向く仕組みがない(静止時の頭はランダムな headYawT のみ)。 - 変更内容: `src/scripts/pigeons.js` のみ、3 ハンク(変更箇所は4か所)。`index.html` は `tools/build.py` の再生成物。 1. 個体パラメータ(コンストラクタ): peckRate rand(0.85,1.30)、peckHold rand(0.06,0.12) 秒、peckDepth rand(0.85,1.15)、peckHit フラグ(初期 false)、peckShake(初期 0)。位相変数のみで、テクスチャ/プログラム/ジオメトリ/メッシュの追加なし。 2. 3相波形(頭部ブロック): 旧 `sin` パルスを「速い突き下ろし(0.08/peckRate 秒=約80 ms、61.5–94.1 ms)→ 底での保持(peckHold=60–120 ms、そのまま)→ 引き上げ(0.12/peckRate 秒)」に置き換えた。各相は S 字カーブ(突き下ろしは (1-cos)/2、引き上げは (1+cos)/2)で、端点は連続(k: 0→1→保持→0)。振幅は peckDepth 倍(hpitch 0.8075–1.0925、hz 0.0255–0.0345、hy -0.0298–-0.0403)。数値検証(波形レプリカ評価): rate=1・hold=0.09 で total 0.2900 秒、k は 0→0.5(突き下ろし中間)→1.0(底)→1.0(保持中間)→0.5(引き上げ中間)→0。rate=0.85・hold=0.12 で total 0.3553 秒、rate=1.30・hold=0.06 で total 0.2138 秒。 3. 命中フラグと飲み込み頭振り: 発火時に命中判定を peckHit として保持し、peckHits の加算条件は変更なし(従来式と同一)。引き上げ終了直後に、命中かつ state==='forage' の場合のみ peckShake=1(0.22 秒で1周期の横方向頭振り、振幅 0.14 rad)を1回入れる。非命中は保持のみで頭振りを出さない。計数はアニメーション側では一切触らないため二重計数はない。state 条件は、水浴び・プレイヤー経路の peckAnim=1(発火計数を伴わない)が先行する命中フラグで頭振りを誤発しないためのガードである。 4. 粒への頭向き(発火時): 餌クラスタ有効時に、最も近い粒(crumbCluster.crumbs の着地点 .to、150 粒を発火時のみ走査)への方位を headYawT に設定し、体幹 heading からの差を ±1 rad にクランプする。ついばみ中(peckAnim>0)および頭振り中(peckShake>0)はランダムな頭スキャン(headYawT の再抽選)を抑止し、狙いがついばみを通して維持される。非クラスタ時のついばみは従来のランダムスキャンのまま(狙う粒がないため)。 5. 変更しないもの: 発火間隔・計数条件・フィード表示条件・スナップショットの pecks/peckHits 項目、歩行の head-bob(R2-1 波形)・飲水・水浴び・羽繕い・止まり時の頭姿勢、headYaw のサッケード系(R2-6 の対象)、脚の stepping ブロック、bobPhase 駆動、テレメトリ表示式。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コード(pigeons.js の stepping ブロック、LEG_Y/ANK_Y/FOOT_Y、スイング振幅・持ち上げ、bobPhase 位相)には一切触れていない。main との unified diff は3ハンクすべてついばみ・頭部まわりで、stepping・脚に言及する差分行はゼロ(diff の step/leg/foot/ankle 検索で 0 件を確認)。 - ビルド: `tools/build.py` で再生成。4,930,960 bytes(変更前 4,928,259 bytes、+2,701 bytes=コメント・コードの追加分がそのまま inlined されたもの)、git blob `22f0f679e857ca1164c9a91a61427a12bab350ba`、SHA-256 `603ad9055b8a607fd4af2d22d50f6624eab0932a6bf34b113fc490903ba3ea7f`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html から抽出)の `node --check` 合格、src/scripts/pigeons.js 単体の `node --check` 合格。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/scripts/*.js を同一方法で計測): CanvasTexture 29→29、MeshStandardMaterial 40→40、MeshPhysicalMaterial 2→2、MeshBasicMaterial 20→20、ShaderMaterial 9→9、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)94→94、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。programs は静的に +0 の見込みで上限 45 の内側(現行 42)。 - 受入への対応見込み: 計測可能な静的受入(3相波形の端点連続と時間配分・振幅範囲の数値検証、発火時計数の不変、ビルド再現性、inline script の構文チェック、D1 遵守、構造量 +0)は満たす。受入 (1)(路面視点で複数個体のついばみの速さ・深さが一様でなく、粒のある方向へ頭が向くこと)およびグルーミングの受入観点(路面 9–15 m と至近 2–5 m で底保持と命中後の頭振りが判別でき、非命中個体に頭振りが出ないこと、フィード表示の従来条件の維持、スナップショット計数の発火時のみ加算)は、本スプリントでは実ブラウザ目視・ランタイム計測ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。検証バッチでの確認方法: 餌まき後に路面(9–15 m)と至近(2–5 m)で複数個体を ×1・×2 で観察し、速さ・深さの個体差、底保持、命中後の頭振りの有無(非命中個体に出ないこと)、粒方向への頭向きを判定すること。フィード表示の eating 計数とスナップショットの pecks/peckHits が発火時のみ加算されることを、餌まき前後で照合すること。計測パネル値(totalNodes/programs/geometries/textures)のランタイム確定計測も同様に未確認とし、検証バッチへ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 - 専門レビュー指摘の反映(コメント 6577951585): 新規ついばみ発火時に `p.peckShake=0;` を1行追加し、前回の頭振りの残留テールが非命中ついばみの引き上げ終了後に残らないようにした。水浴び経路のクリア提案は本スプリントでは採用せず、将来候補として記録に留める。コード変更はこの1行のみで、stepping・脚・bobPhase 駆動には触れていない。 ## R2-3 離着陸遷移の実体化(Issue #73) - 目的: 飛び立ちと着陸の遷移を、瞬間移動的な速度変化ではなく、沈み込み→跳躍、減速→フレア→接地の流れにする。グルーミングコメント 6568242829(行動専門監査 提案1・3)が実施内容の確定版。 - 前提確認(現行 main の実読による既達・未達の切り分け): - 既達(壊さない): 2段階着陸(確認止まり→最終目標)、到着条件(目標まで 1.6 m 以内、approach 腿を除く)、離陸の個体別開始遅延(stateT<0 の staggered wait、群れは idx×0.13 秒)、離陸→飛行の遷移(stateT>1.15)、離陸操舵目標(前方 7 m/s+上昇 3.2 m/s、上限 12 m/s)、ついばみ 3 相波形(R2-2)・歩行頭部波形(R2-1)。 - 未達(本単位で実装): (1) 着陸姿勢が二値切替(descend 中は尾扇スケール常時 1.5、ピッチは速度式のみ)で、最終進入の立ち上がりがない、(2) 接地直後の体の沈み込みがなく、状態遷移と同時に姿勢が切り替わる、(3) 離陸に沈み込み相がなく、移動開始と同時に操舵が始まる、(4) 離陸直後の羽ばたき振幅に包絡がない。 - 変更内容: `src/scripts/pigeons.js` のみ。`index.html` は `tools/build.py` の再生成物。 1. 個体パラメータ(コンストラクタ): takeoffCrouch(フォールバック 0.23、takeoff ごとに setState で rand(0.18,0.28) に再抽選)、takeoffJumped、takeoffEnvBeats、settleT、_flare、_crouching。位相スカラーのみで、テクスチャ/プログラム/ジオメトリ/メッシュの追加なし。 2. 着陸フレア(descend 最終進入のみ): 現在の着陸目標(最終目標または確認止まり)までの 3 次元距離 d からフレア係数 flare=clamp(1-d/4,0,1) を導く。旋回待機(landDelay>0)と高高度の approach 腿では flare=0。d=4 m で 0、d=0 m で 1、端点連続。 3. フレア姿勢: 機首上げピッチ加算 pitch-=flare×0.35(最大約 20 度。モデルは +Z 前方のため rotation.x 正が機首下げで、フレアは負方向への加算になる。符号の導出根拠は PR 本文参照。実ブラウザでの頭上がりの確認は検証バッチへ送る)、尾扇スケール 1+0.5×flare(旧 descend?1.5:1 の二値切替を廃止し、1→1.5 へ漸進)、脚の前方出し 0.005+flare×0.06(最大 +0.06)。旋回・approach 中の尾扇は 1.5→1 に変わる(意図した変更。二値切替の廃止に伴うもので、最終 4 m 以外では扇を広げない)。 4. 接地とセトル: 到着条件(d<1.6)・到達点・操舵目標は変更しない。最終着陸・確認止まり着陸・failsafe 着陸の 3 か所すべてで、状態遷移直後に settleT=0.4(実アニメーション秒:速度設定によらず。stateT+=dt は timeScale の scaling を受けない)を立て、体の沈み込み −0.025×(settleT/0.4) を線形減衰させる。接地時の速度処理(vel=0)は従来どおり。 5. 離陸クラウチ: staggered wait(stateT<0)の後に、takeoffCrouch(0.18–0.28 実アニメーション秒、個体別。速度設定によらず)のクラウチ相を入れる。クラウチ中は速度 0・操舵なし・翼は畳んだまま(fold を 1 へ保持)で、体を −0.02 下げる。クラウチ終了の最初のフレームで跳躍として vel.y=4.5 を与える(操舵目標の鉛直 3.2 m/s より強く、上限 12 m/s の内側。操舵により目標へ収束する)。離陸→飛行の遷移条件(stateT>1.15)は変更しない。 6. 離陸羽ばたき包絡: 既存機構の最初の 3 拍だけ、振幅包絡 env=1+0.15×(1-beats/3)(beats=0 で 1.15、beats=3 で 1.0、端点連続)を羽ばたき正弦項に掛ける。−0.08 のオフセットはスケールしない。拍数は flapFreqFor 内で新設の takeoffEnvBeats で数え、クラウチ中は flapFreq=0 として拍数を進めない(周波数ランプの takeoffBeats もクラウチ中は凍結し、跳躍から始まる)。専門レビュー要修正 1 による修正:staggered wait(stateT<0)中も takeoffBeats・takeoffEnvBeats の加算を凍結し、周波数だけを返す(返却値はカウンタ凍結時の 8.9 Hz。return 0 ではないため待機中の翼の微振動は止まらない)。これにより群れ一斉離陸でも idx の大きい個体の跳躍後に最初の 3 拍の包絡が残る。takeoffEnvBeats は setState('takeoff') で 0 に戻すため、2 回目以降の離陸でも最初の 3 拍が包絡の対象になる(従来の takeoffBeats は群れ一斉離陸以外ではリセットされておらず、流用すると 2 回目以降の包絡が欠落するため、新設カウンタで分離した)。 - 姿勢の合成順(実装前に決定し、コード内注記と PR 本文に明記): - ピッチ: (1) 速度式ピッチ(既存)→ (2) フレア機首上げ(descend のみ、最大 −0.35 rad)→ (3) 求愛 bow(地上のみ、既存)。加算項は状態で排他のため、同時に生きるのは最大 1 項。 - 体の上下: (1) 休息ディップ(forage+restT、既存 −0.032)+ (2) クラウチディップ(離陸クラウチ窓のみ −0.02)+ (3) セトルディップ(着陸後 0.4 実アニメーション秒のみ、−0.025 から線形減衰)。セトルは状態をまたいで減衰するため厳密には状態排他ではなく、休息ディップとの重なりで最大 −0.057、クラウチディップとの重なりで最大 −0.045 になり得る(一過性)。和として合成する順序を明示した。全ディップは bodyG 全体(脚を含む)を動かす既存の休息ディップと同じ機構で、体が沈む読みになる。 - 尾扇: フレア漸進(descend 最終進入)/求愛 bow(地上)/それ以外は 1。脚: 歩行 stepping(forage+歩行、D1 で不変)/フレア前方出し(descend)/それ以外は従来のリセット値。 - 変更しないもの: 飛行中の経路・到達点の仕様、遷移条件(d<1.6、stateT>1.15、stateT>14 の failsafe、checkT)、群れの個体別開始遅延(stateT<0)、操舵目標・上限・加速度、歩行の足運び・タイミング(D1)、計数・テレメトリ表示式、求愛・飲水・水浴び・羽繕い・止まり時の頭姿勢。プレイヤー鳩の離陸に別経路はなく(現行コードに離陸のプレイヤー分岐はない)、同じクラウチが適用される。D4(r128 のまま)、D5(単一 HTML)、D6(手続き生成のみ)も維持。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コード(pigeons.js の stepping ブロック、LEG_Y/ANK_Y/FOOT_Y、スイング振幅・持ち上げ、bobPhase 位相)には一切触れていない。main との unified diff は着陸・離陸まわりのみで、変更行中の step/bobPhase/LEG_Y/ANK_Y/FOOT_Y/ankle/foot 検索は 0 件。脚の前方出しの変更は stepping 分岐の外側の else 分岐のみ。 - ビルド: `tools/build.py` で再生成。4,936,620 bytes(変更前 4,931,114 bytes、+5,506 bytes)、git blob `dbb22c56c18cd3ba084e97e116597577b46e2c89`、SHA-256 `ecd908bef13164b63d8ad3fcdc88c92d7c7216fe9c5118dcc7c598bfbc561c6e`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html からスクリプトタグ境界で抽出)の `node --check` 合格、src/scripts/pigeons.js 単体の `node --check` 合格。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/scripts/*.js を同一方法で計測): CanvasTexture 31→31、MeshStandardMaterial 44→44、MeshPhysicalMaterial 3→3、MeshBasicMaterial 21→21、ShaderMaterial 12→12、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)92→92、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。programs は静的に +0 の見込みで上限 45 の内側(現行 42)。 - 受入への対応見込み: 計測可能な静的受入(フレア係数・尾扇・脚出し・包絡・セトルの端点連続と範囲の数値検証、遷移条件・操舵目標・開始遅延の不変、ビルド再現性、inline script の構文チェック、D1 遵守、構造量 +0)は満たす。受入 (1)(高架・路面視点で離陸直前の沈み込みと着陸前の減速・フレアが判読できること)およびグルーミングの受入観点(路面約 10 m と至近 2〜5 m で最終進入時のフレア姿勢=頭が上がり尾が扇状に広がることが判別できること、俯瞰・路面で少なくとも 3 羽に「沈み込み→跳躍」の順序が判別できること、t-flap が離陸帯域の推移を維持し t-alt がクラウチの後に上昇し始めること、一斉離陸で従来と同じ総数が飛行へ到達すること)は、本スプリントでは実ブラウザ目視・ランタイム計測ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。ただしグルーミング受入観点のうち「接地位置の瞬間移動が見えないこと」「テレメトリ t-alt/t-dist が接地直前に不連続な跳びを示さないこと」の 2 点は、現行設計(フレア+セトルは姿勢のみ緩和)では成立しない「既知の制限」として記録し直す(詳細は留保の既知の制限の項参照)。検証バッチへ委ねるのは、この 2 点の可視性・重大度の判定である。検証バッチでの確認方法: ×1・×2 で、離陸はクラウチ(体 −0.02、翼畳み)→跳躍→最初の 3 拍の振幅増の順序を 3 羽以上で、着陸は最終約 4 m からの機首上げ・尾扇 1→1.5 漸進・脚の前方出し・接地後の沈み込みを路面約 10 m と至近 2〜5 m で判定すること。×1・×2 推奨の根拠は、クラウチ・セトルが速度設定によらず実アニメーション秒であるため運動が圧縮されるからではなく、デイサイクルとイベント頻度が遅いためである。t-alt/t-dist については接地直前の連続性の成立ではなく、スナップの跳びの可視性・重大度を判定すること。一斉離陸の到達総数を従来範囲と照合すること。計測パネル値(totalNodes/programs/geometries/textures)のランタイム確定計測も同様に未確認とし、検証バッチへ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 - 留保(コーディネーター・専門レビューへの申告): - 到着時の位置スナップ(pos.copy(tgt))は既知の制限として残した。到達点の仕様と遷移条件の変更禁止に従い、着陸点の正確さを維持したためである。フレアとセトルは姿勢の遷移を緩和するが、位置とテレメトリの不連続は消さないため、グルーミング受入観点のうち「接地位置の瞬間移動が見えないこと」「テレメトリ t-alt/t-dist が接地直前に不連続な跳びを示さないこと」の 2 点は、現行設計では成立しないものとして「未確認」ではなく「既知の制限」と記録し直す。数値:通常着陸のスナップは最大 1.6 m(到着条件 d<1.6)。最終進入の速度下限 2.2 m/s での通常の 1 フレーム移動は約 0.037 m(60 fps)のため、スナップはその約 43 倍の跳びを 1 フレームで生じる。t-dist は 1.6 m 未満から 0 へ、t-alt も接近経路によっては最大 1.6 m を 1 フレームで跳ぶ。速度処理 vel=0 も従来どおりで、最大 2.2 m/s の速度不連続が残る。failsafe 着陸のスナップは距離無制限(任意の位置から最終目標へ)だが例外経路である。付帯する残留ポップ:接地フレームで尾扇スケールが 1+0.5×flare(接地直前は flare>0.6 のため 1.3 超)から 1 へ、脚の前方出しが +0.06 から 0 へ、それぞれ 1 フレームでニュートラルへ戻る(従来の二値切替と同じ境界挙動で、フレア漸進では滑らかにならない)。コーディネーター決定:スナップ残留を本単位の既知の制限として明示的に受容し、可視性・重大度の判定を検証バッチ(R4-1、Issue #80)に委ねる。スナップ廃止(到着点が最大 1.6 m ずれる)や到着条件の絞り込みは到達点仕様の変更にあたるため本単位では行わない(再グルーミングが必要)。 - 機首上げの符号(pitch-=flare×0.35)は、モデル前方 +Z・rotation.x 正=機首下げの右手系導出による。導出は確実だが、実ブラウザでの頭上がりの目視確認は未了のため、検証バッチで頭が上がる(沈まない)ことを必ず確認すること。符号が逆だった場合の修正は 1 文字(-= を += に)である。 - 持続時間の訂正(専門レビュー要修正 2):クラウチ 0.18–0.28 とセトル 0.4 は sim 秒ではない。animate() は生の clock dt(上限 0.05 秒)を updatePigeon へ渡し(simulation.js:1645)、pigeons.js 内で timeScale を参照するのは flightSecToday の 1 行のみで、stateT+=dt は無 scaling のため、速度設定によらず実アニメーション秒(60 fps で約 11–17 フレーム/約 24 フレーム)である。×10 以上で圧縮されることはない。×1・×2 推奨の根拠はデイサイクルとイベント頻度が遅いためである。検証バッチは ×1・×2 で観察すること。 - 専門レビュー対応(2026-11-02、PR #99 コメント 6579367633):要修正 1 はコード修正(staggered wait 中のカウンタ凍結、周波数返却は維持)、要修正 2・3 は記述訂正(上記のとおり)。マージは本修正では行わない。 ## R2-4 群れの同期とばらつき(Issue #74) - 目的: 固定スロット+凝集のみで剛体に見える編隊に、個体位相による緩やかな呼吸と、旋回時に外側ほど遅れて伝わる旋回波を入れ、群れ全体の一斉反応の不自然さを下げる。グルーミングコメント 6568243446(行動専門監査 提案4)が実施内容の確定版。 - 前提確認(現行 main の実読による既達・未達の切り分け): - スロット目標の所在: `src/scripts/pigeons.js` の fly 状態ブロック(`updatePigeon` 内)。スロットはコンストラクタで `slot=V3(rand(-1,1),rand(-0.3,0.5),rand(-1,1)).multiplyScalar(rand(3,13))` と一度だけ決まり、以後は書き換わらない(再代入箇所はなし)。毎フレーム、スロットをアンカー方位 `ah` で回転し `ENV.cohesion`(季節係数、simulation.js で winter 0.72/summer 1.06/それ以外 1.0)で拡縮して目標 `_v1` を作る。`simulation.js` に編隊目標の計算はなく、変更は `pigeons.js` のみで足りる。グルーミングの前提「固定スロット+凝集のみ」は正しい(凝集はこの拡縮スカラーのみで、個体別の凝集操舵は存在しない)。 - 既達(壊さない): 離陸の個体別開始遅延(stateT<0 の staggered wait、idx×0.13 秒)、アンカーの経路・速度・方位更新(`anchorUpdate`、方位は dt×0.9 の angLerp)、着陸目標・遷移条件(R2-3 まで不変)、split による分離(`splitSign` で ox+=±16、oz-=8)、逃避の flee オフセット(`escapeT>0 && falcon.active` のとき目標をハヤブサ速度の逆向きに −26、y+4)、分離ループ(3.5 m 以内で (3.5-d)×2.2 の反発、fly/takeoff 個体が対象)。 - 未達(本単位で実装): (1) スロット目標に時間変化がなく、呼吸オフセットが存在しない、(2) 全個体が同じ live のアンカー方位 `ah` でスロットを回転するため、旋回時に内外で伝播遅れがなく、向きの変化が一斉に伝わる、(3) 逃避時の呼吸無効化の仕組みがない(そもそも呼吸がないため)。 - 前提の訂正・留保: (a) `escapeT` 単独は逃避フラグとして信頼できない。`escapeT` は flee 分岐の内側でのみ減算されるため、ハヤブサが非活性化(3 パス完了または 26 秒経過)した時点で残量が凍結し、以後も `escapeT>0` のまま残る既存の挙動がある。したがって呼吸無効化の条件は `escapeT>0` 単独ではなく、flee オフセットが実際に適用される条件と同一の `escapeT>0 && falcon.active` とした。ハヤブサ非活性化と同時に flee オフセットも止まるため、呼吸の再開は操舵状態と一致する。(b) `slotHeading` の初期化はコンストラクタではできない(アンカーは鳩生成より後で定義される)ため、最初の fly フレームで live 方位に遅延初期化し、初フレームの跳びをなくした。fly 再入時(stale な `slotHeading`)の跳びは ±0.35 rad クランプで抑える。 - 変更内容: `src/scripts/pigeons.js` のみ、3 か所(コンストラクタ、anchorUpdate の時計、fly 状態のスロット目標ブロック。diff ハンクとしては 4 ハンク)。`index.html` は `tools/build.py` の再生成物。スカラーのみで、テクスチャ/プログラム/ジオメトリ/メッシュの追加なし。 1. 個体パラメータ(コンストラクタ): `flockPhase=hash(i)*TAU`(既存の `hash()` ヘルパー=build-city.js の `sin` ハッシュ、決定的で鳥の一生を通じて固定。スロット自体は乱数だが、呼吸位相は乱数と切り離してある)、`slotHeading=null`(遅延初期化用)。 2. 呼吸時計: `flockClock` を `anchorUpdate` の先頭(`flockFlying` の早期 return の前)で `dt` ずつ進める。`dt` は animate() の生のフレーム dt(上限 0.05 秒、timeScale の scaling を受けない。R2-3 のクラウチ/セトルと同じ実アニメーション秒)で、毎フレーム 1 回だけ進む。sim 秒で進めた場合、×60 では呼吸が壁時間で 10 Hz 級に振動して「震え」に読めるため、実アニメーション秒を採用した(グルーミング受入観点「高速再生でも震えないこと」への対応)。 3. 呼吸オフセット(fly 状態・非プレイヤー・非逃避のみ): 鉛直 `breathY=0.4*sin(flockClock*TAU/6 + flockPhase)`(振幅 ±0.4 m、周期 6 秒)、横 `breathLat=0.6*sin(flockClock*TAU/7.3 + flockPhase + 1.9)`(振幅 ±0.6 m、周期 7.3 秒、+1.9 rad の位相ずれで両軸が同調しない)。横軸はスロット局所 x 軸(cos slotAh, -sin slotAh)で、スロット回転と同じ基底のため、旋回中も進行方向に対して横であり続ける。プレイヤー鳩(slot 0・自操縦)と逃避中は適用しない。数値検証(レプリカ評価): phase=0 で t=0→breathY 0.000、t=1.5(周期の 1/4)→+0.400、phase=π/2 で t=0→+0.400、t=1.5→0.000。横は t=0・phase=0 で 0.6×sin(1.9)=+0.568。 4. 旋回波(fly 状態・非プレイヤー・非逃避のみ): 各個体が自分の `slotHeading`(アンカー方位の遅延コピー)でスロットを回転する。遅延速度は水平スロット半径 r(cohesion 拡縮後)に応じた `rate=0.9/(1+r/12)`[実アニメーション秒あたり]で、r=0→0.90/s(時定数約 1.1 秒、アンカー自身の旋回速度と同じ)、r=12→0.45/s(約 2.2 秒)、夏季最大 r=19.49→0.343/s(約 2.9 秒)、通常 r=18.38→0.355/s(約 2.8 秒)、冬季 r=13.24→0.428/s(約 2.3 秒)。遅れ角は ±0.35 rad(約 20°)にクランプする。遅れは純粋な回転のためスロットをアンカーへ引き寄せず(半径方向の収縮なし、内向きの潰れなし)、クランプにより各スロット目標の変位は `2·r·sin(0.35/2)≈0.348·r` に抑えられる(夏季最大 r=19.49 m で最大約 6.8 m)。アンカー方位の 1.0 rad ステップに対する遅れ角のピーク(レプリカ評価): r=0→0.368 rad、r=5→0.433 rad、r=12→0.500 rad、r=19.49→約 0.55 rad。すなわち大きな方位ステップではクランプが働き、通常の緩やかな旋回(Δ0.3–0.6 rad)ではクランプ以下で内外差がそのまま波として出る。遅れによる一過性の接近は、変更していない分離ループ(3.5 m 以内で反発)が安全弁として受ける。 5. 変更しないもの: アンカーの経路・速度・方位更新、飛行操舵目標・上限・加速度(steer の 16.5 m/s・11、速度式の 8.2–16 m/s)、分離ループの式と対象、逃避の flee オフセット式と `escapeT` の減算・`splitSign` のクリア、split オフセット、着陸目標・遷移条件・failsafe(R2-3 まで不変)、ついばみ(R2-2)・歩行頭部波形(R2-1)・着陸フレア/セトル/離陸クラウチ(R2-3)、プレイヤー鳩の操縦・スロット 0、計数・テレメトリ表示式。`anchorUpdate` への追加は時計の 1 行のみで、経路・方位・速度の計算は不変。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コードには一切触れていない。main との unified diff は上記 3 か所のみ(+73 行・−2 行)で、分離ループの行は不変。差分中の step/foot/ankle 検索は、コメント内の「waypoint switch」「lockstep」の語のみで、stepping コードへの言及はゼロ。D4(r128 のまま)、D5(単一 HTML)、D6(手続き生成のみ、新規テクスチャなし)も維持。 - ビルド: `tools/build.py` で再生成。4,942,297 bytes(変更前 4,937,826 bytes、+4,471 bytes=コメント・コードの追加分がそのまま inlined されたもの。improvement-log.md は index.html に inlined されないため、ログ追記はビルド値に影響しない)、git blob `aa00b9d39bb70dd5dc863a1af107f069cad05799`、SHA-256 `f0fdd4c5b670eb84aadd590c978e249bb577ec8b1c433b318e2ac62564267fe9`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html からスクリプトタグ境界で抽出。citygeo と build-city の混同を避け、抽出セグメントが 6 本であることを確認)の `node --check` 合格、src/scripts/pigeons.js 単体の `node --check` 合格。実装前のベースライン再生成は main の index.html blob `79d36293…`(4,937,826 bytes)とバイト一致し verify PASS であることを確認済み。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/scripts/*.js を同一方法で計測): CanvasTexture 29→29、MeshStandardMaterial 40→40、MeshPhysicalMaterial 2→2、MeshBasicMaterial 20→20、ShaderMaterial 9→9、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)94→94、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。programs は静的に +0 の見込みで上限 45 の内側(現行 42)。 - 受入への対応見込み: 計測可能な静的受入(呼吸・遅延の式の端点・範囲・クランプの数値検証、分離ループの不変、ビルド再現性、inline script の構文チェック、D1 遵守、構造量 +0)は満たす。Issue #74 の受入条件(飛び立ちが波状に伝播すること。ただし本単位の波は旋回波であり、飛び立ちの波状伝播そのものは既存の staggered wait(idx×0.13 秒)が担う)とグルーミングの受入観点(最悪ケース=飛行 24 羽での calls/triangles/フレーム時間/fps 下限の上限内、俯瞰の追跡視点で旋回時に外周個体の進路変更が内側より遅れて見えること、高速再生でもスロットが潰れて重なったり震えたりしないこと)は、本スプリントでは実ブラウザ目視・ランタイム計測ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。検証バッチでの確認方法: 俯瞰の追跡視点で旋回時に外周スロットの回転が内側より遅れて見えること、×10・×60 でもスロットの重なり・震えがないこと、逃避中(ハヤブサ襲来時)に呼吸によるふらつきが出ず flee 操舵が即時に見えること、飛行 24 羽での計測パネル値(calls/triangles/フレーム時間/fps 下限、totalNodes/programs/geometries/textures)が上限内であることを判定すること。計測パネル値のランタイム確定計測も同様に未確認とし、検証バッチへ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 - 留保(コーディネーター・専門レビューへの申告): - 遅れと衝突のバウンド: クランプは各スロット目標の変位を 0.348·r に抑えるが、内外の遅れ差そのものが一過性の接近を生み得る。分離ループは位置ベースの反発(3.5 m 以内)で、操舵目標の変位を直接は打ち消さないため、接近が 3.5 m 以内に入ったフレームでは反発が働き、操舵が追従する。検証バッチで重なりが観察された場合の次の手は、クランプの縮小(0.35→0.25 rad)が直接的である。分母の変更で遅れを弱めるなら r/12→r/16(分母を大きくすると rate が上がり遅れが弱まる)で、r/8 は逆に遅れを強めるため混同しないこと。 - 逃避無効化の範囲: 呼吸・旋回波の無効化は flee オフセットと同一条件(`escapeT>0 && falcon.active`)のため、ハヤブサ非活性化後に `escapeT` が凍結残存していても呼吸は再開する。これは操舵状態と一致する意図した挙動だが、`escapeT>0` を表示上の「逃げている」と読む箇所(actionVerb)とは読みがずれる。逃避表示と呼吸の対応は検証バッチで併せて確認すること。 - 飛び立ちの波状伝播について: Issue 本文の受入「飛び立ちが全個体同時ではなく波状に伝播する」は、既存の staggered wait(idx×0.13 秒、最大で約 3 秒のばらつき)が既に担っており、本単位はそれを変更していない。本単位の新規の波は旋回波である。受入の読み替えが必要な場合はコーディネーター判断に委ねる。 ## R2-5 静止時の微動(Issue #75) - 目的: 止まっている個体が完全静止で置物に見える状態を解消する。グルーミングコメント 6568243714(行動専門監査 提案6)が実施内容の確定版。(a) 個体位相での呼吸(体幹スケールの微小な周期的変化、0.25–0.4 Hz、求愛の首スケールとは別の箇所に適用)、(b) 静止時間に連動した稀な尾の小振り(約 0.3 秒のパルス)、(c) ねぐら時のみ片側の脚を隠して体をわずかに下げ、一本脚の休息姿勢にする(状態を出るとき復帰、脚の可視制御は既存経路に相乗り)。 - 前提確認(現行 main の実読による既達・未達の切り分け): - 既達(壊さない): 羽づくろい(perch/roost の idle 抽選で 30%・0.8–1.6 秒、頭部 pitch 0.5+headYawT 1.15。`preT`)、頭のサッケード/注視スキャン(perch/roost の idle 抽選と、ついばみ中でない地上静止時のランダムな `headYawT` 再抽選。R2-6 の対象と重なるため本単位では触らない)。Issue 本文の受入「少なくとも2種類の微動」は、既存の羽づくろい+頭スキャンに本単位の呼吸・尾の小振り・一本脚が加わることで満たす見込み。 - 既達ではない(本単位では実装しない・申し送り): 瞬き。現行 main に瞬き機構は存在しない(まぶたメッシュなし、目のスケールアニメーションなし。`blink`/`eyelid`/`lid` の検索は 0 件)。目(ring/eye/pupil)は基本頭部パーツとして至近 LOD では closeHead の別メッシュへ置き換わり、遠方 LOD では farHead へ置き換わるため、スケール式の瞬きでも 3 系統の目メッシュのパリティ検証と至近 2–5 m での判読性証明が別途要る。有限単位に収まらないため本スプリントでは混ぜず、瞬き単独の有限単位として Issue #75 へ申し送る(次の手: まぶた式か目スケール式かの設計判断と、基本/至近/遠方の目パリティ確認を先に行うこと)。 - 未達(本単位で実装): (1) 止まり・ねぐら個体の体幹に周期的微動がなく、羽づくろいの合間は完全静止、(2) 尾の動きは飛行時のフレア(R2-3)・求愛の bow(既存)のみで、静止時の小振りがない、(3) ねぐら個体も両脚表示のままで、一本脚の休息姿勢がない。 - 前提の訂正・留保: (a) `setState('roost')` は現行 main では初期配置(i<8 のみ)だけで、夕刻の帰巣フライトは着陸後に `perch` になる(`finalKind='perch'` → `setState('perch')`)。したがって一本脚姿勢の観察窓は、原則としてシーン開始直後から最初の群れ飛行までの、初期ねぐら 8 羽に限られる。検証バッチは (c) をシーン開始直後(群れ飛行の前)に確認すること。夕刻帰巣後のねぐら個体にも一本脚を出したい場合は、perch→roost の遷移設計そのものの再グルーミングが要る(本単位の範囲外)。(b) `bodyG.scale` について R1-4 の注記「animate() は bodyG.scale を書かない」は本単位で変わる。animate() は毎フレーム bodyG.scale を書くが、 plan 軸のみ `r14Size*(1+breathK)` の合成であり、R1-4 の体格 spread を上書きしない。y は常に 1 のため脚の接地は変わらない(注記自体を本単位で訂正済み)。 - 変更内容: `src/scripts/pigeons.js` のみ。`index.html` は `tools/build.py` の再生成物。`docs/improvement-log.md` に本節を追記。位相スカラーと可視フラグのみで、テクスチャ/プログラム/ジオメトリ/メッシュの追加なし。 1. 個体パラメータ(コンストラクタ): `breathFreq=rand(0.25,0.40)`(個体別・一生固定の呼吸数)、`breathPhase=hash(i+50)*TAU`(個体別・一生固定の位相。R2-4 の `flockPhase=hash(i)*TAU` とは別のハッシュ入力で、静止呼吸と飛行呼吸の位相を切り離してある)、`stillT=0`・`tailFlickT=0`・`nextFlickAt=rand(5,15)`(尾の小振りの scheduling)、`roostHideSide=(i%2===0)?0:1`(一本脚で隠す側の固定。0 = legs[0..2]/closeFeet[0] 側、1 = legs[3..5]/closeFeet[1] 側)。修正で `breathEnv=0`(呼吸ゲート包絡)を追加(下記「修正」節参照)。 2. 呼吸時計: `idleClock` を `anchorUpdate` の先頭で `flockClock` と同じ規則(animate() の生のフレーム dt、上限 0.05 秒、timeScale の scaling を受けない実アニメーション秒、毎フレーム 1 回)で進める。R2-4 の `flockClock` を流用せず別時計にしたのは、将来の飛行呼吸の変更が静止呼吸に波及しないためである(値は同じ規則で進む)。 3. 呼吸(姿勢セクション): 地上・非歩行の個体のみ(`!flying && !(state==='forage' && _walking)`)で、体幹グループ `bodyG` の plan 軸スケールを `r14Size*(1+breathK)`(`breathK=0.015*breathEnv*sin(idleClock*TAU*breathFreq + breathPhase)`、ただし `breathEnv` は下記「修正」節の包絡で、修正前は `breathK=0.015*sin(...)` だった)とする。y は 1 のまま。振幅 0.015 peak(体幹幅の ±1.5%、表示で約 ±8 mm)は人形感に対する上限であり、下げる方向の調整だけを許す(検証バッチで人形感と読まれた場合の次の手は 0.015→0.010)。求愛の首スケール(`neck.scale`、bow による 1.0+bow*0.3 等)とは別の箇所(体幹グループ)で、求愛中も両者は重ならずに合成される(首は bow、体幹は呼吸)。 4. 尾の小振り(perch/roost の状態分岐で scheduling、地上分岐で適用): `stillT` は perch/roost 時間のみを数える(羽づくろい中を含む。羽づくろいは頭チャネル、尾の小振りは尾チャネルで競合しない)。`stillT` が再抽選間隔 `nextFlickAt`(5–15 秒)に達したら `tailFlickT=0.3` を立て、`stillT=0`・間隔を再抽選する。適用は地上・非求愛分岐のみで、基礎回転 0.05 に正弦ハンプ `sin(π*(1-tailFlickT/0.3))*0.18`(最大約 10°、両端 0 で連続)を加える。求愛は bow 回転 0.55 のまま(小振りを読まない)。飛行分岐は `tailFlickT` を読まないため、R2-3 のフレア扇・求愛 bow 扇と競合しない。`setState()` は全遷移で `stillT`・`tailFlickT` をリセットし、間隔を再抽選するため、小振りが飛行へ漏れることはない。 5. 一本脚の休息姿勢(姿勢セクション+脚可視セクション): `roostOneLeg=(state==='roost' && stateT>1.0)` のときのみ、固定側の脚 3 点(leg/foot/ankle)と至近 LOD の対応する jointed toes(closeFeet の同側 1 点)を非表示にし、体を −0.015 下げる。stateT>1.0 のゲートにより、ねぐら入りのフレームで姿勢がポップせず、体の 0.2 lerp で滑らかに入る。`stateT` は無 scaling の実アニメーション秒のため、速度設定によらず約 1 秒後に姿勢が入る。体下げは既存の休息ディップと同じ whole-bodyG 機構で、休息ディップ(−0.032)より小さく、減衰中のセトルディップと重なる場合の最大は −0.040(一過性)。状態を出ると `roostOneLeg` が偽になり、脚の可視と体高は自動復帰する(脚の可視は毎フレームこの条件式で決まるため、復帰のための別処理は要らない)。至近 LOD の flat basic feet(1、4)の close-LOD 退場ルールは、隠し判定の後に従来どおり適用する。 6. 変更しないもの: 状態遷移(perch/roost/forage/court/alert/drink/bathe/perchcheck/takeoff/fly/descend の遷移条件と到達点)、歩行の足運び・タイミング(stepping ブロック、LEG_Y/ANK_Y/FOOT_Y、スイング振幅・持ち上げ、bobPhase 駆動)、R2-1 の頭部 bob 波形、R2-2 のついばみ 3 相波形・命中頭振り、R2-3 のフレア/セトル/クラウチ/羽ばたき包絡、R2-4 の群れ呼吸・旋回波(飛行時のスロットオフセット)、求愛 bow(首スケール・尾扇・ピッチ)、羽づくろい・頭スキャン、計数・テレメトリ表示式。R2-4 との重複なし: 飛行呼吸はスロット目標のオフセット(位置)、本単位の呼吸は体幹スケール(姿勢)でチャネルが異なり、状態ゲート(飛行/地上・非歩行)で排他でもあるため、二重適用はない。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コードには一切触れていない。main との unified diff は上記 8 ハンクのみで、削除行・置き換え行に step/bobPhase/LEG_Y/ANK_Y/FOOT_Y/ankle/foot のコード変更はゼロ(これらの語は本単位のコメント内の「触れない」旨の記述のみ)。脚の可視変更は歩行状態では `roostOneLeg` が偽のため従来式と同一であり、stepping ブロックの位置計算には手を入れていない。D4(r128 のまま)、D5(単一 HTML)、D6(手続き生成のみ、新規テクスチャなし)も維持。 - ビルド: `tools/build.py` で再生成。4,950,159 bytes(修正前 4,948,608 bytes、+1,551 bytes=下記「修正」節のコード・コメント追加分がそのまま inlined されたもの。improvement-log.md は index.html に inlined されないため、ログ追記はビルド値に影響しない)、git blob `7cb8b6b43863983cb5470b9d2383472938b8c311`、SHA-256 `41353d6ec43dc05d97f4a6f561d44e513eea9c4bd072fd0644600453edf32ff0`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html からスクリプトタグ境界で抽出。抽出セグメントが 6 本であることを確認し、citygeo と build-city の混同を避けた)の `node --check` 合格、src/scripts/pigeons.js 単体の `node --check` 合格。実装前のベースライン再生成は main の index.html blob `aa00b9d39bb70dd5dc863a1af107f069cad05799`(4,942,297 bytes)とバイト一致し verify PASS であることを確認済み。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/scripts/*.js を同一方法で計測): CanvasTexture 29→29、MeshStandardMaterial 40→40、MeshPhysicalMaterial 2→2、MeshBasicMaterial 20→20、ShaderMaterial 9→9、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)94→94、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。programs は静的に +0 の見込みで上限 45 の内側(現行 42)。totalNodes・geometries のランタイム値は、構造の追加がゼロのため不変の見込みだが、確定計測は検証バッチへ送る。 - 受入への対応見込み: 計測可能な静的受入(呼吸の振幅上限・周波数範囲・周期・30 秒窓内のサイクル数、尾の小振りのハンプ端点連続と最大角、ねぐらディップの和の上限、位相の非同期、ビルド再現性、inline script の構文チェック、D1 遵守、構造量 +0)は満たす。数値検証(レプリカ評価): 呼吸は周波数 0.25 Hz→周期 4.00 秒・30 秒で 7.5 サイクル、0.40 Hz→周期 2.50 秒・30 秒で 12.0 サイクル、振幅ピーク 0.0150(表示幅変化 約 ±7.7 mm)、scale y は常に 1。尾の小振りは flickT=0.3→回転 0.0500、0.225→0.1773、0.15(中間)→0.2300(基礎 0.05+0.18)、0.075→0.1773、0→0.0500。ねぐらディップは単独 −0.015、セトルとの重なり最大 −0.040。位相は 6 羽の spot check で flockPhase と breathPhase の差が 0.310–0.836(同一位相ではない)。初回小振りは発火 15.05 秒以内・パルス終了 15.35 秒以内で 30 秒窓の内側。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。検証バッチでの確認方法: 至近(2–5 m)で止まり個体を 30 秒以内に観察し、呼吸(体幹の緩やかな膨らみ・縮み、個体ごとに位相がずれていること)と尾の小振り(約 0.3 秒の小さい上下振り)が判別できること、ねぐら個体で一本脚姿勢(片側の脚が見えず、体がわずかに低いこと)が判別できること、呼吸が人形感のあるポンピングに見えないこと(見えた場合は振幅 0.015→0.010 への縮小が次の手)、観察窓の間、止まり数が変わらないこと(本単位は状態遷移に触れていないため、変化があれば本単位外の要因)。(c) の確認はシーン開始直後・最初の群れ飛行の前に行うこと(夕刻帰巣後の個体は perch 状態のため一本脚にならない。留保 (a) 参照)。計測パネル値(totalNodes/programs/geometries/textures)のランタイム確定計測も同様に未確認とし、検証バッチへ送る。 - 申し送り(Issue #75 へ): 瞬きは未達のまま残る。次の手は、まぶた式か目スケール式かの設計判断と、基本/至近/遠方の 3 系統の目メッシュのパリティ確認を先に行い、瞬き単独の有限単位として実施すること。本単位の呼吸・尾の小振り・一本脚とはチャネルが異なるため、混ぜずに分離する。専門レビュー指摘の反映は、専門レビュー担当のコメント後にコーディネーターが本節へ追記する。 - 修正(QA コメント 6583443821・専門レビュー コメント 6583453704 への対応、PR #101 の追加コミット。PR 本文の同名節と同一文言): - 修正1(重大・脚可視のセンチネルバグ): 旧コードの `hideBase=-1` は `hideBase+1=0`・`hideBase+2=1` を有効インデックス化し、非ねぐら時の全地上状態で legs[0](左脚)・legs[1](左足)を常時非表示にしていた。旧主張「状態を出ると脚の可視と体高は自動復帰する」「歩行状態では従来式と同一」は、旧コードでは脚について成立していなかった(訂正)。修正後は隠す集合を明示する `hideSet=roostOneLeg?[side*3, side*3+1, side*3+2]:[]`+`!hideSet.includes(li)` とし、非ねぐら時は全脚表示(close-LOD の flat basic feet 1, 4 の退場ルール分を除く)、ねぐら side 0 で [0,1,2] のみ、side 1 で [3,4,5] のみ非表示となることを数値レプリカで確認した。`closeFeet` 側の式は正しかったため変更していない。修正後のコードでは「状態を出ると自動復帰」は脚についても成立する。 - 修正2(軽微・呼吸ゲートの段差): 旧コードはゲート切替フレームで `breathK` が 0 と `0.015*sin(...)` の間を最大 0.015(約 8 mm)跳んだ。旧主張の「段差の許容」は取り下げ、個体ごとの包絡スカラー `p.breathEnv`(初期値 0)を追加し、呼吸ゲートの目標(on=1/off=0)へ時定数 0.2 秒で `dt`(idleClock と同じ実アニメーション dt、上限 0.05 秒)による指数寄せで lerp させ、`breathK=0.015*breathEnv*sin(...)` とした。数値レプリカではゲート切替フレームの体幹スケール変化は最大 0.01500 から dt 上限時 0.00371・60 fps 時 0.00134 へ縮小した。周波数・位相・振幅上限、R1-4 の体格スケールとの合成(`r14Size*(1+breathK)`)と y=1、尾の小振りの端点連続に変化はない。新規構造量はスカラー 1 個のみで、テクスチャ/プログラム/ジオメトリ/メッシュの追加はない。 - 検証バッチへの申し送り(専門レビュー提案の反映): (1) 必須項目に「非ねぐら地上個体で左右両脚・両足が見えること」を追加すること(修正前コードでは左脚が欠落していたことと対比して確認すること)。(2) 尾の小振りの初回 bound は「発火 15.05 秒以内・パルス終了 15.35 秒以内」に精緻化する(結論は変わらず 30 秒窓の内側)。(3) 歩行停止・歩行開始のフレームに体幹スケールのポップが残っていないこと(修正2の確認)。 ## R2-6 頭のサッケードと注視パターン(Issue #88) - 目的: 現行の頭の向き追従は常時なめらかな平滑処理で、ハト特有の「ピッと動いて止まる」注視がない。これを「角速度制限つきサッケード(時間ベースで目標へ到達)+到達後の注視保持」に変える。行動専門監査 提案5(2026-11-02)が実施内容の確定版。 - 前提確認(現行 main の実読による既達・未達の切り分け): - 頭まわりの既存機構(すべて pigeons.js、他ファイルに headYaw の読み書きなし): 状態量は `headYaw`(現在角)・`headYawT`(目標角、初期値とも 0)。適用は毎フレーム `headG.position.set(0, 0.085+hy, 0.155+hz)`・`headG.rotation.set(hpitch, headYaw*0.8+shakeYaw, 0)` で、表示ヨーは目標の 0.8 倍。旧追従は `headYaw=lerp(headYaw, headYawT, 0.35)` のフレームあたり固定係数で、実時間での到達速度はフレームレート依存だった。旧目標再抽選は 4 か所の確率的サイト(perchcheck の dt×1.4、perch/roost の idleT 抽選、地上静止時の dt×0.7、forage 休息時の dt×0.5)+羽づくろい強制(preT>0 で headYawT=1.15)+R2-2 のついばみ命中時の穀粒照準(±1 rad クランプ)。 - 状態名は現行コードの実名で確認し、新設していない。「警戒」は独立状態 `alert` として存在する(launchFalcon で alertT=1.4 または rand(1,2) 秒で入り、alertT 枯渇で site あれば forage・なければ perch へ戻る)。「着陸前確認」は `perchcheck` 状態で、確認窓は checkT=rand(1.5,4) 秒(到着条件 d<1.6・確認止まり占有時の取消し条件は不変)。したがって Issue の「警戒時は保持を短く+頭上げ」「着陸前確認はその確認窓に合わせる」は、既存状態への対応付けで満たせる。新規状態は作っていない。 - 動く範囲は headG のみ: headG は bodyG の子で頭メッシュ・くちばし・cere・目(ring/eye/pupil)・至近頭部(closeHead)・遠方頭部(farHead)を抱え、首メッシュ(+首シェル)は bodyG の子である。したがって headG のヨー回転は首を動かさない(R1-1 の指摘のとおり)。首の虹彩シェル(視点方位で緑⇔紫)は本単位では触れていない。 - 既達(壊さない): R2-1 の歩行頭部ブロック(hz の hold/thrust 波形、hy の dip、bobPhase の stride 駆動)、R2-2 のついばみ 3 相波形(down/hold/lift)・命中時頭振り(peckShake の正弦 1 周期)・穀粒照準、羽づくろい(hpitch 0.5+headYawT 1.15)、drink(hpitch 0.85)・bathe・roost(hpitch 0.25・hy -0.012)の姿勢、状態遷移とその継続時間(alertT・checkT・idleT・courtT 等の式と初期値)。 - 未達(本単位で実装): (1) 頭の追従がフレーム係数の平滑で、離散的な注視になっていない、(2) 注視保持の間隔に状態差がない、(3) 警戒中の頭上げ姿勢がない。 - 変更内容: `src/scripts/pigeons.js` のみ、6 ハンク(diff +92/-7)。`index.html` は `tools/build.py` の再生成物。`docs/improvement-log.md` に本節を追記。スカラーのみで、テクスチャ/プログラム/ジオメトリ/メッシュの追加なし。 1. 個体パラメータ(コンストラクタ): `headHoldT=0`(現在の注視保持の残り秒。0 は「次のスキャンフレームで新目標を抽選」の意)。 2. `setState()` への追加: `alert`・`perchcheck` への入場時のみ `headHoldT=0` とし、窓の入口で新注視から始める。alertT・checkT そのものと遷移条件は不変のため、テレメトリの状態表示の継続時間は従来どおり。 3. サッケードエンジン(頭部ブロック、旧 lerp 行と旧確率的再抽選の置き換え): 角速度制限 SAC_SPEED=20 rad/s(headYaw 目標空間。表示ヨーは 0.8 倍のため表示上は 16 rad/s)。最大ステップ 2.2 rad(±1.1 幅)で 0.11 秒、典型ステップ約 0.7 rad で約 0.04 秒。すべての時間は animate() の生のフレーム dt(上限 0.05 秒、timeScale の scaling を受けない実アニメーション秒)で定義し、フレーム数は使わないため、サッケード/保持の比率は約 2 fps でも 60 fps でも同一である(必須条件 (3) への対応)。振幅範囲は現行どおり(止まり ±1.1、その他 ±1.0、羽づくろい 1.15、ついばみ照準 ±1.0 クランプ)。 4. 状態別保持間隔(dt 秒、到達後に抽選): alert 0.4–0.9(Issue の指定範囲そのまま)、perchcheck 0.5–1.0(1.5–4 秒の確認窓に複数注視が入る)、perch 0.9–2.2、roost 1.5–3.0、forage 0.7–1.8、その他(drink・bathe・飛行状態等)0.8–1.8。旧確率サイト(perchcheck・perch/roost idleT・汎用 dt×0.7・forage 休息 dt×0.5)はすべて除去し、エンジンが再抽選を一元管理するため、二重抽選による保持の上書きはない。 5. 警戒時の頭上げ(頭部ブロック、alert 状態のみ): hpitch-=0.12(頭をわずかに上げる方向。drink の 0.85=下向き・roost の 0.25 と同符号系で、負側が上げ)+hy+=0.006。alert 以外の状態には適用しない。alertT・出入条件は不変。 6. 干渉回避: ついばみ中(peckAnim>0)・頭振り中(peckShake>0)・羽づくろい中(preT>0)は、保持ゲートなしでサッケード速度のまま照準・姿勢へ向かい、スキャン再抽選は行わない(R2-2 の「ついばみ中は穀粒照準を維持し再スキャンしない」設計を維持し、羽づくろい強制 1.15 も維持)。歩行中(R2-1 の bob が hz/hy を担う)と求愛中はヨーを凍結し、再抽選も古い目標への漂流もしない。歩行頭部波形・stride 駆動・stepping コードには触れていない(下記 D1 参照)。 7. 変更しないもの: 状態遷移とその継続時間(alertT・checkT・idleT・courtT・drinkT・batheT・restT・wanderT 等)、R2-1 の歩行頭部波形、R2-2 のついばみ波形・命中頭振り・計数、R2-3 のフレア/セトル/クラウチ、R2-4 の群れ呼吸・旋回波、R2-5 の静止呼吸・尾の小振り・一本脚、首シェル・虹彩、計数・テレメトリ表示式。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コードには一切触れていない。stepping ブロック(LEG_Y/ANK_Y/FOOT_Y、スイング振幅・持ち上げ、closeFeet 連動)、歩行頭部 bob ブロック、ついばみブロックは main とバイト同一であることを抽出比較で確認した。diff の step/bobPhase の語は本単位のコメント内の「触れない」旨とサッケード変数名(sacStep)のみで、stepping コードへの変更はゼロ。D4(r128 のまま)、D5(単一 HTML)、D6(手続き生成のみ、新規テクスチャなし)も維持。 - ビルド: `tools/build.py` で再生成。4,955,249 bytes(変更前 4,950,159 bytes、+5,090 bytes=コード・コメントの追加分がそのまま inlined されたもの。improvement-log.md は index.html に inlined されないため、ログ追記はビルド値に影響しない)、git blob `362a5891d872348c45bc7895a3606c457bf3bc58`、SHA-256 `4ea354cd8cc87aedd9573d65606d690f40e5f7003f27a6f26a92b166b7ffd00b`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)、inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel、生成 index.html からスクリプトタグ境界で抽出。抽出セグメントが 6 本であることを確認)の `node --check` 合格、src/scripts/pigeons.js 単体の `node --check` 合格。実装前のベースライン再生成は main の index.html blob `7cb8b6b43863983cb5470b9d2383472938b8c311`(4,950,159 bytes)とバイト一致し verify PASS であることを確認済み。 - 静的計測(変更前 → 変更後、grep ベースのコンストラクタ出現数、src/scripts/*.js を同一方法で計測): CanvasTexture 31→31、MeshStandardMaterial 44→44、MeshPhysicalMaterial 3→3、MeshBasicMaterial 21→21、ShaderMaterial 12→12、MeshLambertMaterial 24→24、MeshPhongMaterial 2→2、LineBasicMaterial 1→1、Geometry(`new THREE.*Geometry`)92→92、Mesh(`new THREE.Mesh(`)84→84。すべて差分 +0。programs は静的に +0 の見込みで上限 45 の内側(現行 42)。totalNodes・geometries のランタイム値は、構造の追加がゼロのため不変の見込みだが、確定計測は検証バッチへ送る。 - 受入への対応見込み: 計測可能な静的受入(角速度制限・保持間隔・振幅範囲・警戒頭上げ量の数値、エンジンのレプリカ評価、ビルド再現性、inline script の構文チェック、D1 遵守、構造量 +0)は満たす。数値検証(レプリカ評価): 保持間隔は各状態 20,000 回抽選で alert 0.400–0.900・perchcheck 0.500–1.000・perch 0.900–2.200・roost 1.500–2.999・forage 0.700–1.799・その他 0.800–1.800 の範囲内。alert 1.5 秒窓(dt=0.05、上限フレーム)では 30 フレーム中 27 フレームが静止・3 フレームが移動で、離散性が成立。perchcheck 4 秒窓では 5 個の異なる注視目標が抽選された。ついばみ中は照準を維持しつつサッケード速度で接近し(1 フレームで 0.32 rad 移動)、保持はリセットされる。歩行中はヨー・目標とも不変。Issue の受入条件 (1)(至近 2–5 m の止まり個体と着陸前確認の個体で頭が離散的に動いて止まること、警戒個体が頭を高く保つこと)および (2) のうち路面計測の上限照合は、本スプリントでは実ブラウザ目視・ランタイム計測ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。(2) のうち状態表示の継続時間は、alertT・checkT を変更していないため設計上は従来どおりだが、テレメトリ表示での確定確認も検証バッチへ送る。視覚受入とランタイム計測パネル値(totalNodes/programs/geometries/textures 等の確定値)も同様に未確認とし、検証バッチへ送る。検証バッチでの確認方法: 至近 2–5 m で止まり個体を観察し、頭が「ピッと動いて止まる」こと(連続的な漂いではないこと)と、警戒個体(ハヤブサ襲来時)で頭がわずかに上がっていること、着陸前確認(perchcheck、確認止まりでの 1.5–4 秒窓)で複数回の離散的な頭向き変更があることを判定すること。×1・×2 では実アニメーション秒の保持間隔がそのまま読めること、×10・×60 ではデイサイクルとイベント頻度が速まるだけで頭の離散性は変わらないことを併せて確認すること。計測パネル値が上限内であることも判定すること。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。 - 留保(コーディネーター・専門レビューへの申告): - 旧挙動からの意図した変化 2 件: (a) 歩行中・求愛中のヨーは、旧 lerp による古い目標への漂流から凍結へ変わった。歩行頭部 bob・求愛 bow そのものは不変で、頭の向きが歩行・求愛中に漂わなくなるだけである。(b) 羽づくろい終了直後は保持 0 のため次のスキャンフレームで新目標へサッケードする(羽づくろい姿勢 1.15 からの離散的な復帰)。いずれも本単位の設計意図であり、検証バッチで不自然と読まれた場合の次の手は、(a) は歩行・求愛中の lerp 復活(フレーム係数ではなくサッケード速度での緩やかな追従)、(b) は羽づくろい終了時の短い保持(0.3–0.5 秒)の追加である。 - 既存の癖(変更していない): 羽づくろい中(preT>0)に alert へ入った場合、preT の減算は perch/roost 分岐にしかないため preT が凍結し、alert 中も羽づくろい姿勢が残る既存挙動がある。本単位はその条件分岐に触れていないため、alert 頭上げはその姿勢に加算合成される(hpitch 0.5-0.12)。検証バッチで alert 姿勢として読まれた場合の切り分けに留意すること。 - 計測環境の低速(平均 fps 約 2)について: dt は上限 0.05 秒でキャップされるため、低 fps ではシミュレーション全体が実時間に対して遅く進む(1 フレーム=0.05 実アニメーション秒)。本単位のサッケード/保持はその dt 時間で定義されており、alertT・checkT と同一の時間軸のため、比率としての離散性は fps によらない。実時間での見え方は fps に依存する(上限フレームでは最大ステップが約 2.2 フレーム分にわたる)が、これはシミュレーション全体の時間軸の性質であり、本単位だけの歪みではない。 - 専門レビュー指摘の反映は、専門レビュー担当のコメント後にコーディネーターが本節へ追記する。マージは行わない。 ## R3-1 影の柔らかさと環境光の反射(Issue #76) - 前提確認(現行 main の実読による既達・未達の切り分け): - sun は build-city.js で生成され、初期値は shadow.camera ±170・far 1600・bias -0.0006・mapSize 2048・PCFSoft。simulation.js の updateShadowGate()(B5 ゲート)がメインループで updateCamera(dt) の直後に毎フレーム呼ばれている。パネルの shadow.extentM は 170 の固定値だった。focus()・flockFlying・camera は simulation.js のスコープで既存コードが使っている(updateDaylight・updateCamera の用法と同じ)。 - 本単位の対象はグルーミング反映コメント(環境・性能専門監査 提案4)のうち影カメラの視点適応と normalBias の設定のみ。「環境光の反射」という Issue 題名の反射側は本単位の確定内容に含まれないため実施しない。 - 変更内容: `src/scripts/simulation.js` を中心とし、`src/scripts/build-city.js` の既存コメントへ R3-1 の注記1行を追加。`index.html` は `tools/build.py` の再生成物。それ以外の src ファイルには触れていない。 1. 影範囲コントローラ(shadowGate 近傍): 定数 WIDE=170、NARROW=90、NEAR_Y=20、FAR_Y=40、MIN_HOLD_MS=2000。状態は shadowExtentM=170、shadowExtentBucket='wide'、shadowExtentSwitchMs=-1e9(初回切替は即時)。 2. desiredBucket(): 飛行追跡(flockFlying または focus() の state が fly/takeoff/descend)なら 'wide'。それ以外は camera.position.y <= 20 なら 'narrow'、>= 40 なら 'wide'、帯域内(20〜40)なら現行バケット維持。中心 30m に対し高度 ±10m のヒステリシス帯と解釈する。俯瞰・飛行追跡時は ±170m を維持し、路面・至近では ±90m へ絞って texel 密度を約1.9倍(170/90 = 1.889)にする。CSM 化はしない。 3. applyShadowExtent(extent): sun.shadow.camera の left/right/top/bottom を ±extent に設定し、normalBias を texel 相当に設定したうえで sun.shadow.camera.updateProjectionMatrix() を呼ぶ(r128 の LightShadow は射影行列を自動更新しないため、これが無いと範囲変更が反映されない)。 4. normalBias の式は (2*extent / sun.shadow.mapSize.x) * 0.9。グルーミングの「約0.15m」は広域バケットの texel 相当値と解釈する: 170@2048 → 0.1494m、90@2048 → 0.0791m。狭域バケットの値は約0.08m であり、両バケット共通の 0.15m 固定ではない(この解釈をここに明記する)。ロード直後にも広域バケットの applyShadowExtent(170) を1回呼び、ゲートがバケット変化時にしか apply しないため初回切替まで bias が r128 の既定 0 のままになることを避けた。既存の sun.shadow.bias=-0.0006 は変更しない(bias と normalBias は別パラメータである旨をコードコメントに明記)。 5. updateShadowExtent(nowMs): desired と現行が異なり、かつ nowMs - shadowExtentSwitchMs >= 2000(実時間 performance.now() 基準)の場合のみ apply し、バケットと切替時刻を更新する。現行バケットを返す。 6. updateShadowGate() の先頭で updateShadowExtent(performance.now()) を呼び、due 条件に「バケットが gate の記録と異なる」を追加し、発火時に gate.extentBucket を更新する(gate オブジェクトへ extentBucket:null を追加)。範囲変更は必ず同フレームのシャドウマップ再描画を伴う。 7. applyShadowMapSize() で mapSize が変わった際は、現行範囲に対する normalBias を再計算する(texel は mapSize に依存するため)。normalBias 計算は applyShadowExtent と共有の小関数 shadowNormalBias() とした。参考値: 170@1024 → 0.2988m、90@1024 → 0.1582m。 8. パネルの shadow オブジェクト: extentM の固定値 170 を shadowExtentM へ置き換え、normalBias フィールド(+sun.shadow.normalBias.toFixed(4))を追加した。 - D1 厳守: 歩行の足運び・タイミング・stepping 関連コード、翼・ついばみ等のコードには一切触れていない。pigeons.js は未編集(編集ツールを使用していない)。変更は simulation.js の影ゲート近傍・mapSize 適用・パネル表示の3か所と build-city.js のコメント注記、perf-panel.js の可視パネルへの extentM/normalBias 行の追加のみ。 - 増分目標: calls/triangles/programs/textures/geometries/meshes の静的増分はすべて +0。新規マテリアル・テクスチャ・ジオメトリ・メッシュなし。grep ベースの `new THREE.` 出現数で確認: simulation.js 70→70、index.html 全体 553→553(内訳の先頭も不変: Mesh 84、Color 55、Vector 44、MeshStandardMaterial 40、CanvasTexture 29、MeshLambertMaterial 24)。 - ビルド: `tools/build.py` で再生成し verify PASS。変更前 4,955,249 bytes・blob 362a5891…・SHA-256 4ea354cd… → 変更後 4,959,029 bytes(+3,780 bytes=コード・コメントの追加分がそのまま inlined されたもの)・blob 2568acbdfb1868b8eacfa73bb0241e6cdea7e15f・SHA-256 9f96e8f17ac685510da84ad5fa95ddce3aaf1e0a9eaf941238600a07e4bef9e2。決定性: 2回ビルドがバイト同一で、ディスク上の index.html ともバイト一致。inline script 6本の node --check はすべて合格(タグ境界で抽出し、citygeo+build-city の混ざり罠を回避)。専門レビュー指摘の反映(perf-panel.js への2行追加+改善ログ追記)後の再ビルド: 4,959,147 bytes・blob 41a7731b79bd47f60e25a8565c0c00eacfefcef6・SHA-256 957d1c23da1a2832f55f2fc5c5715779d22f59bfbf18378af60bdae4c5f65b46、verify PASS。 - ロジック検証(レプリカ): 定数・条件をそのまま写したレプリカで8ケース全合格。路面(高度10m)で初回即時 narrow、帯域内(30m)で現行バケット維持、高度45mで wide 復帰、2秒保持未満の切替要求は抑止・経過後に切替、飛行追跡中は高度によらず wide、飛行終了+保持経過で narrow 復帰。 - 受入への対応見込み: 計測可能な静的受入(範囲値・ヒステリシス帯・最小保持・normalBias 計算値・ビルド再現性・inline script 構文チェック・D1 遵守・構造量 +0)は満たす。視覚受入(路面での影の濃さ・柔らかさの変化、俯瞰での範囲維持)とランタイム計測パネル値(shadow.extentM/normalBias の切替表示)は未確認。 - 視覚受入: 未確認。実ブラウザ目視とランタイム計測パネル値の確認は検証バッチ(R4-1、Issue #80)へ送る。 - 留保(コーディネーター・専門レビューへの申告): - normalBias の「約0.15m」は広域バケットの値と解釈し、狭域バケットは約0.08m になる。両バケットで 0.15m 固定にしたい場合は別途判断が要る。 - 飛行追跡の判定は既存の updateCamera と同じ条件式(flockFlying または focus() の fly/takeoff/descend)を使った。群れ飛行でない単独飛行の注目鳩も wide になる。 - 専門レビュー指摘の反映(スプリント内修正): 専門レビュー(PR コメント 6586315934)の要修正2件を反映した。(1) コード修正: 当初、パネルの shadow.extentM/normalBias は __QA__.snapshot() の値としては存在したが、可視パネル(perf-panel.js)は shadow.updates/autoUpdate/framesRendered の3行しか描画しておらず、受入観点「パネルの shadow.extentM が路面で 90・俯瞰で 170 と実値で読める」は可視パネルとして未達だったため、perf-panel.js の snapshot セクションへ shadow.extentM(単位 m)・shadow.normalBias(単位 m)の行を追加し、index.html を再生成した。(2) 記述訂正: 「俯瞰で 170」の検証条件を明確化した。170 が期待できるのは camera.position.y >= 40 の高俯瞰または飛行追跡時であり、既定 orbit(camera y ≈ 16m)・路面プリセット(y ≈ 2.6m)・高架プリセット(y ≈ 14.4m)では 90 が正しい動作である。検証バッチでは extentM の判定を camera.pos.y と併読すること。本修正は PR 本文・Issue #76・検証バッチ #80 への申し送りにも記録する。 - 検証バッチへの申し送り(専門レビュー指摘の反映分): extentM の期待値は camera.position.y と併読すること。170 は camera y >= 40 の高俯瞰または飛行追跡時、90 はそれ以外の路面・至近視点(既定 orbit y ≈ 16m を含む)。1024 時・広域の normalBias 0.2988m については、動的解像度最深段の鳩の影の剥離・消失を確認すること。 ## R3-2 大気の奥行き(距離ヘイズの校正)(Issue #77) - 目的: 遠景が近景と同じコントラストで貼り付いて見える状態を解消し、距離に応じたヘイズの色と強さを空の色と整合させて校正する。実施内容はグルーミング反映コメント(環境・性能専門監査 提案3、コメント 6568229180)の確定版。 - 前提確認(現行 main の実読による既達・未達の切り分け): - 現行フォグは単色線形 Fog(build-city.js: `scene.fog=new THREE.Fog(0x9fc3d8, 700, 2600)`)で高さ依存がない。色は simulation.js の updateDaylight が毎フレーム地平色へ追従させ(`scene.fog.color.copy(_horC)`)、near/far は天候連動で再計算される(晴れ 700/2600 を起点に、雲で far 950・near 260 へ、雨で far 620・near 90 へ、雪で far 700・near 110 へ lerp)。したがって色・near/far の天候連動は既存のままで正しく、本単位で変える必要はない。(注:950/260 は雲の lerp 目標値で、重みは cloud×0.7 のため、雲単独の全量(cloud=1)でも far 1445/near 392 にしか到達しない。検証バッチでは雲天時の期待値に 1445/392 を用いること。雨・雪の端点は重み 1.0 で到達しうる。) - 建物メッシュの既存シェーダ変調は build-city.js の facadeShaderMod で、2 材料(cityMeshMat と cityGhostMat)が共有し、customProgramCacheKey は 'facade-c1' で同一プログラムである。頂点側は既に `vC7BaseY = position.y`(ワールド高さ、単位 m、地面=0。C7 の基部グラデーションと同じ変数)を fragment へ渡しているため、新規 varying は不要である。 - THREE.Fog に heightFactor プロパティは存在しない(color/near/far のみ)。パネルの fog.heightFactor は scene.fog のフィールドではなく、本単位で新設する R32 定数の実値である(下記)。この点を誤って scene.fog.heightFactor と読まないこと。 - X1 のチャンク fade はジオメトリグループとゴースト材料の不透明度による形状の出し分けで、フォグとは対象が別である。本単位はフォグ項のみに触れ、X1 の fade 機構には触れていない。 - 変更内容: `src/scripts/build-city.js`・`src/scripts/simulation.js`・`src/scripts/perf-panel.js` のみ。`index.html` は `tools/build.py` の再生成物。それ以外の src ファイルには触れていない。 1. 高さ重み定数(build-city.js、トップレベル、X1 定数の直後): `R32_HAZE_TOP_M=60`(重みが下限に達する高さ、単位 m)、`R32_HAZE_TOP_W=0.35`(その高さ以上でのフォグ重み)。facadeShaderMod の実行時にシェーダ文字列へテンプレート補間で展開され(生成 index.html にはテンプレートリテラルが載り、コンパイルされるシェーダには数値リテラルが入る。実行時評価のレプリカで `0.35`/`60.0` への展開と `$` 残存なしを確認済み)、追加 uniform は置かない。 2. フォグ項の置き換え(build-city.js、facadeShaderMod の fragment 側): `#include ` を、r128 の stock fog_fragment の2分岐(FOG_EXP2 の指数分岐と線形の smoothstep 分岐)をそのまま写したうえで高さ重みを掛けたコードに置き換えた。重みは `mix(1.0, 0.35, smoothstep(0.0, 60.0, vC7BaseY))` で、地面で 1.0、60 m 以上で 0.35。レプリカ評価の重み値: 0 m→1.000、4.5 m→0.990、10 m→0.952、20 m→0.831、30 m→0.675、45 m→0.452、60 m 以上→0.350。両材料が同一関数・同一キャッシュキーのため新規プログラムはなし。`fog:false` の設定は src 内になく、両材料とも既定の fog:true のため USE_FOG 分岐は有効である。 3. 計測パネル用スナップショット(simulation.js、snapshot の sky オブジェクトへ fog を追加): `fog:{near, far, heightFactor, heightTopM}`。near/far は scene.fog のライブ値(表示精度 0.1 m に丸め。天候連動の値がそのまま読める)、heightFactor は R32_HAZE_TOP_W(0.35、無次元)、heightTopM は R32_HAZE_TOP_M(60、単位 m)。シェーダと同一定数を参照するため、パネル値とシェーダが食い違うことはない。 4. 可視パネル(perf-panel.js、snapshot セクションの直後に新規「空(sky)」セクション): sky.dome/environment/envRegens/turbidity/rayleigh(既存スナップショット値)と fog.near(単位 m)/fog.far(単位 m)/fog.heightFactor(無次元)/fog.heightTopM(単位 m)の行を追加した。R3-1 の教訓(スナップショットに値はあっても可視パネルに行がなく受入が読めなかった件)にならい、スナップショット追加と可視パネル行の追加を同スプリントで行った。 - 変更しないもの: 標準 Fog の色・near/far の天候連動式(updateDaylight)、X1 のチャンク fade、高架・道路・川・小物の材料(標準フォグのまま。対象は建物メッシュのみ)、歩行の足運び・タイミング(pigeons.js は未編集。D1 厳守)、Three.js r128(D4)、単一 HTML(D5)、手続き生成テクスチャのみ(D6、新規テクスチャなし)、PLATEAU(D2、触れていない)。 - 増分目標: calls/triangles/programs/textures/geometries/meshes の静的増分はすべて +0。新規マテリアル・テクスチャ・ジオメトリ・メッシュ・varying・uniform なし。grep ベースの `new THREE.` 出現数で確認: build-city.js 239→239、pigeons.js 244→244、simulation.js 70→70、perf-panel.js 0→0、webfont.js 0→0。`new THREE.Mesh(` 出現数も build-city.js 21→21、pigeons.js 59→59、simulation.js 4→4 で不変。fragment の ALU 増は数命令のみのため、受入の見込みは俯瞰 bench が天井内で、増分は frameMs のみ(calls/triangles +0、programs +0)。 - ビルド: `tools/build.py` で再生成。変更前 4,959,147 bytes・blob `41a7731b79bd47f60e25a8565c0c00eacfefcef6`・SHA-256 `957d1c23da1a2832f55f2fc5c5715779d22f59bfbf18378af60bdae4c5f65b46` → 変更後 4,962,444 bytes(+3,297 bytes=コード・コメントの追加分がそのまま inlined されたもの。improvement-log.md は index.html に inlined されないため、ログ追記はビルド値に影響しない)・blob `2d2a5daf6afa8388748a4622c23e52c87d2d5e83`・SHA-256 `dc147010f95f291b149ecb086ffea5f0288b62a8e0b850c8166f1d8af7dd28e2`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)。なお初回ビルド時は 4,962,272 bytes・blob `b5d0fdb6…`・SHA-256 `80bb5014…` であったが、セルフレビューで「baked」の表現を「実行時テンプレート補間」に訂正したコメント修正のため再ビルドし、上記の最終値に更新した。実施前のベースライン再生成は main の index.html blob `41a7731b…` とバイト一致し verify PASS であることを確認済み。生成 index.html から `` の inline ブロックを抽出したところ 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel)で、`node --check` は全本合格。生成 index.html 内で `r32HazeW` は 2 回(定義行と使用行)、`fog.near` 行と `heightTopM` が存在することを確認した。src 単体の `node --check` も build-city.js・simulation.js・perf-panel.js の3本とも合格。 - 専門レビュー指摘の反映(M1・M2、記述訂正のみ・コード変更なし): M1 として simulation.js のスナップショットコメント中の "baked R32 constant" を「build-city.js の `R32_HAZE_TOP_W` 定数」へ訂正し、M2 として上記前提確認へ雲の lerp 目標値の注記(重み cloud×0.7、全量で far 1445/near 392)を補った。訂正後の再ビルドは 4,962,475 bytes(+31 bytes=コメント1行の差し替え分)・blob `539fd7751db73ccbd86b83778c52e063402ba67f`・SHA-256 `f6502a58d2a2ea846e135fb2306fe3a48dc27c921c1c883b2f2b983abfb31865`、決定論的再ビルド一致(`tools/build.py verify` 合格)、inline script 6 本の `node --check` 合格。訂正後の simulation.js に "baked" の残存はなく(build-city.js の UV-baked 言及は本単位と無関係の既存コメント)、改善ログの追記は R3-2 節のみで他セクションへの汚染はない。 - 受入への対応見込み: 計測可能な静的受入(高さ重みの式と数値、追加 uniform なし、両材料同一プログラム、ビルド再現性、inline script の構文チェック、D1 遵守、構造量 +0)は満たす。視覚受入(俯瞰・川面視点での3段階以上の霞み階調、路面近景に霞みがかからないこと、雨・雪時の二重潰れなし)とランタイム計測パネル値(fog.near/fog.far/fog.heightFactor の実値表示、俯瞰 bench の天井照合)と遠距離 LOD(P2)の判読退行なしは、本スプリントでは実ブラウザ目視・ランタイム計測ができないため「未確認」とし、検証バッチ(R4-1、Issue #80)へ送る。雨・雪時の二重潰れについては設計上の根拠がある(重みは最大 1.0 でフォグを強めることはなく、雨・雪時の far 短縮は updateDaylight の既存式のまま優先される)が、目視での確定確認は検証バッチへ送る。 - 視覚受入: 未確認。実ブラウザ目視は検証バッチ(R4-1)へ送る。検証バッチでの確認方法: 俯瞰で遠景の低層・中層・高層屋上の3段階以上の霞み階調が判別できること(低層ほど濃く、屋上ほど抜ける)、「路面で見る」で近景の建物基部に霞みがかかっていないこと、雨・雪時に遠景が二重に潰れていないこと(既存の far 短縮のみが効いていること)、計測パネルの「空(sky)」セクションで fog.near/fog.far が天候・視点に応じた実値(晴れ起点 700/2600 からの天候連動)で読め、fog.heightFactor が 0.35・fog.heightTopM が 60 m と読めること、俯瞰 bench が天井内(calls/triangles が基準値×1.2 以内)であること、遠距離 LOD(P2)の 20 m 以上の識別子が読めること。なお fog.near/fog.far は天候で変動するため、判定時は weather 表示と併読すること。 - 留保(コーディネーター・専門レビューへの申告): - 対象は建物メッシュのみ。高架・道路・川・小物は標準フォグ(距離のみ)のままで、高さ重みはかからない。俯瞰で高架と建物の霞み方に差が出る場合は、検証バッチで不自然と読まれたときの次の手は、高架材料への同項の拡張を別単位とすること(本単位の範囲外)。 - 重み曲線の 60 m・0.35 は本単位の設計値である。実景の日本橋の建物は低中層が多く、60 m 以上の屋上は少数派のため、階調の主役は 10〜45 m 帯の 0.95→0.45 の連続変化である。検証バッチで階調が弱いと読まれた場合の次の手は、TOP_M の引き下げ(例: 40 m)または TOP_W の引き下げ(例: 0.25)のいずれか一方の調整で、両方同時には変えないこと。 - マージは行わない。専門レビュー指摘の反映は、専門レビュー担当のコメント後にコーディネーターが本節へ追記する。 ## R3-3 路面と川面の濡れ・きらめき増強(Issue #78)— 川面側のみ - 目的: 川面のグリントが diffuse に焼き込んだ dash の一様な流れにしか見えない状態を解消し、波による法線の揺らぎとグリント帯の粗さ変化で流れ筋の2層化と明滅を出す。実施内容はグルーミング反映コメント(環境・性能専門監査 提案1、コメント 6568229396)の確定版。路面側は本単位の対象外で触れていない。 - 前提確認(現行 main の実読による既達・未達の切り分け): - 現行の川面材料は MeshStandardMaterial(map=512px の水 diffuse、roughness 0.34、envMapIntensity 1.0)で、normalMap・roughnessMap は付いていなかった。グリントは diffuse 内の白 dash(210 個、alpha 0.35–0.80)の焼き込みで、diffuse と同じ速度・方向(+0.030/+0.011)でしか流れていなかった。 - C6 の反射オーバーレイは別層であることを実読で確認: ベース水面 y=0.35(本単位の材料)、反射オーバーレイ y=0.40(独自 ShaderMaterial、c6ReflMat)、ripple オーバーレイ y=0.44(独自 MeshBasicMaterial、rippleTex)。本単位はベース水面の材料だけに触れ、オーバーレイ2層のジオメトリ・材料・y 位置・renderOrder には触れていないため重複しない。 - r128 の制約(実読による設計上の要点): r128 は材料ごとに単一の vUv しか持たず、レンダラは uvTransform を材料の map(diffuse)の行列からのみコピーする(three.min.js の標準材料 uniform 更新部で map→specularMap→…の優先順)。したがって normalMap テクスチャの offset を独立にスクロールしても描画には反映されない(no-op になる)。本単位はこの制約を回避するため、p7ShiftUV と同じ onBeforeCompile+customProgramCacheKey の流儀で、水材料だけに独立 varying(vWaterNormalUv)を追加した。詳細は下記「変更内容」3 を参照。texture.offset による独立スクロールをそのまま書いて「2層化した」と主張することはしない。 - 変更内容: `src/scripts/build-city.js`・`src/scripts/simulation.js`・`src/scripts/perf-panel.js` のみ。`index.html` は `tools/build.py` の再生成物。`pigeons.js` は未編集(D1 厳守。歩行の足運び・タイミング・stepping 関連コードには一切触れていない)。 1. 焼き込み dash の弱化(build-city.js、水 diffuse 描画部): 白 dash の alpha を 0.35–0.80 から 0.20–0.45 へ下げた。個数(210 個)・サイズ・配置は不変。 2. Sobel 派生の normalMap・roughnessMap(build-city.js、buildRoadsWater 内): 描画済み diffuse キャンバスから getImageData で輝度場(Rec.709 係数 0.2126/0.7152/0.0722)を作り、C4 の makeRoadTextures と同じ Sobel 式・符号規約(dx=(tr+2*mr+br)-(tl+2*ml+bl)、dy=(bl+2*bc+br)-(tl+2*tc+tr)、nx=-dx*2.0、ny=dy*2.0、nz=1、正規化後に 0–255 へ)で 512px の normalMap を生成し、端は wrap-around(±1 px を反対端で参照)でタイル継ぎ目が割れないようにした。roughnessMap は同じ輝度場から派生し、基部 255(材料の roughness 係数をそのまま通す。雨時の updateEnvironment による係数変化 0.40-rain*0.22 も従来どおり効く)、輝度 0.55 超のグリント帯だけを輝度 1.0 で 110 まで線形に下げた(式: max(110, 255-(lum-0.55)/0.45*145))。両テクスチャとも linear(sRGBEncoding なし)、RepeatWrapping、repeat 0.085(diffuse と同一)、anisotropy 8。材料は normalScale (0.55, 0.55)(道路の normalScale と同一値)で付与した。 3. normal 層の独立スクロール(build-city.js、水材料の onBeforeCompile、+simulation.js の animate): 頂点側で `vWaterNormalUv = uv * 0.085 + uWaterNormalOff`(uv は ShapeGeometry の形状座標由来。diffuse の vUv と同じ 0.085 係数のため、diffuse と normal のタイル整合は保たれる)を追加し、fragment 側で stock r128 の normal_fragment_maps チャンクをそのまま写したうえで2か所の normalMap サンプルだけを vUv から vWaterNormalUv へ置き換えた(bumpmap 分岐は不変)。uniform uWaterNormalOff は build-city.js のトップレベル Vector2(waterNormalOff)と同一オブジェクトを指し、animate() で毎フレーム -0.024/+0.008(単位: UV/sim 秒換算の dt 積算)で更新する。diffuse +0.030/+0.011、ripple -0.017/+0.026 とは速度・方向の両方で異なる(x は diffuse に対して逆向き)。perturbNormal2Arb の接線基底は dFdx(vUv)/dFdy(vUv) から作られるが、vWaterNormalUv は vUv と空間的に定数オフセットの差しかなく同一スケールのため、その微分は vUv の微分と等しく、基底は正しいままである。customProgramCacheKey は 'r33-water-normal-uv'(水材料だけの独立プログラム系統)。 4. 計測パネル(simulation.js の snapshot へ water オブジェクトを追加、perf-panel.js へ「川面(R3-3)」セクションを追加): water.normalMap(材料に normalMap があるか)、water.roughnessMap、water.normalScale(材料の normalScale.x、小数2桁)、water.diffuseOffset(diffuse テクスチャの live offset、x/y、小数4桁)、water.normalOffset(shader uniform の live 値、x/y、小数4桁)。normalOffset が uniform の実値である点に注意: テクスチャの offset ではない(上記 r128 制約のため、テクスチャ offset は描画に使われない)。 - 変更しないもの: 路面(道路材料・濡れ・roughness 係数)、C6 反射オーバーレイと ripple オーバーレイ(層・y 位置・スクロール速度とも不変)、水面ジオメトリ(ShapeGeometry・メッシュ数・y=0.35 不変)、歩行の足運び・タイミング(pigeons.js 未編集。D1 厳守)、Three.js r128(D4)、単一 HTML(D5)、手続き生成テクスチャのみ(D6、新規テクスチャは diffuse 派生の手続き生成のみで外部素材なし)、PLATEAU(D2、触れていない)。 - 増分目標: 新規メッシュ・ジオメトリなし(calls/triangles 静的増分 +0)。新規テクスチャは normalMap・roughnessMap の2枚(textures +2、静的 CanvasTexture 29→31)。新規プログラム系統は水材料の onBeforeCompile 系統1つで、全体 Epic #82 の配分枠(+1)以内(programs はランタイム実値のため「見込み +1 以内」とし、実値は検証バッチで照合する)。超過時の縮小策(512→256px)は不要だった(上限内見込みのため未実施)。 - ビルド: `tools/build.py` で再生成し verify PASS。変更前 4,962,475 bytes・blob `539fd7751db73ccbd86b83778c52e063402ba67f`・SHA-256 `f6502a58d2a2ea846e135fb2306fe3a48dc27c921c1c883b2f2b983abfb31865` → 変更後 4,969,855 bytes(+7,380 bytes=build-city・simulation・perf-panel のコード追加分がそのまま inlined されたもの。improvement-log.md は index.html に inlined されないため、ログ追記はビルド値に影響しない)・blob `45ed03995521499a644180cf0ce337fc53939d58`・SHA-256 `5a36d20c3ef97d0e5d481dadd9ee2920fb696d0781cff1b860ff19754d8bef27`、決定論的再ビルド一致(`tools/build.py verify` 合格、ディスク一致)。実施前のベースライン再生成は main の index.html blob `539fd7751db73ccbd86b83778c52e063402ba67f`(4,962,475 bytes)とバイト一致し verify PASS であることを確認済み。生成 index.html から抽出した inline script 6 本(webfont/citygeo/build-city/pigeons/simulation/perf-panel)で `node --check` は全本合格(citygeo は `