Text Chunker 引き継ぎ — v4.1-final → v4.2-final
v4.1-final(Batch 6-N 完了)から v4.2-final への移行を 12 バッチ(7-A〜7-L)で整理。編集スコープ制限・Snapshot/Unpin 分離・統合履歴・並び替え・Merge with next document・Diff オーバーレイ・Storage 圧迫通知・純化 Split モード・同一行重なり表示を追加。
Text Chunker 引き継ぎ — v4.1-final → v4.2-final
0. 一行サマリ
v4.1-final(Batch 6-N 完了)から v4.2-final への移行完了。 12 バッチ(7-A〜7-L)で directive の未着手項目 32 項目を全て消化。編集スコープ制限 / Snapshot・Unpin 分離 / 統合履歴メニュー / 並び替え / Merge with next document / Diff オーバーレイ / Storage 圧迫通知 / 純化 Split モード / 同一行重なり表示を実装。bundle/verify は All files match (23 files) で通過。
1. 到達点
1.1 検証済み状態
| 項目 | 状態 |
|---|---|
| ファイル数 | 23(5 css + 18 js) |
| 循環依存 | ✓ 0 件 |
| 未使用 import | ✓ 0 件 |
@file: マーカー | ✓ 全ファイル === 形式 |
@import: ↔ 実 import | ✓ 1:1 対応 |
| directive 未着手項目 | ✓ 0 件 |
| 破壊的バグ | ✓ 0 件 |
1.2 ファイル構成(v4.2-final)
public/tools/text-chunker/├── index.html├── manifest.json├── package.json├── scripts/ (bundle.mjs / split.mjs / verify.mjs)├── styles/ (00-base / 10-layout / 20-components / 30-editor / 40-theme-light)├── js/ (00-main 〜 180-boot, 全 18 ファイル)└── bundle/index.htmlv4.1-final との差分: ファイル追加・削除なし。
2. Batch 別サマリ(7-A〜7-L)
Batch 7-A: 編集スコープ制限
対象: js/90-editor.js / styles/30-editor.css
editScopeFilter追加(EditorState.changeFilter経由)- Master 選択時は全文、非ゼロ chunk 選択時は
[start, end)のみ、ゼロ長 chunk 選択時は純挿入のみ許可 - 範囲外書き込みで toast 通知(1.5 秒スロットル)
app.bulkMode/app.updatingFromDocは bypass.cm-editable-scopeスタイル追加(ダーク / ライト両対応)
Batch 7-B: 履歴データモデル拡張 + DocumentRec.order
対象: js/60-model.js / js/110-ui.js / js/130-tree.js / js/150-checkpoint.js
HistoryRecにtype/chunkId/versionを追加DocumentRec.orderフィールド追加defaultSettings.mergeSeparator追加(既定'\n')ensureDocumentOrder()新設(updatedAt降順で0, 1, 2, ...を採番)loadAllDataで履歴 migration + document order 採番getAllHistory/getMasterHistory/getChunkHistoryList新設appendChunkHistory/reconstructChunkHistoryContent新設
Batch 7-C: Snapshot / Unpin 分離 + 自動遷移廃止
対象: js/60-model.js / js/120-crud.js / js/130-tree.js / js/140-workflow.js / js/170-wireui.js
chunkKeyをid優先に変更unpinChunkを履歴保持型に(commitVersion > 0 は state のみ変更、それ以外は ephemeral 化)commitChunkに履歴追加を統合(appendChunkHistory)- 保護条件:
pinned OR commitVersion > 0 advanceToNextUncommitted削除- Chunk context menu で
Snapshot/Pin stateを別グループ化
Batch 7-D: 統合履歴メニュー
対象: js/130-tree.js / js/150-checkpoint.js / js/160-dialogs.js / js/170-wireui.js / index.html
openHistoryDialog新設(3 タブ: Master / This chunk / All chunks)previewChunkHistory/restoreChunkHistory/purgeOrphanedHistory新設- Chunk 履歴 Restore は
commitTextのみ更新(master 不変) - ドロワーから master 履歴セクション撤去
File ▾ → History…追加mapPersistedChunksの editId 判定をid保有ベースに修正commitAutoPin=false時の undo stack 副作用を修正
Batch 7-E: 並び替え(doc + chunk)
対象: js/120-crud.js / js/130-tree.js / js/140-workflow.js / js/160-dialogs.js / js/180-boot.js
moveDocumentAbove新設(配列並び替え +order再採番)moveChunkAbove新設(ChangeSet 単発、他 chunk の offset 追従)canMoveUp/canMoveDown/moveChunk削除openMoveAbovePicker新設(汎用ピッカー)openChunkMovePicker/openDocMovePicker新設- doc menu / chunk menu に
Move above…追加
Batch 7-F: 設定メニュー集約(歯車 + タブ)
対象: js/60-model.js / js/160-dialogs.js / js/170-wireui.js / index.html
openSettingsDialog(initialTab)新設(Split / Output / Merge / App の 4 タブ)openSplitSettings/editOutputSettings/openAppSettingsDialogを互換エイリアス化- Merge separator 設定 UI 追加
separatorToSelect/escapeSepForInput/unescapeSepInputヘルパー新設
Batch 7-G: Merge with next document
対象: js/120-crud.js / js/160-dialogs.js / js/170-wireui.js / js/180-boot.js / index.html
getNextDocument()新設(order 昇順の次)mergeWithNextDocument()新設- next の chunk を
curLen + sepLen分シフトして転属 - next の履歴を転属(master
seqは curMaxSeq で再採番) openMergeMasterDialog/applyMergeMaster削除File ▾ → Merge master files…をMerge with next document…に置換
Batch 7-H: Row 2/3 UI 変更
対象: styles/10-layout.css / styles/20-components.css / styles/40-theme-light.css / index.html / js/140-workflow.js / js/160-dialogs.js
#topbar { z-index: 200 }(検索パネル 100 より上).btn/.btn.compactの高さを 26px に統一.btn.snapshot追加(緑、ライト版含む)- Copy ボタンのラベル削除(アイコンのみ)
- chunkStatus の分母削除(分子のみ)
- Row 3 に
⇣(Jump to master end)追加 160-dialogs.jsの未使用 import 整理
Batch 7-I: Diff オーバーレイ
対象: styles/30-editor.css / js/140-workflow.js
#diffViewを全画面置換 → 下 40% オーバーレイに.diff-open .cm-scroller { padding-bottom: 40%; }追加✕クローズボタン追加- エディタのスクロール位置・カーソル位置を保持
Batch 7-J: orphaned purge + Storage 表示拡張
対象: js/110-ui.js / js/150-checkpoint.js / js/160-dialogs.js / js/170-wireui.js / js/180-boot.js / styles/10-layout.css / styles/40-theme-light.css
checkStoragePressure()新設(ok/warn/danger)getAllOrphanedAcrossDocs/estimateAllHistoryBytes/purgeOrphanedHistoryGlobal/purgeAllHistoryGlobal/autoPurgeOrphanedIfNeeded新設persistNow後にautoPurgeOrphanedIfNeeded呼び出し(30 秒スロットル)showStorageDialogを内訳 + reason banner + Clear アクション付きに拡張[IDB]chip のstorage-warn/storage-dangerクラス.storage-reasonバナー(ダーク / ライト)
Batch 7-K: ドロワー調整
対象: js/130-tree.js
- current doc row クリック時、chunk 選択中なら
selectChunk(null)で Master 表示に戻す
Batch 7-L: 残項目 + 修正
対象: js/80-split.js / js/90-editor.js / js/110-ui.js / js/120-crud.js / js/130-tree.js / js/140-workflow.js / styles/20-components.css / styles/30-editor.css / styles/40-theme-light.css
- Split モードを
limit/headings/bothの 3 種に純化Fill by limit→ pure limit(heading/fence 無視)Cut at headings→ pure headings(limit 無視)- Live split / Settings →
both(heading 粗分割 → section 内 limit 細分割)
clearAllChunksPromptで I6 保証(必ず 1 chunk 残る)navPrev/navNextに Master を挟む巡回- 同一行重なり表示
(×N)+openChunkStackPopover追加 cutChunkAtNextHeading新設(This chunk → Cut at headings)- Chunk context menu に
This chunkグループ追加 - 未使用 import 削除(
110-ui.jsのcurrentChunk、120-crud.jsのallChunks/setUnsaved) .snip-row/.snip-list/.snip-editCSS 追加#chunkStackPopoverCSS 追加
3. 主要な設計判断
3.1 編集スコープ制限(Batch 7-A)
根拠:
- v4.1 の「編集ロックなし」は v3.x の UX トラップを解消するためだった
- しかし実装後、chunk #2 選択中に #1 / #3(グレーアウト)まで編集できる問題が判明
- directive の要求「選択中チャンクだけが編集対象」を満たす
実装:
EditorState.changeFilterを使用(readOnlyは全体ロックになるため不適)- 常時 ON(設定化しない)
- 範囲選択・コピーは制限しない(書き込みのみ)
トレードオフ:
- chunk 選択中は chunk 外の編集ができない(意図通り)
- 複数 chunk に跨る編集は Master 選択に切り替える必要
3.2 Snapshot / Unpin 分離(Batch 7-C)
根拠:
- v4.1 は Unpin で snapshot 履歴を破棄 → ユーザーの期待に反する
- 再 Snapshot で version がリセットされる問題
実装:
unpinChunkは state 変更のみ。履歴は保持commitVersion > 0の chunk は unpinned でも保護対象(自動再分割の対象外)chunkKeyをid優先に変更(履歴の連続性)
トレードオフ:
- unpinned-with-history chunk は
app.chunksに残り続ける recomputeAutoChunksの保護条件が複雑化
3.3 Split モードの純化(Batch 7-L)
根拠:
- v4.1 は
Fill by limitもCut at headingsも同じrecomputeAutoChunksを呼ぶ - 実質同じ動作で、directive「両方のロジックを混ぜない」に反する
実装:
- 3 モード:
limit/headings/both - メニュー単体操作 → pure mode
- Live split / Settings 保存 →
both
トレードオフ:
Fill by limitで heading が壊れる(意図通り)Cut at headingsで limit が超過する(Over バッジで通知)
3.4 Diff オーバーレイ(Batch 7-I)
根拠:
- v4.1 は
#cmHost { display: none }でエディタを置換 → スクロール位置・カーソル位置が失われる - directive「エディタ領域の表示位置は変更しない」「diff の表示だけが追加される体験」
実装:
#diffViewを下 40% の絶対配置オーバーレイに.diff-open .cm-scroller { padding-bottom: 40%; }でエディタの最終行到達を保証
トレードオフ:
- 40% 固定は viewport 非依存(実機調整の余地)
3.5 Storage 圧迫通知 + 容量ベース purge(Batch 7-J)
根拠:
- directive「ユーザーには左下のストレージのアイコンで容量不足である事を通知」
- 「履歴の容量であっても、単に読み込んでいるファイルの量であっても色付きで不足を表現」
実装:
- chip 3 段階:
< 70%通常 /70〜90%黄 /≥ 90%赤 - 自動 orphaned purge は
danger時のみ、30 秒スロットル - Storage ダイアログに内訳 + Reason バナー + Clear アクション
トレードオフ:
navigator.storage.estimate非対応ブラウザでは常にok(Safari 15 以前)- 全体使用量で判定するため、履歴以外の要因でも警告が出る
3.6 openSettingsDialog の統合(Batch 7-F)
根拠:
- directive「設定メニューが散在している。歯車アイコンに Split settings と Output format¬es の設定も集約」
- 「タブで切り替えなど、グループ化」
実装:
- 4 タブ:
Split/Output/Merge/App - 旧
openSplitSettings/editOutputSettings/openAppSettingsDialogはエイリアス化 - DOM は全タブ分を一度に構築して display で切替
トレードオフ:
- 起動時に全タブ分の DOM を構築するため、初回ダイアログ表示が若干遅延
160-dialogs.jsが 1560 行に膨らんだ(v4.3 で分割検討)
3.7 Merge with next document(Batch 7-G)
根拠:
- directive「次 Master = ツリー上で隣接するドキュメント」「任意に並び替え可能」
- v4.1 の
Merge master files…は「任意ソースを並べ替えて現在 master に合成」で意味が違う
実装:
getNextDocument()で order 昇順の次を取得- separator は
app.settings.mergeSeparator(Settings → Merge で設定) - next の chunk / 履歴を cur に転属
トレードオフ:
- master 履歴の
seq再採番が必要(curMaxSeq + nextSeq) - next doc は削除される(
beforeBulkcheckpoint で復元可能)
3.8 同一行重なり表示(Batch 7-L)
根拠:
- directive「Chunk が同じ行で重なっている時は重なっている事が分かる表示を行数表示位置に示す」
- 「#{n}などをクリックすると含まれている Chunk 一覧とその行列、文字数が表示される」
実装:
_ensureLayoutCacheにstartByLineマップを追加(行 → chunk 配列)- ラベルに
(×N) #i nameを表示 - クリックで
#chunkStackPopoverを開く(#i name state [start-end] {len}cの一覧) - 行クリックで該当 chunk を選択
トレードオフ:
- モバイルでは
(×N)のみ表示(名前は省略)
4. v4.1-final との差分サマリ
4.1 追加されたもの
| 対象 | 追加行数(概算) |
|---|---|
| 編集スコープ制限 | 60 |
| 履歴データモデル拡張 | 80 |
| Snapshot/Unpin 分離 | 60 |
| 統合履歴メニュー | 200 |
| 並び替え | 150 |
| 設定集約(4 タブ) | 400 |
| Merge with next document | 180 |
| Row 2/3 UI | 30 |
| Diff オーバーレイ | 30 |
| Storage 圧迫通知 | 200 |
| Split モード純化 | 150 |
| 同一行重なり | 100 |
| This chunk アクション | 60 |
| I6 保証 | 20 |
| nav cycle | 30 |
| 未使用 import 削除 / CSS 追加 | 30 |
| 合計 | 約 1780 行 |
4.2 削除されたもの
| 対象 | 削除行数(概算) |
|---|---|
openMergeMasterDialog / applyMergeMaster | 250 |
advanceToNextUncommitted | 15 |
canMoveUp / canMoveDown / moveChunk | 90 |
| ドロワーの履歴セクション | 30 |
| 未使用 import | 5 |
| 合計 | 約 390 行 |
純増: 約 +1390 行(v4.2 は v4.1 より機能が大幅に増えたため)
5. 主要な API / 型の変更
5.1 ChunkRec
変更なし(v4.1 のまま)。state: 'unpinned' で履歴保持を許容する運用変更のみ。
5.2 DocumentRec
order: number; // v4.25.3 HistoryRec
type: 'master' | 'chunk'; // v4.2chunkId: string | null; // v4.2version: number | null; // v4.2kind: string // v4.2: master のみ(chunk は null)5.4 SettingsRec
mergeSeparator: string; // v4.2: 既定 '\n'5.5 新規 API
| 関数 | 提供元 |
|---|---|
checkStoragePressure() | 110-ui |
getAllOrphanedAcrossDocs() | 150-checkpoint |
estimateAllHistoryBytes() | 150-checkpoint |
purgeOrphanedHistoryGlobal() | 150-checkpoint |
purgeAllHistoryGlobal() | 150-checkpoint |
autoPurgeOrphanedIfNeeded() | 150-checkpoint |
appendChunkHistory() | 150-checkpoint |
restoreChunkHistory() | 150-checkpoint |
previewChunkHistory() | 150-checkpoint |
getMasterHistory() / getChunkHistoryList() | 150-checkpoint |
openSettingsDialog(initialTab) | 160-dialogs |
openHistoryDialog(initialTab) | 160-dialogs |
openMoveAbovePicker() | 160-dialogs |
moveDocumentAbove() | 120-crud |
mergeWithNextDocument() | 120-crud |
getNextDocument() | 120-crud |
cutChunkAtNextHeading() | 120-crud |
moveChunkAbove() | 140-workflow |
canMoveChunkAbove() | 140-workflow |
editScopeFilter() | 90-editor |
5.6 削除された API
| 関数 | 理由 |
|---|---|
openMergeMasterDialog() / applyMergeMaster() | 7-G で mergeWithNextDocument に置換 |
advanceToNextUncommitted() | 7-C で自動遷移廃止 |
canMoveUp() / canMoveDown() / moveChunk() | 7-E で moveChunkAbove に置換 |
6. UI 変更の変遷
6.1 Row 2
| 段階 | 内容 |
|---|---|
| v4.1-final (6-L) | ◀ ▶ · chunkStatus · 📋 Copy · ✓ · ⋮ |
| 7-H | ◀ ▶ · chunkStatus · 📋(アイコンのみ) · ✓(緑)· ⋮ |
| 7-L | 同上 |
6.2 Row 3
| 段階 | 内容 |
|---|---|
| v4.1-final (6-L) | [Text|Diff] · ⇤ · 🔍 |
| 7-H | [Text|Diff] · ⇤ · ⇣ · 🔍 |
| 7-L | 同上 |
6.3 File ▾ メニュー
| 段階 | 内容 |
|---|---|
| v4.1-final | Save / Copy / Merge master files… / Extract |
| 7-D | Save / Copy / Merge master files… / History… / Extract |
| 7-G | Save / Copy / Merge with next document… / History… / Extract |
6.4 設定エントリ
| 段階 | 内容 |
|---|---|
| v4.1-final | Split settings… / Output format & notes… / ⚙ App settings |
| 7-F | ⚙ 統合設定(4 タブ) に集約。旧エントリはエイリアス |
6.5 Chunk コンテキストメニュー
| 段階 | 内容 |
|---|---|
| v4.1-final | Header / Copy / Create / Move(連続時のみ) / State / Edit / Danger |
| 7-C | Move up/down / Merge down / Snapshot グループ / Pin state グループ |
| 7-D | + History… |
| 7-E | Move up/down → Move above… |
| 7-L | + This chunk グループ(Fill by limit / Cut at headings) |
6.6 Storage chip
| 段階 | 内容 |
|---|---|
| v4.1-final | [IDB] のみ |
| 7-J | [IDB] + 3 段階色 + 内訳ダイアログ + Clear アクション |
7. リスクと未確定事項
| # | 内容 | 状態 |
|---|---|---|
| 1 | pinChunk / pinChunkLocal の重複 | v4.3 で統合予定 |
| 2 | chunkKey の unpinned@<offset> が位置依存 | v4.3 で ephemeral 用キーを再検討 |
| 3 | mergeWithNextDocument の seq 再採番 | single-tab lock 下では実害なし |
| 4 | app.chunks / app.autos の二重配列 | v5.0 で統合予定 |
| 5 | 内部名 commit* と UI 語 snapshot の乖離 | v5.0 で rename 予定 |
| 6 | 160-dialogs.js が 1560 行 | v4.3 で settings / history / merge / code blocks に分割 |
| 7 | #diffView height: 40% 固定 | 実機調整の余地 |
| 8 | app.ui.historyExpanded デッドステート | v4.3 で削除 |
| 9 | #detailPanel 関連 CSS | v4.3 で削除 |
| 10 | navigator.storage.estimate 非対応ブラウザ | 常に ok(実害なし) |
8. ファイル適用順序
8.1 完全版ファイル(v4.1-final からの差分)
| # | ファイル | 最終バッチ | 変更概要 |
|---|---|---|---|
| 1 | js/00-main.js | — | 変更なし |
| 2 | js/10-utils.js | — | 変更なし |
| 3 | js/20-count.js | — | 変更なし |
| 4 | js/30-safe-pos.js | — | 変更なし |
| 5 | js/40-candidates.js | — | 変更なし |
| 6 | js/50-storage.js | — | 変更なし |
| 7 | js/60-model.js | 7-F | mergeSeparator / ensureDocumentOrder |
| 8 | js/70-compose.js | — | 変更なし |
| 9 | js/80-split.js | 7-L | モード分離 + I6 fallback |
| 10 | js/90-editor.js | 7-L | editScopeFilter + stack popover + __i fix |
| 11 | js/110-ui.js | 7-L | checkStoragePressure + 未使用 import 削除 |
| 12 | js/120-crud.js | 7-L | nav cycle + clearAllChunks + cutChunkAtNextHeading |
| 13 | js/130-tree.js | 7-L | context menu: This chunk グループ |
| 14 | js/140-workflow.js | 7-L | splitAuto/splitChapter の mode 指定 |
| 15 | js/150-checkpoint.js | 7-J | HistoryRec 拡張 + orphan purge |
| 16 | js/160-dialogs.js | 7-J | 統合設定 + 統合履歴 + Storage 拡張 |
| 17 | js/170-wireui.js | 7-J | Storage 圧迫通知 |
| 18 | js/180-boot.js | 7-J | svc 登録 |
| 19 | index.html | 7-G | Merge with next document… + ⇣ + .snapshot |
| 20 | styles/00-base.css | — | 変更なし |
| 21 | styles/10-layout.css | 7-J | storage-warn / storage-danger / .storage-reason |
| 22 | styles/20-components.css | 7-L | .btn.snapshot + .snip-* |
| 23 | styles/30-editor.css | 7-L | Diff overlay + chunk stack popover |
| 24 | styles/40-theme-light.css | 7-L | ライト版調整 |
8.2 適用順序(依存関係順)
1. 7-F の js/60-model.js2. 7-J の js/150-checkpoint.js3. 7-J の js/160-dialogs.js4. 7-J の js/170-wireui.js5. 7-J の js/180-boot.js6. 7-G の index.html7. 7-J の styles/10-layout.css8. 7-L の js/80-split.js9. 7-L の js/90-editor.js10. 7-L の js/110-ui.js11. 7-L の js/120-crud.js12. 7-L の js/130-tree.js13. 7-L の js/140-workflow.js14. 7-L の styles/20-components.css15. 7-L の styles/30-editor.css16. 7-L の styles/40-theme-light.css変更なしファイル(v4.1 のまま): js/00-main.js / js/10-utils.js / js/20-count.js / js/30-safe-pos.js / js/40-candidates.js / js/50-storage.js / js/70-compose.js / styles/00-base.css
9. bundle の所在
public/tools/text-chunker/bundle/index.html
再生成:
cd public/tools/text-chunkernode scripts/html-build/bundle.mjs --project text-chunkernode scripts/html-build/verify.mjs --project text-chunker# 期待: ✓ All files match (23 files)
python -m http.server 8000# /public/tools/text-chunker/ で dev ESM# /public/tools/text-chunker/bundle/ で bundle 版10. 検証手順(v4.2-final)
- 全ファイル配置後、
bundle.mjs実行 → 循環依存警告が 0 件 verify.mjs実行 →All files match (23 files)- dev ESM 起動 → 全 23 ファイルが HTTP 200/304
- サイドバーに
Unpinned/Pinnedバッジが出る - Footer に
[IDB][⚡Live]が出る - Row 2 の主ボタンが
📋(青) - Snapshot ボタンが緑
- Row 3 に
⇣が出る - chunk を選択 → chunk 外の編集が拒否される(T4 / T35)
- Chunk context menu に
This chunkグループ(Fill by limit / Cut at headings)が出る Chunks ▾ → Fill by limit…→ heading 無視で文字数分割Chunks ▾ → Cut at headings…→ heading 位置のみで分割⚙クリック → 4 タブの統合設定が開くFile ▾ → Merge with next document…→ 次 doc が連結されるFile ▾ → History…→ 3 タブの統合履歴が開くDiffクリック → 下 40% にオーバーレイ、エディタ位置保持[IDB]chip クリック → Storage ダイアログ(内訳 + Clear)Clear all chunks→ 必ず 1 chunk 残る- ◀ で #1 → Master、▶ で #N → Master
- 同一行に複数 chunk start → ラベル
(×N)、クリックで popover
11. 既知の制約
| # | 内容 | 影響 | 対応予定 |
|---|---|---|---|
| 1 | expandByLines は O(n) で lineStarts を毎回再構築 | 大規模 doc で copy 連打時に劣化 | v4.3 でメモ化 |
| 2 | computeChunkOverhead は二重 composeOutput | breakdown popover でのみ実行 | 現状維持 |
| 3 | chunkSeparatorPlugin は app.chunks のみ対象 | unpinned には widget が出ない(仕様通り) | — |
| 4 | app.chunks / app.autos の二重配列 | 保守性負債 | v5.0 で統合 |
| 5 | 内部名 commit* と UI 語 snapshot の乖離 | 開発者の混乱リスク | v5.0 で rename |
| 6 | pinChunk / pinChunkLocal の重複 | 片方の修正が他方に反映されないリスク | v4.3 で統合 |
| 7 | chunkKey の unpinned@<offset> が位置依存 | lastOpened 復元で稀に誤選択 | v4.3 で再検討 |
| 8 | mergeWithNextDocument の seq 再採番がセッション依存 | single-tab lock 下では実害なし | 現状維持 |
| 9 | #diffView height: 40% が viewport 非依存 | 実機調整の余地 | v4.3 |
| 10 | _lastAutoPurgeAt がセッション内のみ | 仕様通り | — |
| 11 | app.ui.historyExpanded がデッドステート | メモリ数バイトのみ | v4.3 で削除 |
| 12 | #detailPanel 関連 CSS が残存(v3.x 遺産) | 未使用、~30 行 | v4.3 で削除 |
12. 将来の検討事項
| # | 内容 | 優先度 |
|---|---|---|
| 1 | pinChunk / pinChunkLocal の統合 | 高 |
| 2 | chunkKey の ephemeral 用キー再設計 | 高 |
| 3 | 160-dialogs.js の責務分割 | 中 |
| 4 | app.ui.historyExpanded / #detailPanel 削除 | 中 |
| 5 | expandByLines の lineStarts メモ化 | 中 |
| 6 | #diffView の高さ可変化 | 低 |
| 7 | 自動テストフレームワーク導入(node --test) | 中 |
| 8 | commit* 内部名を snapshot* に全面 rename(v5.0) | 中 |
| 9 | app.chunks / app.autos の単一配列化(v5.0) | 中 |
| 10 | svc レジストリの必要性見直し | 低 |
13. 参照
- 仕様書 v4.2-final: 2026-09-29-text-chunker-spec-v4.2-final
- v4.1-final: 2026-09-29-text-chunker-spec-v4.1-final
- 引き継ぎ v4.1-final: 2026-09-29-text-chunker-handover-v4.1-final
- 元仕様 v4.1: 2026-09-28-text-chunker-spec-v4.1
- 分割化指示書: 2026-09-27-text-chunker-splitting-instructions
- directive: 260929_directive
14. 着手時の注意
- 適用順は §8.2 の依存関係マップを厳守
10-utils.jsのsvcは変更しない60-model.jsは他の全ファイルに先行160-dialogs.jsは170-wireui.jsを import しない(svc経由のみ)- 各ファイルの先頭は
// === @file: ... ===または/* === @file: ... === */ - 各 JS ファイルは
// @import:directive の直後に実 import を 1:1 で持つ index.htmlは分割ソース版(<link>+<script type="module" src>)。CSS/JS は直書きしない- 変更後は必ず
bundle.mjs+verify.mjsを実行し、All files match (23 files)を確認 - UI 語の変更(
unpinned/snapshot/Move above)は内部名と分離して管理 - ゼロ長 chunk の保護則は
enforceI2とdropUnprotectedZeroLengthの協調動作で実現 - Split モードの純化(§3.3)は
recomputeAutoChunks(mode)の第 1 引数で制御 - 編集スコープ制限(§3.1)は
EditorState.changeFilterによりapp.bulkMode/app.updatingFromDocを除いて常時 ON - Storage 圧迫通知(§3.5)は
checkStoragePressure+autoPurgeOrphanedIfNeeded+ chip class の 3 点セット - Merge with next document(§3.7)は
beforeBulkcheckpoint を必ず保存する - I6 保証(§3.8)は
clearAllChunksPromptとrecomputeAutoChunksの fallback で実現