Skip to content

PROGRESS.md

Latest commit

 

History

History
719 lines (649 loc) · 87.4 KB

PROGRESS.md

File metadata and controls

719 lines (649 loc) · 87.4 KB

Yuhitsu — 進捗管理

最終更新: 2026-05-02(フォーム型テンプレート簡素版 + サイドバー α/γ 両対応 + letter テンプレ廃止、Sprint 3 完了) 現在のフェーズ: Phase 1 — Sprint 3 完了。次は Phase 2(差別化機能の成熟化 + 内蔵 AI)に向けた整理

Phase 0: 調査 & PoC(~2週間想定)

目的

Typstudio fork 路線 vs ゼロスタート路線の判断材料を集め、技術的実現性を確認する。

タスク

環境準備

  • 作業ディレクトリ作成 ~/Projects/yuhitsu/
  • Typstudio clone(~/Projects/yuhitsu-refs/typstudio/, shallow depth=50)
  • Tinymist clone(~/Projects/yuhitsu-refs/tinymist/, shallow depth=50)
  • Typst 本体 clone(~/Projects/yuhitsu-refs/typst/, shallow depth=50)
  • git ブランチ master → main にリネーム

Typstudio 分析

  • LICENSE 確認 → GPLv3 / Apache-2.0 と非互換、fork 不可
  • Cargo.toml / package.json の依存確認(typst v0.11.0, tauri 1.6, monaco 0.47, svelte 4)
  • src/ のアーキテクチャ把握(src-tauri ≒1000 LOC, src ≒1400 LOC)
  • 使用エディタライブラリの特定 → Monaco
  • 使用 typst crate バージョン → 0.11.0(現行 v0.14 系から 2 世代遅れ)
  • リポジトリアクティビティ → 実質停止(最終実装 2024-03、作者が archive 予告)
  • cargo check 実行 → time crate で失敗(深追いせず)
  • → docs/phase0-typstudio-analysis.md 完成

Tinymist 調査

  • crate 構造確認(workspace 26 crate、tinymist-query 等は path dep のみ)
  • LSP プロセスとして使う場合の起動方法・プロトコル(tinymist lsp、stdio JSON-RPC)
  • preview 機構の再利用可能性 → WebSocket + incremental SVG、流用可
  • Yuhitsu 用途での推奨統合方法 → (A) LSP subprocess 方式
  • → docs/phase0-tinymist-analysis.md 完成

路線判断

  • fork 路線のメリット/デメリット整理
  • ゼロスタートのメリット/デメリット整理
  • 所要時間見積もり(fork 13〜17 週、ゼロスタート 11〜14 週)
  • 推奨路線の提案 → ゼロスタート + Tinymist LSP 統合
  • → docs/phase0-decision.md 完成
  • 氏承認(2026-04-24):fork しない、ゼロスタート路線で確定

成果物

  • docs/phase0-typstudio-analysis.md
  • docs/phase0-tinymist-analysis.md
  • docs/phase0-decision.md
  • (判断が出たら)初期リポジトリ構成

Phase 1: MVP(Phase 0 完了後、3-4ヶ月)

Sprint 1: 環境セットアップ + 骨組み(2026-04-25 進行中)

  • pnpm 10.33.2 導入(公式 standalone installer 経由、~/.local/share/pnpm)
  • tauri-cli 2.10.1 導入(cargo install)
  • tinymist v0.14.16 導入(GitHub Releases prebuilt、~/.local/bin)
  • pnpm create tauri-app で svelte-ts + Tauri 2 骨組み生成
  • app/ サブディレクトリ配置(Cargo workspace ルート構成)
  • Bundle identifier com.barewalker.yuhitsu 設定
  • License 修正(Tauri テンプレ既定 MIT → Apache-2.0)
  • LICENSE ファイル(Apache-2.0)を repo 直下に配置
  • root Cargo.toml(workspace 宣言)/ .gitignore 整備
  • cargo check 通過(47.82s、Tauri 2 依存解決済み)
  • pnpm build 通過(1.75s、frontend production ビルド)
  • pnpm tauri dev で GUI ウィンドウ起動確認(2026-04-25 氏が確認、デフォルトの Tauri+Svelte welcome 画面表示)
  • Sprint 1 commit(91970ec feat: scaffold Tauri 2 + Svelte 5 app under app/)

Sprint 2: 基本編集ループ(ファイル開閉 → 編集 → プレビュー → 出力)

実装順序: (1) ファイル開閉 → (2) エディタ → (3) ライブプレビュー → (4) PDF → (5) 操作モード3種 → (6) LSP 統合(2026-04-26 順序見直し)。 最低限の編集 1 ループを通すことを優先し、各機能は MVP 水準でつなぐ。typst.app 風の 2 ペイン UI に早く近づけるためライブプレビューを LSP より先に着手する方針。

(1) Tauri シェル、ファイル/フォルダ開閉(c7be3c4 で完了)

  • tauri-plugin-dialog 追加(tauri-plugin-fs は使わず Rust 側 command で完結 = ハイブリッド方式 C)
  • Open File / Save の Tauri command(.typ 想定、UTF-8、open_file / save_file)
  • Svelte 側ツールバー(開く / 保存 / 名前を付けて保存)+ Ctrl/Cmd+O / S / Shift+S
  • dirty 状態管理(* マーク、onCloseRequested で終了時の確認)
  • Open Folder(将来のファイルツリー用、最低限のディレクトリ選択)— Sprint 2 (2) 以降に繰越(現時点で不要)

(2) CodeMirror 6 + Typst syntax highlight

  • CodeMirror 6 を Svelte に組み込み(@codemirror/state, @codemirror/view, @codemirror/commands)— commit 977c59b
  • dirty 状態で終了確認 → 「はい」で閉じない問題を修正(core:window:allow-destroy 追加)— commit 38b3017
  • Typst 用 syntax highlighting(codemirror-lang-typst v0.4.0、Apache-2.0、Typst 公式 typst-syntax を WASM 化)— commit 2d576d6
    • 2026-05-02 で暫定無効化:上流 issue #5(単一 transaction 内に複数 changes で WASM panic)が #figure 末尾編集で発火するため、langExtension を return [] で固定。Phase 2 で StreamLanguage ベースに置き換え予定
    • vite-plugin-wasm + vite-plugin-top-level-await 導入(WASM ESM 対応)
    • SvelteKit hydration の TDZ 回避のため Editor.svelte を動的 import
    • One Dark 風の自前 HighlightStyle を Prec.highest で同梱版に優先させる
    • t.list(- +)・t.definitionOperator(/)など Typst 固有タグをカバー

(3) Live preview pane(順序を上げて Sprint 2 内で先行実装)

  • tinymist preview を起動(subprocess、--no-open --data-plane-host 127.0.0.1:23625 --control-plane-host 127.0.0.1:23626)— commit e1881c5
  • +page.svelte を 2 ペイン化(左: エディタ、右: プレビュー)
  • iframe 方式で MVP 実装(http://127.0.0.1:23625/ をそのまま表示、tinymist 公式フロントエンド HTML を流用)
  • WindowEvent::Destroyed で subprocess を kill(プロセスリーク防止)
  • ファイル切替時の preview 再起動・既存パス保存時の自動再コンパイル動作確認
  • TCP プローブによる起動完了判定(2026-05-02、1.5 秒固定 wait を撤去。data plane / control plane の両 TCP listen を 50ms ポーリングで確認、上限 5 秒)
  • 自前 WebSocket クライアント(Rust 中継方式)(2026-05-02、tokio-tungstenite で control plane に Rust 側から接続。Tauri webview の tauri:// origin が tinymist の origin チェックで弾かれる問題を回避)
  • エディタ ←→ preview の同期スクロール(control plane の changeCursorPosition / panelScrollByPosition / editorScrollTo を使えば実装可、別タスク)
  • 編集中(未保存)もリアルタイムにプレビュー反映(2026-05-02、control plane WS の updateMemoryFiles メッセージで実装。onChange を 150ms debounce、Typst タブの時のみ送信)
  • 無題タブで preview を有効化(2026-05-02、app_cache_dir/untitled/<tab.id>.typ を仮想ファイルとして作成、Tab.virtualPath で管理。新規ドキュメントを書きながら preview を確認できる)
  • タブ単位の undo history 分離(2026-05-02、Tab.editorState に CodeMirror state を per-tab で保持、view.setState で復元)

(4) PDF エクスポート

  • MVP: tinymist compile 経由で PDF 出力(Tauri command + ツールバー + Ctrl+E)— commit af1cf8f
    • 採用根拠:既に subprocess で tinymist が動いており、最小コードで完結。フォント・パッケージ解決も tinymist 任せにできる
  • 編集中の自動保存と緑色メッセージで自動保存の事実を通知
  • 公式 typst crate を Tauri バックエンドに直接リンクする方式への移行検討(フォント同梱・カスタムレンダリングが必要になった段階で)
  • File → Export PDF メニュー(現状はツールバーボタンのみ)
  • フォントロード経路の暫定実装(同梱フォントは Sprint 3 以降)
  • 日本語テンプレート5本
    • 業務報告書
    • 稟議書
    • 議事録
    • 技術論文(材料学会スタイル等)
    • スライド
  • Harano Aji フォント同梱(2026-05-02、submodule + Tauri resources)
    • app/src-tauri/resources/HaranoAjiFonts/ に trueroad/HaranoAjiFonts を git submodule として追加。本家(SIL OFL 1.1)の更新追随は SHA を上げるだけで完結する
    • 同梱対象は Mincho/Gothic の Regular + Bold の 4 ファイルだけ(+ LICENSE / README)。tauri.conf.json の bundle.resources で fonts/<basename>.otf に名前を付け替えてバンドル。インストーラ増分は約 +22 MB
    • Rust 側に bundled_font_dir(&AppHandle) ヘルパを追加。app.path().resource_dir() 経由で dev/リリース両方のパスを解決し、tinymist preview / lsp / compile のコマンドラインに --font-path を 1 つ追加で渡す
    • 全ウェイトが必要になったら tauri.conf.json の resources に行を増やすだけで済む(submodule に元ファイルが揃っているため)
    • 確認:pgrep -af tinymist で --font-path /...resources/.../fonts が両方の subprocess に渡っていることを確認済み
  • 日本語 UI(i18n 基盤)

(5) エディタ操作モード3種ビルトイン(差別化ポイント、設定で切替)

  • OS 標準(CodeMirror 6 デフォルトキーマップ)
  • vim(@replit/codemirror-vim v6.3.0、MIT)
  • emacs(@replit/codemirror-emacs v6.1.0、MIT)
  • 設定永続化(tauri-plugin-store v2.4.2、MIT)— commit d241c6a
  • Compartment による動的切替(再マウント不要)
  • ツールバーのセレクトボックス UI(日本語ラベル: 標準 / vim / emacs)

(6) Tinymist LSP 統合(実装重く最後に)

  • Tauri バックエンドから tinymist lsp を subprocess spawn(stdio JSON-RPC、Content-Length ベースのフレーミングを Rust 側で処理)— commit 72d4f4d
  • LSP クライアントは @codemirror/lsp-client v6.2.3(MIT、CodeMirror 公式)を採用
  • 補完(#l で let link 等のポップアップ): 動作
  • 診断(typo・引数エラーで赤波線): 動作
  • hover(関数名にカーソルを当ててツールチップ): 動作
  • 定義ジャンプ / format / signature help / rename(Phase 2 以降で改善)
  • hover の Markdown 整形改善(現状は素のままで素っ気ない)
  • 未閉鎖の数式など、tinymist 側の挙動依存の診断改善

Phase 1 で並行して仕込む下準備(AI エージェント連携の素地)

  • エディタ操作 API レイヤを Svelte UI / Tauri command / 将来の MCP ハンドラから共通で呼べる形に整理 — Sprint 3 (3) で $lib/commands.ts のコマンドカタログ化が完了。{ id, label, run, ... } の形で 19 種を集約し、ツールバー / キーバインド / 設定永続化が同じ ID を参照する。MCP ハンドラから呼ぶ際もこのカタログを再利用できる構造
  • 文書状態(全文・カーソル・選択範囲・dirty)の JSON シリアライズ可能性確保
  • Tauri Store の設定領域に ai.* サブカテゴリを切る — 操作モード実装の副産物として完了($lib/settings.ts の Settings 型に領域確保済み)
  • @codemirror/merge(MIT)を評価(2026-05-02 完了、Phase 2 採用前提で依存追加済み)
    • 採用方針:unifiedMergeView(既存エディタ上に inline で diff を表示)を Phase 2 で採用
      • 別 view を作らないので Yuhitsu の 2 ペイン構成(エディタ + preview)と競合しない
      • acceptChunk / rejectChunk API が標準で付き、ユーザが各チャンクを個別判断可能
      • mergeControls で accept/reject ボタンの UI を Yuhitsu テーマに合わせてカスタム可
      • collapseUnchanged で長文 diff を折り畳める
      • allowInlineDiffs で単語単位の差分ハイライトも可
    • 不採用:MergeView(左右 2 ペイン版)— Yuhitsu の preview と競合、サイドバイサイド比較は preview 側で十分
    • 注意:Compartment 化が必要(AI 提案 enabled の時だけ extension 投入、disable で外す)。LSP / syntax highlight / vim/emacs モードとの両立は実装時に確認
    • 想定実装(Phase 2):AI が currentDoc → suggested の diff を提案 → unifiedMergeView({ original: currentDoc, ... }) を Compartment に dispatch → ユーザが各チャンクを accept/reject → accept で merge view を外す

Sprint 3: 一般ユーザに「コードを書かせない」ための橋渡し(2026-04-28 氏合意で Phase 2 前倒し着手)

狙い: 現状の「Typst を書ける人にとって便利な GUI」から「コード非経験層が文書を作れる GUI」へ転換する。Yuhitsu のターゲット(事務・営業・CUI 苦手な技術者)が初めてアプリを開いた時の体験を変える。

  • 起動時テンプレート選択ダイアログ + 多言語テンプレート + 参考文献挿入(2026-05-01 実装)
    • 初期 6 種:空ドキュメント / 業務報告書 / 技術報告書 / 議事録 / 簡易レター / スライド
    • テンプレファイル構造:app/src/lib/templates/<id>/{meta.json, ja.typ, en.typ} で同梱、Vite import.meta.glob で静的解決
    • meta.json に title.{ja,en} / description.{ja,en} を持たせ、ローダー側で locale 解決
    • 用紙サイズは本文中の {{paper}} プレースホルダで保持、document.paperSize から流し込む
    • 表示タイミング:初回起動で自動表示(D 案、flags.firstRunDone を立てて以降は出さない)+ 専用コマンド new-from-template (Ctrl+Shift+T、FilePlus2)
    • カード選択時:active タブが空タブなら本文差替、そうでなければ新規タブを作って差替
    • 設定スキーマ拡張:appearance.locale (auto/ja/en)、document.paperSize (auto/a4/letter/b5)、flags.firstRunDone
    • $lib/i18n/locale.ts 新設(navigator.language → ja/en、未対応は en フォールバック)
    • 技術報告書テンプレに #bibliography(...) を bibtex / Hayagriva 両対応のコメント付きで含める
    • 参考文献挿入コマンド(bibliography、BookOpen):.bib / .yml / .yaml ファイル選択 → 相対パス化 → 末尾に #bibliography("...") 挿入
  • GUI 挿入ボタン最小セット(太字・斜体・見出し H1〜H3・箇条書きリスト・番号付きリスト)
    • $lib/editor-commands.ts(EditorView を引数にとる純粋関数群、UI 非依存)
    • Editor.svelte に onReady / onTeardown コールバックを追加し view を親に公開
    • ツールバーに B / I / H1 / H2 / H3 / • / 1. ボタン(title でホバー説明)
    • Ctrl+B / Ctrl+I のショートカット(view 不在時はパススルーで vim Normal モードと共存)
    • 行頭マーカー切替時のインデント保持、トグル動作(同種なら除去・別種なら置換・なしなら付与)
  • GUI 挿入ボタン拡張セット(表・画像・数式・脚注・引用・コード(インライン/ブロック)・リンク)
    • $lib/commands.ts 新設:全コマンド(ファイル系 + 挿入系 19 種)を { id, label, icon, buttonClass, defaultKey, needsEditor, run } でカタログ化
    • $lib/editor-commands.ts に toggleMath / toggleInlineCode / insertCodeBlock / insertLink / insertFootnote / insertQuote / insertTable / insertImage を追加
    • 表は最小 2x2 を挿入、insertTable(view, { columns, rows }) 引数化(将来「列数指定モーダル」を増設しやすい形に)
    • 画像は #figure(image("..."), caption: [|]) で挿入し caption にカーソル(テンプレート側 #show figure: ... でスタイル統一できる Typst 流儀)
    • ツールバーを設定駆動に書き換え(toolbarItems: ToolbarItem[] を {#each} で描画、divider もデータ表現)
    • ボタンを Lucide ピクトグラム化(@lucide/svelte v1.14、ISC、tree-shakable な個別 import)
    • キーバインド一括登録(onKeydown がカタログを順次照合、effectiveKey で override → defaultKey の順)
    • プリセット 3 種(標準 / ミニマル / 論文寄り)を TOOLBAR_PRESETS で内蔵
    • 画像挿入はファイル選択ダイアログ +(getCurrentWebview().onDragDropEvent 経由の)ウィンドウ D&D、ファイル相対パスへ自動正規化(../ を含む完全相対化)
    • tinymist の --root を filesystem ルート(Linux/Mac は /、Windows は入力ドライブ)に統一(preview / PDF)。LSP の rootUri は workspace 機能のためファイルの親ディレクトリのまま
    • hover 等に出る外部 URL クリックは tauri-plugin-opener 経由で OS デフォルトに流す
    • dev_log bridge(JS → Rust stderr)を追加し、開発時にフロントログを Rust 出力で確認可能
  • ワークスペース表示制御(Sprint 3 中に氏の要望で追加)
    • プレビュー on/off トグル(ツールバーボタン + Ctrl+Shift+P、toggle-preview コマンドとしてカタログ化)
    • エディタ / プレビュー境界の可変リサイズ(pointer events ベースのスプリッタ、最小/最大 10〜90%)
    • 設定永続化(workspace.previewVisible / workspace.editorPaneRatio を Tauri Store に保存)
    • 既存設定への migration(toggle-preview を末尾に自動追加)
  • プロジェクトビュー(サイドバー、Sprint 2 (1) からの繰越を Sprint 3 内で回収)
    • Rust list_directory コマンド(全ファイル表示、隠しファイル + 定番ノイズフォルダ(node_modules / target / .git / .svelte-kit 等)を除外、深さ制限 8)
    • フロント $lib/project.ts + ProjectTree.svelte(再帰描画は Svelte 5 流の self-import)
    • ファイルアイコンを拡張子で分岐(.typ / .pdf / 画像 / その他汎用)
    • フォルダ選択(@tauri-apps/plugin-dialog の directory: true)、永続化(workspace.currentFolder)、起動時自動復元
    • ツリーからのファイル切替:.typ はエディタで開く(dirty 時の確認込み、現在ファイルのハイライト)、それ以外(PDF / 画像 / 任意)は openUrl で OS デフォルトに流す
    • サイドバー on/off + 幅リサイズ(workspace.projectViewVisible / workspace.projectPaneRatio)、toggle-project-view コマンド + Ctrl+Shift+E
    • 既存設定への migration(open-folder / toggle-project-view を自動追加)
  • プロジェクトビューの拡張(2026-05-02)
    • 右クリックメニュー:行の上で出る自前 context menu(新規ファイル / 新規フォルダ / 名前変更 / 削除)。空白部分で右クリックするとルートフォルダに対するメニュー(リネーム / 削除はルートでは安全のため非表示)。row の oncontextmenu は stopPropagation してルートメニューに上書きされないようにする
    • ファイル操作:Rust に create_file / create_folder / rename_path / delete_path コマンド追加(/、\、.. を弾くトラバーサル対策込み)。リネーム時はタブ側の path も追従、削除時は対象を含むタブを自動クローズ
    • 名前入力:自前モーダル(<input> + Enter / Escape / OK / Cancel)。VSCode 風のインライン編集は Phase 2 に持ち越し
    • git status 連携:Rust の git_status コマンドで git status --porcelain=v1 -z を呼び、絶対パス → 1 文字 status code のマップを返す。ProjectTree で行に色 + 1 文字バッジ(?・M・A・D・R・U)、CSS 変数経由でテーマ追従。git repo 以外 / git CLI が無い環境でも黙って空マップを返してエラーにならない
    • 保存後は軽量な refreshGitStatus() だけ呼んで、ツリー構造は再取得しない
  • タブ機能 + テキストファイル対応(Sprint 3 中に氏の要望で追加、競合 Typstudio との比較で必要性が浮上)
    • Tab 型({ id, path, content, dirty, cursorAnchor, cursorHead, scrollTop })、複数同時編集
    • 既存タブ再利用(同じパスならそれを active に)/ 空タブ再利用(無題かつ未編集のタブは差し替え)/ 新規タブ追加
    • タブ切替時にカーソル / スクロール位置を per-tab で保持(Editor.svelte の onValueApplied フックで親が復元)
    • タブを閉じる(dirty 時の確認 / 全閉じで空タブ自動生成)
    • ツールバー:new-tab(Ctrl+T)/ close-tab(Ctrl+W)を追加、各タブに ✕ ボタンと「+」新規ボタン
    • テキストファイル全般を開けるよう openFile のフィルタ撤廃、ツリーからは .typ / .md / .csv 等のテキスト系はタブで、バイナリは openUrl で OS デフォルト
    • Typst 以外のファイルでは構文ハイライトを plain に、LSP / preview / PDF 機能を無効化(Editor.svelte に languageMode Compartment 追加)
  • タブの永続化(hot exit)(2026-05-02、<app_data_dir>/tabs.json に file タブの path・無題タブの content・cursor/scroll・active index を保存。300ms debounce で都度書き出し、終了時に flush。復元時は file は再 open、無題は新仮想 path に content を書き込んで dirty=true で復活)
  • タブの D&D 並び替え(HTML5 Drag and Drop API、依存追加なし、ドラッグ中は半透明 + ドロップ先に左ボーダー)
  • Ctrl+Tab / Ctrl+Shift+Tab / 中ボタンクリックでのタブ操作(2026-05-02、next-tab / prev-tab コマンドをカタログ追加。WebKitGTK が Ctrl+Shift+Tab を focus traversal で消費する制約のため、Ctrl+PageUp / Ctrl+PageDown(VSCode 流儀)を併設。CommandDef.defaultKey を string \| string[] に型拡張して 1 コマンド複数キーバインドに対応。中ボタンはタブ pointerdown で button=1 を捕まえて closeTab)
  • テーマ機能(自動 / ライト / ダーク)(Sprint 3 中に氏の要望で追加、Phase 2 予定の前倒し)
    • 全 UI 色を CSS 変数化(app.html の :root に 27 種、背景・ボーダー・文字・アクセント・ステータス・Syntax)
    • :root[data-theme="light"] にライトテーマ(One Light 風)を定義、color-scheme も追従
    • settings.appearance.theme で永続化("auto" | "light" | "dark"、デフォルト "auto")
    • "自動" は prefers-color-scheme に追従、OS 側変更も matchMedia で即反映
    • CodeMirror の EditorView.theme / HighlightStyle も var(...) 化してテーマ切替に連動
  • UI 文字最小化方針 + 設定ファイル直編集ルート(Sprint 3 中に氏の方針確立)
    • ツールバーから操作モード / テーマ セレクトを撤去(「UI に文字を使わない」が Yuhitsu 美学。設定 UI は Phase 2)
    • ツールバーから filename / status 表示も撤去(タブと重複していた)
    • 設定変更は settings.json 直編集 + ウィンドウへのフォーカス復帰時に自動再読み込み (再起動不要、window.focus イベントで loadSettings を再実行して各 state を更新)
  • ステータスバー(画面下部、設定で on/off)
    • workspace.statusbarVisible(デフォルト false)+ migration、settings.json 編集 + focus で切替
    • HTML 構造を配置:左にメッセージ、右に行数 / 文字数 / ワードカウント用の空スロット
    • 行・列 / 文字数表示を実装(2026-05-02、Phase 2 から前倒し)。Editor.svelte に onCursorChange フックを追加し、updateListener で selectionSet / docChanged のいずれかが立った時に通知。選択中は 5 / 120 文字 形式に切替
    • ワードカウント(Typst コンパイル後の本文字数)は Phase 2 で実装(空スロット維持)
  • 設定ファイル(settings.json)を Yuhitsu 自身のタブで開ける(2026-05-01 実装、設定 UI ができるまでの一次手段)
    • Rust get_settings_path コマンド(app_data_dir を返す、未作成なら空 JSON を作成)
    • フロントの open-settings コマンド(Ctrl+, / Settings アイコン、ツールバー右端)
    • save() 内で settings.json への保存を検知したら自動 reloadSettings(focus 任せより確実)
    • loadSettings の冒頭で store.reload()(Yuhitsu の fs::write は Tauri Store のキャッシュを無効化しないため必須)
  • UI 文字列の i18n 化(2026-05-01 氏指摘で追加 → 即日実装)
    • 自前 $lib/i18n/index.svelte.ts($state ベースの i18nState.locale + setLocale + t(key, params?)、ライブラリ追加なし)
    • 辞書 ja.json / en.json(command label / dialog / placeholder / splitter / project / preset / filter / status / preview / templateDialog / tab.untitled / app.name)
    • CommandDef.label / ToolbarPreset.label を labelKey 化
    • +page.svelte の全 UI 文字列(確認ダイアログ / ステータス / プレースホルダ / aria-label / タブ (無題) / プロジェクトビュー / iframe title / ファイル選択フィルタ)を t() 経由に統一
    • TemplateDialog.svelte の aria-label も t() 化
    • onMount + reloadSettings で setLocale(resolveLocale(localeMode)) を呼び、settings.json の locale 変更が UI 全体にリアクティブ反映
  • ツールバー D&D 編集 UI(2026-05-02)。ToolbarEditDialog.svelte 新設、ツールバー右端から開く専用ダイアログ。3 セクション構成:
    • 現在のツールバー(上段)— pointer events で D&D 並び替え、× ホバー削除、flex-wrap: nowrap + 横スクロールで 1 段固定。アイコンのみ表示で実ツールバーと同じスリムさ
    • 追加できる項目(中段)— 全コマンド + divider をアイコン+ラベルのグリッドで一覧。クリックで末尾追加
    • プリセットを適用(下段)— TOOLBAR_PRESETS の 3 種を選んで一括上書き
    • svelte-dnd-action ではなく pointer events で自前実装(WebKitGTK の HTML5 D&D 既知不具合を避ける、タブ並び替えと同じ流儀)
    • parseToolbarItems の migration で既存設定にも open-toolbar-edit を自動追加
  • キーバインド設定 UI(2026-05-02)。KeybindingsDialog.svelte 新設、ツールバー右端から開く専用ダイアログ。各コマンドのキー欄をクリック → 押したキーを Mod-Shift-x 形式で settings.keybindings に保存(override 経路は既存)。「標準に戻す」で override 削除。衝突警告あり。<input> ではなく <div tabindex="0"> でキャプチャして emacs 風 input bindings を回避(完全回避できない GTK Emacs テーマは OS 側設定の問題なので尊重して上書きしない方針)。matchKey は e.key と e.code 両方を試して keymap layout / GTK 変換に両対応
  • フォーム型テンプレート簡素版(2026-05-02)。差別化ポイント #2 の最初の実装。詳細:
    • $lib/template-args.ts 新設:#show: <fn>.with(...) を行ベース簡易パーサで読み・書き戻し(string / number / boolean に対応、それ以外は raw として表示のみ)。コメント・文字列リテラル・括弧ネスト対応の最小実装
    • $lib/FormPanel.svelte 新設:active タブの doc を $derived で監視、見つけた call site の引数キーをラベル付き input / textarea / number / checkbox で描画。focus 中は draft、blur で書き戻し(打鍵ごとに undo 履歴を肥大化させない)
    • 同梱テンプレ向けの meta.json スキーマ拡張:form: { function, fields: [{name, type, label.{ja,en}, placeholder?}] } を追加。同梱外の自作ドキュメント(#show: ~.with(...) を持つ任意の Typst 文書)も汎用フォールバックでフォーム化される(P1 + P3 構成)
    • 業務報告書テンプレを #let business-report(title, author, affiliation, period, body) = {...} + #show: business-report.with(...) 形式に書き換え
    • 残りの同梱テンプレも関数化(2026-05-02 同日対応):
      • technical-report — title / author / affiliation / abstract(textarea)。abstract が空なら概要ボックス自体を出さない条件分岐 #if abstract != "" [...]
      • meeting-minutes — title / location / attendees / recorder
      • slides — title / subtitle / presenter。subtitle が空ならその行と直後の v(2em) を出さない
      • empty は本文がほぼ無い設定だけのテンプレなので関数化対象外(form 未定義のまま)
    • サイドバーを α split / γ tabs の両モード対応:workspace.sidebarMode で切替、split は上半分プロジェクト・下半分フォーム(間に horizontal スプリッタ、sidebarSplitRatio で永続化)、tabs はサイドバー上部に「Project」「Form」タブヘッダ + 排他表示(sidebarActiveTab で永続化)
    • letter テンプレを廃止(氏判断「現代では不要」)。templates/letter/ 削除、ORDER から除外
  • 設定読み込みエラーの可視化(2026-05-02)。Rust の validate_settings_json で serde_json パースして「行 X 列 Y: …」を返し、ステータスバーに表示。修正後 reload 成功で自動クリア(専用フラグ settingsErrorActive で他の error メッセージとは独立に管理)

配布

  • GitHub Releases で配布パイプライン整備(2026-05-04)
    • .github/workflows/release.yml:tag v* push or 手動トリガーで Linux/Windows/macOS マトリクスビルド、tauri-apps/tauri-action で各 OS バンドルを Draft Release に upload
    • .github/workflows/ci.yml:PR / main push 毎に pnpm check + cargo check(完全ビルドは重いので skip)
    • 配布対象:Linux(.deb / .AppImage / .rpm)、Windows(.msi)、macOS は CI ビルド成功確認のみ(配布対象外)
    • ローカル pnpm tauri build 動作確認:.deb / .rpm 成功、.AppImage は Ubuntu 24+ の libfuse2 不在 + linuxdeploy 内蔵 strip が .relr.dyn を認識できない問題で失敗。CI(Ubuntu 22.04)で動く可能性が高いので CI で試す方針に切替
    • .deb 動作確認済(sudo dpkg -i ... → 起動 → dev 版と同じ動作)
  • コード署名は当面なし(2026-05-04 判断)
    • 個人 OSS でマネタイズなしのため、Win 用 OV/EV 証明書(年額数百ドル)は非現実的
    • GlobalSign USB は氏の所属会社のもので個人プロジェクトには使えない
    • alpha 段階では無署名配布(Helix / Alacritty 等の他 OSS と同じ運用、SmartScreen 警告対処を README に明記)
    • 将来:SignPath.io OSS 無料プラン 申請(活発な OSS が条件、人気が出てから検討)
    • macOS は Apple Developer Program($99/年)未加入、配布対象外を継続
  • winget で配布可能にする(GitHub Releases から alpha が出てから別途 PR)

リリース

  • v0.1.0 alpha リリース
  • 日本語 README 最終版
  • 英語 README 整備

Phase 2: UX 強化(Phase 1 リリース後、+3ヶ月)

注: 「フォーム型テンプレート」「GUI 挿入ボタン」は Sprint 3 で前倒し着手済みの場合、ここでは拡張・成熟化のみを担う。

  • Typst 構文ハイライタの再導入(Sprint 3 で暫定無効化、Phase 2 で復帰)
    • 現状:codemirror-lang-typst v0.4.0 の WASM 起因 panic(上流 issue #5)で plain mode 運用
    • 候補 A:@codemirror/legacy-modes の StreamLanguage で regex ベース簡易ハイライタ自作
    • 候補 B:上流修正完了次第バージョン上げて復帰(タイムラインは未読み)
    • 候補 C:fork して上流バグを直す(WASM 側 Rust 修正、最重)
  • フォーム型テンプレート入力の成熟化(差別化ポイント #2、Sprint 3 簡素版を強化)
  • GUI 挿入ボタンの成熟化(差別化ポイント #4、数式は MathLive (MIT) 等の手書き UI 検討)
  • Typst Universe 連携 UI(2026-05-02 氏承認、Phase 2 で扱う)
    • テンプレート取り込み:起動時テンプレ選択ダイアログに「Universe から取得」タブを追加 → tinymist init @preview/<name> 相当を実行 → 出力先フォルダを Yuhitsu で開く
    • パッケージ閲覧:@preview/<name> の検索 / バージョン選択 / 現在の文書末尾に #import 行を挿入
    • キャッシュ可視化:~/.cache/typst/packages/preview/ の中身一覧、サイズ表示、削除
    • 補足:パッケージ参照(#import "@preview/...")自体は Phase 1 時点で tinymist が自動取得するため既に動作する。Phase 2 で扱うのは「取り込み・閲覧・管理の GUI」のみ
  • テンプレートギャラリー(同梱テンプレ + Universe テンプレを横断検索する UI)
  • 内蔵 AI 機能の最小実装(段落整え・補完・テンプレート穴埋め支援)
    • LLM プロバイダ抽象(Anthropic / OpenAI / ローカル LLM / VPN 内エンドポイント を等しく扱う)
    • API キーの安全な保存(tauri-plugin-stronghold または OS キーチェーン)
    • 差分プレビュー → ユーザ確認 → 適用の二段フロー
    • 非同期ジョブキュー(UI ブロックなし、ストリーミング応答対応)
    • 情報漏洩対策はユーザ環境構築に委ねる方針(Yuhitsu 側で誤った安心感を与えない、抽象化に徹する。2026-04-28 氏合意)
    • LSP hover の翻訳(2026-05-02 後回し決定)。tinymist の hover は英語のドキュメントを返す。initialize.locale での切替は @codemirror/lsp-client から渡せず、tinymist 側の翻訳保持も期待薄。LLM プロバイダが整備された後、hover を tinymist が返した英語 → 日本語 に翻訳して表示するレイヤを足す方が自然
  • v0.2.0 リリース

Phase 3: WYSIWYG-lite モード(差別化の本丸) + 外部エージェント連携

  • AST ベース dual-rendering 設計書作成
  • 見出し・強調・引用の記法非表示化(PoC)
  • カーソル位置での記法表示切り替え
  • 表・リスト等の WYSIWYG 化
  • .typz 単一ファイルバンドル形式(2026-05-03 氏承認、Word ライク移行体験)
    • 主拡張子 .typz(Typst バンドル)、互換として .yhz も読み書き両対応
    • 中身は zip:manifest.json + main.typ + images/ + fonts/(opt) + references.yml(opt)
    • 開く:zip → temp dir 展開 → tinymist の --root を temp に向ける
    • 編集中:ユーザはフラット感覚(images 等は images/<name> の相対参照)
    • 保存:temp dir を再 zip → .typz に書き戻し
    • 閉じる:temp dir 削除(クラッシュ復帰のため auto-save 必須)
    • 画像挿入:選択された画像を temp dir 内に copy → 相対パスで挿入
    • 既存の素 .typ + フォルダワークフローは維持(.typz は追加レイヤ、両対応)
    • 工数感:1〜2 週間(Rust の zip crate、Tauri command 増設、画像挿入の path 解決変更、auto-save / temp 管理)
    • 拡張子の懸念(リスク 1):公式が将来 .typz を別用途で予約する可能性。現状空きで先取り、衝突時は名称変更 migration を 1 回だけ入れる
  • Yuhitsu を MCP サーバとして公開(Claude Cowork 等の外部エージェントから制御可能化)
    • @modelcontextprotocol/sdk(MIT)で Yuhitsu の操作を MCP ツールとして公開
    • read_document / apply_edit / get_diagnostics / compile などのツール定義
    • 外部からの編集にもユーザ確認フローを通す権限モデル
  • v0.3.0 リリース

バックログ / 検討事項

  • Typst の breaking change 追従コスト(月1ペース)
  • Harano Aji 同梱のインストーラサイズ影響(数十MB × 複数ウェイト)
    • → 初回起動時オンデマンド DL 方式も検討
  • Detypify(手書き数式)統合可否
  • 縦組みテンプレート
  • 共同編集機能(Typst On-Premises と被るため優先度低)

判断ログ

意思決定の経緯を記録する。

2026-04-23: プロジェクト開始

  • 名前を「右筆 (Yuhitsu)」に決定
  • GitHub 公開方針
  • ライセンスは Apache-2.0 確定
  • 本体 / 汎用テンプレ / private テンプレの三層分離
  • 自社専用 + 他社利用可の両立を目指す

2026-04-23: Phase 0 調査完了

  • Typstudio 分析:fork 不可(GPLv3 が Apache-2.0 と非互換、作者がメンテ放棄宣言)
  • Tinymist 調査:Apache-2.0 で活発、Yuhitsu の必要 LSP 機能を全て具備
  • 推奨路線:ゼロスタート + Tinymist を LSP subprocess として統合
  • 詳細は docs/phase0-decision.md
  • 補足:git ブランチを master → main にリネーム済み(参照リポは ~/Projects/yuhitsu-refs/ に配置)

2026-04-24: 路線確定 — fork しない

  • 氏承認:ゼロスタート路線で確定
  • Typstudio は本体に流用しない(GPLv3 汚染回避)
  • 参照リポ ~/Projects/yuhitsu-refs/typstudio/ は読み物として保持、本体には一切持ち込まない

2026-04-24: 技術スタック確定

  • ✅ Tauri 2.x 採用(1.x は不採用)
  • ✅ typst crate は公式(typst/typst)のみ 使用(Myriad-Dreamin fork は引き込まない)
  • ✅ GPLv3 隔離ルールを CLAUDE.md に明文化(Typstudio 由来コード持込み禁止、依存追加時のライセンス確認義務)
  • → Phase 1 着手準備完了

2026-04-25: Sprint 2 スコープ確定

  • 実装順序:(1) ファイル開閉 → (2) エディタ+LSP → (3) プレビュー → (4) PDF(氏承認)
  • エディタ操作モード3種ビルトイン(氏指示):OS 標準 / vim / emacs を標準装備、設定で切替
    • 採用ライブラリ:CodeMirror 6 デフォルト + @replit/codemirror-vim + @replit/codemirror-emacs(全て MIT、Apache-2.0 互換)
    • vim/emacs ユーザーを取り込みつつ、非エンジニアには OS 標準を提供する両取り戦略

2026-04-26: Sprint 2 順序見直し + AI エージェント連携の長期方針

  • Sprint 2 順序を組み替え(氏承認):(1) ファイル開閉 → (2) エディタ + Typst syntax → (3) ライブプレビュー → (4) PDF → (5) 操作モード3種 → (6) LSP 統合
    • 理由:typst.app 風の 2 ペイン UI に早く近づけて視覚的な完成度を先に上げるため、ライブプレビューを LSP より先行させる。LSP は実装が一番重く、優先度最後で問題なし
  • AI エージェント連携を長期方針として確立(氏承認):
    • プロトコルは MCP(Model Context Protocol) に乗る前提
    • Phase 1:実装はしないが、構造として下準備(エディタ操作 API レイヤ、状態シリアライズ、設定領域分離、@codemirror/merge 評価)
    • Phase 2:内蔵 AI 機能の最小実装(LLM プロバイダ抽象、API キー保護、diff プレビュー、非同期ジョブ)
    • Phase 3:Yuhitsu を MCP サーバ化、外部エージェント(Claude Cowork 等)から制御可能に
    • 避ける:特定ベンダー SDK の直 import / 同期前提 UI / 暗黙の編集適用 / AI 必須化 / 平文 API キー保存 / GPL 系ライブラリ混入
  • Sprint 2 (1)〜(2) の実装完了状況:
    • ファイル開閉(c7be3c4)
    • 終了確認バグ修正(38b3017、core:window:allow-destroy 追加)
    • CodeMirror 6 素導入(977c59b)
    • Typst 構文ハイライト統合(2d576d6、codemirror-lang-typst v0.4.0 + vite-plugin-wasm)

2026-04-29: タブ機能 + プロジェクトビュー + テキストファイル対応

  • 競合 Typstudio に「ExplorerTree / SidePanel」があるのを契機に、Yuhitsu にも以下を一括追加:プロジェクトビュー(サイドバー)、タブ機能、テキストファイル全般対応
  • プロジェクトビュー:Rust list_directory(全ファイル表示・ノイズフォルダ除外)、ProjectTree.svelte(Svelte 5 self-import で再帰描画)、フォルダ選択 + 永続化 + 起動時自動復元、サイドバー on/off + 幅リサイズ、ツリーから .typ はタブで開く・PDF/画像はバイナリは OS デフォルトに流す
  • タブ機能:{ id, path, content, dirty, cursorAnchor, cursorHead, scrollTop } を per-tab で管理、+ ボタン + Ctrl+T で新規、各タブに ✕ + Ctrl+W、ファイル open は同じパスがあれば既存 active に・空タブを再利用・なければ新規追加。タブ切替時に位置復元
  • テキストファイル対応:.md / .txt / .csv / .bib / .yaml / .json / .toml / .html / .rs 等をタブで編集可能。Editor.svelte に languageMode Compartment を追加し、Typst 以外は plain。LSP / preview / PDF は Typst のみ動作
  • トラブル / 解決した workaround:
    • 起動時 LSP rootUri を file:/// にすると tinymist が entry is not in any set root directory でフォールバック → 親ディレクトリに戻し、preview / PDF 側だけ --root /(filesystem root)に拡張(絶対パス画像が読める)
    • codemirror-lang-typst v0.4.0 の WASM パーサが「Typst 言語拡張が有効な状態で大規模 replace edit(タブ切替の全置換)」を処理できず Unreachable code should not be executed で落ちる → Editor.svelte の $effect を 3 段階 dispatch(lang Compartment 一旦外す → doc 全置換 → 再有効化)に変更
    • フロント側ログを直接見るために dev_log Tauri command + $lib/dev-log.ts を新設(JS → Rust stderr)。pnpm tauri dev のログから [js] ... 行を読めるので、DevTools を開かずデバッグ可能に

2026-04-28: Sprint 3 (3) — GUI 挿入ボタン拡張セット + ツールバー駆動化

  • 氏方針:ツールバーはユーザがメニュー構造を柔軟に変更できる設計に。デフォルトとプリセットを用意した上で自分でいじれること。ショートカットも設定可能。D&D 編集 UI は後回しで OK
  • 実装:
    • $lib/commands.ts を新設し、全コマンド(ファイル系 + 挿入系 19 種)を ID 中心のカタログに集約。{ id, label, buttonText, buttonClass, defaultKey, needsEditor, run } を共通形式とし、ツールバー / キーバインド / 設定永続化 / 将来の MCP から同じ ID で参照
    • 挿入コマンドを editor-commands.ts に追加実装(数式 / インラインコード = 既存 toggleInlineWrap を $ ` で再利用、コードブロック / リンク / 脚注 / 引用 / 表 / 画像)
    • 表は insertTable(view, { columns?, rows? }) で引数化(MVP は 2x2、後で「列数指定モーダル」を増設しやすい形)
    • ツールバーを toolbarItems: ToolbarItem[] の配列駆動に書き換え、divider も "divider" という ID として扱う
    • キーバインドは onKeydown がカタログを順次照合する一括方式に(effectiveKey = override ?? defaultKey、matchKey で Mod-Shift-b 形式を判定)。needsEditor のコマンドは view 不在時にパススルーするので vim Normal モードと共存
    • プリセット 3 種(標準 / ミニマル / 論文寄り)を TOOLBAR_PRESETS で内蔵
    • settings.ts に toolbar.items と keybindings 領域を追加。saveToolbarItems / saveKeybindings を export
    • 画像挿入はファイル選択ダイアログ(@tauri-apps/plugin-dialog の open + 拡張子フィルタ)と、getCurrentWebview().onDragDropEvent 経由のウィンドウ D&D の両入り口
    • 画像パスは現在編集中の .typ のディレクトリを基準に相対パス化(同階層・サブ階層のみ。それ以外は絶対パスを / 区切りで)
  • 残:D&D 編集 UI(svelte-dnd-action 採用予定)/ キーバインド設定 UI / 起動時テンプレート選択ダイアログ / フォーム型テンプレート簡素版

2026-04-28: Sprint 3 着手 — GUI 挿入ボタン最小セット完了

  • Sprint 3 (2) GUI 挿入ボタン最小セットを実装(太字・斜体・見出し H1〜H3・箇条書き・番号付き)
    • $lib/editor-commands.ts を新設し、EditorView を引数にとる純粋関数として toggleBold / toggleItalic / applyHeading / toggleBulletList / toggleNumberedList を定義(UI 非依存)
    • これは Phase 1 の下準備「エディタ操作 API レイヤを Svelte UI / Tauri command / 将来の MCP ハンドラから共通で呼べる形に整理」の第一歩を兼ねる
    • Editor.svelte は onReady(view) / onTeardown() で view を親に公開、+page.svelte 側がコマンドを呼ぶ
    • Ctrl+B / Ctrl+I は editorView が無いと preventDefault しない(vim Normal モードでの ページ送り等と共存)
    • 行頭マーカーは「同種ならトグル除去 / 別種なら置換 / なしなら付与」、インデントを保持
  • 残り Sprint 3 項目:起動時テンプレート選択ダイアログ / GUI 挿入ボタン拡張セット / フォーム型テンプレート簡素版

2026-04-28: Sprint 2 完了 + Yuhitsu の長期ポジション確定

  • Sprint 2 (3)〜(6) すべて MVP として動作:
    • ライブプレビュー(e1881c5、tinymist preview の iframe 方式)
    • PDF エクスポート(af1cf8f、tinymist compile 経由)
    • 操作モード3種(d241c6a、@replit/codemirror-{vim,emacs} + tauri-plugin-store)
    • tinymist LSP 統合(72d4f4d、@codemirror/lsp-client v6.2.3、補完 / 診断 / hover 動作確認済み)
  • Yuhitsu の長期ポジションを確定(氏合意):
    • 最終ゴールは 「AI エージェンティック前提のローカル GUI ドキュメントエディタ」。氏自身が Claude Code でこの開発をしている動き方が、そのまま Yuhitsu の理想的なユーザ体験。
    • 空白座標は「OSS × ローカル × GUI × 実用 × エージェント連携可」で、現状の市場に同等品なし。
    • 情報漏洩対策はユーザ環境構築側に委ねる。Yuhitsu は LLM プロバイダを抽象化するに留め、特定の保護機構を凝らない。コンプライアンス厳格な現場でも、ユーザがローカル LLM や VPN 内エンドポイントを選べば採用できる、という設計。
    • 実装順序合意:Phase 1 末で Sprint 3(起動時テンプレート選択 + GUI 挿入ボタン最小セット + フォーム型テンプレート簡素版)を前倒し → Phase 2 で内蔵 AI 機能 → Phase 3 で WYSIWYG-lite + MCP サーバ化 + Universe 連携。

2026-05-01: テーマ機能(自動 / ライト / ダーク)を追加

  • 氏要望:Ubuntu のダーク設定で Yuhitsu もダーク見えしているが、それは Yuhitsu 自体のテーマか OS 追従か? を契機にテーマ対応を実装(Phase 2 予定の前倒し)
  • 判断:公開時に複数テーマを選べる前提なので、まず CSS 変数化で素地を作り、確認用にライト固定セットを足す → 氏が「DevTools 経由は嫌、UI 欲しい」で auto/light/dark 切替セレクトまで一気に実装
  • 実装:
    • 全 UI 色を app.html の :root に CSS 変数として集約(背景 6 / ボーダー 2 / 文字 7 / アクセント 3 / ステータス 3 / Syntax 9、計 27 種)
    • :root[data-theme="light"] でライトテーマを定義(One Light 風配色、color-scheme: light)
    • +page.svelte / Editor.svelte(<style> + CodeMirror EditorView.theme + HighlightStyle)/ ProjectTree.svelte の全色を var(...) 化
    • settings.ts に AppearanceSettings 領域を新設、saveTheme を export、Tauri Store で永続化
    • ツールバーに「テーマ: 自動 / ライト / ダーク」セレクト(操作モードの隣)。"自動" は prefers-color-scheme に追従、matchMedia で OS 側変更も即反映
  • 副次効果:Phase 2 で正式テーマ UI を作る時はプリセット(solarized / nord / gruvbox 等)を [data-theme="..."] セットとして増やすだけで対応できる構造に

2026-05-01: ツールバーを wrap 折り返しに変更

  • 氏指摘:ウィンドウ幅を狭くするとメニュー(ツールバー)が画面外に隠れる。横スクロールより wrap の方がよさそう
  • 実装:.toolbar に flex-wrap: wrap、gap: 6px 8px(縦/横)、.toolbar-divider を align-self: center + 固定高さ 18px に変更
  • 結果:狭い画面でも複数行に折り返して全アクションが見える。完全アイコン化されているので圧迫感は最小限

2026-05-01: UI 文字列の i18n 化(自前 i18n.ts + ja/en 辞書)

  • 氏指摘で発覚:locale を ja に切り替えても UI 全体が日本語のまま → UI 文字列がハードコードされたままで i18n 機構が無いことが判明
  • 方針(再確認):UI 文字最小化方針(hover / 確認 / ステータス / プレースホルダのみ)に従い、辞書ルックアップ + {key} 差し込みで足りる範囲に絞る → 自前 i18n.ts で十分、ライブラリ追加なし
  • 実装:
    • $lib/i18n/index.svelte.ts:$state(locale) + setLocale + t(key, params?)、.svelte.ts 拡張子で $state を共有モジュールから export
    • 辞書 ja.json / en.json:約 70 キー
    • CommandDef.label → labelKey、表示時に t(def.labelKey) を呼ぶ。ToolbarPreset.label も同様
    • 確認ダイアログ(ask)・setStatus・プレースホルダ HTML・splitter aria-label・タブ「(無題)」・iframe title・ファイル選択フィルタなどを全部 t() 化
    • setLocale(resolveLocale(localeMode)) を onMount + reloadSettings で呼び、settings.json での locale 変更が UI 全体にリアクティブ反映
  • 確認:タブ「(無題) ↔ (Untitled)」/ テンプレダイアログのカード / プレビュープレースホルダの切替を確認済み
  • 残:テンプレ本体の用語(例:「業務報告書」テンプレ内の [ここに実施内容を箇条書きで記載])はテンプレファイル自体の i18n(ja.typ / en.typ)で対応済み

2026-05-01: 設定ファイルを Yuhitsu で開く + UI 文字列 i18n の認識合わせ

  • 氏要望:設定確認のたびに別エディタで開いて再起動するのが面倒。Yuhitsu 自身で開けるように
  • 実装:
    • ツールバー右端に Settings アイコン + open-settings コマンド (Ctrl+,)
    • Rust get_settings_path で app_data_dir() を返す(tauri-plugin-store v2 が app_data_dir に保存するため、間違えて app_config_dir を使うと別ディレクトリに空ファイルを作る落とし穴あり)
    • save() 内で「保存先が settings.json と一致したら自動 reloadSettings」(focus イベント任せだとタブ切替で発火せず取りこぼす)
    • loadSettings の冒頭で store.reload():Yuhitsu は fs::write で素朴に書き込むので、Tauri Store のメモリキャッシュが古いまま。reload しないと外部・内部どちらの編集も反映されない
  • 副次:i18n の現状確認:氏が「locale 設定したのに UI が日本語のまま」と指摘 → UI 文字列はテンプレカード以外すべて日本語ハードコードであることを認識合わせ。次タスクとして i18n.ts 実装を予定

2026-05-01: 起動時テンプレ選択ダイアログ + 多言語テンプレート + 参考文献挿入

  • 氏方針(議論で確立):
    • 表示タイミングは D 案(初回起動で自動表示 + 専用コマンド)。毎回起動時に出すのはうざい
    • テンプレ本体は 多言語ファイル管理(meta.json + ja.typ + en.typ)。UI 文字列のフル i18n は別タスク
    • 用紙サイズは locale 非依存(document.paperSize で別管理、auto は locale から推測)
    • 共通スタイルは初期は 完全独立(各 locale ファイルに直書き、テンプレが増えたら共通化)
    • 参考文献は Hayagriva (.yml) 推奨、BibTeX (.bib) も対応(Typst が両方ネイティブサポート)
  • 実装:
    • 初期セット 6 種(空 / 業務報告書 / 技術報告書 / 議事録 / 簡易レター / スライド)、各 ja/en 2 言語
    • 技術報告書ひな形は「概要 / はじめに / 方法 / 結果 / 考察 / 結論 / 参考文献」構成
    • スライドは素のページ分割版(presentation-16-9、touying / polylux 統合は Phase 2)
    • テンプレダイアログはカードグリッド(アイコン大 + タイトル小 + hover で説明)、ESC / 背景クリックでキャンセル
    • 参考文献挿入は画像挿入と同じく「ファイル選択 → 相対パス化 → 末尾挿入」フロー
  • 残:設定 UI(Phase 2)、フォーム型テンプレ簡素版(Sprint 3 続き)、ツールバー D&D 編集 UI / キーバインド設定 UI

2026-05-01: 無題タブを閉じる時の確認ダイアログを「保存しますか?」形式に

  • 氏指摘:「破棄して閉じますか? はい/いいえ」は否定形が混ざって意図が取りづらく、「名前をつけて保存しますか?」の方が自然
  • 実装:
    • closeTab の確認メッセージを変更:無題タブは「名前をつけて保存しますか?」、既存ファイルは「保存しますか?」
    • okLabel="保存" / cancelLabel="保存しない"
    • 「保存」→ 対象タブを active にしてから save/saveAs → 成功で閉じる(保存ダイアログでキャンセルしたらタブ残す)
    • 「保存しない」→ 従来通り破棄して閉じる
    • save / saveAs を Promise<boolean> 化(成功 / キャンセル / エラー判定可能に)。既存呼び出し箇所は戻り値を使わないので無害
  • 関連項目:ウィンドウ全体を閉じる時の「終了してよろしいですか?」も同種の改善余地あり(複数 dirty タブの一括処理が必要なため、Phase 2 で対応)

2026-05-01: UI 文字最小化方針 + ステータスバー仕込み + WYSIWYG-lite の方向性確認

  • 氏方針(Yuhitsu 美学として確立):UI に文字を使うべきじゃない、hover ヒント程度にしたい。設定系(操作モード・テーマ)は編集中に頻繁に変えるものではないのでツールバーから外す
  • 実装:
    • ツールバーから操作モード / テーマ セレクトと filename / status 表示を撤去 → ツールバーは編集アクション専用に
    • 設定変更ルートは「settings.json 直編集 → Yuhitsu にフォーカス復帰で自動再読み込み」(window.focus イベントで loadSettings 再実行、再起動不要)
    • 設定 UI 画面は Phase 2 で本格実装(それまでは直編集が一次手段)
  • i18n 範囲が縮んだ:残るのは hover ヒント / ステータス / ダイアログ / テンプレカード / プレースホルダ のみ → 自前 i18n.ts で十分、ライブラリ追加なし
  • ステータスバー(画面下部、設定で on/off、デフォルト off)を仕込み:
    • 「設定 UI に出すほどでもないが、行数 / 文字数 / ワードカウントは見たくなる」という氏の予感に対応
    • 表示は HTML 構造とスタイルだけ用意、行数 / 文字数 / ワードカウントは Phase 2 で実装する空スロット
    • ワードカウントは Typst コンパイル後の本文字数(仕上り時)を出す前提
  • WYSIWYG-lite モードの方向性確認(氏の質問:Obsidian 的 UI をプレビュー側に実装できるか?):
    • 結論:プレビュー側(SVG 出力)では実装不可、エディタ側に AST ベース Decoration で実装する(これが Phase 3 の本丸)
    • Obsidian / Typora は CodeMirror 6 の Decoration API でエディタ側に被せる方式
    • tinymist preview の SVG 出力は contentEditable 化できない(SVG → Typst の逆変換不能)
    • Typst は Markdown より文法が複雑で、装飾で隠せるノード(見出し / 強調 / リスト / リンク)、プレースホルダ代用ノード(数式 / 表)、生コードのまま見せるノード(#let / #import / 関数定義)の 3 カテゴリに分かれる → Phase 3 の「設計書作成」が一番重い作業

2026-05-02: キーバインド設定 UI(GTK key theme との折り合い)

  • 実装:KeybindingsDialog.svelte 新設、ツールバー右端のキーボードアイコンから開く。各コマンドのキー欄をクリックでキャプチャ、押されたキーを Mod-Shift-x 形式で settings.keybindings に保存。「標準に戻す」「クリア」「衝突警告」付き
  • 物理キー優先化:matchKey を e.key と e.code 両方比較に拡張、KeybindingsDialog の capture も e.code を KeyB → "b" 形式に正規化。これで keymap layout 違いや一部 GTK 変換に対応
  • 判断:GNOME の GTK key theme = Emacs 環境では Ctrl+B が OS レベルで完全に ArrowLeft に変換されて届く(Ctrl 修飾子も消える)ため、JS 側で回避不能
    • 検討した A 案(Yuhitsu 起動時に gtk crate で key theme を Default に override)は、ユーザが OS 単位で設定したキーバインドを Yuhitsu が奪う形になり、ユーザの主要設定を尊重しない
    • 氏判断:Yuhitsu のターゲット層(事務 / 営業 / CUI 苦手層)は emacs theme を有効化しないため、影響は emacs theme を能動的に有効化した上級ユーザのみ。彼らは OS の挙動を理解して受け入れているはずで、Yuhitsu が上書きするのは越権
    • 採用案:OS 設定を尊重し、Yuhitsu からは介入しない。emacs theme ユーザは別キーを使うか、OS 設定を切替える
  • コード上のコメントで方針を明示(onCaptureKeydown 冒頭)

2026-05-02: ステータスバー文字数の空白除外モード + 設定読み込みエラー可視化 + タブ active 配色修正

  • 氏要望(charCountMode):文字数カウントの「空白を除外する / 含める」を選びたい。標準は除外(原稿カウント感覚)
  • 実装:
    • WorkspaceSettings.charCountMode: "non-whitespace" | "all" 追加(default "non-whitespace")
    • Editor.svelte の CursorInfo に selectedNoWs / totalNoWs を追加。countNonWhitespace() で /\s/g(ECMAScript 仕様で Zs カテゴリ全般を含むため、半角・全角スペース・タブ・改行を一括除外)
    • フロントの表示で charCountMode === "all" ? cursor.total : cursor.totalNoWs で切替。選択時も同じく切替
  • 設定読み込みエラー可視化:Rust の validate_settings_json で serde_json パース → 失敗時は「行 X 列 Y: …」をステータスバーに出す。settingsErrorActive フラグで JSON エラーだけ自動クリア(他の error は触らない)
  • タブ active 配色:VSCode 流儀(active = エディタ面と同色 + 上端 2px accent 線)。ダーク/ライト両モードで一貫
  • trap 1 — 起動時の settingsPath 初期化:
    • 過去仕様:openSettings() が呼ばれた時のみ settingsPath がセットされる
    • 結果:プロジェクトツリー等から settings.json をタブで開くと、save() 内の「保存先 == settingsPath なら自動 reloadSettings」が動かず、保存しても設定が即時反映されない
    • 修正:onMount の loadSettings 直後に settingsPath = await invoke("get_settings_path") を追加
  • trap 2 — Yuhitsu 直書きと Tauri Store メモリの衝突:
    • settings.json をタブで編集 → 保存(save_file Rust command = fs::write 直書き)→ ディスク更新
    • 一方 Tauri Store(tauri-plugin-store v2)は memory に古いキャッシュを保持
    • その後 saveWorkspace 等が呼ばれると memory(古い)→ ディスクで上書き → 直書きの内容が失われる
    • 修正:saveWorkspace の冒頭で store.reload() + 既存 workspace 値とマージしてから set する。これでユーザの直編集が消えない
  • 既知の制約:tauri-plugin-store v2 は store.save() 時に JSON のキーをアルファベット順にソートして書き出す。Yuhitsu のタブで末尾に書き加えても、次回 saveWorkspace 呼び出しで再フォーマットされる。Phase 2 の設定 UI ができれば直編集は不要になるので受容(自前 fs::write に置き換える方法もあるが他 save 関数まで波及するため見送り)

2026-05-02: 起動時の preview 接続失敗(孤児 tinymist 起因)を修正

  • 症状(氏報告):起動時に「Failed to start preview. failed to connect preview control plane after 5000 ms」(初回は Connection reset、2 回目は Connection refused)
  • 真因:Tauri dev の再ビルド時、Yuhitsu のメインプロセスはシグナルで強制終了されるが、子プロセス(tinymist preview / tinymist lsp)が孤児として残る。残った preview が 127.0.0.1:23625 を保持しているため、新 Yuhitsu の preview spawn 時に AddrInUse で tinymist 内部 panic(http.rs:37 の TcpListener::bind(..).unwrap())。control plane(23626)も道連れで listen 開始直後に死ぬ → 接続 refused
  • 対策:
    • Tauri setup フックで kill_lingering_tinymist() を呼び、pkill -f "tinymist preview" と pkill -f "tinymist lsp" で起動前に古いプロセスを掃除(Unix 限定。Windows は別途対応必要)
    • connect_control_plane は accept 準備未完了のレース対策として 80ms 間隔の retry ループ(最大 5 秒)を維持
    • probe_data_plane_ready は data plane の TCP listen 確認のみ(control plane の listen 確認は意味がない、accept ループ起動を見ないと判定にならないため)
  • 将来の改良:Linux で prctl(PR_SET_PDEATHSIG) を使って「親死亡 → 子も死ぬ」を保証すれば pkill 戦略は不要(libc クレート追加が必要)。Phase 2 でやる
  • 誤爆懸念:他用途で tinymist preview / tinymist lsp を立てているケースは想定外。普通の利用環境では問題にならない

2026-05-02: 無題タブで preview を有効化(仮想 .typ パス方式)

  • 背景:schedulePreviewMemoryUpdate 完成 + per-tab undo 完成後に氏が確認 → 無題タブでは preview が出ないことに気付き要望。「とりあえず書きながら preview を見たい」のは新規ドキュメント編集の典型的体験
  • 判断:tinymist preview が実在ファイルパスを必須とするため、無題タブ用の仮想 .typ ファイルを app_cache_dir/untitled/<tab.id>.typ に作成して内部 path として扱う
  • 実装:
    • Rust:prepare_untitled_path(tab_id) -> String / cleanup_untitled_path(path) コマンド追加。app 起動時の setup フックで cleanup_untitled_dir を呼んで前回の残骸を掃除(crash 耐性)
    • フロント:Tab 型に virtualPath: string | null を追加。isTypstTab(tab) ヘルパ(無題タブも Typst 機能対象として扱う、新規ドキュメント前提)。ensurePreviewablePath(tab) で「実 path 優先 / なければ仮想 path を必要に応じて遅延作成」。disposeVirtualPathFor(tab) で削除
    • フロント:preview / LSP / memory file 注入の各経路を isTypstPath から isTypstTab 判定に置き換え、起動 path は ensurePreviewablePath 経由で解決
    • フロント:saveAs 成功時(無題 → 実 path)、closeTab 時、ファイル open で空タブを再利用する時に仮想ファイルを cleanup
    • フロント:onMount の loadSettings 後で「初回起動時はテンプレダイアログ / それ以外は無題タブで preview を即起動」に分岐(空 doc プレビューが映る方が体験が良い)
  • 残:タブ閉じ忘れ等で残った仮想ファイルは「次回起動時の cleanup_untitled_dir」で掃除されるので長期蓄積はしない設計

2026-05-02: タブ単位の undo history 分離(view.setState による per-tab state 保持)

  • 症状(氏報告):タブ A で編集 → タブ B に切替 → タブ B で編集 → undo すると 別タブの内容に遡及してしまう。さらに「undo で別タブの内容で上書きされる」現象も発生
  • 原因:単一の EditorView を全タブで共有し、タブ切替時に doc 全置換していたため、CodeMirror の history() extension が 全タブの編集を 1 つの history に連結していた
  • 第一段階対策(失敗):historyCompartment で history を Compartment 化 → タブ切替時に historyCompartment.reconfigure(history()) で history インスタンスを作り直し → 別タブへの遡及はなくなったが、「タブ切替を挟むと undo が遡れない」(切替前の編集スタックを完全に捨ててしまう)
  • 第二段階対策(採用):Tab 型に editorState: EditorState | null を追加し、タブ切替時に view.setState(tab.editorState) で state まるごと復元(doc / 選択 / undo redo / scroll を一括)。captureActiveTabState で tab.editorState = view.state を控える。新規タブ・file open ルートは従来通り doc 全置換 + history reset(新セッション扱い)。Editor.svelte に externalState prop を追加し、lastAppliedExternalState で同じ参照の再 setState を抑止
  • 残:undo/redo のキーバインドは historyKeymap(Ctrl+Z / Ctrl+Shift+Z または Ctrl+Y、macOS は Cmd 系)で標準どおり

2026-05-02: codemirror-lang-typst の編集中 panic 発覚 → 構文ハイライトを Phase 1 期間中は無効化

  • 症状(氏報告):ファイル末尾の #figure(...) 内、caption 行以降を削除しようとすると 行が復活し、さらに undo も効かない。無題タブ・末尾以外の #figure では再現しない
  • 切り分け順序:
    1. リアルタイム preview 反映(control plane WS の updateMemoryFiles)を一時無効化 → 改善なし → 私の今回の作業とは独立
    2. LSP の languageServerSupport を無効化 → 改善なし → tinymist LSP 起因ではない
    3. Typst 言語拡張(codemirror-lang-typst の typst())を無効化 → 症状消失 → これが原因
  • 原因確定:codemirror-lang-typst v0.4.0(GitHub: kxxt/codemirror-lang-typst)の WASM Typst パーサが、「単一 transaction に複数 changes」のケースで panic する。タブ切替時の全置換 panic(2026-04-29 の workaround で 3 段階 dispatch にしている件)も同根。上流 issue #5「Fix problems with multiple changes in a single editor transaction」(2025-12-03 更新)が立っているが未修正、最新 v0.4.0 でも未解決。npm 上に他バージョン無し
  • 判断:Phase 1 段階では構文木を必要とする機能(folding / 高度 navigation)を持っていないので、構文ハイライトは犠牲にしてもエディタ安定性を優先する。Editor.svelte::langExtension を return [] で固定し plain mode で運用。typst / Prec / HighlightStyle / tags as t / highlightStyle 定義は Phase 2 で StreamLanguage 移行する時に参照しやすいよう残置(svelte-check は通過、未使用警告なし)
  • Phase 2 で対応:@codemirror/legacy-modes の StreamLanguage で regex ベース簡易ハイライタを自作する案が有力。完璧な構文認識は LSP(tinymist)が担っているので二重持ちは不要
  • 残:tinymist LSP の hover / 補完 / 診断 自体は復活させて運用(構文ハイライトだけが消えた状態)

2026-05-02: 編集中バッファのリアルタイム preview 反映(control plane WebSocket クライアント)

  • 背景:Sprint 2 (3) の積み残し「編集中(未保存)もリアルタイムにプレビュー反映」「HTTP プローブによる起動完了判定」「自前 WebSocket クライアントへの置き換え」は本質的にひとつの作業に収束。tinymist preview の control plane WebSocket(ws://127.0.0.1:23626/) が公式に syncMemoryFiles / updateMemoryFiles / removeMemoryFiles のフックを持つので、これを使えば「ディスクに書かずに preview に反映」が実現する
  • 接続経路の判断:Tauri の production WebView は tauri://localhost という独自スキームから動く。tinymist の origin チェック(http://localhost / 127.0.0.1 または vscode-webview://)では tauri:// が弾かれる可能性が高い → Rust 側に WebSocket クライアントを置き、Tauri command/event で橋渡しする方式を採用(フロント直接接続だと dev は通っても production で動かなくなる懸念)
  • 実装:
    • Rust:tokio-tungstenite v0.24 + futures-util v0.3 を追加。PreviewState に control_tx: AsyncMutex<Option<UnboundedSender<String>>> を追加。start_preview を async 化し、subprocess spawn → TCP プローブ(data / control 両 plane が listen するまで 50ms 間隔でポーリング、上限 5 秒)→ control plane WS 接続 → 送受信タスクを spawn、までを 1 関数で完結
    • Rust:新コマンド preview_update_memory(path, content) / preview_remove_memory(paths)。WS 未接続時は no-op で返す(タブが .typ じゃない時の保険)
    • Rust:受信側は将来の同期スクロール / クリックジャンプ用に Tauri event preview:control に流す土台のみ作成
    • フロント:onEditorChange 内で schedulePreviewMemoryUpdate() を呼ぶ。150ms debounce、active タブが path 持ち Typst で previewStatus === "ready" の時だけ送信。stopPreview 時にタイマーキャンセル
    • フロント:1.5 秒固定 wait の PREVIEW_BOOT_DELAY_MS を撤去(Rust 側プローブで代替)
    • 副次:save / saveAs を Promise<boolean> 化(2026-05-01)した時の取りこぼしで CommandContext の型が Promise<void> のままだった件を修正(Promise<unknown> に緩和)
  • 残:無題タブ(path 無し)はまだ対象外。仮想パス(例 __yuhitsu_unsaved_<tabId>__.typ)を割り当てて memory file 化すれば対応可だが、preview の subprocess 起動引数に実在ファイルが要る制約があり別タスク
  • 動作確認:氏に GUI で確認してもらう必要あり。型チェック(pnpm check)・Rust ビルド(cargo check)は通過

2026-05-04: 配布パイプライン整備(無署名 + GitHub Releases + GitHub Actions)

  • 判断(氏合意):
    • コード署名は当面なし:個人 OSS、マネタイズなし、Win 証明書(年額数百ドル)/ Apple Developer($99/年)はかけない。会社の GlobalSign USB は私用不可
    • alpha は無署名配布:Helix / Alacritty 等の他 OSS と同じ運用。Win SmartScreen / Mac Gatekeeper の警告対処は README で明記
    • macOS は alpha では配布対象外:CI でビルド成功確認のみ、開発機が Linux のため動作未検証
    • 将来:SignPath.io OSS 無料プラン / Microsoft Trusted Signing 等が選択肢、活発な OSS としての実績が出てから申請
  • 実装:
    • .github/workflows/release.yml:tag v* push でマトリクスビルド + Draft Release 作成。tauri-action 利用
    • .github/workflows/ci.yml:pnpm check + cargo check の軽量 CI(完全ビルドは release のみ)
    • README.md を Phase 1 alpha 向けに全面書き直し(既存機能リスト、ダウンロード手順、SmartScreen 警告対処、開発者向けビルド手順、ロードマップ)
  • ローカルビルド検証:pnpm tauri build で .deb / .rpm 成功、.AppImage は失敗
    • 真因:Ubuntu 24+ で linuxdeploy 内蔵の古い strip が glibc の .relr.dyn ELF section を認識できない
    • 試した回避策:NO_STRIP=true / APPIMAGE_EXTRACT_AND_RUN=1 環境変数を渡すも、tauri-bundler 内部で env が propagate されず効かない
    • 判断:CI(Ubuntu 22.04 ランナー、古い ABI)で再挑戦。ローカルでは .deb / .rpm のみ動作確認、これで alpha 配布は可
    • 残:CI で .AppImage が通れば配布対象に含める、通らなければ alpha は .deb / .rpm / .msi のみで出す
  • .deb 動作確認:sudo dpkg -i ... → 起動 → dev 版と同じ動作確認

2026-05-03: vim mode は experimental 扱い(WebKitGTK 環境で挙動不審)

  • 発覚した問題(氏報告):
    • (A) IME ON で vim が反応しない:: を押しても ex モードに入らない、i などのモード切替も効かない。IME OFF で復帰
    • (B) インサートモードで 1 文字打つと勝手にノーマルモードへ:連打すると数文字入る。どの ASCII 文字でも、IME OFF でも発生
    • (C) Space リーダー(コマンドパレット起動)が動かない:Vim.map(" ", ":Cmd<CR>", "normal") でも Prec.highest の自前 keymap でも、ノーマルモード Space で発火しないケース
  • 切り分け:editor.mode = "default" に切替 → 全部消える。@replit/codemirror-vim 起因確定(Yuhitsu 側の今回の変更とは独立)
  • 判断(氏合意):vim mode は experimental ラベル付きで提供。深追いはコスト過大、当面は default / emacs を推奨
  • 残した実装:
    • Vim.defineEx での :w :q :wq :tabnew :tabclose :bnext :bprev :edit :Cmd 紐付けはそのまま残す(他モードに副作用なし、vim mode で IME OFF なら一応動く)
    • :Cmd で コマンドパレットを開く ex コマンドは動作確認できるユーザもいるので残置
    • Space リーダー keymap も残置(動く環境なら効く)
  • 将来の選択肢:@replit/codemirror-vim の上流に issue 報告 / fix 待ち、別の vim emulation を検討、もしくは Yuhitsu 専用の最小 vim 互換実装(別途設計)
  • (4) :s/aaa/bbb/ の No matches for /aaa/im メッセージ:これは vim 標準の情報メッセージ(エラーではない)、置換は実行されている。気にしなくてよい

2026-05-02: 無題タブで LSP 機能(hover / 補完 / 診断)が無効になる bug 修正

  • 症状(氏報告):業務報告書テンプレを当てた無題タブで、#text 等の組み込み関数にマウスを乗せても hover が出ない、補完(#l でポップアップ)も出ない、診断(赤波線)も出ない。一方 syntax highlight は動作している
  • 真因:Editor.svelte の filePath prop に渡していた値が path = $derived(getActiveTab()?.path ?? null) で、無題タブでは null。lspExtension(client, null) は if (!client || !file) return []; のガードで 空 extension を返し、languageServerSupport 自体が組み込まれない → hover / 補完 / 診断が一切動かない
  • 歴史的背景:2026-05-02 の「無題タブで preview を有効化」対応で tab.virtualPath を導入し、preview / memory file 経路は ensurePreviewablePath で virtualPath を使うようにしたが、Editor.svelte の filePath prop だけはそのまま path(= tab.path)を渡し続けていた ため、無題タブでは LSP が無効化される状態が温存されていた。当時 hover の動作確認は file タブで行っていたため発覚しなかった
  • 対策:editorFilePath = $derived(getActiveTab()?.path ?? getActiveTab()?.virtualPath ?? null) を追加し、Editor の filePath prop に渡すよう変更。これで無題タブでも LSP に正しい URI が伝わる
  • 切り分け経路:
    1. CSS が hover を消していると仮定 → CSS 撤去 → 改善せず
    2. tooltip parent が .app { overflow: hidden } でクリップされていると仮定 → tooltips({ parent: document.body }) 追加 → 改善せず
    3. 最終的に dlog でフロント状態をダンプ → lspClient=true filePath=null を発見 → 一発で原因判明
  • 学び:LSP のような複合 extension は 「extension が組み込まれていない」と「extension が動作しているが応答が無い」が見分けにくい。フロント側ログを早く出す方が遠回りしない

2026-05-02: 全体スクロール bug 修正(エディタ高さ伝達の落とし穴)

  • 症状(氏報告):業務報告書テンプレを当てると、エディタがステータスバーを突き破り、ツールバー / 両サイド / ステータスバー含めて Yuhitsu 全体が縦スクロールしてしまう。プロジェクトビュー非表示でも同じ
  • 真因:+page.svelte の .editor-pane :global(.cm-host) { flex: 1; min-height: 0; } が、Editor.svelte 内の .cm-host { height: 100%; } を CSS specificity で上書き し、height: 100% が消えていた。これは元々の落とし穴で、エディタ本文が短い間は CodeMirror が contentHeight 駆動で表示するだけで露呈しなかった。今回業務報告書を #let business-report(...) = {...} 形式に書き換えて本文を長くしたら、cm-editor が内容ベースで膨張 → .editor-pane → .edit-preview-row → .workspace が連鎖的に伸び、.app { height: 100vh } だけでは body スクロールを封じられず全体スクロール発生
  • 対策(三層):
    • .editor-pane :global(.cm-host) に height: 100% を明示(specificity 競合に勝つ)
    • Editor.svelte の EditorView.theme で "&" (= cm-editor 自身)に height: "100%" を追加(JS 側からも保証)
    • .app に overflow: hidden を追加(子要素が万一伸びても body スクロールは絶対に出さない最終防壁)
  • 副次:flex: 1 1 auto の auto basis は内容ベースで膨らむので、.sidebar-section の form 側を flex: 1 1 0 に変えた(残りスペース配分のみで内容膨張に巻き込まれない)
  • 学び:Svelte の scoped style と :global(...) の specificity は同じになる(両方とも class hash が付くため)。global で flex 指定する時は height 等の関連プロパティもセットで書かないと、上位コンポーネントの指定を意図せず潰す

2026-05-02: フォーム型テンプレート簡素版(Sprint 3 完了)

  • 氏判断:
    • パース対象は C 案(meta.json の form.fields で同梱テンプレに型・ラベル・並びを持たせる)
    • 配置は 左サイドバー下半分を基本。さらに α (split) と γ (tabs) の両対応を採用、ユーザが切替できるようにする(workspace.sidebarMode)
    • 書き換え粒度は P1 + P3:同梱は「業務報告書」だけ最初に書き換え、残りは段階対応。ユーザ自作の #show: ~.with(...) を持つドキュメントにも汎用フォールバックでフォーム化が効く(差別化が一段強くなる)
    • letter テンプレは廃止(氏判断「現代では不要」)
  • 実装:
    • $lib/template-args.ts:#show: <fn>.with(...) を行ベースで読み・書き戻し。string / number / boolean をフォーム対応、datetime(...) 等の関数呼び出し・配列・コードブロックは raw として読み取り専用表示。文字列の \n \t \\ \" エスケープを read/write 両対応
    • $lib/FormPanel.svelte:doc を $derived で監視、call site が見つかれば spec(同梱の場合)または call.args(汎用フォールバック)から入力欄を生成。focus 中は draft、blur で onApply(打鍵ごとに undo 履歴を肥大化させないため)、boolean は即時反映
    • 業務報告書テンプレを #let business-report(...) = { ... body } + #show: business-report.with(...) 形式に書き換え。meta.json の form.fields で title / author / affiliation / period の 4 フィールド + ja/en ラベル翻訳を定義
    • サイドバー HTML を改修:projectPaneEl を bind し縦の splitter(splitter horizontal、cursor: row-resize)を追加。tabs モードは sidebar-tabbar(タブヘッダ)を上部に表示し、選択タブのセクションだけ flex: 1 で占有
    • workspace.sidebarMode / workspace.sidebarSplitRatio / workspace.sidebarActiveTab を settings.ts に追加、デフォルト "split" / 0.55 / "project"、parser / saveWorkspace / migration 対応済み
    • toggleProjectView が「tabs モード × form タブ」のときは Open Folder ダイアログを呼ばないように分岐(フォーム目的で開いた時の不要な確認をスキップ)
    • i18n 辞書に sidebar.tabProject / sidebar.tabForm / splitter.sidebarBoundary / form.* の 9 キー追加
  • 残:
    • サイドバーモード切替の GUI 経路(現状は settings.json 直編集 + focus 復帰で反映)。toggle-sidebar-mode コマンドをカタログに足し、ツールバー編集 UI から追加できるようにするのが筋(UI 文字最小化方針との両立で、デフォルトのツールバーには入れない)。氏に確認後実装
    • 残りの同梱テンプレ(技術報告書 / 議事録 / スライド)を関数化 + form spec 付与(段階対応)
  • 動作確認:氏に GUI で確認してもらう必要あり。pnpm check / pnpm build / cargo check は通過

2026-05-02: Typst Universe 連携 UI は Phase 2 で扱う

  • 氏質問:Typst Universe のパッケージやテンプレートは Yuhitsu で使える?
  • 現状確認:
    • パッケージ参照(#import "@preview/cetz:0.3.0" 等)は 既に動作。Yuhitsu は素の tinymist を spawn しているだけで、tinymist 内部の typst-kit が初回コンパイル時に自動ダウンロード&ローカルキャッシュ(~/.cache/typst/packages/preview/<name>/<version>/)する
    • テンプレ取り込み(typst init @preview/<name>)は UI 未実装。同梱テンプレ(app/src/lib/templates/<id>/)のみ起動ダイアログから選択可能
  • 判断:Universe テンプレ取り込み UI は Phase 2 で扱う(Phase 1 Sprint 3 では同梱テンプレのみ)。Phase 2 の「パッケージ管理 UI」項目を Universe 連携 UI として具体化(取り込み / 閲覧 / キャッシュ可視化の 3 機能)
  • 残:Sprint 3 の残タスクに戻る(フォーム型テンプレ簡素版 / ツールバー D&D 編集 UI / キーバインド設定 UI など)

2026-05-05: Linux IME 対応はアプリ側で持たない方針(README 案内に切替)

  • 発端(氏報告):US EN locale の Ubuntu に後付けで fcitx5(SKK / Mozc)を入れた環境で、Yuhitsu のエディタで漢字変換ができない。手動で GTK_IM_MODULE=fcitx ./yuhitsu 等を付けると動作する
  • 試行 1:ensure_im_env() を実装し、起動時に走っている IME daemon(fcitx5 / fcitx / ibus-daemon)を pgrep -x で検出して GTK_IM_MODULE / QT_IM_MODULE / XMODIFIERS を std::env::set_var で補完。Windows / macOS には影響しない #[cfg(target_os = "linux")]
  • 試行 2:set_var では効かなかったので main() 冒頭(tauri::Builder 構築前)で呼ぶ位置に移動 → 効かず
  • 試行 3:std::os::unix::process::CommandExt::exec() で 自分自身を再起動 し execve(2) の env として渡す形に変更(無限ループ防止に YUHITSU_IM_ENV_FIXED マーカ)。/proc/<pid>/environ で env が正しく立っているのを確認したものの、それでも漢字変換は復旧しなかった
  • 試行 4:shell から GTK_IM_MODULE=fcitx XMODIFIERS=@im=fcitx pnpm tauri dev で起動 → アプリ内ログ [ime] GTK_IM_MODULE already set (fcitx), leaving as-is が出て env は確実に inherit されている。が これでも変換できなかった(env タイミングの問題ではなく、CodeMirror 6 + WebKit2GTK + fcitx5 wayland の組み合わせの別レイヤーの問題と思われる)
  • 氏判断:アプリ側で env の自動補正は持たない。VS Code / Firefox / Chromium 等の主要 OSS も持っておらず、Linux 界隈の標準は OS セッション側で env を立てておくこと(im-config / ~/.profile / ~/.config/environment.d/)。Yuhitsu のターゲット層は Windows 中心で、Linux ユーザの大半は既に env が立っている前提でよい
  • 対応:
    • ensure_im_env() および main.rs の呼び出しを撤去(コードを単純化)
    • README.md / README.en.md の Linux インストール節に「IME が効かない場合」のサブブロックを追加し、im-config または起動時の env 指定を案内
  • 残課題:env を立てた状態でも変換が復旧しなかった環境特有の問題は、OS 側 env 設定で本当に直るかを別環境で再検証する余地あり(本セッションの再現環境では未確認)。エディタ層(CodeMirror 6 の composition events)が原因の可能性も残るが、Phase 2 以降で必要に応じて深掘りする

2026-05-06: tinymist を sidecar として同梱(PATH 依存解消)

  • 発端(氏報告):GUI 起動の Yuhitsu で「LSP 起動に失敗」エラー。原因は GNOME がアプリを spawn するときの PATH に ~/.local/bin が含まれず tinymist が見つからない為。一般 Linux ユーザは大抵 tinymist 未インストールなので、配布物としても致命的
  • 当初の構想:.deb の Depends:、起動時検出 + GUI 案内、wrapper script、sidecar 同梱の 4 案を比較
  • 氏判断:sidecar 同梱(Tauri externalBin)を Phase 1 中に対応。配布の前提条件として外せない。サイズ増(deb で 24.5MB → 53MB、+28MB)は許容
  • 設計:
    • tinymist v0.14.16(最新安定)で固定。tauri.conf.json の bundle.externalBin: ["binaries/tinymist"] を追加し、Tauri が target triple サフィクスを剥がして main binary の隣に配置するよう設定
    • Rust 側に tinymist_path() ヘルパを追加(lib.rs)。解決順は:(1) 実行ファイルの隣 = リリース配置、(2) <CARGO_MANIFEST_DIR>/binaries/tinymist-<host-triple> = dev 配置、(3) PATH = フォールバック。Command::new("tinymist") の 3 箇所(preview / compile / lsp)を Command::new(tinymist_path()) に置換
    • host_target_triple() は cfg! で静的に決定(クロスコンパイル対応)
    • scripts/fetch-tinymist.sh:GitHub Releases から host triple のバイナリを DL して app/src-tauri/binaries/tinymist-<triple> に配置。冪等。TINYMIST_TARGET / TINYMIST_VERSION 環境変数で上書き可
    • .gitignore に binaries/ を追加(数十 MB の binary をコミットしない)
  • CI 対応(release.yml):tauri-action の前にマトリクス各行で fetch-tinymist.sh を呼ぶ step を追加。Linux x86_64 / Linux aarch64 / Windows は単純呼び出し。macOS は universal-apple-darwin で build するので x86_64 / aarch64 の両方を DL し lipo で universal バイナリを合成
  • 動作確認:
    • pnpm tauri build --bundles deb 通過、生成された .deb 内に /usr/bin/tinymist が同梱されることを確認(53MB)
    • 段階 1 テスト(release バイナリ直接起動)で LSP / preview / 漢字変換すべて動作 ✓
    • 段階 2(.desktop 経由 GUI 起動)と 段階 3(.deb 実機インストール)は氏に確認依頼中
  • README 更新:「tinymist を PATH に通せ」の前提を撤去、scripts/fetch-tinymist.sh の手順を追記(README.md / README.en.md)
  • **Phase 1 残:**ARM Linux 含む実機 .deb インストール検証は氏側で実施。CI のサイズ増(macOS universal は ~120MB 程度になる見込み)が無料枠を圧迫しないかは run 後にチェック