Repository navigation
Open
0 / 90 of 9 issues completedDescription
問題
同じ規則や事実を複数の場所に書いていて、正を呼ばずに計算し直すか、写している。
片方だけが直されてずれ、bug と、実装と合わない文書になって表に出ている。
- tcs: IL が意味の一部を持たず、C と VM の backend がそれぞれ推論し直している。通すかどうかの判定が、
tcs checkと 2 つの backend の 3 か所にある。runtime の処理の多くを、C の出力と tcs VM に別々に書いている。open の tcs の bug の多くは、片方の backend だけに、または両方に同じ形で出る。 - lub: csproj の入力、entry class、host の引数、gate の手順、test の一覧を何か所でも計算し直すか写していて、既に経路ごとに振る舞いが違う所がある。
- 文書: 実装の事実を要約して写していて、実装を変えたときに写しが古くなる。エージェント向けの入口が 3 つある。
それぞれの棚卸しは、各段の issue に書いた (master の 3cf29da で確かめた)。
原則
- 規則と事実ごとに正を 1 か所決め、ほかはそれを呼ぶか、そこを指す。
- 写すしかないとき (言語の境目をまたぐなど) は、一致を確かめる検査を同じ PR に入れる。
- 実行経路が 3 つ (tcs VM、tcs2c、.NET) あること、backend が 5 つあることは対象にしない。その中で同じ規則を写している所は対象にする。
段の順
flowchart LR
p0["0. 待っている PR"] --> p605["1. 置き場所 #605"]
p0 --> pdoc["1. 文書の正 #649"]
p605 -. tcs の文書の path .-> pdoc
p605 --> pil["2. IL #651"]
p605 --> plex["2. 字句の残り"]
p605 --> prt["3. runtime #650"]
pil -. 関数の選び方と書式 .-> prt
p0 --> plub["4. lub #592 と #652"]
p647["#647"] --> pgate["4. gate の部品化"]
0. 待っている PR を片付ける
#593–#603 と #647 は、この後の段で触る file と重なるので、先に merge する。
#601、#602、#603 と、#595、#596、#597、#599、#600 は、処理を 1 か所に寄せる向きの変更である。
#593、#594、#598 は C と VM を別々に直していて、その分は 3. で 1 つに移す。
1. 置き場所と文書の正を決める
- tcs を lub のスクリプトの部品として、名前と置き場所を整理し、使っていないものを消す #605: tcs の名前と置き場所を整理する。全部の path が動くので、2. と 3. より前に済ませる。.NET で正解を出す所、テストの入口、tcsvm と C の tcs の build の手順を 1 つにするのも tcs を lub のスクリプトの部品として、名前と置き場所を整理し、使っていないものを消す #605 に含まれる。
- 文書: 話題ごとに正を 1 か所にし、ほかの文書はそこを指すだけにする #649: 話題ごとに文書の正を 1 か所にする。エージェントへの指示を
AGENTS.mdの 1 つにし (CLAUDE.mdは置かない)、上の原則をAGENTS.mdに書く。API の作り直しが揃ったら docs を実装に合わせ直す #308 (API の作り直しの後に docs を合わせ直す) は、ここで決めた正の文書に対して行う。
2. tcs: 意味の決定を IL に載せ、通すかどうかの判定を 1 か所にする
- tcs: 意味の決定を IL に載せて backend は IL を読むだけにし、通すかどうかの判定を 1 か所にする #651 (C backend と VM backend の型推論を共有し、sort / PRNG / dict の algorithm を runtime の C に出す #461 を含む)。
- 字句は、tcs の字句で C# のどの改行も改行として読み、raw 文字列の中身の改行を書いたまま残す #602 と tcs の補間の配置幅を空白の数の上限なく埋め、raw 補間でも読む #603 で raw の形と補間の穴を 1 つの関数で読むようになる。残りの (bug) tcs: raw 補間の穴で式の中の
{ }の組を数えず、初期化子や switch 式を書くと CS1003 で止まる #606、(bug) tcs: 形の誤った raw 文字列と raw 補間を check が報告せず、決まった値にする #622、(bug) tcs: raw 補間の閉じの区切りを穴の中でも探し、穴のコメントや文字列の中の"""で閉じる #623 はその関数の上で直す。tcs: 意味の決定を IL に載せて backend は IL を読むだけにし、通すかどうかの判定を 1 か所にする #651 と並べて進めてよい。
3. tcs: C の出力と tcs VM に別々にある runtime の処理を 1 つにする
- tcs: C の出力と tcs VM に別々にある runtime の処理を、tcs/runtime/ の 1 つの C の実装にする #650。fault の種類の表を最初に作り、テストが fault の種類まで比べるようにする。
- tcs: 意味の決定を IL に載せて backend は IL を読むだけにし、通すかどうかの判定を 1 か所にする #651 と並べて進めてよい。関数の選び方と書式の分け方は IL の形に関わるので、tcs: 意味の決定を IL に載せて backend は IL を読むだけにし、通すかどうかの判定を 1 か所にする #651 と順を合わせる。
4. lub: 同じ規則を計算し直している所を 1 つにする
- tcs vm --watch をやめ、lub の hot reload を組み込みの tcs の session にする #592 (lub の hot reload を組み込みの tcs の session にする) と一緒に、csproj の入力と entry class を 1 本にする。
- lub: 同じ規則を何か所でも計算し直している所を、1 つの実装を呼ぶ形にする #652。gate の部品化は CI は配るものを毎回全部確かめ、確かめたものを配る #647 の後に行う。(bug) vulkan: fragment shader から書く storage texture の binding が StructuredBuffer と重なり、lavapipe が draw で落ちる #643 は lub: 同じ規則を何か所でも計算し直している所を、1 つの実装を呼ぶ形にする #652 の中で直す。
5. 後回し
- box2d と box3d の物理で、key で宣言して寿命を管理する層が 2 本ある (
src/physics_box2d.cとsrc/physics_box3d.cに、同じ名前の静的な関数が 100 以上ある)。box3d には runtime テストが無いので、まとめる前にテストを足す。 - shader の reflection を作る経路が 2 本ある (
src/shader.cppの Slang の API と、reflection の JSON)。今は食い違いが見つかっていない。
終わりの条件
- 下に紐づけた issue がすべて閉じている。
- 新しい重複を作らない約束が
AGENTS.mdにある。
Metadata
Metadata
Assignees
Labels
No labels
Activity
{ }の組を数えず、初期化子や switch 式を書くと CS1003 で止まる #606"""で閉じる #623