EpisodicRAG v5.10.0: source_files 追加を CLI 化し、JSON 書き出しを LF に固定する

/digest Pattern 1 Step 3 は SGD を Edit ツールで手編集していた。同じ文書の Step 7 が
「直接 Edit は事故りやすい」と言う矛盾があり、実運用（2026-09-08 /mydigest）でも
手元の書き出しが CRLF を混入させた。既存の ShadowGrandDigestManager.add_files_to_shadow
に委譲する薄い CLI（add_shadow_sources）を足し、手編集経路を閉じる。

save_json は Path.open("w") に newline="\n" が無く、Windows では全 JSON 出力が CRLF に
なっていた（記憶リポの .gitattributes eol=lf が commit 時に吸収していたため履歴は無傷）。
newline="\n" を明示し、Linux CI でも回帰を捕まえるよう Path.open の引数を検査する
テストを併設する。

TDD: red（ImportError / CRLF 検出）→ green。ruff 0 / mypy Success 302 files /
pytest 2381 passed（not slow and not performance）。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Author: web-flow

.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "EpisodicRAG",
       "source": "./EpisodicRAG",
       "description": "Hierarchical Episodic Memory Generator (8-layer, 100-year span)",
-      "version": "5.9.0",
+      "version": "5.10.0",
       "author": {
         "name": "Weave @ EpisodicRAG"
       },

EpisodicRAG/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "EpisodicRAG",
-  "version": "5.9.0",
+  "version": "5.10.0",
   "description": "Hierarchical Episodic Memory Generator (8-layer, 100-year span)",
   "author": {
     "name": "Weave @ EpisodicRAG"

EpisodicRAG/CHANGELOG.en.md

@@ -1,4 +1,4 @@
-<!-- Last synced: 2026-07-02 -->
+<!-- Last synced: 2026-09-08 -->
 English | [日本語](CHANGELOG.md)
 
 # Changelog
@@ -12,14 +12,56 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Table of Contents
 
-- [v5.x](#590---2026-08-26)
+- [v5.x](#5100---2026-09-08)
 - [v4.x](#410---2025-12-03)
 - [v3.x](#330---2025-11-29)
 - [Archive (v2.x and earlier)](#archive-v2x-and-earlier)
 - [Versioning Rules](#versioning-rules)
 
 ---
 
+## [5.10.0] - 2026-09-08
+
+Moves `/digest` Pattern 1 Step 3 (appending to `source_files`) from hand-editing to a script, and pins JSON output line endings to LF.
+
+### Added
+
+- **`interfaces/add_shadow_sources.py` (`ShadowSourceAdder`)** — CLI that appends file names to the SGD
+  `source_files`: `python -m interfaces.add_shadow_sources <level> <filename>...`. Already-registered
+  names are skipped (idempotent) and duplicates within one call are added once. When the level
+  already holds an analysis, the four fields (digest_type / keywords / abstract / impression) are
+  left alone; in the PLACEHOLDER state (right after a finalize) they are refreshed to placeholder
+  text sized by the file count — the same `FileAppender` behavior as `update_shadow_for_new_loops`,
+  and Step 7 overwrites them anyway. The append itself delegates to the existing
+  `ShadowGrandDigestManager.add_files_to_shadow`; the CLI is a thin wrapper. Empty names and names
+  containing a path separator raise `EpisodicRAGError`
+- `commands/digest.md` Pattern 1 Step 3 now calls this CLI instead of the Edit tool. The same document
+  warned in Step 7 that direct edits of the SGD are error-prone while Step 3 still prescribed one;
+  that contradiction is gone
+
+### Fixed
+
+- **`save_json` now writes LF only** — `Path.open("w")` lacked `newline="\n"`, so Windows text mode
+  turned every `\n` into `\r\n`. ShadowGrandDigest, Provisional and last_digest_times were all written
+  as CRLF, and the memory repository warned `CRLF will be replaced by LF` on every touch (history was
+  intact because `.gitattributes` `eol=lf` normalizes at commit; only the working copy was CRLF).
+  Two regression tests: no `\r\n` in the output bytes (red only on Windows) and `Path.open` being
+  called with `newline="\n"` (catches regressions on Linux CI too)
+- **`index_writer.apply_index` and `tools/check_footer.fix_footer` pinned to LF the same way** — the
+  former rewrites auto-memory's MEMORY.md (untracked by git, so nothing normalizes it and CRLF would
+  stick), the latter is the footer fixer behind `/doc-check`. Each got the same pair of regression
+  tests as `save_json` (`apply_index` previously had none)
+
+### Notes
+
+- The installed (Daily Use) copy keeps the old code until the plugin is updated; `/digest` Step 3
+  switches to the CLI path after that
+
+### Verification
+
+ruff 0 / ruff format 302 files already formatted / mypy Success (302 files, the same invocation CI uses) /
+pytest 2386 passed, 2 skipped (`-m "not slow and not performance"`)
+
 ## [5.9.0] - 2026-08-26
 
 Static checking aligned with the workspace baseline. No behavior change.

EpisodicRAG/CHANGELOG.md

@@ -11,14 +11,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## 目次 / Table of Contents
 
-- [v5.x](#590---2026-08-26)
+- [v5.x](#5100---2026-09-08)
 - [v4.x](#410---2025-12-03)
 - [v3.x](#330---2025-11-29)
 - [Archive (v2.x以前)](#archive-v2x-and-earlier)
 - [バージョニング規則](#バージョニング規則)
 
 ---
 
+## [5.10.0] - 2026-09-08
+
+`/digest` Pattern 1 Step 3（source_files 追加）を手編集からスクリプトへ寄せ、JSON 書き出しの改行を LF に固定する。
+
+### Added
+
+- **`interfaces/add_shadow_sources.py`（`ShadowSourceAdder`）** — SGD の `source_files` へファイル名を追加する CLI。
+  `python -m interfaces.add_shadow_sources <level> <filename>...`。既登録は skip（冪等）、
+  呼び出し内の重複は 1 回だけ。既存分析がある場合は 4 要素（digest_type / keywords / abstract /
+  impression）に触れず、PLACEHOLDER 状態（finalize 直後）では件数に応じたプレースホルダー文へ更新する
+  （`update_shadow_for_new_loops` と同じ `FileAppender` の挙動。Step 7 が上書きする前提）。追加処理は既存の
+  `ShadowGrandDigestManager.add_files_to_shadow` へ委譲し、CLI は薄いラッパー。
+  空文字・パス区切りを含む名前は `EpisodicRAGError`
+- `commands/digest.md` Pattern 1 Step 3 を Edit ツールの手編集から上記 CLI へ置換。同じ文書の Step 7 が
+  「SGD の直接 Edit は事故りやすい」と言いながら Step 3 だけ手編集を指示していた矛盾を解消
+
+### Fixed
+
+- **`save_json` の改行を LF に固定** — `Path.open("w")` に `newline="\n"` が無く、Windows の text mode
+  既定で `\n` が `\r\n` に変換されていた。ShadowGrandDigest / Provisional / last_digest_times の
+  書き出しが全て CRLF になり、記憶リポ側で毎回 `CRLF will be replaced by LF` の警告が出ていた
+  （`.gitattributes` の `eol=lf` が commit 時に正規化するため履歴は無傷、working copy だけが CRLF）。
+  回帰テストは二本：出力バイトに `\r\n` が無いこと（Windows でのみ red になる）と、
+  `Path.open` が `newline="\n"` で呼ばれること（Linux CI でも回帰を捕まえる網）
+- **`index_writer.apply_index` と `tools/check_footer.fix_footer` の `write_text` も同型で LF に固定** —
+  前者は auto-memory の MEMORY.md 書き戻し（git 非追跡ゆえ正規化されず CRLF のまま残る）、後者は
+  `/doc-check` 系の footer 修正。`save_json` と同じ二本立ての回帰テストを各々に付けた
+  （`apply_index` は従来テスト無し）
+
+### Notes
+
+- インストール済み（Daily Use）側はプラグイン更新までは旧コードのまま。`/digest` の Step 3 は
+  更新後に CLI 経路へ切り替わる
+
+### 検証
+
+ruff 0 ／ ruff format 302 files already formatted ／ mypy Success（302 files、CI と同じ起動形）／
+pytest 2386 passed, 2 skipped（`-m "not slow and not performance"`）
+
 ## [5.9.0] - 2026-08-26
 
 静的チェックをワークスペース基準へ揃える。挙動の変更は無い。

EpisodicRAG/commands/digest.md

@@ -117,7 +117,7 @@ TodoWrite items for Pattern 1:
 |------|---------|-------------------|
 | 1 | パス情報・新規Loop確認 | `python -m interfaces.digest_entry` |
 | 2 | SGD読み込み | `essences_path`のShadowGrandDigest.txtを読み込む |
-| 3 | source_files追加 | SGDの`weekly.overall_digest.source_files`に新規Loopファイル名を追加 |
+| 3 | source_files追加 | `python -m interfaces.add_shadow_sources weekly <ファイル名...>` |
 | 4 | DigestAnalyzer起動 | Step 3のLoopファイル別に`Task(DigestAnalyzer)`を並列起動 |
 | 5 | 分析結果受信 | 各DigestAnalyzerからlong/short分析結果を受け取る |
 | 6 | Provisional保存 | 分析結果を一時ファイル経由でProvisionalにアペンド（`save_provisional_digest`） |
@@ -157,28 +157,24 @@ python -m interfaces.digest_entry --output json
 
 **確認ポイント**:
 - `weekly.overall_digest.source_files`の現在のリスト
-- 次のStepで追加するファイル名の重複がないこと
+- 次のStepで追加するファイル名の重複がないこと（既登録は Step 3 の CLI が skip するため、ここは目視確認のみ）
 
 ---
 
 #### Step 3: source_files追加
 
-**対象ファイル**: `{essences_path}/ShadowGrandDigest.txt`
+**実行ディレクトリ**: `{plugin_root}/scripts`
 
-**操作**: Editツールで`weekly.overall_digest.source_files`配列に新規Loopファイル名を追加
+**コマンド**:
+```bash
+python -m interfaces.add_shadow_sources weekly "L00260_タイトル.txt" ["L00261_タイトル.txt" ...]
+```
 
-**追加形式**: `"L00260_タイトル.txt"` （フルファイル名）
+**追加形式**: フルファイル名（`{loops_path}` からの相対パスやディレクトリを付けない）。Step 1 出力の `new_loops` は番号＋タイトル（拡張子なし）なので `.txt` を補う
 
-**フォーマット規約**: 配列要素は1行ずつ記述する（インライン形式 `["a.txt", "b.txt"]` は避ける）
+**動作**: 既登録のファイル名は skip（冪等）。既存分析がある場合は `digest_type` / `keywords` / `abstract` / `impression` に触れない。PLACEHOLDER 状態（finalize 直後）では件数に応じたプレースホルダー文へ更新される（Step 7 が上書きするので問題ない）。改行は LF で書き出される
 
-**例**:
-```json
-"source_files": [
-  "L00258_既存.txt",
-  "L00259_既存.txt",
-  "L00260_新規追加.txt"
-]
-```
+**注意**: SGDの直接Edit（exact-match置換）は長文日本語で事故りやすく、手元の書き出しは改行コードも壊しうるため使用しないこと（Step 7 と同じ理由）
 
 ---
 

EpisodicRAG/docs/dev/api/interfaces.md

@@ -40,8 +40,9 @@ from interfaces import (
 8. [CLI共通ヘルパー](#cli共通ヘルパーinterfacescli_helperspy) *(v4.1.0+)*
 9. [UpdateDigestTimes CLI](#updatedigesttimes-cliupdate_digest_timespy) *(v5.0.0+)*
 10. [OverallDigestUpdater（update_shadow_overall.py）](#overalldigestupdaterupdate_shadow_overallpy)
-11. [ShadowStateChecker（内部CLI）](#shadowstatechecker内部cli)
-12. [DigestReadinessChecker（digest_readiness.py）](#digestreadinesscheckerdigest_readinesspy) *(v5.1.0+)*
+11. [ShadowSourceAdder（add_shadow_sources.py）](#shadowsourceadderadd_shadow_sourcespy) *(v5.10.0+)*
+12. [ShadowStateChecker（内部CLI）](#shadowstatechecker内部cli)
+13. [DigestReadinessChecker（digest_readiness.py）](#digestreadinesscheckerdigest_readinesspy) *(v5.1.0+)*
 
 ---
 
@@ -572,6 +573,40 @@ cat payload.json | python -m interfaces.update_shadow_overall monthly --stdin
 
 ---
 
+## ShadowSourceAdder（add_shadow_sources.py）
+
+ShadowGrandDigest の `source_files` にファイル名を追加。既登録は skip（冪等）。
+既存分析がある場合は digest_type / keywords / abstract / impression に触れない。
+PLACEHOLDER 状態（finalize 直後）では件数に応じたプレースホルダー文へ更新する
+（`update_shadow_for_new_loops` と同じ `FileAppender` の挙動）。
+
+> **背景**: `/digest` Pattern 1 Step 3 は SGD の source_files を Edit ツールで直接編集していた。
+> 長文日本語 JSON の手編集は事故りやすく、手元の書き出しは改行コードも壊しうる。
+> 追加処理は `ShadowGrandDigestManager.add_files_to_shadow` に委譲し、CLI は薄いラッパーに留める。
+
+```python
+class ShadowSourceAdder:
+    def __init__(self, config: Optional[DigestConfig] = None): ...
+    def add_sources(self, level: str, filenames: List[str]) -> List[str]: ...
+```
+
+| メソッド | 説明 |
+|---------|------|
+| `add_sources(level, filenames) -> List[str]` | ファイル名を検証して追加・保存し、実際に追加された名前を指定順で返す。呼び出し内の重複は 1 回だけ追加 |
+
+**使用例（CLI）**:
+
+```bash
+cd scripts
+python -m interfaces.add_shadow_sources weekly "L00592_講義は顧客の仕様書.txt"
+python -m interfaces.add_shadow_sources weekly L00592_a.txt L00593_b.txt
+```
+
+**バリデーション**: 空文字・パス区切りを含む名前は `EpisodicRAGError`（CLI では exit 1）。
+ファイルの実在は検証しない。エラー時 SGD は変更されない。
+
+---
+
 ## ShadowStateChecker（内部CLI）
 
 Shadow状態判定CLI。`__all__`にエクスポートされていない内部CLI。直接インポートせず、CLIとして使用。

EpisodicRAG/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "episodicrag"
-version = "5.9.0"
+version = "5.10.0"
 description = "EpisodicRAG - Hierarchical digest generation for long-term memory"
 requires-python = ">=3.10"
 license = {text = "MIT"}

EpisodicRAG/scripts/README.md

@@ -145,6 +145,8 @@ from domain.validators import validate_type, is_valid_dict, is_valid_list
 | `digest_entry.py` | - | Digestエントリーポイント |
 | `digest_readiness.py` | - | Digest準備状態チェック |
 | `update_digest_times.py` | - | Digestタイムスタンプ更新 |
+| `update_shadow_overall.py` | `OverallDigestUpdater` | SGD overall_digest 4要素の更新（source_files 不変） |
+| `add_shadow_sources.py` | `ShadowSourceAdder` | SGD source_files へのファイル名追加（冪等。既存分析は保持、PLACEHOLDER は件数で更新）*(v5.10.0+)* |
 | `provisional/` | - | Provisionalマージ処理（`file_manager`, `input_loader`, `merger`, `validator`） |
 
 ```python

EpisodicRAG/scripts/infrastructure/auto_dream/index_writer.py

@@ -98,5 +98,6 @@ def apply_index(memory_dir: Path, text: str) -> Path:
         書き込んだ MEMORY.md のパス
     """
     index_path = memory_dir / _INDEX_FILENAME
-    index_path.write_text(text, encoding="utf-8")
+    # newline="\n": Windows の text mode 既定は \n→\r\n 変換。MEMORY.md は LF 正典
+    index_path.write_text(text, encoding="utf-8", newline="\n")
     return index_path

EpisodicRAG/scripts/infrastructure/json_repository/operations.py

@@ -123,7 +123,8 @@ def save_json(file_path: Path, data: dict[str, Any], indent: int = 2) -> None:
     formatter = get_error_formatter()
     try:
         file_path.parent.mkdir(parents=True, exist_ok=True)
-        with file_path.open("w", encoding="utf-8") as f:
+        # newline="\n": Windows の text mode 既定は \n→\r\n 変換。記憶リポは LF 正典
+        with file_path.open("w", encoding="utf-8", newline="\n") as f:
             json.dump(data, f, ensure_ascii=False, indent=indent)
     except OSError as e:
         raise FileIOError(formatter.file.file_io_error("write", file_path, e)) from e