Skip to content

Commit 61edfcf

Browse files
liplus-lin-laysmileygamesclaude
authored
docs: update 0-requirements.md for auto-purge feature (#32)
#29 の auto-purge 実装に伴う仕様ドキュメント更新。 F3.7-F3.8 purge動作、F4.5 戻り値変更、N2.8 PURGE_AFTER_DAYS追加。 Refs #31 Co-authored-by: smile <134200591+smileygames@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 8b48593 commit 61edfcf

1 file changed

Lines changed: 4 additions & 1 deletion

File tree

docs/0-requirements.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,8 @@ Node.js 実装は独立パッケージとして配布される(MCPB: Claude De
8989
| F3.4 | レガシーエンコーディング(cp932, shift_jis, utf-8-sig)からの自動マイグレーションを行う |
9090
| F3.5 | trigger 実行を行う場合、イベントに `trigger_status`, `trigger_error`, `last_triggered_at` を追記できる |
9191
| F3.6 | trigger 実行用に `trigger-events/<event-id>.json` を保存できる |
92+
| F3.7 | `mark_processed` 実行時に、保持期間(`PURGE_AFTER_DAYS`、デフォルト 1 日)を超えた処理済みイベントを自動パージする |
93+
| F3.8 | `PURGE_AFTER_DAYS=0` で即時パージ、負値でパージ無効化 |
9294

9395
**イベント構造:**
9496

@@ -115,7 +117,7 @@ Python 実装と Node.js 実装の両方が、以下の同一ツールセット
115117
| F4.2 | `list_pending_events` | limit (1-100, default 20) | サマリー配列 | 未処理イベントのメタデータ一覧を返す(ペイロード含まず) |
116118
| F4.3 | `get_event` | event_id | 完全イベント or error | UUID 指定で完全なペイロードを返す |
117119
| F4.4 | `get_webhook_events` | なし | 全未処理イベント | 全未処理イベントをフルペイロード付きで返す |
118-
| F4.5 | `mark_processed` | event_id | success, event_id | イベントを処理済みにマークする |
120+
| F4.5 | `mark_processed` | event_id | success, event_id, purged | イベントを処理済みにマークし、保持期間を超えた処理済みイベントを自動パージする |
119121

120122
**イベントサマリー構造:**
121123

@@ -202,6 +204,7 @@ Python 実装と Node.js 実装の両方が、以下の同一ツールセット
202204
| N2.5 | trigger working directory | `--trigger-cwd` / `WEBHOOK_TRIGGER_CWD` | なし |
203205
| N2.6 | success 時に pending を維持するか | `--keep-pending-on-trigger-success` | false |
204206
| N2.7 | events.json パス(Node.js MCP) | `EVENTS_JSON_PATH` | `mcp-server/../events.json` |
207+
| N2.8 | 処理済みイベント保持日数 | `PURGE_AFTER_DAYS` | 1 |
205208

206209
優先順位: CLI 引数 > 環境変数 > デフォルト
207210
Node.js MCP サーバーは環境変数のみで構成する(CLI 引数なし)。

0 commit comments

Comments
 (0)