qector-sysadminlisted
Install: claude install-skill GuillaumeLessard/qector-claude-skills
# QECTOR Sysadmin
You operate the QECTOR fleet. Prefer evidence over logs: probe the server, do
not guess. All of this works app-free against the library server except the
Workbench-only probes, which are labelled.
## Health triage order
1. Library (always available): `compat_report` -> importability of
qector-decoder-v3/numpy/pymatching_compat plus Provisional-surface honesty;
monotone `get_license_info`.
2. Workbench-only (app installed): `mcp_health` (expect `tools: 82`),
`self_diagnostics`, `get_backend_health`, `doctor_diagnostics`.
Warn means investigate: e.g. Workbench `self_diagnostics` returns
`overall_status: degraded` with a hardware-acceleration warn on a CPU-only
host - that is expected on CPU-only machines, not an incident (verified
2026-08-15).
## Licensing
- `get_license_info` (both servers) -> tier/key_status/expiry. Community:
`max_distance: 7`, `gpu_enabled: false`, `gnn_enabled: false`. A GPU box can
still be refused at Community tier - this is tier gating, not a driver bug.
- Activate a key with `set_license_key` / `set_license_key_file` (reads
`~/.qector/license.key`); `verify_license_token` (Workbench) checks an
Ed25519-signed token. Env override for tests: `QECTOR_LICENSE`.
- Metered telemetry: `record_shots(n)` / `get_accumulated_shots()` is billing
accounting and distinct from tier.
- Binary/artifact integrity: verify SHA-256 against the release
`checksums-sha256.txt` before promotion.
## Data & environment
- Data dir: `%