clawdefi-plugin (Phase 0 runtime foundation)

This package is the plugin-first runtime scaffold referenced by:

• docs/plugin-mcp-split-architecture.md
• docs/plugin-mcp-phase0-execution-checklist.md

Current status:

• runtime foundation implemented:
  • MCP supervisor with restart/backoff lifecycle (src/runtime/mcpSupervisor.ts)
  • retry policy (src/runtime/retryPolicy.ts)
  • circuit breaker (src/runtime/circuitBreaker.ts)
  • correlation context + propagation helpers (src/runtime/correlation.ts)
  • plugin pre-flight policy gate (src/runtime/policyGate.ts)
  • MCP HTTP transport client (src/runtime/mcpHttpClient.ts) with strict v1 response-envelope validation
  • runtime MCP wrapper with policy/retry/circuit/telemetry (src/runtime/runtimeMcpClient.ts)
  • in-memory telemetry counters (src/runtime/telemetry.ts)
  • runtime facade wired for real tool execution path (src/pluginRuntime.ts)
  • OpenClaw plugin entrypoint now invokes runtime facade directly for MVP tools (src/openclaw.ts, openclaw.plugin.json)
  • tool shims for simulate_transaction, evaluate_risk, build_unwind_plan, create_wallet, list_wallets, rotate_wallet_secret aligned to current MCP v1 payload contracts
  • protocol-generic perps shim surface scaffolded (perps_fetch_*, perps_build_*, perps_set_risk_orders, perps_simulate_intent, perps_execute_intent) with protocolSlug routing
  • wallets.v1 schema artifact for frontend/external multi-wallet directory parsing (src/config/walletsSchema.ts)
  • category placeholder modules added under src/categories/:
    • wallet_management, swap, perps, prediction, lending, yield, options, policy
• package naming aligned for publish target: @clawdefi/plugin (public access)
• OpenClaw extension entry points to built JS (dist/openclaw.js); prepare runs build before publish/install
• contract-facing MCP client wiring and production telemetry sinks are next.