Text Chunker 引き継ぎ — BASELINE-5 → v4.1-final
BASELINE-5(v3.x)から v4.1-final への移行を 14 バッチ(6-A〜6-N)で整理。削減約 -900 行 + 語彙統一 + ゼロ長保護則 + round-trip 修正。
Text Chunker 引き継ぎ — BASELINE-5 → v4.1-final
0. 一行サマリ
BASELINE-5(v3.x)から v4.1-final への移行完了。 14 バッチ(6-A〜6-N)で純削減 約 −900 行。アーキテクチャは簡素化され、語彙は直感的になり、ゼロ長 chunk の保護則が明文化され、分割ソース / bundle の round-trip 検証が All files match (23 files) で通過。
1. 到達点
1.1 検証済み状態
| 項目 | 状態 |
|---|---|
bundle.mjs | ✓ 5 css + 18 js → 287,028 bytes |
verify.mjs | ✓ All files match (23 files) |
| 循環依存 | ✓ 0 件 |
| dev ESM | ✓ 全 23 ファイルが HTTP 200/304 で読込完了 |
@file: マーカー | ✓ 全ファイル === 付き |
@import: → 実 import | ✓ 1:1 対応 |
1.2 ファイル構成
public/tools/text-chunker/├── index.html entry template(分割ソース版)├── 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 bundle 生成物(単一 HTML)v3.x との差分:
js/100-detail-panel.js削除js/40-candidates.jsにfindFenceCandidates追加index.htmlの構造明確化(<link>+<script type="module" src>)
2. バッチ別サマリ(6-A〜6-N)
Batch 6-A: データモデル + migration
対象: js/60-model.js / js/110-ui.js / js/160-dialogs.js / js/180-boot.js
SplitParamsからmargin/overlapLines/minFill/autoSplitOnPaste削除OutputSettingsをbeforeSection/afterSection/copyWrapBefore/copyWrapAfter/copyAppliesLineEndingに変更ChunkRecからdoneText/doneSource/doneIndex/doneTotal/doneAt/anchorLocked削除、commitVersion/commitText/commitAt追加migrateParams/migrateOutput/migrateChunkを新形式にSettingsRec.schemaVersion = 2
Batch 6-B: done → commit + version
対象: js/140-workflow.js / js/90-editor.js / js/120-crud.js / js/130-tree.js / js/60-model.js / js/180-boot.js / js/170-wireui.js
finalizeDone→commitChunkcopyAndMarkDoneChunk→copyAndCommitChunkadvanceToNextNonDone→advanceToNextUncommitted_fStatusCache/ensureFStatusChildren削除refreshEditorRangesの readOnly 分岐削除migrateChunkのcommitText = doneSourceに修正
Batch 6-C: anchor / split after / boundaries / gap 削除
対象: index.html / js/90-editor.js / js/120-crud.js / js/140-workflow.js / js/130-tree.js / js/170-wireui.js / js/180-boot.js / js/110-ui.js / js/160-dialogs.js
js/100-detail-panel.js削除#detailPanel/#splitAfterBtn/#markChunkBtn/#fChunkStatusを HTML から削除changeFilterFn/pendingMark*/overlapRangePluginを editor から削除toggleMarkChunk/cancelMarkChunk削除insertCheckpointMenuItems削除updateDoneEditBanner削除- 動的 import を静的化
Batch 6-D: overlap / minFill / lastAfter / When 削除
対象: js/170-wireui.js / js/80-split.js / js/70-compose.js / js/90-editor.js
overlapStart/overlapLines/minFill削除wrapperVisibility/resolveBefore/resolveAfter/isEffectivelyEmpty削除enforceI2強化(非重複保証)- C9 修正:
EditorViewimport 追加
Batch 6-E: copy wrap + fence 候補 + D1/D2
対象: js/40-candidates.js / js/70-compose.js / js/80-split.js / js/90-editor.js
findFenceCandidates追加(コードブロック境界優先分割)expandByLines追加(Copy wrap 実装)composeOutputのforCopywrap 適用computeChunkOverheadに wrap 分を反映enforceI2確定版
Batch 6-F: Footer 再構成 + Row 2/3 再編
対象: index.html / js/170-wireui.js / js/140-workflow.js / js/180-boot.js / js/120-crud.js / js/160-dialogs.js
- Row 1 に
?Legend 追加 - Row 2:
✓ Commit/⋮追加、🔍/?削除 - Row 3:
[Text|Diff]/⇤/📋 Copy/🔍/⚡Live - Footer:
[IDB]/[LF]/[UTF-16]chip 追加、MvN削除 - File ▾ から Export/Import JSON / Storage usage を Footer chip に移動
Batch 6-G: snippet 統合 + text/chunk 同一化 + F1
対象: index.html / js/170-wireui.js / js/160-dialogs.js
editSnippetsを Output dialog 内に統合(<details>折り畳み)- Chunks ▾ に
Textグループ追加 - F1 解消: 動的 import を静的化
Batch 6-H: Split text at chunk start (new document)
対象: js/120-crud.js / js/170-wireui.js / js/130-tree.js / index.html / js/180-boot.js
- 解釈 C を実装: master を 2 doc に分割
- 選択チャンクは後半 doc に残る
- commit 履歴は chunk と一緒に移動
- toast に
[Open]アクション
Batch 6-I: UI polish(C1〜C8, C11)
対象: index.html / js/110-ui.js / js/90-editor.js / js/120-crud.js / js/130-tree.js / js/160-dialogs.js / js/170-wireui.js
- C1: Copy 主 / Commit 副
- C3: ⚡Live を Footer に復帰
- C5: Storage chip からサイズ表示削除
- C6:
?を Row 1 へ - C7: Chunks ▾ の Move/Merge 削除
- C8:
enforceI2trim の toast 通知 - C11: split toast に
[Open] toast(..., opts.autoMs)追加
Batch 6-J: unpinned 語彙 + autoPinOnInteraction + ゼロ長保護則
対象: js/60-model.js / js/80-split.js / js/90-editor.js / js/120-crud.js / js/130-tree.js / index.html / js/160-dialogs.js / js/180-boot.js
state: 'auto'→'unpinned'chunkKeyprefixauto@→unpinned@promoteAutoOnEdit→promoteUnpinnedOnEditautoPinOnInteraction設定追加(既定 true)unpinChunk新設(releaseChunkはエイリアス)enforceI2をゼロ長免除に変更dropUnprotectedZeroLength追加updateCursorChunkにゼロ長完全一致ZeroLenMarker追加dimPluginにゼロ範囲分岐createNewChunkAfterを pin 済みで作成∅バッジ /⚠ SRバッジ分離
Batch 6-K: commit → snapshot 語彙統一
対象: index.html / js/140-workflow.js / js/170-wireui.js / js/160-dialogs.js / js/130-tree.js
- UI 文言を
commit→snapshotに統一 - 内部名(
commitChunk/commitVersion/commitText/commitAt/commitAutoPin)は永続化互換のため維持 Snapshotted: N/No changes since snapshot./Snapshot #N → vM等
Batch 6-L: 完全版再出力(統合)
対象: index.html / js/130-tree.js / js/140-workflow.js / js/170-wireui.js / js/180-boot.js
- 適用順序の依存関係を解消
- 5 ファイルの完全版を出力
Batch 6-M: Round-trip 修正
対象: 全 18 JS + 5 CSS ファイル / js/160-dialogs.js
@file:マーカーを===形式に統一:- CSS:
/* === @file: styles/xx-name.css === */ - JS:
// === @file: js/xx-name.js ===
- CSS:
@import:directive の直後に実 import 文を 1:1 配置(規約 §6.4 準拠)160 → 170の直接 import を削除:refreshFooterChips()→svc.refreshFooterChips?.()に変更(3 箇所)- 循環依存
160 ⇄ 170 ⇄ 140 ⇄ 160を切断
160-dialogs.jsの NOTE コメントを import 群の後ろに移動(round-trip 差分検出回避)
Batch 6-N: P0/P1 バグ修正
| # | バグ | 対象 | 修正 |
|---|---|---|---|
| Q1 | mapImportedChunk の v1→v2 変換が暗黙 | 160-dialogs.js | v1/v2/auto/done の全変換経路をコメントで明記 |
| Q2 | dropUnprotectedZeroLength の Store 削除失敗を握り潰し | 90-editor.js | console.warn + dirtyChunkIds に再登録し、次回 persistNow で再試行 |
| Q5 | chooseEnd が毎回候補配列を再構築 | 80-split.js | hints 引数追加、splitGap で hc / fc / bp を一度だけ構築 |
| Q9 | showManualCopySheet の未使用 n 引数 | 140-workflow.js | 引数から削除、呼び出し側も更新 |
| UX4 | Diff ヘッダの .badge にスタイルなし | styles/30-editor.css | #diffView .diffHeader .badge を追加 |
3. 主要な設計判断
3.1 done → commit + version 化
根拠:
- 編集ロック(done の副作用)は開発/運用の妨げ
- 進捗管理(index/total)は Diff で代替可能
- commit を version として保持することで差分確認が自然
トレードオフ:
- 「凍結した出力」という概念は薄れる
- Changes ビューが commitVersion > 0 前提に変わる
- UI 語は
snapshotに変更して git 連想を回避
3.2 overlap 廃止 → copy wrap
根拠:
- チャンク境界の重複は並び替え・結合・fit を破壊する
- ユーザーの意図は「コピー時に前後の文脈を含めたい」という出力の話
- forCopy 拡張は物理範囲に影響しない
3.3 anchor 廃止
根拠:
- anchor と pin の違いが直感的でない
- 全 chunk を対称に
ChangeSet.mapPosで追従させれば十分 - snapshot 済みは Move 対象外とするだけで暗黙の保護が成立
3.4 boundaries 廃止
根拠:
- 編集ロックと組み合わさって分かりにくい
- breakdown popover の方が情報が集約されている
- master 上で自由編集 → chunk が追従、で十分
3.5 編集ロック撤廃
根拠:
- filter があると「別の場所を編集しようとすると弾かれる」UX トラップ
- chunk の視覚表示(dimmed / band / gutter)だけ維持すれば、編集中の chunk は自明
3.6 auto → unpinned
根拠:
- 「自動」の意味不明(何が自動か)
pinnedの直接対義語が自然- 動詞
Pin/Unpinと整合 - 内部の
app.autosは「自動生成された list」の意味で維持
3.7 commit → snapshot (UI のみ)
根拠:
- git の commit と誤解される
- 編集ロックを含意しない “snapshot” が実態に合う
- 内部名は永続化スキーマ互換のため維持
- 将来 v5.0 で全面 rename 可能
3.8 ゼロ長 chunk の保護則
根拠:
- pin / snapshot はユーザーの明示的な操作
- 履歴を守るには実体のない位置でも保持が必要
- 非保護のゼロ長は「無関心な chunk」として削除
createNewChunkAfterは pin 済みで作成して直後の消失を防ぐ
3.9 循環依存の切断(6-M)
問題: 160-dialogs.js が 170-wireui.js の refreshFooterChips を直接 import し、170 → 140 → 160 → 170 の循環を形成。bundle は hoisting で救われるが dev ESM では TDZ の懸念。
解決: svc.refreshFooterChips?.() 経由に変更。svc は 10-utils.js が export し、180-boot.js の Object.assign(svc, {...}) で populate される。
4. 削減と追加
4.1 削減されたもの
| 対象 | 削減行数(概算) |
|---|---|
js/100-detail-panel.js | 370 |
#detailPanel HTML + CSS | 120 |
_fStatusCache / ensureFStatusChildren | 100 |
#fChunkStatus HTML + CSS | 60 |
finalizeDone / markNotDone | 80 |
overlapStart / computeOverlaps / overlapRangePlugin | 90 |
toggleAnchorLock / anchorLocked 分岐 | 30 |
manualSplitAtCursor('end') | 20 |
Align to next | 20 |
minFill パラメータ + 参照 | 30 |
overlapLines パラメータ + 参照 | 80 |
lastAfter パラメータ + 参照 | 15 |
wrapper.when パラメータ + 参照 | 20 |
changeFilterFn | 25 |
pendingMark* | 40 |
insertCheckpointMenuItems | 30 |
updateDoneEditBanner | 10 |
Mark chunk 関連 | 60 |
| 合計 | 約 1,200 行 |
4.2 追加されたもの
| 対象 | 追加行数(概算) |
|---|---|
commitChunk / copyAndCommit / undoLastCommit | 60 |
expandByLines | 40 |
findFenceCandidates | 30 |
unpinChunk / dropUnprotectedZeroLength | 60 |
ZeroLenMarker / dimPlugin ゼロ範囲 | 40 |
promoteUnpinnedOnEdit / autoPinOnInteraction | 30 |
splitTextAtChunkStart | 100 |
| Footer storage / line ending / count mode chip | 130 |
beforeSnippets / afterSnippets UI 統合 | 80 |
| Migration v3 → v4.1 | 60 |
| breakdown popover 拡張 | 30 |
| import 文(round-trip 対応) | 90 |
=== マーカー統一 | 46 |
| 合計 | 約 800 行 |
純削減: 約 −400 行(CSS 削除分を含めると −900 行)
5. 主要な API / 型の変更
5.1 ChunkRec
state: 'auto' | 'pinned' | 'done'state: 'unpinned' | 'pinned'
doneText: string | nulldoneSource: string | nulldoneIndex: number | nulldoneTotal: number | nulldoneAt: number | nullanchorLocked: booleancommitVersion: numbercommitText: string | null // source slicecommitAt: number | null5.2 SplitParams
margin: numberoverlapLines: numberminFill: numberautoSplitOnPaste: boolean5.3 OutputSettings
wrapper: { open, close, when }defaultBefore: stringdefaultAfter: stringlastAfter: string | nullbeforeSection: stringafterSection: stringcopyWrapBefore: numbercopyWrapAfter: numbercopyAppliesLineEnding: boolean5.4 SettingsRec
schemaVersion: 1schemaVersion: 2
noteSnippets: string[]wrapperPresets: any[]gapWhitespace: 'exclude' | 'include'beforeSnippets: string[]afterSnippets: string[]
autoPinOnInteraction: boolean // 新規6. UI 変更の変遷
6.1 Row 2
| 段階 | 内容 |
|---|---|
| BASELINE-5 | ◀ ▶ · chunkStatus · 🔍 · ? |
| 6-F | ◀ ▶ · chunkStatus · ✓ Commit · ⋮ |
| 6-I | ◀ ▶ · chunkStatus · 📋 Copy · ✓ · ⋮ |
| 6-L | 同上(Snapshot 語彙反映) |
6.2 Row 3
| 段階 | 内容 |
|---|---|
| BASELINE-5 | ↤ ↦ · Content|Changes · ⇤ ⊕ · Copy&Commit · ↶ · ⋮ |
| 6-C | ↤ ↦ · Content|Changes · ⇤ · Copy&Commit · ↶ · ⋮ |
| 6-F | [Text|Diff] · ⇤ · 📋 Copy · 🔍 · ? · ⚡Live |
| 6-I | [Text|Diff] · ⇤ · 🔍 |
6.3 Footer
| 段階 | 内容 |
|---|---|
| BASELINE-5 | Ln · Total · Sel · Mv · ⚡Live · chunkStatus |
| 6-F | [IDB] · Ln · Total · Sel · [LF] · [UTF-16] |
| 6-I | [IDB] · [⚡Live] · Ln · Total · Sel · [LF] · [UTF-16] |
7. リスクと未確定事項
| # | 内容 | 状態 |
|---|---|---|
| 1 | commitAutoPin の既定値 | true(実装済み) |
| 2 | autoSplit の扱い | 継続(footer トグル) |
| 3 | 既存 done の migration | state='pinned' + commitVersion=1 + commitText=doneSource |
| 4 | state: 'auto' の migration | 'unpinned' に rename(migrateChunk) |
| 5 | Changes ビューの差分アルゴリズム | 現行 renderSimpleDiff を継続 |
| 6 | snippet 配列の分離 | before / after 独立。noteSnippets は beforeSnippets に移行 |
| 7 | svc レジストリの必要性 | 循環依存解消のため 160 → 170 で必要。他は将来縮小検討 |
| 8 | app.chunks / app.autos の二重配列 | v5.0 で統合予定 |
| 9 | 内部名 commit* と UI 語 snapshot | v5.0 で全面 rename 予定 |
8. ファイル適用順序
8.1 完全版ファイル(そのまま上書き配置)
| # | ファイル | 完全版バッチ |
|---|---|---|
| 1 | js/00-main.js | BASELINE-5 |
| 2 | js/10-utils.js | BASELINE-5 |
| 3 | js/20-count.js | BASELINE-5 |
| 4 | js/30-safe-pos.js | BASELINE-5 |
| 5 | js/40-candidates.js | 6-E |
| 6 | js/50-storage.js | BASELINE-5 |
| 7 | js/60-model.js | 6-J |
| 8 | js/70-compose.js | 6-E(+6-M で === 追加) |
| 9 | js/80-split.js | 6-N(Q5 + 6-M ===) |
| 10 | js/90-editor.js | 6-N(Q2 + 6-M ===) |
| 11 | js/110-ui.js | 6-I(+6-M ===) |
| 12 | js/120-crud.js | 6-J(+6-M ===) |
| 13 | js/130-tree.js | 6-L |
| 14 | js/140-workflow.js | 6-N(Q9 + 6-M ===) |
| 15 | js/150-checkpoint.js | BASELINE-5 |
| 16 | js/160-dialogs.js | 6-N(Q1 + 6-M 循環切断 + NOTE 位置) |
| 17 | js/170-wireui.js | 6-L |
| 18 | js/180-boot.js | 6-L |
| 19 | index.html | 6-M(分割ソース版、<link> + <script src>) |
| 20 | styles/00-base.css | 6-M(===) |
| 21 | styles/10-layout.css | 6-M(===) |
| 22 | styles/20-components.css | 6-M(===) |
| 23 | styles/30-editor.css | 6-N(UX4 + 6-M ===) |
| 24 | styles/40-theme-light.css | 6-M(===) |
8.2 削除ファイル
| # | ファイル | 削除バッチ |
|---|---|---|
| 1 | js/100-detail-panel.js | 6-C |
8.3 依存関係マップ
10-utils ← 全ファイル(svc レジストリもここ)60-model ← 70, 80, 90, 110, 120, 130, 140, 150, 160, 170, 18070-compose ← 80, 90, 120, 140, 160, 17080-split ← 90, 120, 140, 160, 170, 18090-editor ← 120, 140, 160, 170, 180110-ui ← 120, 130, 140, 160, 170, 180120-crud ← 130, 140, 170, 180130-tree ← 140, 170, 180140-workflow ← 170, 180150-checkpoint ← 120, 160, 180160-dialogs ← 180(170 へは import しない → 循環切断)170-wireui ← 180180-boot ← 00-main重要な順序制約:
10-utils.jsはsvcの exporter。全ファイルが参照60-model.jsは他の全ファイルに先行(state: 'unpinned'を export)160-dialogs.jsは170-wireui.jsを import しない(svc経由のみ)170-wireui.jsは他ファイルを自由に import して良い(DAG 末端)
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.1-final)
- 全ファイル配置後、
bundle.mjs実行 → 循環依存警告が 0 件であること verify.mjs実行 →All files match (23 files)- dev ESM 起動 → 全 23 ファイルが HTTP 200/304 で読込完了
- サイドバーに
Unpinnedバッジが出る - Footer に
[IDB][⚡Live]が出る - Row 2 の主ボタンが
📋 Copy(青) - 空ドキュメントで 1 unpinned chunk
[0,0)が自動生成される - 何か入力すると
autoPinOnInteractionにより pinned 化 - 設定 → “Pin an unpinned chunk when edited or renamed” が表示される
- ゼロ長 pinned を作成 → 編集で消えない
- ゼロ長 unpinned を作成 → 自動削除される
- Split into new document → 2 doc に分かれる
11. 既知の制約
| # | 内容 | 影響 | 対応予定 |
|---|---|---|---|
| 1 | expandByLines は O(n) で lineStarts を毎回再構築 | 大規模 doc で copy 連打時に劣化 | v4.2 でメモ化 |
| 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 |
12. 将来の検討事項
| # | 内容 | 優先度 |
|---|---|---|
| 1 | commit* 内部名を snapshot* に全面 rename(v5.0) | 中 |
| 2 | expandByLines の lineStarts メモ化 | 低 |
| 3 | ゼロ長 chunk の Add marker here 明示作成 | 中 |
| 4 | ゼロ長 chunk の name 必須化 | 低 |
| 5 | カーソル位置での Split here コンテキストメニュー | 中 |
| 6 | app.chunks / app.autos の単一配列化 | 中 |
| 7 | svc レジストリの必要性見直し | 低 |
| 8 | 自動テストフレームワーク導入(node --test) | 中 |
13. 参照
- 仕様書 v4.1-final: 2026-09-29-text-chunker-spec-v4.1-final
- 元仕様 v4.1: 2026-09-28-text-chunker-spec-v4.1
- 旧引き継ぎ v4: Text Chunker 引き継ぎ — BASELINE-5 から v4.0 へ
- 分割化指示書: 2026-09-27-text-chunker-splitting-instructions
14. 着手時の注意
- 適用順は §8.3 の依存関係マップを厳守
10-utils.jsはsvcを export(変更しない)60-model.jsは他の全ファイルに先行160-dialogs.jsは170-wireui.jsを import しない(svc.refreshFooterChips?.()経由)- 各ファイルの先頭は
// === @file: ... ===または/* === @file: ... === */ - 各 JS ファイルは
// @import:directive の直後に実 import を 1:1 で持つ(複数行 import 禁止) index.htmlは分割ソース版(<link>+<script type="module" src>)。CSS/JS は直書きしない- 変更後は必ず
bundle.mjs+verify.mjsを実行し、All files match (23 files)を確認 - UI 語の変更(
unpinned/snapshot)は内部名と分離して管理 - ゼロ長 chunk の保護則は
enforceI2とdropUnprotectedZeroLengthの協調動作で実現