REPO_B Shim Control Center Ops
Use this skill for Control Center runtime and service-surface operations.
Workflow
- Start or restart using the canonical repo-owned desktop path.
- Close stale repo-owned windows/processes before relaunch.
- Validate API readiness and endpoint contracts.
- Debug connector routing, diagnostics windows, and startup state restore.
- Validate desktop/window lifecycle ownership and verify no duplicate bounds/maximize/fullscreen ownership outside the window manager.
- Enforce startup acceptance:
- no visible empty console windows
- no stale-window relaunches
- frontend plus backend together
- shortcuts/icons target the latest repo-owned launcher
- Capture endpoint, window-manager, and launcher evidence for each restart fix.
Scope Boundary
Use this skill for Control Center startup/restart behavior and service-surface readiness checks.
Do not use this skill for:
- Windows-host vs WSL split diagnostics lane.
- Strict real-hardware probe/root-cause lane.
- PR preflight and docs lockstep gate lane.
Canonical Operations
powershell -ExecutionPolicy Bypass -File .\scripts\Start-ControlCenter.ps1
powershell -ExecutionPolicy Bypass -File .\scripts\stop.ps1
curl http://127.0.0.1:9000/health
curl http://127.0.0.1:9000/v1/models
curl http://127.0.0.1:9000/api/resources
curl http://127.0.0.1:9000/api/mcp/status
curl http://127.0.0.1:9000/api/agent/capabilities
Desktop Window and Layout Checks
From <PRIVATE_REPO_B> root:
python -m pytest apps/mx3-control-center/tests
cd apps/mx3-control-center/web/electron
npm test -- windowBounds.test.js windowManager.test.js
From <PRIVATE_REPO_B>/apps/mx3-control-center/web:
npm run build
Contract Guardrails
- Keep documented Control Center and startup diagnostics endpoints stable unless migration is approved.
- Keep connector routing and endpoint behavior backward-compatible.
- Preserve existing boundary for desktop window lifecycle: one authoritative window manager module, no duplicate bounds state ownership.
- Keep hidden/windowless launch limited to secondary helper processes, not the canonical desktop startup path.
- Treat Electron/embedded-Node ABI ownership and ORT provider readiness as part of the shipped startup contract when those lanes change.
References
- Endpoint checklist:
references/control-center-endpoints.md
Loopback
If this lane is unresolved, blocked, or ambiguous:
- Capture current evidence and failure context.
- Route back through
$skill-hubfor chain recalculation. - Resume only after the updated chain returns a deterministic next step.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.