HWLAB

HWLAB is the hardware lab runtime and control plane for MVP development.

This repository is intentionally small at L0. It defines the shared protocol contract, schema skeletons, deploy manifest schema, and minimal validation entry points that later service implementations must follow.

MVP Freeze

• MVP scope is DEV only.
• DEV endpoint is fixed at http://74.48.78.17:6667.
• PROD endpoint :6666 is reserved and is not an MVP acceptance target.
• UniDesk may be used only as an external scheduling, CI, or CD base.
• HWLAB runtime services must not be replaced by UniDesk backend, provider-gateway, or microservice proxy implementations.

Frozen Service IDs

• hwlab-cloud-api
• hwlab-cloud-web
• hwlab-agent-mgr
• hwlab-agent-worker
• hwlab-gateway
• hwlab-gateway-simu
• hwlab-box-simu
• hwlab-patch-panel
• hwlab-router
• hwlab-tunnel-client
• hwlab-edge-proxy
• hwlab-cli
• hwlab-agent-skills

Frozen Repository Layout

The MVP branches may add implementation files under these paths:

• cmd/...
• internal/...
• web/hwlab-cloud-web
• tools/hwlab-cli
• skills
• protocol/schemas
• deploy/deploy.json
• deploy/k8s/base/dev/prod
• deploy/master-edge
• deploy/frp
• scripts/bootstrap-skills.sh
• scripts/worker-entrypoint.sh

Contract Index

• Protocol contract: protocol/README.md
• JSON-RPC envelope: protocol/json-rpc.md
• Error codes: protocol/errors.md
• Audit fields: protocol/audit.md
• Capability model: protocol/capabilities.md
• Topology constraints: protocol/topology.md
• MVP e2e contract: protocol/mvp-e2e-contract.md
• JSON Schemas: protocol/schemas
• Deploy schema: deploy/deploy.schema.json

Validation

Run the lightweight validation suite:

npm run check