Text Chunker 引き継ぎ — BASELINE-5 から v4.0 へ
BASELINE-5(現行動作版)から仕様書 v4.0 への移行作業を 7 バッチで整理。削減見込み -700 行。
Text Chunker 引き継ぎ — BASELINE-5 → v4.0
0. 一行サマリ
BASELINE-5(現在の分割ソース 30 ファイル)は動作する。 これを仕様書 v4.0 へ移行する。移行は純粋な機能削減と再編成で、推定 −700 行。アーキテクチャは大幅に簡素化される。
1. 現状 (BASELINE-5)
1.1 ファイル構成
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, 全 19 ファイル)└── bundle/index.html bundle 生成物(本番配布用)1.2 動作確認済み
node scripts/bundle.mjs→bundle/index.html生成成功node scripts/verify.mjs→All files match (24 files)python3 -m http.server 8000→/bundle/で動作- dev ESM(
/)もsvcレジストリ導入により動作 - 循環依存警告 0
1.3 現行機能(BASELINE-5)
- 3 行ヘッダー、footer
- 分割(auto split / chapter split)
- 手動チャンク作成(⊕ ボタン / Ctrl+M)
- Split before / after
- Chunk 並び替え(Move up / down)
- Commit 相当(旧 done)
- Changes ビュー
- Boundaries(詳細パネル)
- Anchor lock
- Overlap lines
- Min fill
- Last after note
- Wrapper
when(always / smart / asNeeded / never) - 手動 save checkpoint
- Footer 右: chunkStatus
- Storage メニュー: File ▾ 内
1.4 既知の制約
svcレジストリで循環依存を動的解決(dev ESM 動作のため)pendingMarkFieldがtr.changes.mapPosを直接使用chunkSeparatorPluginは inline widget のみ(block 禁止)
2. 目標 (v4.0)
仕様書 2026-09-28-text-chunker-spec-v4 参照。要点:
| 領域 | 変更 |
|---|---|
| 不変条件 | 重複禁止 / ゼロ長禁止 |
| 状態 | auto / pinned(done 廃止) |
| commit | version + commitText + commitAt |
| 編集ロック | なし |
| Copy | forCopy で wrap 前後 N 行 |
| 出力 | beforeSection / afterSection 統合 |
| Footer 左 | storage 表示 |
| Footer 右 | LF / Count mode |
| 削除 | anchor / boundaries / minFill / overlap / lastAfter / When / 手動 checkpoint / Save checkpoint / Align / Split after / Open |
3. ギャップ分析
3.1 削除されるファイル・コード
| 対象 | 理由 | 行数 |
|---|---|---|
js/100-detail-panel.js | boundaries 廃止 | 全 370 行 |
#detailPanel HTML + CSS | 同上 | 120 |
_fStatusCache / ensureFStatusChildren | footer chunkStatus 廃止 | 100 |
#fChunkStatus HTML + CSS | 同上 | 60 |
finalizeDone / markNotDone | commit 化 | 80 |
renderDiff / setupDiffNav | Changes 表示は残すが内容変更 | 60(改修) |
overlapStart / computeOverlaps / overlapRangePlugin | overlap 廃止 | 90 |
toggleAnchorLock / anchorLocked 分岐 | anchor 廃止 | 30 |
manualSplitAtCursor('end') | split after 廃止 | 20 |
Align to next ロジック | 常時整列済み | 20 |
remove-zero-chunks メニュー | ゼロ長禁止 | 5 |
save-checkpoint メニュー項目 | 手動 checkpoint 廃止 | 5 |
Open メニュー項目 | 行クリックと重複 | 3 |
minFill パラメータ + 参照 | 用途なし | 30 |
overlapLines パラメータ + 参照 | copy wrap に置換 | 80 |
lastAfter パラメータ + 参照 | UI 簡素化 | 15 |
wrapper.when パラメータ + 参照 | 常時出力 | 20 |
changeFilterFn | 編集ロック廃止 | 25 |
削減小計: 約 1,000 行
3.2 追加されるコード
| 対象 | 内容 | 行数 |
|---|---|---|
commitChunk / copyAndCommit | done 代替 | 60 |
expandByLines | copy wrap 実装 | 40 |
| Footer storage ボタン + dropdown | File ▾ から移行 | 50 |
| Footer line ending ボタン + dropdown | 新規 | 40 |
| Footer count mode ボタン + dropdown | 新規 | 40 |
beforeSnippets / afterSnippets UI | Output dialog 内に統合 | 80 |
Migration v3 → v4(migrateOutput / migrateChunk) | 後方互換 | 60 |
| breakdown popover 拡張(line ending / count mode) | footer から移行 | 30 |
追加小計: 約 400 行
純削減: 約 600 行
4. 移行計画(BASELINE-6、7 バッチ)
各バッチ完了時に node scripts/verify.mjs を実行し All files match を維持する。
Batch 6-A: データモデル + migration
対象: js/60-model.js, js/110-ui.js, js/160-dialogs.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を更新- 旧
done→state='pinned'+commitVersion=1+commitText=doneText - 旧
wrapper.open + defaultBefore→beforeSection(結合) - 旧
defaultAfter + wrapper.close→afterSection anchorLockedは無視
- 旧
SettingsRec.schemaVersion = 2
検証: 既存 doc を import して正しく migration される
Batch 6-B: done → commit 実装
対象: js/140-workflow.js, js/90-editor.js, js/120-crud.js
finalizeDone→commitChunk(chunk, opts)に置換copyAndMarkDone→copyAndCommitに置換markNotDone削除_fStatusCache/ensureFStatusChildren削除updateEditorTopを簡素化(footer 関連を削除)refreshEditorRangesの readOnly 分岐削除(done なし)setViewMode('diff')の条件をcommitVersion > 0に変更renderDiff/setupDiffNavを commitText ベースにadvanceToNextNonDone→advanceToNextUncommitted
検証: Copy & Commit が動作、Changes で差分表示
Batch 6-C: anchor / split after / boundaries 削除
対象: 全 JS、index.html、CSS
anchorLocked全削除(js/120-crud.js,js/90-editor.js,js/130-tree.js,js/140-workflow.js)splitAfterBtn削除(index.html)、manual-split-end削除(js/170-wireui.js)js/100-detail-panel.jsファイル削除openDetailPanel/closeDetailPanel/detailオブジェクト削除#detailPanelHTML + CSS 削除changeFilterFn削除(js/90-editor.js)Ctrl+Shift+]削除(js/170-wireui.js)Chunks ▾メニューからRemove zero-length chunks削除
検証: 編集が自由、詳細パネルなしで動作
Batch 6-D: overlap / minFill / lastAfter / When 削除
対象: 全 JS
overlapStart/computeOverlaps/refreshOverlaps/overlapRangePlugin削除splitGapの overlap 分岐削除recomputeAutoChunksの overlap ロジック削除overlapIds/⊘バッジ削除minFill削除(chooseEnd)resolveAfterのlastAfter分岐削除wrapperVisibilityを単純化(never/alwaysの 2 択)enforceI2を強化(重複検出 + ゼロ長削除)
検証: 分割が重複なしで生成される
Batch 6-E: copy wrap 実装
対象: js/70-compose.js, js/80-split.js, js/160-dialogs.js
expandByLines(text, chunk, before, after)実装composeOutput(chunk, i, n, masterText, forCopy)内でforCopy === trueの時のみ適用computeChunkOverheadをwrapBeforeCnt/wrapAfterCnt対応に- Split settings から
overlapLines削除 - Output dialog に
Copy wrap before / afterフィールド追加
検証: Copy と Save で wrap 適用、プレビューでは非適用
Batch 6-F: Footer 再構成
対象: index.html, CSS, js/140-workflow.js, js/170-wireui.js
- Footer 左端に
#fStorageボタン + dropdown - Footer 右端に
#fLineEnding/#fCountModeボタン + dropdown #fChunkStatus削除#chunkStatusクリック →openChunkBreakdownPopoverに変更File ▾からExport JSON/Import JSON/Storage usage…削除(footer に移行)updateFooterCountsに storage 数値更新追加
検証: 起動時 storage 表示、footer で line ending / count mode 切替
Batch 6-G: Output dialog 再設計 + 統合テスト
対象: js/160-dialogs.js, CSS
editOutputSettingsを新レイアウトに- Before section(textarea + preset select)
- Copy wrap before / after(number)
- 本文プレースホルダ表示
- After section(textarea + preset select)
- Line ending
- Apply line ending to copy
Manage snippetsを Output dialog 内に統合(before / after それぞれの snippet 配列)editSnippets削除lastAfter/Whenの UI 削除- 受入テスト T1〜T26 実行
検証: round-trip 維持、全受入テスト pass
5. 主要な決定と根拠
5.1 done → commit + version 化
根拠:
- 編集ロック(done の副作用)は開発/運用の妨げになる
- 進捗管理(index/total)は Changes で代替可能
- commit を version として保持することで差分確認が自然になる
トレードオフ:
- 「凍結した出力」という概念は薄れる(commit 後の編集は許容)
- Changes ビューが commitVersion > 0 前提に変わる
5.2 overlap 廃止 → copy wrap
根拠:
- チャンク境界の重複は「同一領域が 2 つの chunk に属する」ことを意味し、並び替え・結合・fit を破壊する
- ユーザーの意図は「コピー時に前後の文脈を含めたい」という出力の話
- forCopy 拡張は物理範囲に影響しない
5.3 anchor 廃止
根拠:
- anchor と pin の違いが直感的でない
- 全 chunk を対称に
ChangeSet.mapPosで追従させれば十分 - 編集時は「master 上で自由に編集、chunk は追従」という一貫した動作
5.4 boundaries 廃止
根拠:
- 編集ロックと組み合わさって分かりにくい
- breakdown popover の方が情報が集約されている
- master 上で自由編集 → chunk が追従、で十分
5.5 編集ロック撤廃
根拠:
- filter があると「別の場所を編集しようとすると弾かれる」UX トラップ
- chunk の視覚表示(dimmed / band / gutter)だけ維持すれば、編集中の chunk は自明
6. リスクと未確定事項
| # | 内容 | 対応 |
|---|---|---|
| 1 | commitAutoPin の既定値 | true(commit が通常のワークフロー) |
| 2 | autoSplit の扱い | 継続(footer トグル) |
| 3 | 既存 done の migration | state='pinned' + commitVersion=1 で安全 |
| 4 | svc レジストリの必要性 | v4.0 で循環はさらに減る。最終的に svc が不要になる可能性あり(将来の BASELINE-7 で検討) |
| 5 | Changes ビューの差分アルゴリズム | 現行 renderSimpleDiff を継続 |
| 6 | snippet 配列の分離 | before / after 独立。既存 snippet は beforeSnippets に移行 |
7. 参照
- 仕様書 v4.0: 2026-09-28-text-chunker-spec-v4
- 分割化指示書: 2026-09-27-text-chunker-splitting-instructions
- 旧仕様書 v3.3: 2026-09-27-text-chunker-spec(superseded)
8. 現在の bundle の所在
public/tools/text-chunker/bundle/index.html
再生成:
cd public/tools/text-chunkernode scripts/bundle.mjsnode scripts/verify.mjs9. 着手時の注意
- 必ず Batch 6-A から順に進める。6-B 以降はデータモデル依存
- 各バッチで
verify.mjsを実行し、round-trip を維持 - 大規模な rename は避ける(関数名・変数名は据え置き、フィールド名のみ変更)
- 受入テストは各バッチ後に該当項目を実行
- 6-A 完了時点で旧 doc の import を 1 件テストし、migration を検証する
1. 1 ファイル = 1 見出し + 1 コードブロック
## `js/80-split.js`
~~~js...ファイルの中身(全文)...// @end~~~- 見出しは
##+ インラインコードで 相対パスのみ。連番や説明を付けたい場合は## 3/7:+ インラインコードのパス のように、パスをインラインコードで囲む。 - コードブロック本文の 1 行目は必ずファイルマーカー
// @file: <相対パス>(その言語のコメント記法で)。- JS / TS / Java / C 系 :
// @file: path/to/a.js - Python / Shell / YAML :
# @file: path/to/a.py - HTML / XML / Markdown :
<!-- @file: path/to/a.html --> - CSS :
/* @file: path/to/a.css */ - SQL :
-- @file: db/a.sql - JSON(コメント不可) : マーカーを書かず、見出しとフェンス情報で示す
(例: フェンス情報を
json title="package.json"にする)
- JS / TS / Java / C 系 :
- 最終行に
// @endを書く(欠けていても動くが、途中切れの検出精度が上がる)。 - フェンス情報は
言語のみ、または言語 title="相対パス"のいずれか。
2. 途中で切れる場合(分割送信)
1 回の応答に収まらないときは、必ずパート宣言を入れる。
## `js/60-model.js`
~~~js// @part: 1/3...前半...~~~次の応答の冒頭は、説明より先に続きのブロックを置く。
~~~js// @part: 2/3...続き...~~~- パートは 行の途中で切らない。必ず行末で区切る。
- 最後のパートには
// @part: 3/3と// @endを書く。 - 同じファイルを作り直す場合は分割ではなく 全文を 1 ブロックで再送し、
見出しに
(差し替え・全文)と明記する。
3. 禁止事項
- 応答全体を 1 つの大きなコードブロックで包まない(フェンスの入れ子禁止)。
- 1 つのコードブロックに複数ファイルを入れない。
- ファイル内容のコードブロックに、説明文・省略記号・
...(中略)...・ 差分(diff)を混ぜない。常に完全な全文を出す。 - ファイル本文のコードブロック内に、さらにフェンス(バッククォート 3 個)を 書かない。どうしても必要なら外側フェンスをバッククォート 4 個以上にする。
- 見出しやフェンス情報のパスと、
// @file:のパスを食い違わせない。 - 変更点の説明・表・チェックリストは、コードブロックの 外に書く。
4. 推奨(任意)
- 応答の先頭に、その応答で出すファイルの一覧を箇条書きで書く。
- パスは常にプロジェクトルート相対(
./や絶対パス、..は使わない)。