chore: update n8n to 2.42.2

n8n 2.23+ has higher memory requirements. The previous 512Mi limit
caused OOM crashes (JS heap exhausted at ~248MB).

Changes:
- memory limit: 512Mi -> 1Gi, request: 256Mi -> 512Mi
- NODE_OPTIONS: --max-old-space-size={{ nodeHeapSizeMb }} (default 768MB)
  keeps JS heap at 75% of limit, leaving headroom for native code/buffers
- WEBHOOK_URL -> N8N_WEBHOOK_URL (deprecation warning fix)
- values.yaml: expose nodeHeapSizeMb for tuning

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.agents/rules/claude-md.md

@@ -0,0 +1,7 @@
+---
+trigger: always_on
+description: Read the CLAUDE.md hierarchy via GEMINI.md before doing anything in this workspace
+---
+
+最初に、このディレクトリの `GEMINI.md` を読み、そこに列挙された CLAUDE.md を上から順にすべて読んで従うこと。
+Read `GEMINI.md` in this directory first, then read and follow every CLAUDE.md it lists, in order.

.gitea/workflows/image-update-and-release.yaml

@@ -26,7 +26,6 @@ jobs:
       - name: Check jq availability
         run: |
           if ! command -v jq &> /dev/null; then
-            echo "Installing jq..."
             apt-get update && apt-get install -y jq
           fi
           jq --version
@@ -36,16 +35,45 @@ jobs:
         run: |
           set -e
           echo "Checking n8n versions..."
-          CURRENT=$(grep "tag:" values.yaml | head -1 | sed 's/.*tag: *"\([^"]*\)".*/\1/' | tr -d ' ')
+          CURRENT=$(grep 'tag:' values.yaml | head -1 | sed 's/.*tag: *"\([^"]*\)".*/\1/' | tr -d ' ')
           echo "Current n8n: $CURRENT"
 
-          LATEST=$(curl -s "https://registry.hub.docker.com/v2/repositories/n8nio/n8n/tags?page_size=100" | \
-            jq -r '.results[].name' | \
-            grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | \
-            sort -V | tail -1)
+          # --- Source 1: GitHub Releases API ---
+          # Stable releases only (prerelease=false, draft=false), latest 30 entries
+          GH_LATEST=$(curl -s --retry 3 --retry-delay 5 \
+            "https://api.github.com/repos/n8n-io/n8n/releases?per_page=30" | \
+            jq -r '[.[] | select(.prerelease==false and .draft==false) | .tag_name] | first // empty' | \
+            sed 's/^n8n@//')
+          echo "GitHub latest: ${GH_LATEST:-not found}"
 
-          if [ -z "$LATEST" ]; then
-            echo "Warning: Could not fetch latest n8n version, using current"
+          # --- Source 2: Docker Hub page 1 (newest last_updated first) ---
+          # Docker Hub sorts by last_updated, so recent releases appear near the top.
+          # Page 1 alone is NOT reliable (some versions fall on later pages due to
+          # non-monotonic last_updated), but combined with GitHub it provides coverage
+          # for releases not yet promoted to GitHub "latest".
+          DH_RESPONSE=$(curl -s --retry 3 --retry-delay 5 \
+            "https://registry.hub.docker.com/v2/repositories/n8nio/n8n/tags?page_size=100")
+          DH_LATEST=""
+          if echo "$DH_RESPONSE" | jq -e '.results' > /dev/null 2>&1; then
+            DH_LATEST=$(echo "$DH_RESPONSE" | jq -r '.results[].name' \
+              | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -1)
+          fi
+          echo "Docker Hub latest: ${DH_LATEST:-not found}"
+
+          # --- Take the maximum of both sources ---
+          ALL_CANDIDATES=$(printf '%s\n%s' "${GH_LATEST}" "${DH_LATEST}" \
+            | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$')
+          LATEST=$(echo "$ALL_CANDIDATES" | sort -V | tail -1)
+
+          # --- Sanity check: LATEST must be >= CURRENT ---
+          if [ -n "$LATEST" ]; then
+            HIGHER=$(printf '%s\n%s' "$CURRENT" "$LATEST" | sort -V | tail -1)
+            if [ "$HIGHER" != "$LATEST" ]; then
+              echo "Warning: best candidate ($LATEST) is older than current ($CURRENT). Skipping update."
+              LATEST="$CURRENT"
+            fi
+          else
+            echo "Warning: could not determine latest version from any source. Using current."
             LATEST="$CURRENT"
           fi
 
@@ -80,14 +108,10 @@ jobs:
         if: steps.check_update.outputs.update_needed == 'true'
         run: |
           set -e
-          echo "Updating values.yaml..."
           N8N_OLD="${{ steps.n8n.outputs.current }}"
           N8N_NEW="${{ steps.n8n.outputs.latest }}"
-
+          echo "Updating values.yaml: $N8N_OLD -> $N8N_NEW"
           sed -i "s/tag: \"${N8N_OLD}\"/tag: \"${N8N_NEW}\"/" values.yaml
-          echo "n8n updated: $N8N_OLD -> $N8N_NEW"
-
-          echo "values.yaml updated"
           git diff values.yaml
 
       - name: Update Chart.yaml version
@@ -100,12 +124,24 @@ jobs:
           echo "Chart.yaml updated to version $APP_VERSION"
           cat Chart.yaml
 
+      - name: Update README version history
+        if: steps.check_update.outputs.release_needed == 'true'
+        run: |
+          set -e
+          APP_VERSION="${{ steps.n8n.outputs.latest }}"
+          # Insert new version row after the header row in the version history table
+          sed -i "/^| バージョン | n8n | 変更内容 |/{
+            n
+            a\| ${APP_VERSION} | ${APP_VERSION} | 自動更新 |
+          }" README.md
+          echo "README.md version history updated"
+
       - name: Commit changes
         if: steps.check_update.outputs.update_needed == 'true'
         run: |
           git config user.name "Claude"
           git config user.email "claude@cafepieters.com"
-          git add values.yaml Chart.yaml
+          git add values.yaml Chart.yaml README.md
           git commit -m "chore: update n8n to ${{ steps.n8n.outputs.latest }}"
           git push origin main
 
@@ -135,7 +171,7 @@ jobs:
           APP_VERSION="${{ steps.n8n.outputs.latest }}"
           CHART_NAME=$(grep '^name:' Chart.yaml | awk '{print $2}')
           PACKAGE_FILE="${CHART_NAME}-${APP_VERSION}.tgz"
-          RELEASE_BODY="n8n Helm Chart v${APP_VERSION} - n8n: ${{ steps.n8n.outputs.latest }}"
+          RELEASE_BODY="n8n Helm Chart v${APP_VERSION}"
 
           EXISTING=$(curl -s \
             -H "Authorization: token ${GITEA_TOKEN}" \
@@ -166,7 +202,6 @@ jobs:
           APP_VERSION="${{ steps.n8n.outputs.latest }}"
           PACKAGE_FILE="${CHART_NAME}-${APP_VERSION}.tgz"
 
-          echo "Publishing ${PACKAGE_FILE} to Gitea Package Registry..."
           curl --fail-with-body \
             -u "${{ secrets.REGISTRY_USER }}:${{ secrets.REGISTRY_TOKEN }}" \
             -X POST \
@@ -179,19 +214,10 @@ jobs:
         run: |
           APP_VERSION="${{ steps.n8n.outputs.latest }}"
           UPDATE_NEEDED="${{ steps.check_update.outputs.update_needed }}"
-          RELEASE_NEEDED="${{ steps.check_update.outputs.release_needed }}"
           echo "========================================"
           if [ "$UPDATE_NEEDED" = "true" ]; then
-            echo "Update completed!"
+            echo "Updated to $APP_VERSION"
           else
-            echo "Already up to date, no changes."
-          fi
-          echo "========================================"
-          echo "n8n: ${APP_VERSION}"
-          if [ "$RELEASE_NEEDED" = "true" ]; then
-            echo "Chart Version: ${APP_VERSION} (released)"
-            echo "Registry: ${REGISTRY_URL}/api/packages/${OWNER}/helm"
-          else
-            echo "No release needed"
+            echo "Already up to date: $APP_VERSION"
           fi
           echo "========================================"

CLAUDE.md

@@ -1,4 +1,7 @@
-# n8n Helm Chart - CLAUDE.md
+# CLAUDE.md — n8n Helm Chart
+
+> **共通ルール（要約）** — 詳細は `P:\Claude\CLAUDE.md`（全体共通）と `P:\Claude\HelmChart\CLAUDE.md`（Helm チャート共通: リリースフロー・ワークフロー・Gitea Secrets）を参照。
+> 作業前に pull ／ 機能変更時は README 更新 ／ 作業単位ごとに commit → push まで ／ コミットに AI クレジットを付けない ／ pull で入った変更を revert しない ／ Helm はローカル実行不可（Python のみ可）。
 
 ## リポジトリ概要
 
@@ -6,17 +9,14 @@ n8n ワークフロー自動化ツールを Kubernetes 上にデプロイするH
 Raspberry Pi などのベアメタル上で動作する Kubernetes クラスタを想定した構成になっています。
 `n8nio/n8n` 公式マルチアーキテクチャイメージ（linux/arm64 対応）を使用します。
 
+- **Gitea リポジトリ**: `ssh://git@192.168.9.65/helmchart/n8n.git`
+- **主アプリ**: n8n（チャートのバージョン = n8n のバージョン。サブアプリは無いため、n8n 更新時は常にリリース）
+
 ## ARM 対応について
 
 `n8nio/n8n` は linux/arm64 に対応したマルチアーキテクチャイメージです。
 Raspberry Pi 4 以降（arm64）で動作します。
 
-## Git 情報
-
-- **ユーザー名**: Claude
-- **メールアドレス**: claude@cafepieters.com
-- **リポジトリ**: ssh://git@192.168.9.65/helmchart/n8n.git
-
 ## チャート構成
 
 | リソース | 説明 |
@@ -41,42 +41,9 @@ n8n のデータは `/home/node/.n8n` に保存されます。
 - デフォルト: SQLite（`/home/node/.n8n/database.sqlite`）
 - 本番推奨: PostgreSQL（`n8n.database.type: postgresdb`）
 
-## 更新時のルール
+## README 更新時の反映先
 
-**チャートに何らかの変更を加えた場合、必ず `README.md` を最新状態に更新してからコミットすること。**
-更新内容に応じて以下を反映する:
 - イメージバージョン・設定値の変更 → values の表を更新
 - テンプレート追加・削除 → チャート構成表を更新
 - 設定項目の追加・変更 → 設定リファレンス表を更新
 - 注意事項・制限事項の変更 → 該当セクションを更新
-
-## リリースフローのルール
-
-### バージョン番号の方針
-- Helmチャートのバージョン番号（`Chart.yaml` の `version` / `appVersion`）は、**n8n のバージョン番号と同一**とする。
-
-### 自動リリース条件
-- **n8n バージョン更新時**: `values.yaml` と `Chart.yaml` を更新し、Gitタグ・Giteaリリース・Gitea Package Registry への発行まで行う。
-
-### 手動リリース（臨時）
-- 改修作業などで手動リリースが必要な場合は、バージョン末尾にアルファベットを付与する。
-  - 例: `2.19.2` → `2.19.2-a`, `2.19.2-b`
-
-## ワークフロー構成
-
-### `.gitea/workflows/image-update-and-release.yaml`
-毎週月曜日 3:00 AM（JST 12:00 PM）に自動実行され、以下を行う:
-1. Docker Hub から n8n の最新バージョンを取得
-2. 更新がある場合は `values.yaml` と `Chart.yaml` を更新
-3. Gitタグ・Giteaリリース・Gitea Package Registry への発行を実施
-
-### `.gitea/workflows/helm-release.yaml`
-`main` ブランチへのプッシュ時に自動実行。Gitea Package Registry にチャートを発行する。
-
-## 必要な Gitea Secrets
-
-| シークレット名 | 用途 |
-|---|---|
-| `GITEA_TOKEN` | Gitea API（リリース作成・タグ操作） |
-| `REGISTRY_USER` | Gitea Package Registry ユーザー名 |
-| `REGISTRY_TOKEN` | Gitea Package Registry トークン |

Chart.yaml

@@ -2,8 +2,8 @@ apiVersion: v2
 name: n8n
 description: A Helm chart for n8n workflow automation on Kubernetes (ARM/Raspberry Pi ready)
 type: application
-version: "2.21.3"
-appVersion: "2.21.3"
+version: "2.42.2"
+appVersion: "2.42.2"
 keywords:
   - n8n
   - workflow

GEMINI.md

@@ -0,0 +1,24 @@
+# GEMINI.md — Antigravity (Gemini) 用エントリポイント（HelmChart\n8n）
+
+このディレクトリのルールはすべて **`CLAUDE.md`** に記載されている。本ファイルにはルール本文を書かず、読むべき CLAUDE.md への参照だけを置く（正本は常に CLAUDE.md）。
+
+## 必ず最初に実行すること
+
+以下のファイルを**上から順に**読み込み、すべての指示に従うこと。上位ほど広い範囲に適用される共通ルールで、下位は上位を前提とした補足・例外である。
+
+1. `P:\Claude\CLAUDE.md` — 全組織共通ルール（Git 運用・コミット書式・実行環境・情報記載の原則）
+2. `P:\Claude\HelmChart\CLAUDE.md` — HelmChart 組織共通ルール
+3. `P:\Claude\HelmChart\n8n\CLAUDE.md` — n8n リポジトリ固有ルール（このディレクトリ）
+
+> Antigravity はワークスペース（または git ルート）直下のルールしか自動で読まず、親フォルダを遡らない。そのため上位階層のパスをここに明示している。`P:\Claude` はクラウド同期されており、デスクトップ・ノート PC とも同じパスで存在する。
+
+## 読み替え
+
+- CLAUDE.md 中の「Claude」「Claude Code」は、Antigravity で作業する場合は Gemini 自身のことと読み替える。
+- Git のコミット者は Antigravity でも `user.name = Claude` / `user.email = claude@cafepieters.com` のまま使う（変更しない）。コミットメッセージに AI クレジットを付けない。
+- Claude Code 固有の機能（`.claude/` 設定、スキル、メモリ等）に関する記述は無視してよい。
+
+## 保守ルール
+
+- ルールの追加・変更は **CLAUDE.md にのみ**行う。本ファイルと `.agents/rules/claude-md.md` は参照だけを保持し、内容を増やさない。
+- CLAUDE.md を新しいディレクトリに追加したときは、同じ形式の `GEMINI.md` と `.agents/rules/claude-md.md` も併置する。

README.md

@@ -119,12 +119,15 @@ helm install my-n8n cafepieters/n8n \
 
 ### リソース（Raspberry Pi 向けデフォルト）
 
+n8n 2.23 以降はメモリ消費が増加しています。`nodeHeapSizeMb` は `resources.limits.memory` の約 75% に設定してください。
+
 | パラメータ | デフォルト |
 |---|---|
 | `resources.requests.cpu` | `250m` |
-| `resources.requests.memory` | `256Mi` |
+| `resources.requests.memory` | `512Mi` |
 | `resources.limits.cpu` | `1000m` |
-| `resources.limits.memory` | `512Mi` |
+| `resources.limits.memory` | `1Gi` |
+| `nodeHeapSizeMb` | `768` |
 
 ## セキュアCookieの自動設定
 
@@ -237,8 +240,23 @@ helm upgrade my-n8n cafepieters/n8n \
 
 | バージョン | n8n | 変更内容 |
 |---|---|---|
-| バージョン | n8n | 変更内容 |
-|---|---|---|
+| 2.42.2 | 2.42.2 | 自動更新 |
+| 2.41.3 | 2.41.3 | 自動更新 |
+| 2.40.3 | 2.40.3 | 自動更新 |
+| 2.39.4 | 2.39.4 | 自動更新 |
+| 2.37.10 | 2.37.10 | 自動更新 |
+| 2.37.4 | 2.37.4 | 自動更新 |
+| 2.36.5-a | 2.36.5 | OOM対応: メモリ制限 1Gi・NODE_OPTIONS ヒープ制限追加・WEBHOOK_URL 非推奨警告修正 |
+| 2.36.5 | 2.36.5 | 自動更新 |
+| 2.35.3 | 2.35.3 | 自動更新 |
+| 2.34.4 | 2.34.4 | 自動更新 |
+| 2.33.3 | 2.33.3 | 自動更新 |
+| 2.33.0 | 2.33.0 | 自動更新 |
+| 2.27.3 | 2.27.3 | 自動更新 |
+| 2.26.3 | 2.26.3 | 自動更新ワークフロー修正（GitHub Releases + Docker Hub ハイブリッドソース） |
+| 2.22.2 | 2.22.2 | 自動更新 |
+| 2.21.3 | 2.21.3 | 自動更新 |
+| 2.20.6 | 2.20.6 | 自動更新 |
 | 2.19.2-c | 2.19.2 | 暗号化キー復旧手順を README に追加 |
 | 2.19.2-b | 2.19.2 | 暗号化キーを `lookup` で既存 Secret から維持、`helm upgrade` での再生成を防止 |
 | 2.19.2-a | 2.19.2 | `N8N_SECURE_COOKIE` を Ingress/TLS 設定から自動判定（HTTP/LoadBalancer 環境対応） |

templates/deployment.yaml

@@ -41,6 +41,8 @@ spec:
           containerPort: 5678
           protocol: TCP
         env:
+        - name: NODE_OPTIONS
+          value: "--max-old-space-size={{ .Values.nodeHeapSizeMb }}"
         - name: N8N_PORT
           value: "5678"
         - name: N8N_PROTOCOL
@@ -48,7 +50,7 @@ spec:
         - name: N8N_HOST
           value: {{ .Values.n8n.host | quote }}
         {{- if .Values.n8n.webhookUrl }}
-        - name: WEBHOOK_URL
+        - name: N8N_WEBHOOK_URL
           value: {{ .Values.n8n.webhookUrl | quote }}
         {{- end }}
         - name: GENERIC_TIMEZONE

values.yaml

@@ -7,7 +7,7 @@ replicaCount: 1
 image:
   registry: docker.io
   repository: n8nio/n8n
-  tag: "2.21.3"
+  tag: "2.42.2"
   pullPolicy: IfNotPresent
 
 imagePullSecrets: []
@@ -64,13 +64,18 @@ ingress:
   #      - n8n.local
 
 # Resource limits suitable for Raspberry Pi
+# n8n 2.23+ requires more memory. Set nodeHeapSizeMb to ~75% of memory limit.
 resources:
   limits:
     cpu: 1000m
-    memory: 512Mi
+    memory: 1Gi
   requests:
     cpu: 250m
-    memory: 256Mi
+    memory: 512Mi
+
+# Node.js heap size limit (MB). Should be ~75% of resources.limits.memory.
+# 1Gi limit → 768MB heap leaves headroom for native code and buffers.
+nodeHeapSizeMb: 768
 
 autoscaling:
   enabled: false