# 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](protocol/README.md)
- JSON-RPC envelope: [protocol/json-rpc.md](protocol/json-rpc.md)
- Error codes: [protocol/errors.md](protocol/errors.md)
- Audit fields: [protocol/audit.md](protocol/audit.md)
- Capability model: [protocol/capabilities.md](protocol/capabilities.md)
- Topology constraints: [protocol/topology.md](protocol/topology.md)
- MVP e2e contract: [protocol/mvp-e2e-contract.md](protocol/mvp-e2e-contract.md)
- JSON Schemas: [protocol/schemas](protocol/schemas)
- Deploy schema: [deploy/deploy.schema.json](deploy/deploy.schema.json)

## Validation

Run the lightweight validation suite:

```sh
npm run check
```

Run only the L2 gateway/box simulator runtime smoke:

```sh
npm run l2:smoke
```

## L6 Manual Acceptance Entry

The external MVP acceptance surface is DEV-only and report-driven:

```sh
npm run l6:smoke
npm run web:check
npm run cli:dry-run
node tools/hwlab-cli/bin/hwlab-cli.mjs test e2e --env dev --mvp
```

The CLI command defaults to a JSON dry-run plan sourced from
`reports/dev-gate/dev-mvp-gate-report.json` and
`fixtures/mvp/m5-e2e/dry-run-plan.json`. A live DEV attempt requires
`--live --confirm-dev --confirmed-non-production`; with open gate blockers it
returns `BLOCKED` evidence rather than using fixtures or UniDesk runtime as a
substitute.