log

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 廃止)
commitversion + commitText + commitAt
編集ロックなし
CopyforCopy で 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.jsboundaries 廃止全 370 行
#detailPanel HTML + CSS同上120
_fStatusCache / ensureFStatusChildrenfooter chunkStatus 廃止100
#fChunkStatus HTML + CSS同上60
finalizeDone / markNotDonecommit 化80
renderDiff / setupDiffNavChanges 表示は残すが内容変更60(改修)
overlapStart / computeOverlaps / overlapRangePluginoverlap 廃止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 / copyAndCommitdone 代替60
expandByLinescopy wrap 実装40
Footer storage ボタン + dropdownFile ▾ から移行50
Footer line ending ボタン + dropdown新規40
Footer count mode ボタン + dropdown新規40
beforeSnippets / afterSnippets UIOutput 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

  1. SplitParams から margin / overlapLines / minFill / autoSplitOnPaste 削除
  2. OutputSettings を beforeSection / afterSection / copyWrapBefore / copyWrapAfter / copyAppliesLineEnding に変更
  3. ChunkRec から doneText / doneSource / doneIndex / doneTotal / doneAt / anchorLocked 削除、commitVersion / commitText / commitAt 追加
  4. migrateParams / migrateOutput / migrateChunk を更新
    • 旧 done → state='pinned' + commitVersion=1 + commitText=doneText
    • 旧 wrapper.open + defaultBefore → beforeSection(結合)
    • 旧 defaultAfter + wrapper.close → afterSection
    • anchorLocked は無視
  5. SettingsRec.schemaVersion = 2

検証: 既存 doc を import して正しく migration される

Batch 6-B: done → commit 実装

対象: js/140-workflow.js, js/90-editor.js, js/120-crud.js

  1. finalizeDone → commitChunk(chunk, opts) に置換
  2. copyAndMarkDone → copyAndCommit に置換
  3. markNotDone 削除
  4. _fStatusCache / ensureFStatusChildren 削除
  5. updateEditorTop を簡素化(footer 関連を削除)
  6. refreshEditorRanges の readOnly 分岐削除(done なし)
  7. setViewMode('diff') の条件を commitVersion > 0 に変更
  8. renderDiff / setupDiffNav を commitText ベースに
  9. advanceToNextNonDone → advanceToNextUncommitted

検証: Copy & Commit が動作、Changes で差分表示

Batch 6-C: anchor / split after / boundaries 削除

対象: 全 JS、index.html、CSS

  1. anchorLocked 全削除(js/120-crud.js, js/90-editor.js, js/130-tree.js, js/140-workflow.js)
  2. splitAfterBtn 削除(index.html)、manual-split-end 削除(js/170-wireui.js)
  3. js/100-detail-panel.js ファイル削除
  4. openDetailPanel / closeDetailPanel / detail オブジェクト削除
  5. #detailPanel HTML + CSS 削除
  6. changeFilterFn 削除(js/90-editor.js)
  7. Ctrl+Shift+] 削除(js/170-wireui.js)
  8. Chunks ▾ メニューから Remove zero-length chunks 削除

検証: 編集が自由、詳細パネルなしで動作

Batch 6-D: overlap / minFill / lastAfter / When 削除

対象: 全 JS

  1. overlapStart / computeOverlaps / refreshOverlaps / overlapRangePlugin 削除
  2. splitGap の overlap 分岐削除
  3. recomputeAutoChunks の overlap ロジック削除
  4. overlapIds / ⊘ バッジ削除
  5. minFill 削除(chooseEnd)
  6. resolveAfter の lastAfter 分岐削除
  7. wrapperVisibility を単純化(never / always の 2 択)
  8. enforceI2 を強化(重複検出 + ゼロ長削除)

検証: 分割が重複なしで生成される

Batch 6-E: copy wrap 実装

対象: js/70-compose.js, js/80-split.js, js/160-dialogs.js

  1. expandByLines(text, chunk, before, after) 実装
  2. composeOutput(chunk, i, n, masterText, forCopy) 内で forCopy === true の時のみ適用
  3. computeChunkOverhead を wrapBeforeCnt / wrapAfterCnt 対応に
  4. Split settings から overlapLines 削除
  5. Output dialog に Copy wrap before / after フィールド追加

検証: Copy と Save で wrap 適用、プレビューでは非適用

対象: index.html, CSS, js/140-workflow.js, js/170-wireui.js

  1. Footer 左端に #fStorage ボタン + dropdown
  2. Footer 右端に #fLineEnding / #fCountMode ボタン + dropdown
  3. #fChunkStatus 削除
  4. #chunkStatus クリック → openChunkBreakdownPopover に変更
  5. File ▾ から Export JSON / Import JSON / Storage usage… 削除(footer に移行)
  6. updateFooterCounts に storage 数値更新追加

検証: 起動時 storage 表示、footer で line ending / count mode 切替

Batch 6-G: Output dialog 再設計 + 統合テスト

対象: js/160-dialogs.js, CSS

  1. editOutputSettings を新レイアウトに
    • Before section(textarea + preset select)
    • Copy wrap before / after(number)
    • 本文プレースホルダ表示
    • After section(textarea + preset select)
    • Line ending
    • Apply line ending to copy
  2. Manage snippets を Output dialog 内に統合(before / after それぞれの snippet 配列)
  3. editSnippets 削除
  4. lastAfter / When の UI 削除
  5. 受入テスト 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. リスクと未確定事項

#内容対応
1commitAutoPin の既定値true(commit が通常のワークフロー)
2autoSplit の扱い継続(footer トグル)
3既存 done の migrationstate='pinned' + commitVersion=1 で安全
4svc レジストリの必要性v4.0 で循環はさらに減る。最終的に svc が不要になる可能性あり(将来の BASELINE-7 で検討)
5Changes ビューの差分アルゴリズム現行 renderSimpleDiff を継続
6snippet 配列の分離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

再生成:

Terminal window
cd public/tools/text-chunker
node scripts/bundle.mjs
node scripts/verify.mjs

9. 着手時の注意

  • 必ず 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/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" にする)
  • 最終行に // @end を書く(欠けていても動くが、途中切れの検出精度が上がる)。
  • フェンス情報は 言語 のみ、または 言語 title="相対パス" のいずれか。

2. 途中で切れる場合(分割送信)

1 回の応答に収まらないときは、必ずパート宣言を入れる。

js/60-model.js
## `js/60-model.js`
~~~js
// @part: 1/3
...前半...
~~~

次の応答の冒頭は、説明より先に続きのブロックを置く。

js/60-model.js
~~~js
// @part: 2/3
...続き...
~~~
  • パートは 行の途中で切らない。必ず行末で区切る。
  • 最後のパートには // @part: 3/3 と // @end を書く。
  • 同じファイルを作り直す場合は分割ではなく 全文を 1 ブロックで再送し、 見出しに (差し替え・全文) と明記する。

3. 禁止事項

  • 応答全体を 1 つの大きなコードブロックで包まない(フェンスの入れ子禁止)。
  • 1 つのコードブロックに複数ファイルを入れない。
  • ファイル内容のコードブロックに、説明文・省略記号・...(中略)...・ 差分(diff)を混ぜない。常に完全な全文を出す。
  • ファイル本文のコードブロック内に、さらにフェンス(バッククォート 3 個)を 書かない。どうしても必要なら外側フェンスをバッククォート 4 個以上にする。
  • 見出しやフェンス情報のパスと、// @file: のパスを食い違わせない。
  • 変更点の説明・表・チェックリストは、コードブロックの 外に書く。

4. 推奨(任意)

  • 応答の先頭に、その応答で出すファイルの一覧を箇条書きで書く。
  • パスは常にプロジェクトルート相対(./ や絶対パス、.. は使わない)。