mAi
9625d97efc
+Port (device inspector): - New button on the device inspector arms a port-placement tool with the device + currently-active cable type pre-selected. - Click anywhere on the canvas: snapToDeviceEdge() finds the closest edge of the selected device, clamps the perpendicular coord, POSTs a new port. The new port renders immediately (state.ports.push + render()). - Per-port × delete button in the inspector ports grid. Manual cable draw: - Port circles are now clickable (slice 4 had pointer-events:none). - Click a port → starts a cable draw with that port as the source (state.cableDrawFromPortID, port highlighted via .cable-from class). - Click another port → POSTs a cable with from_port_id + to_port_id, type derived from source port, auto=false. If the target port's type differs, confirm-prompt warns m before committing. - Shift+click target port → binds to the target's parent device (to_device_id) instead of the port. - Click an IO marker mid-draw → terminates the cable with to_io_id. - Esc cancels the draw + clears state.cableDrawFromPortID. - "Draw cable" toolbar button is now enabled (data-tool=cable, keyboard is implicit via port-click). armTool() teardown clears the source-port state. Cable inspector tweak (slice 6 callback): - "driver" row now renders as a clickable button showing the requirement's "FromName ↔ ToName" instead of the raw id; click jumps the inspector to that requirement. CSS: - tool-port + tool-cable add the same crosshair cursor as the other tools (descendant-targeted with !important to beat svg-draggable's grab cursor — same fix-pattern as slice 3's cursor-cache pass). - .port-circle.cable-from gives the source port a glow. - .btn-link styles for inspector inline buttons.
mCables
Cable-management framework for m's setup — visual web editor backed by a single Go binary + SQLite, generating Excalidraw drawings via mExDraw.
Each cable-managed environment (LOFT, OFFICE, …) is a separate mCables
project; each project is backed by exactly one .excalidraw drawing on
mxdrw.msbls.de.
Status
Slice 1 — bootstrap shipped. Projects + global cable types are end-to-end; the SVG canvas is intentionally empty until slice 2.
| Slice | What's in it | Status |
|---|---|---|
| 1 | Project CRUD, global cable types, empty SVG canvas, project picker | ✅ |
| 2 | Frames + devices, drag-to-position | pending |
| 3 | Ports + cables (click-port → click-port) | pending |
| 4 | IO markers + cable-type editing | pending |
| 5 | Export to mxdrw.msbls.de | pending |
Run it
go run ./cmd/mcables
# open http://localhost:7777
Or built:
make build
./bin/mcables
The binary serves the frontend from an embedded web/static/ and the
JSON API under /api/. SQLite lives at ./data/mcables.db by default.
Environment
| Var | Default | Notes |
|---|---|---|
MCABLES_ADDR |
0.0.0.0:7777 |
Listen address. |
MCABLES_DB |
./data/mcables.db |
SQLite path. Parent dir is created on boot. |
MEXDRAW_BASE_URL |
(unset) | Used by slice 5 export — not consumed yet. |
MEXDRAW_TOKEN |
(unset) | Bearer for the mExDraw export. Not consumed yet. |
Tests
make test # go test -race ./...
Store-level tests cover projects + cable-types CRUD, the
drawing_name auto-default, the ?confirm=<name> guardrail on
DELETE /api/projects/:pid, and the ON DELETE RESTRICT on a
referenced cable type.
API (slice 1)
GET /api/healthz → 200 {"status":"ok"}
GET /api/projects → [Project, …]
POST /api/projects ← {name, drawing_name?, description?}
drawing_name defaults to "<name>.excalidraw"
GET /api/projects/:pid → {project, cable_types, frames, devices, …}
PATCH /api/projects/:pid ← partial
DELETE /api/projects/:pid?confirm=<name> ← confirm must equal current name
GET /api/cable-types → [CableType, …] (global)
POST /api/cable-types ← {name, color}
PATCH /api/cable-types/:id ← partial — affects every project
DELETE /api/cable-types/:id ← 409 in_use if any cable references it
Deploy to mDock
mCables runs on mDock at http://mdock:7777 as a docker-compose
service under /home/m/stacks/mcables/. Pattern matches the other
mDock services (mgreen-journal, mgeo, msports-garmin, …) — no Dokploy,
no reverse proxy, LAN-trusted.
Manual deploy (first roll)
-
Build + push the image (from any host with docker; today the image lives in mAi's Gitea namespace because mAi doesn't have write access to
m/):docker build -t mgit.msbls.de/mai/mcables:latest . awk '/machine mgit.msbls.de/{getline; getline; print $2}' ~/.netrc-mai \ | docker login mgit.msbls.de -u mAi --password-stdin docker push mgit.msbls.de/mai/mcables:latest -
Prepare directories on mDock (one-time):
ssh mdock 'mkdir -p /home/m/stacks/mcables/data /home/m/secrets/mcables \ && touch /home/m/secrets/mcables/.env \ && chmod 0600 /home/m/secrets/mcables/.env' scp docker-compose.yml mdock:/home/m/stacks/mcables/docker-compose.yml -
Pull + start:
ssh mdock 'cd /home/m/stacks/mcables && docker compose pull && docker compose up -d' -
Verify from any LAN host:
curl http://mdock:7777/api/healthz # → {"status":"ok"} curl http://mdock:7777/api/cable-types # → the 5 seeded types
To update to a new build: rebuild + push the image, then
ssh mdock 'cd /home/m/stacks/mcables && docker compose pull && docker compose up -d'.
Persistence
SQLite lives at /home/m/stacks/mcables/data/mcables.db on the host
(bind-mounted into the container at /app/data). Container runs as
UID 1000:1000 to align with m:m ownership on mDock — DB files end
up owned by m, the host user.
docker compose restart keeps the data intact (tested 2026-05-15).
Automation — follow-up task
This first roll is manual. A Gitea Actions workflow on the
self-hosted runner already on mDock (/home/m/act-runner/, label
self-hosted:host) — build → push → docker compose up -d on every
push to main — is a separate task per the design's §10. Tracking
spawned by the head if/when wanted.
Design + project conventions
docs/design.md— full v3 design (schema, API, importer/export conventions, slices, mDock deploy notes).CLAUDE.md— project instructions for mai workers.
Architecture
| Layer | Tech |
|---|---|
| DB | SQLite via modernc.org/sqlite (cgo-free), WAL, FKs on |
| Backend | Go 1.22+ net/http ServeMux pattern routing, single binary |
| Frontend | Vanilla ES modules + SVG, no build step, embedded via embed.FS |
| Export (slice 5) | mExDraw HTTP API on mxdrw.msbls.de |
LAN-trusted, no auth.