mAi
61bc1dcf43
m: 'Add port' should be a sidebar form, not a two-step canvas gesture.
- Port inspector gains a Type dropdown (read /api/cable-types via
state.cableTypes, PATCH /ports/:id with type_id). Edge picker + label
+ delete from prior shift are unchanged.
- New "Add port" form rendered from selection.kind === "port_new":
Type / Edge / Label, Create + Cancel buttons. Default label is the
next free index for the chosen type on this device ("HDMI 3" if two
HDMIs already live there). Recomputes when m changes the type, but
stops recomputing as soon as m hand-edits the label.
- +Port in the device inspector now flips selection to port_new,
rendering the form. Submit → POST → switch to the new port's editor.
No second canvas click required.
- Clicking a port row in the device inspector's port list selects that
port and opens its editor (same surface as canvas-click).
- "← <device name>" back-link in both port editor and add-port form
jumps back to the device inspector.
Removed: state.tool === "port" branch, armPortTool helper, placePortAt
function, .tool-port CSS, state.portToolDevice / portToolTypeID. The
canvas-armed +Port tool was the user-trip-wire perseus flagged; the
sidebar form replaces it entirely.
snapToDeviceEdge also removed — placePortAt was its only caller; the
edgeCentre + portEdge + relayoutEdge trio fully owns port placement
now.
Port rows in the device inspector get a hover background + pointer
cursor to read as clickable.
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 |
https://mxdrw.msbls.de |
Base URL for mExDraw export. |
MEXDRAW_USER |
(unset) | Username for the mxdrw HTTP Basic Auth on export. Required. |
MEXDRAW_PASS |
(unset) | Password for the mxdrw HTTP Basic Auth on export. Required. |
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.