KENSAI 製品アップデート, canonical path の真実と root mirror sync が日次公開の隙間をふさぐ

KENSAI は 4 月 19 日の公開フローを強化し、OpenClaw の project tree を正規ソースとして扱い、各言語ブログインデックスを HTML から再構築し、served root mirror を同期することで、same-day 件数を実際に読める内容と一致させました。

今日リリースした内容

今日の作業では、公開パイプラインにあった地味だが危険な曖昧さを取り除きました。OpenClaw の project tree にはもともと本当の authoring state がありましたが、公開サイトは同時に served root mirror にも依存していました。そのため、記事が canonical repo に存在していても、ユーザーや crawler が実際に見る surface にはまだ出ていない、という状態が起こり得ました。

4 月 19 日はこのループを引き締めました。今の publish とは、実際の localized HTML を書き、そこから各言語 index を再構築し、最後に served mirror を同期して、公開件数が意図ではなく現実を表すようにすることです。

1) canonical path が重要なのは、チームが live だと思っているものをデバッグするから

複数の tree があると、人は最後に触った path を自然に見に行きます。もし live site が別の mirror を配信しているなら、それは罠になります。Authoring path を明示的に canonical とし、一方向に同期することで、その混乱を断ち切れます。

正しいファイルが間違った現実に置かれていれば、結果はやはり間違った現実です。Canonical path の規律は事務作業ではなく、幽霊のような不具合をデバッグしないための条件です。

2) HTML は引き続き真実のソースであり、言語別 JSON はそこから派生する

安全な契約は変わっていません。HTML が authoritative で、JSON は derived です。各言語の記事はその言語専用の JSON index にだけ入るべきで、index は localized HTML から再構築されるべきです。手作業で別の truth source を維持してはいけません。

これは重要です。overview pages, blog listings, locale routes はその derived index を使うからです。JSON が rendered files から drift すると、サイトは静かに真実を語らなくなります。

3) served surface が英語と一致して初めて same-day 公開は完了する

4 月 19 日の実務的な目標は単純でした。1 日 2 本目の product post を、英語と必須の 10 非英語ロケールすべてで同日に存在させることです。今回出荷したのはそのより強い版で、served surfaces が英語と一致しない限り、その日は完了とは見なされません。

これにより same-day publishing は測定可能になります。1 つでも言語が欠け、1 つでも index が汚染され、1 つでも overview が遅れていれば、git 上の draft がどれだけきれいでも release は未完了です。

なぜ重要なのか

公開まわりの小さな曖昧さはすぐに積み上がります。古い mirror は freshness を壊し、古い index は discoverability を壊し、ずれた locale overview は same-day の約束を壊します。この 3 つを同時に締めることこそ、高速な多言語公開を持続可能にする地味な信頼性です。

今日の product work のポイントはそこです。劇場ではなく、検証できる真実です。