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/tests/validateContract.test.ts

@@ -0,0 +1,113 @@
+// 單元測試：validateContract
+// Requirements: 1.1, 1.2, 11.5
+
+import { describe, it, expect } from 'vitest';
+import { validateContract } from '../src/actions/validateContract';
+
+const VALID_CONTRACT = {
+  canonical_id: 'validate_json',
+  display_name: 'JSON 格式驗證器',
+  category: 'logic',
+  version: 'v1',
+  wasi_target: 'preview1',
+  stability: 'floating',
+  runtime_compat: ['cf-workers', 'wazero'],
+  constraints: {
+    max_size_kb: 2048,
+    max_cold_start_ms: 50,
+    no_network_syscall: true,
+    io_model: 'stdin_stdout_json',
+  },
+  input_schema: { type: 'object', required: ['json_string'] },
+  output_schema: { type: 'object', properties: { valid: { type: 'boolean' } } },
+  gherkin_tests: [
+    { scenario: 'happy path', given: '{"json_string":"{}"}', then_contains: '{"valid":true}' },
+    { scenario: 'error path', given: '{"json_string":"bad"}', then_contains: '{"valid":false' },
+  ],
+};
+
+describe('validateContract', () => {
+  it('完整合約通過驗證', () => {
+    const result = validateContract(VALID_CONTRACT);
+    expect(result.valid).toBe(true);
+    expect(result.missing_fields).toHaveLength(0);
+    expect(result.errors).toHaveLength(0);
+  });
+
+  it('缺少 canonical_id 時回傳 missing_fields', () => {
+    const { canonical_id: _, ...rest } = VALID_CONTRACT;
+    const result = validateContract(rest);
+    expect(result.valid).toBe(false);
+    expect(result.missing_fields).toContain('canonical_id');
+  });
+
+  it('缺少 version 時回傳 missing_fields', () => {
+    const { version: _, ...rest } = VALID_CONTRACT;
+    const result = validateContract(rest);
+    expect(result.valid).toBe(false);
+    expect(result.missing_fields).toContain('version');
+  });
+
+  it('缺少 constraints.io_model 時驗證失敗', () => {
+    const contract = {
+      ...VALID_CONTRACT,
+      constraints: {
+        max_size_kb: 2048,
+        max_cold_start_ms: 50,
+        no_network_syscall: true,
+        // io_model 缺失
+      },
+    };
+    const result = validateContract(contract);
+    expect(result.valid).toBe(false);
+    // io_model 缺失時可能在 missing_fields 或 errors 中
+    const allIssues = [...result.missing_fields, ...result.errors];
+    expect(allIssues.some(f => f.includes('io_model'))).toBe(true);
+  });
+
+  it('gherkin_tests 少於 2 個時驗證失敗', () => {
+    const contract = {
+      ...VALID_CONTRACT,
+      gherkin_tests: [
+        { scenario: 'only one', given: '{}', then_contains: '{}' },
+      ],
+    };
+    const result = validateContract(contract);
+    expect(result.valid).toBe(false);
+  });
+
+  it('category 不在允許集合時驗證失敗', () => {
+    const contract = { ...VALID_CONTRACT, category: 'invalid_category' };
+    const result = validateContract(contract);
+    expect(result.valid).toBe(false);
+  });
+
+  it('wasi_target 不是 preview1 時驗證失敗', () => {
+    const contract = { ...VALID_CONTRACT, wasi_target: 'preview2' };
+    const result = validateContract(contract);
+    expect(result.valid).toBe(false);
+  });
+
+  it('version 格式不符時驗證失敗', () => {
+    const contract = { ...VALID_CONTRACT, version: '1.0.0' };
+    const result = validateContract(contract);
+    expect(result.valid).toBe(false);
+  });
+
+  it('canonical_id 含大寫時驗證失敗', () => {
+    const contract = { ...VALID_CONTRACT, canonical_id: 'ValidateJson' };
+    const result = validateContract(contract);
+    expect(result.valid).toBe(false);
+  });
+
+  it('空物件回傳所有必填欄位', () => {
+    const result = validateContract({});
+    expect(result.valid).toBe(false);
+    expect(result.missing_fields.length).toBeGreaterThan(0);
+  });
+
+  it('null 輸入回傳驗證失敗', () => {
+    const result = validateContract(null);
+    expect(result.valid).toBe(false);
+  });
+});