kouchou-ai には進行中の作業が多数あり、docs/ や meeting-minutes が断片的に語る状態を新規コントリビュータが追いづらい。本ページでは課題を 3 つの状態 に分類して並べる。

  • A. 未定 — 方向性が定まっておらず議論中、または対立する意見が残っている
  • B. 方針決定済み・未着手 — 何をすべきかは合意があるが、誰も手を付けていない/着手者待ち
  • C. 着手済み・未完了 — コードや PR としては存在するが production パスに乗っていない or マージ未済

「やります」「やりません」を Wiki 自身が判断するのではなく、現在の合意状態を観測 して整理する。状態が変わったら本ページを更新する。

加えて 2026-05-19 以降は、usage-modes に合わせて各論点を次の 3 軸でも読む。

  • Web UI — 非専門家向け運用プロダクト (admin / api / public-viewer / 共有・公開)
  • CLI — 研究者・データサイエンティスト・agent 向け (analysis-core / 中間成果物 / PyPI / 観察用HTML)
  • 共通コア — 両モードに跨る分析品質・provider・出力スキーマ・plugin 基盤

2026-05-17 時点では gh pr list -R digitaldemocracy2030/kouchou-ai --state open も参照し、main にまだ無いが open PR として存在する作業を C に含めている。


2026-06-30 current overlay

このページ本体は 2026-05 の棚卸しを含むため、下の件数や分類だけで現在地を判断しない。2026-06-30 19:15 JST の work/kouchou-ai/main@d5c9ece、GitHub live state、議事録、work/slack-logs/main@7c17dd3 を合わせた最新の短期未決は次の 6 つである。current-status-2026-06-30より

  1. 公開事例と trust layer の placement: #564 の公開事例ページ、basic explainer / FAQ、#696 の誤読防止、#542 の責任所在は、別々の docs issue ではなく「初回説明 + 公開事例リスト + レポートの読み方 + 何を保証しないか」のセットとして扱う必要がある。最小文言案は report-reading-guide-minimum-wording-2026-06-30 にあり、未決なのは canonical copy の置き場所と承認者。
  2. tool catalog の canonical placement: 広聴AI / いどばた / Cartographer / Jigsaw Sensemaker / tttc-light-js を collect / deepen / analyze / show / classify / read-and-act に分ける draft はできたが、DD2030 website、kouchou-ai docs、8/2 event material、#564 case page のどこを正本にするかは未決。website は自然な外部正本候補だが、現状は src/kouchou-ai/case.vto 直書きで、長期は cross-product case-news list 化の issue もある。public-tool-catalog-draft-2026-06-30より website-kouchou-ai-case-live-2026-06-30より
  3. 8/2 first demo と実践 lane framing: 公式性、viewer demo、deep case のどれを主 artifact にするかが未決。候補は渋谷区 / 宇多津町 / 岩手県 / 東京都 / 舞鶴2040 / 北見 / 奈良 / 八代などに広がった。#dd_prance_event2026 では奈良 / 舞鶴2040 が地方自治側の planning lead として再浮上したが、Slack-only lead では外部 proof にせず、primary public source、source strength、政治文脈、話者・許諾確認を分ける必要がある。slack-prance-event-broadlistening-session-2026-06-30より
  4. #884 作成前確認パネルを次 code-safe slice にするか: #884 / #221 は 19:15 JST 時点でも open / high priority / unassigned で、current main には未実装。first PR の契約は issue-884-pre-create-review-contract-2026-06-30 に切り出し済みだが、AI が着手するなら issue assign と human decision が必要。development-next-actions-live-2026-06-30より
  5. docs-safe PR 順序: #876 developer docs、#877 Windows setup、#885 Node runtime 排除、#696/#542 reading guide は、同じ docs 群でも reader contract が違う。次に本体 repo へ出す PR を 1 本選ぶ必要がある。docs-issue-map-2026-06-30より
  6. Azure demo / SaaS 境界: 6/5 に viewer 公開と admin 共用は進める方向へ倒れ、1 ヶ月専用試用環境は優先度低、365 日 SaaS は提供主体・責任範囲の整理項目として残った。したがって A2 は「全部未定」ではなく、公開事例 / サンプルレポート / reading guide で参照環境の価値を補う段階に移っている。azure-demo-visibility-thread-resolution-2026-06-05より

この overlay は下の A/B/C 棚卸しを置き換えるものではなく、2026-06-30 時点で人間の判断を使うと次の作業が動く場所を示す。思考ハブは thinking-targets。公開事例ページには事例 detail だけでなく初回説明 FAQ / 一枚絵 / 説明資料導線も必要であり、tool catalog draft は #564 / 8/2 へ転用できる形になった。19:15 JST の live check で GitHub 状態は 18:44 JST から変わっていない。github-issues-564-696-542-trust-layer-live-2026-06-30より public-tool-catalog-draft-2026-06-30より development-next-actions-live-2026-06-30より

A. 未定(合意なし/対立あり)

A-Web UI

A1. 散布図の維持 vs 廃止

meeting-minutes 2025-10-08, 2025-10-01:

  • ken-san:「散布図を見て満足する時代ではない、インサイト発見を中心にせよ」
  • nishio:少なくとも 2026-09 の書籍版リリース時点までは現行の散布図を温存する。より良い可視化が見つかれば、まずは併用し、最終的にデフォルトをそちらへ移すこともあり得る、というスタンス。

技術的にも UMAP→クラスタリングは精度トレードオフを抱えており(pipeline)、代替を 解析 plugin で実装するのか/散布図そのものを縮退させるのか 未決。

A2. 静的 HTML のホスト先戦略

非エンジニアユーザが 静的書き出し HTML をどこに置くかは 2025-04 〜 2026-05 で毎週議論され続けて未着地。候補:

  • SaaS ホスト kouchou-ai.dd2030.org(dd2030 の体制不足で先送り、anno: 「少なくとも 7 月末まで実現困難」2025-04-09)
  • 埋め込み fetch 型 HTML
  • BASIC 認証付き Azure ホスティング

「広く使ってもらう」上で最大の摩擦点だが、責任主体が定まらない。

2026-06-01 定例では、developer-quickstart の読者像整理と合わせて 「自治体担当本人 / 組織内デモ役が一番欲しいのは、自分で構築しなくても触れる環境」 という論点が明示された。nishio は少なくとも現 Azure 環境で「見せる」ことは手軽にした方がよいとしつつ、課金して秘密情報を入れて分析する SaaS 本番運用とは別問題として切り分けた。meeting-minutesより

同じ議論で、1 つのインスタンスに複数ユーザの秘密情報を入れるのは避けるべきで、やるならユーザごとに現 Azure デモ環境相当を丸ごと複製する方向が示された。一方、ユーザに admin を触らせず、データ投入は運営側が行い、report viewer だけ見せる案も出たが、admin 画面で試行錯誤する体験自体に価値があるかどうかは未決のまま残った。meeting-minutesより

2026-06-04 に nishio が dd2030 Slack で Ohki さん宛に 4 問の具体質問として整理した。(Q1) viewer 公開、(Q2) admin 画面共用 + 「共用環境なので秘密情報を入れないで」明示、(Q3) Github admin (大木さん他) がワンクリックで上げる 1 ヶ月専用試用環境、(Q4) 365 日稼働 SaaS は大木さん不参加の確認、の 4 層。Q3 は「ユーザごとに現 Azure デモ環境相当を丸ごと複製」案を on-demand provisioning + Github admin トリガー + 1 ヶ月期限つき、として具体化したもの。azure-demo-public-visibility-proposal-2026-06-04 / nishio-slack-azure-demo-visibility-proposal-2026-06-04より

2026-06-05 に大木さんから返答があり、nishio 決定として着地した。viewer 公開と admin 共用は進める (前提: デモ環境の API キーの扱いを、利用者が自分のキーを入れて使う形にそろえる。現在のキー構成は公開 wiki には書かず、Google Drive「広聴AI-Azureデモ環境」で扱う。公開時に「共用 / 機微情報禁止 / データ保存・継続稼働非保証」の 3 点明示)。1 ヶ月専用試用環境は優先度低で保留し、代わりに「公開事例 / サンプルレポート / サンプル CSV を見せる導線の充実」が自治体ユーザ向けの優先方向となった。365 日 SaaS は提供主体・責任範囲の整理項目化 とし、責任を持って継続運用・サポートできる主体を立てる方向で未着地のまま残す。あわせて、デモ環境の現時点の価値は「自分たちのデータを投入して試す場所」よりも「使い方や準備すべきデータを理解するための参照環境」として見直す再フレームが出ている。azure-demo-visibility-thread-resolution-2026-06-05 / azure-demo-public-visibility-proposal-2026-06-04より

A3. DB 導入のタイミング

meeting-minutes 2025-05-21, 2025-06-25 で毎回「v4.0 のあたり」と言いつつ毎回先送り。ファイルストレージ継続が暗黙の現状維持。SQLite 候補が nasuka の cluster-title 編集 (PR #545) で検討されたが採用されず。

A4. private-by-default にすべきか

meeting-minutes 2025-04-23 / Issue #341:YouTube 風 unlisted は PR #500 で実装済み。ただし 「unlisted default」と「private default + unlisted opt-in」のどちらが正しいか は議論残存。

A5. 多言語 i18n の扱い

meeting-minutes 2026-01-26:「v5.0 リリースは日本語ユーザにフォーカス」が方針だが、Polis など外部ツール への plugin 経由ブリッジは “maybe”。英語版書籍/英語ユーザベース との関係はオープン。

A6. レビュー/マージ基準

meeting-minutes 2025-05-07 〜:「壊れても OK」スタンスは採用されたが、ohki-shingo のレビュー困難度マトリクス(A: スキルセット / B: 工数 / C: 環境 / D: 基準なし)は分類どまり。具体的なマージ基準 は PR テンプレ以上には固まっていない(contributing)。

A7. モバイルでの散布図表示(2026-09 に最小範囲を決定、A から除外)

meeting-minutes 2025-07-30(チームみらい 61 レポート運用フィードバック):30,000 点散布図のスマホ表示は構造的に難しい。当時は「共有時にズーム済みビューを送る」という部分的な解決だけだった。2026-05 には、スマホでは散布図を最初から interactive chart として出さず、静的画像やサムネイルで見せてタップ時だけ全体インタラクティブビューに移る案も出た。chart-scroll-ux-decisionより

PR #933(2026-09-09 JST merge、Issue #872 を close)で、初期表示を指定していないレポートは、幅 600px 以下では階層リストを入口にする という最小範囲に決まった。本体 docs の docs/development/mobile-reading.md は「専用画像の生成や新しいレポート形式は導入しません」と書いており、静的画像の案は採らない。したがってこの項目は A(未定)から外れる。ただし散布図そのものの課題(縦長画面での表示 Issue #121、クラスタラベルの重なり Issue #266)は別の課題で、2026-10-21 時点で open のまま残っている。

A8. パブコメ攻撃対策のステップ 3〜4

meeting-minutes 2025-03-26, 2025-04-23:4 段階対策(効率化 → 検証可能性 → フィルタリング → 認証)のうち、ステップ 1-2 のみ着手(nishio の pubcom-seiri 等)。3-4 は未定。

A-CLI

A9. ipynb 研究の置き場所

meeting-minutes 2025-10-08 で nishio の「A: ipynb / B: CLI / C: WebUI / D: ホスト型デモ」分類は議論されたが、リサーチ ipynb をリポジトリ内のどこに置くか/別リポジトリにするか 未決(現在は外部 nishio/broadlistening-research/ などに散在)。

A-共通コア

A10. 可視化 plugin の Python 化

plugin-system:docs/development/why-plugin-system.md は「3 軸目」として可視化を挙げるが、バックエンド側に Python plugin システムは存在しない。フロント側 apps/public-viewer/ の ChartType extensible 化(commit 05b6c11)が先行している。バックエンド/フロントどちらで提供するかの設計判断は未決。

A11. 「LOCAL LLM」というカテゴリ名

2026-05 の HTTPS バグを受けて「LOCAL という命名が実装にバイアスを与えていた」教訓があるが、リネーム提案までは至っていない(llm-providers)。

A12. 広聴AI紹介論文の投稿戦略

kouchou-ai-paper-draft-strategyで整理した通り、広聴AIを紹介する論文を書く価値自体は高いが、日本語論文を主成果物にするのか、英語投稿を主成果物にするのか は未決である。Polis / vTaiwan 型の制度・プロセス記述に寄せるのか、Birdwatch / Community Notes 型の評価論文に寄せるのかでも必要データが変わる。kouchou-ai-paper-draft-strategyより

A13. ドリルダウンのツリー表示と ズームできる付箋表示の置き場

retrospective-2026-10-28:ドリルダウンのツリー表示は、2025 年参院選のチームみらい(policy-pr-hub)で作った「クラスタを展開して最下層で個別意見まで辿る階層 bullet list」で、2026-01 に公開ビューアの可視化 plugin「階層リスト」として移植済みだが、サンプル plugin のままで既定の見せ方になっていない(「提供してもウケない」という観測事実と、「細かいクラスタまで全部見るならツリービュー向き」という 2026-05-30 の整理が並立)。付箋表示は nishio の canvas_kozaneba_prototype(semantic zoom、既定画面に未統合)。階層リストを「詳細モード」の正式 view にするか、付箋表示を CLI の standalone HTML か公開ビューアの plugin か Kozaneba 側のどこに置くか が未決。#250・#60・#880 が関連。

  • 2026-10-29: 階層リストは「全部読む」詳細モードとして PR #1166(#1159)で位置づけ直し(既定は散布図のまま)
  • 2026-11-07: #1166 が main に merge(7253efcc)、#1159 は close。A13 のうち階層リストの位置づけは決着し、残るのは付箋表示の置き場の確定と書き出し契約(公開用 artifact public_result.json との関係)。階層表示系の #60 は着手待ちが解け、#250 は最下層の出典リンクでどこまで満たせたかの照合が残る
  • 2026-11-07: nishio の方針。付箋ズーム・ツリー表示・マンダラートなどの可視化は、nishio の個人 repo で作ってカタログ化し、本体に入れるかはそこで試してから決める。共通の題材は team-mirai-2025-open-dataset(Hugging Face、CC BY 4.0、意見 21,348 件、20/400 クラスタ)。このデータは公開用 artifact public_result.json の項目とほぼ 1 対 1 に対応するので、可視化は public_result.json の形を読む作りにして、データセットからは変換スクリプト 1 本で揃える(本体に移すときに plugin を書くだけで済むように)。これで 10-29 の暫定の意向(standalone HTML と Web plugin の両方)は「まず個人 repo、Web plugin は昇格の判断後」に置き換わる。マンダラート(#880)は nishio の案で、8 分割を意見 1 枚になるまで再帰的に繰り返す形にする。既定の階層づくり(下から併合)では子の数が 8 以下に揃わないので、上から割る分割が別に要る(team-mirai-2025-open-dataset)
  • 2026-11-07: カタログの置き場を nishio/broadlistening-visualizations として作成し、最初の項目として意見マンダラートの試作を GitHub Pages で公開(表札は LLM 不使用の代表意見)。次は付箋ズームと、上の段の表札を LLM で付けるかどうか
  • 2026-11-11: nishio の方針の確認。可視化を試すたびに本体(公開契約やビューア)を直すのでは、個人 repo に切り分けた意味がない。試作は今の契約の中で描く。題材の列は変換スクリプトで arguments[].attributes(自由形式)に入れ、どの属性が何か(同じ投稿を束ねる・日時など)は URL 引数で渡す。足りない項目は、本体に入れると決めたときの材料として個人 repo の README に残し、試作の段階では契約の変更を提案しない。AI が new-visualization-axes-2026-11-11 のあとに、属性の型と役割を宣言するキー(attribute_meta の案)と、#1165 の公開設定の許可リストに賛否の対象などを足す小さな PR を判断に上げたことへの答え。同日、散布図が描いていない軸の可視化 4 つを、契約を変えずに公開した
  • 2026-10-29: 付箋表示の置き場について nishio の暫定の意向は 「CLI の standalone HTML と、Web(公開ビューア)の可視化 plugin の両方」(Kozaneba 側には置かない)。同じ結果 JSON から描く前提なので、先に決めるのは結果 JSON からの書き出し契約(意見・座標・クラスタの経路・表札)で、描画は canvas 試作の知見を両方で使う。確定の判断と着手順は未定(post-review-product-direction-2026-10-28 の順序 4)

A14. tokoroten の賛否分離 2 手法(センチメント次元の付与・DivCon)の取り込み

retrospective-2026-10-28:どちらも tokoroten の個人 repo にあり本体未収録。賛否スコアを opinion_classification(#971)と同じ「意見ごとの属性」として CLI に入れる案が最小。DivCon は llm_grouping 系の mode として対立軸の capability を先に決める必要がある。本体に入れるか自体と、入れるなら主担当 が未決。


  • 2026-10-29: 前段として賛否スコア・新規性スコアを「意見ごとの属性」にする CLI 任意ステップを PR #1165(#1158)で実装(post-review-direction-issues-2026-10-29)
  • 2026-10-29: nishio の方針。2 手法(センチメント次元の付与・DivCon)は本体に取り込まず、docs から「成熟していない関連研究」として紹介する形にする。入れるとしても CLI から。したがって A14 の「本体に入れるか」は当面「入れない」で、残る作業は docs 側の紹介ページ(手法の要点・tokoroten の repo / デモへの pointer・最終確認日・本体の属性ステップとの関係)を書くこと。主担当の確認と評価データの確保は、CLI で試す段階になったら改めて
  • 2026-10-29: 紹介ページを本体 docs の PR #1174(Issue #1173)として作成(未 merge)。docs/development/related-research.md に 2 手法と farbrain を「名前 / 一文説明 / 所在 / 状態 / 担当 / 最終確認日」の表と「要点 / 所在 / 本体との関係」で載せ、所在 URL は同日に到達確認。これで A14 の残作業は merge 判断と、tokoroten 本人による書き方の確認だけになる
  • 2026-11-08: 本体の判断は変えずに、DivCon を nishio の個人 repo のカタログで試した(team-mirai-2025-open-dataset の「個人 repo のカタログ」)。広聴AI の上位クラスタをトピックにして Stage 3a〜5 を回す形で、チームみらいのデータの 4 まとまり・2,167 件に軸 12 本。本体に載せるなら、意見ごとの採点は arguments[].attributes に入るが、軸の定義を置く省略可能なキーが public_result.json に要る(個人 repo の README に提案)
  • 2026-11-08: 同じく本体の判断は変えずに、センチメント次元の付与を個人 repo の賛否スライダーで試した。賛否スコアは本体の opinion_stance と同じ形・同じ既定プロンプト。重みを上げるとエネルギー・移民は賛否で分かれ(シルエット 0.7 台)、話題の近さは 1〜2 割落ちる。本体に載せるなら、何への賛否かを public_result.json に置く省略可能なキーが要る(個人 repo の README に提案)
  • 2026-11-11: nishio の方針で位置づけを改めた。「成熟していない関連研究」とは呼ばず、「まだ本体に取り込まれていない周辺の研究・実験」として紹介し、こうした本体外の試みを奨励する。#1174 のページ名を「周辺の研究・実験(本体未収録)」に変え、本体を変えずに public_result.json や CLI 出力で試すことを歓迎する節(自分の repo で公開してページに 1 行足せばよい)を足し、nishio の可視化カタログ(nishio/broadlistening-visualizations)をエントリに加えた。#1158 が main に入ったので、賛否・新規性スコアは opinion_stance / opinion_novelty へのリンクにした。main を merge して nav の衝突を解消

B. 方針決定済み・未着手

B-CLI

B1. extraction.skip: true オプション

meeting-minutes 2026-05-18 見出し:「整形済みデータで extraction を skip したい」を nishio が AI からの示唆で発議、合意感あるが PR は未提出。複数回希望されているが手付かず(gotchas)。

B2. クラスタ数のデフォルト自動算出

meeting-minutes 2026-05-18 見出し:「クラスタ数を optional にし、データ件数から ∛n で自動算出」方向で合意。PR #832 は merge され、analysis-core で cluster_nums 未指定時に extraction 後の argument 数から cube-root rule を使う実装が入った。したがってこの項目は 「未着手」ではなく一旦着地済み。
残る open question は、README / getting-started / how-to-use の「コメント数ベース」説明を argument 数ベースへ揃えるかどうか、と読む方が正確。詳細は auto-cluster-defaults。

B3. PyPI リリース運用の硬化

analysis-core-v* tag push 起点の .github/workflows/publish-analysis-core.yml は current main にあり、analysis-core-v0.1.2 で publish success も観測済み。したがって「自動 publish が無い」は古い。
未完なのは、apps/api 互換テストまで release gate に入れるか、PYPI_API_TOKEN 維持のまま行くか Trusted Publishing へ寄せるか、package slimming 後の release gate をどこまで厳しくするか、という 運用の硬化 である。pypi-auto-release-requirementsより pypi-release-triggerより

なお「tag 付けまで自動化するか(merge to main で自動 release するか)」については、2026-05 時点では しない方が良い と整理した。0.1.x 段階で破壊的変更が頻繁なこと、release gate が package 内 test のみで apps/api 互換まで張れていないこと、書籍リリース等で release 時期を握りたいことが理由。先にやるべきは Trusted Publishing 移行と TestPyPI 経路の整備。pypi-release-timing-automationより

B7. 外部 plugins/analysis/ ディレクトリの実利用

loader (plugin/loader.py) は Path.cwd() / "plugins" / "analysis" と ANALYSIS_PLUGINS_PATH 環境変数を探す実装になっているが、リポジトリにこのディレクトリは無く、外部 analysis plugin の同梱もゼロ。枠だけ用意して利用例なし。

B8. --skip-interaction argparse バグ修正

cli:--skip-interaction は action="store_true" + default=True なので、CLI から False に戻せない。既知だが修正未着手(2026-10-21 の main で確認)。修正方針自体は単純(store_false 化など)。同じ形だった --without-html は PR #825(2026-05-18 merge)で default=False に直っている。

B-Web UI

B9. packages/ui-shared/ 共有 UI パッケージ

歴史的には refactoring phase docs と naming_convention.md に計画記載があったが、current source tree に残るのは naming_convention.md のみで、ディレクトリ自体は未作成。apps/public-viewer/ と apps/admin/ の共通コンポーネント整理(Issue #586)と紐づくはずだった。#586 は 2026-11-02 の棚卸しで「複数アプリで共有する基盤は pnpm workspaces(packages/report-schema、apps/shared)で達成」として close(completed)された。デザイントークンの共通パッケージは、トークンが出てきた時点で別 Issue にする扱い(stale-issue-disposition-2026-11-02)。packages/ui-shared/ は 2026-11-03 時点でも未作成。

B-共通運用

B10. ルート CHANGELOG.md 整備

docs/development/pypi-release.md などからの参照はあるが、ファイル自体が存在しない。バージョン履歴は git log のみ。

B11. CodeRabbit 運用の深掘り

CodeRabbit は 2025-05 から PR を自動レビューしており、設定は .coderabbit.yaml にある。当初(main@3809a7a)は reviews.auto_review.drafts: true だったが、PR #817(2026-05-18 merge)以降は drafts: false の 3 行だけで、draft PR は自動レビューしない。したがって「未配線」は古い。
一方で、レビュー対象の絞り込み、除外ルール、コメント運用方針はまだ薄く、導入後の運用設計 は詰め切れていない。

B12. YAML ベース workflow 定義

packages/analysis-core/src/analysis_core/plugin/loader.py は YAML manifest を読む実装になっているが、実態の workflow は workflows/hierarchical_default.py(Python のみ)。current source tree に YAML workflow 定義の実例はない。

B13. PR レビュー責任の AI 生成 PR への拡張

coding-agents:Devin / Copilot Agent の PR をどこまで人間が引き取るかの線引きは PR テンプレ以上に明文化されていない。draft 扱い+ CLA 範囲は決まっているが、マージ判断者の責任範囲は曖昧。

B14. LLM grouping 系 LLM 分類の互換枝

slack-dev-kouchouai-2026-q1 2026-02-11, 2026-02-25:まずは extraction, embedding の後ろで LLM クラスタリングに分岐する 方針が語られている。理由は、既存のパイプラインや可視化との両立を保ったまま分析プロセス切り替え部分を検証したいから。

同 source ではさらに「既存のカテゴリーツリーをパラメータとして与える亜種」も明示されており、自治体の予算カテゴリに合わせたいという具体的ニーズがある。意図はかなり明確だが、main / open PR にまだ対応実装は見えない。

2026-05-18 時点では open PR #827 が source repo ルートに PLAN_llm_grouping_capabilities.md を追加し、analysis_mode=llm_grouping、analysis_capabilities 自動導出、viewer 側 requirements 判定まで含む段階計画を具体化している。したがって 「意図しかない」段階は脱したが、なお doc-only で実装未着手 と見るのが正確。pr-827-llm-grouping-capabilities-plan-2026-05-18より


C. 着手済み・未完了(実装あり/production 未到達)

整理のため Phase 進行中/PR 出てる項目もここにまとめる。詳細は refactoring-status。

C-Web UI

C1. PR #824 — LOCAL LLM の HTTPS 対応(2026-10-19 に着地、C から除外)

この PR は 2026-05-18 に merge され、analysis-core の services/llm.py は local_llm_address に完全な URL を受け取る helper と LOCAL_LLM_API_KEY 対応を持った。API の分析実行(apps/api/src/services/report_launcher.py)も analysis-core を subprocess で起動するので、分析の経路はこの時点で HTTPS / 完全な URL に対応した。ただし admin の /admin/models 用のモデル一覧取得(apps/api/src/services/llm_models.py)は host:port を http://.../v1 に組み立てる旧前提のまま残り、2026-05 時点では「基幹処理は完了、admin 補助経路は未統一」として C に置いていた。pr-824-local-llm-https-observation-2026-05-19より

PR #1038(2026-10-19 merge)で、モデル一覧取得もパイプラインと同じ resolve_local_llm_base_url() と LOCAL_LLM_API_KEY を使うようになった。admin の接続確認(/admin/environment/verify)も analysis-core の同じ LLM 呼び出しを経由する。したがってこの項目は C から外れる。残るのは使い方の案内だけで、2026-10-21 時点でも admin の入力欄の placeholder(ollama:11434)や API の説明文の例は host:port 形式しか示していない(完全な URL も受け付ける)。詳細は llm-providers。

C-共通コア

C2. フロント側可視化 plugin 基盤

apps/public-viewer/components/charts/plugins/ に registry / types / validation と built-in plugin (scatter, treemap, hierarchy-list) がある。基盤自体は既に main にある。
未完なのは、外部 plugin ロードやバックエンドの「第 3 軸」としての統一設計まで含めた完成形。


進行のスナップショット(2026-05 時点)

カテゴリ件数
A. 未定12
B. 方針決定済み・未着手11
C. 着手済み・未完了2

この表は 2026-05 時点の棚卸しの件数(A12 を足した 2026-05-19 以降の項目数)。その後、A7 は 2026-09 に決着し、C1 は 2026-10-19 に着地したので、2026-10-21 時点で C に残るのは C2 の 1 件である。A10 と B14 も前提や状態が変わった(2026-10-14 の追記を参照)。A・B のほかの項目は 2026-05 以降まとめて再確認していないので、件数だけで現在地を判断しない。

「決まったが手が無い」(B) が A(未定)と並んで多い、というのは コントリビュータ募集をかける際にここから候補を引くと効率的 であることを示唆する。ただし候補として拾う前に、その項目の現状を main と open PR で確かめる(着地済みの項目が混ざっている)。加えて usage-modes の軸で見ると、Web UI 専任の人は A-Web UI / B-Web UI / C-Web UI を、分析コア寄りの人は A-CLI / B-CLI / C-共通コア を優先的に追うと読みやすい。

観測手順

このページのステータスは状況依存。月単位で見直すには:

  1. meeting-minutes の最新数回をスキャン(特に「Open Questions」や「次回に向けて」項目)
  2. main の tip と PR 一覧(gh pr list -R digitaldemocracy2030/kouchou-ai)を確認
  3. current source tree と refactoring-status を照合し、削除済みの phase docs を前提にした stale claim が残っていないかチェック
  4. 該当する refactoring-status と本ページを同期して更新

Updates

  • 2026-10-28: A13(ドリルダウン / 付箋表示の置き場)と A14(tokoroten の賛否分離 2 手法)を追加(retrospective-2026-10-28)
  • 2026-10-29: A13・A14 に、着手済みの PR(#1165・#1166)と未決部分の注記を追加
  • 2026-10-29: A13 に付箋表示の置き場についての nishio の暫定の意向(standalone HTML と Web plugin の両方)を追記
  • 2026-10-29: A14 に nishio の方針(本体に取り込まず docs で関連研究として紹介、入れるとしても CLI から)を追記
  • 2026-06-30: 19:15 JST の live check と #dd_prance_event2026 source を反映し、current overlay を 5 件から 6 件へ補正。8/2 は first demo と実践 lane framing を分け、#884 は次 code-safe slice の人間判断項目として追加した。
  • 2026-06-30: public-tool-catalog-draft-2026-06-30 を current overlay に追加し、短期未決を 4 件から 5 件へ補正。tool catalog の canonical placement を #564 / 8/2 / docs の人間判断項目として明示。
  • 2026-06-30: website-kouchou-ai-case-live-2026-06-30 を反映し、DD2030 website は短期外部正本候補だが、現行は case.vto 直書き、長期は横断 case-news list 未決として overlay を補強。
  • 2026-06-30: current-status-2026-06-30 をもとに current overlay を追加し、#564/#696/#542 trust layer、8/2 first demo、docs-safe PR 順序、Azure demo / SaaS 境界を短期未決として明示。
  • 2026-05-17: 初回作成 — 議事メモ+コードリーディング結果を 3 分類で整理
  • 2026-05-17: main@3809a7a を再確認し、CodeRabbit は「未配線」ではなく最小導入済みへ修正
  • 2026-05-17: apps/api/src/services/report_duplicate.py / docs/user-guide/reuse-report.md / admin UI を確認し、レポート再利用機能は C から除外
  • 2026-05-17: 可視化 plugin 基盤は frontend 側で実装済み、LOCAL LLM HTTPS は main では未完了寄りに補正
  • 2026-05-17: gh pr list で open PR を確認し、C カテゴリが「main 未反映だが open PR に存在するもの」を含むことを明記
  • 2026-05-17: #2_開発_広聴ai ログから、LLM grouping 系 LLM 分類の互換枝と taxonomy-guided 亜種を B に追加
  • 2026-05-18: A7 に、モバイルでは「静的画像 → 全体インタラクティブビュー」案も候補であることを追記
  • 2026-05-18: PR #827 により、LLM grouping 系 LLM 分類の互換枝は doc-only の計画 PR として具体化した、と B14 を更新
  • 2026-05-19: PR #825 / PR #824 merge 後の current main@55e93e1 を確認し、前者は CLI 観察用HTMLと Web 主経路を分けて整理し直し、後者は analysis 実行完了だが /admin/models が旧前提のまま、と補正
  • 2026-05-19: usage-modes に合わせ、各状態の中を Web UI / CLI / 共通コア の読み筋でグルーピング
  • 2026-05-21: Phase 3b の完了判定を議論しやすくするため、phase3b-exit-criteria への導線を追加
  • 2026-06-01: A2 に、自治体担当本人 / 組織内デモ役向けの Azure 体験環境 priority、秘密情報を扱う SaaS 本番運用との切り分け、ユーザ単位環境複製 vs viewer-only デモ vs admin 試行錯誤体験の未決論点を追記
  • 2026-05-21: main@0e1552d を確認し、PR #840 相当 merge 後は Phase 3b を B から除外。残課題は Phase 8 / extras 分割 / status semantics follow-up 側へ移ったと整理
  • 2026-05-21: main@42d2afb で PR #843 merge を確認し、B4 の extras 分割を除外。あわせて open PR #844 の analysis-core CLI preflight を C4 として追加
  • 2026-05-21: main@5d591ef で PR #844 merge と Issue #836 / #837 close を確認し、C4 の analysis-core CLI preflight 項目を除外
  • 2026-05-23: maintainer 判断 report-html-non-web-canonical-decision-2026-05-23 を反映し、report.html の Web canonical 化を open decision から外した
  • 2026-05-24: work/kouchou-ai/main@e5ed743 を確認し、legacy cleanup merge 後は Phase 8 が open decision ではなくなったため B5 を除外。current tree から消えた phase docs への参照も補正
  • 2026-05-25: A1 の nishio スタンスを訂正。「チームみらい等の宣伝用途」という外部顧客像に紐づけた表現は不適切で、実際は「少なくとも 2026-09 書籍版リリース時点までは温存」「より良い可視化が見つかれば併用→デフォルト切替も可」という時間軸のある立場である
  • 2026-06-04: A2 に azure-demo-public-visibility-proposal-2026-06-04 への接続を追記。nishio が Ohki さん宛に Slack で 4 問 ((Q1) viewer 公開 / (Q2) admin 共用 + 秘密情報禁止明示 / (Q3) Github admin ワンクリックの 1 ヶ月専用試用環境 / (Q4) 365 日 SaaS 不参加確認) として decompose した
  • 2026-06-05: A2 に azure-demo-visibility-thread-resolution-2026-06-05 による着地を追記。viewer 公開と admin 共用は進める (前提: API キーの扱いを利用者のキー前提にそろえる、3 点明示文言)、1 ヶ月専用試用環境は優先度低 + 公開事例導線が代替方向、365 日 SaaS は提供主体・責任範囲の整理項目化、デモ環境の価値は「参照環境」へ再フレーム
  • 2026-10-07: lint 注記。短期未決 4 の #884 は 2026-09-08 に PR #922(作成前に入力とAPI接続状態を確認する画面)で CLOSED(nishio 担当)。#221 は open のまま。2026-06-30 overlay の他項目(8/2 event 等)は日付を過ぎており、現在の判断待ちは current-status-2026-10-05 を先に見る
  • 2026-10-14(ヘルスチェック追記): B14 の LLM grouping / LLM 直接分類は analysis-core に出荷済み(builtin plugin + workflow、#866 MERGED、admin/api 受け渡しは #176/#987 で main 入り)。A10 の backend Python plugin system は存在する(#746 でコア/実験拡張を分離、register_all が 10 plugin を登録)。両項の未決は『scatter を持たない mode の visualization / capability 契約』に絞られる。詳細は plugin-system。また本ページ冒頭の『現在地は current-status-2026-10-05』案内は v4.1.0・docs 大掃除より前なので、現在地は meeting-report-draft / kouchou-ai-docs-overhaul-2026-10 を参照。
  • 2026-10-21: main b71e0b79 と照合し、A7(PR #933 で最小範囲が決まり A から除外)、B8(--without-html は PR #825 で修正済みのため --skip-interaction に絞る)、B11(PR #817 以降は drafts: false)、C1(PR #1038 で着地し C から除外)を書き直し、件数表の A を 11 から 12 に訂正。あわせて公開境界に合わせ、A2 と 2026-06-05 の行からデモ環境の現在のキー構成についての記述を外した
  • 2026-10-29: A14 の紹介ページを PR #1174 として作成。2026-06 の「実験的機能カタログ」提案(experimental-features-catalog-proposal-2026-06-03)の最終確認日ルールを、この 3 件で初めて本体 docs に実装した形
  • 2026-11-03: B9 に、#586 が 2026-11-02 に close(completed)されたことを反映(GitHub の close コメントで確認)。B9 を残すか外すかは未判断
  • 2026-11-07: A13 に #1166 の merge を反映(階層リストの位置づけは決着、付箋表示の置き場が残る)
  • 2026-11-07: A13 に、可視化を個人 repo のカタログで試してから本体への昇格を判断する方針と、共通データ team-mirai-2025-open-dataset を追記
  • 2026-11-08: A14 に、DivCon を個人 repo のカタログで試した結果と public_result.json に足りない項目を追記(方針は不変)
  • 2026-11-11: A13 に、試作は今の契約の中で描き、試作の段階では本体の契約の変更を提案しないという nishio の方針の確認を追記