logstable

Text Chunker 引き継ぎ — v4.2-final → v4.3-final

v4.2-final から 7-L2 / 7-M / 7-N / 7-P / 7-P-fix / 7-Q を経た最終状態。単一配列モデル、pinChunk 統合、trim 変更、emoji swap、commit→snapshot rename + schemaVersion 3 migration を反映。

Text Chunker 引き継ぎ — v4.2-final → v4.3-final

0. 一行サマリ

v4.2-final に 7 バッチ(7-L2 / 7-M / 7-N / 7-P / 7-P-fix / 7-Q / 7-Q2)を追加適用。 単一配列モデル(app.autos 廃止)、pinChunk 統合、末尾改行 trim 変更、emoji swap、commit* → snapshot* 識別子 rename(schemaVersion 3 migration 付き)を達成。bundle / verify / audit 全て通過。

1. 到達点

1.1 検証済み状態

項目状態
bundle.mjs✓ bundled 5 css + 18 js
verify.mjs✓ All files match (23 files)
audit-imports.mjs✓ Total remaining issues: 0
循環依存✓ 0 件
app.autos✓ 完全撤去
内部識別子 commit*✓ snapshot* へ rename 済み
schemaVersion✓ 3

1.2 ファイル構成(v4.3-final)

public/tools/text-chunker/
├── index.html
├── manifest.json
├── package.json
├── scripts/html-build/ ← ツール
│ ├── _shared.mjs
│ ├── bundle.mjs
│ ├── split.mjs
│ ├── verify.mjs
│ ├── audit-imports.mjs
│ ├── rename-identifiers.mjs ← 7-Q 用(適用済)
│ └── rename-maps/
│ └── commit-to-snapshot.json
├── styles/ (5 css)
├── js/ (18 js)
└── bundle/index.html

2. バッチサマリ(v4.2-final 以降)

Batch 7-L2: Row 2/3 レイアウト再構成 + Merge メニュー

変更ファイル:

  • index.html — Row 2(chunkStatus / pin / ✓ / ⋮)、Row 3(◀▶⇣ / 📋 / [Text|Diff] / 🔍)
  • js/130-tree.js — Merge with next chunk / Merge with next master text… 追加
  • js/140-workflow.js — pin ボタン状態更新
  • js/170-wireui.js — pin-toggle / jump-chunk-end ACTION
  • styles/20-components.css / styles/40-theme-light.css — .pinBtn スタイル

Batch 7-M: 長さ表示一貫性 + ゼロ長可視化

変更ファイル:

  • js/70-compose.js — contentTextOf / composeOutput の trim を \n+$ → \n$
  • js/90-editor.js — ChunkLabelMarker に arr 常時渡し(同一行 chunk 番号クリックを常時有効)
  • js/130-tree.js — badge 計算を contentTextOf ベースに
  • js/140-workflow.js — updateEditorTop に診断 tooltip
  • styles/20-components.css — .badge.unpinned / .pinBtn 色統一
  • styles/30-editor.css — .cm-zero-len-marker min-height
  • styles/40-theme-light.css — ライト版

Batch 7-N: pinChunk 統合

  • pinChunk(c, opts) に opts.silent 追加
  • openNotesDialog から svc.pinChunk(c, { silent: true }) で呼ぶ
  • pinChunkLocal 削除

変更ファイル:

  • js/120-crud.js — pinChunk(c, opts)
  • js/140-workflow.js — pinChunkLocal 削除
  • js/180-boot.js — svc.pinChunk populate

Batch 7-P: 単一配列モデル

設計:

  • app.chunks に persisted(id != null)と ephemeral(id == null)を混在
  • app.autos 削除
  • 新規 helper: isPersisted(c) / isEphemeral(c) / persistedChunks() / ephemeralChunks()
  • recomputeAutoChunks(mode) 全面書き換え

変更ファイル(7 ファイル):

  • js/60-model.js
  • js/80-split.js
  • js/90-editor.js
  • js/120-crud.js
  • js/130-tree.js
  • js/140-workflow.js
  • js/160-dialogs.js

Batch 7-P-fix: pin / unpinned emoji swap

変更ファイル:

  • js/140-workflow.js — updateEditorTop の pin ボタン emoji(3 箇所)
    • pinned → 📍
    • unpinned → 📌

Batch 7-Q: commit* → snapshot* rename(スクリプト)

作成したツール:

  • scripts/html-build/rename-identifiers.mjs — 汎用 rename ツール(_shared.mjs 統合、--project / --map / --dry / --apply / --show 対応)
  • scripts/html-build/rename-maps/commit-to-snapshot.json — 11 ペアのマップ

適用した rename(11 識別子):

旧新
commitVersionsnapshotVersion
commitTextsnapshotText
commitAtsnapshotAt
commitAutoPinsnapshotAutoPin
commitChunksnapshotChunk
commitOnlysnapshotOnly
copyAndCommitcopyAndSnapshot
copyAndCommitChunkcopyAndSnapshotChunk
undoLastCommitundoLastSnapshot
commitBtn(DOM id)snapshotBtn
commit-only(data-act)snapshot-only

変更ファイル: 10 ファイル(js 8 / css 1 / html 1)

Batch 7-Q2: schemaVersion 3 への移行(手作業)

変更ファイル 3 つ:

  1. js/60-model.js:

    • defaultSettings().schemaVersion: 2 → 3
    • migrateChunk に v2 → v3 フィールド移行追加(// rename:skip で囲む)
  2. js/110-ui.js:

    • loadSettings に v2 → v3 settings migration 追加(// rename:skip で囲む)
  3. js/160-dialogs.js:

    • exportJSON の schemaVersion: 2 → 3
    • importJSONWithMode の許容バージョン [1, 2] → [1, 2, 3]

migration の冪等性: rename:skip マーカーで保護されているため、rename-identifiers.mjs を再実行しても migration コードは破壊されない。

3. 主要な設計判断

3.1 単一配列モデル(7-P)

根拠:

  • app.chunks / app.autos の同期漏れバグが頻発
  • chunkKey が文脈依存
  • 新操作追加時に両配列を意識する負担

トレードオフ: 配列内で id == null 判定が必要、Store 境界で明示的 filter。

3.2 pinChunk 統合(7-N)

opts.silent で挙動切替。svc 経由で openNotesDialog から呼ぶ。

3.3 trim を \n+$ → \n$(7-M)

段落末尾の空行(\n\n)を保持。EOF の \n 1 つだけを separator として扱う。

3.4 emoji swap(7-P-fix)

  • 📍 = location marker(置いてある)→ pinned
  • 📌 = pushpin(刺さっている)→ unpinned

3.5 commit* → snapshot* rename(7-Q)

設計判断:

  • 識別子 rename は機械的スクリプトで実施(rename-identifiers.mjs)
  • 永続化 migration は手作業(migrateChunk / loadSettings)
  • migration コードは // rename:skip-begin ~ // rename:skip-end で保護
  • スキーマバージョンを 2 → 3 に更新
  • 既存 v2 データは on-read 変換(非破壊)

冪等性:

  • rename script は 2 回実行しても no-op
  • migration は schemaVersion < 3 判定で 1 回のみ実行
  • 旧フィールドは変換後 delete され、次回以降は新フィールドのみ

4. ファイル適用マトリクス

v4.2-final + 7-L2 + 7-M + 7-N + 7-P + 7-P-fix + 7-Q + 7-Q2 を全て適用した状態 = v4.3-final:

#ファイル最終バッチ変更概要
1index.html7-L2 + 7-QRow 2/3 再構成、snapshotBtn
2js/00-main.jsv4.2変更なし
3js/10-utils.jsv4.2変更なし
4js/20-count.jsv4.2変更なし
5js/30-safe-pos.jsv4.2変更なし
6js/40-candidates.jsv4.2変更なし
7js/50-storage.jsv4.2変更なし
8js/60-model.js7-P + 7-Q + 7-Q2単一配列、snapshot*、schemaVersion 3
9js/70-compose.js7-M + 7-Qtrim \n$、snapshotText
10js/80-split.js7-P + 7-QrecomputeAutoChunks 書換、snapshot*
11js/90-editor.js7-P + 7-Q単一配列参照、snapshot*
12js/110-ui.js7-Q + 7-Q2settings migration v2→v3、snapshotAutoPin
13js/120-crud.js7-P + 7-Q全操作を単一配列に、snapshot*
14js/130-tree.js7-P + 7-Qapp.autos マージ削除、snapshot*
15js/140-workflow.js7-P-fix + 7-Qemoji swap、snapshot*
16js/150-checkpoint.jsv4.2 + 7-Q変更なし(commit* 未使用)+ rename
17js/160-dialogs.js7-P + 7-Q + 7-Q2breakdown 単一配列、schemaVersion 3
18js/170-wireui.js7-L2 + 7-Qpin-toggle / jump-chunk-end、snapshot-only
19js/180-boot.js7-N + 7-Qsvc.pinChunk populate、snapshot*
20styles/00-base.cssv4.2変更なし
21styles/10-layout.cssv4.2変更なし
22styles/20-components.css7-M + 7-Q.badge.unpinned / .pinBtn、#snapshotBtn
23styles/30-editor.css7-Mzero-len min-height
24styles/40-theme-light.css7-M + 7-Qライト版、#snapshotBtn

5. 検証手順

Terminal window
node scripts/html-build/bundle.mjs --project text-chunker
node scripts/html-build/verify.mjs --project text-chunker
node scripts/html-build/audit-imports.mjs --project text-chunker

期待結果:

  • ✓ bundled 5 css + 18 js
  • ✓ All files match (23 files)
  • Total remaining issues: 0

migration 検証:

テスト期待
旧 v2 データ(commitVersion)で起動正常動作、内部で snapshotVersion に変換
新 v3 データ(snapshotVersion)で起動無変換で動作
旧データを新コードで保存 → 再読込snapshotVersion で永続化
v2 JSON を importmapImportedChunk 経由で成功
v3 JSON を exportschemaVersion: 3 で出力
v3 JSON を再 importそのまま読める

6. 既知の制約

#内容影響
1chunkKey の unpinned@<offset> 位置依存稀に誤選択
2mergeWithNextDocument の seq 再採番がセッション依存single-tab lock 下では実害なし
3#diffView 高さ 40% 固定実機調整の余地
4app.ui.historyExpanded デッドステートv4.4 で削除予定
5#detailPanel 関連 CSS 残存v4.4 で削除予定

7. 次のバッチ(推奨順)

名前内容優先度
8-Aapp.ui.historyExpanded / #detailPanel 削除中
8-BchunkKey の ephemeral キー再設計中
8-C#diffView 高さ可変化低
8-D自動テストフレームワーク導入(node --test)中
8-Esvc レジストリの必要性見直し低

8. 参照

  • v4.3-final 仕様書: 2026-09-30-text-chunker-spec-v4.3-final
  • v4.2-final 仕様書: 2026-09-29-text-chunker-spec-v4.2-final
  • v4.2-final 引き継ぎ: 2026-09-29-text-chunker-handover-v4.2-final
  • directive: 260929_directive