Merge branch 'feat/overview-dashboard'

# Conflicts: # CLAUDE.md
docs(index): index edits go on main and get pushed
2026-07-27 15:26:37 -04:00 · 2026-07-27 13:36:18 -04:00 · 2026-07-27 13:34:10 -04:00 · 2026-07-27 13:34:10 -04:00 · 2026-07-27 13:34:10 -04:00
1 changed files with 26 additions and 0 deletions
@@ -361,6 +361,32 @@ This file is meant to be re-scanned when `scadaproj` is opened in Claude Code:
 3. Keep the project set **curated** — only the SCADA/OT/Wonderware/OPC-UA family belongs here.
 4. Flag new duplicates/overlaps and namespace mismatches rather than silently merging them.

+### Index edits go on `main`, and get pushed
+
+Every sister project's `CLAUDE.md` tells it to update its entry here whenever a fact this
+index records changes. That edit lands in **this** repo, which has its own checkout — so a
+naive `git commit` writes it onto whatever branch `scadaproj` happens to be on, usually an
+unrelated feature branch, sometimes one with no upstream. The index then disagrees with
+reality for as long as that branch stays unmerged, which is the exact drift the rule exists
+to prevent, and it is invisible unless someone goes looking.
+
+**So: commit index edits on `main` and push them.** Stash or set aside unrelated work first
+— never commit an index edit onto a dirty branch — and restore the original branch after:
+
+```bash
+git rev-parse --abbrev-ref HEAD    # note it
+git checkout main && git pull
+#   …edit the entry…
+git commit -am "docs(index): <what changed about <project>>" && git push origin main
+git checkout -                     # restore
+```
+
+**Observed 2026-07-27:** the OtOpcUa `Sql` poll driver's entry had sat unpushed on
+`feat/overview-dashboard` since 2026-07-24 for exactly this reason, and the `Mqtt` driver's
+entry was about to join it. Both were recovered by cherry-picking onto `main` (`6ab50fe`,
+`591eaac`, `7dcd93c`) — **cherry-pick stranded index commits rather than merging the branch
+they are stuck on**, since that branch usually carries unrelated in-progress work.
+
 ## Other workspace projects with a CLAUDE.md (not indexed — promote on request)

 Listed so they can be pulled into the index above if you decide they belong.
Author	SHA1	Message	Date
Joseph Doherty	035c5feeb8	Merge branch 'feat/overview-dashboard' # Conflicts: # CLAUDE.md	2026-07-27 15:26:37 -04:00
Joseph Doherty	75f267c4c9	docs(index): index edits go on main and get pushed Sister projects are told to update their entry here whenever an indexed fact changes, but that edit lands in this repo's own checkout — so a naive commit writes it onto whatever branch scadaproj happens to be on. Observed 2026-07-27: the OtOpcUa Sql driver's entry sat unpushed on feat/overview-dashboard for three days, and the Mqtt entry was about to join it. Records the procedure (stash, main, push, restore) and says to cherry-pick stranded index commits rather than merge the branch they are stuck on. Claude-Session: https://claude.ai/code/session_01GASWkNEi68FSCtvr6rLoEW	2026-07-27 13:36:18 -04:00
Joseph Doherty	7dcd93c326	docs(index): OtOpcUa's MQTT / Sparkplug B driver is merged to master Merge c3a2b0f7, pushed to origin 2026-07-27. Supersedes the "on branch feat/mqtt-sparkplug-driver, not yet merged" note in `bf75e26`. Claude-Session: https://claude.ai/code/session_01GASWkNEi68FSCtvr6rLoEW	2026-07-27 13:34:10 -04:00
Joseph Doherty	591eaac881	docs(index): record OtOpcUa's MQTT / Sparkplug B driver The OtOpcUa entry's driver set changed, so the index has to change with it (OtOpcUa CLAUDE.md's cross-repo rule). A read-only `Mqtt` broker-subscribe driver landed with two ingest shapes over one MQTTnet-5 client: Plain binds a tag to a concrete topic, SparkplugB decodes vendored Eclipse-Tahu protobuf under a single spBv1.0/{groupId}/# subscription and binds by the group/edgeNode/device?/metric tuple (birth/alias/seq-gap/ rebirth state machine, death→STALE, a birth-driven browse picker with a scoped Request-rebirth NCMD). Write-through is deferred — every MQTT node is read-only. Live-gated on docker-dev against a Mosquitto TLS+auth broker plus a project-owned C# Sparkplug edge-node simulator on 10.100.0.35:8883. Recorded as on branch feat/mqtt-sparkplug-driver, not yet merged to master, so the index does not overstate what is on OtOpcUa's default branch — unlike the Sql DB-poll driver next to it, which is merged. Claude-Session: https://claude.ai/code/session_01GASWkNEi68FSCtvr6rLoEW	2026-07-27 13:34:10 -04:00
Joseph Doherty	6ab50fed1f	docs(index): add the OtOpcUa Sql poll driver to the driver set OtOpcUa merged a read-only Sql Equipment-kind driver to master 2026-07-24 (polls SQL Server → OPC UA variables; connectionStringRef env resolution, schema-walk address picker, live /run gate passed on docker-dev). Keep the umbrella index's OtOpcUa driver enumeration in sync per the propagation rule. Claude-Session: https://claude.ai/code/session_01GASWkNEi68FSCtvr6rLoEW	2026-07-27 13:34:10 -04:00