2026年11月17日火曜日

プログラムの監査(2)

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


図:人間と一緒にプログラムを監査する(ChatGPTによる)

Koshix Timeline(旧名:現在は Layering History)のプログラム監査である。v2.5.0 でもうでき上がったというが,まだ積み残し(過去の松尾版から引き摺るレガシーなど)があるのにChatGPTはそれがややこしいので正面突破を避けているのだ。

そこで一案を高じた。まず現在のバージョンと松尾版コードの比較を頼む。そのうえで,こちらは,まだ運用開始前(10月1日公開予定にした,記事執筆は9月末)なので,互換性は一切気にしないことを強調した。そのうえで,改善可能性はないのかと問い質した。その結果,相手もとうとうあきらめて,大幅な見直しに着手することになった。午後から夜までの一日仕事になった。

A(ChatGPT):

今回の作業は、Koshix Timelineの内部構造を長期保守に耐える形へ整理し、その成果をv2.6.0としてWeb、starter ZIP、公開用ソースまで一貫して配布することであった。単なる機能追加ではなく、データモデル、保存、UI、検証、リリース運用までを一巡させた点が重要である。

1.目標

Koshix Timelineは機能的には十分動いていたが、開発の経緯から旧形式、重複状態、保存方式の分散、巨大なApp.jsxなどが残っていた。理想構造は次の通りである。

    TSV / browser / server
            ↓
    入力・検証・codec
            ↓
    Canonical Event / Canonical Profile
            ↓
    Workspace persistence
            ↓
    Timeline Model
            ↓
    React UI

今回は、イベントの内部表現を一本化し、教育歴・成人期をCanonical Profileへ統合し、ブラウザ保存をWorkspace境界へ集約した。さらに年表固有の意味論をTimeline Modelへ寄せ、App.jsxから表示部品を分離した。管理者データ読込では個人史と人生設定を同時に復元できるようにし、共有UIも整理した。これらをWeb版、starter ZIP、公開用ソース、Git tag、運用文書までv2.6.0へ揃えることを最終目標とした。

2.改善結果

以前、理想設計に対して構造面で80〜85%程度と評価していたが、今回の整理後は90〜95%程度まで来たと考える。旧 t/n/l/q/ic、旧 y、旧教育設定、adultPeriodsEnabled などの重複表現を整理し、イベント、教育歴、成人期の正規表現を明確にした。

保存層も、settings、自分史、年表カスタマイズをworkspaceStore経由で扱う構造となった。Timeline Modelには期間の開閉対象や初期状態など、年表としての意味を集約した。

App.jsxは約2075行から1477行へ減少した。約600行、29%減である。年表行、人生設定、自分史編集、共通年表編集を独立させ、App.jsxは画面全体の調停役に近づいた。

品質保証では、公開イベント575件、Chromium E2E 5件、privacy boundary、reproducible build、公開用ソース単独build、starter ZIPのSHA-256、Git管理外個人史まで確認した。

最終的に、STATE CONSISTENT、RELEASE READY を通し、本体tag、公開用ソースtag、本番Web、starter ZIPをv2.6.0へ一致させた。

3.残された課題

大きな構造問題はほぼ片付いた。App.jsxはなお1477行(一番最初は6600行程度だった)あるが、残っているのは状態管理と画面全体の調停が中心であり、行数削減だけを目的に分割する必要はない。

IndexedDBも個人史と年表カスタマイズで別DBのままである。しかしWorkspaceとして論理的には統合されており、互換性を壊してまで一本化する利点は小さい。

運用面では、2026年10月1日の一般公開に向け、noindex,nofollowの解除、downloads/のBasic認証解除、公開用ソースrepoのpublic化、最終privacy監査などが残っている。

今後の主役はコードより内容である。公開イベント575件と個人史約50件について、日付、内容、分類、出典、重要度を育てる方が、追加の構造改革より成果に直結する。

4.作業過程の反省 (注:その後文書化してもらった)

最大の反省は、長いheredocを使いすぎたことである。ChatGPTから長いPython heredocをTerminalへ貼る方法は不安定で、何度か heredoc> に入った。途中から短い python3 -cへ切り替えると安定した。今後は、1ファイル、1目的、短い置換、確認 を基本とするべきである。

二つ目は、文書の「現在状態」が古くなっていたことである。NUCLEUS-SERVER-NOTE.mdにはv2.4.0、個人史49件、旧asset名などが残っていた。コードやサーバーだけでなく、運用文書の主要値も機械的に照合できる仕組みが必要である。

三つ目は、確認を細かくしすぎたことである。安全性は高いが、後半は1行変更ごとの確認が続き、効率が落ちた。今後は、実状態を採取→変更対象を確定→更新スクリプト→diff --check→stale記述検査、程度にまとめる方がよい。

また、release/koshix-timeline-publicと~/koshix-timeline-publicは名前が紛らわしい。前者は生成物、後者は独立した公開用ソースrepoであり、今後も実体確認が必要である。

5.全体評価

今回の価値は、新機能の追加ではなく、これまで蓄積した機能を壊れにくく、理解しやすく、配布しやすい構造へ整理したことにある。v2.5.0までは「よく動くアプリ」であった。v2.6.0では、内部モデル、保存境界、UI構造、privacy、配布工程、運用文書まで、かなり一貫した設計思想で揃った。

したがって、当面は大規模な構造改革を続ける必要はない。今後は実際に使いながら、年表と個人史の内容を育て、必要な改善だけを小さく加えていく段階である。

0 件のコメント: