feat(snapshot): devbase up の自動スナップショットを最小間隔でスキップ

.cross_review/codex-review-pr75-gh-response.json

@@ -0,0 +1 @@
+{"id":4571476541,"node_id":"PRR_kwDOSHX-a88AAAABEHsyPQ","user":{"login":"takemi-ohama","id":10234200,"node_id":"MDQ6VXNlcjEwMjM0MjAw","avatar_url":"https://avatars.githubusercontent.com/u/10234200?u=5234c3bda85b1b6bdd98e5a4f2dfa04541b37ebb&v=4","gravatar_id":"","url":"https://api.github.com/users/takemi-ohama","html_url":"https://github.com/takemi-ohama","followers_url":"https://api.github.com/users/takemi-ohama/followers","following_url":"https://api.github.com/users/takemi-ohama/following{/other_user}","gists_url":"https://api.github.com/users/takemi-ohama/gists{/gist_id}","starred_url":"https://api.github.com/users/takemi-ohama/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/takemi-ohama/subscriptions","organizations_url":"https://api.github.com/users/takemi-ohama/orgs","repos_url":"https://api.github.com/users/takemi-ohama/repos","events_url":"https://api.github.com/users/takemi-ohama/events{/privacy}","received_events_url":"https://api.github.com/users/takemi-ohama/received_events","type":"User","user_view_type":"public","site_admin":false},"body":"## 🤖 cross-review | round 1 | codex | COMMENT\n\n時刻比較の正規化漏れについて 1 件コメントしました。","state":"COMMENTED","html_url":"https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571476541","pull_request_url":"https://api.github.com/repos/devbasex/devbase/pulls/75","author_association":"MEMBER","_links":{"html":{"href":"https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571476541"},"pull_request":{"href":"https://api.github.com/repos/devbasex/devbase/pulls/75"}},"submitted_at":"2026-06-25T13:42:09Z","commit_id":"5ddd4981eef09374487a77c98380d2d041335a1e"}

.cross_review/codex-review-pr75-prompt.md

@@ -0,0 +1,55 @@
+# /ndf:review 実行 (cross-review codex / round 3)
+
+PR #75 を **codex の観点でレビューし、gh api で直接 PR に投稿** してください。
+
+## 必須コンテキスト
+- repo: devbasex/devbase
+- PR: #75
+- commit_id (headRefOid): f8231341fb4dfa044e1b27ee4e698058b7ff28b2
+- worktree: /var/folders/qz/qxt0p_y15xv5jg4x77zmtxj80000gp/T/ndf-worktrees/devbasex--devbase/pr75 （**ファイル読み取りは必ず此処の絶対パスを使う**）
+- event_downgrade: true
+  - true の場合: payload の `event` は `COMMENT` にすること。
+    ただし body 先頭 prefix の `<event>` には **本来の intent** を書く。
+- 既存コメントスナップショット: /var/folders/qz/qxt0p_y15xv5jg4x77zmtxj80000gp/T/ndf-worktrees/devbasex--devbase/pr75/.cross_review/cross-review-pr75-existing-comments.txt （重複指摘禁止）
+
+## 出力契約
+- review body の **先頭行** に必ず以下を入れる（fence 不要、Markdown 見出しとして）:
+  ```
+  ## 🤖 cross-review | round 3 | codex | <event(intent)>
+  ```
+  例: `## 🤖 cross-review | round 3 | codex | REQUEST_CHANGES`
+  - `<event>` は **本来の intent** (REQUEST_CHANGES / APPROVE / COMMENT)
+
+### 出力に **含めてはいけないもの**（Resolve 負荷を増やすため）
+- ❌ **「良い点」/「Strengths」/「評価できる点」 section** — body にも書かない
+- ❌ **対応アクションが無いインラインコメント** — 観察・感想・現状説明だけは禁止
+- ❌ **nit / スタイル指摘のインライン化** — 好みの問題はコメント化しない (無視する)
+- ❌ **コード引用 (``` ... ```) だけで指摘内容が無いコメント**
+- ❌ **`event=COMMENT` での雑感投稿** — 直すべき点が無ければ `APPROVE` にする
+
+### インラインコメントの書式
+- `[重要度 / カテゴリ]` プレフィックス必須 (例: `[major / 正確性]`)
+- 重要度は `critical` / `major` / `minor` のみ使う (nit はインライン化しない)
+- 本文は **1 コメント = 1 修正アクション** で完結させる。1〜2 文で具体的な修正提案を書く
+
+### body (総評) の書き方
+- 設計レベル・PR 横断の **修正提案のみ** 書く
+- 書くことが無ければ prefix 行 + 1 行サマリだけで良い (褒め言葉や評価文は不要)
+
+- 投稿後、サマリを **/var/folders/qz/qxt0p_y15xv5jg4x77zmtxj80000gp/T/ndf-worktrees/devbasex--devbase/pr75/.cross_review/codex-review-pr75-result.json** に書く:
+  ```json
+  {
+    "event": "REQUEST_CHANGES",
+    "posted_as": "COMMENT",
+    "comments_count": 5,
+    "review_url": "https://github.com/.../pull/75#pullrequestreview-...",
+    "by_severity": {"critical": 0, "major": 3, "minor": 2, "nit": 0}
+  }
+  ```
+- payload（全コメント詳細）は **/var/folders/qz/qxt0p_y15xv5jg4x77zmtxj80000gp/T/ndf-worktrees/devbasex--devbase/pr75/.cross_review/codex-review-pr75-round3-payload.json** に保存
+  （振動検知用、`{ "comments": [{path, line, body, severity}, ...] }` 形式）
+
+## 守るべきこと
+- リポジトリ編集は行わない（コード修正は別ステップ）
+- worktree 外のパスは触らない
+- gh api 失敗時は err.log にエラー詳細を残して即時終了

.cross_review/codex-review-pr75-result.json

@@ -0,0 +1,12 @@
+{
+  "event": "APPROVE",
+  "posted_as": "COMMENT",
+  "comments_count": 0,
+  "review_url": "https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571614169",
+  "by_severity": {
+    "critical": 0,
+    "major": 0,
+    "minor": 0,
+    "nit": 0
+  }
+}

.cross_review/codex-review-pr75-round1-payload.json

@@ -0,0 +1,10 @@
+{
+  "comments": [
+    {
+      "path": "lib/devbase/snapshot/manager.py",
+      "line": 110,
+      "body": "[minor / 正確性] `fromisoformat()` は `2026-06-25T12:00:00+09:00` のような offset-aware な日時も返すため、既存の naive な `created_at` と混在すると `dt > latest` や `_auto_snapshot()` 側の `datetime.now() - last` が `TypeError` になります。比較前に naive/aware を同じ基準へ正規化するか、offset-aware な日時を明示的に無視する処理にしてください。",
+      "severity": "minor"
+    }
+  ]
+}

.cross_review/codex-review-pr75-round2-api-payload.json

@@ -0,0 +1,13 @@
+{
+  "commit_id": "f99f050fb2cb1d1d1d2609be1cab5b73a4ff2f7d",
+  "event": "COMMENT",
+  "body": "## 🤖 cross-review | round 2 | codex | REQUEST_CHANGES\n\n成功したスナップショット本体だけを最小間隔の判定対象にする修正が必要です。",
+  "comments": [
+    {
+      "path": "lib/devbase/snapshot/manager.py",
+      "line": 114,
+      "side": "RIGHT",
+      "body": "[major / 正確性] 判定対象を  と  に限定してください。現状は  や / の mtime でも直近スナップショット扱いになるため、コピーや失敗した差分作成後に成功したバックアップが無いまま  がスキップされます。"
+    }
+  ]
+}

.cross_review/codex-review-pr75-round2-comment-update.json

@@ -0,0 +1 @@
+{"url":"https://api.github.com/repos/devbasex/devbase/pulls/comments/3474878988","pull_request_review_id":4571528229,"id":3474878988,"node_id":"PRRC_kwDOSHX-a87PHnIM","diff_hunk":"@@ -95,6 +95,32 @@ def list(self) -> list[dict]:\n                 snap['size_bytes'] = 0\n         return snapshots\n \n+    def last_snapshot_time(self) -> Optional[datetime]:\n+        \"\"\"直近のスナップショット取得 (フル/差分) 日時を返す。\n+\n+        各スナップショットディレクトリ内のアーカイブファイルの mtime のうち\n+        最新のものを採用する。差分更新は既存ディレクトリ名を再利用するため\n+        (ディレクトリ名の日付は世代作成時のまま) ファイルの mtime を実測する方が\n+        正確で、メタデータの整合性にも依存しない。\n+\n+        スナップショットが存在しない場合は None。\n+        \"\"\"\n+        if not self.backups_dir.exists():\n+            return None\n+        latest: Optional[float] = None\n+        for snap_dir in self.backups_dir.iterdir():\n+            if not snap_dir.is_dir():\n+                continue\n+            for f in snap_dir.iterdir():","path":"lib/devbase/snapshot/manager.py","commit_id":"f99f050fb2cb1d1d1d2609be1cab5b73a4ff2f7d","original_commit_id":"f99f050fb2cb1d1d1d2609be1cab5b73a4ff2f7d","user":{"login":"takemi-ohama","id":10234200,"node_id":"MDQ6VXNlcjEwMjM0MjAw","avatar_url":"https://avatars.githubusercontent.com/u/10234200?v=4","gravatar_id":"","url":"https://api.github.com/users/takemi-ohama","html_url":"https://github.com/takemi-ohama","followers_url":"https://api.github.com/users/takemi-ohama/followers","following_url":"https://api.github.com/users/takemi-ohama/following{/other_user}","gists_url":"https://api.github.com/users/takemi-ohama/gists{/gist_id}","starred_url":"https://api.github.com/users/takemi-ohama/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/takemi-ohama/subscriptions","organizations_url":"https://api.github.com/users/takemi-ohama/orgs","repos_url":"https://api.github.com/users/takemi-ohama/repos","events_url":"https://api.github.com/users/takemi-ohama/events{/privacy}","received_events_url":"https://api.github.com/users/takemi-ohama/received_events","type":"User","user_view_type":"public","site_admin":false},"body":"[major / 正確性] 判定対象を `full.tar.zst` と `incr-*.tar.zst` に限定してください。現状は `meta.yml` や `snapshot.snar`/`.bak` の mtime でも直近スナップショット扱いになるため、コピーや失敗した差分作成後に成功したバックアップが無いまま `up` がスキップされます。","created_at":"2026-06-25T13:47:29Z","updated_at":"2026-06-25T13:48:08Z","html_url":"https://github.com/devbasex/devbase/pull/75#discussion_r3474878988","pull_request_url":"https://api.github.com/repos/devbasex/devbase/pulls/75","_links":{"self":{"href":"https://api.github.com/repos/devbasex/devbase/pulls/comments/3474878988"},"html":{"href":"https://github.com/devbasex/devbase/pull/75#discussion_r3474878988"},"pull_request":{"href":"https://api.github.com/repos/devbasex/devbase/pulls/75"}},"reactions":{"url":"https://api.github.com/repos/devbasex/devbase/pulls/comments/3474878988/reactions","total_count":0,"+1":0,"-1":0,"laugh":0,"hooray":0,"confused":0,"heart":0,"rocket":0,"eyes":0},"start_line":null,"original_start_line":null,"start_side":null,"line":114,"original_line":114,"side":"RIGHT","author_association":"MEMBER","original_position":20,"position":20,"subject_type":"line"}

.cross_review/codex-review-pr75-round2-payload.json

@@ -0,0 +1,10 @@
+{
+  "comments": [
+    {
+      "path": "lib/devbase/snapshot/manager.py",
+      "line": 114,
+      "body": "[major / 正確性] 判定対象を `full.tar.zst` と `incr-*.tar.zst` に限定してください。現状は `meta.yml` や `snapshot.snar`/`.bak` の mtime でも直近スナップショット扱いになるため、コピーや失敗した差分作成後に成功したバックアップが無いまま `up` がスキップされます。",
+      "severity": "major"
+    }
+  ]
+}

.cross_review/codex-review-pr75-round2-response.json

@@ -0,0 +1 @@
+{"id":4571528229,"node_id":"PRR_kwDOSHX-a88AAAABEHv8JQ","user":{"login":"takemi-ohama","id":10234200,"node_id":"MDQ6VXNlcjEwMjM0MjAw","avatar_url":"https://avatars.githubusercontent.com/u/10234200?u=5234c3bda85b1b6bdd98e5a4f2dfa04541b37ebb&v=4","gravatar_id":"","url":"https://api.github.com/users/takemi-ohama","html_url":"https://github.com/takemi-ohama","followers_url":"https://api.github.com/users/takemi-ohama/followers","following_url":"https://api.github.com/users/takemi-ohama/following{/other_user}","gists_url":"https://api.github.com/users/takemi-ohama/gists{/gist_id}","starred_url":"https://api.github.com/users/takemi-ohama/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/takemi-ohama/subscriptions","organizations_url":"https://api.github.com/users/takemi-ohama/orgs","repos_url":"https://api.github.com/users/takemi-ohama/repos","events_url":"https://api.github.com/users/takemi-ohama/events{/privacy}","received_events_url":"https://api.github.com/users/takemi-ohama/received_events","type":"User","user_view_type":"public","site_admin":false},"body":"## 🤖 cross-review | round 2 | codex | REQUEST_CHANGES\n\n成功したスナップショット本体だけを最小間隔の判定対象にする修正が必要です。","state":"COMMENTED","html_url":"https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571528229","pull_request_url":"https://api.github.com/repos/devbasex/devbase/pulls/75","author_association":"MEMBER","_links":{"html":{"href":"https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571528229"},"pull_request":{"href":"https://api.github.com/repos/devbasex/devbase/pulls/75"}},"submitted_at":"2026-06-25T13:47:29Z","commit_id":"f99f050fb2cb1d1d1d2609be1cab5b73a4ff2f7d"}

.cross_review/codex-review-pr75-round3-body.md

@@ -0,0 +1,3 @@
+## 🤖 cross-review | round 3 | codex | APPROVE
+
+修正要求に相当する新規指摘はありません。

.cross_review/codex-review-pr75-round3-payload.json

@@ -0,0 +1,3 @@
+{
+  "comments": []
+}

.cross_review/codex-review-pr75-round3-response.json

@@ -0,0 +1 @@
+{"id":4571614169,"node_id":"PRR_kwDOSHX-a88AAAABEH1L2Q","user":{"login":"takemi-ohama","id":10234200,"node_id":"MDQ6VXNlcjEwMjM0MjAw","avatar_url":"https://avatars.githubusercontent.com/u/10234200?u=5234c3bda85b1b6bdd98e5a4f2dfa04541b37ebb&v=4","gravatar_id":"","url":"https://api.github.com/users/takemi-ohama","html_url":"https://github.com/takemi-ohama","followers_url":"https://api.github.com/users/takemi-ohama/followers","following_url":"https://api.github.com/users/takemi-ohama/following{/other_user}","gists_url":"https://api.github.com/users/takemi-ohama/gists{/gist_id}","starred_url":"https://api.github.com/users/takemi-ohama/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/takemi-ohama/subscriptions","organizations_url":"https://api.github.com/users/takemi-ohama/orgs","repos_url":"https://api.github.com/users/takemi-ohama/repos","events_url":"https://api.github.com/users/takemi-ohama/events{/privacy}","received_events_url":"https://api.github.com/users/takemi-ohama/received_events","type":"User","user_view_type":"public","site_admin":false},"body":"## 🤖 cross-review | round 3 | codex | APPROVE\n\n修正要求に相当する新規指摘はありません。\n","state":"COMMENTED","html_url":"https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571614169","pull_request_url":"https://api.github.com/repos/devbasex/devbase/pulls/75","author_association":"MEMBER","_links":{"html":{"href":"https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571614169"},"pull_request":{"href":"https://api.github.com/repos/devbasex/devbase/pulls/75"}},"submitted_at":"2026-06-25T13:56:48Z","commit_id":"f8231341fb4dfa044e1b27ee4e698058b7ff28b2"}

.cross_review/codex-review-pr75-stdout.log

@@ -0,0 +1,10 @@
+PR #75 に `gh api` で review 投稿しました。
+
+- intent: `APPROVE`
+- posted_as: `COMMENT`
+- inline comments: `0`
+- review: https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571614169
+- result: `.cross_review/codex-review-pr75-result.json`
+- payload: `.cross_review/codex-review-pr75-round3-payload.json`
+
+確認として `uv run pytest tests/snapshot/test_auto_snapshot.py tests/cli/test_project_dispatch.py` を実行し、54 件すべて通過しました。

.cross_review/codex-review-pr75.pid

@@ -0,0 +1 @@
+30402

.cross_review/cross-review-pr75-state.json

@@ -0,0 +1,107 @@
+{
+  "started_at": "2026-06-25T22:39:23+09:00",
+  "max_rounds": 12,
+  "rotate_after": 8,
+  "only": null,
+  "current_pr": 75,
+  "worktree_path": "/var/folders/qz/qxt0p_y15xv5jg4x77zmtxj80000gp/T/ndf-worktrees/devbasex--devbase/pr75",
+  "tmp_dir": "/private/var/folders/qz/qxt0p_y15xv5jg4x77zmtxj80000gp/T/ndf-worktrees/devbasex--devbase/pr75/.cross_review",
+  "repo": "devbasex/devbase",
+  "head_branch": "feat/snapshot-min-interval",
+  "base_branch": "main",
+  "pr_author": "takemi-ohama",
+  "is_own_pr": true,
+  "event_downgrade": true,
+  "pr_history": [
+    {
+      "pr": 75,
+      "opened_at": "2026-06-25T22:39:23+09:00",
+      "closed_at": null,
+      "rounds": 0
+    }
+  ],
+  "rounds": [
+    {
+      "round": 1,
+      "pr": 75,
+      "started_at": "2026-06-25T22:39:27+09:00"
+    },
+    {
+      "round": 2,
+      "pr": 75,
+      "started_at": "2026-06-25T22:45:54+09:00",
+      "codex": {
+        "intent": "REQUEST_CHANGES",
+        "posted_as": "COMMENT",
+        "comments": 1,
+        "review_url": "https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571528229",
+        "by_severity": {
+          "critical": 0,
+          "major": 1,
+          "minor": 0,
+          "nit": 0
+        }
+      },
+      "gemini": {
+        "intent": "REQUEST_CHANGES",
+        "posted_as": "COMMENT",
+        "comments": 2,
+        "review_url": "https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571531359",
+        "by_severity": {
+          "critical": 0,
+          "major": 1,
+          "minor": 1,
+          "nit": 0
+        }
+      },
+      "fix": {
+        "commit": "f8231341fb4dfa044e1b27ee4e698058b7ff28b2",
+        "fixed": [
+          "修正1: last_snapshot_time() の mtime 集計対象を full.tar.zst / incr-*.tar.zst に限定 (meta.yml / snapshot.snar / *.bak 等を除外。docstring 更新済み)",
+          "修正2: _auto_snapshot() で delta = datetime.now() - last を変数化し timedelta(0) <= delta < timedelta(minutes=min_interval) の未来日時ガードを追加",
+          "修正3: テスト追加 (tests/snapshot/test_auto_snapshot.py, tests/snapshot/__init__.py 新規)"
+        ],
+        "deferred": 0,
+        "rejected": 0,
+        "resolved_threads": 0,
+        "ci": null,
+        "ci_failed_checks": [],
+        "ci_note": null,
+        "by_severity": {}
+      },
+      "ended_at": "2026-06-25T22:54:28+09:00"
+    },
+    {
+      "round": 3,
+      "pr": 75,
+      "started_at": "2026-06-25T22:54:49+09:00",
+      "codex": {
+        "intent": "APPROVE",
+        "posted_as": "COMMENT",
+        "comments": 0,
+        "review_url": "https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571614169",
+        "by_severity": {
+          "critical": 0,
+          "major": 0,
+          "minor": 0,
+          "nit": 0
+        }
+      },
+      "gemini": {
+        "intent": "APPROVE",
+        "posted_as": "COMMENT",
+        "comments": 1,
+        "review_url": "https://github.com/devbasex/devbase/pull/75#pullrequestreview-4571615192",
+        "by_severity": {
+          "critical": 0,
+          "major": 0,
+          "minor": 1,
+          "nit": 0
+        }
+      }
+    }
+  ],
+  "deferred_nits": [],
+  "final": "approved",
+  "ended_at": "2026-06-25T22:57:31+09:00"
+}

.cross_review/fix-pr75-result.json

@@ -0,0 +1,14 @@
+{
+  "commit_sha": "f8231341fb4dfa044e1b27ee4e698058b7ff28b2",
+  "fixed": [
+    "修正1: last_snapshot_time() の mtime 集計対象を full.tar.zst / incr-*.tar.zst に限定 (meta.yml / snapshot.snar / *.bak 等を除外。docstring 更新済み)",
+    "修正2: _auto_snapshot() で delta = datetime.now() - last を変数化し timedelta(0) <= delta < timedelta(minutes=min_interval) の未来日時ガードを追加",
+    "修正3: テスト追加 (tests/snapshot/test_auto_snapshot.py, tests/snapshot/__init__.py 新規)"
+  ],
+  "stale_resolved": ["3474835202", "3474838653"],
+  "tests_passed": true,
+  "test_output_tail": "837 passed in 34.72s (新規 tests/snapshot/ は 10 passed)",
+  "threads_resolved": 6,
+  "remaining_open_threads": 0,
+  "notes": "pytest はシステム python に無いため uv run pytest で実行。tests/snapshot/ ディレクトリは新規作成し __init__.py も追加 (既存 tests/cli 等の構成に倣う)。各 review comment に返信は replies エンドポイントで成功 (重複なし=各1件)、6スレッド全て resolveReviewThread で解決済み。"
+}