@ozzylabs/feedradar 0.2.1 → 0.2.2

package/dist/templates/ja/workflows/combined.template.yaml.tmpl

@@ -0,0 +1,109 @@
+# `radar workflow generate combined` テンプレート。
+#
+# `radar watch run` -> 「新規アイテムがなければスキップ」ガード -> `radar research
+# --batch` -> `git commit/push --rebase` リトライを単一ジョブ内で連結し、検出から
+# リサーチまでの遅延を 2 つに分かれたワークフローではなく cron 1 ティックに収める。
+#
+# `src/cli/workflow/generate-combined.ts` が差し込むプレースホルダ:
+#   {{cron}}        — スケジュールの cron 式（デフォルト "0 0 * * *"）
+#   {{maxItems}}    — `--max-items` のハードキャップ（デフォルト 10）
+#   {{filterTags}}  — `--filter-tags` 引数を単一の CLI リテラルとして（フィルタが
+#                     無効なときは空になり、行は素の `--batch` に縮む）
+#   {{agent}}       — エージェント ID リテラル（claude-code|codex-cli|gemini-cli|copilot）
+#   {{secretsBlock}} — エージェント固有の `env:` 本体（共通デフォルトはなく、CLI
+#                     ジェネレータが 4 種のプリビルト断片から 1 つを選ぶ。OAuth
+#                     トークンは決して注入しない）
+#
+# ハードキャップの根拠: この YAML は `--max-items {{maxItems}}` をリテラルで埋め込み、
+# ワークフローを監査すれば CLI ソースを読み直さずともキャップが分かるようにしている。
+# CLI 側もキャップを再強制する（`src/cli/research.ts` の
+# `RESEARCH_BATCH_DEFAULT_MAX_ITEMS`）ため、手で編集した YAML でも 1 回の呼び出し内で
+# 超過できない（多層防御: YAML リテラル + CLI デフォルト）。
+
+name: feedradar-combined
+
+on:
+  schedule:
+    - cron: "{{cron}}"
+  workflow_dispatch: {}
+
+permissions:
+  contents: write
+
+concurrency:
+  # 種別スコープの concurrency グループ。watch のみと combined のワークフローは
+  # 互いを直列化してはならない（cadence もスコープも異なる）ため、種別ごとに
+  # 独自の `feedradar-<type>-${{ github.ref }}` グループを持つ。
+  group: feedradar-combined-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  combined:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: ワークスペースをチェックアウト
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: true
+
+      - name: Node.js をセットアップ
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22.21"
+
+      - name: FeedRadar をインストール
+        run: npm install -g @ozzylabs/feedradar
+
+      - name: watch を実行
+        env:
+{{secretsBlock}}
+        run: radar watch run
+
+      - name: 新規アイテムがなければ research をスキップ
+        id: detect_changes
+        # `watch run` が新規アイテムを生まなかったときは research ステップを
+        # まるごとスキップする。さもないと、暴走検出キャップがあっても空のキューに対して
+        # 丸ごと 1 回の `radar research --batch` 呼び出し（テンプレ読み込み・アイテム走査）を
+        # 消費してしまう。
+        run: |
+          if [ -z "$(git status --porcelain items/)" ]; then
+            echo "no new items in items/; skipping research step"
+            echo "has_changes=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "has_changes=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: 検出したアイテムを research（最大 {{maxItems}} 件, agent={{agent}}）
+        if: steps.detect_changes.outputs.has_changes == 'true'
+        env:
+{{secretsBlock}}
+        # `--batch` は items/ を status=detected で走査し、filter-tags の許可リストを
+        # 適用し、`--max-items` 件のレポートを書き終えたら停止する。CLI 側もキャップを
+        # 再強制するため、手で編集した YAML でも超過できない。
+        run: radar research --batch --status detected --max-items {{maxItems}}{{filterTags}} --agent {{agent}}
+
+      - name: リトライ付きでコミットして push
+        if: steps.detect_changes.outputs.has_changes == 'true'
+        # 失敗のあいだに `git pull --rebase --autostash` を挟む 3 回試行 push。
+        # items/ / state/ / research/ を奪い合う 2 つの並行 feedradar ワークフロー
+        # （例: watch-hourly + combined-weekly）向けに調整している。
+        run: |
+          git config user.name "feedradar-bot"
+          git config user.email "feedradar-bot@users.noreply.github.com"
+          git add items/ state/ research/
+          if git diff --cached --quiet; then
+            echo "nothing staged; exiting cleanly"
+            exit 0
+          fi
+          git commit -m "chore(feedradar): combined watch + research $(date -u +%Y-%m-%d)"
+          for attempt in 1 2 3; do
+            if git push origin "${GITHUB_REF_NAME}"; then
+              exit 0
+            fi
+            echo "push failed (attempt ${attempt}/3), rebasing..."
+            git pull --rebase --autostash origin "${GITHUB_REF_NAME}"
+          done
+          echo "push failed after 3 attempts" >&2
+          exit 1

package/dist/templates/ja/workflows/watch.template.yaml.tmpl

@@ -0,0 +1,100 @@
+# `radar workflow generate watch` が生成する GitHub Actions の雛形。
+# cron スケジュール・sources・コミットメッセージは自分のワークフローに合わせて編集する。
+# 認証ポリシー: API キーのみ。Claude Code の OAuth トークンは
+# Anthropic の利用規約により無人ワークフローでは禁止。
+#
+# このテンプレートはプレースホルダ駆動で、init 後に再生成するための変種。
+# `src/templates/en/workflows/watch.yaml`（init --with-actions が初回ブートストラップで
+# 出力するもの）は後方互換のため別に保持している。違いは次のとおり:
+#
+#   - cron スケジュール・出力先・エージェントの secret 名は、書き込み前に
+#     `generate-watch.ts` が CLI フラグから差し込む。
+#   - `concurrency.group` を `feedradar-watch-` にスコープし、複数のワークフロー種別
+#     （watch / combined）が互いをキャンセルせず並走できるようにしている。下記の
+#     rebase リトライと組み合わせて push 衝突を緩和する。
+#   - `Commit and push with retry` ステップは、並行 cron による push を吸収するため
+#     最大 3 回まで `git pull --rebase` をリトライする。
+
+name: feedradar-watch
+
+on:
+  schedule:
+    - cron: "{{cron}}"
+  workflow_dispatch: {}
+
+permissions:
+  # 検出したアイテム / state をワークスペースのブランチへコミットするのに必要。
+  contents: write
+
+concurrency:
+  # 種別ごとのグループ。`watch` と `combined` のワークフローが互いをキャンセルしない。
+  # 同一種別の並行実行はこのグループで直列化される。
+  group: feedradar-watch-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  watch:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: ワークスペースをチェックアウト
+        uses: actions/checkout@v4
+        with:
+          # 並行 push の上に rebase できるよう履歴が必要。
+          fetch-depth: 0
+          persist-credentials: true
+
+      - name: Node.js をセットアップ
+        uses: actions/setup-node@v4
+        with:
+          # radar が HTTPS_PROXY / HTTP_PROXY を自動検出して --use-env-proxy で
+          # 再起動するには Node 22.21+（または 24.5+）が必要。
+          node-version: "22.21"
+
+      - name: FeedRadar をインストール
+        # バージョンを決めたらリリースに固定する。この雛形では
+        # 最新の公開ビルドをインストールする。
+        run: npm install -g @ozzylabs/feedradar
+
+      - name: watch を実行
+        env:
+          # エージェント API に対して認証する（API キーのみ、OAuth は使わない）。
+          # 下記の secret 名はエージェント別の規約に従う。追加すべき正確な
+          # secret 名は生成後の標準出力を参照。
+          {{agentEnvKey}}: ${{ secrets.{{agentEnvKey}} }}
+          # github-releases アダプタの GitHub REST API レート上限を
+          # 60 → 5000 req/h に引き上げる。
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: radar watch run
+
+      - name: リトライ付きでコミットして push
+        # items/ と state/ の更新を永続化し、次回の定期実行が前回の
+        # lastSeenIds と差分を取れるようにする。Routines / Actions はどちらも
+        # 毎回クリーンに clone するため、state は git に置く必要がある。
+        #
+        # push 衝突の緩和: 別のワークフロー（例: combined.yaml）が並行して
+        # push すると `git push` が non-fast-forward で失敗する。各試行で
+        # rebase しながら最大 3 回リトライする。autostash により index 外の
+        # bot 側変更も rebase をまたいで保全される。4 回以上は構造的な問題
+        # （branch protection・トークン障害・本当のマージ衝突）を示すため、
+        # それ以上リトライせず即座に失敗させる。
+        run: |
+          set -euo pipefail
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          if git diff --quiet items/ state/; then
+            echo "no changes detected; skipping commit"
+            exit 0
+          fi
+          git add items/ state/
+          git commit -m "chore(watch): detected items $(date -u +%Y-%m-%d)"
+          for attempt in 1 2 3; do
+            if git push origin "${GITHUB_REF_NAME}"; then
+              echo "push succeeded on attempt ${attempt}"
+              exit 0
+            fi
+            echo "push failed (attempt ${attempt}/3), rebasing..."
+            git pull --rebase --autostash origin "${GITHUB_REF_NAME}"
+          done
+          echo "push failed after 3 attempts" >&2
+          exit 1

package/dist/templates/ja/workflows/watch.yaml

@@ -0,0 +1,73 @@
+# `radar init --with-actions` が生成する GitHub Actions の雛形。
+# cron スケジュール・sources・コミットメッセージは自分のワークフローに合わせて編集する。
+# 認証ポリシー: API キーのみ。Claude Code の OAuth トークンは
+# Anthropic の利用規約により無人ワークフローでは禁止。
+
+name: feedradar
+
+on:
+  schedule:
+    # 毎日 00:00 UTC。自分のペースに合わせて調整する。
+    - cron: "0 0 * * *"
+  workflow_dispatch: {}
+
+permissions:
+  # 検出したアイテム / state をワークスペースのブランチへコミットするのに必要。
+  contents: write
+
+concurrency:
+  group: feedradar-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  watch:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: ワークスペースをチェックアウト
+        uses: actions/checkout@v4
+        with:
+          # 同じブランチへコミットを push し戻せるよう履歴が必要。
+          fetch-depth: 0
+          # push 時に GITHUB_TOKEN の identity を使う — 下記の
+          # "Commit state" ステップを参照。
+          persist-credentials: true
+
+      - name: Node.js をセットアップ
+        uses: actions/setup-node@v4
+        with:
+          # radar が HTTPS_PROXY / HTTP_PROXY を自動検出して --use-env-proxy で
+          # 再起動するには Node 22.21+（または 24.5+）が必要。
+          # 古い 22.x はこのフラグを欠くため、HTTPS_PROXY を設定しても
+          # `radar` は proxy サポートなしで動作してしまう。
+          node-version: "22.21"
+
+      - name: FeedRadar をインストール
+        # バージョンを決めたらリリースに固定する。この雛形では
+        # 最新の公開ビルドをインストールする。
+        run: npm install -g @ozzylabs/feedradar
+
+      - name: watch を実行
+        env:
+          # Anthropic API に対して認証する。このワークフローは `watch run` しか
+          # 呼ばないが、後続の `research`/`review`/`update` コマンドに必要。
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          # github-releases アダプタの GitHub REST API レート上限を
+          # 60 → 5000 req/h に引き上げる。
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: radar watch run
+
+      - name: state をコミット
+        # items/ と state/ の更新を永続化し、次回の定期実行が前回の
+        # lastSeenIds と差分を取れるようにする。Routines / Actions はどちらも
+        # 毎回クリーンに clone するため、state は git に置く必要がある。
+        run: |
+          if git diff --quiet items/ state/; then
+            echo "no changes detected; skipping commit"
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add items/ state/
+          git commit -m "chore(watch): detected items $(date -u +%Y-%m-%d)"
+          git push

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ozzylabs/feedradar",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Multi-agent CLI that watches blogs and release feeds, then turns keyword hits into Markdown research reports",
   "type": "module",
   "publishConfig": {