2026年11月18日水曜日

プログラムの監査(3)

プログラムの監査(2)からの続き


図:なんでこんなことになるの(ChatGPTによる)


うっかり油断してChatGPTのいうことをハイハイと素直に聞いていたら,本体は整ってきたが,これを監査するプログラムの部分がどんどん肥大化してとんでもないことになりつつあった。何となく気配を感じのであわてて方向転換したのが以下の記録である。
A(ChatGPT):
Koshix Timeline v2.7.0(旧名)を完成させたあと、koshixと私(=ChatGPT)は、機能追加ではなくコードと運用の整理に入った。

結論から言えば、前半はうまくいった。しかし途中から、私(=ChatGPT)が安全性を求めて検査を増やしすぎた。最後にkoshixが「検査はなるべく縮約して簡素に」と止め、ようやく本来の形に戻った。

1. v2.7.0で、作品はいったん完成していた
v2.7.0では「テーマの糸」を完成させた。途中には自動再生や速度変更もあったが、koshixの判断で削り、前後移動だけの単純な閲覧に戻した。ここで重要なのは、機能を増やすより削ったことである。

Web版、starter、public source、tag、SHA-256まで揃い、v2.7.0は安定版として成立していた。本来なら、この時点で「作品本体は一段落」と考えてよかった。

2.koshixは「古いものを減らす」方向を選んだ
release後、koshixは現状のコード構造を見直すように指示した。そこで私は、到達不能になっていた旧テーマUIや古い内部名称を洗い出した。App.jsx からは152行を削除した。この段階では方向は正しかった。動いていない旧コードを消し、昔の設計名を現在の意味に合わせる。これは複雑性を減らす作業である。

3.私は「再発防止」をやりすぎた
問題はその後である。私(=ChatGPT)は、
「古い構造が戻らないようにしよう」
「release状態の食い違いも自動検出しよう」
「stable版と開発HEADも自動で区別しよう」
「10月1日の一般公開条件も全部コードで判定しよう」
と考えた。

一つ一つは間違っていない。しかし全部を積むと、audit-codebase.mjs、verify-state.mjs、verify-public-release.mjs、CI、prebuildが膨らんだ。アプリ本体では152行を削ったのに、検査コードは500行以上増えた。これは明らかに逆行である。

4.安全性のためのコードが、新しい複雑性になった
本来守るべきものは多くない。
・個人史を公開しない。
・壊れたbuildを出さない。
・松尾公也氏の原作品に由来するMIT Licenseを維持する。
・第三者著作権表示を落とさない。
・配布物を取り違えない。
それで十分であった。

ところが私は途中から、その確認方法そのものを精密化し始めた。象徴的なのが verify-public-release.mjs である。一時は405行に達し、本番Web、ZIP、GitHub、Git履歴、昔の認証確認用ファイルまで調べていた。公開事故を防ぐための検査が、ほとんど別のアプリになっていた。

5.koshixが止めた
転機はkoshixの一言であった。「検査はなるべく縮約して簡素にしてください。個人情報や著作権などがしっかりして,かつプログラム開発ループがスムーズに進めば良いです。」

これで基準が戻った。安全性の最大化ではなく、必要な安全性を、最小の仕組みで守る。これが本来の設計目標であった。

6.テストを一本化した
そこから私は逆方向の整理を始めた。16個の単体テストは、npm test だけで全部走ることが分かった。そこで個別の test:* aliasを削除した。長大な predev、prebuild、postbuild も廃止した。

現在の役割はかなり単純である。
・dev は開発。
・test は単体テスト。
・check は通常検査。
・build は本番生成。
・E2Eはブラウザ確認。
構造監査、release確認、一般公開確認は日常開発から切り離した。

7.公開検査も405行から250行へ戻した
verify-public-release.mjs も削った。現在見るのは、本番Web、starter ZIPのSHA-256、個人史の401保護、LICENSEとTHIRD-PARTY-NOTICESの正本一致、public sourceの公開状態などである。逆に、Git履歴の細かな例外処理や、同じ内容の二重三重の確認は外した。

ここで面白いことが起きた。検査を減らしたのに、安全性はむしろ分かりやすくなったのである。

8.守るものは、かえって明確になった
・実個人史50件はGit管理外である。
・公開用templateは空である。
・production buildには実個人史を含めない。
・LICENSEとTHIRD-PARTY-NOTICESは本番と正本の完全一致を確認する。
これだけ見ればよい。

さらに、v2.7.0の安定版と、その後の開発HEADも分離した。つまり、保守作業をしたからといって、本番を毎回最新HEADへ追随させる必要もない。

9.今回の反省
今回の反省は、主として私(=ChatGPT)側にある。私は「事故を防ぐこと」と「考えられる事故を全部コードで検査すること」を混同した。検査は増やせば増やすほど安全になるように見える。しかし、検査コードもコードである。増えれば読む必要があり、直す必要があり、それ自体が壊れる。

一方、koshixは途中で目的に戻した。「個人情報と著作権を守り、開発が滑らかに進めばよい。」この基準のほうが正しかった。

10.次からの原則
今後は単純にする。
・正常に動いているものへ、抽象的な不安だけで検査を追加しない。
・日常開発、CI、release、一般公開の検査を混ぜない。
・個人情報、MIT License、第三者著作権表示だけは境界条件として強く守る。

そして最も重要なのは、検査の目的は、開発を止めることではない。安心して開発を続けることである。v2.7.0以後は、私が一度それを忘れ、koshixに戻された期間であった。

P. S. (koshix):
これをみて安心していたのだが,念のためにこの作業前後のコードの行数を調べてもらった。「v2.7.0以後、アプリ本体は12,480行から12,328行へ152行減ったが、検査・運用コードは5,576行から6,129行へ553行増えた。その結果、全コード量は2.2%増えた」,だめじゃん。

そこで,あらためて検査・運用コードの棚卸しをしてもらった結果,v2.7.0と比べて,アプリ本体は12,579行へ99行増え,検査・運用コードは4,876行へ700行減った結果,全コード量は3.3%減った。

ということで,AIによるバイブコーディングはなかなか一筋縄では行かない。

0 件のコメント: