logstable

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.html

v4.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-edit CSS 追加
  • #chunkStackPopover CSS 追加

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&notes の設定も集約」
  • 「タブで切り替えなど、グループ化」

実装:

  • 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 は削除される(beforeBulk checkpoint で復元可能)

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 document180
Row 2/3 UI30
Diff オーバーレイ30
Storage 圧迫通知200
Split モード純化150
同一行重なり100
This chunk アクション60
I6 保証20
nav cycle30
未使用 import 削除 / CSS 追加30
合計約 1780 行

4.2 削除されたもの

対象削除行数(概算)
openMergeMasterDialog / applyMergeMaster250
advanceToNextUncommitted15
canMoveUp / canMoveDown / moveChunk90
ドロワーの履歴セクション30
未使用 import5
合計約 390 行

純増: 約 +1390 行(v4.2 は v4.1 より機能が大幅に増えたため)

5. 主要な API / 型の変更

5.1 ChunkRec

変更なし(v4.1 のまま)。state: 'unpinned' で履歴保持を許容する運用変更のみ。

5.2 DocumentRec

order: number; // v4.2

5.3 HistoryRec

type: 'master' | 'chunk'; // v4.2
chunkId: string | null; // v4.2
version: number | null; // v4.2
kind: 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-finalSave / Copy / Merge master files… / Extract
7-DSave / Copy / Merge master files… / History… / Extract
7-GSave / Copy / Merge with next document… / History… / Extract

6.4 設定エントリ

段階内容
v4.1-finalSplit settings… / Output format & notes… / ⚙ App settings
7-F⚙ 統合設定(4 タブ) に集約。旧エントリはエイリアス

6.5 Chunk コンテキストメニュー

段階内容
v4.1-finalHeader / Copy / Create / Move(連続時のみ) / State / Edit / Danger
7-CMove up/down / Merge down / Snapshot グループ / Pin state グループ
7-D+ History…
7-EMove 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. リスクと未確定事項

#内容状態
1pinChunk / pinChunkLocal の重複v4.3 で統合予定
2chunkKey の unpinned@<offset> が位置依存v4.3 で ephemeral 用キーを再検討
3mergeWithNextDocument の seq 再採番single-tab lock 下では実害なし
4app.chunks / app.autos の二重配列v5.0 で統合予定
5内部名 commit* と UI 語 snapshot の乖離v5.0 で rename 予定
6160-dialogs.js が 1560 行v4.3 で settings / history / merge / code blocks に分割
7#diffView height: 40% 固定実機調整の余地
8app.ui.historyExpanded デッドステートv4.3 で削除
9#detailPanel 関連 CSSv4.3 で削除
10navigator.storage.estimate 非対応ブラウザ常に ok(実害なし)

8. ファイル適用順序

8.1 完全版ファイル(v4.1-final からの差分)

#ファイル最終バッチ変更概要
1js/00-main.js—変更なし
2js/10-utils.js—変更なし
3js/20-count.js—変更なし
4js/30-safe-pos.js—変更なし
5js/40-candidates.js—変更なし
6js/50-storage.js—変更なし
7js/60-model.js7-FmergeSeparator / ensureDocumentOrder
8js/70-compose.js—変更なし
9js/80-split.js7-Lモード分離 + I6 fallback
10js/90-editor.js7-LeditScopeFilter + stack popover + __i fix
11js/110-ui.js7-LcheckStoragePressure + 未使用 import 削除
12js/120-crud.js7-Lnav cycle + clearAllChunks + cutChunkAtNextHeading
13js/130-tree.js7-Lcontext menu: This chunk グループ
14js/140-workflow.js7-LsplitAuto/splitChapter の mode 指定
15js/150-checkpoint.js7-JHistoryRec 拡張 + orphan purge
16js/160-dialogs.js7-J統合設定 + 統合履歴 + Storage 拡張
17js/170-wireui.js7-JStorage 圧迫通知
18js/180-boot.js7-Jsvc 登録
19index.html7-GMerge with next document… + ⇣ + .snapshot
20styles/00-base.css—変更なし
21styles/10-layout.css7-Jstorage-warn / storage-danger / .storage-reason
22styles/20-components.css7-L.btn.snapshot + .snip-*
23styles/30-editor.css7-LDiff overlay + chunk stack popover
24styles/40-theme-light.css7-Lライト版調整

8.2 適用順序(依存関係順)

1. 7-F の js/60-model.js
2. 7-J の js/150-checkpoint.js
3. 7-J の js/160-dialogs.js
4. 7-J の js/170-wireui.js
5. 7-J の js/180-boot.js
6. 7-G の index.html
7. 7-J の styles/10-layout.css
8. 7-L の js/80-split.js
9. 7-L の js/90-editor.js
10. 7-L の js/110-ui.js
11. 7-L の js/120-crud.js
12. 7-L の js/130-tree.js
13. 7-L の js/140-workflow.js
14. 7-L の styles/20-components.css
15. 7-L の styles/30-editor.css
16. 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

再生成:

Terminal window
cd public/tools/text-chunker
node scripts/html-build/bundle.mjs --project text-chunker
node 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)

  1. 全ファイル配置後、bundle.mjs 実行 → 循環依存警告が 0 件
  2. verify.mjs 実行 → All files match (23 files)
  3. dev ESM 起動 → 全 23 ファイルが HTTP 200/304
  4. サイドバーに Unpinned / Pinned バッジが出る
  5. Footer に [IDB] [⚡Live] が出る
  6. Row 2 の主ボタンが 📋(青)
  7. Snapshot ボタンが緑
  8. Row 3 に ⇣ が出る
  9. chunk を選択 → chunk 外の編集が拒否される(T4 / T35)
  10. Chunk context menu に This chunk グループ(Fill by limit / Cut at headings)が出る
  11. Chunks ▾ → Fill by limit… → heading 無視で文字数分割
  12. Chunks ▾ → Cut at headings… → heading 位置のみで分割
  13. ⚙ クリック → 4 タブの統合設定が開く
  14. File ▾ → Merge with next document… → 次 doc が連結される
  15. File ▾ → History… → 3 タブの統合履歴が開く
  16. Diff クリック → 下 40% にオーバーレイ、エディタ位置保持
  17. [IDB] chip クリック → Storage ダイアログ(内訳 + Clear)
  18. Clear all chunks → 必ず 1 chunk 残る
  19. ◀ で #1 → Master、▶ で #N → Master
  20. 同一行に複数 chunk start → ラベル (×N)、クリックで popover

11. 既知の制約

#内容影響対応予定
1expandByLines は O(n) で lineStarts を毎回再構築大規模 doc で copy 連打時に劣化v4.3 でメモ化
2computeChunkOverhead は二重 composeOutputbreakdown popover でのみ実行現状維持
3chunkSeparatorPlugin は app.chunks のみ対象unpinned には widget が出ない(仕様通り)—
4app.chunks / app.autos の二重配列保守性負債v5.0 で統合
5内部名 commit* と UI 語 snapshot の乖離開発者の混乱リスクv5.0 で rename
6pinChunk / pinChunkLocal の重複片方の修正が他方に反映されないリスクv4.3 で統合
7chunkKey の unpinned@<offset> が位置依存lastOpened 復元で稀に誤選択v4.3 で再検討
8mergeWithNextDocument の seq 再採番がセッション依存single-tab lock 下では実害なし現状維持
9#diffView height: 40% が viewport 非依存実機調整の余地v4.3
10_lastAutoPurgeAt がセッション内のみ仕様通り—
11app.ui.historyExpanded がデッドステートメモリ数バイトのみv4.3 で削除
12#detailPanel 関連 CSS が残存(v3.x 遺産)未使用、~30 行v4.3 で削除

12. 将来の検討事項

#内容優先度
1pinChunk / pinChunkLocal の統合高
2chunkKey の ephemeral 用キー再設計高
3160-dialogs.js の責務分割中
4app.ui.historyExpanded / #detailPanel 削除中
5expandByLines の lineStarts メモ化中
6#diffView の高さ可変化低
7自動テストフレームワーク導入(node --test)中
8commit* 内部名を snapshot* に全面 rename(v5.0)中
9app.chunks / app.autos の単一配列化(v5.0)中
10svc レジストリの必要性見直し低

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)は beforeBulk checkpoint を必ず保存する
  • I6 保証(§3.8)は clearAllChunksPrompt と recomputeAutoChunks の fallback で実現