Feat/clawhub integration sprint 2026 04 17

[JustinaChano04]

feat: complete ClawHub integration flow

Summary

This PR adds the end-to-end ClawHub integration for OpenClaw agents in Nora.

It includes:

• ClawHub catalog browse, search, and skill detail retrieval
• Deploy-time skill selection for new agents
• Runtime skill installation for existing running agents
• Durable persistence of selected/installed skills in agents.clawhub_skills
• Post-deploy reconciliation so saved skills are reinstalled when needed
• Focused backend test coverage for ClawHub routes and reconciliation behavior

What Changed

Backend

• Added a ClawHub client for catalog/search/detail data retrieval
• Replaced the stub ClawHub route with real browse/search/detail/install/job endpoints
• Added BullMQ queue plumbing for ClawHub install jobs
• Extended agent deploy flow to persist selected clawhub_skills
• Added reconciliation helpers to compare saved skills vs installed runtime skills
• Updated the provisioner worker to:
  • run clawhub install inside Docker-backed OpenClaw agents
  • verify installs against the ClawHub lockfile
  • persist successful installs
  • reconcile missing saved skills after deploy
• Added schema support for agents.clawhub_skills

Frontend

• Added a dedicated ClawHub selection page for the new-agent deploy flow
• Added ClawHub UI on the agent page for:
  • browse/search
  • detail view
  • multi-select
  • install polling/state
  • selected-skill tray with clear/remove flows
• Wired the agent detail page and deploy flow into the new ClawHub experience

Reliability / Operational Fixes

• Removed the nested in-container timeout wrapper that was causing Nora-triggered installs to hang even when manual clawhub install succeeded
• Hardened lockfile reads to avoid transient parse failures
• Preserved post-deploy readiness checks and runtime auth sync when reconciling with the latest origin/master

Testing

Verified with:

docker compose exec worker-provisioner npm run typecheck
docker compose exec frontend-dashboard npm run typecheck
docker compose exec backend-api npx jest __tests__/clawhub.test.ts __tests__/clawhubReconciliation.test.ts --runInBand

Results:

• Backend ClawHub suites passed (19/19)
• Worker typecheck passed
• Frontend typecheck passed

Notable Behavior

• ClawHub installs are currently supported for Docker-backed OpenClaw agents
• Saved skills are reconciled after deploy, but per-skill reconciliation failures do not fail the entire deployment
• Skill stats on search results were intentionally simplified so detail stats are shown after opening a skill instead of eagerly on search cards

Merge Note

• This branch also includes the latest origin/master merged in.
• The main shared conflict in workers/provisioner/worker.ts was resolved by preserving both:
• Upstream readiness/auth-sync behavior
• Local ClawHub install/reconciliation behavior