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>

registry/components/validate_json/README.md

@@ -0,0 +1,42 @@
+# validate_json
+
+u6u 第一個 WASM 零件。驗證輸入字串是否為合法 JSON 格式。
+
+## 編譯
+
+需要安裝 [TinyGo](https://tinygo.org/getting-started/install/)：
+
+```bash
+# macOS
+brew install tinygo
+
+# 編譯為 WASM
+tinygo build -o validate_json.wasm -target=wasi .
+```
+
+## 本地測試
+
+```bash
+# 合法 JSON → {"valid":true}
+echo '{"json_string":"{\"key\":\"value\"}"}' | wasmtime validate_json.wasm
+
+# 非法 JSON → {"valid":false,"error":"..."}
+echo '{"json_string":"not-json"}' | wasmtime validate_json.wasm
+
+# 空字串 → {"valid":false,"error":"json_string is required"}
+echo '{"json_string":""}' | wasmtime validate_json.wasm
+```
+
+## 提交至 Component Registry
+
+```bash
+# 驗證合約格式
+curl -X POST https://component-registry.finally.click/components/validate-contract \
+  -H "Content-Type: application/json" \
+  -d @component.contract.yaml
+
+# 提交零件（multipart）
+curl -X POST https://component-registry.finally.click/components \
+  -F "contract=@component.contract.yaml;type=application/yaml" \
+  -F "wasm=@validate_json.wasm;type=application/wasm"
+```

registry/components/validate_json/component.contract.yaml

@@ -0,0 +1,71 @@
+canonical_id: "validate_json"
+display_name: "JSON 格式驗證器"
+category: "logic"
+version: "v1"
+wasi_target: "preview1"
+stability: "floating"
+
+runtime_compat:
+  - "cf-workers"
+  - "workerd"
+  - "wazero"
+
+constraints:
+  max_size_kb: 2048
+  max_cold_start_ms: 50
+  no_network_syscall: true
+  no_filesystem_syscall: true
+  io_model: "stdin_stdout_json"
+
+input_schema:
+  type: object
+  required:
+    - json_string
+  properties:
+    json_string:
+      type: string
+      description: "待驗證的 JSON 字串"
+
+output_schema:
+  type: object
+  required:
+    - valid
+  properties:
+    valid:
+      type: boolean
+      description: "是否為合法 JSON"
+    error:
+      type: string
+      description: "驗證失敗時的錯誤訊息（valid=false 時存在）"
+
+gherkin_tests:
+  - scenario: "合法 JSON 物件通過驗證"
+    given: '{"json_string":"{\"key\":\"value\"}"}'
+    then_contains: '{"valid":true}'
+
+  - scenario: "合法 JSON 陣列通過驗證"
+    given: '{"json_string":"[1,2,3]"}'
+    then_contains: '{"valid":true}'
+
+  - scenario: "非法 JSON 字串回傳錯誤"
+    given: '{"json_string":"not-json"}'
+    then_contains: '{"valid":false,"error":'
+
+  - scenario: "空字串回傳錯誤"
+    given: '{"json_string":""}'
+    then_contains: '{"valid":false,"error":"json_string is required"}'
+
+  - scenario: "缺少 json_string 欄位回傳錯誤"
+    given: '{}'
+    then_contains: '{"valid":false,"error":"json_string is required"}'
+
+tags:
+  - "validation"
+  - "json"
+  - "utility"
+  - "logic"
+
+description: "驗證輸入字串是否為合法 JSON 格式。輸入 json_string 欄位，回傳 valid（布林值）與 error（失敗時的錯誤訊息）。"
+config_example: |
+  my_validate_json:                       # 節點名稱（可自訂）
+    json_string: '{"key":"value"}'        # 待驗證的 JSON 字串（必填）

registry/components/validate_json/go.mod

@@ -0,0 +1,3 @@
+module validate_json
+
+go 1.21

registry/components/validate_json/main.go

@@ -0,0 +1,71 @@
+// validate_json — u6u 第一個 WASM 零件
+// 驗證輸入字串是否為合法 JSON 格式
+//
+// 白名單 import（TinyGo 規範）：
+//   - "os"             只用 os.Stdin / os.Stdout
+//   - "io"             io.ReadAll(os.Stdin)
+//   - "encoding/json"  json.Unmarshal / json.Marshal
+//
+// 禁止：goroutine、channel、net/*、os.Open、syscall.*、第三方 module
+//
+// 編譯指令：
+//   tinygo build -o validate_json.wasm -target=wasi .
+//
+// 本地測試：
+//   echo '{"json_string":"{\"key\":\"value\"}"}' | wasmtime validate_json.wasm
+//   echo '{"json_string":"not-json"}' | wasmtime validate_json.wasm
+
+package main
+
+import (
+	"encoding/json"
+	"io"
+	"os"
+)
+
+// Input 對應 input_schema
+type Input struct {
+	JSONString string `json:"json_string"`
+}
+
+// Output 對應 output_schema
+type Output struct {
+	Valid bool   `json:"valid"`
+	Error string `json:"error,omitempty"`
+}
+
+func main() {
+	// 1. 讀取 stdin
+	raw, err := io.ReadAll(os.Stdin)
+	if err != nil {
+		writeOutput(Output{Valid: false, Error: "failed to read stdin: " + err.Error()})
+		return
+	}
+
+	// 2. 解析 input JSON
+	var input Input
+	if err := json.Unmarshal(raw, &input); err != nil {
+		writeOutput(Output{Valid: false, Error: "invalid input JSON: " + err.Error()})
+		return
+	}
+
+	// 3. 驗證 json_string 欄位
+	if input.JSONString == "" {
+		writeOutput(Output{Valid: false, Error: "json_string is required"})
+		return
+	}
+
+	// 4. 嘗試解析 json_string
+	var target interface{}
+	if err := json.Unmarshal([]byte(input.JSONString), &target); err != nil {
+		writeOutput(Output{Valid: false, Error: err.Error()})
+		return
+	}
+
+	writeOutput(Output{Valid: true})
+}
+
+func writeOutput(out Output) {
+	data, _ := json.Marshal(out)
+	os.Stdout.Write(data)
+}