@ozzylabs/feedradar 0.2.0 → 0.2.2

package/dist/templates/ja/workflows/combined-with-triage.template.yaml.tmpl

@@ -0,0 +1,123 @@
+# `radar workflow generate combined-with-triage` が生成。
+# watch run -> LLM triage -> キャップ付き research --batch -> グループ別
+# research --digest -> review --batch を 1 つの GitHub Actions ジョブで連結する。
+# triage 層が検出量をリサーチ価値のあるアイテムだけに絞り込むため、LoC を多く消費する
+# research/review ステップは生の検出件数の約 5〜15% だけを見ることになり、全量を浴びずに済む。
+# テンプレートのプレースホルダ / ハードキャップの根拠は
+# `src/cli/workflow/generate-combined-with-triage.ts` に記載。
+#
+# 最終ステップは `--output-mode`（デフォルト `pr`）からレンダリングされる:
+#   pr            — peter-evans/create-pull-request@v6（research/ がデフォルトブランチに
+#                   入る前に人間が PR をレビューする）。
+#   direct-commit — デフォルトブランチへ直接 commit & push（PR ゲートなし。
+#                   `permissions:` から `pull-requests: write` を外す）。このモードを
+#                   使うときはデフォルトブランチに PR 必須の branch protection を
+#                   設定しないこと — bot が直接 push する。
+
+name: feedradar-daily
+
+on:
+  schedule:
+    - cron: "{{watchCron}}"
+  workflow_dispatch: {}
+
+{{permissionsBlock}}
+
+concurrency:
+  # feedradar-watch / feedradar-combined とは別にすることで、同じブランチ上で
+  # 直列化せずによりシンプルなワークフローと共存できる。
+  group: feedradar-daily-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  daily:
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    env:
+{{envBlock}}
+    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 を実行（新規アイテムを検出）
+        run: radar watch run
+
+      - name: 検出アイテムを triage（agent={{triageAgent}}）
+        # source ごとの `triagePolicy:` が安価なモデルでの分類を駆動する。
+        # ポリシーのないアイテムはスキップされ `detected` のまま残るので、既存の
+        # 未 triage フィード向けワークフローが引き続き拾う。
+        run: radar triage --apply --triage-agent {{triageAgent}}
+
+      - name: triaged_research のアイテムを research（最大 {{maxItems}} 件, agent={{researchAgent}}）
+        # `--batch --status triaged_research` は triage ステップが昇格させたアイテムだけを
+        # 消費し、`triaged_digest` は digest ステップに、`triaged_unsure` は人間レビューの
+        # キューに残す。ハードキャップは全件昇格してしまう triage の誤射から守る。
+        run: radar research --batch --status triaged_research --max-items {{maxItems}} --agent {{researchAgent}}
+
+      - name: digest グループを research（triage.group ごとに 1 レポート）
+        # `radar items list --triage-group <g>` は triage アダプタが同じグループヒントを
+        # 付けた全アイテムを返し、それを `radar research --digest` が単一の統合レポートに
+        # まとめる。各 digest が自己完結するよう、ユニークなグループを 1 つずつ走査する。
+        # `items list --field` は一致アイテムごとに 1 行を出すため、`sort -u` で重複排除する。
+        run: |
+          set -euo pipefail
+          # `mapfile` はグループ一覧を配列に読み込み、各要素が単一かつ適切にクォートされた
+          # トークンになるようにする。以前のコマンド置換によるスカラ代入は、下のループが
+          # 配列のように扱った時点で actionlint/shellcheck の SC2128（添字なしで配列を展開）/
+          # SC2178（同じ名前をスカラと配列の両方で再利用）に引っかかっていた。パイプラインは
+          # 引き続き重複排除し、ungrouped アイテムに `--field` が出す `-` センチネルを落とす。
+          #
+          # 注意: この配列は `GROUPS` という名前にしない — それは bash の特殊配列
+          # （呼び出し側のグループ ID）であり、その予約名にグループ一覧を読み込むと
+          # `set -e` 下で即座に失敗する。予約されていない名前を使う。
+          mapfile -t DIGEST_GROUPS < <(radar items list --status triaged_digest --field triage.group | sort -u | grep -v '^-$' || true)
+          if [ "${#DIGEST_GROUPS[@]}" -eq 0 ]; then
+            echo "no triaged_digest groups to process"
+            exit 0
+          fi
+          for GROUP in "${DIGEST_GROUPS[@]}"; do
+            [ -z "$GROUP" ] && continue
+            echo "::group::digest for triage.group=$GROUP"
+            IDS=$(radar items list --triage-group "$GROUP" --status triaged_digest --field id | tr '\n' ' ')
+            # `--triage-group "$GROUP"` は digest ファイルをグループ名にちなんで命名するため、
+            # 単一キーワード source の同日 2 グループが `<date>_digest_<slug>_v1.md` で衝突
+            # しなくなる（#255）。
+            # shellcheck disable=SC2086
+            radar research --digest $IDS --triage-group "$GROUP" --agent {{researchAgent}}
+            echo "::endgroup::"
+          done
+
+      - name: research 済みアイテムを review（agent={{reviewAgent}}）
+        # クロスエージェントレビュー: review ステップは意図的に research ステップとは
+        # 異なるエージェントを使い、レビュアーが同じモデルの盲点を引き継がないようにする。
+        run: radar review --batch --status researched --agent {{reviewAgent}}
+
+      - name: unsure キューを通知
+        # `if: always()` により、下流の research ステップが失敗しても triage スパイクは
+        # 通知される。Slack 通知は `--slack-webhook secrets.<NAME>` でオプトイン。空の
+        # webhook では curl 分岐が no-op に縮むため、アラートを漏らさずステップは成功する。
+        if: always()
+        env:
+          SLACK_WEBHOOK_URL: {{slackWebhookExpr}}
+        run: |
+          set -euo pipefail
+          UNSURE=$(radar items list --status triaged_unsure --json | jq length)
+          echo "triaged_unsure queue depth: $UNSURE"
+          if [ "$UNSURE" -gt 0 ] && [ -n "${SLACK_WEBHOOK_URL:-}" ]; then
+            curl -X POST "$SLACK_WEBHOOK_URL" \
+              -H 'Content-Type: application/json' \
+              -d "{\"text\":\"feedradar: $UNSURE items need human triage review\"}"
+          fi
+
+{{finalStep}}

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.0",
+  "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": {