kouchou-ai developer wiki

meeting-report-draft

21 min read

目的

このページは、次の定例会議で Codex 関連の作業を短時間で報告するための下書き である。Issue / PR / CI / wiki の更新が散らばるので、会議前に思い出すのではなく、作業のたびにここへ要点を寄せる。

ポイントは「全部の変更履歴」を書くことではなく、会議で口頭共有したい判断と進み具合だけを残す こと。詳しい根拠は各 concept / analysis / source ページへリンクする。coding-agentsより contributingより

使い方

  • まず冒頭の「月曜にそのまま読む用」を 8 項目以内に保つ。詳細は下のテーマ別セクションへ送る
  • 1 項目は 2〜4 行程度で、やったこと / 現在地 / 次の一手 が分かる粒度にする
  • merge 済みか進行中かを明記する
  • issue 番号、PR 番号、main commit などの検索キーを残す
  • 会議で読まない細かい実装詳細はこのページに詰め込まず、関連 analysis / source ページへ送る
  • 同じテーマで新しい情報が来たら、新しい bullet を足すのではなく既存セクションを書き換える
  • 「議題候補」セクション は team の判断・議論・合意が必要な論点を集める場所。status 報告 (「月曜にそのまま読む用」) とは別物として扱う
  • 会議が終わったら本ページを wiki/concepts/meeting-report-YYYY-MM-DD.md へ rotate し、本ページは次回向けに空に戻す

過去回

  • meeting-report-2026-06-01 — ラベル品質仕切り直し、構造把握スタンス、open issue 全件棚卸し、PR #887 deploy false positive / runtime build risk、PR #883 撤回後の quickstart 再設計、Windows / local LLM route など
  • meeting-report-2026-05-25 — 大リファクタリング完了、LLM grouping 実験、ラベル refinement 実験、open issue 棚卸し、Windows setup 切り替えなど

議題候補 (2026-06-08 定例)

  • Dependabot alerts (https://github.com/digitaldemocracy2030/kouchou-ai/security/dependabot) を週次または定例前の確認対象として固定するか。公開 wiki には alert 詳細を転記せず、対応 issue / PR / 優先度判断だけ残す運用でよいか。
  • デプロイ詳細は公開 wiki に書かず、Google Drive「広聴AI-Azureデモ環境」を一次置き場にする方針でよいか。アクセス権は大木・西尾・小野(moai)。
  • Azure デモ動線化は 2026-06-05 Slack で着地済み (azure-demo-public-visibility-proposal-2026-06-04 / azure-demo-visibility-thread-resolution-2026-06-05)。共有事項: viewer 公開と admin 共用は進める方針、ただし container の dd2030 フォールバック OPENAI_API_KEY 除去と「共用 / 機微情報禁止 / 保存・継続稼働非保証」3 点明示が前提。1 ヶ月専用試用環境は優先度低、365 日 SaaS は提供主体・責任範囲の整理項目化。デモ環境の現時点の価値は「データ投入の場所」より「使い方理解の参照環境」として再フレーム。次の手順 (container env 修正 + 公開文言の docs / admin 反映 + 公開事例ページ更新) のオーナーをどう割り当てるかを定例で詰めたい
  • docs entry spine の改訂 (kouchou-ai-docs-entry-restructure-2026-06-03): 入口を viewer に置き、tier 2 を「(a) 誰かが建てたサーバ / (b) 建ててくれる人を探す / (c) 自分で建てる」の 3 択にして、getting-started/ は (c) 配下に押し込む方針への合意確認。Azure デモ動線化が tier 1 / tier 2-a の docs 動線を埋める前提と接続する

月曜にそのまま読む用 (2026-06-08 向け)

  • 進行中: public-viewer の startup next build 撤去に向けて、PR #888 (codex/public-viewer-build-serve-split) で実装を進めた。dynamic hosting は API なしで next build、static export は fixture API ありで build する形に分離し、container 起動は next start のみにした。 ローカルでは Jest 94 件、API-less dynamic build、static export build、runtime smoke (/, /faq/, /example/) が通過。PR #888 の CI client build でも API-less dynamic build、static export build、Docker build が通過した。
  • wiki 運用: Dependabot alerts を GitHub current state の定期観測対象として CLAUDE.md / wiki-driven-workflow / codeql-introduction-context に追記した。main / open PR / issue だけでは拾えない security live state として扱い、公開 wiki には脆弱性詳細を転記しない方針にした。あわせて、デプロイ詳細は公開 wiki に書かず Google Drive「広聴AI-Azureデモ環境」側で管理する方針に更新した。
  • main 済み: Dependabot alerts に対し、PR #889 (codex/dependabot-alerts-2026-06-01) を admin merge した。pnpm.overrides と pnpm-lock.yaml だけを更新し、audit / tests / build は通過。merge 後の Dependabot open alerts は 19 件から 6 件へ減った。alert 詳細は公開 PR / wiki に転記していない。
  • main 済み: CodeQL Action v3 の 2026-12 deprecation warning 対応として、PR #893 (codex/codeql-action-v4) を admin merge した。.github/workflows/codeql.yml の init / autobuild / analyze を github/codeql-action/*@v4 へ更新し、workflow 構造・trigger・permissions は変えていない。
  • main 済み: Code scanning alerts 対応 PR #892 (codex/code-scanning-fixes) を admin merge した。admin の API URL 組み立て、static build endpoint、API エラー返却の公開可能な範囲を修正し、PR branch の code scanning open alerts は 0 件。alert 詳細は公開 wiki に転記していない。
  • main 済み: all green + CodeRabbit actionable comment なしを確認し、PR #896 (codex/api-docker-dependency-check) と PR #897 (codex-fix-mixed-type-csv-input) を admin merge した。#896 は API Docker image と test 環境の依存差分を Dockerfile contract pytest + API Docker Dependency Smoke で検知する修正、#897 は混在型 CSV 属性を文字列として扱う修正。source-codeより
  • main 済み: nishio authored の open PR を整理し、PR #893 → #890 → #892 → #863 の順で admin merge した。#863 は draft だったが、mergeable と checks pass を確認して ready 化してから merge した。merge 後の nishio authored open PR は 0 件。
  • 進行中: CLI で pipeline を試行錯誤して発展させる順序を cli-pipeline-experiment-roadmap-2026-06-02 に整理し、first slice として codex/experiment-storage で analysis-core に --experiment-root / --experiment-id を追加した。 さらに既存 LLM grouping 400 件実験を raw/experiments/2026-06-02-llm-grouping-400-tree-label-corpus/ に台帳化し、5 tree run / 10 labelling run / 5 judge run / 4 observation と tree-label matrix bundle を作った。これは探索 corpus として扱い、次は同じ tree / evidence で label variants を作り、人間に A/B preference を聞く。
  • wiki 整理: 議事録 / Slack 由来情報の鮮度基準を wiki-driven-workflow と主要 source に追記した。今後はページ更新日ではなく、last_checked / last_read と coverage を見て「いつ時点まで読んだ観測か」を判断する。さらに jigsaw-sensemaker を追加し、Jigsaw Sensemaker は LLM grouping の一例だが、LLM grouping 全体を Jigsaw と呼ぶと混乱する、という呼び分けを整理した。
  • wiki ingest: oss_weekly_reporter の 2026-05-20_to_2026-05-27 weekly dump を weekly-log-2026-05-20 として source 化した。公開 UI 要件 thread、MST / bridge 可視化 seed、実験 artifact 保存方針の Slack 上の前段を公式 dump で確認できた。

次回定例向け詳細 (テーマ別)

public-viewer build/serve 分離

  • 進行中 PR: #888 (codex/public-viewer-build-serve-split)。apps/public-viewer/entrypoint.sh から runtime build を消し、Dockerfile の builder stage で .next を作る構成に変更した。
  • 実装判断: / と /faq は connection() で request-time rendering に寄せた。一方 [slug] に connection() を入れると /example が DYNAMIC_SERVER_USAGE で落ちたため、non-export では generateStaticParams() => [] と fallback metadata、runtime env 読みで対応した。
  • CodeRabbit review 対応: / の generateMetadata() は connection() で request-time 化し、API-less build を維持しつつ reporter-specific metadata を復元した。[slug] metadata の request-time 化は /example 500 を起こすため見送った。
  • 次に見ること: Docker build を CI / daemon 起動済み環境で通すこと。Azure deploy readiness poll / representative report smoke は PR #890 で main 済みなので、次は main push 後の deploy 挙動を見る。

security alert 運用

  • Dependabot alerts は main / open PR / issue だけでは拾えない GitHub live state なので、security / dependency の保守では https://github.com/digitaldemocracy2030/kouchou-ai/security/dependabot を定期確認対象に含める。
  • 公開 wiki には alert の具体的な脆弱性詳細を転記せず、対応 issue / PR / 優先度判断だけを残す。確認頻度と担当は次回定例で決めたい。
  • CodeQL Action v3 deprecation warning への対応は PR #893 で main 済み。.github/workflows/codeql.yml 内の CodeQL action 参照だけを v4 に上げ、security scan の対象言語や実行条件は維持している。
  • Code scanning alerts の実装修正は PR #892 で main 済み。PR branch では open alerts 0 件まで確認済みで、merge 後に main 側 alert が close されるかを見る。

API Docker 依存整合性

  • PR #895 で見つかった根本原因は、CI が requirements-dev.lock / all-features 前提で通る一方、API Dockerfile は local analysis-core を extras なしで入れていたこと。PR #896 (codex/api-docker-dependency-check) では、Dockerfile が /packages/analysis-core[full] を quote 付きで install することを pytest で固定し、2026-06-05 に admin merge した。source-codeより
  • 追加 workflow API Docker Dependency Smoke は Dockerfile / API dependency lock / analysis-core dependency manifest 変更時だけ API image を build し、container 内で hierarchical_clustering, sklearn, scipy, umap, numba, sentence_transformers, torch, google.genai の import を確認する。
  • ローカルでは新規 pytest、ruff、workflow YAML / bash 構文検証まで通過。PR #896 の CI では dependency-smoke、server pytest、ruff、CodeQL が全 pass。
  • 副次メモ: codex/api-docker-dependency-check worktree で commit / push 時に Can't find lefthook in PATH が出たが、原因は dedicated worktree 側に node_modules が無かったこと。pnpm install --frozen-lockfile 後に lefthook 1.13.6 と pre-push ruff checks が正常起動したため、worktree-hygiene に運用メモとして反映。

mixed-type CSV 入力

  • PR #897 (codex-fix-mixed-type-csv-input) は、ユーザー入力 CSV の属性列に数値と文字列が混ざる場合でも文字列として扱うため、analysis-core 側に schema inference を抑える共通 CSV reader を追加し、API の input CSV 生成も明示 schema に寄せた。CI は analysis-core / server / CodeQL / ruff 全 pass、CodeRabbit は actionable comment なし。2026-06-05 に admin merge 済み。source-codeより

public wiki の公開境界

  • デプロイ詳細は公開 wiki に書かない。実環境 URL、resource 名・サイズ、revision / run details、ログ、具体手順、secret / access 周辺は Google Drive「広聴AI-Azureデモ環境」側で扱う。
  • 公開 wiki に残すのは、設計判断・公開可能な課題・対応 issue / PR・次に見る論点の粒度にする。
  • main 済み PR: #889 (codex/dependabot-alerts-2026-06-01), #890, #892, #893, #863。open PR #888 は package.json / pnpm-lock.yaml を触っていないため、差分上の干渉は小さい。

CLI pipeline 実験 lane

  • cli-pipeline-experiment-roadmap-2026-06-02 を追加し、CLI / analysis-core を pipeline variant、judge、view prototype の実験場として位置づけ直した。
  • 追加で clustering-labeling-comparison-corpus-2026-06-02 を作成し、judge 改善の前に dataset / tree_run / labelling_run / human_observation / judge_run を分けて蓄積する必要があると補正した。
  • experiment-result-storage-policy-2026-06-02 を追加し、実験結果の保存先を work/ scratch、raw/experiments/ raw snapshot、wiki/ public summary の 3 層に分けた。CLAUDE.md にも運用ルールとして追記済み。
  • 進行中 branch: codex/experiment-storage。analysis-core CLI に --experiment-root / --experiment-id / --experiment-overwrite を足し、既存 output から manifest.json、datasets.jsonl、tree_runs.jsonl、labelling_runs.jsonl、artifact copy を作る first slice を実装した。対象テスト 13 件と ruff は通過。
  • llm-grouping-400-tree-label-corpus-2026-06-02 を追加し、既存 LLM grouping 400 件実験を raw/experiments/2026-06-02-llm-grouping-400-tree-label-corpus/ に移した。bundles/tree_label_matrix.md / .html で top-level labels と [8,40] refinement を横比較できる。
  • one-factor-experiment-principle-2026-06-02 を追加し、複数要素を同時に変えた run は exploratory、採用判断用の clean experiment は current main baseline から factor_under_test を 1 つだけ変える、という原則を明文化した。
  • human-pairwise-label-preference-experiment-2026-06-02 を追加し、人間評価は単独 label 批評ではなく、同じ tree / evidence から作った label variants の blind A/B preference として集める方針に補正した。
  • 追加で、A/B 評価では algorithm / process 由来を人間に隠し、困難な full UI 評価は label 単体 / 隣接 label 集合 / label + 代表例の分解テストとして扱う方針にした。
  • label-quality-human-preference-improvement-plan-2026-06-03 を追加し、次の implementation slice を hierarchical_8_40 固定の blind A/B bundle と human_preferences.jsonl schema 作成に絞った。
  • scripts/build_label_preference_bundle.py を追加し、既存 corpus から 24 件の pending blind A/B questions、空の human_preferences.jsonl、schema、Markdown / HTML bundle を生成した。HTML には回答フォームと JSONL output textarea を追加し、表示 bundle には candidate origin を出していない。
  • 次の順序は、label variants → human A/B preference → judge calibration → evidence contract → label/refinement → Mandalart mock → sticky board mock。Mandalart / 付箋ビューは最初から Web default にせず、standalone HTML / JSON の CLI artifact として読みやすさを確認する。
  • 次に見ること: hierarchical_8_40 tree / evidence 固定で label process だけを変えた A/B bundle を作れるか。judge v1 は、この preference を再現できるかで見る。#880 マンダラートや付箋ビューは、ラベル品質 loop と接続する view prototype として扱う。

source freshness 運用

Open Questions

  • Codex 以外の AI エージェント（Devin / Copilot Agent）の報告も同じページに寄せるかは未整理

Updates

  • 2026-06-05: all green + CodeRabbit actionable comment なしを確認して PR #896 / #897 を ready/admin merge したことを追記
  • 2026-06-05: dedicated worktree では node_modules も別なので、Can't find lefthook in PATH は各 worktree root で pnpm install --frozen-lockfile して解消する、という知見を worktree-hygiene / gotchas に追記
  • 2026-06-05: codex/api-docker-dependency-check で API Dockerfile の analysis-core[full] install contract test と実 image dependency smoke workflow を追加したことを追記
  • 2026-06-05: Azure デモ動線化 4 問は 2026-06-05 大木さん返答 + nishio 決定 (azure-demo-visibility-thread-resolution-2026-06-05) で着地。議題候補を「次の手順 (container env 修正 + 公開文言反映 + 公開事例ページ更新) のオーナー割り当て」に書き換え
  • 2026-06-04: 議題候補に Azure デモ動線化 4 問 (azure-demo-public-visibility-proposal-2026-06-04) と docs entry spine 改訂 (kouchou-ai-docs-entry-restructure-2026-06-03) を追加。nishio が 2026-06-04 Slack で大木さんに投げた 4 問が起点
  • 2026-06-01: 2026-06-01 定例後に meeting-report-2026-06-01 へ rotate し、本ページを 2026-06-08 向けの空テンプレートへ戻した
  • 2026-06-03: codex-log-label-preference-bundle-2026-06-03 を追加し、blind A/B bundle 生成の実行結果を CLI pipeline 実験 lane に追記
  • 2026-06-03: label_preference_ab.html に回答フォームと JSONL output textarea を追加したことを CLI pipeline 実験 lane に追記
  • 2026-06-03: label-quality-human-preference-improvement-plan-2026-06-03 を追加し、ラベル品質評価改善の次 slice を blind A/B bundle と human_preferences.jsonl schema 作成として追記
  • 2026-06-02: nishio-blind-human-label-presentation-context-2026-06-02 を追加し、A/B evaluation では algorithm 由来を隠し、提示文脈を分けて記録する方針を CLI pipeline 実験 lane に追記
  • 2026-06-02: full UI context は困難なので、A/B 評価では label 単体 / 隣接 label 集合 / label + 代表例の 3 つへ分解して扱う方針に補正
  • 2026-06-02: human-pairwise-label-preference-experiment-2026-06-02 を追加し、人間評価を単独 label 批評ではなく A/B preference collection にする方針を CLI pipeline 実験 lane に追記
  • 2026-06-02: one-factor-experiment-principle-2026-06-02 を追加し、CLI pipeline 実験 lane に「探索 corpus と clean experiment を分け、採用判断は 1 要素ずつ変える」方針を追記
  • 2026-06-02: llm-grouping-400-tree-label-corpus-2026-06-02 を追加し、既存 LLM grouping 400 件実験を raw comparison corpus に移したことを追記
  • 2026-06-02: codex/experiment-storage で analysis-core CLI に実験 archive first slice を実装したことを CLI pipeline 実験 lane に追記
  • 2026-06-02: experiment-result-storage-policy-2026-06-02 と CLAUDE.md に実験結果の 3 層保存方針を追加
  • 2026-06-02: clustering-labeling-comparison-corpus-2026-06-02 を追加し、ラベル品質実験は judge 改善の前に tree / labelling output 比較コーパスを作る順序へ補正
  • 2026-06-02: CLI で pipeline を試行錯誤して発展させる順序を cli-pipeline-experiment-roadmap-2026-06-02 に整理し、次回定例向けに追記
  • 2026-06-02: nishio authored open PR #893 / #890 / #892 / #863 を admin merge したことを追記
  • 2026-06-02: CodeQL Action v3 deprecation warning 対応として、PR #893 (codex/codeql-action-v4) で CodeQL workflow の action 参照を v4 へ更新したことを追記
  • 2026-06-02: Code scanning alerts 対応 PR #892 の作成を追記
  • 2026-06-02: 議事録 / Slack 由来情報の freshness marker を wiki-driven-workflow と主要 source に追記
  • 2026-06-02: jigsaw-sensemaker を追加し、Jigsaw Sensemaker と LLM grouping の呼び分けを整理。禁止語 lint は不要として scripts/lint_wiki.py から撤去
  • 2026-06-02: oss_weekly_reporter の 2026-05-20_to_2026-05-27 weekly dump を source 化し、公開 UI / MST 可視化 / 実験 artifact 保存方針の前段として反映
  • 2026-06-01: Dependabot 脆弱性詳細とデプロイ詳細を公開 wiki に書かない方針を次回定例向け議題に追加
  • 2026-05-31: 「議題候補」セクションを status 報告と分ける運用を追加。2026-06-01 定例で、developer-quickstart 再設計、組織内デモ役 / SaaS ホスト型、議題候補常設化を相談対象にした
  • 2026-05-30: 月曜読み上げ用要約を冒頭に追加し、本文をテーマ別に束ね直した
  • 2026-05-21: 初回作成。直近の analysis-core / Web UI / deploy / AI 運用ルールの進捗を次回定例向けに要約

グラフビュー

バックリンク