arcrun — AI workflow execution engine (clean history)

Self-hosted 開源：WASM 零件 + recipe + cypher-executor，跑在你自己的 Cloudflare。此為重建的乾淨歷史起點（移除曾誤 commit 的 GCP SA 金鑰，舊歷史保留在 richblack/arcrun 與本地 backup 分支）。含： - acr init --self-hosted installer（建 KV/R2 + codeload 拉預編譯 wasm + wrangler deploy + seed recipe） - recipe push 把關（資料外流提醒 + 打通檢查） - 19 個正當零件預編譯 wasm（claude_api/km_writer/kbdb_upsert_block 排除：違反 DECISIONS §1） - CLI / cypher-executor / registry / 完整 SDD Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-03 15:52:38 +08:00
commit 922a57fe34
485 changed files with 89356 additions and 0 deletions
@@ -0,0 +1,31 @@
+# email-summary
+
+## 解決什麼問題
+信箱爆炸不想一封一封看？每天早上 8 點收到一份 LLM 整理過的「今天該注意的事」。
+
+## 前置
+- 設好 gmail auth credential（`acr creds push gmail`，OAuth2 flow）
+- 設好 telegram bot + chat_id（推送目的地）
+
+## 怎麼觸發
+不用手動，cron 排程每天 08:00 自動跑。
+
+## 改成你自己的
+- `daily_cron.cron_expr` 改時區（注意 cypher-executor 跑 UTC，台灣要 -8h）
+- `fetch_unread.query` 改 gmail 搜尋條件
+- 摘要 prompt 改成你的優先級邏輯
+- 推送可換 line_notify、slack、或寫進 KBDB 等
+
+## 為什麼這 pattern 重要
+最典型「多服務串聯」case：data source（gmail）+ LLM 處理 + 通知。
+arcrun 三件套各自獨立、用 cypher binding YAML 串起來。
+
+## 進階
+- 加 `if_control` 節點：若摘要無新急件，跳過 telegram 不打擾
+- 加 KBDB 存歷史摘要（type=daily-digest）方便回看
+- 接 ai-meka workflow 自動排日程（急件 → calendar event）
+
+## 學到什麼
+- `cron` 排程 + 多步串聯標準骨架
+- `{{secret.X}}` 走 credential 系統取得 sensitive value（不寫死 YAML）
+- gmail / telegram 都是 arcrun 內建零件（list_components 看完整清單）
@@ -0,0 +1 @@
+["cron", "gmail", "llm", "telegram", "digest", "automation", "common-pattern"]
@@ -0,0 +1,43 @@
+name: email_summary
+description: 每天 8am 撈 gmail 最近未讀 → claude 摘要 → telegram 推送
+
+flow:
+  - "daily_cron >> ON_SUCCESS >> fetch_unread"
+  - "fetch_unread >> ON_SUCCESS >> summarize"
+  - "summarize >> ON_SUCCESS >> push_to_telegram"
+
+config:
+  daily_cron:
+    component: cron
+    cron_expr: "0 8 * * *"     # 每天 08:00 UTC（依需求調時區）
+
+  fetch_unread:
+    component: gmail
+    action: "list"
+    query: "is:unread newer_than:1d"
+    max_results: 20
+
+  summarize:
+    component: claude_api
+    timeout_ms: 60000
+    _recipe_output_format: text
+    prompt: |
+      你是 leo 的 email 助理。把下列 {{fetch_unread.count}} 封信濃縮成
+      一份「今天該注意的事」摘要：
+
+      **格式**：
+      - 急件（需 24h 內回）：list
+      - 帳單 / 重要通知：list
+      - 一般資訊（可週末看）：list
+      - 廣告 / spam：忽略
+
+      Emails：
+      {{fetch_unread.messages}}
+
+  push_to_telegram:
+    component: telegram
+    chat_id: "{{secret.LEO_TELEGRAM_CHAT_ID}}"
+    text: |
+      📬 今日 email 摘要
+
+      {{summarize.data.text}}
				`@@ -0,0 +1 @@`
				`["cron", "gmail", "llm", "telegram", "digest", "automation", "common-pattern"]`