@sayue_ltr/fleq 1.50.1 → 2.0.0

package/CHANGELOG.md

@@ -2,6 +2,180 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [2.0.0](https://github.com/Lateo2580/FlEq/compare/v1.51.0...v2.0.0) (2026-04-25)
+
+
+### ⚠ BREAKING CHANGES
+
+* **policy:** --event-log / --event-log-raw / --no-event-log の
+CLI オプションが廃止された。eventLog / eventLogRaw 設定キーも廃止。
+これらの機能に依存している外部利用者は、削除前バージョン (v1.52.x)
+を pin するか、自身で private fork を保持して継続利用すること。
+
+次回リリースは major bump (v2.0.0) として npm run release:major で
+発行する想定。
+
+関連: 段階1 (baf0b41)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+
+### 機能追加
+
+* **cli:** add --event-log and --event-log-raw flags ([f046653](https://github.com/Lateo2580/FlEq/commit/f046653df9c42d88f0362bdeb34dc87bcdf999f3))
+* **cli:** show eventLog status in startup banner ([07d509f](https://github.com/Lateo2580/FlEq/commit/07d509fda93cfc0e4f1d83b9208e5dc0e86e9270))
+* **cli:** 起動バナーに音声バックエンドの健康状態を表示 ([30a070e](https://github.com/Lateo2580/FlEq/commit/30a070e0fa97c8c034269c608a050500b058ce6d))
+* clock コマンド・ヘルプ・status 表示を uptime 対応に ([f362927](https://github.com/Lateo2580/FlEq/commit/f362927c84515770b609628c2ced7ba0cf19004f))
+* commands コマンド新設 — help から一覧表示を分離 ([0eb81c1](https://github.com/Lateo2580/FlEq/commit/0eb81c1fe335617e6346657a0d9bf1cacca0b387))
+* **config:** add eventLog and eventLogRaw configuration ([db1f376](https://github.com/Lateo2580/FlEq/commit/db1f376648e705c61d1439f85e75fdde17a74810))
+* EEW isWarning 判定を XML ベースに移行 (classification はフォールバック) ([c2087cd](https://github.com/Lateo2580/FlEq/commit/c2087cd931a31af603cadd4eff90a0a33bac833f))
+* Event File Writer — write telegrams as individual JSON files ([0ebbd0c](https://github.com/Lateo2580/FlEq/commit/0ebbd0cb21e33d03cb97f7c6a78f996941dbfcad))
+* formatUptime 関数を追加 (DDD:HH:MM:SS, dim ゼロ桁) ([a694522](https://github.com/Lateo2580/FlEq/commit/a6945227cc1c3c1d16728356075aae4e9765301b))
+* implement EventFileWriter with atomic write ([e05e9cb](https://github.com/Lateo2580/FlEq/commit/e05e9cb66cd61e9af049b2c6e8d2beed7c1f50e8))
+* **monitor:** apply eventLog config to EventFileWriter on startup ([12c251b](https://github.com/Lateo2580/FlEq/commit/12c251b1c298d4f8f0446ec93576d8904bed091b))
+* ParsedEarthquakeInfo に eventId を追加し、地震情報表示に EventID 行を表示 ([7562377](https://github.com/Lateo2580/FlEq/commit/756237726821e2c48ceed4a58ba2ce62ce3270b8))
+* **policy:** dmdata.jp 再配信ポリシー対応の段階1実装 ([baf0b41](https://github.com/Lateo2580/FlEq/commit/baf0b4135878ab6400554bc7c790ddd4c8be6cdc))
+* processEew に suppressed kind を追加 (VXSE45 優先時) ([e65b33e](https://github.com/Lateo2580/FlEq/commit/e65b33e6d7ab7480bd13359a7da21661b78a40a7))
+* PromptClock 型に uptime を追加 ([d7c2829](https://github.com/Lateo2580/FlEq/commit/d7c2829487b78ebf993c4188ec1054d74b8ad071))
+* **repl:** add eventlog command ([874a679](https://github.com/Lateo2580/FlEq/commit/874a679eb4b12d8bba330a205d11a117ab8de2e9))
+* **sound:** checkSoundBackend で実再生プローブによる健康チェックを追加 ([46c391c](https://github.com/Lateo2580/FlEq/commit/46c391cb3222e5200594e27040f2f9214aace123))
+* **sound:** process.uptime ベースの単調時計ヘルパーを追加 ([6cfc195](https://github.com/Lateo2580/FlEq/commit/6cfc195bf2540f0c6586ad22be8159824fdde49f))
+* **sound:** 起動直後 60 秒以内の再生失敗を 20 秒後に自動リトライ ([9b86ff9](https://github.com/Lateo2580/FlEq/commit/9b86ff96111bc18066e0f4aaba7f0f513fd07b1e))
+* **sound:** 再生失敗系ログを debug から warn に格上げ ([fd9f1d5](https://github.com/Lateo2580/FlEq/commit/fd9f1d5dc07ba234bbdb9cb0cb76bd9015662673))
+* StatusLine で uptime モード表示に対応 (未接続時も表示) ([55c93c7](https://github.com/Lateo2580/FlEq/commit/55c93c7733d5e31fccd5f47944e37736aaa5ec41))
+* wire EventFileWriter into message-router and VolcanoRouteHandler ([a1107e0](https://github.com/Lateo2580/FlEq/commit/a1107e00db7adbfdd81c3e377143001c7542e8ce))
+* wrap-up コマンド新設 + Codex CLI フラグ更新 + commit リマインド hook 追加 ([68dac86](https://github.com/Lateo2580/FlEq/commit/68dac861fc17e95ce1fb6ac9cb0c43bc5bc62592))
+* 警報昇格通知をイベント単位の isUpgradeToWarning に変更 ([2e338dd](https://github.com/Lateo2580/FlEq/commit/2e338dd797f4c814da8209505f2d1e2a822e951b))
+* 待機中Tipsに火山カテゴリを追加 (+78項目) ([0f619bb](https://github.com/Lateo2580/FlEq/commit/0f619bb87eb663f611ea461d2002040a0fedafe6))
+* 待機中Tipsに気象カテゴリを追加 (警報・予報・定時報) ([deda85e](https://github.com/Lateo2580/FlEq/commit/deda85e46f1b154248a919ac623c3e81ea5d1048))
+* 待機中Tipsを大幅拡充 — 新8カテゴリ+229件追加 (444→673件) ([bac458a](https://github.com/Lateo2580/FlEq/commit/bac458a556ddaa807f558fcf57cc0199b10c2a40))
+* 統計表示にテーマロールベースのカラーリングを追加 ([d816b17](https://github.com/Lateo2580/FlEq/commit/d816b1766f3b25c2cbd199ee54248df995ef3121))
+
+
+### バグ修正
+
+* **cli:** let --no-event-log override --event-log-raw ([fe5226e](https://github.com/Lateo2580/FlEq/commit/fe5226e13ccf7d3c8357c925cdff5466755a340f))
+* **eew:** isWarning 観測ログを真の仕様不整合のみに絞る ([be1757c](https://github.com/Lateo2580/FlEq/commit/be1757cabf7ae22b7c8045e316477ad338fac049))
+* **event-file-writer:** prevent collision and enforce maxFiles strictly ([a7227d6](https://github.com/Lateo2580/FlEq/commit/a7227d6f6b619fcd5a5ddfbf972aa143a5c5ff63))
+* formatUptime の日部分を文字レベルで dim 表示する ([67d5c70](https://github.com/Lateo2580/FlEq/commit/67d5c700a35d48b97de2c7534392ef33109af59c))
+* **monitor:** drain EventFileWriter queue on shutdown ([6cd0fc2](https://github.com/Lateo2580/FlEq/commit/6cd0fc2836e51c43218202ea51257a18cdb8056b))
+* processMessage の EEW suppressed 結果ハンドリングを追加 ([3b5f48f](https://github.com/Lateo2580/FlEq/commit/3b5f48f72e627ee0e68372e892959c623bab174b))
+* **sound:** Codex レビュー 2 の指摘を反映 ([3d3fdf1](https://github.com/Lateo2580/FlEq/commit/3d3fdf185a51c43d6519c7fb083a415ffa184249))
+* **sound:** DoneHandle 化で launch 経路の log/bell も二重完了ガードで保護 ([cc5fd1c](https://github.com/Lateo2580/FlEq/commit/cc5fd1c126a38c39585250dd15831f436b2a02b7))
+* **sound:** runPlay の timeout と execFile コールバックによる二重完了を防止 ([b0456dc](https://github.com/Lateo2580/FlEq/commit/b0456dc8f78ea1b7e6d6f62bcc8e4a007fb90aae))
+* VXSE61 の複数 Coordinate ノードから十進度を正しく抽出 ([bdcfb38](https://github.com/Lateo2580/FlEq/commit/bdcfb383f0d34694714fa81da38cee875529e424))
+* 起動メッセージをcommands案内に更新、+マーカーの位置と凡例を改善 ([f13fabd](https://github.com/Lateo2580/FlEq/commit/f13fabd7c688ef9da5b171787de51e5aa80d2c00))
+* 抑制報の hasWarningIssued 更新と終端処理を修正 (Codex レビュー指摘) ([34676ba](https://github.com/Lateo2580/FlEq/commit/34676ba8a5c0d434de387a13b7349740abaaeafb))
+
+
+### リファクタリング
+
+* codex-design スキルを対立的レビュー方式に刷新 ([6db5a6d](https://github.com/Lateo2580/FlEq/commit/6db5a6d6dd17ca8bcdf0192064458dc866f92752))
+* EewTracker を byType Map ベースに再設計 ([79a606f](https://github.com/Lateo2580/FlEq/commit/79a606fbcb80fe2b15ee5887529140ec9c311f56))
+* **policy:** dmdata.jp 再配信ポリシー対応の段階2 ([cf5c6fb](https://github.com/Lateo2580/FlEq/commit/cf5c6fbe047953ce256827e18ce5a62d74186096))
+
+
+### ドキュメント
+
+* EEW再設計に伴う仕様書同期 (5ファイル) ([a4f4b4a](https://github.com/Lateo2580/FlEq/commit/a4f4b4ad15f2c764599078884e50a427f678aa08))
+* uptime モードの Tip・仕様書を同期 ([6b77ae5](https://github.com/Lateo2580/FlEq/commit/6b77ae57298584e7978bdae40cc3c2b86e4ae084))
+* 待機中Tipsを現行機能に同期 (21件追加, 1件修正) ([078e070](https://github.com/Lateo2580/FlEq/commit/078e0708b76e2a89246dac67a2242cd3387558ea))
+
+## [1.51.0](https://github.com/Lateo2580/FlEq/compare/v1.50.1...v1.51.0) (2026-03-29)
+
+
+### 機能追加
+
+* **compact:** add width-adaptive summary line display (Phase 3) ([2a747ef](https://github.com/Lateo2580/FlEq/commit/2a747efc12379c72c458a2767e328a83096ed3b4))
+* **diff/focus:** add PresentationDiffStore and focus mode (Phase 4) ([00f7cb3](https://github.com/Lateo2580/FlEq/commit/00f7cb3d65558f92bd34b1bc6e0e73374fe0b5d2))
+* distribute waiting tips across categories with epoch-deck shuffler ([fd87c84](https://github.com/Lateo2580/FlEq/commit/fd87c84b99c0fb83dec47f3205f1d3a0c70213da))
+* **filter/template:** add --filter and --template with REPL support (Phase 2) ([7acad77](https://github.com/Lateo2580/FlEq/commit/7acad777e11cdb0955fba97a8c64d250db40d1d8))
+* **integration:** volcano pipeline + final fixes + documentation ([a2ffae1](https://github.com/Lateo2580/FlEq/commit/a2ffae139eb0893406a0128e04542c3ec0d7e205))
+* **minimap:** add 47-prefecture area-to-pref mapping ([1b0a58a](https://github.com/Lateo2580/FlEq/commit/1b0a58a8926097965dd19d1e559d73cd07fbe6e0))
+* **minimap:** add 47-prefecture grid layout ([eab5f1b](https://github.com/Lateo2580/FlEq/commit/eab5f1b4376bad7bb1b6a31661f3b18dada5f819))
+* **minimap:** add ASCII minimap with 12-block Japan layout (Phase 7) ([195f404](https://github.com/Lateo2580/FlEq/commit/195f404c3fd2b33a2e0aafa9396d45c035a2939b))
+* **minimap:** rewrite renderer for 47-prefecture grid layout ([70d0e95](https://github.com/Lateo2580/FlEq/commit/70d0e95d26cbccb476f73531f510a73ae334f368))
+* **night:** add night mode as theme overlay (Phase 6) ([b206b22](https://github.com/Lateo2580/FlEq/commit/b206b22000666bff18b6ed65aa29352e1bda6434))
+* **presentation:** add PresentationEvent common layer (Phase 1) ([7afdea5](https://github.com/Lateo2580/FlEq/commit/7afdea57960c192996fa10b83fd448a91f8ef87c))
+* **rest:** REST API に指数バックオフ付きリトライ機構を追加 ([3837964](https://github.com/Lateo2580/FlEq/commit/3837964545b064b7ad856d95e5bb3185dc77a586))
+* **site:** add CSS with light/dark theme and navbar/hero styles ([6213fd3](https://github.com/Lateo2580/FlEq/commit/6213fd3dcaa8314f854c31e421372d24b2113e1a))
+* **site:** add dark mode toggle, copy button, smooth scroll ([2fdde07](https://github.com/Lateo2580/FlEq/commit/2fdde0784805e70ca26b88fbfaa367d80bc42625))
+* **site:** add features section with responsive grid ([add41eb](https://github.com/Lateo2580/FlEq/commit/add41ebf6fa0db46e58a2aa40bb82eb8f0930c33))
+* **site:** add footer with links and attribution ([24e055f](https://github.com/Lateo2580/FlEq/commit/24e055faeaba03ed5c9fe92100a658586115b01a))
+* **site:** add HTML skeleton with navbar and hero section ([0de85af](https://github.com/Lateo2580/FlEq/commit/0de85afa569daf9aa9fa471e0f5bf2af9bf72fa5))
+* **site:** add install section with steps, prerequisites, and OS table ([4f2db43](https://github.com/Lateo2580/FlEq/commit/4f2db4327f4c0fdfd010eab1db699f066f7d4807))
+* **site:** add screenshot section with terminal mockup ([a65b381](https://github.com/Lateo2580/FlEq/commit/a65b381e8a4bb7f973a0a9af34c682cef89871f4))
+* **site:** add supported categories section ([af495e3](https://github.com/Lateo2580/FlEq/commit/af495e3df7010d9c8ea5321fa07b7e69163716f4))
+* **site:** finalize responsive breakpoints ([202adc2](https://github.com/Lateo2580/FlEq/commit/202adc230bc1c98c45d2c792dee0eefd7aac4eae))
+* **site:** overhaul output preview with tabbed terminal and update content ([94d5354](https://github.com/Lateo2580/FlEq/commit/94d5354bba04970886492a1a15defa68b79575a4))
+* **stats:** add telegram statistics display (Phase 0) ([9d29b82](https://github.com/Lateo2580/FlEq/commit/9d29b821014e8904bf4979c5da821898fd08a7fd))
+* **summary:** add periodic summary with sparkline (Phase 5) ([fc4879c](https://github.com/Lateo2580/FlEq/commit/fc4879c359f4ff8368a05e01490644451f2ae682))
+* **ui:** add renderGroupedItemList helper for compact area display ([06afba3](https://github.com/Lateo2580/FlEq/commit/06afba3fdb2a70fa3543c8197fab7520f2246144))
+
+
+### バグ修正
+
+* **config:** summaryInterval のバリデーションを追加し窓幅を統一 ([0fccdb8](https://github.com/Lateo2580/FlEq/commit/0fccdb838e3b2ea6b34d82adc8e0dc24b36dfdc9))
+* **diff-store:** previous Map に TTL/クリーンアップを追加しメモリ蓄積を防止 ([7b9434a](https://github.com/Lateo2580/FlEq/commit/7b9434a5c502413cd8913db5571586b7ac5edfdd))
+* **filter,template:** ReDoS 対策・実行時 try-catch・パーサ再帰深度制限を追加 ([05d9a6f](https://github.com/Lateo2580/FlEq/commit/05d9a6f545ab1df826c9a9b02aada05a32fbdd24))
+* info-handlers.ts に NotifyCategory の import を追加 ([5ab9df0](https://github.com/Lateo2580/FlEq/commit/5ab9df0d9d20e1aaae70aa8caf4d533420339f17))
+* **monitor:** シャットダウン時に要約タイマーを停止 ([24099b1](https://github.com/Lateo2580/FlEq/commit/24099b1ad024fe30204a016b2a499eb3a510b48e))
+* **router:** volcanoMsgCache に TTL を追加し残留エントリを防止 ([db4c683](https://github.com/Lateo2580/FlEq/commit/db4c683bdea28e468aedad28e3a88822da4305b4))
+* **site:** address code review findings ([28dda04](https://github.com/Lateo2580/FlEq/commit/28dda04158e898255591b2343a03bbb492c32e76))
+* **site:** fix CSS dark mode fallback for no-JS scenarios ([59e3ba1](https://github.com/Lateo2580/FlEq/commit/59e3ba1b8f69263449eed55ddade9b381d137cf8))
+* **sound:** Windows カスタム通知音が再生されないバグを修正 ([69486a8](https://github.com/Lateo2580/FlEq/commit/69486a8c4276080917ea95f2896ff3b9e8d837a8))
+* **telegram-stats:** eewEventIds/earthquakeMaxIntByEvent にサイズ上限を追加 ([7c6ff34](https://github.com/Lateo2580/FlEq/commit/7c6ff34fd7f9474bf8e912163819b6be4dd215a6))
+* **ui:** summary/minimap の PresentationEvent フィールド参照を修正 ([b85e8c1](https://github.com/Lateo2580/FlEq/commit/b85e8c1e0e0b8a9b25b2049fdd687cac70cf8b8e))
+* **ws:** 孤立ソケット防止のため doConnect に多層世代チェックを追加 ([f671708](https://github.com/Lateo2580/FlEq/commit/f67170815b0d712a78aac6d6225801dddf635162))
+* セキュリティ・互換性の修正8件 ([ad557be](https://github.com/Lateo2580/FlEq/commit/ad557bed33136e5adb9c5d8d6f0b3db94e784df9))
+
+
+### パフォーマンス改善
+
+* **filter:** 正規表現パターンをコンパイル時にキャッシュ ([545c725](https://github.com/Lateo2580/FlEq/commit/545c725ef3f13f07a2b70aaed512a1358e7fa438))
+* **notifier:** resolveIconPath の結果をキャッシュ ([6e104c9](https://github.com/Lateo2580/FlEq/commit/6e104c933c88b99a3a3a4321516f71d2a99c218f))
+* **sound:** 音声再生を有界キューで直列化しタイムアウトを追加 ([675748b](https://github.com/Lateo2580/FlEq/commit/675748ba5e3cc2eb2257c18a708840a59fa1e4ff))
+
+
+### リファクタリング
+
+* apply Claude Code best practices — rules, commands, hooks, slim CLAUDE.md ([9fda668](https://github.com/Lateo2580/FlEq/commit/9fda66837cd107797944e00cc329eabbe8b03ac7))
+* **eew:** use renderGroupedItemList for compact forecast area display ([eb6ef92](https://github.com/Lateo2580/FlEq/commit/eb6ef9234c1a9cc3a5ef6d9ca56770202288e52c))
+* FrameLevel を ui/formatter から types.ts に移動 ([beb7893](https://github.com/Lateo2580/FlEq/commit/beb789352cef9577382ec9402a024046e4d1babc))
+* **minimap:** remove old block-mapping, update exports for v2 ([b75392a](https://github.com/Lateo2580/FlEq/commit/b75392a39a6d5c2f728459a59e184350e814addb))
+* **minimap:** replace BlockId with PrefId (47 prefectures) ([118a3ad](https://github.com/Lateo2580/FlEq/commit/118a3ad952d96c3793625c9590f455c97f7af4dd))
+* **parser:** 6つのparse関数の共通前処理を extractBaseReport に集約 ([8eed90f](https://github.com/Lateo2580/FlEq/commit/8eed90fc946f85820d9ba35104f24897417ee1e8))
+* **repl:** repl.ts を大規模リファクタリング (2,500行→310行) ([abf8253](https://github.com/Lateo2580/FlEq/commit/abf825351ad2ad184ee03b3130b5d147536a6092))
+* **router:** 表示パイプラインを runDisplayPipeline に共通化 ([08b7a84](https://github.com/Lateo2580/FlEq/commit/08b7a84712f4b2834e7b8b3bf571a0b1fd4a2e4f))
+* **ui:** CJK文字幅判定の重複を isWideChar ヘルパーに統合 ([3ad362a](https://github.com/Lateo2580/FlEq/commit/3ad362a2544774593bd2007e2a16cfd765091c16))
+* **ui:** use renderGroupedItemList for compact long-period area display ([44577f6](https://github.com/Lateo2580/FlEq/commit/44577f6f7b13506ce742433f50273ceb03f0a491))
+* **volcano:** use renderSimpleNameList, remove municipality truncation ([6b9a8d6](https://github.com/Lateo2580/FlEq/commit/6b9a8d6b91d89885d3bd61b5420fba3201f8abf4))
+* **ws:** close/error ハンドラの重複処理を onDisconnect に統合 ([fc84374](https://github.com/Lateo2580/FlEq/commit/fc84374d90f0acf5d9a80423f7e522bc11694c0c))
+* アーキテクチャリファクタリング3件 (W8/W7/C2) ([724c2a0](https://github.com/Lateo2580/FlEq/commit/724c2a0b6f4a85cb570e66d4ea621a575eeb3085))
+* 未使用フィールドの削除 ([16e9e12](https://github.com/Lateo2580/FlEq/commit/16e9e1262444c6c42eb759e806af1838d2acbca9))
+
+
+### ドキュメント
+
+* add Claude Harness policy and hook configuration ([91f5b54](https://github.com/Lateo2580/FlEq/commit/91f5b54d4912d3a7a0172f7e9864137a62cd99fc))
+* add landing page design spec ([b1acb2b](https://github.com/Lateo2580/FlEq/commit/b1acb2b9ec0476b9621f17f4d64765609903a7a8))
+* add landing page implementation plan ([8afda8a](https://github.com/Lateo2580/FlEq/commit/8afda8af92ef6ba3ad712d65152b67f6895d65f4))
+* Codexレビューのフィードバックを設計・プランに反映 ([1f1c71b](https://github.com/Lateo2580/FlEq/commit/1f1c71baa56b2ea6d96cd3ee1eb03d81450e7f0c))
+* **engine:** engine.md の critical 乖離10件を修正 ([36a598e](https://github.com/Lateo2580/FlEq/commit/36a598e68ff2f57147b1179493109b0836f6fecd)), closes [#3](https://github.com/Lateo2580/FlEq/issues/3)
+* fix GitHub Pages deployment method in landing page spec ([26df90a](https://github.com/Lateo2580/FlEq/commit/26df90a804c9fb1a423164cc459a5395fc7a51fc))
+* **minimap:** add implementation plan and fix spec overlaps ([57b5414](https://github.com/Lateo2580/FlEq/commit/57b541434f45cd0519529494349657668cdc5599))
+* **minimap:** add v2 design spec for prefecture-level ASCII minimap ([20b47d0](https://github.com/Lateo2580/FlEq/commit/20b47d0a7c0835f5fb6c609df4e5ba2ea0f45b74))
+* remove hamburger menu from landing page spec ([756132a](https://github.com/Lateo2580/FlEq/commit/756132abf323a420512b3ea075dab860b146175f))
+* root.md/dmdata.md/display-reference.md の critical 乖離を修正 ([b39fbad](https://github.com/Lateo2580/FlEq/commit/b39fbad9f49951c7696f85c21c082a0eff9215b7))
+* **site:** 対応区分・機能説明を実装と同期 ([4b83a79](https://github.com/Lateo2580/FlEq/commit/4b83a7988e5d10279bae64bfe26805f0bd1cc96a))
+* **specs:** add telegram statistics feature design ([39916a4](https://github.com/Lateo2580/FlEq/commit/39916a42a549694d7a248776f90bb3650f234bbe))
+* **specs:** address Codex review feedback on telegram statistics spec ([5f22851](https://github.com/Lateo2580/FlEq/commit/5f22851500fd2c9c1e7cd19c322fd2c6f3c51b5c))
+* summary コマンドの help 一覧に間隔設定可能な旨を追記 ([e55c769](https://github.com/Lateo2580/FlEq/commit/e55c76920a3ed7d5ee72d02b4dbedfcba9e327f8))
+* **ui:** add JSDoc note about renderSimpleNameList label styling ([5e74594](https://github.com/Lateo2580/FlEq/commit/5e745943e514960f9d398e834664d045e0476a55))
+* **ui:** ui.md の critical 乖離5件を修正 ([d0e336e](https://github.com/Lateo2580/FlEq/commit/d0e336e28ea6dbbf27339a9e38f4accdab9fcb24))
+* ヘルスチェックで検出されたドキュメント乖離31件を解消 ([f428dc7](https://github.com/Lateo2580/FlEq/commit/f428dc7124add03c32d1cff723af5451e45ab952))
+* 総合ヘルスチェック実装プランを追加 ([5767864](https://github.com/Lateo2580/FlEq/commit/5767864ad7bbc75e131315a729b423994adaeb92))
+* 総合ヘルスチェック設計を追加 ([da35d32](https://github.com/Lateo2580/FlEq/commit/da35d32451c8fd9b5b9010395ba0d6039a93f01d))
+
 ## [1.50.1](https://github.com/Lateo2580/FlEq/compare/v1.50.0...v1.50.1) (2026-03-23)
 
 

package/README.md

@@ -13,6 +13,14 @@ npm パッケージ名: `@sayue_ltr/fleq` / CLI コマンド名: `fleq`
 - REPL による実行中の設定変更・状態確認
 - CUD 配色準拠のテーマシステム（カスタマイズ可能）
 - Raspberry Pi 等の低メモリ環境でも動作
+- 電文統計（`stats` コマンド）でセッション中の受信状況を一覧表示
+- `--filter` で条件式による電文の絞り込み表示
+- `--template` でユーザー定義テンプレートによる 1 行要約カスタマイズ
+- `--compact` 改善: 端末幅に応じた幅適応型 1 行表示
+- `--focus` で条件に一致しない電文を薄く（dim compact）表示
+- `--summary-interval` で N 分ごとの定期受信要約（sparkline グラフ付き）
+- `--night` ナイトモード（彩度・輝度を抑制、危険色は維持）
+- 地震/EEW/津波の地域情報を ASCII ミニマップ（12 ブロック列島形）で表示
 
 ## 出力例
 
@@ -36,17 +44,17 @@ FlEq を使うには、以下の準備が必要です。
 
 | OS | 備考 |
 |----|------|
-| macOS 10.13+ | メイン開発・テスト環境 |
+| Windows 10+ | メイン開発・テスト環境（ConPTY 対応ターミナル推奨） |
+| macOS 10.13+ | 動作確認済み |
 | Linux (x64 / ARM) | Raspberry Pi 等の ARM デバイスでも動作 |
-| Windows 10+ | ConPTY 対応のターミナルを推奨 |
 
 ## 受信区分と内容
 
 | 区分 | 分類名 | 内容 |
 |------|--------|------|
 | 地震・津波関連 | `telegram.earthquake` | 震度速報、震源情報、震源・震度情報、津波警報等 |
-| 緊急地震速報（予報） | `eew.forecast` | EEW 予報（要契約） |
-| 緊急地震速報（警報） | `eew.warning` | EEW 警報（要契約） |
+| 緊急地震速報（予報） | `eew.forecast` | EEW 予報 |
+| 緊急地震速報（警報） | `eew.warning` | EEW 警報 |
 | 火山関連 | `telegram.volcano` | 噴火警報、噴火速報、降灰予報、火山の状況に関する解説情報等 |
 
 ## インストール
@@ -121,6 +129,18 @@ fleq --debug
 
 # 同一APIキーの既存ソケットを閉じてから接続
 fleq --close-others
+
+# EEW 警報だけ表示（通知・統計は全電文が対象）
+fleq --filter 'domain = "eew" and isWarning = true'
+
+# テンプレートで 1 行要約をカスタマイズ
+fleq --template '{{title}} {{hypocenterName|default:"-"}} M{{magnitude|default:"-"}} 最大{{maxInt|default:"-"}}'
+
+# 震度 4 以上にフォーカス（それ以外は薄く表示）
+fleq --focus 'maxInt >= "4"'
+
+# ナイトモード + 30 分ごとの受信要約
+fleq --night --summary-interval 30
 ```
 
 デフォルトの受信区分は `telegram.earthquake,eew.forecast,eew.warning,telegram.volcano` です。
@@ -136,6 +156,11 @@ fleq --close-others
 | `--keep-existing` | 既存接続を維持（互換オプション。現在はデフォルト動作） | `true` |
 | `--close-others` | 同一 API キーの既存ソケットを閉じてから接続 | `false` |
 | `--mode <mode>` | 表示モード: `normal` / `compact` | `normal` |
+| `--filter <expr>` | 条件式で電文を絞り込み表示（通知・統計には非適用） | なし |
+| `--focus <expr>` | 条件に一致しない電文を dim compact 表示に落とす | なし |
+| `--template <tpl>` | ユーザー定義テンプレートで 1 行要約をカスタマイズ | なし |
+| `--summary-interval <min>` | N 分ごとの定期受信要約を表示（sparkline 付き） | `0`（無効） |
+| `--night` | ナイトモード（彩度・輝度を抑制、危険色は維持） | `false` |
 | `--debug` | デバッグログ表示 | `false` |
 
 ## 設定
@@ -177,9 +202,11 @@ fleq config keys          # 設定可能キー一覧を表示
 | `promptClock` | プロンプト時計: `"elapsed"` (経過時間) / `"clock"` (現在時刻) |
 | `waitTipIntervalMin` | 待機中ヒント表示間隔（分、0 で無効、デフォルト: 30） |
 | `sound` | 通知音の有効/無効 (`true` / `false`) |
-| `eewLog` | EEW ログ記録の有効/無効 (`true` / `false`) |
+| `eewLog` | EEW ログ記録の有効/無効 (`true` / `false`、デフォルト: `false`。明示 opt-in） |
 | `maxObservations` | 観測点の最大表示件数 (1〜999 / `"off"` で全件表示) |
 | `backup` | EEW 副回線の有効/無効 (`true` / `false`) |
+| `nightMode` | ナイトモードの有効/無効 (`true` / `false`) |
+| `summaryInterval` | 定期受信要約の間隔（分、0 で無効） |
 | `truncation` | 省略表示の上限設定（`truncation.<key> <N>` で個別設定。`fleq config keys` で詳細を確認） |
 
 > **補足:** `eewLogFields`（EEW ログの記録項目）と通知カテゴリ設定は、REPL の `eewlog fields` / `notify` コマンドで管理します。
@@ -226,6 +253,8 @@ Raspberry Pi での常時稼働については [Raspberry Pi 500 セットアッ
 | `history [N]` | 地震履歴を取得・表示（デフォルト 10 件、最新が一番下） |
 | `colors` | カラーパレット・震度色の一覧を表示 |
 | `detail [tsunami\|volcano]` | 直近の津波情報または火山警報状態を再表示 |
+| `stats` | セッション中の電文受信統計を表示 |
+| `summary` | 直近の定期受信要約を手動表示 |
 
 ### ステータス
 | コマンド | 説明 |
@@ -248,6 +277,12 @@ Raspberry Pi での常時稼働については [Raspberry Pi 500 セットアッ
 | `tablewidth [N\|auto]` | テーブル幅の表示・変更（`auto` でターミナル幅に自動追従） |
 | `infotext [full/short]` | お知らせ電文の全文/省略切替 |
 | `tipinterval [N]` | 待機中ヒント表示間隔（分）を表示・変更（0 で無効） |
+| `filter set <expr>` | フィルタ条件を動的に設定 |
+| `filter clear` | フィルタ条件をクリア |
+| `filter test <expr>` | フィルタ式の構文チェック |
+| `focus set <expr>` | フォーカス条件を動的に設定 |
+| `focus clear` | フォーカス条件をクリア |
+| `night [on/off]` | ナイトモードの ON/OFF 切替 |
 | `mode [normal/compact]` | 表示モード切替 |
 | `clock [elapsed/now]` | プロンプト時計の切替（`now` は Config 上の `"clock"` に対応） |
 | `sound [on/off]` | 通知音の ON/OFF 切替 |
@@ -298,7 +333,7 @@ A: グローバルインストールが完了しているか確認してくだ
 A: API キーに必要な権限が付与されているか確認してください。最低限 `socket.start` と、受信する区分に対応する `telegram.get.*` 権限が必要です。dmdata.jp の管理画面で確認できます。
 
 **Q: EEW が受信できない**
-A: `eew.forecast` / `eew.warning` の受信には dmdata.jp の対応する契約が必要です。無料プランでは受信できません。契約なしで試す場合は `-c telegram.earthquake,telegram.volcano` で地震・火山情報のみ受信してください。
+A: `eew.forecast` / `eew.warning` の受信には dmdata.jp の対応する契約が必要です。
 
 **Q: 他のデバイスで FlEq を起動したら、既存の接続が切れた**
 A: デバイスごとに異なる `appName` を設定してください。詳しくは「複数デバイスで使う場合」を参照してください。
@@ -308,6 +343,7 @@ A: `notify-send` がインストールされているか確認してください
 
 ## 関連ドキュメント
 
+- [CLI 強化機能ガイド](docs/cli-features.md) — フィルタ・テンプレート・フォーカス等の詳細な使い方
 - [表示リファレンス](docs/display-reference.md) — 電文タイプ別の表示フォーマット一覧
 - [Raspberry Pi 500 セットアップガイド](docs/raspi500-setup-guide.md) — Raspberry Pi での常時稼働セットアップ
 - [内部仕様書](docs/specs/) — アーキテクチャ・電文ルーティング・UI 仕様等の開発者向けドキュメント

package/dist/config.js

@@ -59,7 +59,7 @@ class ConfigError extends Error {
 exports.ConfigError = ConfigError;
 /** 旧Configファイルのディレクトリ (マイグレーション用) */
 const OLD_CONFIG_DIR = path.join(os.homedir(), ".config", "dmdata-monitor");
-/** レガシーConfigディレクトリ (macOS/Windows でのマイグレーション用) */
+/** レガシーConfigディレクトリ (OS 別パス導入前の ~/.config/fleq からのマイグレーション用) */
 const LEGACY_CONFIG_DIR = path.join(os.homedir(), ".config", "fleq");
 /**
  * OS・環境変数・ホームディレクトリからConfigディレクトリを解決する純粋関数。
@@ -159,7 +159,7 @@ const VALID_TEST_MODES = ["no", "including", "only"];
 /** 有効な表示モード */
 const VALID_DISPLAY_MODES = ["normal", "compact"];
 /** 有効なプロンプト時計モード */
-const VALID_PROMPT_CLOCKS = ["elapsed", "clock"];
+const VALID_PROMPT_CLOCKS = ["elapsed", "clock", "uptime"];
 /** 有効な EEW ログ記録項目 */
 exports.VALID_EEW_LOG_FIELDS = [
     "hypocenter",
@@ -196,7 +196,6 @@ exports.VALID_TRUNCATION_KEYS = [
     "volcanoAshfallDetailLines",
     "volcanoAshfallRegularLines",
     "volcanoPreventionLines",
-    "volcanoMunicipalities",
     "ashfallAreasQuick",
     "ashfallAreasOther",
     "ashfallPeriodsQuick",
@@ -215,12 +214,14 @@ const CONFIG_KEYS = {
     tableWidth: 'テーブル表示幅 (40〜200 / "auto" でターミナル幅に自動追従)',
     infoFullText: "お知らせ電文の全文表示 (true/false)",
     displayMode: '表示モード: "normal" | "compact"',
-    promptClock: 'プロンプト時計: "elapsed" (経過時間) | "clock" (現在時刻)',
+    promptClock: 'プロンプト時計: "elapsed" (経過時間) | "clock" (現在時刻) | "uptime" (稼働時間)',
     waitTipIntervalMin: "待機中ヒント表示間隔 (分, 0で無効)",
     sound: "通知音の有効/無効 (true/false)",
     eewLog: "EEWログ記録の有効/無効 (true/false)",
     maxObservations: '観測点の最大表示件数 (1〜999 / "off" で全件表示)',
     backup: "EEW副回線の有効/無効 (true/false)",
+    nightMode: "ナイトモードの有効/無効 (true/false)",
+    summaryInterval: "定期受信要約の間隔 (分, 1〜1440)",
     truncation: "省略表示の上限設定 (truncation.<key> で個別設定)",
 };
 /** Configファイルのパスを返す */
@@ -284,6 +285,8 @@ function validateConfig(raw) {
     applyNotifySettings(config, raw.notify);
     applyMaxObservations(config, raw.maxObservations);
     applyBooleanField(config, "backup", raw.backup);
+    applyBooleanField(config, "nightMode", raw.nightMode);
+    applySummaryInterval(config, raw.summaryInterval);
     applyTruncation(config, raw.truncation);
     return config;
 }
@@ -329,6 +332,11 @@ function applyBooleanField(config, field, value) {
     }
 }
 function applyTableWidth(config, value) {
+    if (value === "auto") {
+        log.warn('config.json の tableWidth に "auto" が指定されていますが、文字列 "auto" は無効です。' +
+            "tableWidth を削除するとターミナル幅に自動追従します。");
+        return;
+    }
     if (typeof value === "number" && value >= 40 && value <= 200) {
         config.tableWidth = value;
     }
@@ -353,6 +361,14 @@ function applyWaitTipInterval(config, value) {
         config.waitTipIntervalMin = value;
     }
 }
+function applySummaryInterval(config, value) {
+    if (typeof value === "number" &&
+        Number.isInteger(value) &&
+        value >= 1 &&
+        value <= 1440) {
+        config.summaryInterval = value;
+    }
+}
 function applyNotifySettings(config, value) {
     if (typeof value !== "object" || value == null || Array.isArray(value)) {
         return;
@@ -530,6 +546,20 @@ function setConfigValue(key, value) {
             }
             config.backup = value === "true";
             break;
+        case "nightMode":
+            if (value !== "true" && value !== "false") {
+                throw new ConfigError("nightMode は true または false を指定してください。");
+            }
+            config.nightMode = value === "true";
+            break;
+        case "summaryInterval": {
+            const si = Number(value);
+            if (isNaN(si) || !Number.isInteger(si) || si < 1 || si > 1440) {
+                throw new ConfigError("summaryInterval は 1〜1440 の整数を指定してください。");
+            }
+            config.summaryInterval = si;
+            break;
+        }
         case "maxObservations": {
             if (value === "off") {
                 delete config.maxObservations;
@@ -542,6 +572,9 @@ function setConfigValue(key, value) {
             config.maxObservations = mo;
             break;
         }
+        case "truncation":
+            throw new ConfigError(`truncation は set コマンドでは直接変更できません。truncation.<key> を指定してください。\n` +
+                `有効なサブキー: ${exports.VALID_TRUNCATION_KEYS.join(", ")}`);
     }
     saveConfig(config);
 }

package/dist/dmdata/rest-client.js

@@ -49,6 +49,11 @@ const API_BASE = "https://api.dmdata.jp/v2";
 const REQUEST_TIMEOUT_MS = 15_000;
 const SOCKET_CLEANUP_MAX_RETRIES = 5;
 const SOCKET_CLEANUP_RETRY_INTERVAL_MS = 500;
+/** リトライ設定 */
+const RETRY_MAX_ATTEMPTS = 3;
+const RETRY_BASE_DELAY_MS = 1_000;
+const RETRY_MAX_JITTER_MS = 500;
+const RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504]);
 /** TLS ハンドシェイクを再利用するための keep-alive エージェント (遅延初期化) */
 let keepAliveAgent = null;
 function getKeepAliveAgent() {
@@ -61,8 +66,18 @@ function getKeepAliveAgent() {
 function buildAuthorizationHeader(apiKey) {
     return `Basic ${Buffer.from(`${apiKey}:`).toString("base64")}`;
 }
-/** HTTPS リクエストを Promise でラップ */
-function request(method, url, apiKey, body) {
+/** HTTP レスポンスのステータスコードを保持するエラー */
+class HttpError extends Error {
+    statusCode;
+    retryAfterMs;
+    constructor(message, statusCode, retryAfterMs) {
+        super(message);
+        this.statusCode = statusCode;
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+/** 単発 HTTPS リクエストを Promise でラップ */
+function requestOnce(method, url, apiKey, body) {
     return new Promise((resolve, reject) => {
         const parsed = new URL(url);
         const options = {
@@ -100,7 +115,18 @@ function request(method, url, apiKey, body) {
                         const errMsg = typeof json === "object" && json != null && "error" in json
                             ? json.error?.message || "Unknown error"
                             : data.slice(0, 200);
-                        reject(new Error(`${method} ${parsed.pathname}: HTTP ${statusCode}: ${errMsg}`));
+                        // Retry-After ヘッダーの解析 (429 用)
+                        let retryAfterMs = null;
+                        if (statusCode === 429) {
+                            const retryAfter = res.headers["retry-after"];
+                            if (retryAfter != null) {
+                                const seconds = Number(retryAfter);
+                                if (!Number.isNaN(seconds)) {
+                                    retryAfterMs = seconds * 1_000;
+                                }
+                            }
+                        }
+                        reject(new HttpError(`${method} ${parsed.pathname}: HTTP ${statusCode}: ${errMsg}`, statusCode, retryAfterMs));
                         return;
                     }
                     resolve(json);
@@ -120,6 +146,35 @@ function request(method, url, apiKey, body) {
         req.end();
     });
 }
+/** 指数バックオフ + ジッター付きリトライでリクエストを実行 */
+async function request(method, url, apiKey, body) {
+    let lastError;
+    for (let attempt = 0; attempt <= RETRY_MAX_ATTEMPTS; attempt++) {
+        try {
+            return await requestOnce(method, url, apiKey, body);
+        }
+        catch (err) {
+            lastError = err;
+            // リトライ上限到達
+            if (attempt >= RETRY_MAX_ATTEMPTS)
+                break;
+            // リトライ可能なエラーか判定
+            if (!(err instanceof HttpError) || !RETRYABLE_STATUS_CODES.has(err.statusCode)) {
+                break; // ネットワークエラー・タイムアウト・4xx（429以外）等はリトライしない
+            }
+            // バックオフ遅延の算出: 指数バックオフ + ジッター、429 の場合は Retry-After を尊重
+            const exponentialDelay = RETRY_BASE_DELAY_MS * Math.pow(2, attempt);
+            const jitter = Math.floor(Math.random() * RETRY_MAX_JITTER_MS);
+            const baseDelay = err.retryAfterMs != null
+                ? Math.max(err.retryAfterMs, exponentialDelay)
+                : exponentialDelay;
+            const delay = baseDelay + jitter;
+            log.warn(`${method} ${new URL(url).pathname}: HTTP ${err.statusCode} — ${delay}ms 後にリトライします (${attempt + 1}/${RETRY_MAX_ATTEMPTS})`);
+            await new Promise((r) => setTimeout(r, delay));
+        }
+    }
+    throw lastError;
+}
 /** 契約一覧を取得し、有効な区分を返す */
 async function listContracts(apiKey) {
     log.debug("GET /v2/contract");