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,33 @@
+# github-issue-bot
+
+## 解決什麼問題
+開源專案維護苦：每天好幾個 issue 進來，要先看 → 分流 → 引導用戶補資訊。
+這個 bot 自動做第一輪：分類 / 評估嚴重度 / 留有意義的 comment / 加 label。
+
+## 前置
+1. 在 GitHub repo settings → Webhooks → 加 webhook：
+   - URL: `https://cypher.arcrun.dev/webhooks/named/github_issue_bot/trigger`
+   - Content type: `application/json`
+   - Events: `Issues (opened)`
+   - 加 secret header `X-Arcrun-API-Key: ak_xxx`
+2. 設 credential `GITHUB_BOT_TOKEN`（一支 PAT 或 GitHub App token）
+
+## 預期結果
+新 issue 開出來 30 秒後，bot 就 comment + 加標籤了。
+
+## 改成你自己的
+- prompt 改為你的專案 conventions（用詞、語氣）
+- severity / category enum 改為你的分類
+- 加 conditional：critical 自動 telegram 通知 maintainer
+- 加 KBDB 存歷史 issue + claude 分析 → 用 RAG 找重複 issue
+- 加 `if_control`：若 issue body 有 `traceback` 自動 reproduce
+
+## 為什麼這 pattern 重要
+- LLM 做「結構化判斷」比寫 if-else 強：能讀人類自然語言、抓上下文、判斷模糊邊界
+- GitHub webhook → workflow 是最常見「外部 event → 處理」場景，所有 SaaS webhook 都類似
+
+## 學到什麼
+- 多步串聯（analyze → comment → label）每步都有 next，ON_SUCCESS 串
+- `{{analyze.X}}` 從 claude_api JSON 自動展開到下游
+- 同一個 API（GitHub）多次 call 共享 `Authorization` header
+- 嚴重度 / 類別這類 LLM 判斷，用 enum + required_fields 確保結構穩定
@@ -0,0 +1 @@
+["github", "webhook", "llm", "automation", "triage", "external-api"]
@@ -0,0 +1,51 @@
+name: github_issue_bot
+description: GH webhook 收新 issue → claude 分析 → 自動留 comment + 加 label
+
+flow:
+  - "input >> ON_SUCCESS >> analyze"
+  - "analyze >> ON_SUCCESS >> add_comment"
+  - "add_comment >> ON_SUCCESS >> add_labels"
+
+config:
+  analyze:
+    component: claude_api
+    timeout_ms: 30000
+    _recipe_output_format: json
+    _recipe_output_required_fields:
+      - severity
+      - category
+      - first_response
+    prompt: |
+      你是 GitHub issue 第一線分流員。對下列 issue 給出：
+      - severity: "critical" | "high" | "medium" | "low"
+      - category: "bug" | "feature" | "doc" | "question" | "other"
+      - first_response: 一段 markdown，禮貌、有用、不假裝是真人
+
+      若是 bug，guide 用戶提供 reproduce steps；若 question 直接回答；
+      若 feature 引導去 discussion；若 doc 直接收。
+
+      Issue:
+      Title: {{input.issue.title}}
+      Body: {{input.issue.body}}
+
+  add_comment:
+    component: http_request
+    url: "https://api.github.com/repos/{{input.repository.full_name}}/issues/{{input.issue.number}}/comments"
+    method: POST
+    headers:
+      Authorization: "Bearer {{secret.GITHUB_BOT_TOKEN}}"
+      Accept: "application/vnd.github+json"
+    body_json:
+      body: "{{analyze.first_response}}"
+
+  add_labels:
+    component: http_request
+    url: "https://api.github.com/repos/{{input.repository.full_name}}/issues/{{input.issue.number}}/labels"
+    method: POST
+    headers:
+      Authorization: "Bearer {{secret.GITHUB_BOT_TOKEN}}"
+    body_json:
+      labels:
+        - "auto-triaged"
+        - "severity:{{analyze.severity}}"
+        - "type:{{analyze.category}}"
				`@@ -0,0 +1 @@`
				`["github", "webhook", "llm", "automation", "triage", "external-api"]`