diff --git a/docs/0-requirements.md b/docs/0-requirements.md index 4ed8973..d79bec2 100644 --- a/docs/0-requirements.md +++ b/docs/0-requirements.md @@ -89,6 +89,8 @@ Node.js 実装は独立パッケージとして配布される(MCPB: Claude De | F3.4 | レガシーエンコーディング(cp932, shift_jis, utf-8-sig)からの自動マイグレーションを行う | | F3.5 | trigger 実行を行う場合、イベントに `trigger_status`, `trigger_error`, `last_triggered_at` を追記できる | | F3.6 | trigger 実行用に `trigger-events/.json` を保存できる | +| F3.7 | `mark_processed` 実行時に、保持期間(`PURGE_AFTER_DAYS`、デフォルト 1 日)を超えた処理済みイベントを自動パージする | +| F3.8 | `PURGE_AFTER_DAYS=0` で即時パージ、負値でパージ無効化 | **イベント構造:** @@ -115,7 +117,7 @@ Python 実装と Node.js 実装の両方が、以下の同一ツールセット | F4.2 | `list_pending_events` | limit (1-100, default 20) | サマリー配列 | 未処理イベントのメタデータ一覧を返す(ペイロード含まず) | | F4.3 | `get_event` | event_id | 完全イベント or error | UUID 指定で完全なペイロードを返す | | F4.4 | `get_webhook_events` | なし | 全未処理イベント | 全未処理イベントをフルペイロード付きで返す | -| F4.5 | `mark_processed` | event_id | success, event_id | イベントを処理済みにマークする | +| F4.5 | `mark_processed` | event_id | success, event_id, purged | イベントを処理済みにマークし、保持期間を超えた処理済みイベントを自動パージする | **イベントサマリー構造:** @@ -202,6 +204,7 @@ Python 実装と Node.js 実装の両方が、以下の同一ツールセット | N2.5 | trigger working directory | `--trigger-cwd` / `WEBHOOK_TRIGGER_CWD` | なし | | N2.6 | success 時に pending を維持するか | `--keep-pending-on-trigger-success` | false | | N2.7 | events.json パス(Node.js MCP) | `EVENTS_JSON_PATH` | `mcp-server/../events.json` | +| N2.8 | 処理済みイベント保持日数 | `PURGE_AFTER_DAYS` | 1 | 優先順位: CLI 引数 > 環境変数 > デフォルト Node.js MCP サーバーは環境変数のみで構成する(CLI 引数なし)。