hosting

# Purpose

Take a local codebase or static site and publish it to a production URL with minimal DevOps friction.

Primary outcomes:
1. repository created and synced,
2. deployment triggered,
3. live URL verified,
4. custom-domain path documented when requested.

This is an orchestration skill. It does not guarantee uptime/SLA by itself.

# Required Installed Skills

Core:
- `github-api` (inspected latest: `1.0.3`)
- One deploy path:
  - `vercel` (inspected latest: `1.0.1`), or
  - `netlify` (inspected latest: `1.0.0`)

Optional:
- `domain-dns-ops` (inspected latest: `1.0.0`, environment-specific)
- `api-gateway` (inspected latest: `1.0.29`)

Install/update:

```bash
npx -y clawhub@latest install github-api
npx -y clawhub@latest install vercel
npx -y clawhub@latest install netlify
npx -y clawhub@latest install domain-dns-ops
npx -y clawhub@latest install api-gateway
npx -y clawhub@latest update --all
```

Verify:

```bash
npx -y clawhub@latest list
```

Important name mapping:
- If user says `/netlifly`, map it to `/netlify`.

# Required Credentials

Mandatory:
- `MATON_API_KEY` (required for `github-api`, and for `api-gateway` routes)

Provider/CLI auth (at least one deploy path):
- Vercel path: logged in `vercel login` or `VERCEL_TOKEN`
- Netlify path: logged in `netlify login` or `NETLIFY_AUTH_TOKEN`

Optional (custom infra through api-gateway):
- active app-specific OAuth connection in Maton control plane (`ctrl.maton.ai`)

Preflight:

```bash
echo "$MATON_API_KEY" | wc -c
echo "$VERCEL_TOKEN$NETLIFY_AUTH_TOKEN" | wc -c
```

Mandatory behavior:
- Never fail silently on missing keys/tokens.
- Always return `MissingAPIKeys` (or missing auth) with blocked stages.
- Continue with non-blocked stages and mark output as `Partial` when needed.

# Inputs the LM Must Collect First

- `project_path`
- `repo_name`
- `repo_visibility` (`private` or `public`)
- `deploy_target` (`vercel` or `netlify`)
- `framework_hint` (optional)
- `custom_domain` (optional)
- `domain_provider...